이 페이지에서

안드로이드 개발 환경 설정

Qt Creator 는 필요한 모든 패키지와 도구를 자동으로 설치하고 디버거, 툴체인 및 키트를 생성하여 안드로이드용 Qt 개발 환경을 설정할 수 있는 기능을 제공합니다.

Qt Creator 을 이용하세요:

  • Android SDK 명령줄 도구를 다운로드하여 압축을 풉니다.
  • NDK, 빌드 툴, 플랫폼 툴과 같은 필수 패키지를 설치하거나 업데이트합니다.

Android용 개발 환경을 설정하려면 다음과 같이 하세요:

  1. 환경설정 > SDKs > Android 으로 이동합니다.

    SDK 환경 설정의 Android 탭

  2. JDK location 에서 JDK 경로를 설정합니다. Qt Creator 에서 JDK 설치를 확인하고 오류를 보고합니다.

    기본적으로 Qt Creator 은 지원되는 Adoptium OpenJDK 또는 OpenJDK 설치를 찾으려고 시도합니다. 찾을 수 없는 경우 경로를 수동으로 설정해야 합니다. 지원되는 JDK를 설치하지 않은 경우 시스템 브라우저에서 JDK 다운로드 URL을 엽니다. 을 선택하여 기본 브라우저에서 JDK 다운로드 웹 페이지를 엽니다.

    참고: 32비트 JDK를 사용하면 cmdline-tools 에서 문제가 발생할 수 있으며 일부 패키지가 목록에 표시되지 않을 수 있으므로 64비트 JDK를 사용하세요.

  3. Android SDK location 에서 Android SDK 명령줄 도구를 설치할 폴더의 경로를 설정합니다.
  4. Set Up SDK 을 선택하면 Android SDK 명령줄 도구가 선택한 경로에 자동으로 다운로드되고 압축이 풀립니다.

    SDK 관리자가 필요한 도구가 있는지 확인합니다. 더 많은 패키지 또는 업데이트가 필요한 경우 SDK 관리자는 적절한 패키지를 추가하거나 제거하도록 제안합니다. 조치를 취하기 전에 변경 사항을 수락할지 묻는 메시지가 표시됩니다. 또한 필요에 따라 Google 라이선스를 수락할지 묻는 메시지가 표시됩니다.

  5. Android NDK list 설치된 NDK 버전이 나열됩니다. SDK 관리자가 잠긴 항목을 설치했습니다. Android SDK Manager 대화 상자에서만 수정할 수 있습니다. 자세한 내용은 Android NDK 패키지 관리를 참조하세요.
  6. Automatically create kits for Android tool chains 을 선택하면 필요한 키트가 자동으로 생성됩니다. Qt Creator 적합한 Qt 버전을 찾을 수 없는 경우 경고가 표시됩니다.
  7. 선택 사항으로 Android OpenSSL Settings 그룹에서 미리 빌드된 OpenSSL 라이브러리의 경로를 설정합니다.

    OpenSSL 지원이 필요한 Qt 애플리케이션의 경우 외부 라이브러리 추가하기의 지침에 따라 프로젝트에 Android OpenSSL 지원을 추가합니다.

  8. Download OpenSSL 을 선택하여 선택한 경로로 OpenSSL 리포지토리를 다운로드합니다. 자동 다운로드에 실패하면 수동 다운로드를 위한 다운로드 웹 페이지가 열립니다.

수동 설정

자동 설정이 요구 사항을 충족하지 않는 경우 Android SDK 명령줄 도구를 다운로드하여 설치한 다음 필요한 NDK, 도구 및 패키지를 설치하거나 업데이트합니다. 자세한 내용은 Android용 Qt 시작하기를 참조하십시오.

안드로이드 툴체인 설정 보기

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.json에서 확인할 수 있습니다.

참고: Qt 6.5 이상의 경우, Qt Creatormodules/Core.json 에서 Qt 빌드에 사용된 NDK 버전을 읽어와 sdk_definitions.json 의 버전 대신 사용합니다.

방법: 안드로이드용 개발, 안드로이드용 개발키트도참조하십시오 .

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.