合作咨询
我们的专家服务团队将竭诚为您提供专业的合作咨询服务
插件当前也支持您在工具面板关联应用。
小程序转换元服务
本文导读
插件支持将微信/支付宝/Taro/uni-app小程序转换为ASCF元服务，大大减少重复性适配工作，降低入驻鸿蒙生态的成本。转换后，您还可以通过对话将元服务直接推送至真机或者模拟器上运行，并完成编译打包。此外，插件面板还提供上架自检入口，方便您快速自查软件包问题，提高上架审核通过率。
转换元服务
本章节以VS Code为例描述如何将小程序转换为元服务，在其他IDE上操作类似。
转换元服务工程
- 在VS Code中打开待转换工程的上一级目录。
例如，待转换工程为“xiaochengxu”，则打开其上级目录“project”。
- 进入插件界面，在左下角切换模式为“元服务转换”，在对话框中输入类似下述提示语：当前是一个XXX小程序，帮我转换为ASCF元服务工程。
- 等待“待办清单”中各任务的执行完成。
会话中关联元服务并配置签名
元服务构建编译过程中，插件会自动引导您进行签名配置。
- 如当前元服务工程尚未与HarmonyOS 开发者中心上的元服务关联，则对话框会先弹出关联元服务卡片。
- 如HarmonyOS 开发者中心已存在待关联的元服务，选择元服务所属的团队以及元服务名称，点击“提交”。
- 如需新建一个元服务进行关联，点击“新建应用”页签，选择团队、应用类型、应用名称和分类、项目，点击“提交”，新建应用成功且自动与当前元服务工程关联。
说明 - 如HarmonyOS 开发者中心已存在待关联的元服务，选择元服务所属的团队以及元服务名称，点击“提交”。
- 元服务关联成功后，插件会与您确认配置的签名类型（调试签名/发布签名）。
- 如后续需将元服务推送至真机运行调试，建议选择“调试签名”，插件将为元服务配置调试签名。注意
PC必须连接真机后才可配置调试签名。
- 如后续计划直接打包元服务进行发布上架，建议选择“发布签名”，插件将为元服务配置发布签名。
- 如后续需将元服务推送至真机运行调试，建议选择“调试签名”，插件将为元服务配置调试签名。
在模拟器上运行元服务
- 在插件对话框中输入类似下述提示词：将包推送到模拟器上运行调试。
- 插件将拉起DevEco Studio中的模拟器运行元服务。
在真机上运行元服务
- 确保真机已与PC连接，且真机上已安装ASCF引擎（在负一屏或华为应用市场搜索“元服务ASCF示例”，点击运行，系统会自动安装）。
- 确保元服务已配置调试签名。如未完成，可在对话框中输入“帮我创建调试签名”的提示语，插件将快速帮您完成签名配置，具体流程可参见会话中关联元服务并配置签名。说明
插件当前也支持您在工具面板配置签名。
- 在对话框中输入类似下述提示词：已完成签名，帮我运行到真机上。
- 插件将元服务推送到连接的真机上运行。
上架自检
- 确保元服务已配置发布签名。如未完成，可在对话框中输入“帮我创建发布签名”的提示语，插件将快速帮您完成签名配置，具体流程可参见会话中关联元服务并配置签名。说明
插件当前也支持您在工具面板配置签名。
- 在插件对话框中输入类似下述提示语：帮我打包用于最终上架。
- 等待“待办清单”中各任务的执行完成。
- 进入资源管理器界面，在“build > outputs”目录下获取带签名的元服务软件包。
- 打开插件配置界面，在“关联元服务”页签的“上架自检”区域，点击文件选择按钮。
- 选择刚刚编译生成的带签名的元服务软件包，点击“提交自检”。
- 等待自检结果。
- 报告生成后，点击“报告”可查看详细信息。
（可选）在工具面板关联应用
您可以在插件配置页面，将生成的应用工程与HarmonyOS 开发者中心上的应用关联，支持关联已有的应用，或者新建一个应用进行关联。
说明
使用关联应用功能前，请确保当前打开的项目工程为HarmonyOS工程。（注：HBuilderX中可为uni-app工程）
关联已有的应用
- 点击插件右上角设置按钮。
- 在“关联应用”页签，点击“关联应用”。
- 选择HarmonyOS 开发者中心上应用所属的团队以及应用名称，点击“关联”。
- 应用成功关联后，“当前应用”区域将展示应用的详细信息。
关联新建的应用
- 点击插件右上角设置按钮。
- 在“关联应用”页签，点击“关联应用”。
- 点击“新建应用”页签，选择团队、应用类型、应用名称、应用包名和分类、项目，点击“提交”。
- 界面展示应用的详细信息，表示应用已成功关联。
（可选）在工具面板配置签名
您可以在插件配置页面，为应用配置调试或发布签名。
打开插件配置界面，在“关联应用”页签的“应用签名”栏点击“调试签名”或“发布签名”，插件将为应用自动配置签名。
