HarmonyOS 配置应用自定义签名


在 HarmonyOS 应用开发过程中,运行鸿蒙应用到真机是需要签名的,开发同学往往会选择自动签名,但是自动签名不同的人不同的开发者账号,通过自动签名后的信息都是不同的,这时候签名信息的管理就显得尤为重要。为了提升团队协作效率、减少配置冲突,我们可以将签名信息配置为**可自定义文件**,以便团队成员根据自身需求灵活管理。本文将介绍如何通过 `signdata.json` 文件实现签名配置的模块化与自动化。

---

## 一、创建签名信息文件(signdata.json)

首先,我们需要在项目根目录下创建一个 JSON 文件,用于存放签名信息。文件名可根据实际情况自定义,比如我们命名为 `signdata.json`。文件内容结构如下:

```json
{
  "certpath": "xxxx.cer",
  "keyAlias": "debugKey",
  "keyPassword": "myKeyPassword",
  "profile": "xxxx.p7b",
  "signAlg": "xxxx",
  "storeFile": "xxxx.p12",
  "storePassword": "myStorePassword"
}
```

> ✅ 建议不要将此文件上传至版本控制系统(如 Git),可通过 `.gitignore` 忽略该文件,以保障签名信息的私密性。

可以在工程级.gitignore文件里添加 /signdata.json
---
## 二、在工程级 `hvigorfile.ts` 中引入签名信息

在项目的根级别 `hvigorfile.ts` 文件中,导入我们刚刚创建的 `signdata.json` 文件。示例代码如下:

```ts
import signData from './signdata.json';
```

引入成功后,即可在构建配置中使用相关信息,在plugins平级添加config节点,在config添加子节点ohos,代码如下:
```ts
import { appTasks } from '@ohos/hvigor-ohos-plugin';
import * as data from "./signdata.json";
const needsSigning = true

export default {
    system: appTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
    plugins:[],         /* Custom plugin to extend the functionality of Hvigor. */
    config:{
        ohos:{
        }
    }
}

```
---

## 三、封装获取签名信息的函数

为了代码更清晰、逻辑更独立,我们可以在 `hvigorfile.ts` 中封装一个函数,用于获取签名配置:

```ts
/* 从自定义data.json文件获取签名信息 */
function getSigningConfig() {
    if(needsSigning){
        return{
            signingConfig:{
                "type": "HarmonyOS",
                "material": {
                    "certpath": data.certpath,
                    "storePassword": data.storePassword,
                    "keyAlias": data.keyAlias,
                    "keyPassword": data.keyPassword,
                    "profile": data.profile,
                    "signAlg": data.signAlg,
                    "storeFile": data.storeFile
                }
            }
        }
    }
}
```
这样,其他构建模块只需调用该函数即可获得完整签名信息,便于后续维护和多成员并行开发。

---

## 四、将自动签名内容抽离到 `signdata.json`

在原有构建配置中,自动签名的签名信息通常直接写在 `build-profile.json5s` 中,随着项目复杂度的增加,人员设备的变动等,这种方式不利于维护。

我们可以将`build-profile.json5s` 中的`signingConfigs`节点里的代码迁移到`signdata.json`中,如下:

```ts
{
  "certpath": "/Users/admin/.ohos/config/default_signdata_example_ewsaR-SOaBqfod-eIAwDgAeE2lBwrQn-8NRU01BDOX4=.cer",
  "keyAlias": "debugKey",
  "keyPassword": "0000001BD18F617B42AC67518AFAAEED6F111AE5DD2410CC1130D03A38A0941EF12B7CF6C70716977AB5ED",
  "profile": "/Users/admin/.ohos/config/default_signdata_example_ewsaR-SOaBqfod-eIAwDgAeE2lBwrQn-8NRU01BDOX4=.p7b",
  "signAlg": "SHA256withECDSA",
  "storeFile": "/Users/admin/.ohos/config/default_signdata_example_ewsaR-SOaBqfod-eIAwDgAeE2lBwrQn-8NRU01BDOX4=.p12",
  "storePassword": "0000001B70A28142A3555F7A5AA5F7E8863681B049F1E8D8D306673CDD4B81F82008D7A2F435F192E76506"
}
```

迁移至 `signdata.json` 中,并通过`hvigorfile.ts` 的 `getSigningConfig()` 函数引用。最终,在构建模块中使用如下方式配置:

```ts
export default {
    system: appTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
    plugins:[],         /* Custom plugin to extend the functionality of Hvigor. */
    config:{
        ohos:{
            overrides:getSigningConfig()
        }
    }
}
```

这样即可实现签名信息的集中管理与代码分离。

---

## 五、总结

在不方便创建debug签名的时候,通过将签名信息抽离到 `signdata.json` 文件,并在 `hvigorfile.ts` 中进行统一引用,我们可以有效地提升代码可读性与团队协作效率:

* 每位成员可本地维护自己的签名文件;
* 防止签名信息冲突;
* 签名信息不再硬编码,增强安全性;
* 配置变更更灵活,维护成本更低。

---

当然最好的办法是,是创建应用后,生成对应的debug签名,所有的成员共用一套debug签名,创建debug签名的方法可以参考官网:[多人协作时DevEco Studio如何引用一份签名文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-signature-service-8)

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值