# Android 权限申请详解

## 一、权限分类

### 1. 普通权限
- **特点**：不会直接威胁用户隐私
- **申请方式**：在 AndroidManifest.xml 中声明即可，无需运行时申请
- **示例**：
  ```xml
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <uses-permission android:name="android.permission.SET_WALLPAPER" />
  ```

### 2. 危险权限
- **特点**：可能影响用户隐私或设备安全
- **申请方式**：需要在运行时动态申请
- **示例**：
  ```xml
  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  ```

### 3. 特殊权限
- **特点**：需要特殊处理流程
- **示例**：
  - `SYSTEM_ALERT_WINDOW`（悬浮窗）
  - `WRITE_SETTINGS`（修改系统设置）
  - `MANAGE_EXTERNAL_STORAGE`（访问所有文件，Android 11+）

## 二、运行时权限申请流程

### 完整示例代码

```java
public class PermissionHelper {
    
    private static final int REQUEST_CODE_PERMISSIONS = 1001;
    
    // 检查权限是否已授予
    public static boolean checkPermissions(Context context, String[] permissions) {
        for (String permission : permissions) {
            if (ContextCompat.checkSelfPermission(context, permission) 
                != PackageManager.PERMISSION_GRANTED) {
                return false;
            }
        }
        return true;
    }
    
    // 申请权限
    public static void requestPermissions(Activity activity, String[] permissions) {
        ActivityCompat.requestPermissions(activity, permissions, REQUEST_CODE_PERMISSIONS);
    }
    
    // 处理权限申请结果
    public static void handlePermissionsResult(
            int requestCode, 
            String[] permissions, 
            int[] grantResults,
            OnPermissionResultListener listener) {
        
        if (requestCode == REQUEST_CODE_PERMISSIONS) {
            boolean allGranted = true;
            for (int result : grantResults) {
                if (result != PackageManager.PERMISSION_GRANTED) {
                    allGranted = false;
                    break;
                }
            }
            
            if (allGranted) {
                listener.onAllGranted();
            } else {
                listener.onDenied();
            }
        }
    }
    
    // 检查是否需要显示权限说明
    public static boolean shouldShowRationale(Activity activity, String permission) {
        return ActivityCompat.shouldShowRequestPermissionRationale(activity, permission);
    }
    
    public interface OnPermissionResultListener {
        void onAllGranted();
        void onDenied();
    }
}
```

### 在 Activity 中使用

```java
public class MainActivity extends AppCompatActivity {
    
    private static final String[] REQUIRED_PERMISSIONS = {
        Manifest.permission.CAMERA,
        Manifest.permission.READ_EXTERNAL_STORAGE,
        Manifest.permission.WRITE_EXTERNAL_STORAGE
    };
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        checkAndRequestPermissions();
    }
    
    private void checkAndRequestPermissions() {
        if (PermissionHelper.checkPermissions(this, REQUIRED_PERMISSIONS)) {
            // 权限已授予，执行操作
            startCamera();
        } else {
            // 检查是否需要显示说明
            boolean shouldShowRationale = false;
            for (String permission : REQUIRED_PERMISSIONS) {
                if (PermissionHelper.shouldShowRationale(this, permission)) {
                    shouldShowRationale = true;
                    break;
                }
            }
            
            if (shouldShowRationale) {
                // 显示权限说明对话框
                showPermissionRationaleDialog();
            } else {
                // 直接申请权限
                PermissionHelper.requestPermissions(this, REQUIRED_PERMISSIONS);
            }
        }
    }
    
    private void showPermissionRationaleDialog() {
        new AlertDialog.Builder(this)
            .setTitle("需要权限")
            .setMessage("应用需要相机和存储权限才能正常工作")
            .setPositiveButton("确定", (dialog, which) -> {
                PermissionHelper.requestPermissions(this, REQUIRED_PERMISSIONS);
            })
            .setNegativeButton("取消", null)
            .show();
    }
    
    @Override
    public void onRequestPermissionsResult(int requestCode, 
            String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        
        PermissionHelper.handlePermissionsResult(
            requestCode, permissions, grantResults,
            new PermissionHelper.OnPermissionResultListener() {
                @Override
                public void onAllGranted() {
                    startCamera();
                }
                
                @Override
                public void onDenied() {
                    Toast.makeText(MainActivity.this, 
                        "权限被拒绝，无法使用功能", 
                        Toast.LENGTH_SHORT).show();
                    checkNeverAskAgain();
                }
            }
        );
    }
    
    private void checkNeverAskAgain() {
        boolean someNeverAskAgain = false;
        for (String permission : REQUIRED_PERMISSIONS) {
            if (!PermissionHelper.shouldShowRationale(this, permission) 
                && ContextCompat.checkSelfPermission(this, permission) 
                    != PackageManager.PERMISSION_GRANTED) {
                someNeverAskAgain = true;
                break;
            }
        }
        
        if (someNeverAskAgain) {
            new AlertDialog.Builder(this)
                .setTitle("权限被永久拒绝")
                .setMessage("请在设置中手动开启权限")
                .setPositiveButton("去设置", (dialog, which) -> {
                    openAppSettings();
                })
                .setNegativeButton("取消", null)
                .show();
        }
    }
    
    private void openAppSettings() {
        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
        Uri uri = Uri.fromParts("package", getPackageName(), null);
        intent.setData(uri);
        startActivity(intent);
    }
    
    private void startCamera() {
        // 启动相机
    }
}
```

## 三、使用 Google 简化库（推荐）

### 添加依赖
```gradle
implementation 'com.google.accompanist:accompanist-permissions:0.32.0'
```

### Kotlin 使用示例
```kotlin
@Composable
fun PermissionExample() {
    val cameraPermission = rememberPermissionState(
        Manifest.permission.CAMERA
    )
    
    Column(
        modifier = Modifier.fillMaxSize(),
        horizontalAlignment = Alignment.CenterHorizontally,
        verticalArrangement = Arrangement.Center
    ) {
        if (cameraPermission.status.isGranted) {
            Text("相机权限已授予")
            // 使用相机
        } else {
            Column {
                Text("需要相机权限")
                Button(onClick = { cameraPermission.launchPermissionRequest() }) {
                    Text("申请权限")
                }
            }
        }
    }
}
```

## 四、Android 版本差异处理

### Android 6.0 (API 23) 及以上
- 需要运行时申请危险权限

### Android 10 (API 29)
- 分区存储，需要使用 `MediaStore` 或 `Storage Access Framework`

### Android 11 (API 30)
- 需要使用 `MANAGE_EXTERNAL_STORAGE` 访问所有文件
- 需要在 `AndroidManifest.xml` 中声明可见性
  ```xml
  <queries>
      <package android:name="com.example.app" />
  </queries>
  ```

### Android 13 (API 33)
- 新增细粒度权限：
  - `READ_MEDIA_IMAGES`（图片）
  - `READ_MEDIA_VIDEO`（视频）
  - `READ_MEDIA_AUDIO`（音频）

```xml

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
```

## 五、权限组

Android 将相关权限分组，同一组中只要有一个权限被授予，该组其他权限也会被自动授予。

| 权限组 | 包含权限 |
|--------|----------|
| CALENDAR | READ_CALENDAR, WRITE_CALENDAR |
| CAMERA | CAMERA |
| CONTACTS | READ_CONTACTS, WRITE_CONTACTS, GET_ACCOUNTS |
| LOCATION | ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION |
| MICROPHONE | RECORD_AUDIO |
| PHONE | READ_PHONE_STATE, CALL_PHONE, READ_CALL_LOG, etc. |
| SENSORS | BODY_SENSORS |
| SMS | SEND_SMS, RECEIVE_SMS, READ_SMS, etc. |
| STORAGE | READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE |

## 六、注意事项

### 1. 必须在 AndroidManifest.xml 中声明
```xml
<uses-permission android:name="android.permission.CAMERA" />
```

### 2. 不要一次性申请过多权限
- 建议按需申请，在需要使用功能时再申请
- 一次申请不超过 3 个权限

### 3. 提供友好的权限说明
- 在申请前解释为什么需要该权限
- 使用对话框或引导页面说明

### 4. 处理权限被拒绝的情况
- 提供替代方案或引导用户手动开启
- 不要强制要求权限，否则可能导致用户卸载

### 5. 检查"不再询问"状态
```java
// 如果 shouldShowRequestPermissionRationale 返回 false
// 且权限未授予，说明用户选择了"不再询问"
```

### 6. 适配不同 Android 版本
```java
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    // 运行时权限申请
} else {
    // 直接使用权限
}
```

### 7. 特殊权限处理
```java
// 悬浮窗权限
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    if (!Settings.canDrawOverlays(this)) {
        Intent intent = new Intent(
            Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
            Uri.parse("package:" + getPackageName())
        );
        startActivityForResult(intent, REQUEST_CODE_OVERLAY);
    }
}

// 修改系统设置权限
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    if (!Settings.System.canWrite(this)) {
        Intent intent = new Intent(
            Settings.ACTION_MANAGE_WRITE_SETTINGS,
            Uri.parse("package:" + getPackageName())
        );
        startActivityForResult(intent, REQUEST_CODE_WRITE_SETTINGS);
    }
}
```

### 8. 使用 ContextCompat 检查权限
```java
// 推荐使用
ContextCompat.checkSelfPermission(context, permission)

// 而不是
context.checkSelfPermission(permission)
```

## 七、最佳实践总结

1. **最小权限原则**：只申请必要的权限
2. **按需申请**：在需要使用功能时再申请
3. **友好提示**：解释权限用途，提供清晰的说明
4. **优雅降级**：权限被拒绝时提供替代方案
5. **版本适配**：考虑不同 Android 版本的差异
6. **测试覆盖**：测试各种权限场景（授予、拒绝、不再询问）
7. **使用简化库**：考虑使用 Google 的 Accompanist 库简化权限处理

通过合理处理权限申请，可以提升用户体验，避免因权限问题导致应用功能异常。

MANAGE_EXTERNAL_STORAGE（访问所有文件，Android 11+）

如何在 Android 中申请权限？有什么需要注意的？

客户端

后端

编程语言

详解Android权限申请机制，包括普通权限、危险权限和特殊权限的分类与申请方式。提供运行时权限申请完整代码示例，介绍Google简化库使用，分析Android各版本权限差异及最佳实践。帮助开发者正确处理权限申请，提升应用兼容性和用户体验。

设备安全

Android

Kotlin

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

如何在 Android 中申请权限？有什么需要注意的？-腾讯云开发者社区-腾讯云

如何在 Android 中申请权限？有什么需要注意的？

如何在 Android 中申请权限？有什么需要注意的？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐