(目录)
1. 准备工作
1.1 共享包har和hsp文件（自行开发）
qhj_privacy_library.har
qhj_privacy_library-default-signed.hsp
1.2 安装共享包har文件（使用方安装）
D:\xxxDemo\entry> ohpm install ..\qhj_privacy_library.har
2. 动态共享包使用介绍
2.1 共享包导出一个首选项数据库类和一个Dialog组件
export { PreferencesUtil } from "./utils/PreferencesUtil"
export { CustomDialogPrivacy } from './dialog/CustomDialogPrivacy'
2.2 PreferencessUtil提供了创建首选项数据库，保存数据，修改数据
export class PreferencesUtil {
createPrivacyPreferences(context)
saveDefaultPrivacy(isAgree: boolean)
saveChangePrivacy(isAgree: boolean)
async getChangePrivacy()
async deleteChangePrivacy()
}
2.3 CustomDialogPrivacy对话框提供更改标题，文本，本地html或远程html文件配置
// 隐私协议标题
private title?: string = '协议和隐私政策提示'
// 前辍隐私协议信息
private prefixMessage?: string = '感谢您选择xxx元服务！我们非常重视您....'
// 后辍隐私协议信息
private suffixMessage?: string = '的全部内容。'
// 隐私协议信息，点击可以跳转
private privacyMessage?: string = '《协议与隐私政策》'
// 本地html文件或http和https返回html文件
private localHtml?: boolean = true
// 隐私协议URL 支持本地html或http和https返回html
private urlPage?: string = ""
3. 使用方如何调用
3.1 在EntryAbility.ts的onCreate初始化首选项数据
import { CustomDialogPrivacy,PreferencesUtil } from 'qhj_privacy_library'
let preferencesUtil = new PreferencesUtil();
onCreate(want, launchParam) {
// 创建首选项数据库
preferencesUtil.createPrivacyPreferences(this.context);
// 设置隐私协议默认不同意
preferencesUtil.saveDefaultPrivacy(false);
}
3.2 在Index.ets页面调用共享包自定义Dialog
import { CustomDialogPrivacy,PreferencesUtil } from 'qhj_privacy_library'
let preferencesUtil = new PreferencesUtil();
// 开始显示隐私协议对话框
/**
* 如果localHtml参数为true,urlPage参数为空，显示默认隐私协议
* 如果localHtml参数为true,urlPage参数不为空，显示urlPage参数本地html文件
* 如果localHtml参数为false,urlPage参数为空，显示默认隐私协议
* 如果localHtml参数为false,urlPage参数不为空，显示urlPage参数http或https返回html文件
*/
privacyDialogController: CustomDialogController = new CustomDialogController({
builder: CustomDialogPrivacy({
localHtml: true,
urlPage: 'privacy.html'
// urlPage: 'https://id1.cloud.huawei.com/AMW/portal/agreements/userAgreement/zh-cn_userAgreement.html'
}),
autoCancel: false,
alignment: DialogAlignment.Center,
customStyle: true
})
onPageShow() {
console.info('xx onPageShow 显示隐私协议')
preferencesUtil.getChangePrivacy().then((value) => {
console.info(`xx onPageShow 获取隐私协议状态：${value}`)
if (!value) {
this.privacyDialogController.open()
}
})
}
onPageHide() {
console.info(`xx Index -> onPageHide Close Start`)
this.privacyDialogController.close()
console.info(`xx Index -> onPageHide Close End`)
}
aboutToDisappear() {
console.info(`xx Index -> aboutToDisappear`)
delete this.privacyDialogController
this.privacyDialogController = null
}
// 结束显示隐私协议对话框
4. 补充内容
4.1 跨包页面路由跳转
若想在library模块中的Dialog点击文本跳转到隐私协议页面（路径为：library/src/main/ets/pages/PrivacyPage.ets），那么可以在Dialog的代码（library模块下的CustomDialogPrivacy.ets，路径为：qhj_privacy_library/src/main/ets/dialog/CustomDialogPrivacy.ets）里这样使用：
.onClick(() => {
this.controller.close()
router.pushUrl({
url: '@bundle:com.xxx.study/qhj_privacy_library/ets/pages/PrivacyPage',
params: {
localHtml: this.localHtml,
pageUrl: this.urlPage
}
}).then(() => {
console.info("xx push page success");
}).catch(err => {
console.error(`xx pushUrl failed, code is ${err.code}, message is ${err.message}`);
})
})
其中router.pushUrl方法的入参中url的内容为：
'@bundle:com.xxx.study/qhj_privacy_library/ets/pages/PrivacyPage'
url内容的模板为：
'@bundle:包名（bundleName）/模块名（moduleName）/路径/页面所在的文件名(不加.ets后缀)'
4.2 应用内HSP开发指导
应用内HSP开发指导-HSP-共享包-应用程序包基础知识-开发基础知识-入门-HarmonyOS应用开发
4.3 应用间HSP的调试方式
开发者本地调试应用间HSP相关的功能时，可以通过相关指令本地完成应用间HSP的分发，主要步骤如下：
- 获取到应用间
HSP的安装包。 - 通过指令先安装应用间
HSP的安装包。hdc install qhj_privacy_library-default-signed.hsp - 通过指令后安装开发者自身的应用
hap。hdc install library_privacy-demo.hap - 启动开发者自身的应用，调试相关功能。 注意：步骤2和步骤3不可以颠倒，否则会由于缺少必要的应用间
HSP导致开发者的应用安装失败。
4.4 打包HSP和HAP注意事项
打包HSP和HAP用手工签名，也就是不能用自动签名，如果生成HSP包时用自动签名，生成HAP包时也是用自动签名，安装时，就会提示签名不一致。生成签名证书请看官方文档：
为应用/服务进行签名-调试HarmonyOS应用/服务-应用/服务调试-DevEco Studio使用指南-工具-HarmonyOS应用开发
5. 总结
通过开发隐私协议对话框动态共享包，学习到了跨包页面路由跳转，HSP动态共享包开发、引用和调试，同时也为以后App上架做好准备工作，这样以后开发的项目都可以引用这个隐私协议共享包，大大缩小开发时间和成本。
本文作者：狼哥Army