Apple Vision Pro 入门
简介
本指南将帮助您开始为 visionOS™.
在开始之前，必须了解为 visionOS 开发应用程序有两种方法。第一种方法是制作 "低浸入式 "应用程序。这些应用程序可以像任何普通的 iPad/iOS 应用程序一样开发，然后部署到 visionOS 上，这些应用程序以窗口模式运行，看起来就像一个普通的 iPad 应用程序漂浮在 VR 环境中。
注： 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 部署的。
要为 visionOS 构建一个 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.
