플랫폼 참고 사항 - iOS

배포

개발, 빌드, 실행, 디버깅은 모두 macOS에서 Qt Creator 을 사용하여 Qt for iOS 애플리케이션을 개발, 빌드, 실행, 디버깅할 수 있습니다. 툴체인은 Apple의 Xcode에서 제공하며, iOS용 프로젝트에서 qmake 또는 CMake를 실행하면 초기 애플리케이션 설정이 포함된 Xcode 프로젝트 파일(.xcodeproj)도 생성됩니다. Qt Creator 에서는 iOS 플랫폼에 특정한 모든 설정을 관리할 수 있는 인터페이스를 제공하지 않으므로 때때로 Xcode에서 직접 조정해야 하는 경우가 있습니다. 애플리케이션이 올바르게 구성되었는지 확인하는 것은 Apple의 앱 스토어에 게시하기 위해 애플리케이션을 제출하기 전에 특히 중요합니다.

애플리케이션 번들

iOS 애플리케이션은 일반적으로 독립된 애플리케이션 번들로 배포됩니다. 애플리케이션 번들에는 애플리케이션의 실행 파일은 물론 애플리케이션에 필요한 Qt 라이브러리, 플러그인, 번역 및 기타 리소스와 같은 종속성이 포함되어 있습니다.

CMake를 사용하여 애플리케이션을 애플리케이션 번들로 빌드하려면 실행 대상의 MACOSX_BUNDLE 속성을 다음과 같이 설정합니다:

qt_add_executable(app)
if(APPLE)
    set_target_properties(tst_manual_ios_assets PROPERTIES MACOSX_BUNDLE TRUE)
endif()

qmake를 사용하면 번들이 기본값입니다. 비활성화하려면 프로젝트 파일(.pro)에서 CONFIG -= app_bundle 을 설정합니다.

정보 속성 목록 파일

iOS 및 macOS의 정보 속성 목록 파일(Info.plist)은 애플리케이션 번들을 구성하는 데 사용됩니다. 이러한 구성 설정에는 다음이 포함됩니다:

• 애플리케이션 표시 이름 및 식별자
• 필수 장치 기능
• 지원되는 사용자 인터페이스 방향
• 아이콘 및 시작 이미지

자세한 내용은 iOS 개발자 라이브러리의 정보 속성 목록 파일 문서를 참조하세요.

CMake를 사용한 Info.plist

대상의 MACOSX_BUNDLE 속성이 TRUE 로 설정된 경우 CMake는 기본 Info.plist 파일을 생성합니다. 안타깝게도 이 파일은 iOS 프로젝트에 적합하지 않습니다.

대신 프로젝트는 qt_add_executable을 사용하면 iOS 프로젝트에 적합한 기본값으로 Info.plist 파일을 자동으로 생성할 수 있습니다.

사용자 지정 Info.plist 을 지정하려면 프로젝트에서 아래 그림과 같이 MACOSX_BUNDLE_INFO_PLIST 대상 속성을 설정할 수 있습니다. 이렇게 하면 qt_add_executable에서 제공하는 자동 파일 생성이 비활성화되고 대신 프로젝트가 제공한 Info.plist 파일에 대한 CMake의 기본 처리가 사용됩니다.

qt_add_executable(app)
if(IOS)
    set_target_properties(app
        PROPERTIES MACOSX_BUNDLE_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/ios/Info.plist")
endif()

CMake에서 템플릿 대체를 위해 지정할 수 있는 대상 속성 및 변수에 대한 자세한 내용은 CMake MACOSX_BUNDLE_INFO_PLIST 설명서를 참조하십시오.

QMake를 사용한 Info.plist

qmake를 실행하면 적절한 기본값이 포함된 Info.plist 파일이 생성됩니다.

다음에 qmake를 실행할 때 덮어쓰는 것을 방지하려면 생성된 Info.plist를 자신의 복사본으로 바꾸는 것이 좋습니다. .pro 파일에 QMAKE_INFO_PLIST 변수를 사용하여 사용자 지정 정보 속성 목록을 정의할 수 있습니다.

ios {
    QMAKE_INFO_PLIST = ios/Info.plist
}

애플리케이션 자산

Qt 리소스로 번들링할 수 없는 파일의 경우 QMAKE_BUNDLE_DATA qmake 변수를 사용하여 애플리케이션 번들에 복사할 파일 집합을 지정할 수 있습니다. 예를 들어

ios {
    fontFiles.files = $$files(fonts/*.ttf)
    fontFiles.path = fonts
    QMAKE_BUNDLE_DATA += fontFiles
}

CMake를 사용하면 다음과 같은 방법으로 동일한 작업을 수행할 수 있습니다:

qt_add_executable(app)
file(GLOB_RECURSE font_files CONFIGURE_DEPENDS "fonts/*.ttf")
if(IOS AND font_files)
    target_sources(app PRIVATE ${font_files})
    set_source_files_properties(
        ${font_files}
        PROPERTIES MACOSX_PACKAGE_LOCATION Resources/fonts)
endif()

이미지 리소스의 경우, 다른 방법은 Xcode의 에셋 카탈로그를 사용하는 것이며, qmake를 사용하여 다음과 같은 방법으로 추가할 수 있습니다:

ios {
    QMAKE_ASSET_CATALOGS += ios/Assets.xcassets
}

CMake를 사용합니다:

qt_add_executable(app)
set(asset_catalog_path "ios/Assets.xcassets")
target_sources(app PRIVATE "${asset_catalog_path}")
set_source_files_properties(
    ${asset_catalog_path}
    PROPERTIES MACOSX_PACKAGE_LOCATION Resources)

아이콘

Xcode 13부터는 아이콘을 에셋 카탈로그의 아이콘 세트(일반적으로 AppIcon 이라고 함)에 추가해야 합니다. 그러면 Xcode가 Info.plist 파일을 올바른 키와 값으로 업데이트하고 필요한 아이콘 파일을 애플리케이션 번들에 직접 복사합니다.

Xcode 14부터는 1024x1024 픽셀 크기의 이미지 하나만 필요합니다. Xcode가 필요한 모든 아이콘 생성을 처리합니다. 에셋 카탈로그에서 이미지를 수동으로 지정할 수도 있습니다.

지정할 수 있는 아이콘의 자세한 목록은 아이콘 파일에서 확인할 수 있습니다.

파일 이름은 중요하지 않지만 실제 픽셀 크기는 중요합니다. 범용 iOS 애플리케이션을 지원하려면 다음 이미지가 필요합니다:

• AppIcon60x60@2x.png: 120 x 120(iPhone용)
• AppIcon76x76@2x~ipad.png: 152 x 152 (iPad용)
• AppIcon167x167.png: 167x167 (iPad Pro용)
• AppIcon1024x1024.png: 1024 x 1024(App Store용)

임시 배포는 또한 iTunes에서 애플리케이션을 시각화하기 위해 애플리케이션 번들에 다음 파일 이름을 포함해야 합니다:

• iTunesArtwork 512x512
• iTunesArtwork@2x 1024x1024

아이콘을 추가하는 가장 쉬운 방법은 Xcode의 에셋 카탈로그 및 세트 생성에 있는 설명서를 따르는 것입니다.

CMake로 프로젝트를 빌드할 때 다음 Xcode 속성을 지정하여 Xcode에서 앱 아이콘이 생성되도록 해야 합니다.

set_target_properties(app_target_name PROPERTIES
    XCODE_ATTRIBUTE_ASSETCATALOG_COMPILER_APPICON_NAME AppIcon)

아래는 Xcode 14용 Assets.xcassets/AppIcon.appiconset/Contents.json 파일의 예시입니다:

{
  "images" : [
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "20x20"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "20x20"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "29x29"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "29x29"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "38x38"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "38x38"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "40x40"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "40x40"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "60x60"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "60x60"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "64x64"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "3x",
      "size" : "64x64"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "68x68"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "76x76"
    },
    {
      "idiom" : "universal",
      "platform" : "ios",
      "scale" : "2x",
      "size" : "83.5x83.5"
    },
    {
      "filename" : "AppIcon1024x1024.png",
      "idiom" : "universal",
      "platform" : "ios",
      "size" : "1024x1024"
    }
  ],
  "info" : {
    "author" : "xcode",
    "version" : 1
  }
}

실행 화면 및 실행 이미지

실행 화면

모든 iOS 앱은 앱이 실행되는 동안 표시되는 실행 화면을 제공해야 합니다. 시작 화면은 인터페이스 빌더 .xib 파일이며 스토리보드 파일이라고도 합니다. 자세한 내용은 앱의 시작 화면 지정을 참조하세요.

실행 화면 지원은 iOS 9.0에서 도입되었습니다.

qmake와 CMake는 모두 LaunchScreen.storyboard 라는 기본 실행 화면을 생성합니다.

사용자 지정 시작 화면을 지정하려면 애플리케이션 번들에 복사해야 하며 UILaunchStoryboardName 키를 Info.plist 파일에서 시작 화면 이름으로 설정해야 합니다.

Qt는 Qt 6.4부터 CMake로 사용자 정의 시작 화면을, Qt 6.0부터는 qmake로 사용자 정의 시작 화면을 지원합니다.

시작 파일의 이름이 Launch.storyboard 이라고 가정하면 다음과 같이 Info.plist 에 추가할 수 있습니다:

<key>UILaunchStoryboardName</key>
<string>Launch</string>

qmake를 사용하여 실행 화면을 애플리케이션 번들에 복사하려면 프로젝트 .pro 파일에 다음 코드 조각을 사용합니다:

ios {
    QMAKE_IOS_LAUNCH_SCREEN = $$PWD/Launch.storyboard
}

CMake를 사용합니다:

qt_add_executable(app)
if(IOS)
    set_target_properties(app PROPERTIES
        QT_IOS_LAUNCH_SCREEN "${CMAKE_CURRENT_SOURCE_DIR}/Launch.storyboard")
endif()

이미지 실행

시작 화면 대신 시작 이미지(PNG 파일)를 지정할 수도 있습니다.

실행 이미지는 애플리케이션 번들에 복사해야 하며 UILaunchImages 키를 사용하여 Info.plist 파일에 이름을 설정해야 합니다.

다음 이미지를 준비해야 합니다:

• LaunchImage-iOS7-568h@2x.png: 640 x 1136
• LaunchImage-iOS7-Landscape.png: 1024 x 768
• LaunchImage-iOS7-Landscape@2x.png: 2048 x 1536
• LaunchImage-iOS7-Portrait.png: 768 x 1024
• LaunchImage-iOS7-Portrait@2x.png: 1536 x 2048
• LaunchImage-iOS7@2x.png: 640 x 960

이미지는 다음과 같이 Info.plist 에 추가할 수 있습니다:

<key>UILaunchImages</key>
<array>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7</string>
        <key>UILaunchImageOrientation</key>
        <string>Portrait</string>
        <key>UILaunchImageSize</key>
        <string>{320, 568}</string>
    </dict>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7</string>
        <key>UILaunchImageOrientation</key>
        <string>Portrait</string>
        <key>UILaunchImageSize</key>
        <string>{320, 480}</string>
    </dict>
</array>
<key>UILaunchImages~ipad</key>
<array>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7-Landscape</string>
        <key>UILaunchImageOrientation</key>
        <string>Landscape</string>
        <key>UILaunchImageSize</key>
        <string>{768, 1024}</string>
    </dict>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7-Portrait</string>
        <key>UILaunchImageOrientation</key>
        <string>Portrait</string>
        <key>UILaunchImageSize</key>
        <string>{768, 1024}</string>
    </dict>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7</string>
        <key>UILaunchImageOrientation</key>
        <string>Portrait</string>
        <key>UILaunchImageSize</key>
        <string>{320, 568}</string>
    </dict>
    <dict>
        <key>UILaunchImageMinimumOSVersion</key>
        <string>7.0</string>
        <key>UILaunchImageName</key>
        <string>LaunchImage-iOS7</string>
        <key>UILaunchImageOrientation</key>
        <string>Portrait</string>
        <key>UILaunchImageSize</key>
        <string>{320, 480}</string>
    </dict>
</array>

실행 이미지를 qmake를 사용하여 애플리케이션 번들에 복사하려면 프로젝트 .pro 파일에 다음 코드 스니펫을 사용합니다:

ios {
    app_launch_images.files = $$files($$PWD/ios/LaunchImage*.png)
    QMAKE_BUNDLE_DATA += app_launch_images
}

CMake를 사용합니다:

qt_add_executable(app)
file(GLOB_RECURSE launch_images CONFIGURE_DEPENDS "ios/LaunchImage*.png")
if(IOS AND launch_images)
    target_sources(app PRIVATE ${launch_images})
    set_source_files_properties(
        ${launch_images}
        PROPERTIES MACOSX_PACKAGE_LOCATION Resources)
endif()

기본 이미지 선택기

Info.plist 파일에 NSPhotoLibraryUsageDescription 에 대한 항목이 포함되어 있으면 qmake에 기본 이미지 선택기에 액세스할 수 있는 추가 플러그인이 자동으로 포함됩니다.

CMake의 경우 네이티브 이미지 선택기를 qt_import_plugins와 수동으로 연결합니다:

qt_import_plugins(app INCLUDE Qt6::QIosOptionalPlugin_NSPhotoLibraryPlugin)

디렉터리가 QFileDialog 로 설정되어 있는 경우:

QStandardPaths::standardLocations(QStandardPaths::PicturesLocation).last();

또는 QML의 FileDialog 폴더로 설정된 경우:

shortcuts.pictures

로 변경하면 사용자의 사진 앨범에 액세스할 수 있는 기본 이미지 선택기가 표시됩니다.

지원되는 iOS 버전 표현하기

Apple 플랫폼에는 애플리케이션이 지원하는 OS 버전을 표현하는 방법이 내장되어 있어 이전 버전의 플랫폼에서는 충돌을 일으키거나 스택 추적을 표시하는 대신 사용자에게 OS를 업데이트하라는 사용자 친화적인 오류 메시지를 자동으로 표시할 수 있습니다.

특정 범위의 OS 버전에 대한 지원을 표현하는 데 관련된 주요 개념은 다음과 같습니다:

• 배포 대상은 애플리케이션이 지원하는 macOS 또는 iOS의 하드 최소 버전을 지정합니다.
• SDK 버전은 애플리케이션이 지원하는 macOS 또는 iOS의 소프트 최대 버전을 지정합니다.

Apple 플랫폼용 애플리케이션을 개발할 때는 항상 개발 시점에 사용 가능한 최신 버전의 Xcode와 최신 SDK를 사용해야 합니다. iOS와 같은 일부 플랫폼에서는 그렇지 않은 경우 실제로 앱 스토어에서 거부될 수 있습니다. 따라서 SDK 버전은 항상 배포 대상보다 크거나 같아야 합니다.

Apple 플랫폼용 애플리케이션을 개발할 때는 배포 대상을 설정해야 합니다. 컴파일러 및 링커를 포함하되 이에 국한되지 않는 Xcode 툴체인 내의 다양한 빌드 도구에는 모두 이 값을 설정하는 데 사용할 수 있는 플래그가 있습니다. 배포 대상 값을 설정하면 애플리케이션이 최소한 해당 버전에서 작동해야 하며 이전 버전의 OS에서는 작동하지 않음을 명시적으로 선언하는 것입니다. 그런 다음 시스템 API 사용이 선언한 내용과 일치하는지 확인하는 것은 사용자의 몫입니다. 컴파일러는 사용자가 선언한 내용을 알고 있으므로 이를 적용하는 데 도움이 될 수 있습니다.

SDK 버전은 애플리케이션이 SDK로 빌드된 경우 OS가 바이너리의 로드 명령을 확인하고 이전 OS와의 역호환성을 에뮬레이션하기 때문에 최신 OS 버전에서도 해당 SDK의 동작을 계속 사용하는 방식으로 애플리케이션이 호환되는 OS의 소프트 최대 버전으로 간주됩니다. 예를 들어 애플리케이션이 macOS 10.12 SDK로 빌드된 경우 10.13 이상에서도 10.12 동작을 계속 사용합니다.

그러나 Mach-O 바이너리는 본질적으로 이전 버전과 호환됩니다. 예를 들어, iOS 9 SDK로 빌드된 애플리케이션은 iOS 10에서도 정상적으로 실행되지만, 해당 애플리케이션이 최신 SDK로 다시 컴파일될 때까지 새 릴리스에서 특정 기능에 변경된 동작이 적용되지 않을 수 있습니다.

최소 OS 버전은 Mach-O 바이너리에 포함되는 컴파일러 및 링커 플래그를 통해 시스템에 표시할 수 있습니다. 또한 애플리케이션의 앱 번들에 LSMinimumSystemVersion 키가 설정되어 있어야 합니다. 이 값은 컴파일러와 링커에 전달된 값과 같아야 합니다. macOS에서 이 값을 사용하면 OS가 충돌 대화 상자 대신 애플리케이션에 최신 버전의 OS가 필요하다는 사용자 친화적인 오류 대화 상자를 표시할 수 있기 때문입니다. 컴파일러 및 링커 플래그에는 아무런 권한이 없는 LSMinimumSystemVersion 키는 앱 스토어에서 필요한 OS 버전을 표시하는 데 사용하는 키이기도 합니다.

대부분의 경우 Qt 애플리케이션은 문제 없이 작동합니다. 예를 들어, qmake에서 Qt mkspec은 QMAKE_IOS_DEPLOYMENT_TARGET 또는 QMAKE_MACOSX_DEPLOYMENT_TARGET을 Qt 자체에서 지원하는 최소 버전으로 설정합니다. 마찬가지로 Qbs에서 Qt 모듈은 cpp.minimumIosVersion, cpp.minimumMacosVersion, cpp.minimumTvosVersion, 또는 cpp.minimumWatchosVersion 을 Qt 자체가 지원하는 최소 버전으로 설정합니다.

그러나 직접 목표 버전을 수동으로 설정할 때는 주의해야 합니다. Qt에서 요구하는 것보다 높은 값으로 설정하고 직접 Info.plist 파일을 제공하면 OS에서 LSMinimumSystemVersion 값을 권한 있는 값으로 사용하므로 배포 대상 값과 일치하는 LSMinimumSystemVersion 항목을 Info.plist 에 추가해야 합니다.

Qt에서 요구하는 것보다 낮은 배포 대상 값을 지정하면 Qt가 지원하는 것보다 오래된 버전에서 실행될 때 애플리케이션이 Qt 라이브러리 어딘가에서 충돌할 가능성이 거의 확실합니다. 따라서 실제 빌드 시스템 코드에 실제로 필요한 최소 OS 버전이 반영되어 있는지 확인하십시오.

Apple App Store에 퍼블리싱하기

응용 프로그램 제출하기에서 설명한 대로 iOS용 Qt 애플리케이션을 App Store에 게시할 준비가 되었는지 확인할 수 있습니다. 애플리케이션을 제출하려면 Xcode 또는 애플리케이션 로더(Xcode와 함께 설치됨)를 사용할 수 있습니다. Qt Creator 은 Xcode 프로젝트 구성의 모든 설정을 관리할 수 있는 인터페이스를 제공하지 않습니다.

애플리케이션은 지원 대상인 iOS 버전 및 기기에서 테스트해야 합니다. Qt 애플리케이션의 최소 배포 대상은 Qt 버전에 따라 다릅니다. 자세한 내용은 지원되는 구성을 참조하십시오.

실제 게시 프로세스에는 배포 인증서 및 프로비저닝 프로필을 만들고, 애플리케이션의 서명된 아카이브를 만들고, 일련의 유효성 검사 테스트를 실행하는 과정이 포함됩니다.

자세한 내용은 iOS 개발자 라이브러리에서 앱 배포 가이드를 참조하세요.

심볼 가시성 경고

C++ 라이브러리 연결의 맥락에서 함수와 객체를 심볼이라고 합니다. 심볼은 default 또는 hidden 가시성을 가질 수 있습니다.

성능상의 이유로 Qt와 다른 많은 라이브러리는 기본적으로 hidden 가시성을 사용하여 소스를 컴파일하고, 사용자 프로젝트에서 사용하려는 경우에만 default 가시성을 가진 심볼을 표시합니다.

안타깝게도 한 라이브러리가 hidden 가시성으로 컴파일되고 사용자 프로젝트 애플리케이션이나 라이브러리가 default 가시성으로 컴파일되는 경우 Apple 링커가 경고를 표시할 수 있습니다.

프로젝트 개발자가 경고를 무효화하려면 프로젝트 코드도 hidden 가시성으로 빌드해야 합니다.

CMake에서는 CMakeLists.txt 에 다음 코드를 추가하여 이 작업을 수행할 수 있습니다:

set(CMAKE_CXX_VISIBILITY_PRESET hidden)

qmake에서는 .pro 파일에 다음 코드를 추가하면 됩니다:

CONFIG+=hide_symbols

프로젝트에서 라이브러리를 빌드하는 경우, 라이브러리에서 다른 라이브러리나 애플리케이션에서 사용하려는 심볼은 default 가시성을 명시적으로 표시해야 합니다. 예를 들어, 이러한 함수나 클래스에 Q_DECL_EXPORT 을 사용하여 주석을 달면 됩니다.

CMake의 제품 아카이브 문제

CMake의 문제로 인해 iOS 애플리케이션으로 제품 아카이브를 만들려고 하면 실패할 수 있습니다.

이 문제는 Xcode에서 제품 -> 아카이브 메뉴 항목을 사용하거나 xcodebuild -archivePath 을 사용하여 명령줄에서 아카이브를 생성하려고 할 때 모두 발생할 수 있습니다.

오류 메시지는 정의되지 않은 기호 또는 존재하지 않는 파일 경로를 참조할 수 있습니다.

이 문제를 해결하려면 아카이브를 생성하기 전에 프로젝트의 Release 버전을 빌드하세요.

CMake Xcode 프로젝트에서 생성한 xcarchive에 dSYM 번들이 누락됨

Xcode의 버그 및 특정 CMake 제한으로 인해 CMake로 생성된 Xcode 프로젝트는 Xcode의 아카이브 작업 중에 애플리케이션의 dSYM 번들을 xcarchive 에 포함시키지 못합니다.

Qt는 dSYM 번들이 xcarchive 에 포함되도록 하는 해결 방법을 제공하지만, 이 방법에는 단점이 있습니다. 즉, 다음 CMake 기능이 올바르게 작동하지 않습니다:

• $<TARGET_FILE:app> 생성기 표현식이 앱 바이너리로 연결되지 않는 잘못된 경로로 확장될 수 있습니다.
• CMAKE_RUNTIME_OUTPUT_DIRECTORY 변수 및 관련 RUNTIME_OUTPUT_DIRECTORY 대상 속성이 설정되어 있어도 무시됩니다.
• 기타 알려지지 않은 문제

위의 문제를 완화하려면 다음과 같이 할 수 있습니다:

• 프로젝트 개발 중이 아닌 xcarchive 을 만들려고 할 때만 해결 방법을 활성화합니다.
• 실행 파일과 라이브러리를 add_subdirectory 호출이 아닌 루트 프로젝트 디렉토리에만 추가하세요.

해결 방법을 사용하려면 다음 옵션을 사용하여 프로젝트를 구성합니다:

cmake . -DQT_USE_RISKY_DSYM_ARCHIVING_WORKAROUND=ON

또는 qt_add_executable 또는 qt_add_library 호출 전에 프로젝트에서 변수를 설정합니다:

set(QT_USE_RISKY_DSYM_ARCHIVING_WORKAROUND ON)

...

qt_add_executable(app)