# Quick Start Guide

## 快速開始指南

### Prerequisites (前置要求)

1. **Node.js & npm** - [Download](https://nodejs.org/)
2. **Java Development Kit (JDK)** - [Download](https://www.oracle.com/java/technologies/downloads/)
3. **Android Studio & SDK** - [Download](https://developer.android.com/studio)
4. **Cordova CLI** - `npm install -g cordova`

### Environment Setup (環境設定)

#### Mac/Linux

Add to `~/.bash_profile` or `~/.zshrc`:

```bash
export ANDROID_HOME=$HOME/Library/Android/sdk
export ANDROID_SDK_ROOT=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/platform-tools
```

#### Windows

1. Set environment variable `ANDROID_HOME` to your Android SDK path
2. Add to PATH: `%ANDROID_HOME%\tools` and `%ANDROID_HOME%\platform-tools`

### Project Initialization (項目初始化)

```bash
cd "Android Photo App"
npm install
```

### First Run (第一次運行)

```bash
# Check requirements
cordova requirements android

# Add Android platform
cordova platform add android

# Add required plugins
cordova plugin add cordova-plugin-printer
cordova plugin add cordova-plugin-device
cordova plugin add cordova-plugin-statusbar
```

### Build Commands (構建命令)

```bash
# Debug build
npm run cordova-build

# Release build (requires keystore)
npm run cordova-build-apk

# Clean and rebuild
cordova clean && cordova build android --release
```

### Run on Device/Emulator (在設備/模擬器上運行)

```bash
# List connected devices
adb devices

# Install debug APK
adb install -r platforms/android/build/outputs/apk/debug/app-debug.apk

# Install release APK
adb install -r platforms/android/build/outputs/apk/release/app-release.apk
```

### Troubleshooting (故障排除)

**Problem: Gradle build fails**
```bash
cordova clean
rm -rf platforms/android
cordova platform add android
```

**Problem: Cannot find Android SDK**
```bash
# Ensure ANDROID_HOME is set correctly
echo $ANDROID_HOME

# Reinstall platform tools
sdkmanager "build-tools;33.0.0"
sdkmanager "platform-tools"
```

**Problem: Device not recognized**
```bash
# Restart ADB daemon
adb kill-server
adb start-server
adb devices
```

### File Structure (文件結構)

```
├── www/
│   ├── index.html           # Entry point
│   ├── js/
│   │   ├── main.js          # Vue initialization
│   │   ├── App.js           # Main component
│   │   └── utils.js         # Helper functions
│   ├── css/
│   │   └── styles.css       # Global styles
│   └── assets/              # Images, logos
├── config.xml               # Cordova config
├── package.json             # Dependencies
├── README.md                # Full documentation
└── PLUGINS.md               # Plugin information
```

### Next Steps (下一步)

1. Add your app logo: Place in `www/assets/logo.png`
2. Configure API token in [www/js/utils.js](www/js/utils.js)
3. Test on emulator or device
4. Build release APK for distribution

### Support (支援)

- Cordova Docs: https://cordova.apache.org/docs/
- Vue 3 Docs: https://vuejs.org/
- Android Development: https://developer.android.com/