鸿蒙构建中如何获取Jenkins传递的环境变量参数

在鸿蒙（HarmonyOS）应用开发中，我们常常需要与Jenkins这样的持续集成工具集成，以便自动化构建和部署我们的应用。一个常见的需求是在构建过程中获取Jenkins传递的环境变量参数，并将这些参数应用到我们的源代码中。本文将详细介绍如何在鸿蒙构建过程中获取并使用Jenkins的环境变量。

问题背景

在我的项目中，我们接入了Jenkins系统来自动化构建流程。为了更好地管理和调试，我们需要在构建过程中获取一些关键的环境变量，如构建号、是否为发布构建等，并在我们的应用代码中使用这些信息。例如，我们希望在应用中显示构建号，以便在测试时快速定位问题。

解决方案探索

最初，我了解到可以通过hvigorfile.ts文件中的process.env.xxx来获取传递的环境变量参数。然而，问题在于如何将这些参数传递到源代码中，特别是在BuildProfile中使用。

实施步骤

自定义Hvigor插件：为了解决这个问题，我开始探索自定义Hvigor插件的可能性。Hvigor是鸿蒙的构建工具，它支持通过插件扩展其功能。我创建了一个自定义插件，用于在构建过程中注册新的任务，这些任务可以访问并处理环境变量。

typescript 复制代码

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

export function customPlugin(): HvigorPlugin {
    return {
        pluginId: 'customPlugin',
        context() {
            return {
                data: 'customPlugin xxx'
            };
        },
        async apply(currentNode: HvigorNode): Promise<void> {
            hvigor.nodesEvaluated(async () => {
                hapTask(currentNode);
            });
        }
    };
}

function hapTask(currentNode: HvigorNode) {
    currentNode.subNodes((node: HvigorNode) => {
        const hapContext = node.getContext(OhosPluginId.OHOS_HAP_PLUGIN) as OhosHapContext;
        const moduleName = hapContext?.getModuleName();
        const appContext = currentNode.getContext(OhosPluginId.OHOS_APP_PLUGIN) as OhosAppContext;
        const buildMode = appContext?.getBuildMode();
        const currentProduct = appContext?.getCurrentProduct();
        hapContext?.targets((target: Target) => {
            const targetName = target.getTargetName();
            const outputPath = target.getBuildTargetOutputPath();
            node.getTaskByName(`${target.getTargetName()}@SignHap`)?.setEnable(false);
            node.registerTask({
                name: `${targetName}@onlineSignHap`,
                run() {
                    console.log('targetName:' + targetName + ', moduleName:' + moduleName + ', buildMode:' + buildMode + ', currentProduct:' + currentProduct.getProductName());
                },
                dependencies: [`${targetName}@PackageHap`],
                postDependencies: ['assembleHap']
            });
        });
    });
}

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

在模块或har中注册任务 ：在自定义的Hvigor插件中，我定义了一个名为hapTask的函数，它遍历所有子节点，并为每个目标注册一个新的任务。这个任务在运行时会输出相关的环境变量信息，从而可以在构建过程中被捕获并在代码中使用。

结果与反思

通过实施上述步骤，我成功地在鸿蒙构建过程中获取了Jenkins传递的环境变量，并将这些信息应用到了我们的应用代码中。这不仅提高了我们的构建流程的自动化程度，也使得问题定位和调试变得更加高效。

在未来的工作中，我计划进一步优化这个插件，使其更加通用和易于集成，同时也考虑增加更多的功能，如自动生成版本信息等，以进一步提升开发效率。

通过这次实践，我深刻体会到在技术开发中，理解和掌握底层工具和框架的能力是非常重要的。这不仅可以帮助我们解决具体的技术问题，还可以提升我们的技术视野和解决复杂问题的能力。