HUAWEI WATCH GT 系列安装第三方应用

Lite Wearable 应用开发

调测助手APP可以辅助GT表进行应用的安装，同时还可以进行GT表上运行的应用的日志收集，帮助开发者进行应用的调试和问题定位。使用调测助手时，需要依赖运动健康APP，因此在进行应用安装和日志收集时，请勿关闭运动健康APP的后台进程。

连接运动手表

进入调测助手APP后选择底部的"Lite Wearable"标签页；

点击"连接设备"，会自动打开运动健康APP；

在运动健康APP的"设备"页签中，点击"添加设备"按钮；

在"手表"列表中，选择对应的GT表型号。

点击"开始配对"，按照界面指引完成GT表与华为手机之间的连接。

安装应用

将应用"hap包"，拷贝到手机中的"/sdcard/haps/"目录。

在调测助手APP中，点击"应用管理"。

选择需要安装的hap包，点击"安装"按钮开始安装应用。安装完成后，手机界面会提示"安装成功"。

获取手表调试日志

在调测助手APP中，点击"查看日志"，会自动启动应用的日志收集功能，请耐心等待日志采集完成。

日志的采集规则：

• GT表上采集的日志信息每达到1Kb（例如日志信息为2.5Kb，则会分3次发送给调测助手APP）时，GT表会自动将日志信息返回给调测助手APP进行呈现，开发者可以在启动日志采集后操作GT表，以产生需要的日志信息。

• GT表产生的日志信息达不到1Kb，此时可以通过点击界面的"停止"按钮，GT表会停止日志的采集，同时会将这部分日志信息返回给调测助手APP。

• 调测助手APP上最多可展示10000条日志信息，如果日志达到10000条，调测助手APP会自动删除最先呈现的2000条记录。

从源码构建 hap 文件和对源码签名

下载和安装DevEco Studio

下载和安装

DevEco Studio是HarmonyOS应用及服务的集成开发环境（IDE），提供了一站式的开发平台，包括代码编辑、编译构建、代码调试、性能调优、模拟器、应用测试等能力。

手表应用推荐版本（适用于 HarmonyOS 3.1/4.0及以下）：https://developer.huawei.com/consumer/cn/deveco-studio/archive/

推荐使用 2021-12-31 的DevEco Studio 3.0 Beta2 for HarmonyOS（3.0.0.800）版本，虽然安装对应SDK比较费事儿，但感觉这个版本对老项目源码的兼容性会好一些。

（备用）最新版本官方下载地址：https://developer.huawei.com/consumer/cn/download/deveco-studio

下载后执行安装程序，根据提示进行安装即可。

首次启动

首次启动DevEco Studio，会提示是否导入旧版本配置，选择不导入（Do not import settings）。下一步，同意协议，点击"Agree"按钮。即可进入DevEco Studio的界面。

如果本机环境缺少合适版本的Node.js或SDK等，在第一次启动时的向导中根据提示选择install选项即可现场安装。

推荐：设置IDE推荐的兼容版本环境

在不同的IDE版本的版本说明网页中，都有介绍兼容的版本环境，比如：Gradle、JDK、Node.js、HarmonyOS SDK/Toolchains、OpenHarmony SDK/Toolchains、hap插件、decctest插件都有兼容的版本要求，参照文档说明进行设置就好。

（可选）安装并启用中文菜单插件

打开插件市场
- 启动DevEco Studio。在打开的主界面中，点击菜单栏中的"File（文件）"选项，然后在下拉菜单中选择"Preferences（设置）"。
- 在弹出的"Preferences"对话框中，找到并点击"Plugins（插件）"选项。这将打开插件管理界面，在这里可以浏览、安装和管理各种插件。
- 首先查看已安装插件是否有中文语言包，有的话直接启用就可以。没有的话就要在插件市场进行搜索安装。
搜索中文插件
- 在插件管理界面的顶部，有一个搜索框。在搜索框中输入"Chinese (Simplified)"等关键词，然后按下回车键进行搜索。
安装中文插件
- 从搜索结果中找到"Chinese (Simplified) Language Pack"（简体中文语言包）插件。注意，该官方插件是JetBrains提供。
- 找到插件后，点击插件名称旁边的"Install（安装）"按钮。DevEco Studio会自动下载并安装该插件。
- 如果找不到，那是因为你使用的DevEco Studio版本太新了，官方还没有适配对应的中文语言包，只能等待，或者去 JetBrains 插件的官方网站搜索并手动安装适用于旧版本的中文语言包，但可能存在汉化不全、兼容性问题，不是很推荐。
重启DevEco Studio
- 安装完成后，会提示需要重启DevEco Studio才能使插件生效。关闭当前的设置对话框，然后退出DevEco Studio。
确认语言设置
- 重新启动DevEco Studio后，它应该会自动检测并应用简体中文语言包。

使用DevEco Studio

打开项目并进行构建

启动DevEco Studio
- 双击DevEco Studio的启动图标或通过命令行启动。
打开现有项目
- 选择 File > Open。
- 浏览到你的项目源码目录，选择项目的根目录，然后点击 OK。
- 等待DevEco Studio加载项目文件。
同步项目
- 确保项目的配置文件（如 build.gradle）是正确的，并且所有依赖项都已正确配置。
- 点击工具栏上的 Sync Now 按钮（通常是一个带有两个箭头的图标），或者选择 File > Sync Project with Gradle Files。
- 等待Gradle同步完成，这将下载所有必要的依赖项。
构建项目
- 使用菜单栏 ：
  - 选择 Build > Build Project。
- 使用快捷键 ：
  - Windows/Linux: Ctrl + F9
  - macOS: Cmd + F9
- 使用工具栏按钮 ：
  - 在工具栏上找到 Build 按钮（通常是一个锤子图标），点击它。
- 查看构建结果 ：
  - 构建过程会在底部的 Build 标签页中显示进度和结果。
  - 如果构建成功，你会看到 BUILD SUCCESSFUL 的消息。
  - 如果构建失败，错误信息会显示在 Build 标签页中，根据错误信息进行调试和修复。修复完成后从"同步项目"步骤开始再次尝试。
找到 .hap 文件
- 构建成功后，.hap 文件通常位于项目的 entry/build/outputs/hap/debug 目录下。具体路径可能因项目结构而异，但通常是这样的结构：
  - <项目根目录>/entry/build/outputs/hap/debug/
- 你可以在文件资源管理器中导航到该路径，或者在DevEco Studio的 Project 视图中展开相应的目录来找到 .hap 文件。

构建问题解决

肯定存在未签名问题，参照下文继续添加签名即可。
提示项目中指定的Node.js等环境路径不可用，点击默认的确定按钮，就会更新为IDE的实际路径配置。这实际上是修改的local.properties文件。
提示SDK API版本等不一致，点击问题的默认解决链接，就会进行下载匹配的SDK。
下载SDK的自动任务失败，可以尝试在 File > Settings > SDK 中自己手动下载对应版本。如果还是失败，仔细看提示，可能是其所依赖的SDK版本过低，已经不被支持。修改项目根目录下的build.gradle文件和模块级别的entry/build.gradle文件，将compileSdkVersion调高，直至可以被支持。但是，不要动compatibleSdkVersion字段，它意思是支持的最低兼容版本。
如果下载SDK总是失败，可以尝试在 DevEco Studio 中配置代理，通过 File > Settings > Appearance & Behavior > System Settings > HTTP Proxy 设置代理服务器信息。
如果执行npm失败，可以将npm设置为国内源：npm config set registry https://registry.npmmirror.com。
SDK的previewer也可以忽略，实际不是自己需要在电脑上调试的话不需要。
npm报错：npm ERR! code CERT_HAS_EXPIRED，这是registry的证书过期了，可将npm设置为忽略SSL证书检查：npm config set strict-ssl false。
npm报错：network request to https://registry.nlark.com/... failed，这是因为registry.nlark.com不可用了。使用以下脚本来替换为可用的源：for i in {1..1000}; do find <此处填出错的上级路径> -type f -name "*.json" -print0 | xargs -0 sed -i -e 's|//registry.nlark.com/|//registry.npmmirror.com/|g'; sleep 1; done。如果又报错npm ERR! code EINTEGRITY，可以使用以下命令来直接删除lock文件从而使用默认registry：for i in {1..1000}; do find <此处填出错的上级路径> -type f -name "package-lock.json" -exec rm -f {} +; sleep 1; done。
npm错误太多不好解的话，就参照其日志，将SDK的zip包直接下载到本地指定目录，手动执行命令安装即可。
HarmonyOS SDK API 6（2.2.0.3）版本的下载地址：
任何其他异常，请自行参照IDE的版本说明 ，查看"Gradle、JDK、Node.js、HarmonyOS SDK/Toolchains、OpenHarmony SDK/Toolchains、hap插件、decctest插件"，那一坨的各自的兼容版本要求，务必理顺。否则意外很难解决。

一、生成密钥和证书请求文件

打开相关界面
- 在主菜单栏单击Build > Generate Key and CSR。这一步是启动生成密钥和证书请求文件的操作入口。
处理密钥库文件
- 如果本地已有对应的密钥，可在Generate Key界面中单击下方的Skip跳过密钥生成过程，直接使用已有密钥生成证书请求文件。例如，如果之前已经为其他类似项目创建过密钥，且该密钥符合当前项目要求，就可以选择跳过。
- 如果没有密钥库文件，需创建新的密钥库文件：
  - 在Key Store File中，单击New。
  - 在Create Key Store窗口中：
    - Key store file：设置密钥库文件存储路径，并填写.p12文件名。比如，可以设置为D:/myKeys/myAppKey.p12，这里D:/myKeys是自定义的存储路径，myAppKey是文件名，可根据项目实际情况命名。
    - Password：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。例如，可以设置为Abc@1234。
    - Confirm password：再次输入密钥库密码，确保两次输入一致。然后单击OK。
填写密钥信息
- 在Generate Key and CSR界面中，继续填写密钥信息：
  - Alias：密钥的别名信息，用于标识密钥名称。可以根据项目功能或模块来命名，比如myAppDebugKey。
  - Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入。然后单击Next。
设置CSR文件信息
- 在Generate Key and CSR界面，设置CSR文件存储路径和CSR文件名。例如，设置CSR文件存储路径为D:/myKeys，文件名myAppDebug.csr。然后单击Finish，创建CSR文件成功，可在存储路径下获取生成的密钥库文件（.p12）、证书请求文件（.csr）和material文件夹（存放签名方案相关材料，如密码、证书等）。

二、创建应用/服务

前提条件：已注册华为开发者账号并实名认证。

登录并进入相关页面
- 登录 AppGallery Connect 官网，选择"证书、APP ID和Profile"，在左侧导航栏选择"证书、APP ID和Profile > APP ID "，进入"APP ID"页面，点击右上角"新建"。
填写应用基础信息
- 进入"设置应用开发基础信息"页面，填写以下信息：
  - 应用类型：选择HarmonyOS应用或元服务。
  - 应用名称：填写新应用名称（限30字符）。
  - 应用包名 ：
    - 当"应用类型"为HarmonyOS应用时，需手动填写，必须符合规范：以点号（.）分隔的字符串，至少包含三段，首段以英文字母开头，非首段以数字或英文字母开头，每段以数字或者英文字母结尾，不允许多个点号连续出现，长度为7 - 128个字符，且不可包含敏感词，不能将保留字符作为独立段呈现。同时，应用包名必须与DevEco Studio工程中配置的Bundle name（在entry/src/main/config.json内查看）一致，以确保应用的一致性和正常运行。
    - 点击"下一步"时，如果提示包名称重复，则需要同步修改应用包名和工程Bundle name。
    - 元服务包名会在元服务创建成功后自动生成。
  - 应用分类：选择普通应用或游戏类应用，设置后不支持修改。填写完成后点击"下一步"。
选择应用所属项目
- 在"开放能力接入"页面，为应用选择所属的项目：
  - 如需添加到已有项目，点击下拉框进行选择。
  - 如需添加到新项目，直接在框中填写新项目名称。完成后点击"确认"。
设置开放能力（可选）
- 如果应用需要使用华为账号等开放能力，则必须在AGC打开对应能力的开关：
  - 在"开放能力"栏找到想要接入的开放能力，打开该能力所在行的开关，点击"确认"即可。
  - 部分开放能力要求设置数据处理位置，在打开能力开关时会给予相应提示，点击提示框中的"去设置"进入对应项目设置数据处理位置，设置完成后，再打开所需能力开关。
查看创建信息
- 返回"APP ID"页面，可查看已创建的APP ID、应用名称与包名信息。

三、申请调试证书

注意：每个账号最多可申请两个调试证书。

登录AppGallery Connect
- 打开浏览器，访问 AppGallery Connect 官网。
- 使用已注册的华为开发者账号登录。
进入证书管理页面
- 在左侧导航栏选择"证书、APP ID和Profile > 证书"，进入"证书"页面。
新增证书
- 在"证书"页面右上角点击"新增证书"按钮。
填写证书信息
- 证书名称：填写不超过100个字符的名称，如"[项目名称]调试证书"，用于标识该证书。
- 证书类型：在下拉菜单中选择"调试证书"。
上传证书请求文件
- 找到在DevEco Studio上申请的证书请求文件（.csr文件）。
- 点击"上传文件"按钮，选择该证书请求文件并上传。
提交申请
- 确认证书信息和上传文件无误后，点击"提交"按钮。
查看证书状态
- 提交申请后，证书状态显示为"审核中"。
- 通常在较短时间内（几分钟到几十分钟不等），证书状态更新为"生效"，此时可在该页面下载证书（.cer文件）用于调试签名。

四、注册调试设备

登录AppGallery Connect
- 打开浏览器，访问AppGallery Connect 官网。
- 使用已注册并实名认证的华为开发者账号登录。
进入设备管理页面
- 在左侧导航栏选择"证书、APP ID和Profile > 设备"，进入"设备"页面。
添加设备
- 在"设备"页面右上角点击"添加设备"按钮。
填写设备信息
- 设备名称：填写不超过100个字符的名称，用于标识该设备。
- 设备类型：从运动手表、智能手表、智慧屏、手机或路由器中选择要注册的调试设备类型（平板请选择"手机"）。
- UDID ：填写设备的唯一标识符，是由字母和数字组成的64位字符串。获取方法如下：
  - 对于手机：
    - 打开"设置 > 关于本机"，多次点击版本号，打开开发者模式。
    - 打开"设置 > 系统"，在最下方找到"开发人员选项"，打开"USB调试"开关。
    - 使用PC连接手机后，打开命令行工具，进入HDC目录（一般为：HarmonyOS SDK安装目录/toolchains/{版本号}），输入hdc shell bm get --udid命令获取设备的UDID。
  - 对于智能手表：
    - 打开智能手表的"设置 > 关于手表"，多次点击版本号，打开开发者模式。
    - 打开"设置"，在最下方找到"开发人员选项"，打开"HDC调试"开关。
    - 使用PC连接智能手表后，打开命令行工具，进入HDC目录（一般为：HarmonyOS SDK安装目录/toolchains/{版本号}），输入hdc shell bm get --udid命令获取设备的UDID。
  - 对于路由器：
    - 在DevEco Studio的"Terminal"窗口，使用telnet命令登录到Router串口，并打开路由器串口打印，具体请参考在Router中运行应用。
    - 在Terminal窗口输入debug cms get udid命令获取设备的UDID。
  - 对于运动手表（WATCH GT系列） ：
    - 从华为应用市场下载并安装应用调测助手和运动健康app。
    - 打开应用调测助手，选择底部的"Lite Wearable"页签。
    - 点击"连接设备"，自动打开运动健康app。
    - 在运动健康app的"设备"页签中，点击"添加设备"。
    - 在"手表"列表，选择对应的手表型号。
    - 点击"开始配对"，按界面指引完成运动手表与华为手机的配对。配对成功后，应用调测助手界面会显示运动手表型号和UDID，点击"复制"即可复制UDID到剪贴板。
提交设备信息
- 确认填写的设备信息无误后，点击"提交"按钮。设备添加成功后，可在"设备管理"页面查看设备信息。

五、申请调试Profile

登录AppGallery Connect
- 打开浏览器，访问AppGallery Connect 官网。
- 使用华为开发者账号登录。
进入Profile管理页面
- 在左侧导航栏选择"证书、APP ID和Profile > Profile"，进入"Profile"页面。
新增Profile
- 在"Profile"页面右上角点击"新增Profile"按钮。
填写Profile信息
- 应用名称：选择下拉选项中之前创建的应用。
- 应用包名：系统自动显示，不可修改。
- Profile名称：填写不超100字符的名称，如"[项目名称]调试Profile"。
选择证书
- 在"证书"下拉菜单选已申请的调试证书。
选择设备（可选）
- 若为特定设备申请，在"设备"下拉菜单选相应设备；若不选，可用于所有设备。
申请权限（可选）
- 点击"权限申请"。
- API 9以下：仅支持申请ohos.permission.READ_USER_STORAGE和ohos.permission.WRITE_USER_STORAGE权限，在权限列表勾选后提交。
- API 9及以上：发应用信息（如名称、包名、申请权限说明等）至agconnect@huawei.com审核，周期1个工作日，邮件主题格式为"AGC项目名称+应用名称+权限申请"。
提交申请
- 确认信息无误后点击"提交"。
查看Profile状态
- 提交后状态为"审核中"。
- 通常短时间内（几分钟到几十分钟）变为"生效"，可下载Profile（.p7b文件）用于调试。

六、手动配置签名信息

打开配置窗口
- 在File > Project Structure > Project > Signing Configs窗口中，取消勾选Automatically generate signature（如果是HarmonyOS应用，请勾选Support HarmonyOS）。这一步是切换到手动配置签名信息的模式。
- 设置签名有Debug和Release两个卡片独立配置。
配置签名信息
- Store file：选择密钥库文件，文件后缀为.p12，该文件为生成密钥和证书请求文件中生成的.p12文件。比如，如果之前设置的密钥库文件是D:/myKeys/myAppKey.p12，这里就选择该文件。
- Store password：输入密钥库密码，该密码与生成密钥和证书请求文件中填写的密钥库密码保持一致。即输入之前设置的Abc@1234。
- Key alias：输入密钥的别名信息，与生成密钥和证书请求文件中填写的别名保持一致，注意要转为小写 。如myappdebugkey。
- Key password：输入密钥的密码，与生成密钥和证书请求文件中填写的Store Password保持一致，也是Abc@1234。
- Sign alg：签名算法，固定为SHA256withECDSA。
- Profile file：选择申请调试证书和调试Profile文件中生成的Profile文件，文件后缀为.p7b。
- Certpath file：选择申请调试证书和调试Profile文件中生成的数字证书文件，文件后缀为.cer。
查看配置结果
- 配置完成后，进入工程级build-profile.json5文件，在signingConfigs下可查看到配置成功的签名信息。例如，可能看到类似以下的配置信息：

json 复制代码

"signingConfigs": [ {
"name": "default",
"type": "Harmony0S",
"material": {
"storePassword": "Abc@1234",
"certpath": "D:/myKeys/myAppDebug.cer",
"keyAlias": "myAppDebugKey",
"keyPassword": "Abc@1234",
"profile":"D:/myKeys/myAppDebug Provision.p7b",
"signAlg":"SHA256withECDSA",
"storeFile":"D:/myKeys/myAppKey.p12
} ]

给华为手表安装 HAP 文件

在手机下载并安装"应用调测助手"

应用调测助手APP是一款用于分布式应用的调测，包含Lite Wearable应用开发和写入NFC标签信息功能。

在应用商店中搜索并下载"应用调测助手"。只要是安卓手机就可以，不限定必须是华为手机。如果非华为手机没找到，就先下载"华为应用商店"，再从"华为应用商店"中搜索并安装该应用即可。

注意：

官方应用的开发者是"华为公司"。
该应用依赖华为的HMS应用（Huawei Mobile Services，华为移动服务，类似于谷歌的GMS地位），对于非华为手机，一般华为运动健康App会推荐并安装，如果没有安装则需要先下载"华为应用商店"再从中手动下载安装。

将"华为运动健康"连接手表并授权

推荐：将运动健康APP升级至最新版本。
华为运动健康App中先连接好手表。
打开应用调测助手App，会自动调起华为运动健康App并弹窗为应用调测助手App授权，勾选全部选项并点击"确认"按钮。
如果没有自动调起授权弹窗，则需要手动打开华为运动健康App，然后在 我的 > 设置 > 设备能力开放 中为应用调测助手App开启全部选项的授权。

将 HAP 文件安装到手表上

拷贝HAP文件
- 将HAP文件拷贝到手机的/sdcard/haps/目录下，若没有该文件夹则手工创建。
- 注意：如果是抓取的bin文件，可以使用zip方式压缩，然后修改文件扩展名.zip为.hap即可。
打开应用调测助手APP
- 在华为手机上打开应用调测助手APP。
连接设备（如果需要）
- 若Lite Wearable设备未自动连接，点击应用调测助手界面上的"连接设备"按钮手动连接。
安装应用
- 点击应用调测助手APP中的"应用管理"按钮，找到HarmonyOS安装包（HAP文件）点击安装，按提示操作权限确认等。
运行应用
- 安装完成后，在Lite Wearable设备的应用列表中点击应用图标运行应用。

附录

手表文件资源备份

资源备份地址：https://download.csdn.net/download/zhiyuan411/89811222

解压密码：hap