Android 运行时权限

Android 6.0 及以后，如果你的应用需要用到一些危险权限，那么这些权限必须手动申请。
具体危险权限有哪些，可以通过下面这篇文章自行查询到：
使用 adb 命令列出设备所有危险权限

例如，读写文件就涉及到两个危险权限：
android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE

步骤1：声明权限

首先，你必须在 AndroidManifest.xml 文件中声明要用到的权限：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <!-- 读写文件 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

</manifest>

对于危险权限来说，声明了并不意味着你就拥有这些权限，你还必须手动申请。

步骤2：查询是否有权限

在读写文件之前，你必须检查你是否拥有读写文件的权限。
通过 ContextCompat 的 checkSelfPermission 函数就可以检查是否拥有指定权限。

例如：

ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)

第一个参数是 Context；
第二个参数是需要检查的权限名称。
该函数返回一个 Int 类型的值，其结果只有两种：PackageManager.PERMISSION_GRANTED 和 PackageManager.PERMISSION_DENIED

• PERMISSION_GRANTED：有此权限
• PERMISSION_DENIED：无此权限

综上所述，我们可以通过判断来处理相应的逻辑：

if (ContextCompat.checkSelfPermission(
        this,
        Manifest.permission.READ_EXTERNAL_STORAGE
    ) == PackageManager.PERMISSION_GRANTED
) {
    Log.d(TAG, "有权限")
} else {
    Log.d(TAG, "无权限")
}

步骤3：申请权限

对于没有的权限，你就必须手动去申请。
通过 ActivityCompat 的 requestPermissions 函数就可以手动申请权限。

例如：

ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), PERMISSION_REQUEST_CODE)

第一个参数是 Activity；
第二个参数是将要申请的权限放在一个数组里，可以同时申请多个权限；
第三个参数是申请码，权限申请是一个异步操作，申请结果会通过onRequestPermissionsResult回调告诉你，通过比较requestCode来定位你申请的结果

结合 ContextCompat.checkSelfPermission 一起使用：

if (ContextCompat.checkSelfPermission(
        this,
        Manifest.permission.READ_EXTERNAL_STORAGE
    ) == PackageManager.PERMISSION_GRANTED
) {
    Log.d(TAG, "有权限")
} else {
    Log.d(TAG, "无权限")
    ActivityCompat.requestPermissions(
        this,
        arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE),
        PERMISSION_REQUEST_CODE
    )
}

步骤4：申请结果

权限申请是一个异步操作，申请结果以回调的方式告知你。
通过 onRequestPermissionsResult 回调函数可以得到申请结果。

例如：

override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    when (requestCode) {
        PERMISSION_REQUEST_CODE -> {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Log.d(TAG, "权限申请成功")
            } else {
                Log.d(TAG, "权限申请失败")
            }
        }
    }
}

综合案例

activity_main.xml：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.appcompat.widget.AppCompatButton
        android:id="@+id/main_btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="申请权限"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity：

class MainActivity : AppCompatActivity() {
    private val TAG = "MainActivity"
    private val PERMISSION_REQUEST_CODE = 1

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val button: AppCompatButton = findViewById(R.id.main_btn)
        button.setOnClickListener {
            requestPermission()
        }
    }

    private fun requestPermission() {
        if (ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.READ_EXTERNAL_STORAGE
            ) == PackageManager.PERMISSION_GRANTED
        ) {
            Log.d(TAG, "有权限")
            work()
        } else {
            Log.d(TAG, "无权限")
            ActivityCompat.requestPermissions(
                this,
                arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE),
                PERMISSION_REQUEST_CODE
            )
        }
    }

    override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<out String>,
        grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        when (requestCode) {
            PERMISSION_REQUEST_CODE -> {
                if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    Log.d(TAG, "权限申请成功")
                    work()
                } else {
                    Log.d(TAG, "权限申请失败")
                }
            }
        }
    }

    private fun work() {
        Log.d(TAG, "工作")
    }
}