# MaxHap 项目

这是一个基于 Kotlin Multiplatform 和 Jetpack Compose 的跨平台应用项目，支持 Android 和 HarmonyOS 平台。

## 项目结构

```
MaxHap/
├── composeApp/          # 共享的 Compose 代码
├── androidApp/          # Android 特定代码
├── harmonyApp/          # HarmonyOS 特定代码
├── iosApp/              # iOS 特定代码（如果需要）
└── scripts/             # 项目脚本工具
```

## 脚本工具

项目提供了几个实用的脚本工具来帮助开发和测试：

### 1. 单文件批量生成Composable函数脚本

#### generate_hap_test_files.sh
在单个文件中生成1000个@Composable函数。

**功能特性：**
- 生成1个大型.kt文件（BatchComposables.kt）
- 包含1000个独立的@Composable函数
- 每个函数都有独特的彩色文本内容
- 函数命名规范：BatchComposable1, BatchComposable2, ..., BatchComposable1000
- 文件大小约4.2MB，包含约138,000行代码

**使用方法：**
```bash
# 给脚本添加执行权限（首次使用）
chmod +x generate_hap_test_files.sh

# 运行脚本生成文件
./generate_hap_test_files.sh
```

**生成文件位置：**
```
composeApp/src/commonMain/kotlin/com/dong/maxhap/HapTestPage/
```

### 2. 清理测试文件脚本

#### cleanup_hap_test_files.sh（交互式）
安全删除所有生成的测试文件，带确认提示。

**功能特性：**
- 显示要删除的文件数量
- 需要用户确认才执行删除
- 删除完成后可选择是否删除空目录

**使用方法：**
```bash
# 给脚本添加执行权限（首次使用）
chmod +x cleanup_hap_test_files.sh

# 运行交互式清理
./cleanup_hap_test_files.sh
```

#### quick_cleanup.sh（快速版）
直接删除所有测试文件，无需确认。

**功能特性：**
- 直接删除，无需用户交互
- 执行速度快
- 适合自动化脚本调用

**使用方法：**
```bash
# 给脚本添加执行权限（首次使用）
chmod +x quick_cleanup.sh

# 快速清理所有文件
./quick_cleanup.sh
```

## 开发环境

### 技术栈
- Kotlin Multiplatform
- Jetpack Compose
- Android SDK
- HarmonyOS SDK

### 构建工具
- Gradle
- Hvigor（HarmonyOS构建工具）

## 构建和运行

### Android
```bash
# 构建Debug版本
./gradlew assembleDebug

# 运行Android应用
./gradlew installDebug
```

### HarmonyOS
```bash
# 构建HarmonyOS应用
cd harmonyApp
hvigorw assembleHap
```

## 项目特点

- 跨平台共享代码
- 响应式UI设计
- 模块化架构
- 支持多种构建变体

## 注意事项

1. 嵌套页面结构可用于深度导航和递归调用测试
2. 1000层嵌套可能会对调用栈造成压力，请注意性能监控
3. 清理脚本会删除NestedPage*.kt和NestedPagesMain.kt文件
4. 建议在使用清理脚本前备份重要数据