鸿蒙多环境配置(二)

你是否每次手动更改发布证书打app包上加应用市场呢？你是否每次打完包都手动在名称后添加版本号和时间呢？不同环境的依赖包经常打包时忘记改呢？其实这些鸿蒙都支持动态配置。

认识hvigor编译构建

hvigor将工程解析为一个树形结构，项目为树的根节点，项目中的每个模块为树的叶子节点，树最多为两层，模块中不能包含其他模块，在hvigor的定义中统称项目或模块为一个node(节点)。在构建最开始的初始化阶段，会通过hvigorconfig.ts文件以及工程级build-profile.json5文件中的配置来构造出一个树形结构存储项目的工程结构，工程级build-profile.json5文件和hvigorconfig.ts文件均可以配置多模块。

hvigor是基于任务对您的项目进行自动化构建的，任务（Task）是hvigor构建过程中的基本工作单元，它定义了构建项目时需要执行的具体工作。任务可以完成多种操作，比如源码编译任务，打包任务或签名任务等。每一种任务的执行逻辑由插件（plugin）提供，插件可以是由hvigor-ohos-plugin提供的默认任务逻辑，也可由您个性化定制。

如何动态配置发布证书

发布证书是在应用打包APP上架应用市场时使用，所以有人将debug环境配置为调试证书，release环境配置为发布证书是不对的，用发布证书打包的应用是不能直接运行到手机上。
我们可以对比一下调试证书和发布证书，不一样的是profile、certpath、keyPassword和storePassword，我们只需要在hvigor中判断当前任务是在打包APP，就可以将这些值动态替换为发布证书的值。比如我们正常在build-profile.json5中配置调试证书如下

{
  "app": {
    "signingConfigs": [
      {
        "name": "default",
        "type": "HarmonyOS",
        "material": {
          "keyAlias": "harmony",
          "storeFile": "key/key.p12",
          "signAlg": "SHA256withECDSA",
          "profile": "key/key_debug.p7b",
          "certpath": "key/key_debug.cer",
          "keyPassword": "password_debug",
          "storePassword": "password_debug"
        }
      }
    ]
  }
}

在根目录下的hvigorfile.ts可以这么处理

import { appTasks, OhosAppContext, OhosPluginId } from '@ohos/hvigor-ohos-plugin';
import { hvigor } from '@ohos/hvigor'

hvigor.getRootNode().afterNodeEvaluate(node => {
  const appCtx = node.getContext(OhosPluginId.OHOS_APP_PLUGIN) as OhosAppContext;
  const profileOpt = appCtx.getBuildProfileOpt()
  if (hvigor.getCommandEntryTask() === 'assembleApp') {
    const signArray = profileOpt['app']['signingConfigs']
    for (const element of signArray) {
      element['material']['profile'] = 'key/key_release.p7b'
      element['material']['certpath'] = 'key/key_release.cer'
      element['material']['storePassword'] = 'password_release'
      element['material']['keyPassword'] = 'password_release'
    }
  }
  appCtx.setBuildProfileOpt(profileOpt)
})

打包时如何动态设置APP版本和日期

我们可以在根目录下的hvigorfile.ts中动态获取项目的版本号以及通过Date获取打包时的日期时间，并追加到APP的名称上，示例如下

import { appTasks, OhosAppContext, OhosPluginId } from '@ohos/hvigor-ohos-plugin';
import { hvigor } from '@ohos/hvigor'

hvigor.getRootNode().afterNodeEvaluate(node => {
  const appCtx = node.getContext(OhosPluginId.OHOS_APP_PLUGIN) as OhosAppContext;
  const profileOpt = appCtx.getBuildProfileOpt()
  const jsonOpt = appCtx.getAppJsonOpt()
  const products = profileOpt['app']['products']
  for (const element of products) {
    element['output']['artifactName'] += `-${jsonOpt['app']['versionName']}-${getDate()}`
  }
  appCtx.setBuildProfileOpt(profileOpt)
})

function getDate(): string {
  const date = new Date()
  const dateStr = `${date.getFullYear()}${parseNum(date.getMonth() + 1)}${parseNum(date.getDate())}`
  const timeStr = `${parseNum(date.getHours())}${parseNum(date.getMinutes())}${parseNum(date.getSeconds())}`
  return `${dateStr}${timeStr}`
}

function parseNum(num: number): string {
  return num < 10 ? `0${num}` : `${num}`
}

假如我们在build-profile.json5中配置artifactName的值为app，则打包的名称为app-1.0.0-20241027204510.app

如何根据不同的环境依赖不同的库

比如我们要在开发环境依赖flutter的debug包，在生产环境依赖flutter的release包该怎么处理呢？我们可以在oh-package.json5中先配置debug包，在模块下的hvigorfile.ts中检测到当前是生产环境，则动态的将依赖包替换为release版本。oh-package.json5的配置如下

{
  "dependencies": {
    "flutter": "file:libs/flutter_debug.har"
  }
}

假如生产环境的product配置为prod，则hvigorfile.ts中的示例如下

import { hapTasks, OhosHapContext, OhosPluginId } from '@ohos/hvigor-ohos-plugin'
import { getNode } from '@ohos/hvigor'

const entryNode = getNode(__filename)
entryNode.afterNodeEvaluate(node => {
    const hapCtx = node.getContext(OhosPluginId.OHOS_HAP_PLUGIN) as OhosHapContext
    hapCtx.targets((target)=>{
        if (target.getCurrentProduct().getProductName() === 'prod') {
            const depOpt = hapCtx.getDependenciesOpt()
            depOpt["flutter"]="file:libs/flutter_release.har"
            hapCtx.setDependenciesOpt(depOpt)
        }
    })
})

在hvigorfile.ts中可以做很多事情，可以动态更改app.json5、module.json5、build-profile.json5和oh-package.json5中的很多内容，大家可以多尝试尝试，有了这些能力，就不用担心打包时忘记更改或改错了。