HiPermission
A simple and beautiful runtime permission library on Android.中文文档
Features
- One line of code to solve
- Various logics are omitted
- Support change permission Ui
ACCESS_FINE_LOCATION
,WRITE_EXTERNAL_STORAGE
and CAMERA
,these almost every app requires permissions ,so we can request these permissions when app launch.But it's not very friendly to request so many permissions at once.So before the request permission, we need to tell the user why we did this.The inspiration comes from eleme
Screenshot
Demo
Usage
Use Gradle:
compile 'me.weyye.hipermission:library:1.0.7'
Or Maven:
<dependency>
<groupId>me.weyye.hipermission</groupId>
<artifactId>library</artifactId>
<version>1.0.7</version>
<type>pom</type>
</dependency>
In your Activity or anywhere:
They will request three necessary permissions:CAMERA
,ACCESS_FINE_LOCATION
and WRITE_EXTERNAL_STORAGE
HiPermission.create(context)
.checkMutiPermission(new PermissionCallback() {
@Override
public void onClose() {
Log.i(TAG, "onClose");
showToast("They cancelled our request");
}
@Override
public void onFinish() {
showToast("All permissions requested completed");
}
@Override
public void onDeny(String permission, int position) {
Log.i(TAG, "onDeny");
}
@Override
public void onGuarantee(String permission, int position) {
Log.i(TAG, "onGuarantee");
}
});
Sometimes you don't need to request for these permissions,you can add permissions that you want to request like this
List<PermissionItem> permissionItems = new ArrayList<PermissionItem>();
permissionItems.add(new PermissionItem(Manifest.permission.CAMERA, "Camera", R.drawable.permission_ic_memory));
permissionItems.add(new PermissionItem(Manifest.permission.ACCESS_FINE_LOCATION, "Location", R.drawable.permission_ic_location));
HiPermission.create(MainActivity.this)
.permissions(permissionItems)
.checkMutiPermission(...);
Custom Style
Can I change the color of the interface? Or change hint information? Yes!
HiPermission.create(MainActivity.this)
.title("Dear God")
.permissions(permissionItems)
.filterColor(ResourcesCompat.getColor(getResources(), R.color.colorPrimary, getTheme()))//permission icon color
.msg("To protect the peace of the world, open these permissions! You and I together save the world!")
.style(R.style.PermissionBlueStyle)
.checkMutiPermission(...);
After you have set the theme, you must called
filterColor ()
to set the color of the icon,otherwise the default is black
styles.xml
<style name="PermissionBlueStyle">
<item name="PermissionTitleColor">@color/colorPrimaryDark</item>
<item name="PermissionMsgColor">@color/colorPrimary</item>
<item name="PermissionItemTextColor">@color/colorPrimary</item>
<item name="PermissionButtonBackground">@drawable/shape_btn</item>
<item name="PermissionBackround">@drawable/shape_bg_white</item>
<item name="PermissionButtonTextColor">@android:color/white</item>
</style>
Default Icon
If you need to request other permissions, but no icon? HiPermission
has been prepared for you
Calendar | Camera | Contacts | Location | |
---|---|---|---|---|
drawableId | permission_ic_calendar | permission_ic_camera | permission_ic_contacts | permission_ic_location |
Micro Phone | Phone | Sms | Storage | Sensors | |
---|---|---|---|---|---|
drawableId | permission_ic_micro_phone | permission_ic_phone | permission_ic_sms | permission_ic_storage | permission_ic_sensors |
Use icon
List<PermissionItem> permissions = new ArrayList<PermissionItem>();
//use default icon
permissions.add(new PermissionItem(Manifest.permission.CALL_PHONE, getString(R.string.permission_cus_item_phone), R.drawable.permission_ic_phone));
HiPermission.create(MainActivity.this)
.permissions(permissions)
.style(R.style.PermissionDefaultGreenStyle)
.checkMutiPermission(...);
The icon is black by default, and you need to called
filterColor ()
to change the icon color
Default Style
Of course, there are three default style and animations
Screenshot | Screenshot | Screenshot | |
---|---|---|---|
styleId | PermissionDefaultNormalStyle | PermissionDefaultGreenStyle | PermissionDefaultBlueStyle |
AnimId | PermissionAnimFade | PermissionAnimModal | PermissionAnimScale |
Theme by default without animation, you need to call animStyle () like this:
HiPermission.create(MainActivity.this)
.title(getString(R.string.permission_cus_title))
.permissions(permissions)
.msg(getString(R.string.permission_cus_msg))
.animStyle(R.style.PermissionAnimModal)//set dialog animation
.style(R.style.PermissionDefaultGreenStyle)//set dialog style
.checkMutiPermission(...);
If you want to change the style of a attribute, you can extends a style inside your style override a attribute, like this
<style name="CusStyle" parent="PermissionDefaultGreenStyle">
<item name="PermissionBgFilterColor">#75D175</item>
</style>
The following are all attributes
attributes name | type |
---|---|
PermissionTitleColor | int |
PermissionMsgColor | int |
PermissionItemTextColor | int |
PermissionButtonTextColor | int |
PermissionButtonBackground | drawable |
PermissionBackround | drawable |
PermissionBgFilterColor | int |
PermissionIconFilterColor | int |
End
If you like,please give a star as an encouragement to me
About me
- Email:hiweyye@gmail.com
- My Blog:http://weyye.me
- 简书:http://www.jianshu.com/u/c5da2f9c87fb
- CSDN:http://blog.csdn.net/yewei02538
License
Copyright (C) 2017 WeyYe
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.