안드로이드용 Qt 시작하기

아래 동영상은 안드로이드용 Qt 앱 개발을 시작하는 데 도움이 되는 Qt Creator IDE를 포함한 안드로이드용 Qt 툴체인 사용에 대한 초보자 가이드입니다.

안드로이드용 Qt 시작하기의 기초를 배우려면 Qt 아카데미에서 안드로이드용 Qt 시작하기 강좌를 수강하세요.

이 페이지의 나머지 부분에는 더 자세한 시작하기 정보가 있습니다.

Android용 Qt를 다운로드하여 설치하려면 Qt 시작하기 페이지의 지침을 따르세요.

Android 개발 전제 조건

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

• 자바 개발 키트(JDK)
• 다음을 포함하는 안드로이드 명령줄 도구:
  • Android NDK: C++ 코드 빌드용.
  • 안드로이드 SDK 플랫폼 및 안드로이드 SDK 빌드 도구: 특정 API 버전용 안드로이드 앱 빌드용.
  • Android SDK 플랫폼 도구: Android 종속성을 배포하고 관리하기 위한 도구입니다.

종속성을 관리하는 가장 쉬운 방법은 Qt Creator 의 기본 제공 Android 개발 설정을 사용하는 것입니다. Android용 Qt XML을 설치한 후 Qt Creator 을 처음 열면 Android 설정 마법사를 실행할 것인지 묻는 메시지가 표시됩니다. 그러면 Android용 OpenSSL도 설정됩니다.

기존 SDK 위치 사용

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

필수 구성 요소 수동 설치

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

자바 개발 키트(JDK)

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

• Adoptium
• OpenJDK
• Java SE 개발 키트

원하는 JDK를 설치합니다. 설치 관리자가 설치된 JDK의 위치를 가리키는 JAVA_HOME 환경 변수를 설정하지 않은 경우 수동으로 설정할 수 있습니다. 예를 들어 Linux에서:

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

또는 macOS의 경우:

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

안드로이드 SDK 명령줄 도구

운영 체제에 맞는 최신 버전의 Android SDK 명령줄 도구를 다운로드하고 아래에 명시된 대로 적절한 경로에 압축을 풉니다.

Android SDK 경로

Android SDK는 일반적으로 Qt Creator 또는 Android Studio에서 다음 위치에 설치합니다:

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

또는 OS의 패키지 관리자를 사용하세요(예: macOS):

brew install android-commandlinetool

Android SDK 필수 패키지

SDK 플랫폼, 플랫폼 도구 및 빌드 도구를 설치해야 합니다. Qt 6.8의 경우

sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

안드로이드 NDK

Qt 6.8은 NDK 26.1.10909125 을 사용하며, 실행하여 설치할 수 있습니다:

sdkmanager "ndk;26.1.10909125"

예를 들어 macOS의 경우:

에뮬레이터

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

sdkmanager "emulator" "patcher;v4"

플랫폼별 구성

Windows

Windows의 기본 USB 드라이버는 Android 디버그 브리지(ADB) 도구를 사용한 디버깅을 허용하지 않습니다. 추가 Android SDK 패키지에서 제공하는 추가 USB 드라이버를 설치해야 합니다. 다음을 실행하여 설치하세요:

sdkmanager.bat "extras;google;usb_driver"

Linux

Qt Creator 에서 사용할 수 있는 adb 또는 gdb 과 같은 도구를 사용하려면 다음 종속성이 필요합니다:

sudo apt-get install libstdc++6 libncurses5

Android 에뮬레이터를 실행하려면 다음 종속성도 필요합니다:

설정 테스트

이제 Qt 설치와 함께 제공된 예제를 실행하여 개발 설정을 테스트할 수 있습니다. 자세한 내용은 모바일 예제를 참조하세요.

간단한 애플리케이션을 처음부터 개발하려면 Qt Creator: 모바일 애플리케이션 만들기를 참조하세요.