Android용 Qt - 소스 코드 빌드

이 페이지에서는 Android용 Qt를 구성하고 빌드하는 과정을 설명합니다. 미리 빌드된 Android용 Qt를 다운로드하여 설치하려면 ‘Qt 시작하기’ 페이지의 지침을 따르십시오.

필수 조건

소스 코드로부터 Android용 Qt를 빌드하려면, 계속 진행하기 전에 'Android용 Qt 필수 조건'에 명시된 모든 요구 사항이 충족되었는지 확인하십시오.

Windows

Windows에서 Android용 Qt를 빌드하려면 다음 소프트웨어도 필요합니다:

• Mingw-w64 13.1 툴체인

필수 구성 요소를 설치하고 해당 바이너리 경로를 시스템 환경 변수 PATH 에 추가하십시오:

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

설치 여부를 확인하려면 다음 명령을 실행하십시오:

where mingw32-make.exe

이 명령을 실행하면 <MINGW_ROOT> 경로 아래에 mingw32-make.exe가 가장 먼저 표시되어야 합니다.

소스 코드 구하기

Qt 소스 코드는 Qt 다운로드 페이지에서 다운로드하거나, 위키 가이드의 ‘소스 코드 얻기’ 항목을 따라 얻을 수 있습니다.

구성

Qt 6을 사용하면 CMake 를 통해 소스 코드에서 Android용 Qt를 빌드할 수 있습니다. Android용 Qt 6에는 호스트 Qt 빌드가 필요합니다. 즉, Android용 Qt를 빌드하려면 호스트로 사용되는 데스크톱 플랫폼(Linux, macOS 또는 Windows)용 Qt를 먼저 빌드해야 합니다. 자세한 내용은 Qt 크로스 컴파일을 참조하십시오.

Android용 Qt를 구성하려면 소스 디렉터리를 깔끔하게 유지하기 위해 섀도 빌드 디렉터리를 생성하십시오:

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Android용 Qt는 다음 디바이스 아키텍처(ABI)를 지원합니다: arm64-v8a, x86_64, x86, 그리고 armeabi-v7a

그런 다음 방금 생성한 빌드 디렉터리 내에서 configure 스크립트를 실행하십시오:

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

Android SDK는 일반적으로 Qt Creator 또는 Android Studio를 통해 다음 위치에 설치됩니다:

• Linux: ~/Android/Sdk/
• macOS: ~/Library/Android/sdk/
• Windows: C:\Users\<USER>\AppData\Local\Android\Sdk\

고급 configure 인수

이 섹션을 살펴보기 전에, configure 옵션에 대한 자세한 정보가 포함된 ‘Qt configure 옵션’을 참조하십시오.

Android용 Qt에는 javac 컴파일러로 *.jar 파일로 컴파일된 Java 코드가 포함되어 있습니다. 소스 및 대상에 대한 javac 버전을 설정하려면 각각 -android-javac-source 및 -android-javac-target을 사용하십시오:

-android-javac-source 17 -android-javac-target 17

접두사 빌드 대신 개발자 빌드로 Qt를 빌드하려면, ` -prefix ` 인수 대신 다음을 사용하십시오:

-developer-build

-qt-host-path 는 호스트 개발자 빌드에서 호스트 빌드 디렉터리의 qtbase 디렉터리를 가리켜야 합니다. 예: ~/dev/build-qt-host/qtbase.

빌드

Qt를 빌드하려면 다음 명령을 실행하십시오:

cmake --build . --parallel

설치

접두사(prefix) 빌드의 경우, Qt를 설치하려면 다음 명령을 실행하십시오:

cmake --install .

Unix에서 -prefix <install_path> configure 옵션을 지정하지 않은 경우, 설치 위치는 /usr/local/Qt-<version> 아래가 됩니다. 이 경우, install 명령을 사용할 때 sudo 을 사용해야 합니다.