이 페이지에서

Android용 Qt

Qt에서는 Android용 애플리케이션을 개발하는 두 가지 방법을 제공합니다:

Qt for Android

Qt for Android™ 를 사용하면 Android 기기용 Qt 애플리케이션을 개발할 수 있으며, 광범위한 기능과 사용 사례를 지원합니다.

Qt Core Qt GUI Qt Quick Qt Widgets

Qt 애플리케이션은 이벤트 전파, 라이프사이클 관리, 렌더링 등을 포함하여 네이티브 Android(Java/Kotlin) 측과 Qt(C++) 측 간의 상호작용을 처리함으로써 Android 기기에서 실행됩니다.

안드로이드 에뮬레이터에서 실행되는 Qt for Android 데모 애플리케이션

주요 기능 및 특징

Qt for Android의 주요 기능은 다음과 같습니다.

  • 크로스 플랫폼 개발. Android용 Qt 애플리케이션은 일반적으로 QML 애플리케이션이며, 그 백엔드 코드는 C++로 작성됩니다. 최소한의 수정만 거치거나 아예 수정 없이도 애플리케이션 코드를 한 번 작성하여 여러 플랫폼에 배포할 수 있습니다.
  • 네이티브 성능. Qt 런타임은 Android용으로 컴파일되므로 네이티브 수준의 성능을 제공하며, Android 기기의 네이티브 기능에 접근할 수 있습니다.
  • 풍부한 UI 구성 요소. 반응형 인터페이스를 위한 Qt의 광범위한 Qt Quick 컴포넌트를 활용하여 반응성이 뛰어난 인터페이스를 구현할 수 있습니다.

    또한 Qt의 방대한 모듈 생태계를 활용하여 애플리케이션에 기능을 추가할 수도 있습니다:

  • C++ 통합. 기존 C++ 라이브러리에 의존하거나 고성능 네이티브 코드가 필요한 애플리케이션에 이상적입니다.
  • 성숙하고 일관된 API. Qt의 안정적인 모듈은 플랫폼의 분열을 줄이고, 플랫폼 간 기능의 균일성을 유지하기 쉽게 해줍니다.

Android용 Qt 살펴보기

Qt for Android를 활용한 개발에 대해 알아보려면 다음 주요 주제를 확인해 보세요:

안드로이드 프래그먼트

Qt for Android 애플리케이션에서는 Android 프래그먼트를 사용할 수 없습니다. 하지만 Qt는 QML을 통해 자체적인 모듈형 컴포넌트와 뷰를 제공합니다. 하나의 QML 뷰에 여러 컴포넌트를 결합할 수 있습니다. 자세한 내용은 QML 문서를 참조하십시오.

Qt Quick for Android를 Android 애플리케이션에 통합하는 경우, Android 프래그먼트 내에서 QtQuickView API를 사용할 수 있습니다.

Qt Quick for Android

Android용 Qt Quick 를 사용하면 네이티브 Android 애플리케이션 UI에 Qt Quick 컴포넌트를 뷰( View)로 추가할 수 있습니다. 이는 전체 애플리케이션을 Qt로 재작성하지 않고도 복잡한 UI 요소, 애니메이션 또는 3D 그래픽을 앱의 특정 부분에 통합하는 데 특히 유용합니다. 전체 UI를 Qt로 대체하는 Android용 Qt와 달리, Android용 Qt Quick 는 기존의 네이티브 Android UI를 보완합니다.

Qt Quick for Android를 사용하면 다음과 같은 컴포넌트를 통해 네이티브 애플리케이션의 UI를 확장할 수 있습니다:

Qt Quick Android용 버전에는 Google의 Android Studio용 플러그인이 포함되어 있습니다. IntelliJ 마켓플레이스에서 찾아보실 수 있습니다.

지원되는 구성

이 Qt 릴리스에서는 다음 구성이 지원됩니다:

섹션설명
배포판Android 9 (API 28) ~ 16 (API 36)
아키텍처arm64-v8a, x86_64, x86 및 armeabi-v7a
컴파일러Clang 17.0.2 (NDK r27c 또는 27.2.12479018)

참고: 심볼 누락 오류를 방지하기 위해 Qt 앱은 공식 Qt for Android 라이브러리 빌드에 사용된 것과 동일한 NDK 버전을 사용하는것이 권장됩니다 . 여러 NDK를 지원하는 릴리스의 경우, Qt 빌드에는 지원되는 최신 NDK가 사용됩니다.

JDKJDK 21
GradleGradle 9.5.1 및 AGP 9.2.1
패키지다중 ABI APK, AAB및 AAR

참고: 멀티 ABI 빌드는 CMake를 사용할 때만 사용할 수 있습니다. 자세한 내용은 CMake Android 멀티 ABI를 참조하세요.

지원되는 Android 버전에 대한 자세한 내용은 Qt for Android 지원 버전 선택 지침을 참조하십시오.

© 2026 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.