Android 개발 환경 설정
Qt Creator 필요한 모든 패키지와 도구를 자동으로 설치하고, 디버거, 툴체인 및 키트를 생성하여 Android용 Qt 개발 환경을 설정해 줍니다.
Qt Creator 를 사용하여 다음 작업을 수행할 수 있습니다:
- Android SDK 명령줄 도구를 다운로드하고 압축을 풉니다.
- NDK, 빌드 도구, 플랫폼 도구와 같은 필수 패키지를 설치하거나 업데이트합니다.
Android 개발 환경을 설정하려면:
- Preferences > SDKs > Android 로 이동합니다.

- JDK location 에서 JDK 경로를 설정하십시오. Qt Creator 는 JDK 설치 상태를 확인하고 오류를 보고합니다.
기본적으로 Qt Creator 는 지원되는 Adoptium OpenJDK 또는 OpenJDK 설치본을 찾으려고 시도합니다. 찾을 수 없는 경우 경로를 수동으로 설정해야 합니다. 지원되는 JDK를 설치하지 않은 경우,
를 선택하여 기본 브라우저에서 JDK 다운로드 웹 페이지를 열 수 있습니다.참고: 32비트 JDK를 사용하면
cmdline-tools에서 문제가 발생하거나 일부 패키지가 목록에 표시되지 않을 수 있으므로 64비트 JDK를사용하십시오 . - Android SDK location 에서 Android SDK 명령줄 도구를 설치할 폴더의 경로를 설정하십시오.
- ' Set Up SDK '를 선택하여 Android SDK 명령줄 도구를 자동으로 다운로드하고 선택한 경로에 압축을 풉니다.
SDK 관리자는 필요한 도구가 설치되어 있는지 확인합니다. 추가 패키지나 업데이트가 필요한 경우, SDK 관리자는 해당 패키지를 추가하거나 제거할 것을 제안합니다. 작업을 진행하기 전에 변경 사항을 수락할지 묻는 메시지가 표시됩니다. 또한, 필요한 경우 Google 라이선스 동의 여부를 묻는 메시지가 표시됩니다.
- Android NDK list 설치된 NDK 버전이 나열됩니다. SDK 관리자가 잠긴 항목을 설치했습니다. 이러한 항목은 ‘ Android SDK Manager ’ 대화 상자에서만 수정할 수 있습니다. 자세한 내용은 ‘Android NDK 패키지 관리’를 참조하십시오.
- ' Automatically create kits for Android tool chains '를 선택하면 필요한 키트가 자동으로 생성됩니다. 적합한 Qt 버전을 찾을 수 없는 경우, ' Qt Creator '에서 경고 메시지가 표시됩니다.
- 선택 사항으로, ‘ Android OpenSSL Settings ’ 그룹에서 미리 빌드된 OpenSSL 라이브러리의 경로를 설정할 수 있습니다.
OpenSSL 지원이 필요한 Qt 애플리케이션의 경우, 'Android 패키지에 외부 라이브러리 추가'에 설명된 대로 프로젝트에 Android OpenSSL 지원을 추가하십시오.
- ' Download OpenSSL '을 선택하여 OpenSSL 저장소를 선택한 경로로 다운로드하십시오. 자동 다운로드에 실패하면 수동 다운로드를 위한 웹 페이지가 열립니다.
수동 설정
자동 설정이 요구 사항을 충족하지 않는 경우, Android SDK 명령줄 도구를 다운로드하여 설치한 다음, 필요한 NDK, 도구 및 패키지를 설치하거나 업데이트하십시오. 자세한 내용은 'Qt for Android 시작하기'를 참조하십시오.
Android 툴체인 설정 보기
JSON 구성 파일은 Android SDK 명령줄 도구 다운로드 URL, 필수 패키지 목록 및 각 Qt 버전에 적합한 NDK를 정의합니다. 이 파일은 Qt Creator 리소스 폴더에 있습니다:
# Linux and macOS ~/.config/QtProject/qtcreator/android/sdk_definitions.json # Windows C:\Users\Username\AppData\Local\QtProject\qtcreator\android\sdk_definitions.json
예를 들어, SDK 구성 파일은 Qt 6.3, Qt 6.2 및 Qt 5.15.9~5.15.20과 함께 사용할 NDK 버전을 22.1.7171670으로 설정합니다:
"specific_qt_versions": [ { "versions": ["6.3", "6.2", "5.15.[9-20]"], "sdk_essential_packages": ["build-tools;31.0.0", "ndk;22.1.7171670"] }, ]
Android SDK 및 NDK 변경 사항을 반영한 최신 버전의 구성 파일은 sdk_definitions.jsonGit에서 확인할 수 있습니다.
참고: Qt 6.5 이상의경우 , ` Qt Creator `는 ` modules/Core.json `에서 Qt 빌드에 사용된 NDK 버전을 읽어와 ` sdk_definitions.json`에 지정된 버전 대신 이를 사용합니다.
‘Android용 개발 방법’, ‘Android용 개발’ 및 ‘키트 관리’항목도 참조하십시오 .
Copyright © The Qt Company Ltd. and other contributors. 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.