HarmonyOS成功灵活放开授权

Nothing theoretical can be clearer than the code. 本期笔者将以一个Demo为例,与读者们独特讨论在ArkUI的框架中如何成功灵活放开授权的配置。

通常状况下，一些提供基础配置的权限可以经过静态的方式失掉（即间接将开发者须要的权限在模块级别的module.json5文件中申明），如联网权限。而关于一些能够为运行提供用户的隐衷数据的敏感权限，则须要以灵活的方式可视化地向用户放开。本期的Demo以放开失掉大抵位置权限(即"ohos.permission.APPROXIMATELY_LOCATION")为例,成功灵活放开权限的配置。

关上DevEco Studio(开发工具的版本必定支持API9)，创立一个新的project，相关勾选如下：

成功创立工程后，在工程文件目录中关上目录:entry/src/main/module.json5, 减少两个权限——定位权限（"ohos.permission.LOCATION"）和失掉大抵位置的权限（"ohos.permission.APPROXIMATELY_LOCATION" ）。

{"module": {"name": "entry","type": "entry","description": "$string:module_desc","mainElement": "EntryAbility","deviceTypes": ["phone"],"deliveryWithInstall": true,"installationFree": false,"pages": "$profile:main_pages",//减少模块所需的相关权限"requestPermissions": [{"name": "ohos.permission.APPROXIMATELY_LOCATION","usedScene": {"abilities": ["EntryAbility"],"when": "inuse"}},{"name": "ohos.permission.LOCATION","usedScene": {"abilities": ["EntryAbility"],"when": "inuse"}},],......}}

理想上，当运行同时失掉以上两种权限后，运行可以失掉设施的精准位置，精准度在米级别。

要成功向用户灵活放开授权的配置，咱们须要制造两个配置模块，区分是审核能否已取得所需权限的配置和向用户动员权限放开的配置。为了到达公共调用和配置模块化，咱们须要将这两个配置模块集成到两个不同的TypeScript文件中，并将可调用接口导出。

在ets文件夹下新建目录，并将其命名为Service。

在Service目录下新建两个TypeScript文件（右键Service目录，选用新建，再选用TypeScript），区分命名为Detector与Applicant。

在编辑器中关上Detector.ts，参与以下代码以集成审核运行能否已取得所需权限的配置，各代码块的详细配置已写注解。

//导入程序访问控制治理模块import abilityAccessCtrl, { Permissions } from '@ohos.abilityAccessCtrl';//导入包治理模块import bundleManager from '@ohos.bundle.bundleManager';///定义待检测的权限列表const permissionsList: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION']//权限数据的列表//模块的日志标签const TAG = '------[Detector] 'const APPROVAL:number = 0//自动导出的模块接口export default async function Check_Access(){//创立AtManager实例let atManager = abilityAccessCtrl.createAtManager()//定义部分变量grantStatuslet grantStatus:abilityAccessCtrl.GrantStatus//定义部分变量tokenIdlet tokenId:numbertry{//期待包治理模块失掉本模块所在的包的BundleInfolet bundleInfo:bundleManager.BundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)//失掉上述BundleInfo中携带的ApplicationInfolet appInfo:bundleManager.ApplicationInfo = bundleInfo.appInfo//获上述ApplicationInfo携带的accessTokenIdtokenId = appInfo.accessTokenId}catch (err){console.error(TAG+`getBundleInfoForSelf failed, code is ${err.code}, message is ${err.message}`)}try{//应用AtManager实例审核能否已取得所需权限grantStatus = await atManager.checkAccessToken(tokenId,permissionsList[0])}catch (err){console.error(TAG+`checkAccessToken failed, code is ${err.code}, message is ${err.message}`)}//依据不同的审核结果做不同的输入if(grantStatus == APPROVAL){console.info(TAG+'Accessible')return true}else {console.error(TAG+'Inaccessible')return false}}

由于笔者已给代码减少了注释，所以笔者就不对这个模块做太多啰嗦的剖析了。这个模块的大抵口头逻辑是，经过调用系统才干@ohos.bundle.bundleManager失掉本包的accessTokenId，再调用系统才干@ohos.abilityAccessCtrl，在传入accessTokenId和权限列表的条件下审核module能否已失掉权限列表中的每个权限。当atManager的异步方法checkAccessToken前往结果为0时，示意所需权限均已被提供。

在编辑器中关上Applicant.ts，参与以下代码以集成向用户动员权限放开的配置，各代码块的详细配置已写注解。

//导入程序访问控制治理模块import abilityAccessCtrl, { Permissions } from '@ohos.abilityAccessCtrl'//导入commonimport common from '@ohos.app.ability.common';//定义待灵活放开的权限列表const permissionsList: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION']const APPROVAL:number = 0//模块的日志标签const TAG = '------[Applicant] '//自动导出的模块接口export default async function Request_Permission_From_Users(context:common.UIAbilityContext){//预约义函数口头结果的形态let isFinished:boolean = false//创立AtManager实例let atManager = abilityAccessCtrl.createAtManager()//期待程序访问控制模块成功权限恳求的异步操作，成功后依据前往结果口头then()或catch()await atManager.requestPermissionsFromUser(context, permissionsList).then((result)=>{//将API前往的数据存储到变量grantStatus中let grantStatus: Array<number> = result.authResults//判别用户能否提供一切相关权限for(let i = 0 ; i < grantStatus.length ; i++){if(grantStatus[i] === APPROVAL){//用户提供一切权限， ===指的是全等console.info(TAG+'Succeed! Obtain all the permissions')isFinished = true//将函数口头结果的形态设置为true}else{//用户未提供一切权限console.error(TAG+'User denies providing the permissions')}}}).catch((err)=>{console.error(TAG+`Request permission failed, code is ${err.code}, message is ${err.message}`)})return isFinished}

这个模块的大抵口头逻辑是，在atManager的异步方法requestPermissionsFromUser。

中传入所需的高低文对象和待放开权限列表，并期待其异步环节的完结。在requestPermissionsFromUser的异步环节中，系统会弹出选用框，征询用户能否提供权限。当用户点击选用框中的准许或制止时，权限会被授予或否，异步环节随即完结（此处指的是放开单个权限的场景），requestPermissionsFromUser将放开结果以number型数组的方式输入。当此数组中的每个元素的值都为0时，示意一切权限都成功取得，否则，用户拒绝授权了至少一个权限。

Detector.ts和Applicant.ts均自动导出了接口，想要在其他中央调用它们的配置，只需导入接口即可。

减少图片资源

在工程文件目录中关上目录：src/main/resources/rawfile, 减少两张恣意的图片(可以在IDE中将待减少的图片资源间接粘贴至rawfile目录下，也可以在文件资源治理器中经过文件门路关上rawfile目录并减少图片资源)，区分命名为image1和image2。当然，图片的格局没有要求，只需在之后的步骤中能被正确援用即可。

关上Index.ets，删除原有的Text组件，新增两个Button组件和一个Image组件（相关属性设置如下），并申明一个用@state润色的布尔变量ifAccessible。

@Entry@Componentstruct Index {//将运行能否失掉权限这条信息用布尔型变量ifAccessible贮存@State ifAccessible:boolean = falsebuild() {Row() {Column() {//减少两个Button组件和一个Image组件//条件渲染Image组件if(this.ifAccessible){Image($rawfile('image2.png')).height(200).width(200)}else{Image($rawfile('image1.png')).height(200).width(200)}//第一个Button组件Button('审核运行能否取得权限').fontSize(20).width('70%').margin({top:40}).backgroundColor(Color.Pink)//第二个Button组件Button('向用户灵活放开权限').fontSize(20).width('70%').margin({top:20}).backgroundColor(Color.Pink)}.width('100%')}.height('100%')}}

首先，在组件Index之外用struct申明一个新的自定义组件dialog，并用装璜器@CustomDialog对其启动润色，使dialog领有成为自定义弹窗的才干。接着，咱们对弹窗显示的内容启动自定义设置，在build函数中参与自定义UI申明。其中，CustomDialogController类型的成员变量controller和字符串类型成员变量message皆必无法少，后者可用于对dialog的外部传参。

之后，咱们在组件Index中new两个弹窗控制器（ CustomDialogController类的实例），并区分将它们赋予两个私有成员变量（dialogController_Accessible和dialogController_Inaccessible）以供调用。当然，咱们是用两个message不同的dialog组件来结构这两个弹窗控制器的，所以弹窗控制器dialogController_Accessible和弹窗控制器dialogController_Inaccessible可用于关上和封锁它们所对应的dialog。

@Entry@Componentstruct Index {@State message: string = 'Hello World'......//new两个弹窗控制器private dialogController_Accessible : CustomDialogController = new CustomDialogController({builder:dialog({message:'已失掉权限'})})private dialogController_Inaccessible : CustomDialogController = new CustomDialogController({builder:dialog({message:'暂未失掉权限'})})build() {......}}//自定义弹窗@CustomDialogstruct dialog{controller:CustomDialogController@State message:string = ''build(){Column() {Text(this.message).fontSize(20).height(40).fontColor(Color.White)}.width('100%').backgroundColor(Color.Gray)}}

首先，咱们从先前步骤中已集成的配置模块Detector导入异步函数Check_Access，并自定义异步方法detect。在detect的方法体中，咱们经过关键字await期待异步环节，这象征者原本的异步义务变成了一个等价的延时同步义务，保障了detect中操作语句的顺序口头。由于关键字await只能在异步方法或异步函数中产生，所以detect必定是异步方法。依据Check_Access的不同前往结果（成功或失败），系统会生成不同内容的弹窗与用户交互。detect()编写完后，咱们在用于审核运行能否取得权限的Button组件的onclick事情中参与此异步方法。

import Check_Access from 'ets/Service/Detector'//从模块Detector中导入异步函数Check_Access@Entry@Componentstruct Index {.....//编写异步方法detect,调用之前已写好的模块文件Detectorasync detect(){let res = await Check_Access()this.ifAccessible = resif(res){this.dialogController_Accessible.open()}else{this.dialogController_Inaccessible.open()}}......build() {Row() {Column() {......Button('审核运行能否取得权限').fontSize(20).width('70%').margin({top:40}).backgroundColor(Color.Pink)//设置onclick回调，并调用异步函数detect().onClick(()=>{this.detect()})......}.width('100%')}.height('100%')}}......

接着，咱们从先前步骤中已集成的配置模块Applicant中导入异步函数Request_Permission_From_Users，并导入common。随后，咱们经过getContext方法失掉高低文对象，并将其转化为UIAbilityContext类型，存入私有成员变量context中。之后，自定义异步方法apply，在方法体中将成员变量context传入异步函数Request_Permission_From_Users中。这样，咱们便可在用于向用户灵活放开权限的Button组件的onclick事情中参与自定义方法apply了。

......import Request_Permission_From_Users from 'ets/Service/Applicant'import common from '@ohos.app.ability.common'@Entry@Componentstruct Index {......//失掉高低文对象, 贮存在成员变量context中private context = getContext(this) as common.UIAbilityContext//编写异步方法,调用之前已写好的模块文件Applicantasync apply(){let res = await Request_Permission_From_Users(this.context)this.ifAccessible = resif(res){this.dialogController_Accessible.open()}else{this.dialogController_Inaccessible.open()}}......build() {Row() {Column() {......Button('向用户灵活放开权限').fontSize(20).width('70%').margin({top:20}).backgroundColor(Color.Pink)//设置onclick回调，并调用异步函数apply().onClick(()=>{this.apply()})}.width('100%')}.height('100%')}}......

Demo成功之后，咱们须要用模拟器或真机来运转以检查成果。

理想上，变量ifAccessible的值应该保留在本地的数据库里，这样每次从新创立此Demo的页面实例时，才干正确地显示对应图像，读者们可以自行修复这个bug。

当然，咱们也可以关上日志栏，经过日志信息观察配置模块的运转。关上编辑器下方的Hilog，勾选'show only js log'，并在标签挑选栏中输入0FEFE，过滤后的日志信息如下。