안드로이드용 Qt - 소스에서 빌드하기

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

전제 조건

소스에서 Android용 Qt를 빌드하려면 계속하기 전에 Android용 Qt 시작하기의 모든 요구 사항이 충족되는지 확인하십시오.

Windows

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

  • Mingw-w64 13.1 툴체인

참고: Android용 Qt는 Microsoft Visual C++(MSVC)로 소스에서 빌드하는 것을 지원하지 않습니다.

필수 요구 사항을 설치하고 시스템에 바이너리 경로를 추가합니다 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 빌드에 사용할 최소한의 호스트 빌드를 구성하고 실행하려면 다음 명령을 사용합니다:

mkdir ~/dev/build-host
cd ~/dev/build-host
./configure -developer-build -nomake tests -nomake examples
cmake --build . --target host_tools

그러면 호스트에 대한 개발자 빌드가 구성되고 안드로이드 빌드에 사용되는 필수 종속성만 빌드됩니다. 호스트에 대한 전체 및 사용자 정의 가능한 빌드를 수행하는 방법에 대한 자세한 내용은 Qt 소스 빌드를 참조하십시오.

안드로이드용 Qt를 구성하려면 섀도 빌드 디렉터리를 생성하여 소스 디렉터리를 깨끗하게 유지합니다:

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

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

그런 다음 구성 스크립트를 실행합니다:

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

안드로이드 SDK는 일반적으로 Qt Creator 또는 안드로이드 스튜디오에서 다음 위치에 설치합니다:

  • Linux: ~/Android/Sdk/
  • macOS: ~/Library/Android/sdk/
  • Windows: C:\사용자\<사용자>\앱데이터\로컬\안드로이드\에스디케이\

참고: 구성은 항상 ninja 실행 파일을 사용할 수 있는 경우 Ninja 생성기 및 빌드 도구를 사용합니다. Ninja는 크로스 플랫폼이며 기능이 풍부하고 성능이 뛰어나며 모든 플랫폼에서 권장됩니다. 다른 생성기를 사용할 수도 있지만 공식적으로 지원되지는 않습니다.

고급 구성 인수

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

-android-javac-source 8 -android-javac-target 8

Qt를 접두사 빌드 대신 개발자 빌드로 빌드하려면 -prefix 인수 대신 다음을 사용합니다:

-developer-build

참고: 이 configure 인수를 사용할 때 Qt 빌드를 설치할 필요는 없으며, 빌드 디렉토리 내에서 바로 안드로이드용 Qt를 사용할 수 있습니다.

구성 옵션에 대한 자세한 내용은Qt 구성 옵션을 참조하십시오.

빌드

Qt를 빌드하려면 다음 명령을 실행합니다:

cmake --build . --parallel

설치

접두사 빌드의 경우, Qt를 설치하려면 다음 명령을 실행합니다:

cmake --install .

Unix에서 -prefix <install_path> 구성 옵션을 제공하지 않은 경우 설치 위치는 /usr/local/Qt-<version>, 이 경우 설치 명령과 함께 sudo 를 사용해야 합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.