# caidan

**Repository Path**: wwjedu/caidan

## Basic Information

- **Project Name**: caidan
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-17
- **Last Updated**: 2026-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 餐饮菜单生成器 - Android APK 打包步骤

## 方式一：使用 Android Studio (推荐新手)

### 1. 安装必要软件

**Java JDK 17:**
```bash
winget install OpenJDK.JDK.17
# 或手动下载: https://adoptium.net/temurin/releases/?version=17
```

**Android Studio:**
```
下载地址: https://developer.android.com/studio
```
安装时勾选：
- Android SDK
- Android Virtual Device (模拟器)
- SDK Platforms → Android 14 (API 34)
- SDK Tools → Android SDK Build-Tools 34.0.0

### 2. 打开项目

```bash
# 启动 Android Studio
start "" "E:\小工具设计\餐饮菜单\mobile\android"
```

或在 Android Studio 中：
- `File` → `Open` → 选择 `android` 文件夹

### 3. 同步 Gradle

点击顶部提示的 `Sync Now` 按钮

### 4. 连接设备或启动模拟器

**连接手机：**
1. 手机开启开发者选项和 USB 调试
2. 用 USB 连接电脑
3. Android Studio 会自动识别

**使用模拟器：**
1. `Tools` → `Device Manager`
2. 创建虚拟设备 (建议 Pixel 5, Android 14)
3. 启动模拟器

### 5. 运行应用

点击 `Run` 按钮 (▶️) 或按 `Shift + F10`

### 6. 导出 APK

菜单: `Build` → `Build Bundle(s) / APK(s)` → `Build APK(s)`

APK 位置: `android/app/build/outputs/apk/debug/app-debug.apk`

---

## 方式二：命令行构建

### 1. 设置环境变量

```powershell
# PowerShell (管理员)
$env:JAVA_HOME = "C:\Program Files\Java\jdk-17"
$env:ANDROID_HOME = "$env:USERPROFILE\AppData\Local\Android\Sdk"
$env:Path = "$env:JAVA_HOME\bin;$env:ANDROID_HOME\platform-tools;$env:ANDROID_HOME\tools;$env:ANDROID_HOME\tools\bin;$env:Path"
```

### 2. 构建 APK

```powershell
cd E:\小工具设计\餐饮菜单\mobile\android
.\gradlew.bat assembleDebug
```

构建完成后:
```
app\build\outputs\apk\debug\app-debug.apk
```

---

## 方式三：GitHub Actions 远程构建 (无需本地环境)

1. 将项目推送到 GitHub
2. Actions 会自动构建 APK
3. 在 Actions 页面下载 APK

详见 `.github/workflows/build.yml`

---

## 更新应用内容

修改 `www/` 目录下的文件后，重新同步：

```bash
cd E:\小工具设计\餐饮菜单\mobile
npx cap sync
# 然后重新构建
```

---

## 常见问题

### Q: gradlew.bat 执行失败
A: 确保 Java 和 Android SDK 已正确安装并设置环境变量

### Q: 模拟器启动慢
A: 在 BIOS 中启用虚拟化 (Intel VT-x / AMD-V)

### Q: APK 无法安装
A: 手机设置 → 安全 → 允许安装未知来源应用

### Q: 应用白屏
A: 检查浏览器控制台是否有错误，确保 www/ 目录下的文件完整