HarmonyOs应用权限申请，system_grant和user_grant区别。本文附头像上传申请user-grant权限代码示例

k&p

已于 2024-08-24 16:06:11 修改

阅读量2k

点赞数 36

分类专栏： Harmony Os应用开发文章标签： harmonyos 鸿蒙华为

于 2024-08-24 16:04:53 首次发布

本文链接：https://blog.csdn.net/s_407/article/details/141499651

版权

Harmony Os应用开发专栏收录该内容

10 篇文章 0 订阅

订阅专栏

HarmonyOs应用权限申请，system_grant和user_grant区别。本文附头像上传申请user-grant权限代码示例

system_grant（系统授权）

system_grant指的是系统授权类型，在该类型的权限许可下，应用被允许访问的数据不会涉及到用户或设备的敏感信息，应用被允许执行的操作对系统或者其他应用产生的影响可控

user_grant（用户授权）

user_grant指的是用户授权类型，在该类型的权限许可下，应用被允许访问的数据将会涉及到用户或设备的敏感信息，应用被允许执行的操作可能对系统或者其他应用产生严重的影响。

权限APL等级

根据权限对于不同等级应用有不同的开放范围，权限类型对应分为以下三个等级，等级依次提高。

APL级别说明开放范围
normal 允许应用访问超出默认规则外的普通系统资源，如配置Wi-Fi信息、调用相机拍摄等。这些系统资源的开放（包括数据和功能）对用户隐私以及其他应用带来的风险低。 APL等级为normal及以上的应用。
system_basic 允许应用访问操作系统基础服务（系统提供或者预置的基础功能）相关的资源，如系统设置、身份认证等。这些系统资源的开放对用户隐私以及其他应用带来的风险较高。 - APL等级为system_basic及以上的应用。- 部分权限对normal级别的应用受限开放，这部分权限在本指导中描述为“受限开放权限”。
system_core 涉及开放操作系统核心资源的访问操作。这部分系统资源是系统最核心的底层服务，如果遭受破坏，操作系统将无法正常运行。 - APL等级为system_core的应用。- 仅对系统应用开放。

每次执行需要目标权限的操作时，应用都必须检查自己是否已经具有该权限。

如需检查用户是否已向您的应用授予特定权限，可以使用checkAccessToken()函数，此方法会返回Promise<[GrantStatus]>：PERMISSION_GRANTED或PERMISSION_DENIED。

每次访问受目标权限保护的接口之前，都需要使用requestPermissionsFromUser()接口请求相应的权限。

用户可能在动态授予权限后通过系统设置来取消应用的权限，因此不能将之前授予的授权状态持久化。

user_grant权限授权要基于用户可知可控的原则，需要应用在运行时主动调用系统动态申请权限的接口，系统弹框由用户授权，用户结合应用运行场景的上下文，识别出应用申请相应敏感权限的合理性，从而做出正确的选择。

系统不鼓励频繁弹窗打扰用户，如果用户拒绝授权，将无法再次拉起弹窗，需要应用引导用户在系统应用“设置”的界面中手动授予权限。

API12新增可以二次向用户申请授权requestPermissionOnSetting()

系统权限弹窗不可被遮挡。

系统权限弹窗不可被其他组件/控件遮挡，弹窗信息需要完整展示，以便用户识别并完成授权动作。

如果系统权限弹窗与其他组件/控件同时同位置展示，系统权限弹窗将默认覆盖其他组件/控件。

APL级别	说明	开放范围
normal	允许应用访问超出默认规则外的普通系统资源，如配置Wi-Fi信息、调用相机拍摄等。这些系统资源的开放（包括数据和功能）对用户隐私以及其他应用带来的风险低。	APL等级为normal及以上的应用。
system_basic	允许应用访问操作系统基础服务（系统提供或者预置的基础功能）相关的资源，如系统设置、身份认证等。这些系统资源的开放对用户隐私以及其他应用带来的风险较高。	- APL等级为system_basic及以上的应用。- 部分权限对normal级别的应用受限开放，这部分权限在本指导中描述为“受限开放权限”。
system_core	涉及开放操作系统核心资源的访问操作。这部分系统资源是系统最核心的底层服务，如果遭受破坏，操作系统将无法正常运行。	- APL等级为system_core的应用。- 仅对系统应用开放。

代码示例：点击头像申请访问相机和相册媒体的权限，拒绝后二次点击半模态弹窗按钮向用户进行二次权限申请：
实现思路：
1.点击头像时利用checkAccessToken()检查当前是否已拥有权限，如果有则直接使用，如果没有则使用requestPermissionsFromUser()进行向用户询问权限授权
2.如果用户全部拒绝，下一次使用时则使用requestPermissionOnSetting()进行二次用户询问拉起弹窗（也可以引导用户去设置界面手动授权，在requestPermissionsFromUser()拒绝策略中即可实现）

//校验权限工具类

import { abilityAccessCtrl,Context, bundleManager, common, Permissions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
/**
 * 校验当前是否已经授权（已封装成工具类，如使用三层架构则可放入common中）
 * @param permission
 * @returns
 */
export async function checkPermissionGrant(permission: Permissions): Promise<abilityAccessCtrl.GrantStatus> {
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
  let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;
  // 获取应用程序的accessTokenID
  let tokenId: number = 0;
  try {
    let bundleInfo: bundleManager.BundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
    let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
    tokenId = appInfo.accessTokenId;
  } catch (error) {
    const err: BusinessError = error as BusinessError;
    console.error(`Failed to get bundle info for self. Code is ${err.code}, message is ${err.message}`);
  }
  // 校验应用是否被授予权限
  try {
    grantStatus = await atManager.checkAccessToken(tokenId, permission);
  } catch (error) {
    const err: BusinessError = error as BusinessError;
    console.error(`Failed to check access token. Code is ${err.code}, message is ${err.message}`);
  }

  return grantStatus;
}
/**
 *向用户二次询问拉起弹窗授权
 */
export function reqPermissionTwice(permissions: Array<Permissions>, context: common.UIAbilityContext): Promise<Array<abilityAccessCtrl.GrantStatus>> {
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
  return atManager.requestPermissionOnSetting(context, permissions)
}

//主页面（其中涉及一些工具类未提供，不影响本次示例功能实现，布局会有影响。项目代码还在开发中，之后会开源）

import {AppStorageEnum,NavigationBar,HdUser,hdHttp,cameraCapture,HdLoadingDialo,logger,authStore,reqPermissionTwice,checkPermissionGrant} from "@ss/basic"
import { fileIo, picker } from '@kit.CoreFileKit'
import { BusinessError, request } from '@kit.BasicServicesKit'
import { promptAction } from '@kit.ArkUI'
import { router } from '@kit.ArkUI'
import { abilityAccessCtrl, common, Permissions } from '@kit.AbilityKit'

@Component
export struct MineIndexView {
  pageInfos: NavPathStack = new NavPathStack()
  @StorageProp(AppStorageEnum.TOP_AVOID_HEIGHT)
  avoidTopHeight: number = 0
  @StorageProp(AppStorageEnum.LOGIN_USER)
  loginUser: HdUser = {} as HdUser
  @State isShowSheet: boolean = false
  dialog: CustomDialogController = new CustomDialogController({
    builder: HdLoadingDialog({ message: '更新中...' }),
    customStyle: true,
    alignment: DialogAlignment.Center
  })
  permissions: Array<Permissions> = ['ohos.permission.CAMERA', 'ohos.permission.WRITE_MEDIA'];
  isGrantFirst: boolean = false

  aboutToAppear(): void {
    console.log(JSON.stringify(this.loginUser))
    // this.checkPermissions()
  }

  async checkPermissions(permission: Permissions): Promise<void> {
    //通过checkAccessToken校验本次usergrant是否已授权
    let grantStatus: abilityAccessCtrl.GrantStatus = await checkPermissionGrant(permission);

    //根据返回结果处理业务
    const currentPermission: Array<Permissions> = [permission]
    if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) { //授权
      logger.info("已授权")
      if (currentPermission[0] == this.permissions[0]) {
        this.updateAvatarForCamera()
      } else {
        this.updateAvatarForPhotos()
      }
    } else { //未授权
      logger.info("未授权")
      if (this.isGrantFirst) { //因为二次询问授权之前必须调用一次requestPermissionsFromUser
        //二次向用户申请授权api12拥有
        reqPermissionTwice(currentPermission, getContext(this) as common.UIAbilityContext)
          .then((data: Array<abilityAccessCtrl.GrantStatus>) => {
            if (data[0] == abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
              if (currentPermission[0] == this.permissions[0]) {
                this.updateAvatarForCamera()
              } else {
                this.updateAvatarForPhotos()
              }
            }
          })
          .catch((err: BusinessError) => {
            console.error('data:' + JSON.stringify(err));
          });
      }
    }
  }

  //询问用户是否授权，只会调起一次弹窗
  reqPermissionsFromUser(permissions: Array<Permissions>, context: common.UIAbilityContext): void {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    // requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗
    atManager.requestPermissionsFromUser(context, permissions).then((data) => {
      let grantStatus: Array<number> = data.authResults;
      let length: number = grantStatus.length;
      let count: number = 0
      for (let i = 0; i < length; i++) {
        count = count + 1
        if (grantStatus[i] === 0) {
          // 用户授权，可以继续访问目标操作
          this.isShowSheet = true
        } else {
          // 用户拒绝授权，提示用户必须授权才能访问当前页面的功能，并引导用户到系统设置中打开相应的权限
          if(count == length)
            this.isShowSheet = false
        }
      }
      // 授权成功
    }).catch((err: BusinessError) => {
      console.error(`Failed to request permissions from user. Code is ${err.code}, message is ${err.message}`);
    })
  }

  /**
   * 唤起相机上传图片
   */
  async updateAvatarForCamera() {
    //调用相机唤起工具类
    let URI = await cameraCapture(getContext(this) as common.UIAbilityContext)
    if (URI != undefined) {
      // 2. 存储到沙箱中(fileIo在API9之后就废弃了，使用fs替换)
      const context = getContext(this)
      const fileType = 'jpg'
      const fileName = Date.now() + '.' + fileType
      const copyFilePath = context.cacheDir + '/' + fileName
      const file = fileIo.openSync(URI, fileIo.OpenMode.READ_ONLY)
      fileIo.copyFileSync(file.fd, copyFilePath)
      // 3. 准备请求配置
      const config: request.UploadConfig = {
        url: hdHttp.baseURL + 'userInfo/avatar',
        method: 'POST',
        header: {
          'Accept': '*/*',
          'Authorization': `Bearer ${this.loginUser.token}`,
          'Content-Type': 'multipart/form-data'
        },
        files: [
          {
            name: 'file', //multipart提交时，表单项目的名称，缺省为file
            uri: `internal://cache/` + fileName, //仅支持"internal"协议类型，"internal://cache/"为应用的私有目录，是必填字段
            type: fileType, //文件的内容类型，默认根据文件名或路径的后缀获取。
            filename: fileName //multipart提交时，请求头中的文件名。
          }
        ],
        data: []
      }
      // 4. 开始上传
      this.dialog.open() //自定义加载弹窗
      request.uploadFile(context, config, (err, data) => {
        if (err) {
          return logger.error('UPLOAD', err.message)
        }
        data.on('complete', () => {
          // 5. 更新头像
          hdHttp.get<HdUser>('userInfo').then(res => {
            this.loginUser.avatar = res.data.avatar
            authStore.setUser(this.loginUser)
            promptAction.showToast({ message: '更新头像成功' }) //提示弹窗
            this.dialog.close()
          })
        })
      })
    }
  }

  /**
   * 唤起相册上传图片
   */
  updateAvatarForPhotos() {
    const photoSelectOptions = new picker.PhotoSelectOptions()
    photoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE
    photoSelectOptions.maxSelectNumber = 1

    const photoViewPicker = new picker.PhotoViewPicker()
    photoViewPicker.select(photoSelectOptions).then(result => {
      // 1. 得到文件路径
      const URI = result.photoUris[0]
      // 2. 存储到沙箱中(fileIo在API9之后就废弃了，使用fs替换)
      const context = getContext(this)
      const fileType = 'jpg'
      const fileName = Date.now() + '.' + fileType
      const copyFilePath = context.cacheDir + '/' + fileName
      const file = fileIo.openSync(URI, fileIo.OpenMode.READ_ONLY)
      fileIo.copyFileSync(file.fd, copyFilePath)
      // 3. 准备请求配置
      const config: request.UploadConfig = {
        url: hdHttp.baseURL + 'userInfo/avatar',
        method: 'POST',
        header: {
          'Accept': '*/*',
          'Authorization': `Bearer ${this.loginUser.token}`,
          'Content-Type': 'multipart/form-data'
        },
        files: [
          {
            name: 'file', //multipart提交时，表单项目的名称，缺省为file
            uri: `internal://cache/` + fileName, //仅支持"internal"协议类型，"internal://cache/"为应用的私有目录，是必填字段
            type: fileType, //文件的内容类型，默认根据文件名或路径的后缀获取。
            filename: fileName //multipart提交时，请求头中的文件名。
          }
        ],
        data: []
      }
      // 4. 开始上传
      this.dialog.open() //自定义加载弹窗
      request.uploadFile(context, config, (err, data) => {
        if (err) {
          return logger.error('UPLOAD', err.message)
        }
        data.on('complete', () => {
          // 5. 更新头像
          hdHttp.get<HdUser>('userInfo').then(res => {
            this.loginUser.avatar = res.data.avatar
            authStore.setUser(this.loginUser)
            promptAction.showToast({ message: '更新头像成功' }) //提示弹窗
            this.dialog.close()
          })
        })
      })
    })
  }

  @Builder
  builderMenuBack() {
    Button({ type: ButtonType.Circle }) { //设置按钮的类型未圆形按钮
      Image($r("app.media.left"))
    }.onClick(() => {
      router.back()
    })
    .width(25)
    .height(25)
    .backgroundColor('rgba(255, 255, 255, 0)')
  }

  @Builder
  builderMenuMail() {
    Button({ type: ButtonType.Circle }) { //设置按钮的类型未圆形按钮
      Image($r("app.media.mail"))
    }.onClick(() => {
      this.pageInfos.pushPathByName("MailCenterView", false);
    })
    .width(25)
    .height(25)
    .backgroundColor('rgba(255, 255, 255, 0)')
  }

  /**
   * 半模态对话框
   */
  @Builder
  buildAvatarSheet() {
    Column() {
      Text("拍照")
        .width('100%')
        .height('50%')
        .lineHeight('45%')
        .textAlign(TextAlign.Center)
        .backgroundColor('#e5e7ed')
        .onClick(() => {
          this.isShowSheet = !this.isShowSheet
          this.checkPermissions(this.permissions[0])
        })

      Divider().color(Color.White)

      Text("从相册选择")
        .width('100%')
        .height('50%')
        .lineHeight('45%')
        .textAlign(TextAlign.Center)
        .backgroundColor('#e5e7ed')
        .onClick(() => {
        //并非多次一举，再调用reqPermissionsFromUser之前如果打开半模态化转场会阻塞主线程（原因不知）
          if(!this.isGrantFirst) {
                this.isGrantFirst = true
                this.reqPermissionsFromUser(this.permissions, getContext(this) as common.UIAbilityContext)
              }else{
                this.isShowSheet = !this.isShowSheet
              }
        })

    }
    .width('100%')
    .height(150)
  }

  build() {
    Navigation(this.pageInfos) {
      Column() {
        NavigationBar({
          buildButtonBackParam: () => {
            this.builderMenuBack()
          },
          buildMenuOneParam: () => {
            this.builderMenuMail()
          }
        })

        Flex({ alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center, direction: FlexDirection.Column }) {
          Image($rawfile('kyrie.jpg'))
            .id("mine")
            .width(90)
            .height(90)
            .clip(true)
            .borderRadius(45)
            .margin({ top: 45 })
            .geometryTransition("avatar")
            .transition(TransitionEffect.opacity(0.99))
            .onClick(() => {
              this.isShowSheet = !this.isShowSheet
              if(!this.isGrantFirst)
                this.reqPermissionsFromUser(this.permissions, getContext(this) as common.UIAbilityContext)
            })

          Text(this.loginUser.username)
            .fontWeight(700)
            .fontSize(16)
            .margin({ top: 8 })

          Button({ type: ButtonType.Capsule, stateEffect: false }) {
            Text("终身大会员")
              .fontColor("#7f8085")
              .fontSize(12)
          }
          .width(150)
          .height(32)
          .margin({ top: 8 })
          .backgroundColor("#dbdce1")
        }
        .bindSheet(this.isShowSheet, this.buildAvatarSheet(), {
          height: 150,
          dragBar: false,
          showClose: false,
          onDisappear: () => {
            this.isShowSheet = false
          }
        })
        .width("90%")
        .height(200)

      }
      .width('100%')
      .transition(TransitionEffect.asymmetric(
        TransitionEffect.opacity(0.99),
        TransitionEffect.OPACITY
      ))
      .height('100%')
    }
    .backgroundColor("#e4e5ea")

  }
}