在前面的几篇里，我们已经把一个应用的骨架搭好了：
有路由、有状态、有网络
有登录、有列表、有缓存
页面结构也开始清晰
但到这里，很多同学会遇到一个分水岭问题：
❓ 为什么我的应用看起来像个 Web App？
因为它还没真正“用到系统能力”。
而 HarmonyOS 的核心价值，恰恰就在这里。
一、为什么“权限管理”是鸿蒙应用的必修课？
在真实应用中，你几乎一定会遇到：
读取设备信息
访问网络
使用相机 / 麦克风
读写文件
获取位置信息
而这些都离不开两个关键词：
权限 + 系统能力
📌权限 = 能不能用
📌系统能力 = 用来干什么
二、HarmonyOS 权限体系整体认知
HarmonyOS 权限主要分为三类：
| 权限类型 | 特点 |
|---|---|
| normal | 安装即授权 |
| system_basic | 运行时弹窗 |
| system_grant | 系统应用 |
我们日常开发99% 使用 system_basic。
三、在 module.json5 中声明权限（第一步）
示例：网络 + 设备信息权限
{ "module": { "requestPermissions": [ { "name": "ohos.permission.INTERNET" }, { "name": "ohos.permission.GET_DEVICE_INFO" } ] } }📌声明 ≠ 已授权
📌 声明只是“我可能会用”
四、运行时权限申请（真正的关键）
HarmonyOS 使用abilityAccessCtrl进行权限控制。
1️⃣ 引入模块
import abilityAccessCtrl from '@ohos.abilityAccessCtrl'2️⃣ 检查 & 请求权限
async function requestPermission(permission: string): Promise<boolean> { const atManager = abilityAccessCtrl.createAtManager() const result = await atManager.requestPermissionsFromUser( getContext(), [permission] ) return result.authResults[0] === 0 }📌 返回0表示授权成功
3️⃣ 使用示例
const granted = await requestPermission( 'ohos.permission.GET_DEVICE_INFO' ) if (!granted) { showToast('没有权限，无法继续') return }五、实战一：获取设备信息（最常见系统能力）
1️⃣ 引入模块
import deviceInfo from '@ohos.deviceInfo'2️⃣ 获取设备 ID
const deviceId = deviceInfo.deviceId const model = deviceInfo.productModel📌 常用于：
设备绑定
风控
日志追踪
3️⃣ 推荐封装成 Service
export async function getSafeDeviceInfo() { const ok = await requestPermission( 'ohos.permission.GET_DEVICE_INFO' ) if (!ok) return null return { id: deviceInfo.deviceId, model: deviceInfo.productModel } }📌 页面永远不直接碰权限逻辑
六、实战二：文件读写（缓存 / 导出必备）
1️⃣ 权限声明
{ "name": "ohos.permission.READ_USER_STORAGE" }, { "name": "ohos.permission.WRITE_USER_STORAGE" }2️⃣ 使用文件系统能力
import fs from '@ohos.file.fs' const path = '/data/storage/el2/base/test.txt' fs.writeText(path, 'Hello HarmonyOS')📌 建议统一路径管理
📌 不要硬编码到页面
七、实战三：调用相机（权限 + 能力组合）
1️⃣ 权限声明
{ "name": "ohos.permission.CAMERA" }2️⃣ 调用系统相机（示意）
import camera from '@ohos.camera' camera.openCamera({ success: () => { console.log('相机已打开') } })📌 HarmonyOS 强调能力调用 + 权限前置
八、权限管理的“正确架构姿势”
❌ 错误做法
onClick() { requestPermission() openCamera() }页面混乱
无法复用
难维护
✔ 正确做法
Page ↓ Service ↓ PermissionManager ↓ System Ability示例
CameraService.open()内部自己判断权限
九、用户拒绝权限怎么办？
这是必考点。
推荐策略
| 情况 | 处理 |
|---|---|
| 第一次拒绝 | Toast 提示 |
| 多次拒绝 | 引导设置页 |
| 关键权限 | 阻断功能 |
引导示例
showDialog( '需要相机权限', '请在系统设置中开启权限' )📌不要死循环弹窗
十、权限相关常见坑总结
⚠️ 忘记在 module.json5 声明
→ 永远申请失败
⚠️ 在 build 中申请权限
→ 无限重绘
⚠️ 页面直接使用系统 API
→ 架构混乱
⚠️ 不处理拒绝情况
→ 用户体验极差
十一、到这一篇，你已经进入“系统级开发”
你现在已经：
✔ 理解 HarmonyOS 权限模型
✔ 会运行时动态申请权限
✔ 能调用系统能力
✔ 知道如何设计权限架构
✔ 明白用户拒绝时如何兜底
这已经不是“UI 应用”，而是：
真正的 HarmonyOS 原生应用
结语
权限不是限制，而是你与系统之间的契约。
理解它、尊重它、封装它，
你的应用才能稳定、可靠、可扩展。
