涉及用戶隱私/敏感資源,**必須動態申請**,用戶可拒絕/撤銷。分組機制:同組任一授權,組內其他自動授權 (API 23-28);API 29+ 取消分組,逐個授權。
| 權限組 | 權限 | 說明 |
| CALENDAR | READ_CALENDAR, WRITE_CALENDAR | 日曆讀寫 |
| CAMERA | CAMERA | 拍照/錄像 |
| CONTACTS | READ_CONTACTS, WRITE_CONTACTS, GET_ACCOUNTS | 聯系人讀寫 |
| LOCATION | ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, ACCESS_BACKGROUND_LOCATION (API 29+) | 精確/粗略/後台定位 |
| MICROPHONE | RECORD_AUDIO | 錄音 |
| PHONE | READ_PHONE_STATE, READ_PHONE_NUMBERS, CALL_PHONE, ANSWER_PHONE_CALLS, ADD_VOICEMAIL, USE_SIP | 電話狀態/撥號/接聽 |
| SENSORS | BODY_SENSORS | 心率等生物傳感器 |
| SMS | SEND_SMS, RECEIVE_SMS, READ_SMS, RECEIVE_WAP_PUSH, RECEIVE_MMS | 短信收發讀取 |
| STORAGE | READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE (API 28-), READ_MEDIA_IMAGES/VIDEO/AUDIO (API 33+) | 存儲讀寫 (分區存儲後大幅變化) |
3. 特殊權限 (Special Permissions)
不走標準權限流程,需跳轉系統設置頁面用戶手動開啟:
SYSTEM_ALERT_WINDOW (悬浮窗/覆蓋其他應用)
WRITE_SETTINGS (修改系統設置)
REQUEST_INSTALL_PACKAGES (安裝未知應用,API 26+)
ACCESS_ALL_FILES (MANAGE_EXTERNAL_STORAGE,API 30+,全文件訪問)
SCHEDULE_EXACT_ALARM (精確鬧鐘,API 31+)
BIND_ACCESSIBILITY_SERVICE (無障礙服務)
BIND_NOTIFICATION_LISTENER_SERVICE (通知監聽)
4. 簽名/系統權限
僅系統應用或同簽名應用可獲取:INSTALL_PACKAGES, DELETE_PACKAGES, REBOOT, BRICK 等。
動態權限申請標準流程
Java 版本
public class PermissionUtils {
public static final int REQUEST_CODE_PERMISSION = 1001;
public static void requestPermission(Activity activity, String permission,
PermissionCallback callback) {
if (ContextCompat.checkSelfPermission(activity, permission)
== PackageManager.PERMISSION_GRANTED) {
callback.onGranted();
return;
}
// 應顯示理由 (用戶曾拒絕過)
if (ActivityCompat.shouldShowRequestPermissionRationale(activity, permission)) {
new AlertDialog.Builder(activity)
.setTitle("需要權限")
.setMessage("此功能需要 " + getPermissionName(permission) + " 權限,請授權")
.setPositiveButton("去授權", (d, w) ->
ActivityCompat.requestPermissions(activity, new String[]{permission}, REQUEST_CODE_PERMISSION))
.setNegativeButton("取消", (d, w) -> callback.onDenied(false))
.show();
} else {
// 首次請求或用戶勾選"不再詢問"後拒絕
ActivityCompat.requestPermissions(activity, new String[]{permission}, REQUEST_CODE_PERMISSION);
}
}
public static void onRequestPermissionsResult(Activity activity, int requestCode,
String[] permissions, int[] grantResults,
PermissionCallback callback) {
if (requestCode == REQUEST_CODE_PERMISSION) {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
callback.onGranted();
} else {
boolean neverAskAgain = !ActivityCompat.shouldShowRequestPermissionRationale(activity, permissions[0]);
callback.onDenied(neverAskAgain);
}
}
}
// 引導用戶去設置頁面
public static void openAppSettings(Context context) {
Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
intent.setData(Uri.fromParts("package", context.getPackageName(), null));
context.startActivity(intent);
}
// 獲取權限友好名稱
private static String getPermissionName(String permission) {
// 可建立映射表返回中文名
return permission.substring(permission.lastIndexOf('.') + 1);
}
public interface PermissionCallback {
void onGranted();
void onDenied(boolean neverAskAgain);
}
}
// Activity 中使用
PermissionUtils.requestPermission(this, Manifest.permission.CAMERA, new PermissionUtils.PermissionCallback() {
@Override public void onGranted() { openCamera(); }
@Override public void onDenied(boolean neverAskAgain) {
if (neverAskAgain) PermissionUtils.openAppSettings(MainActivity.this);
}
});
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
PermissionUtils.onRequestPermissionsResult(this, requestCode, permissions, grantResults, callback);
}
Kotlin + Activity Result API (現代推薦)
class MainActivity : ComponentActivity() {
// 單權限請求
private val requestPermission = registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
if (granted) openCamera() else handleDenied(Manifest.permission.CAMERA)
}
// 多權限請求
private val requestPermissions = registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { results ->
results.forEach { (permission, granted) ->
if (granted) onGranted(permission) else handleDenied(permission)
}
}
fun openCamera() {
if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) == PERMISSION_GRANTED) {
// 直接打開相機
} else {
requestPermission.launch(Manifest.permission.CAMERA)
}
}
private fun handleDenied(String permission) {
if (!shouldShowRequestPermissionRationale(permission)) {
// 用戶選擇"不再詢問",引導去設置
startActivity(Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
data = Uri.fromParts("package", packageName, null)
})
}
}
}
分區存儲 (Scoped Storage) 適配
Android 10 (API 29) 強制分區存儲,WRITE_EXTERNAL_STORAGE 僅對應用專有目錄 (getExternalFilesDir()) 生效,訪問共享媒體文件需:
- API 29:
READ_EXTERNAL_STORAGE + android:requestLegacyExternalStorage="true" (臨時過渡)
- API 30+:MediaStore API (推薦) 或 Storage Access Framework (SAF)
- API 33+:
READ_MEDIA_IMAGES, READ_MEDIA_VIDEO, READ_MEDIA_AUDIO 替代 READ_EXTERNAL_STORAGE
// MediaStore 訪問圖片 (無需權限,僅限媒體文件)
val projection = arrayOf(MediaStore.Images.Media._ID, MediaStore.Images.Media.DISPLAY_NAME)
val resolver = contentResolver
resolver.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, projection, null, null, null)?.use { cursor ->
while (cursor.moveToNext()) {
val id = cursor.getLong(0)
val name = cursor.getString(1)
val uri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id)
// 使用 uri 加載圖片 (Glide/Coil 直接支持 content:// URI)
}
}
// SAF 選擇任意文件/目錄
val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE).apply {
addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION or Intent.FLAG_GRANT_READ_URI_PERMISSION)
}
startActivityForResult(intent, REQUEST_CODE_DIR)
權限聲明最佳實踐
- 最小權限原則:只聲明必需權限,定期審計移除無用權限
- 清單說明:在
<uses-permission> 添加 android:description (API 33+) 或 Play Console 填寫用途說明
- 分組申請:關聯功能打包申請 (如定位組一次性申請精確+粗略+後台)
- 上下文引導:功能入口處解釋為什麼需要權限,提高授權率
- 優雅降級:拒絕權限後提供替代方案 (如手動輸入地址代替定位)
- 測試覆蓋:測試授權/拒絕/不再詢問/撤銷/系統設置開啟各路徑
常見權限對照表 (部分)
copyright ©
萬盛學電腦網 all rights reserved