easypermissions 下载 - easypermissions 源代码下载

简单的权限

其他源码

3.0.0

下载

简易权限

EasyPermissions 是一个包装器库，用于在面向 Android M 或更高版本时简化基本系统权限逻辑。

注意：如果您的应用程序是用 Kotlin 编写的，请考虑使用 easypermissions-ktx 库，它将 Kotlin 扩展添加到核心 EasyPermissions 库中。

安装

EasyPermissions 是通过将以下依赖项添加到build.gradle文件来安装的：

dependencies {
    // For developers using AndroidX in their applications
    implementation ' pub.devrel:easypermissions:3.0.0 '
 
    // For developers using the Android Support Library
    implementation ' pub.devrel:easypermissions:2.0.1 '
}

用法

基本的

要开始使用 EasyPermissions，请让您的Activity （或Fragment ）重写onRequestPermissionsResult方法：

 public class MainActivity extends AppCompatActivity {
    @ Override
    protected void onCreate ( Bundle savedInstanceState ) {
        super . onCreate ( savedInstanceState );
        setContentView ( R . layout . activity_main );
    }

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

        // Forward results to EasyPermissions
        EasyPermissions . onRequestPermissionsResult ( requestCode , permissions , grantResults , this );
    }
}

请求权限

下面的示例显示如何为需要CAMERA和ACCESS_FINE_LOCATION权限的方法请求权限。有几点需要注意：

使用EasyPermissions#hasPermissions(...)检查应用程序是否已具有所需的权限。此方法可以将任意数量的权限作为其最终参数。
使用EasyPermissions#requestPermissions请求权限。此方法将请求系统权限并在必要时显示提供的理由字符串。提供的请求代码对于该请求应该是唯一的，并且该方法可以将任意数量的权限作为其最终参数。
使用AfterPermissionGranted注释。这是可选的，但为了方便而提供。如果给定请求中的所有权限都被授予，则所有使用正确的请求代码注释的方法都将被执行（确保具有唯一的请求代码）。带注释的方法必须为void并且没有输入参数（相反，您可以使用onSaveInstanceState来保持抑制参数的状态）。这是为了简化在授予请求方法的所有权限后需要运行请求方法的常见流程。这也可以通过在onPermissionsGranted回调上添加逻辑来实现。

 @ AfterPermissionGranted ( RC_CAMERA_AND_LOCATION )
private void methodRequiresTwoPermission () {
    String [] perms = { Manifest . permission . CAMERA , Manifest . permission . ACCESS_FINE_LOCATION };
    if ( EasyPermissions . hasPermissions ( this , perms )) {
        // Already have permission, do the thing
        // ...
    } else {
        // Do not have permissions, request them now
        EasyPermissions . requestPermissions ( this , getString ( R . string . camera_and_location_rationale ),
                RC_CAMERA_AND_LOCATION , perms );
    }
}

或者为了更好地控制基本原理对话框，请使用PermissionRequest ：

 EasyPermissions . requestPermissions (
        new PermissionRequest . Builder ( this , RC_CAMERA_AND_LOCATION , perms )
                . setRationale ( R . string . camera_and_location_rationale )
                . setPositiveButtonText ( R . string . rationale_ask_ok )
                . setNegativeButtonText ( R . string . rationale_ask_cancel )
                . setTheme ( R . style . my_fancy_style )
                . build ());

或者，为了更好的控制，您可以让Activity / Fragment实现PermissionCallbacks接口。

 public class MainActivity extends AppCompatActivity implements EasyPermissions . PermissionCallbacks {

    @ Override
    protected void onCreate ( Bundle savedInstanceState ) {
        super . onCreate ( savedInstanceState );
        setContentView ( R . layout . activity_main );
    }

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

        // Forward results to EasyPermissions
        EasyPermissions . onRequestPermissionsResult ( requestCode , permissions , grantResults , this );
    }

    @ Override
    public void onPermissionsGranted ( int requestCode , List < String > list ) {
        // Some permissions have been granted
        // ...
    }

    @ Override
    public void onPermissionsDenied ( int requestCode , List < String > list ) {
        // Some permissions have been denied
        // ...
    }
}

所需权限

在某些情况下，如果没有某些权限，您的应用程序将无法正常运行。如果用户使用“不再询问”选项拒绝这些权限，您将无法向用户请求这些权限，并且必须在应用设置中更改这些权限。在这种情况下，您可以使用EasyPermissions.somePermissionPermanentlyDenied(...)方法向用户显示一个对话框，并将他们定向到您的应用程序的系统设置屏幕：

注意：由于Android框架权限API提供的信息有限， somePermissionPermanentlyDenied方法仅在权限被拒绝并且您的应用程序收到onPermissionsDenied回调后才起作用。否则图书馆无法区分永久拒绝和“尚未拒绝”的情况。

 @ Override
public void onPermissionsDenied ( int requestCode , List < String > perms ) {
    Log . d ( TAG , "onPermissionsDenied:" + requestCode + ":" + perms . size ());

    // (Optional) Check whether the user denied any permissions and checked "NEVER ASK AGAIN."
    // This will display a dialog directing them to enable the permission in app settings.
    if ( EasyPermissions . somePermissionPermanentlyDenied ( this , perms )) {
        new AppSettingsDialog . Builder ( this ). build (). show ();
    }
}

@ Override
public void onActivityResult ( int requestCode , int resultCode , Intent data ) {
    super . onActivityResult ( requestCode , resultCode , data );

    if ( requestCode == AppSettingsDialog . DEFAULT_SETTINGS_REQ_CODE ) {
        // Do something after user returned from app settings screen, like showing a Toast.
        Toast . makeText ( this , R . string . returned_from_app_settings_to_activity , Toast . LENGTH_SHORT )
                . show ();
    }
}

与基本原理对话框交互

如果您想与基本原理对话框交互，请实现EasyPermissions.RationaleCallbacks 。

 @ Override
public void onRationaleAccepted ( int requestCode ) {
    // Rationale accepted to request some permissions
    // ...
}

@ Override
public void onRationaleDenied ( int requestCode ) {
    // Rationale denied to request some permissions
    // ...
}

基本原理回调并不一定意味着权限更改。要检查这些，请参阅EasyPermissions.PermissionCallbacks 。

执照

	Copyright 2017 Google

   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.

展开

附加信息