codeSearch/flet_android_guide.md

2.5 KiB

고장코드 검색기 안드로이드 앱 대체 빌드 가이드

Flet 0.21.2 버전에서 안드로이드 APK 빌드 방법이 변경되었습니다. 이 문서는 현재 버전에서 안드로이드 앱을 빌드하는 대체 방법을 안내합니다.

1. 수동 빌드 방법

최신 Flet 버전은 안드로이드 APK를 직접 빌드하는 대신, 먼저 Flutter 프로젝트를 생성한 후 Flutter 도구를 사용해 빌드하는 방식을 사용합니다.

1단계: Flet 앱 패키징

# 앱을 먼저 패키징합니다
flet pack main.py --name 고장코드검색기 --product-name 고장코드검색기

2단계: Flutter 프로젝트 생성

# 패키징된 앱을 기반으로 Flutter 프로젝트 생성
flet create flutter --path dist/codeSearch

3단계: Flutter 프로젝트에서 안드로이드 빌드

# Flutter 프로젝트 디렉토리로 이동
cd dist/codeSearch/flutter

# APK 빌드
flutter build apk --release

빌드된 APK는 dist/codeSearch/flutter/build/app/outputs/flutter-apk/app-release.apk에 생성됩니다.

2. 대체 도구: Briefcase

Flet 대신 BeeWare의 Briefcase를 사용하여 안드로이드 앱을 빌드할 수도 있습니다:

# Briefcase 설치
pip install briefcase

# 프로젝트 초기화
briefcase new

# 앱 이름, 번들 ID 등을 입력

# 안드로이드 앱 빌드
briefcase create android
briefcase build android

# APK 패키징
briefcase package android

3. 현 상황에서의 안드로이드 앱 공유 방법

1. 웹 앱으로 배포하여 모바일에서 웹 브라우저로 접근

# 웹 앱으로 배포
flet publish main.py

2. 진행 중인 Flet 모바일 지원

Flet 팀은 모바일 빌드 도구를 개선 중입니다. 최신 문서와 릴리스를 확인하세요:

4. 권장 접근 방식

현재 상황에서는 다음과 같은 접근 방식을 권장합니다:

  1. 웹 앱 배포: Flet 앱을 웹 앱으로 배포하고 모바일 브라우저에서 접근
  2. Flet 버전 호환성 검토: 과거 버전의 Flet으로 다운그레이드하거나 최신 베타 버전 시도
  3. 커뮤니티 지원 활용: Flet 이슈 트래커나 디스커션 포럼에서 도움 구하기

추가 정보

Flet의 안드로이드 빌드 지원은 아직 완전하지 않으며 활발히 개발 중입니다. 최신 정보는 공식 문서를 참조하세요.