# HarmonyDeploy

**Repository Path**: qq1963861722/harmony-deploy

## Basic Information

- **Project Name**: HarmonyDeploy
- **Description**: 在鸿蒙（HarmonyOS）应用开发与测试过程中，频繁安装和更新测试包是一项常见需求。本文介绍如何通过一个自动化批处理脚本（`install_v1.0.1.bat`）快速完成鸿蒙应用的卸载、安装与启动，显著提升开发和测试效率。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-10
- **Last Updated**: 2025-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

---

## 📂 文件结构说明

```ts
├── 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`）：  
   ![配置示例](2.脚本配置.png)  
   
   > 注：文件仅需单行内容，若留空则运行脚本时会提示输入。

#### 方式二：运行脚本时输入
- 若未配置 `config.txt` 或内容为空，脚本将提示手动输入包名。

---

### 第三步：一键安装
1. **双击运行** `install_v1.0.1.bat`：  
   ![脚本运行](1.脚本使用介绍.png)  
2. 观察命令行输出：  
   - 自动卸载旧版本应用  
   - 按顺序安装所有 `.hsp` 文件  
   - 最后安装 `.hap` 文件并启动应用  

---

## ⚙️ 脚本功能详解
| 功能             | 实现逻辑                                             |
| ---------------- | ---------------------------------------------------- |
| **动态包名读取** | 优先从 `config.txt` 读取，失败时提示手动输入         |
| **批量安装HSP**  | 遍历目录下所有 `.hsp` 文件，依次安装                 |
| **HAP安装校验**  | 仅当所有HSP安装成功后，才会安装 `.hap` 文件          |
| **自动启动应用** | 安装成功后通过 `hdc shell aa start` 命令启动入口能力 |
| **错误中断机制** | 任一文件安装失败时立即终止流程，并输出错误日志       |

---

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

---

## ❓ 常见问题
**Q1: 脚本运行时提示 `hdc` 命令未找到**  
- **解决**：将鸿蒙SDK的 `hdc` 工具路径添加到系统环境变量。

**Q2: 安装成功后应用未自动启动**  
- **解决**：检查 `EntryAbility` 名称是否与工程中的 `config.json` 配置匹配。

**Q3: 如何支持多个HAP文件？**  
- **扩展脚本**：修改循环逻辑，遍历所有 `.hap` 文件并依次安装。

---

## 🔗 参考资源
- [HarmonyOS hdc 工具官方文档](https://developer.harmonyos.com)
- [HAP/HSP 开发指南](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-application-package-overview-0000000000017004)