1. 准备工作

1.1共享包har和hsp文件（自行开发）

qhj_privacy_library.har
qhj_privacy_library-default-signed.hsp<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

1.2安装共享包har文件（使用方安装）

D:\xxxDemo\entry> ohpm install …\qhj_privacy_library.har<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

2. 动态共享包使用介绍

2.1 共享包导出一个首选项数据库类和一个Dialog组件

export { PreferencesUtil } from “./utils/PreferencesUtil”
export { CustomDialogPrivacy } from './dialog/CustomDialogPrivacy’<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

2.2 PreferencessUtil提供了创建首选项数据库，保存数据，修改数据

export class PreferencesUtil {
createPrivacyPreferences(context)
saveDefaultPrivacy(isAgree: boolean)
saveChangePrivacy(isAgree: boolean)
async getChangePrivacy()
async deleteChangePrivacy()
}<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

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 = ""<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

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);
}<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

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: ‘http://xxx.com/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() {
delete this.privacyDialogController
this.privacyDialogController = null
}
// 结束显示隐私协议对话框<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

4. 补充内容

4.1 跨包页面路由跳转

若想在library模块中的Dialog点击文本跳转到隐私协议页面（路径为：library/src/main/ets/pages/PrivacyPage.ets），那么可以在Dialog的代码（library模块下的CustomDialogPrivacy.ets，路径为：qhjprivacylibrary/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});
})
})<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

其中router.pushUrl方法的入参中url的内容为：

'@bundle:com.xxx.study/qhj_privacy_library/ets/pages/PrivacyPage’<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

url内容的模板为：

'@bundle:包名（bundleName）/模块名（moduleName）/路径/页面所在的文件名(不加.ets后缀)'<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

4.2 应用内HSP开发指导

应用内HSP开发指导-HSP-共享包-应用程序包基础知识-开发基础知识-入门-HarmonyOS应用开发

4.3 应用间HSP的调试方式

开发者本地调试应用间HSP相关的功能时，可以通过相关指令本地完成应用间HSP的分发，主要步骤如下：

1. 获取到应用间HSP的安装包。
2. 通过指令先安装应用间HSP的安装包。

   hdc install qhj_privacy_library-default-signed.hsp<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

3. 通过指令后安装开发者自身的应用hap。

   hdc install library_privacy-demo.hap<button style="position: absolute; padding: 4px 8px 0px; cursor: pointer; top: 8px; right: 8px; font-size: 14px;">复制</button>

4. 启动开发者自身的应用，调试相关功能。

注意：步骤2和步骤3不可以颠倒，否则会由于缺少必要的应用间HSP导致开发者的应用安装失败。

4.4 打包HSP和HAP注意事项

打包HSP和HAP用手工签名，也就是不能用自动签名，如果生成HSP包时用自动签名，生成HAP包时也是用自动签名，安装时，就会提示签名不一致。生成签名证书请看官方文档：

为应用/服务进行签名-调试HarmonyOS应用/服务-应用/服务调试-DevEco Studio使用指南-工具-HarmonyOS应用开发

5. 总结

通过开发隐私协议对话框动态共享包，学习到了跨包页面路由跳转，HSP动态共享包开发、引用和调试，同时也为以后App上架做好准备工作，这样以后开发的项目都可以引用这个隐私协议共享包，大大缩小开发时间和成本。