HarmonyOS 健康追踪应用（上）：权限管理全流程实战

在开发应用时，合理的权限管理至关重要。以健康追踪应用为例，我们可以深入了解权限管理的各个环节，确保应用既能满足功能需求，又能保护用户隐私。

一、场景驱动的权限规划

在开发健康追踪应用之前，我们需要明确各个功能模块所需的权限及其使用场景。下面展示了主要功能模块与权限的对应关系：

特别需要注意的是，LOCATION 权限的 when 属性应设置为 inuse。因为如果需要在后台使用定位功能，必须另外申请 LOCATION_BACKGROUND 权限。并且，申请后台定位权限会触发系统级通知，所以在需求分析阶段就要明确是否有必要使用后台定位。

二、module.json 的精细化配置

在明确了权限规划后，我们需要在 module.json 文件中进行权限声明。以下是针对运动轨迹记录功能的权限声明示例：

{
  "requestPermissions": [
    {
      "name": "ohos.permission.LOCATION",
      "reason": "记录运动轨迹，以便在地图上显示您的跑步路线",
      "usedScene": {
        "ability": ["MapActivity"],
        "when": "inuse"
      }
    }
  ]
}

reason 字段的优化

reason 字段应包含 “功能 - 价值 - 场景” 三要素。这样可以帮助用户清楚地理解申请权限的必要性，提高用户授权的可能性。

usedScene 的作用

usedScene 字段用于限定权限的使用范围。在上面的示例中，我们将权限限定在 MapActivity 前台运行时生效。这种设置符合最小权限原则，只在必要的场景下申请权限，减少对用户隐私的潜在影响。

三、权限管理类的封装设计

为了更好地管理权限申请逻辑，我们可以封装一个 PermissionManager 类。这个类可以实现智能申请和防骚扰逻辑：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';

class PermissionManager {
  private deniedCount: Map<string, number> = new Map();

  async smartRequest(permission: string, context: any): Promise<boolean> {
    const isDeniedTooMany = this.deniedCount.get(permission) || 0 >= 3;

    if (isDeniedTooMany) {
      this.guideToSettings(permission);
      return false;
    }

    try {
      const atManager = abilityAccessCtrl.createAtManager();
      const result = await atManager.requestPermissionsFromUser(context, [permission]);

      if (result.authResults[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
        this.deniedCount.delete(permission);
        return true;
      } else {
        this.deniedCount.set(permission, (this.deniedCount.get(permission) || 0) + 1);
        return false;
      }
    } catch (error) {
      console.error('权限申请失败:', error);
      return false;
    }
  }

  private guideToSettings(permission: string) {
    // 打开系统权限设置页
    console.log(`引导用户为权限 ${permission} 前往系统设置页`);
    // 实际项目中，此处应替换为打开系统设置的具体实现代码
  }
}

拒绝次数记录

在 PermissionManager 类中，我们使用 Map 来存储每个权限被拒绝的次数。每次权限申请被拒绝时，拒绝次数会增加；如果权限申请成功，拒绝次数会被重置。为了确保数据持久化，我们可以在应用启动时从 SharedPreferences 中加载拒绝次数记录，并在应用退出时保存。

防骚扰逻辑

如果某个权限被拒绝的次数达到 3 次，PermissionManager 类将不再弹出权限申请弹窗，而是直接引导用户前往系统设置页。这种设计符合鸿蒙系统的交互规范，避免频繁打扰用户，提升用户体验。

四、UI 层集成与页面交互逻辑

在完成了权限声明和 PermissionManager 类的封装后，我们需要将权限管理逻辑与 UI 层进行集成。以下是主要的集成步骤和交互逻辑：

权限状态驱动的 UI 渲染

根据权限状态动态渲染 UI 元素，确保用户界面能够准确反映当前权限状态：

@Entry
@Component
struct CameraPage {
  @State private hasCameraPermission: boolean = false;

  private permissionManager: PermissionManager = new PermissionManager();

  build() {
    Column() {
      if (this.hasCameraPermission) {
        Button('启动相机')
          .onClick(this.startCamera)
      } else {
        Text('相机权限未开启')
          .fontSize(16)
          .margin({ top: 20 })
      }

      Button('申请相机权限')
        .onClick(this.requestCameraPermission)
    }
    .padding({ left: 20, right: 20, top: 20 })
  }

  private async requestCameraPermission() {
    const permission = 'ohos.permission.CAMERA';
    this.hasCameraPermission = await this.permissionManager.smartRequest(permission, getContext());
  }

  private startCamera() {
    console.log('启动相机');
    // 相机启动逻辑
  }
}

在上述代码中，我们根据相机权限的状态动态显示不同的 UI 内容。如果权限已开启，显示 “启动相机” 按钮；如果权限未开启，显示提示信息 “相机权限未开启”，并提供一个 “申请相机权限” 按钮供用户点击申请权限。

分步引导的用户体验优化

为了优化用户体验，我们可以设计一个分步引导流程，逐步引导用户完成必要权限的申请。这可以通过创建一个引导页面来实现：

@Entry
@Component
struct GuidePage {
  @State private currentPage: number = 0;

  build() {
    Column() {
      if (this.currentPage === 0) {
        this.buildWelcomePage();
      } else if (this.currentPage === 1) {
        this.buildPermissionGuidePage();
      } else if (this.currentPage === 2) {
        this.buildFeatureIntroductionPage();
      }
    }
  }

  private buildWelcomePage() {
    Column() {
      Text('欢迎使用健康追踪')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 100 })

      Button('开始')
        .onClick(() => { this.currentPage = 1; })
        .margin({ top: 30 })
    }
  }

  private buildPermissionGuidePage() {
    Column() {
      Text('我们需要以下权限来为您提供更好的服务')
        .fontSize(18)
        .margin({ top: 100 })

      List() {
        ListItem() {
          Text('位置权限：用于记录运动轨迹')
        }
        ListItem() {
          Text('相机权限：用于拍摄运动照片')
        }
        ListItem() {
          Text('身体传感器权限：用于监测心率')
        }
      }

      Button('申请权限')
        .onClick(() => { this.requestPermissions(); })
        .margin({ top: 30 })
    }
  }

  private buildFeatureIntroductionPage() {
    Column() {
      Text('应用主要功能')
        .fontSize(18)
        .margin({ top: 100 })

      List() {
        ListItem() {
          Text('运动轨迹记录：记录您的跑步路线')
        }
        ListItem() {
          Text('照片拍摄：记录运动瞬间')
        }
        ListItem() {
          Text('心率监测：实时监测您的心率变化')
        }
      }

      Button('完成')
        .onClick(() => { this.navigateToMainPage(); })
        .margin({ top: 30 })
    }
  }

  private async requestPermissions() {
    const permissionManager = new PermissionManager();
    const locationPermissionGranted = await permissionManager.smartRequest('ohos.permission.LOCATION', getContext());
    const cameraPermissionGranted = await permissionManager.smartRequest('ohos.permission.CAMERA', getContext());
    const bodySensorsPermissionGranted = await permissionManager.smartRequest('ohos.permission.BODY_SENSORS', getContext());

    if (locationPermissionGranted && cameraPermissionGranted && bodySensorsPermissionGranted) {
      this.currentPage = 2;
    } else {
      console.log('部分权限未授予');
    }
  }

  private navigateToMainPage() {
    router.push('/main');
  }
}

在分步引导页面中，我们首先向用户展示欢迎信息，然后逐步引导用户了解所需权限及其用途，并提供申请权限的按钮。如果用户授予了所有必要权限，引导流程将继续到功能介绍页面；如果部分权限未授予，我们可以在后续的功能使用中根据需要再次申请权限。

五、总结

通过本篇的实践案例，我们深入学习了鸿蒙健康追踪应用的权限管理全流程。从场景驱动的权限规划，到 module.json 的精细化配置，再到权限管理类的封装设计以及 UI 层的集成，我们逐步将理论知识转化为可落地的代码实现。这种系统化的权限管理方法，不仅能够满足应用的功能需求，还能有效保护用户隐私，提升用户体验。

在实际开发中，合理的权限管理是构建安全、可靠应用的重要保障。希望本篇的内容能够为开发者提供有益的指导，帮助大家更好地理解和应用鸿蒙系统的权限管理机制。