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()
系统权限弹窗不可被遮挡。
系统权限弹窗不可被其他组件/控件遮挡,弹窗信息需要完整展示,以便用户识别并完成授权动作。
如果系统权限弹窗与其他组件/控件同时同位置展示,系统权限弹窗将默认覆盖其他组件/控件。
代码示例:点击头像申请访问相机和相册媒体的权限,拒绝后二次点击半模态弹窗按钮向用户进行二次权限申请:
实现思路:
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;// 获取应用程序的accessTokenIDlet 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 = falsedialog: CustomDialogController = new CustomDialogController({builder: HdLoadingDialog({ message: '更新中...' }),customStyle: true,alignment: DialogAlignment.Center})permissions: Array<Permissions> = ['ohos.permission.CAMERA', 'ohos.permission.WRITE_MEDIA'];isGrantFirst: boolean = falseaboutToAppear(): 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 = 0for (let i = 0; i < length; i++) {count = count + 1if (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() + '.' + fileTypeconst copyFilePath = context.cacheDir + '/' + fileNameconst 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提交时,表单项目的名称,缺省为fileuri: `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.avatarauthStore.setUser(this.loginUser)promptAction.showToast({ message: '更新头像成功' }) //提示弹窗this.dialog.close()})})})}}/*** 唤起相册上传图片*/updateAvatarForPhotos() {const photoSelectOptions = new picker.PhotoSelectOptions()photoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPEphotoSelectOptions.maxSelectNumber = 1const 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() + '.' + fileTypeconst copyFilePath = context.cacheDir + '/' + fileNameconst 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提交时,表单项目的名称,缺省为fileuri: `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.avatarauthStore.setUser(this.loginUser)promptAction.showToast({ message: '更新头像成功' }) //提示弹窗this.dialog.close()})})})})}@BuilderbuilderMenuBack() {Button({ type: ButtonType.Circle }) { //设置按钮的类型未圆形按钮Image($r("app.media.left"))}.onClick(() => {router.back()}).width(25).height(25).backgroundColor('rgba(255, 255, 255, 0)')}@BuilderbuilderMenuMail() {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)')}/*** 半模态对话框*/@BuilderbuildAvatarSheet() {Column() {Text("拍照").width('100%').height('50%').lineHeight('45%').textAlign(TextAlign.Center).backgroundColor('#e5e7ed').onClick(() => {this.isShowSheet = !this.isShowSheetthis.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 = truethis.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.isShowSheetif(!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")}
}
效果图:
1.第一次点击头像
2.假如全部拒绝,第二次访问继续询问(具体业务权限)