# Android项目Git必须文件清单

## 📋 核心配置文件（必须）

### 1. 项目根目录
- ✅ `build.gradle` - 项目级构建配置
- ✅ `settings.gradle` - 模块配置
- ✅ `gradle.properties` - Gradle属性配置
- ✅ `.gitignore` - Git忽略规则（已存在）
- ✅ `gradlew` - Gradle Wrapper脚本（Unix/Mac）
- ✅ `gradlew.bat` - Gradle Wrapper脚本（Windows）
- ✅ `gradle/wrapper/gradle-wrapper.jar` - Gradle Wrapper JAR
- ✅ `gradle/wrapper/gradle-wrapper.properties` - Gradle Wrapper配置

### 2. 应用模块 (app/)
- ✅ `app/build.gradle` - 应用构建配置
- ✅ `app/proguard-rules.pro` - ProGuard混淆规则
- ✅ `app/src/main/AndroidManifest.xml` - 应用清单文件
- ✅ `app/src/main/java/**/*.java` - Java源代码
- ✅ `app/src/main/res/**` - 资源文件（drawable, layout, values等）
- ✅ `app/src/main/assets/**` - Assets资源文件
- ⚠️ `app/libs/**/*.aar` - 第三方AAR库（如果项目依赖）
- ⚠️ `app/heartRateBand.jks` - 签名密钥文件（**建议不要提交，使用环境变量或单独管理**）

### 3. 其他模块
每个模块都需要以下文件：
- ✅ `模块名/build.gradle` - 模块构建配置
- ✅ `模块名/proguard-rules.pro` - ProGuard规则（如果有）
- ✅ `模块名/src/main/AndroidManifest.xml` - 模块清单文件
- ✅ `模块名/src/main/java/**/*.java` - Java源代码
- ✅ `模块名/src/main/res/**` - 资源文件
- ✅ `模块名/src/main/assets/**` - Assets资源（如果有）
- ✅ `模块名/src/main/jniLibs/**` - 原生库（.so文件，如果有）
- ✅ `模块名/libs/**` - 模块依赖的库文件（如果有）

**具体模块：**
- ✅ `core/` - 核心模块
- ✅ `ICDeviceManager/` - IC设备管理模块
- ✅ `uniplugin_module/` - UniApp插件模块
- ✅ `myLockView/` - 锁屏视图模块
- ✅ `myWIFIView/` - WiFi视图模块
- ✅ `UpdateHelper/` - 更新助手模块

### 4. 文档文件（可选但建议）
- ✅ `README.md` - 项目说明（如果有）
- ✅ `*.md` - 其他文档文件（如：`快速开始.md`、`KIOSK_SETUP_GUIDE.md`等）

### 5. 脚本文件（可选）
- ✅ `*.bat` - Windows批处理脚本（如果有用）

---

## ❌ 不应该提交的文件

### 构建产物（已在.gitignore中）
- ❌ `build/` - 所有构建输出目录
- ❌ `app/build/` - 应用构建输出
- ❌ `*.iml` - IntelliJ IDEA模块文件
- ❌ `.gradle/` - Gradle缓存
- ❌ `local.properties` - 本地配置（包含SDK路径等）

### IDE文件
- ❌ `.idea/` - IntelliJ IDEA配置（部分）
- ❌ `.DS_Store` - macOS系统文件

### 敏感文件
- ⚠️ `*.jks` - 签名密钥文件（**强烈建议不要提交**）
- ⚠️ `local.properties` - 包含本地路径配置

---

## 🔒 安全建议

### 签名密钥文件处理
**不要提交以下文件到Git：**
- `app/heartRateBand.jks`
- `UpdateHelper/UpdateHelper.jks`

**建议做法：**
1. 将这些文件添加到 `.gitignore`
2. 使用环境变量或CI/CD系统管理密钥
3. 在团队中通过安全渠道共享密钥

### 更新.gitignore
建议在 `.gitignore` 中添加：
```
# 签名密钥文件
*.jks
*.keystore
```

---

## 📝 快速检查清单

在提交到Git之前，确认：

- [ ] 所有源代码文件（.java, .kt）
- [ ] 所有资源文件（res/, assets/）
- [ ] 所有构建配置文件（build.gradle, settings.gradle）
- [ ] Gradle Wrapper文件（gradlew, gradlew.bat, gradle/wrapper/）
- [ ] AndroidManifest.xml文件
- [ ] ProGuard规则文件
- [ ] 第三方库文件（libs/中的.aar, .jar）
- [ ] 原生库文件（jniLibs/中的.so）
- [ ] 文档文件（README.md等）
- [ ] .gitignore文件已正确配置
- [ ] 签名密钥文件（.jks）已排除
- [ ] local.properties已排除
- [ ] build/目录已排除

---

## 🚀 Git初始化命令

```bash
cd E:\TPlat\HeartRateProject\bBeng-HeartRate-4.66-pad

# 初始化Git仓库
git init

# 添加所有文件（.gitignore会自动排除不需要的文件）
git add .

# 提交
git commit -m "Initial commit: Android HeartRate project"
```

---

## 📌 注意事项

1. **首次提交前检查**：运行 `git status` 查看将要提交的文件，确保没有敏感信息
2. **大文件处理**：如果assets/或libs/中有大文件，考虑使用Git LFS
3. **分支策略**：建议使用main/master分支，并考虑创建develop分支用于开发
4. **提交信息**：使用清晰的提交信息，遵循约定式提交规范