1 背景介绍

随着物联网和智能设备的迅速发展，操作系统的多元化需求日益凸显。鸿蒙系统作为华为研发的面向全场景的分布式操作系统，旨在打破不同设备之间的生态壁垒，实现跨设备的无缝协同。

在鸿蒙系统初期，开发者主要依赖本地开发工具和传统的开发流程，面临着诸多挑战。一方面，本地算力有限，在处理复杂的编译任务和大型项目时，容易出现编译速度慢、资源消耗大等问题，严重影响开发效率。另一方面，在应用和元服务的构建、打包与批量发布过程中，缺乏统一、高效的平台支持，操作繁琐且容易出错。此外，不同开发者之间的代码协作和版本管理也存在一定困难，难以保障代码质量和项目的顺利推进。

为了解决上述问题，华为云软件开发生产线CodeArts提供了鸿蒙应用的一站式开发能力，覆盖代码托管、代码检查、编译构建、二进制仓库、发布部署等多个环节，实现鸿蒙应用和元服务的构建打包和批量发布，解放本地算力，提升研发效率。

2 实验目的

本实验将介绍如何通过华为云CodeArts实现鸿蒙应用的批量生成和发布，主要包含项目创建、代码托管、代码检查、编译构建和应用发布等主要环节。通过本实验，您将能够：

• 掌握华为云代码托管CodeArts Repo的能力，体验云上代码托管服务。
• 掌握华为云代码检查CodeArts Check的能力，体验ArkTS语言的代码检查结果。
• 掌握华为云编译构建CodeArts Build的能力，体验通过HarmonyOS模板创建并执行构建任务的能力。
• 掌握华为云流水线CodeArts Pipeline的能力，体验通过在流水线中增加鸿蒙应用发布插件，将发布在华为云制品仓库CodeArts Artifact平台的应用包自动上传并发布至鸿蒙应用AppGallery Connect平台上。

3 AppGallery Connect应用创建

3.1 创建API客户端

步骤1 登录AppGallery Connect官网完成注册登录等操作，网址：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/myApp 。

步骤2 将鼠标移动至网页右上方账号下拉图标上，点击“个人信息”。

步骤3 在个人信息页面，点击左侧菜单“API密钥-Connect API”，点击“创建”。

步骤4 输入API客户端名称，客户端名称可自定义；项目默认为“N/A”；角色勾选“APP管理员”。点击“确认”。

步骤5 API客户端创建完成后，可查看该客户端ID及密钥，此处的客户端ID和密钥将于第4.5章的应用发布中使用。

3.2 创建项目

步骤1 在AppGallery Connect官网中，点击顶部菜单“用户与访问-我的项目”。

步骤2 点击“添加项目”。

步骤3 输入项目名称后，项目名称需自定义，此处截图中的名称仅为示例，点击“完成”。

3.3 创建应用

步骤1 在AppGallery Connect官网中，点击顶部菜单“用户与访问-我的应用”。

步骤2 点击“创建APP ID”或“新建发布“。

步骤3 选择应用类型，默认为“HarmonyOS应用”；输入应用名称，应用名称需自定义，此处截图中的名称仅为示例；输入应用包名，包名需要用英文命名且以“.huawei.com”结尾，包名需自定义且全网唯一，此处截图中的名称仅为示例；应用分类选择“应用”。点击“下一步”。

步骤4 选择应用所属项目，点击“确认”。

步骤5 开放能力可根据实际情况勾选，本实验默认不勾选，点击“确认”。

步骤6 应用创建完成后，点击操作栏的“发布”。

步骤7 确认应用包名、应用名称、支持设备、默认语言无误后，点击“确认”。

步骤8 发布后，可在应用信息中查看APP ID，此处的APP ID将于第4.5章应用发布中使用。

4 基于CodeArts的鸿蒙应用一站式开发实践

4.1 创建项目

CodeArts项目是一切开发活动的基础空间，开发者可以根据团队组织或者实际的业务划分创建多个项目。软件开发中的需求管理、代码托管、CICD等操作全部在CodeArts项目下进行，项目间成员、资源相互独立隔离。

4.1.1 开通CodeArts

步骤1 进入华为云CodeArts控制台并登录，网址：https://console.huaweicloud.com/console/。

如果未实名认证请先完成实名认证，实名认证操作请见：https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html

步骤2 进入华为云控制台，在顶部导航栏中搜索“CodeArts”，点击“软件开发生产线CodeArts”。

步骤3 点击“立即购买”。

步骤4 进入购买页面，计费模式选择“包年/包月”；区域可根据实际情况选择，默认可选择“华为-北京四”；CodeArts套餐选择“体验版”；购买时长与数量默认为“50人”；购买时长默认为“1个月”；是否自动续费可根据实际情况选择是否勾选（自动续费不会产生任何费用，体验版套餐为永久免费套餐）；协议需勾选“我已阅读并同意”。点击“立即开通”。

步骤5 套餐开通后，前往CodeArts工作台，也可以直接通过链接访问工作台：https://devcloud.cn-north-4.huaweicloud.com/home 。

4.1.2 创建示例项目

步骤1 若是首次创建项目，直接选用“鸿蒙应用的一站式开发项目” 示例项目；若之前创建过项目，单击“新建项目”，在选择模板中选用“鸿蒙应用的一站式开发项目”示例项目。

步骤2 点击“确定”，完成项目创建。

鸿蒙应用的一站式开发示例项目，内嵌官方经典示例工程，提供详细的工程说明和使用方法。项目创建后，系统将自动初始化包含代码仓、代码检查、编译构建以及鸿蒙开发流水线等鸿蒙应用开发任务，方便开发者试用体验。

4.2 代码托管

华为云代码托管服务CodeArts Repo基于Git提供分布式代码管理和协同能力，内置华为公司的代码提交规范、代码合并等多项代码管理规则，保证代码开发和管理的安全可信。针对鸿蒙应用开发场景，我们新增了ArkTS类型源代码文件托管，支持.ets文件的关键字的高亮显示和渲染。

步骤1 点击左侧菜单“代码-代码托管”，即可新建仓库，将代码托管到CodeArts的代码仓中。由于本示例项目已初始化了相关任务，所以我们可以直接看到一个已经创建好的名为“HealthyDiet”的代码仓。

步骤2 点击代码仓名称，可以查看本示例项目内置的代码及相关信息。

4.3 代码检查

华为云代码检查服务CodeArts Check提供10000+的代码检查规则，覆盖17+类语言、脚本。针对鸿蒙应用开发场景，我们联合华为HarmonyOS团队发布了权威的代码检查规范，包括基于ArkTS语言的官方检查规则集，以及鸿蒙领域C/C++、JS、Python等多语言官方规则集。

步骤1 点击左侧菜单“代码-代码检查”，即可新建代码检查任务。由于本示例项目已经初始化了相关任务，所以我们可以看到一个已经创建好的名为“HealthyDiet-check”的代码检查任务。

步骤2 点击操作栏中的更多图标，再点击“设置”。

步骤3 在设置页签中，点击“规则集”，可以看到本次代码检查任务主要检查的是“TYPESCRIPT”和“ARKTS”语言；点击“开始检查”，即可检查本次任务。

步骤4 代码检查完成后，点击“概览”页签可以查看检查结果。

步骤5 点击“代码问题”页签，点击对应问题的“问题帮助”可以查看具体问题和修改建议。

4.4 编译构建

华为云编译构建服务CodeArts Build基于云端大规模分布加速，为企业和开发者提供高速、低成本、配置简单的混合语言构建能力，帮助客户缩短构建时间，提升构建效率。针对鸿蒙应用开发场景，CodeArts Build提供鸿蒙应用构建模板，内置鸿蒙应用的构建环境和构建工具，开箱即用。

步骤1 点击左侧菜单“持续交付-编译构建”，可以新建构建任务。由于本示例项目已初始化了相关任务，所以我们可以直接看到一个已经创建好的名为“HealthyDiet-build”的构建任务。

步骤2 点击构建任务操作栏的“更多图标-编辑”。

步骤3 点击“Hvigor构建”，工具版本选择“HarmonyOS-API9”；命令中将HarmonyOS-API12版本的命令行用“#“注释掉，将Harmony-API9版本的命令行显示出来。如下图所示：

步骤4 点击“保存并执行“，再点击确定。

步骤5 当所有构建步骤前面都显示绿色的“√“后，构建任务即执行完毕。

4.5 应用发布

步骤1 点击左侧菜单“持续交付-流水线“，即可新建流水线。由于本示例项目已经初始化了相关任务，所以我们可以看到一个已经创建好的名为”HealthyDiet-pipeline“的流水线任务。

步骤2 点击操作栏的“更多图标-编辑“进入流水线编辑页面。

步骤3 点击应用发布环节的“HarmonyOS APP发布“进入发布配置弹框。

步骤4 点击AGC连接点右侧的“新建扩展点“进入扩展点配置页。

步骤5 点击“新建服务扩展点-AGC”。

步骤6 输入连接名称、客户端id和密钥，点击“确定”。连接名称可自定义；客户端id和密钥为3.1中创建的客户端ID和密钥，点击链接查看：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/ups/9249519184595983326 。

步骤7 在HarmonyOS APP发布弹框中，点击“刷新”，选择刚刚创建好的的连接点名称。

步骤8 输入应用id。应用id为我们在3.3章节创建应用中创建的应用ID，点击链接查看：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/myApp/6917568692958810943/9322385623857555199 。进入链接后如果没有进到应用详情页，需再点击应用名称进入详情页面查看。

步骤9 输入制品仓文件路径。点击左侧菜单“制品仓库-软件发布库“，点击包文件名称，复制相对路径填入制品仓库文件路径。

步骤10 所有的发布信息配置完成后，点击“确定“。

步骤11 点击“保存并执行“，再点击”执行“。

步骤12 等待流水线任务执行，当所有任务前面都打绿色的“√“，则表示流水线任务执行成功。

步骤13 流水线任务执行完成后，我们可以在APPGallery Connect“我的应用-软件包管理“中看到我们已经将应用包文件上传至APPGallery中了。由于我们内置的程序只是一个Demo，我们设置的相关信息也不完全，所以状态显示为”不通过“。如果开发者自己开发的应用比较完善，符合APPGallery上架需求，则状态会显示为”通过“，我们也可以在应用商店中下载并使用。