Android용 Qt의 필수 구성 요소

Qt를 사용하여 Android용 애플리케이션을 개발하려면 필요한 도구와 종속성을 갖춘 개발 환경을 설정해야 합니다. 이 페이지에서는 시작하는 데 도움이 되는 단계별 지침을 제공합니다.

Android 개발 필수 조건

Qt for Android로 개발하려면 다음 전제 조건이 필요합니다:

• Java 개발 키트(JDK)
• 다음이 포함된 Android 명령줄 도구:
  • Android NDK: C++ 코드 빌드용.
  • Android SDK 플랫폼 및 Android SDK 빌드 도구: Android 앱 빌드용.
  • Android SDK 플랫폼 도구: Android 종속성을 배포하고 관리하는 데 사용됩니다.

필수 구성 요소 설치

Qt Creator 의 Android 개발 환경 설정 사용

의존성을 관리하는 가장 쉬운 방법은 Qt Creator 의 내장된 Android 개발 설정 기능을 사용하는 것입니다. Android용 Qt를 설치한 후 Qt Creator 를 처음 열면 Android 설정 마법사를 실행할지 묻는 메시지가 표시됩니다. 이 과정에서는 Android용 OpenSSL도 함께 설정됩니다.

기존 SDK 위치 사용

이미 Android SDK가 설정되어 있다면 이 마법사를 실행할 필요가 없습니다. 대신, Qt Creator 에서 Preferences > Devices > Android 로 이동하여 기존 JDK 및 SDK 경로를 지정하십시오. 일반적인 Android SDK 경로를 참조하십시오. 자세한 내용은 Qt Creator: Android 개발 환경 설정을 참조하십시오.

필수 구성 요소 수동 설치

필수 구성 요소를 수동으로 설치하려면 다음 단계를 따르십시오.

1. Java Development Kit(JDK)를 설치하십시오.

   Android용 Qt 개발에는 다음 지원 배포판 중 하나에서 제공하는 JDK 21 이상이 필요합니다:

   • Adoptium
   • OpenJDK
   • Java SE 개발 키트

   원하는 JDK를 설치하십시오. 설치 프로그램이 설치된 JDK의 위치를 가리키는 ` JAVA_HOME ` 환경 변수를 설정하지 않는 경우, 수동으로 설정할 수 있습니다. 예를 들어, Linux에서는 다음과 같이 설정합니다:

   sudo apt-get install openjdk-21-jdk
   export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

   또는 macOS의 경우:

   brew install openjdk@21
   sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \
       "/Library/Java/JavaVirtualMachines/openjdk-21.jdk"
   export JAVA_HOME="$(/usr/libexec/java_home -v 21)"

2. Android SDK 명령줄 도구를 설치하십시오. 사용 중인 운영 체제에 맞는 최신 버전의 Android SDK 명령줄 도구를 다운로드한 후, 아래에 명시된 적절한 경로에 압축을 풀어 주십시오.

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

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

   또는 사용 중인 OS의 패키지 관리자를 사용하세요. 예를 들어 macOS의 경우:

   brew install android-commandlinetools

3. Android SDK 플랫폼, 빌드 도구 및 플랫폼 도구를 설치하십시오.

   반드시 SDK 플랫폼, 플랫폼 도구 및 빌드 도구를 설치하십시오. Qt 6.12의 경우 다음 명령을 사용하십시오:

   sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

4. Android NDK를 설치하십시오.

   Qt 6.12는 NDK 27.2.12479018을 사용하며, 다음 명령어를 실행하여 설치할 수 있습니다:

   sdkmanager "ndk;27.2.12479018"

5. (선택 사항) Android 에뮬레이터를 설치합니다.

   Android 에뮬레이터를 사용하려면 다음 명령을 실행하여 설치할 수 있습니다:

   sdkmanager "emulator"

6. 플랫폼별 구성
   • Windows의 경우, extras Android SDK 패키지에서 제공하는 추가 USB 드라이버를 설치해야 합니다. 다음 명령을 실행하여 설치하십시오:

     sdkmanager.bat "extras;google;usb_driver"

   • 리눅스의 경우, Qt Creator 에서 사용할 수 있는 adb 또는 gdb 와 같은 도구를 사용하려면 다음 종속성이 필요합니다:

     sudo apt-get install libstdc++6 libncurses5

     참고: Android 에뮬레이터가 적절한 성능을 발휘하려면하드웨어 가속이 필요합니다. 하드웨어 가속이 없으면 에뮬레이터는 소프트웨어 CPU 에뮬레이션을 사용하게 되며, 이 경우 실행 속도가 매우 느려집니다. 자세한 내용은 Android: 에뮬레이터 가속을 참조하십시오.

설정 테스트

필수 구성 요소를 설치하고 구성한 후에는 Qt 설치 패키지에 포함된 예제 프로그램을 실행하여 개발 환경을 테스트할 수 있습니다. 자세한 내용은 ‘모바일 예제’를 참조하십시오.