HarmonyOS 测试包一键安装脚本仓库指南

仓库概述

本仓库提供了一套自动化脚本，用于快速安装和启动 HarmonyOS 测试包（HSP/HAP），支持动态配置包名和批量安装功能，适用于开发调试和测试场景。

📂 文件结构说明

├── common_res-default-signed.hsp # 鸿蒙共享资源包（HSP文件）
├── entry-default-signed.hap # 鸿蒙应用入口包（HAP文件）
├── config.txt # 包名配置文件
└── install_v1.0.1.bat # 一键安装批处理脚本

🛠️ 使用指南

第一步：准备工作

1. 确保已配置 hdc 工具并连接鸿蒙设备。
2. 将以下文件放在同一目录下：
   • .hsp 文件（共享包）
   • .hap 文件（应用包）
   • install_v1.0.1.bat（脚本）
   • config.txt（配置文件，可选）

第二步：配置包名（二选一）

方式一：通过配置文件

1. 编辑 config.txt，写入包名（如 com.atomicservice.xxx）：
   

   注：文件仅需单行内容，若留空则运行脚本时会提示输入。

方式二：运行脚本时输入

• 若未配置 config.txt 或内容为空，脚本将提示手动输入包名。

第三步：一键安装

1. 双击运行 install_v1.0.1.bat：
   
2. 观察命令行输出：
   • 自动卸载旧版本应用
   • 按顺序安装所有 .hsp 文件
   • 最后安装 .hap 文件并启动应用

⚙️ 脚本功能详解

📝 注意事项

1. 包名一致性：确保 config.txt 中的包名与工程配置完全一致。
2. 文件完整性：
   • 必须包含至少一个 .hap 文件
   • .hsp 文件按需添加（若无共享资源可删除）
3. 权限问题：若安装失败，检查设备是否开启开发者模式和USB调试权限。

❓ 常见问题

Q1: 脚本运行时提示 hdc 命令未找到

• 解决：将鸿蒙SDK的 hdc 工具路径添加到系统环境变量。

Q2: 安装成功后应用未自动启动

• 解决：检查 EntryAbility 名称是否与工程中的 config.json 配置匹配。

Q3: 如何支持多个HAP文件？

• 扩展脚本：修改循环逻辑，遍历所有 .hap 文件并依次安装。

🔗 参考资源

• HarmonyOS hdc 工具官方文档
• HAP/HSP 开发指南