파이썬 코드 안드로이드 앱으로 변환하는 3가지 실제 방법

파이썬으로 만든 프로그램을 안드로이드 앱으로 만들고 싶다면, 생각보다 방법이 다양합니다. 핵심은 파이썬 코드를 그대로 안드로이드에서 실행할 수 있는 환경을 만드는 것인데요.

이 글에서는 실제로 동작하는 세 가지 접근 방식을 소개합니다. 각각 장단점이 있으니 자신의 프로젝트 성격에 맞게 선택하면 됩니다.

파이썬 프로그램을 안드로이드 앱으로 만드는 가장 쉬운 길, Flet

파이썬 개발자라면 Flutter를 활용하는 Flet 라이브러리를 먼저 고려해볼 만합니다. Flet은 파이썬 코드만으로 안드로이드 앱을 만들 수 있게 해주는데, Flutter의 강력한 UI 엔진을 그대로 가져오면서도 파이썬 문법으로 개발할 수 있다는 장점이 있습니다.

먼저 컴퓨터에 Flutter를 설치해야 합니다. 설치 후 명령 프롬프트에서 flutter doctor를 실행하면 필요한 프로그램들이 제대로 설치되었는지 한눈에 확인할 수 있습니다.

대부분의 경우 Visual Studio나 Android Studio 등 몇 가지가 빠져 있을 텐데, 하나씩 설치해주면 됩니다. Android Studio를 설치했다면 함께 제공되는 Android Emulator도 꼭 설치해두세요.

앱 실행 결과를 바로 확인할 수 있어서 개발 속도가 훨씬 빨라집니다. Flet 설치는 간단합니다.

터미널에서 pip install flet 한 줄이면 끝입니다. 업그레이드가 필요할 때는 pip install flet --upgrade를 사용합니다.

이제 실제로 앱을 만들어볼 차례입니다. main.py 파일을 하나 만들고 원하는 파이썬 코드를 작성합니다.

예를 들어 텍스트를 출력하는 아주 간단한 프로그램도 괜찮습니다. 중요한 건 파일명을 반드시 main.py로 해야 한다는 점입니다.

이 파일을 Flet이 설치된 경로 안에 새 프로젝트 폴더를 만들어 넣습니다. 예를 들어 C:\...\site-packages\flet\bin\flet\test 같은 식입니다.

그 다음 VS Code 터미널에서 해당 경로로 이동한 후 flet build apk 명령어를 입력하면 APK 파일이 생성됩니다. 여기서 한 가지 주의할 점이 있습니다.

빌드 과정에서 여러 오류가 발생할 수 있는데요. 제가 겪었던 경우를 몇 가지 정리해보겠습니다.

• Git이 설치되지 않은 경우: Git을 미리 설치해두지 않으면 빌드가 중단됩니다.
• 패키지 버전 불일치: Flutter가 설치된 폴더에서 flutter pub outdated 명령어를 실행해 업데이트가 필요한 패키지를 확인하고 업데이트합니다.
• 개발자 모드 비활성화: "Please enable Developer Mode"라는 에러 메시지가 뜨면 윈도우 설정에서 개발자 모드를 활성화해야 합니다.

이런 오류들은 대부분 검색이나 ChatGPT를 활용하면 해결 방법을 쉽게 찾을 수 있습니다. 생성된 APK 파일은 Android Emulator를 통해 실행 결과를 바로 확인할 수 있습니다.

Android Studio의 Device Manager에서 원하는 에뮬레이터를 선택하고 실행하면 됩니다.

Kivy, 전통적인 방식은 여전히 유효하다

Flet이 나오기 전까지 가장 널리 사용된 방법은 Kivy입니다. Kivy는 파이썬만으로 멀티터치 애플리케이션을 만들 수 있는 오픈소스 라이브러리로, 안드로이드와 iOS 모두 지원합니다.

다만 개인적으로는 Flet보다 설정이 까다롭고 UI가 덜 깔끔하게 느껴졌습니다. Kivy를 사용하려면 먼저 pip install kivy로 설치하고, 안드로이드 빌드를 위해 buildozer라는 도구를 추가로 설치해야 합니다.

pip install buildozer 명령어로 설치한 후, 프로젝트 폴더에서 buildozer init을 실행하면 설정 파일이 생성됩니다. 이 파일에서 앱 이름, 패키지 이름, 아이콘 등을 지정한 뒤 buildozer android debug 명령어로 APK를 생성합니다.

Kivy의 장점은 파이썬 코드를 거의 수정하지 않고도 안드로이드에서 실행할 수 있다는 점입니다. 하지만 Flet에 비해 UI 구현이 직관적이지 않고, 빌드 시간이 오래 걸리는 단점이 있습니다.

특히 buildozer로 첫 빌드를 할 때는 필요한 라이브러리를 모두 다운로드하고 컴파일하는 과정 때문에 30분 이상 걸리기도 합니다.

Chaquopy, 안드로이드 스튜디오 안에 파이썬을 심다

세 번째 방법은 Chaquopy입니다. 이는 안드로이드 스튜디오 프로젝트에 파이썬 코드를 직접 포함시킬 수 있게 해주는 Gradle 플러그인입니다.

기존에 안드로이드 개발 경험이 있고, 특정 기능만 파이썬으로 구현하고 싶을 때 유용합니다. 사용 방법은 안드로이드 스튜디오에서 새 프로젝트를 만들고, 프로젝트 수준의 build.gradle 파일에 Chaquopy 플러그인을 추가합니다.

그 다음 앱 수준의 build.gradle에서 파이썬 버전과 필요한 패키지를 지정하면 됩니다. 파이썬 코드는 app/src/main/python 폴더에 넣으면 됩니다.

이 방법의 장점은 안드로이드 네이티브 기능(카메라, 센서, GPS 등)을 자유롭게 사용하면서도 파이썬의 강력한 라이브러리(머신러닝, 데이터 분석 등)를 활용할 수 있다는 점입니다. 단점은 안드로이드 스튜디오와 Gradle 설정에 익숙해야 한다는 것입니다.

초보자라면 진입 장벽이 조금 높을 수 있습니다.

FAQ 파이썬 안드로이드 앱 만들 때 자주 묻는 질문

Q. Flet으로 만든 앱의 성능은 어떤가요?

A. 간단한 UI와 데이터 처리는 무리 없이 동작합니다. 하지만 복잡한 그래픽이나 실시간 처리가 필요한 게임 같은 경우에는 성능이 떨어질 수 있습니다.

Flutter 엔진을 기반으로 하기 때문에 일반적인 앱 수준에서는 충분합니다.

Q. iOS 앱도 만들 수 있나요?

A. Flet과 Kivy 모두 iOS 빌드를 지원합니다. 단, iOS의 경우 애플의 정책 때문에 실제 배포를 위해서는 맥OS 환경과 Xcode가 필요합니다.

안드로이드에 비해 빌드 과정이 더 까다롭습니다.

Q. 앱을 구글 플레이스토어에 올릴 수 있나요?

A. 가능합니다. Flet이나 Kivy로 만든 APK도 구글 플레이스토어의 정책을 준수하기만 하면 업로드할 수 있습니다.

다만 앱 서명, 개인정보 처리방침 등 추가로 준비해야 할 사항이 있으므로 관련 가이드를 꼭 확인해야 합니다.

Q. 어떤 방법이 가장 배우기 쉬운가요?

A. 파이썬만 할 줄 알고 안드로이드 개발 경험이 없다면 Flet이 가장 쉽습니다. 파이썬 코드를 그대로 사용하면서 UI도 간단히 구성할 수 있기 때문입니다.

반대로 안드로이드 개발 경험이 있다면 Chaquopy가 더 익숙할 수 있습니다.

Q. 빌드 시간이 너무 오래 걸리는데 방법이 없나요?

A. 첫 빌드는 항상 오래 걸립니다. 특히 Kivy의 buildozer는 처음에 모든 의존성을 다운로드하고 컴파일해야 하므로 시간이 많이 소요됩니다.

Flet의 경우 비교적 빠른 편이지만, 인터넷 속도와 컴퓨터 사양에 따라 차이가 있습니다. 한 번 빌드한 후에는 캐시가 남아 있어 두 번째부터는 훨씬 빠릅니다.