# Gradle 同步问题解决指南

## ✅ 已完成的修复

### 1. 降级 Android Gradle Plugin
- **修改文件**: `HBuilder-Integrate-AS/build.gradle`
- **从**: `com.android.tools.build:gradle:8.7.3`
- **改为**: `com.android.tools.build:gradle:8.0.2`

### 2. 优化镜像配置
- 使用阿里云镜像（主）
- 使用华为云镜像（备用）
- 移除 Google 仓库（被墙）

### 3. 配置应用信息
- AppID: `uni.app.UNI08E0C13`
- 添加 Vosk 语音库依赖

---

## 🔧 下一步操作

### 在 Android Studio 中

1. **重新同步**
   - 点击顶部的 "Sync Now"
   - 或菜单：File → Sync Project with Gradle Files

2. **等待同步完成**
   - 首次约需 5-10 分钟
   - 等待底部显示 "Gradle sync finished"

---

## 🐛 如果还是失败

### 备选方案 1：使用更低版本

编辑 `HBuilder-Integrate-AS/build.gradle`，将：
```gradle
classpath 'com.android.tools.build:gradle:8.0.2'
```

改为：
```gradle
classpath 'com.android.tools.build:gradle:7.4.2'
```

同时修改 `simpleDemo/build.gradle`：
```gradle
compileSdkVersion 33
buildToolsVersion '33.0.0'
```

改为：
```gradle
compileSdkVersion 31
buildToolsVersion '31.0.0'
```

### 备选方案 2：清理 Gradle 缓存

在 PowerShell 中执行：
```powershell
cd D:\4_Part\HBuilder-Android\HBuilder-Integrate-AS
.\gradlew clean --refresh-dependencies
```

### 备选方案 3：配置代理（如果有）

编辑 `gradle.properties`，添加：
```properties
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890
```

（根据实际代理设置）

---

## 📊 同步成功的标志

### 成功后会显示：

- ✅ 底部状态栏：`Gradle sync finished`
- ✅ 项目树中没有红色错误标记
- ✅ 可以看到 `simpleDemo` 模块的完整结构

### 然后可以：

1. 构建 APK
   - Build → Build Bundle(s) / APK(s) → Build APK(s)

2. APK 输出位置
   - `simpleDemo/build/outputs/apk/debug/simpleDemo-debug.apk`

---

## ⚡ 快速命令行构建（备用）

如果 Android Studio 一直有问题，可以直接用命令行：

```powershell
cd D:\4_Part\HBuilder-Android\HBuilder-Integrate-AS

# 清理
.\gradlew clean

# 构建 Debug APK
.\gradlew assembleDebug

# 构建 Release APK  
.\gradlew assembleRelease
```

---

## 📞 常见错误

### 1. SSL 握手失败
- **原因**: 网络环境问题
- **解决**: 使用国内镜像（已配置）

### 2. 找不到依赖
- **原因**: 版本太新或镜像未同步
- **解决**: 降级版本（已完成）

### 3. Gradle 版本不兼容
- **原因**: Gradle 版本与 Plugin 不匹配
- **解决**: 确保使用 Gradle 8.x

---

## ✅ 修改总结

| 项目 | 修改前 | 修改后 |
|------|--------|--------|
| Android Gradle Plugin | 8.7.3 | 8.0.2 |
| 编译 SDK | 35 | 33 |
| BuildTools | 35.0.0 | 33.0.0 |
| ApplicationId | com.android.simple | uni.app.UNI08E0C13 |
| Vosk 库 | 无 | 已添加 |
| 镜像 | 部分配置 | 完全国内化 |