​

 

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: '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
}
// 结束显示隐私协议对话框

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}`);
    })
})

其中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的分发，主要步骤如下：

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

   hdc install qhj_privacy_library-default-signed.hsp

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

   hdc install library_privacy-demo.hap

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

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

4.4 打包HSP和HAP注意事项

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

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

5. 总结

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

​

 

关于坚果派

坚果派由坚果创建，团队拥有12个华为HDE，以及若干其他领域的三十余位万粉博主运营。专注于分享的技术包括HarmonyOS/OpenHarmony，ArkUI-X，元服务，服务卡片，华为自研语言，AI、BlueOS操作系统、团队成员聚集在北京，上海，南京，深圳，广州，宁夏等地，欢迎合作。