因为项目中需要用到地图服务,所以不得不申请签名证书,过程太繁琐做个笔记,也方便大家参考。
开发设备:MacOS(M)
DevEco-Studio版本:5.0.3.400
签名基本概念
●密钥:包含非对称加密中使用的公钥和私钥,存储在密钥库文件中,格式为.p12,公钥和私钥对用于数字签名和验证。
●证书请求文件:格式为.csr,全称为Certificate Signing Request,包含密钥对中的公钥和公共名称、组织名称、组织单位等信息,用于向AppGallery Connect申请数字证书。
●数字证书:格式为.cer,由华为AppGallery Connect颁发。
●Profile文件:格式为.p7b,包含HarmonyOS应用/服务的包名、数字证书信息、描述应用/服务允许申请的证书权限列表,以及允许应用/服务调试的设备列表(如果应用/服务类型为Release类型,则设备列表为空)等内容,每个应用/服务包中均必须包含一个Profile文件。
手动签名步骤
手动签名共配置四个证书文件:
1.在 DevEco Studio 工具侧生成密钥(.p12)和证书请求文件(.csr)。
2.在 AppGallery Connect 侧申请应用证书(.cer)、Profile(.p7b)文件。
生成密钥和证书请求文件 .p12 和 .csr
官方文档
1、在主菜单栏单击 Build(构建) > Generate Key and CSR(生成私钥和证书请求文件)
2、在新打开页面中点击New
●注意!!!,一定要记住这个Password(我就是因为没记住又来了一遍)
●文件名是自定义的,后缀.p12
●OK
●下一步这个Alias也要记住,最好记个文本,后续要用
●只填必填项点Next会出错,应该是版本问题,以后会好吧
●Next
●这一步需要填csr文件路径和文件名,注意后缀.csr就行了
●Finish
●确认
3、到这一步就是用DevEco-Studio生成了密钥和证书请求文件,去刚才选择的路径可以看见.p12和.csr就对了
AppGallery Connect侧申请应用证书(.cer)。
●开发者账号需要实名认证
●每个账号最多申请2个调试证书(开发阶段)
●证书格式为.cer,包含公钥、证书指纹等信息
1、登录AppGallery Connect,点申请发布/调试证书
2、点新增,这可能会有之前用DevEco-Studio默认生成的证书,不用管。
3、在‘新增证书’窗口填写证书信息,点提交
●证书名称:不超过100个字符,随意。
●证书类型:选择“调试证书”。
●选取证书请求文件(CSR): 选择本地 .csr 文件,就是之前生成的那个。
4、证书申请成功后,“证书管理”页面展示证书名称等信息。点击“下载”,将生成的证书保存至本地,供后续签名使用。
AGC 创建HarmonyOS应用申请调试Profile .p7b
.p7b包含HarmonyOS应用/元服务的包名、数字证书信息、应用/元服务允许申请的证书权限列表,以及允许应用/元服务调试的设备列表(如果应用/元服务类型为Release类型,则设备列表为空)等内容。每个应用/元服务包中均必须包含一个Profile文件。
1、登录AppGallery Connect,点我的应用 -> 新增
●这要注意确保应用名称的唯一性,与项目中app.json5配置文件中的bundleName一致
●确认2、点击我的项目,打开在步骤1中新建的项目,打开会有补充包名的弹窗
●我这选的是手工输入,与项目中app.json5配置文件中的bundleName一致(应该可以自定义,不知道后续有啥影响)
●在我的项目页面中,选择“HarmonyOS应用 > HAP Provision Profile管理”,进入“管理HAP Provision Profile”页面,点击右上角“添加
●在弹出的“HarmonyAppProvision信息”窗口添加调试Profile,完成后点击“提交”
●名称:不超过100个字符,任意。
●类型:选择“调试”。
●选择证书:选择一个调试证书
●选择设备:选择一个或多个调试设备(列表中是当前账号登录过的设备,包括模拟器)
3、调试Profile申请成功后,“管理HAP Provision Profile”页面展示Profile信息。点击“下载”,将生成的Profile保存至本地,供后续签名使用。
配置签名信息
回到DevEco-Studio配置签名信息,选择自己刚才生成的文件,忘了密码的同学再来一遍。
查看签名信息是否成功
1、登录AppGallery Connect平台,在“我的项目”中选择目标应用,获取“项目设置 > 常规 > 应用”的Client ID。
2、添加公钥指纹
3、在工程中entry模块的 module.json5 文件中,新增 metadata,配置name为client_id,value为上一步获取的Client ID的值
4、登录AppGallery Connect网站,选择“我的项目”,选择目标项目,点击API管理。
找到地图开关,打开开关
5、运行官方地图示例
import { AsyncCallback } from '@kit.BasicServicesKit';
import { map, mapCommon, MapComponent } from '@kit.MapKit';
@Entry
@Component
struct HuaweiMapDemo {
private TAG = "HuaweiMapDemo";
private mapOption?: mapCommon.MapOptions;
private callback?: AsyncCallback<map.MapComponentController>;
private mapController?: map.MapComponentController;
aboutToAppear(): void {
// 地图初始化参数,设置地图中心点坐标及层级
this.mapOption = {
position: {
target: {
latitude: 39.9,
longitude: 116.4
},
zoom: 10
}
};
// 地图初始化的回调
this.callback = async (err, mapController) => {
if (!err) {
// 获取地图的控制器类,用来操作地图
this.mapController = mapController;
this.mapController.on("mapLoad", () => {
console.info(this.TAG, `on-mapLoad`);
});
}
};
}
build() {
Stack() {
// 调用MapComponent组件初始化地图
MapComponent({ mapOptions: this.mapOption, mapCallback: this.callback })
.width('100%')
.height('100%');
}
.height('100%')
}
}
打开虚拟机运行结果
案例地图渲染出来,签名应该是没问题了。。。
写在最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V3.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……
《鸿蒙开发进阶》
●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……
《鸿蒙进阶实战》
●ArkTS实践
●UIAbility应用
●网络案例
……