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

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

## 1. 수동 빌드 방법

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

### 1단계: Flet 앱 패키징

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

### 2단계: Flutter 프로젝트 생성

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

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

```bash
# 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를 사용하여 안드로이드 앱을 빌드할 수도 있습니다:

```bash
# Briefcase 설치
pip install briefcase

# 프로젝트 초기화
briefcase new

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

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

# APK 패키징
briefcase package android
```

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

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

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

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

Flet 팀은 모바일 빌드 도구를 개선 중입니다. 최신 문서와 릴리스를 확인하세요:
- [Flet GitHub](https://github.com/flet-dev/flet)
- [Flet 문서](https://flet.dev/docs)

## 4. 권장 접근 방식

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

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

## 추가 정보

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