Apple Vision Pro 시작하기

소개

이 가이드는 다음을 위한 애플리케이션 개발을 시작하는 데 도움이 됩니다. visionOS.

시작하기 전에 비전OS용 애플리케이션을 개발하는 방법에는 두 가지가 있다는 점을 이해하는 것이 중요합니다. 첫 번째 방법은 "저몰입" 애플리케이션을 제작하는 방법입니다. 이러한 애플리케이션은 일반 iPad/iOS 애플리케이션처럼 개발하여 visionOS에 배포할 수 있으며, 창 모드에서 실행되며 VR 환경에서 일반 iPad 애플리케이션이 떠 있는 것처럼 보입니다.

참고: 비전OS 전용 애플리케이션도 저몰입 모드로 배치할 수 있으며, 기본적으로 iPad/iOS 애플리케이션과 동일하게 작동합니다.

두 번째 방법을 고몰입 애플리케이션 제작이라고 합니다. 이러한 애플리케이션은 비전OS SDK를 사용하여 개발되며 '전체 화면' 모드에서 실행되므로 QtQuick3D 에서 일부 예외(손의 패스스루 비디오 등)를 제외하고 렌더링을 완전히 제어할 수 있습니다.

참고: visionOS는 이 두 상태 사이를 전환하는 애플리케이션을 지원하지만 QtQuick3D.Xr에서는 지원되지 않습니다.

참고: visionOS용으로 개발하려면 Apple Silicon이 탑재된 Apple 하드웨어가 필요합니다.

참고: visionOS용 Qt 바이너리 빌드는 없습니다. 소스에서 Qt를 빌드해야 합니다. 자세한 내용은 비전OS용 Qt 빌드하기를 참조하십시오.

몰입도가 낮은 애플리케이션 배포하기

iPad/iOS 애플리케이션을 visionOS에 배포하려면 iOS/iPad용 애플리케이션을 빌드하고 배포할 때와 마찬가지로 애플리케이션을 빌드하고 배포합니다.

비전OS용 Qt 빌드하기

비전OS용 Qt를 빌드하려면 Qt Quick3D를 사용한 Qt 소스 코드가 필요합니다. 소스 코드를 얻는 방법에 대한 자세한 내용은 Qt 소스 빌드하기를 참조하십시오.

시뮬레이터 구성 및 빌드

비전OS 시뮬레이터용 Qt를 빌드하기 위한 최소한의 구성 명령은 다음과 같습니다:

[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xrsimulator -submodules qtquick3d

구성이 끝나면 빌드 도구(예: CMake)를 사용하여 빌드할 수 있습니다.

디바이스용 구성 및 빌드

비전OS 디바이스용 Qt를 빌드하기 위한 최소한의 구성 명령은 다음과 같습니다:

[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xros -submodules qtquick3d

구성이 끝나면 빌드 도구를 사용하여 빌드할 수 있습니다.

비전OS 애플리케이션 배포하기

비전OS 애플리케이션을 배포하려면 비전OS SDK 구성 요소가 설치된 Xcode와 선택 사항으로 비전OS 시뮬레이터가 필요합니다. 자세한 내용은 지원되는 버전을 참조하세요.

참고: iOS/iPad 애플리케이션과 달리 비전OS 애플리케이션은 Qt Creator 를 사용하여 배포하지 않고 Xcode를 사용하여 배포합니다.

비전OS용 Qt 예제 중 하나를 빌드하려면 다음 명령을 사용할 수 있습니다:

[QT_VISIONOS_BUILD]/bin/qt-cmake -B [EXAMPLE_BUILD_DIR] -S [EXAMPLE_SOURCE_DIR]

이 명령을 실행하면 Xcode에서 열고 장치에 배포할 수 있는 Xcode 프로젝트가 생성됩니다.

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