萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 權限體系完整詳解:分類、聲明、動態申請、最佳實踐

Android 權限架構演進

版本機制特點
< API 23 (6.0)安裝時授權用戶安裝時一次性授予所有權限,不可單獨拒絕
API 23-28 (6.0-9.0)運行時權限危險權限需運行時動態申請,用戶可單獨拒絕
API 29 (10.0)分區存儲、後台定位權限文件訪問限制、後台定位需單獨權限
API 30 (11.0)一次性授權、權限自動重置臨時授權、長期未用自動撤銷
API 31 (12.0)藍牙/附近設備權限拆分、精確鬧鐘權限權限顆粒度更細
API 33 (13.0)媒體權限拆分、通知權限READ_MEDIA_IMAGES/VIDEO/AUDIO、POST_NOTIFICATIONS
API 34 (14.0)前台服務類型細化、照片選擇器系統化FOREGROUND_SERVICE_* 類型、PhotoPicker

權限分類

1. 正常權限

安裝時自動授予,無風險,用戶不可撤銷。無需動態申請。

  • INTERNET、ACCESS_NETWORK_STATE、ACCESS_WIFI_STATE
  • BLUETOOTH (連接已配對)、BLUETOOTH_ADMIN (發現/配對)
  • VIBRATE、WAKE_LOCK、SET_ALARM
  • FOREGROUND_SERVICE (API 28+)、REQUEST_INSTALL_PACKAGES

2. 危險權限

涉及用戶隱私/敏感資源,**必須動態申請**,用戶可拒絕/撤銷。分組機制:同組任一授權,組內其他自動授權 (API 23-28);API 29+ 取消分組,逐個授權。

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)

權限聲明最佳實踐

  1. 最小權限原則:只聲明必需權限,定期審計移除無用權限
  2. 清單說明:在 <uses-permission> 添加 android:description (API 33+) 或 Play Console 填寫用途說明
  3. 分組申請:關聯功能打包申請 (如定位組一次性申請精確+粗略+後台)
  4. 上下文引導:功能入口處解釋為什麼需要權限,提高授權率
  5. 優雅降級:拒絕權限後提供替代方案 (如手動輸入地址代替定位)
  6. 測試覆蓋:測試授權/拒絕/不再詢問/撤銷/系統設置開啟各路徑

常見權限對照表 (部分)










 


 
 
 
 
 
 


























 



copyright © 萬盛學電腦網 all rights reserved
權限組權限說明
CALENDARREAD_CALENDAR, WRITE_CALENDAR日曆讀寫
CAMERACAMERA拍照/錄像
CONTACTSREAD_CONTACTS, WRITE_CONTACTS, GET_ACCOUNTS聯系人讀寫
LOCATIONACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, ACCESS_BACKGROUND_LOCATION (API 29+)精確/粗略/後台定位
MICROPHONERECORD_AUDIO錄音
PHONEREAD_PHONE_STATE, READ_PHONE_NUMBERS, CALL_PHONE, ANSWER_PHONE_CALLS, ADD_VOICEMAIL, USE_SIP電話狀態/撥號/接聽
SENSORSBODY_SENSORS心率等生物傳感器
SMSSEND_SMS, RECEIVE_SMS, READ_SMS, RECEIVE_WAP_PUSH, RECEIVE_MMS短信收發讀取
STORAGEREAD_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE (API 28-), READ_MEDIA_IMAGES/VIDEO/AUDIO (API 33+)存儲讀寫 (分區存儲後大幅變化)