이 페이지에서

Apple Vision Pro 시작하기

소개

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

시작하기 전에, visionOS용 애플리케이션을 개발하는 방법에는 두 가지가 있다는 점을 이해하는 것이 중요합니다. 이 가이드에서 다룰 첫 번째 방법은 “낮은 몰입도” 애플리케이션을 생성하는 것입니다. 이러한 애플리케이션은 일반적인 iPad/iOS 애플리케이션과 동일하게 개발하여 visionOS에 배포할 수 있으며, 창 모드로 실행되어 VR 환경 속에 떠 있는 일반 iPad 애플리케이션처럼 보입니다.

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

두 번째 방법은 “고몰입형” 애플리케이션을 제작하는 것으로 지칭하겠습니다. 이러한 애플리케이션은 visionOS SDK를 사용하여 개발되며 “전체 화면” 모드로 실행됩니다. 즉, QtQuick3D 가 렌더링을 완전히 제어하지만, 일부 예외(예: 손의 패스스루 비디오)가 있습니다.

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

참고: visionOS용 애플리케이션을개발하려면 Apple Silicon이 탑재된 Apple 하드웨어가 필요합니다.

참고: visionOS용 Qt 바이너리 빌드는제공되지 않습니다 . 소스 코드에서 Qt를 빌드해야 합니다. 자세한 내용은 visionOS용 Qt 빌드하기를 참조하십시오.

저몰입도 애플리케이션 배포

iPad/iOS 애플리케이션을 visionOS에 배포하려면, iOS/iPad용과 동일한 방식으로 애플리케이션을 빌드하고 배포하십시오.

visionOS용 Qt 빌드

visionOS용 Qt를 빌드하려면 Qt Quick3D가 포함된 Qt 소스 코드가 필요합니다. 소스 코드를 구하는 방법에 대한 자세한 내용은 ‘Qt 소스 빌드’를 참조하십시오.

시뮬레이터용 구성 및 빌드

visionOS 시뮬레이터용 Qt를 빌드하기 위한 최소한의 configure 명령어는 다음과 같습니다.

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

구성 후에는 CMake와 같은 빌드 도구를 사용하여 빌드할 수 있습니다.

기기용 구성 및 빌드

visionOS 기기용 Qt를 빌드하기 위한 최소한의 configure 명령어는 다음과 같습니다:

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

설정이 완료된 후에는 사용 중인 빌드 도구(예: CMake)를 사용하여 빌드할 수 있습니다.

visionOS 애플리케이션 배포

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

참고: iOS/iPad 애플리케이션과 달리 , visionOS 애플리케이션은 Qt Creator 을 통해 배포되지 않고 Xcode를 통해 배포됩니다.

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

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

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

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