# 고장코드 검색기 안드로이드 앱 빌드 안내서

이 문서는 고장코드 검색기 앱을 안드로이드 APK로 빌드하는 과정을 설명합니다.

## 빌드 준비 사항

### 필수 설치 프로그램

1. **Java JDK 11 이상**
   - 다운로드: [Oracle JDK](https://www.oracle.com/java/technologies/downloads/) 또는 [OpenJDK](https://adoptium.net/)
   - 환경 변수 설정: `JAVA_HOME`을 JDK 설치 경로로 설정

2. **Android SDK**
   - [Android Studio](https://developer.android.com/studio)를 설치하면 Android SDK가 함께 설치됩니다.
   - 또는 [Android SDK 단독 설치](https://developer.android.com/studio#command-tools)
   - 환경 변수 설정: `ANDROID_SDK_ROOT`를 Android SDK 설치 경로로 설정

3. **Flutter SDK**
   - 다운로드: [Flutter 설치](https://docs.flutter.dev/get-started/install/windows)
   - 환경 변수 설정: Flutter SDK 경로를 PATH에 추가

4. **Flet CLI**
   - 설치: `pip install flet`

### 프로젝트 설정

1. **앱 설정 확인**
   - `flet_app_config.py` 파일에서 앱 이름, 패키지명, 버전 등을 확인/수정

2. **앱 아이콘 준비**
   - 512x512 픽셀 PNG 이미지를 `assets/app_icon.png`로 저장
   - 이미 간단한 파란색 아이콘이 생성되어 있습니다.

## 빌드 과정

### 1. 환경 변수 설정

Windows에서:
```
set ANDROID_SDK_ROOT=C:\Users\사용자명\AppData\Local\Android\Sdk
set ANDROID_SDK_ROOT=C:\Users\khchoi\AppData\Local\Android\Sdk
```

Linux/macOS에서:
```
export ANDROID_SDK_ROOT=/Users/사용자명/Library/Android/sdk

```

### 2. 빌드 스크립트 실행

```
python android_build.py
```

빌드가 성공하면 프로젝트 루트 디렉토리에 `고장코드검색기_1.0.0.apk` 파일이 생성됩니다.

## 설치 방법

### 안드로이드 기기에 APK 설치

1. APK 파일을 안드로이드 기기로 전송
2. 기기에서 '알 수 없는 출처' 앱 설치 허용
   - 설정 > 보안 > 알 수 없는 출처 (기기에 따라 경로가 다를 수 있음)
3. 파일 관리자에서 APK 파일 선택하여 설치

## 문제 해결

### 빌드 오류 

1. **Java 버전 호환성 문제**
   - Java 11 이상이 설치되어 있는지 확인: `java -version`

2. **Android SDK 경로 문제**
   - Android SDK 경로가 올바르게 설정되었는지 확인
   - `android_build.py` 스크립트에서 SDK 경로를 직접 지정 가능

3. **Flutter 설치 문제**
   - Flutter 설치 확인: `flutter doctor`
   - 모든 항목이 체크표시로 표시될 때까지 필요한 구성 요소 설치

## 추가 리소스

- [Flet 문서](https://flet.dev/docs/)
- [Flutter 안드로이드 앱 빌드](https://docs.flutter.dev/deployment/android)
- [Android 개발자 문서](https://developer.android.com/)