# WebView Grammar App

本项目是一个基于 Android WebView 的语法与语音应用。为了顺利完成构建，请根据以下说明准备依赖、配置环境变量并执行 Gradle 任务。

## 依赖与版本
- **JDK**：版本 17（`JAVA_HOME` 指向对应目录）
- **Gradle**：使用仓库中 `gradle/wrapper/gradle-wrapper.properties` 内置的 Gradle **8.7**（通过 `./gradlew` 自动下载）
- **Android Gradle Plugin**：`com.android.application` **8.5.0**
- **Kotlin 插件**：`org.jetbrains.kotlin.android` **1.9.24**
- **Android SDK**：需要安装 **API 34 (Android 14)**，并额外安装 Platform-Tools 与 Build-Tools 34.x

## Android SDK 路径配置
1. 安装 Android SDK 后，记录其根目录路径（例如 `/Users/you/Library/Android/sdk` 或 `/home/you/Android/Sdk`）。
2. 在项目根目录创建或编辑 `local.properties`，写入：
   ```
   sdk.dir=/绝对路径/Android/Sdk
   ```
3. 若使用 CI，请通过环境变量 `ANDROID_HOME` 或 `ANDROID_SDK_ROOT` 指向相同目录。

## 可选的构建常量
`app/build.gradle` 中的接口地址可通过 Gradle Property 覆盖：
- `grammarApiBaseUrl`：语法 API 根路径，默认 `http://aimanyi.top`
- `ttsEndpointUrl`：TTS 接口地址，默认 `http://141.140.15.30:8028/generate`

在命令行中可以这样传入：
```
./gradlew assembleDebug -PgrammarApiBaseUrl=https://example.com -PttsEndpointUrl=https://tts.example.com
```

## 构建步骤
1. 确保安装 JDK 17 并配置 `JAVA_HOME`。
2. 安装 Android SDK API 34，并按上述方式在 `local.properties` 声明 `sdk.dir`。
3. 在项目根目录执行以下命令完成依赖下载与调试包构建：
   ```
   ./gradlew clean assembleDebug
   ```
4. 生成的 APK 位于 `app/build/outputs/apk/debug/app-debug.apk`，可通过 `adb install` 安装到设备：
   ```
   adb install -r app/build/outputs/apk/debug/app-debug.apk
   ```

## 常见问题
- **Gradle 下载失败**：检查网络或配置代理，可在 `~/.gradle/gradle.properties` 中设置代理变量。
- **SDK 路径找不到**：确认 `local.properties` 使用绝对路径，且路径中的空格已被正确转义（或使用引号）。
- **JDK 版本不匹配**：Gradle 8.7/AGP 8.5.0 需要 JDK 17；如果使用 Android Studio，请在 `File > Settings > Build Tools > Gradle` 中指定同版本 JDK。