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,过滤后的日志信息如下。
本网站的文章部分内容可能来源于网络和网友发布,仅供大家学习与参考,如有侵权,请联系站长进行删除处理,不代表本网站立场,转载者并注明出处:https://www.jmbhsh.com/baobaofuzhuang/36152.html