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