Skip to content
/ Perm Public

Perm is a library that makes it simple to check and request Android Permissions at runtime (like Camera or GPS) for Apps targetting Android 6 or more

License

Notifications You must be signed in to change notification settings

smart-fun/Perm

Repository files navigation

Perm for Android

Perm is a library that makes it simple to check and request Android Permissions at runtime (like Camera or GPS) for Apps targetting Android 6 or more.

Note that since version 1.1.1 of the library it is possible to request several Permissions at the same time.

Permissions can now also be checked from an Androidx Fragment.

Usage

To Check and Request permissions, simply create a Perm instance, and use isGranted(), areGranted(), isDenied(), areDenied(), or askPermissions() methods:

public class MainActivity extends AppCompatActivity {

    private static final int PERMISSIONS_REQUEST = 1;
    private static final String PERMISSIONS[] = {Manifest.permission.CAMERA, Manifest.permission.READ_CONTACTS};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setContentView(R.layout.main_activity);

        final Perm perm = new Perm(this, PERMISSIONS);
        if (perm.areGranted()) {
            Toast.makeText(this, "All Permissions granted", Toast.LENGTH_LONG).show();
        } else {
            perm.askPermissions(PERMISSIONS_REQUEST);
        }
    }
}

To handle the result of the request, create a PermResult in the onRequestPermissionsResult of your Activity, and use isGranted(), areGranted(), isDenied(), areDenied(), or areCancelled() methods.

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        if (requestCode == PERMISSIONS_REQUEST) {
            PermResult permResult = new PermResult(permissions, grantResults);
            if (permResult.areCancelled()) {
                Toast.makeText(this, "Permission process cancelled", Toast.LENGTH_LONG).show();
            } else {
                for (String permission : PERMISSIONS) {
                    if (permResult.isGranted(permission)) {
                        Toast.makeText(this, permission + " granted", Toast.LENGTH_SHORT).show();
                    } else {
                        Toast.makeText(this, permission + " denied", Toast.LENGTH_SHORT).show();
                    }
                }
            }
        }

    }

Don't forget to add the required permissions in your AndroidManifest.xml file! For example

    <uses-permission
        android:name="android.permission.CAMERA"
        android:required="false" />
        
    <uses-permission
        android:name="android.permission.READ_CONTACTS" />

Installation with gradle

Add the following maven{} line to your PROJECT build.gradle file

allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }    // add this line
    }
}

Add the libary dependency to your APP build.gradle file

dependencies {
    implementation 'com.github.smart-fun:Perm:1.2.0'    // add this line
}

License

Copyright 2016-2019 Arnaud Guyon

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.

About

Perm is a library that makes it simple to check and request Android Permissions at runtime (like Camera or GPS) for Apps targetting Android 6 or more

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages