# 手动安装Gradle并构建APK

## 问题分析
当前构建失败的主要原因是系统中缺少Gradle工具。本指南将帮助您手动安装Gradle并成功构建APK。

## 步骤1：下载Gradle

1. 访问Gradle官方下载页面：https://gradle.org/releases/
2. 下载最新的**Binary-only**版本（例如：gradle-8.5-bin.zip）
3. 将下载的zip文件保存到您的计算机（建议保存到：`C:\gradle`）

## 步骤2：安装Gradle

1. 解压缩下载的zip文件
2. 将解压缩后的文件夹重命名为`gradle`（例如：`C:\gradle`）

## 步骤3：配置环境变量

1. 按下 `Win + R`，输入 `sysdm.cpl`，回车
2. 点击 "高级" 标签页，然后点击 "环境变量"

3. **创建系统变量**：
   - 变量名：`GRADLE_HOME`
   - 变量值：`C:\gradle`

4. **更新系统变量PATH**：
   - 找到并选择 "Path" 变量
   - 点击 "编辑"
   - 点击 "新建"
   - 输入：`%GRADLE_HOME%\bin`
   - 点击 "确定" 保存所有更改

## 步骤4：验证Gradle安装

1. 打开命令提示符（`Win + R`，输入 `cmd`，回车）
2. 运行命令：`gradle --version`
3. 如果成功，您将看到Gradle版本信息

## 步骤5：构建APK

1. 打开命令提示符
2. 导航到项目目录：
   ```cmd
   cd /d E:\xampp\htdocs\www\kc-app
   ```

3. 运行构建命令：
   ```cmd
   cordova build android --debug
   ```

## 替代方案：直接使用Android Studio构建

如果上述方法仍然失败，建议使用Android Studio直接构建：

1. 启动Android Studio
2. 点击 "Open an existing project"
3. 选择路径：`E:\xampp\htdocs\www\kc-app\platforms\android`
4. 等待项目加载完成（可能需要下载依赖）
5. 点击顶部菜单：`Build > Build Bundle(s) / APK(s) > Build APK(s)`
6. 构建完成后，点击 "locate" 按钮找到APK文件

## 在线构建替代方案

如果本地构建持续失败，您可以使用在线APK构建工具：

1. 将项目文件夹 `kc-app` 压缩为zip文件
2. 访问在线构建工具，如：
   - AppGyver Cloud Build (https://www.appgyver.com/)
   - PhoneGap Build (https://build.phonegap.com/)
3. 上传zip文件并按照网站提示构建APK

## 常见问题排查

### 问题1：Cordova命令找不到
- 确保已全局安装Cordova：`npm install -g cordova`

### 问题2：Java版本错误
- 确保使用的是Java JDK 17或更高版本
- 检查 `JAVA_HOME` 环境变量是否正确设置

### 问题3：Android SDK路径错误
- 检查 `ANDROID_HOME` 环境变量是否指向正确的SDK目录
- 通常为：`C:\Users\admin\AppData\Local\Android\Sdk`

### 问题4：网络连接问题
- 第一次构建需要下载大量依赖，确保网络连接稳定
- 考虑配置Gradle代理（如果在受限网络环境中）

## 联系方式

如果您仍然遇到问题，建议联系技术支持或寻求专业开发人员的帮助。