场景描述
引导用户跳转到系统设置页进行权限,通知的相关设置,类似android和iOS应用中常见的应用内跳转到设置进行通知开启或权限设置的操作。
应用经常会遇到如下的业务诉求:
场景一:如果应用首次拒绝了消息通知,应用希望能够引导用户拉起设置应用设置允许通知,用来接收应用内的推送消息;并且在设置完后返回页面可以监听到修改后的状态。
场景二:当用户使用一些需要用户授权的api时(如访问获取联系人信息),若用户首次拒绝授权,则需要引导用户到权限设置页面能够主动进行应用权限的修改。
场景三:支持打开/关闭系统功能如Wi-Fi、NFC、移动网络、蓝牙等。
方案描述
场景一:
如果应用首次拒绝了消息通知,应用希望能够引导用户拉起设置应用设置允许通知,用来接收应用内的推送消息;并且在设置完后返回页面可以监听到修改后的状态。
效果图
方案
1、通过startability显式拉起设置应用-通知管理界面,配置相应的want信息(不推荐使用隐式拉起的方式)。
2、在进入页面时通过Notification.requestEnableNotification()监听应用请求通知使能
核心代码
为Button绑定拉起事件
Button(this.buttonText).onClick(()=>{
let context = getContext(this) as common.UIAbilityContext;
let want: Want = {
bundleName: 'com.huawei.hmos.settings',//设置应用bundleName
abilityName: 'com.huawei.hmos.settings.MainAbility',//设置应用abilityName
uri: "systemui_notification_settings",//通知管理页面
parameters: {
pushParams: {
bundleName:context.abilityInfo.bundleName//拉起方应用包名
}
};
context.startAbility(want)
}).margin(10)
Text(this.message)
在打开页面时获取通知管理中按钮状态,Notification.requestEnableNotification()请求发送通知的许可,第一次调用会弹窗让用户选择。
onPageShow(): void {
Notification.requestEnableNotification().then(() => {
//已打开通知
this.message = "已允许接收消息推送。"
this.buttonText = "去关闭通知"
console.info("requestEnableNotification success");
}).catch((err:Error) => {
//未打开通知
this.message = "已禁止接收消息推送。"
this.buttonText = "去开启通知"
console.info("requestEnableNotification error");
});
}
场景二:
当用户使用一些需要用户授权的api时(如访问获取联系人信息),若用户首次拒绝授权,则需要引导用户到权限设置页面能够主动进行应用权限的修改。
是否为用户授权可参考 允许ACL跨级别申请-应用权限列表-应用权限管控-程序访问控制-Ability Kit(程序框架服务)-开发 | 华为开发者联盟 (huawei.com)
效果图
方案
暂无直接跳转权限管理的方式,可通过跳转至应用详情进行用户申请权限的修改
核心代码
为button绑定获取联系人信息事件:
Button("获取联系人").onClick(async () => {
const permissions: Array<Permissions> = ['ohos.permission.READ_CONTACTS'];
let context: Context = getContext(this) as common.UIAbilityContext;
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
// requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗
atManager.requestPermissionsFromUser(context, permissions).then((data: PermissionRequestResult) => {
//grantStatus:授权状态:0 已授权 1未授权 2未授权 表示请求无效,
let grantStatus: Array<number> = data.authResults;
let length: number = grantStatus.length;
for (let i = 0; i < length; i++) {
if (grantStatus[i] === 0) {
// 已经授权,可以继续访问目标操作
this.getContact(context)
} else {
// 用户拒绝授权,提示用户必须授权才能访问当前功能,并引导用户到系统设置中打开相应的权限
this.contacts = []
this.dialogControllerConfirm.open()
return;
}
}
}).catch((err: BusinessError) => {
console.error(`Failed to request permissions from user. Code is ${err.code}, message is ${err.message}`);
})
}).margin(10)
调用 contact.queryContacts获取联系人信息
getContact(context:Context){
contact.queryContacts(context, (err: BusinessError, data) => {
this.contacts = data
});
}
拒接授权后的引导弹窗:
dialogControllerConfirm: CustomDialogController = new CustomDialogController({
builder: AlertDialog({
content: '已拒绝访问系统通讯录,是否前往开启?',
primaryButton: {
value: '取消',
action: () => {},
},
secondaryButton: {
value: '确认',
fontColor: $r('sys.color.ohos_id_color_warning'),
action: () => {
this.openAppInfo()
}
},
}),
autoCancel: true,
customStyle: true,
alignment: DialogAlignment.Bottom
})
进入设置-应用详情页
openAppInfo(){
let context = getContext(this) as common.UIAbilityContext;
context.startAbility({
bundleName: 'com.huawei.hmos.settings',
abilityName: 'com.huawei.hmos.settings.MainAbility',
uri: 'application_info_entry',
parameters: {
pushParams: "com.example.startability"
}
});
}
场景三:
支持打开/关闭系统功能如Wi-Fi、NFC、移动网络、蓝牙等
效果图
同设置应用内相应界面
方案
通过配置对应的uri进行跳转,蓝牙uri:“bluetooth_entry”,NFC uri:“nfc_settings”,移动网络uri:“mobile_network_entry”
核心代码
Button("to蓝牙").onClick(()=> {
let context = getContext(this) as common.UIAbilityContext;
context.startAbility({
bundleName: 'com.huawei.hmos.settings',
abilityName: 'com.huawei.hmos.settings.MainAbility',
uri:"bluetooth_entry",
});
}).margin(10)
Button("toNFC").onClick(()=> {
let context = getContext(this) as common.UIAbilityContext;
context.startAbility({
bundleName: 'com.huawei.hmos.settings',
abilityName: 'com.huawei.hmos.settings.MainAbility',
uri:"nfc_settings",
});
}).margin(10)
Button("to移动网络").onClick(()=> {
let context = getContext(this) as common.UIAbilityContext;
context.startAbility({
bundleName: 'com.huawei.hmos.settings',
abilityName: 'com.huawei.hmos.settings.MainAbility',
uri:"mobile_network_entry",
});
}).margin(10)
鸿蒙全栈开发全新学习指南
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以要有一份实用的鸿蒙(HarmonyOS NEXT)学习路线与学习文档用来跟着学习是非常有必要的。
针对一些列因素,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。
本路线共分为四个阶段:
第一阶段:鸿蒙初中级开发必备技能
第二阶段:鸿蒙南北双向高工技能基础:gitee.com/MNxiaona/733GH
第三阶段:应用开发中高级就业技术
第四阶段:全网首发-工业级南向设备开发就业技术:gitee.com/MNxiaona/733GH
《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?
1.基本概念
2.构建第一个ArkTS应用
3.……
开发基础知识:gitee.com/MNxiaona/733GH
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
鸿蒙开发面试真题(含参考答案):gitee.com/MNxiaona/733GH
鸿蒙入门教学视频:
美团APP实战开发教学:gitee.com/MNxiaona/733GH
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:
gitee.com/MNxiaona/733GH