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 的最小配置命令如下所示：
[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xrsimulator -submodules qtquick3d配置完成后，您可以使用自己的构建工具（例如 CMake）进行构建。
针对设备的配置和构建
用于为 visionOS 设备构建 Qt 的最简配置命令如下所示：
[QT_SOURCE_DIR]/configure -qt-host-path [PATH_TO_QT_HOST_BUILD] -platform macx-visionos-clang -sdk xros -submodules qtquick3d配置完成后，您可以使用您的构建工具进行构建。
部署 visionOS 应用程序
要部署 visionOS 应用程序，您需要安装了 visionOS SDK 组件的 Xcode，并可选安装 visionOS 模拟器。有关更多信息，请参阅支持的版本。
注意：与 iOS/iPad 应用程序不同 ，visionOS 应用程序不通过Qt Creator 进行部署，而是通过 Xcode 进行部署。
要构建 Qt 的 visionOS 示例之一，您可以使用以下命令：
[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.
