qt_android_package_name

앱의 패키지 이름입니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

앱의 패키지 이름을 지정합니다. 일반적으로 점으로 구분된 앱의 고유한 이름으로, 기기나 Play 스토어에서 앱을 식별하는 데 사용됩니다. 예: "org.qtproject.gallery".

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

이 속성으로 설정된 패키지 이름은 AndroidManifest.xml 대신 namespace 속성으로 build.gradle 파일에 전달됩니다(후자는 Android Gradle 플러그인 7.4부터 더 이상 사용되지 않음).

패키지 이름에서 일부 단어나 문자를 불법으로 간주하고 이러한 이름이 발견되면 빌드에서 해당 이름을 정리합니다. 밑줄(_)은 불법 문자를 대체하거나 불법 단어에 추가됩니다.

• 허용되는 문자: 영숫자, 밑줄 또는 점[a-zA-Z0-9_.]
• 허용되지 않는 단어: 추상, 계속, for, new, switch, assert, default, if, package, 동기화, 부울, 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, 인터페이스, static, void, class, finally, long, strictfp, 휘발성, const, float, native, super, while입니다.

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

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