guoyu/log/备份/md/内层_gradle-fix-guide.md

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，将：

classpath 'com.android.tools.build:gradle:8.0.2'

改为：

classpath 'com.android.tools.build:gradle:7.4.2'

同时修改 simpleDemo/build.gradle：

compileSdkVersion 33
buildToolsVersion '33.0.0'

改为：

compileSdkVersion 31
buildToolsVersion '31.0.0'

备选方案 2：清理 Gradle 缓存

在 PowerShell 中执行：

cd D:\4_Part\HBuilder-Android\HBuilder-Integrate-AS
.\gradlew clean --refresh-dependencies

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

编辑 gradle.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 一直有问题，可以直接用命令行：

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 库	无	已添加
镜像	部分配置	完全国内化