86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
# 고장코드 검색기 안드로이드 앱 빌드 안내서
|
|
|
|
이 문서는 고장코드 검색기 앱을 안드로이드 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/) |