HarmonyOS APP打包运行和调试应用开发步骤

Huanggf0317

在进行HarmonyOS应用开发前，您应该掌握HarmonyOS应用的逻辑结构。

HarmonyOS应用发布形态为APP Pack（Application Package，简称APP），它是由一个或多个HAP（HarmonyOS Ability Package）包以及描述APP Pack属性的pack.info文件组成。

一个HAP在工程目录中对应一个Module，它是由代码、资源、第三方库及应用配置文件组成，可以分为Entry和Feature两种类型。

Entry：应用的主模块。一个APP中，对于同一设备类型必须有且只有一个entry类型的HAP，可独立安装运行。（类似安卓项目中主Module）

Feature：应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP，也可以不含。（类似安卓项目中的库,Module）

HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开，它是由一个或多个Ability组成。Ability分为两种类型：FA（Feature Ability，中文名称：元程序）和PA（Particle Ability，中文名称：元服务）。FA/PA是应用的基本组成单元，能够实现特定的业务功能。FA有UI界面，而PA无UI界面。

编译构建

编译构建是将HarmonyOS应用的源代码、资源、第三方库等打包生成HAP或者APP的过程。其中，HAP可以直接运行在真机设备或者模拟器中；APP则是用于应用上架到华为应用市场。

为了确保HarmonyOS应用的完整性，HarmonyOS通过数字证书和授权文件来对应用进行管控，只有签名过的HAP才允许安装到设备上运行（如果不带签名信息，仅可以运行在模拟器中）；同时，上架到华为应用市场的APP也必须通过签名才允许上架。因此，为了保证应用能够发布和安装到设备上，需要提前申请相应的证书与Profile文件，注意：

申请证书和Profile文件时，用于调试和上架的证书与授权文件不能交叉使用：

应用调试证书与应用调试Profile文件、应用发布证书与应用发布Profile文件具有匹配关系，必须成对使用，不可交叉使用。

应用调试证书与应用调试Profile文件必须应用于调试场景，用于发布场景将导致应用发布审核不通过；应用发布证书与应用发布Profile文件必须应用于发布场景，用于调试场景将导致应用无法安装。

应用签名

调试应用签名的方式包括如下两种：

方式一：通过DevEco Studio自动化签名的方式对应用进行签名；

方式二：通过从AppGallery Connect中申请调试证书和Profile文件后，再进行签名。

通过DevEco Studio自动化签名的方式更加简单和高效，因此推荐使用自动化签名

连接真机设备，确保DevEco Studio与真机设备已连接。

进入File > Project Structure > Project > Signing Configs界面，点击“Sign In”按钮进行登录。

在AppGallery Connect中创建项目和应用。

登录AppGallery Connect，创建一个项目。

在项目中，点击添加应用按钮，创建一个应用。如果是非实名认证的用户，请点击“HAP Provision Profile管理”界面的HarmonyOS应用按钮。

选择平台：选择APP（HarmonyOS应用）。

支持设备：选择调试的设备类型。

应用包名：必须与config.json文件中的“bundleName”取值保持一致。

应用名称、应用分类、默认语言请根据实际需要进行设置。

返回DevEco Studio的自动签名界面，点击Try Again，即可自动进行签名。自动生成签名所需的密钥（.p12）、数字证书（.cer）和Profile文件（.p7b）会存放到用户user目录下的.ohosconfig目录下。

如果是非实名认证用户，需要先接受“HUAWEI Developer Basic Service Agreement”协议。

设置完签名信息后，点击OK进行保存，然后可以在工程下的build.gradle中查看签名的配置信息。

构建带签名信息的HAP（Debug类型）

在构建带签名信息的HAP前，请先对应用进行签名。

打开左下角的OhosBuild Variants，检查并设置模块的编译构建类型为debug，默认类型为debug。

在主菜单栏，点击Build > Build APP(s)/Hap(s) > Build Hap(s)，生成已签名的Debug HAP。

构建带签名信息的HAP（Release类型）

在构建带签名信息的HAP前，请先对应用进行签名。

打开左下角的OhosBuild Variants，检查并设置模块的编译构建类型为release，默认类型为debug

在主菜单栏，点击Build > Build APP(s)/Hap(s) > Build Hap(s)，生成已签名的Release HAP。

构建不带签名信息的HAP

不带签名信息的HAP（包括Debug和Release类型），只能运行在模拟器设备上。

构建不带签名信息的HAP（Debug类型）

打开左下角的OhosBuild Variants，检查并设置模块的编译构建类型为debug，默认类型为debug。

在主菜单栏，点击Build > Build APP(s)/Hap(s) > Build Hap(s)，生成不带签名的Debug HAP。

构建不带签名信息的HAP（Release类型）

打开左下角的OhosBuild Variants，检查并设置模块的编译构建类型为release，默认类型为debug。

在主菜单栏，点击Build > Build APP(s)/Hap(s) > Build Hap(s)，生成不带签名的Release HAP。

设置Hap包安装方式

在调试阶段，Hap包在设备上的安装方式有2种，您可以根据实际需要进行设置

安装方式一：先卸载应用后，再重新安装，该方式会清除设备上的所有应用缓存数据（默认安装方式）。

安装方式二：采用覆盖安装方式，不卸载应用，该方式会保留应用的缓存数据。

设置方法如下：

点击Run > Edit Configurations，设置指定模块的Hap包安装方式，勾选 ”Replace existing application”，则表示采用覆盖安装方式，保留应用缓存数据。

如果一个工程中同一个设备存在多个模块（如Phone设备，存在entry和feature模块），且存在模块间的调用时，在调试阶段需要同时安装多个模块的hap包到设备中。此时，需要在待调试模块的设置项中勾选“Deploy Multi Hap Package”。例如entry模块调用feature模块，在调试entry模块时，需要同时安装feature模块，您应该在entry模块的调试设置项中勾选“Deploy Multi Hap Package”后再启动调试。

使用Remote Emulator运行应用

Remote Emulator中的单设备模拟器（Single device）可以运行和调试Phone、Tablet、TV和Wearable设备的HarmonyOS应用，可兼容签名与不签名两种类型的HAP。

Remote Emulator每次使用时长为1小时，到期后会自动释放资源，请及时完成HarmonyOS应用的调试。如果Remote Emulator到期释放后，您可以重新申请资源。

在DevEco Studio菜单栏，点击Tools > Device Manager。

在Remote Emulator页签中，点击Login，在浏览器中弹出华为开发者联盟帐号登录界面，请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录。

登录后，请点击界面的允许按钮进行授权。

在Single device中，点击设备运行按钮，启动远程模拟设备（同一时间只能启动一个设备）。

点击DevEco Studio的Run > Run'模块名称'或，或使用默认快捷键Shift+F10（Mac为Control+R）。

DevEco Studio会启动应用的编译构建，完成后应用即可运行在Remote Emulator上。

启动调试

在工具栏中，选择调试的设备，并点击Debug 或Attach Debugger to Process启动调试。

说明