QT_ANDROID_패키지_이름

앱의 패키지 이름.

이 속성은 Qt 6.8에서 도입되었습니다.

참고: 이 속성은 Android 플랫폼을 대상으로 하는 경우에만 사용됩니다.

앱의 패키지 이름을 지정합니다. 이는 일반적으로 앱을 식별하기 위해 기기나 Play 스토어에서 사용되는, 점(.)으로 구분된 고유한 앱 이름입니다. 예를 들어, "org.qtproject.gallery"와 같습니다.

set_target_properties(${target} PROPERTIES
    QT_ANDROID_PACKAGE_NAME "org.qtproject.gallery"
)

이 속성으로 설정된 패키지 이름은 AndroidManifest.xml 대신 namespace 속성으로 build.gradle 파일에 전달됩니다. 후자는 Android Gradle Plugin 7.4부터 사용이 중단되었기 때문입니다.

패키지 이름에서는 일부 단어나 문자를 허용되지 않는 것으로 간주하며, 빌드 과정에서 이러한 이름이 발견되면 제거됩니다. 밑줄(_)은 허용되지 않는 문자를 대체하거나 허용되지 않는 단어 뒤에 추가됩니다.

  • 허용되는 문자: 영숫자, 밑줄 또는 점 [a-zA-Z0-9_.].
  • 허용되지 않는 단어: abstract, continue, for, new, switch, assert, default, if, package, synchronized, boolean, do, goto, private, this, break, double, implements, protected, throw, byte, else, import, public, throws, case, enum, instanceof, return, transient, catch, extends, int, short, try, char, final, interface, static, void, class, finally, long, strictfp, volatile, const, float, native, super, while.

Android용 Qt 앱의 기본 패키지 이름은 org.qtproject.example.<target_name> 입니다.

참고: build.gradle 에서 패키지 이름을 수동으로설정하는 경우( namespace 속성을 통해), AndroidManifest.xml 에서 설정된 값( package 속성을 통해)보다 우선하며, 후자는 이 속성보다 우선합니다.

자세한 내용은 Android의 앱 모듈 구성을 참조하세요.

qt_android_generate_deployment_settings()도 참조하십시오 .

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