우분투에서 flet app을 android apk 로 만들기 위한 환경 설정

환경은 우분투 26.04 라고 가정한다.

 

1. 시스템 필수 패키지 및 자바(JDK 17) 설치

1-1) 설치

 

sudo apt update

sudo apt install -y openjdk-17-jdk git curl unzip cmake ninja-build clang pkg-config

 

설치가 끝난 후 java -version 을 입력하여 17 버전이 정상적으로 잡히는지 확인한다.

만약 다른 버전이 잡힌다면

 

1-2) 자바 버전 교체

 

sudo update-alternatives --config java

 

이 명령어를 치면 화면에 현재 설치된 자바 버전들의 목록과 번호가 뜬다. 그중에서 java-17-openjdk 가 포함된 줄을 찾은 뒤, 해당 줄의 맨 앞에 있는 번호를 키보드로 입력하고 엔터를 누른다.

 

1-3) 자바 컴파일러 버전 교체

앱 빌드 시 내부적으로 사용하는 컴파일러의 버전도 똑같이 17로 맞춰주는 것이 안전하다.

 

sudo update-alternatives --config javac

 

마찬가지로 17 버전에 해당하는 번호를 누르고 엔터를 친다.

 

1-4) JAVA_HOME 환경 변수

주입 안드로이드 컴파일러(Gradle)는 버전을 찾을 때 환경 변수를 우선적으로 참조하는 경향이 있다. 현재 터미널 창에 17 버전의 경로를 확실하게 못 박아준다.

 

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

export PATH=$JAVA_HOME/bin:$PATH

 

또는 영구적으로 효과를 나타내게 하려면 .bashrc 파일에 같은 내용을 입력해준다. 그리고

source ~/.bashrc

명령을 내린다.

 

2. 안드로이드 스튜디오 설치

 

2-1) 설치

https://developer.android.com/studio?hl=ko 에 방문하여 안드로이드 스튜디오를 다운 받고 설치한다.

 

2-2) 설치 후 세팅 1

설치 후 {안드로이드 스튜디오 설치 폴더}/bin 을 PATH 에 넣어준다.

export PATH= {안드로이드 스튜디오 설치 폴더}/bin :$PATH

와 같이 1-3) 과 같은 방법으로 추가한다.

 

2-3) 설치 후 세팅 2

안드로이드 스튜디오에서 Settings - Languages & Frameworks - Android SDK - SDK Tools 에서

 

Android SDK Build-Tools

NDK (Side by side)

Android SDK Command-line Tools

CMake

Android Emulator

Android SDK Platform-Tools

 

등 항목이 체크되어 함께 설치되었는지 확인하고 안되어 잇으면 체크하고 적용한다.

 

3. uv 패키지 매니저 설치

curl -LsSf https://astral.sh/uv/install.sh | sh

 

4. 프로젝트 초기화 및 flet 설치

 

mkdir flet_linux_app

cd flet_linux_app

uv init uv add flet

 

5. 안드로이드 빌드 실행

5-1) 빌드 명령

 

uv run flet build apk --yes -v

 

5-2) apk 확인

build/apk 폴더에서 정상적으로 apk 파일이 만들어졌는지 확인한다.

 

6. 안드로이드에 설치

다음 둘 중 하나로 설치하여 실행해 본다.

 

6-1) 파일 전송 및 스마트폰 직접 설치

1. 파일 전송: 카카오톡 '내게 쓰기', 이메일, 구글 드라이브 등을 활용하여 컴퓨터에 있는 .apk 파일을 스마트폰으로 전송하고 다운로드한다. (USB 케이블로 폰을 연결해 직접 복사해 넣어도 된다.)
2. 앱 설치: 스마트폰의 '내 파일(파일 관리자)' 앱을 열고 다운로드한 .apk 파일을 터치한다.
3. 보안 권한 허용: 구글 플레이 스토어를 거치지 않고 직접 만든 파일이므로 설치가 차단된다.
   • "출처를 알 수 없는 앱 설치" 경고가 뜨면 '설정'을 눌러 권한을 허용해 준다.
   • "Play 프로텍트에 의해 차단됨" 경고가 뜨면 '세부정보 보기'를 누른 뒤 '그래도 설치(안전하지 않음)'를 눌러 진행한다. 본인이 직접 짠 코드이므로 안심해도 된다.

6-2) 터미널 명령어로 바로 설치

현재 안드로이드 SDK가 모두 세팅되어 있으므로, 폰을 컴퓨터에 연결한 상태라면 명령어로 아주 우아하게 설치할 수 있다.

1. 스마트폰의 설정에서 개발자 옵션을 켜고 USB 디버깅을 활성화한다.
2. 스마트폰을 컴퓨터에 USB 케이블로 연결한다. (폰 화면에 디버깅 허용 팝업이 뜨면 '허용'을 누른다.)
3. 다음 명령을 입력한다.   adb install build/apk/app-release.apk