codeSearch/안드로이드앱빌드안내서.md

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

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

빌드 준비 사항

필수 설치 프로그램

1. Java JDK 11 이상

   • 다운로드: Oracle JDK 또는 OpenJDK
   • 환경 변수 설정: JAVA_HOME을 JDK 설치 경로로 설정

2. Android SDK

   • Android Studio를 설치하면 Android SDK가 함께 설치됩니다.
   • 또는 Android SDK 단독 설치
   • 환경 변수 설정: ANDROID_SDK_ROOT를 Android SDK 설치 경로로 설정

3. Flutter SDK

   • 다운로드: Flutter 설치
   • 환경 변수 설정: 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 문서
• Flutter 안드로이드 앱 빌드
• Android 개발자 문서