创建您的第一个visionOS应用程序

使用SwiftUI构建一个新的visionOS应用程序，并添加特定于平台的功能。

概述

如果您是visionOS的新手，请从一个新的Xcode项目开始，了解平台功能，并熟悉visionOS的内容和技术。当您为visionOS构建应用程序时，SwiftUI是一个不错的选择，因为它可以让您完全访问visionOS功能。虽然您也可以使用UIKit构建应用程序的部分内容，但您需要使用SwiftUI来获得许多平台独有的功能。

笔记

开发visionOS需要搭载苹果芯片的Mac。

在任何SwiftUI应用程序中，您可以使用场景将内容放在屏幕上。场景包含要在屏幕上显示的视图和控件。场景还定义了这些视图和控件在屏幕上出现时的外观。在visionOS中，您可以在同一场景中包含2D和3D视图，您可以在窗口中或作为该人周围环境的一部分呈现这些视图。

从一个新的Xcode项目开始，并添加功能来熟悉visionOS内容和技术。在模拟器中运行您的应用程序，以验证您的内容看起来与您预期的一样，并在设备上运行它，以查看您的3D内容栩栩如生。

围绕一个或多个场景组织您的内容，这些场景管理您的应用程序的界面。每个场景都包含您想要显示的视图和控件，场景类型决定了您的内容是采用2D还是3D外观。SwiftUI专门为visionOS添加了3D场景类型，还为所有场景类型添加了3D元素和布局选项。

创建您的Xcode项目

通过选择“文件”>“新建”>“项目”在Xcode中创建一个新项目。导航到模板选择器的visionOS部分，然后选择应用程序模板。出现提示时，为您的项目指定名称和其他选项。

创建新的visionOS应用程序时，您可以从配置对话框中配置应用程序的初始场景类型。要在初始场景中主要显示2D内容，请选择windows作为初始场景类型。对于主要3D内容，请选择一个volume。您还可以添加一个ImmersiveSpace，将您的内容放置在该人的周围。

当您想要创建3D资产或场景以从应用程序中显示时，请包含一个Reality Composer Pro项目文件。使用此项目文件从原始形状和现有USDZ资产构建内容。您还可以使用它为您的内容构建和测试自定义RealityKit动画和行为。

修改现有窗口

使用标准的SwiftUI视图构建您的初始界面。视图为您的界面提供基本内容，您可以使用SwiftUI修饰符自定义它们的外观和行为。例如，.background修饰符在内容后面添加了部分透明的色调：

处理你视图中的事件

许多SwiftUI视图自动处理交互——您所做的只是提供代码在交互发生时运行。您还可以将SwiftUI手势识别器添加到视图中，以处理点击、长按、拖动、旋转和缩放手势。系统会自动将以下类型的输入映射到您的SwiftUI事件处理代码：

间接输入。这个人的眼睛表示互动的对象。为了开始互动，这个人用一只手或双手将拇指和食指一起触摸。额外的手指和手部动作定义了手势类型。

直接输入。当一个人的手指占据与屏幕上项目相同的空间时，系统会报告交互。额外的手指和手部动作定义了手势类型。

键盘输入。人们可以使用连接的鼠标、触控板或键盘与项目进行交互、触发菜单命令和执行手势。

构建并运行您的应用程序

在模拟器中构建并运行您的应用程序，看看它的外观。visionOS模拟器有一个虚拟背景作为应用程序内容的背景。使用键盘和鼠标或触控板在环境中导航并与您的应用程序进行交互。

点击并拖动应用程序内容下方的窗口栏，在环境中重新定位窗口。将指针移到窗口栏旁边的圆圈上，以显示窗口的关闭按钮。将光标移动到窗口的一个角落，将窗口栏变成调整大小控件。

笔记

应用程序不控制窗口在空间中的放置。系统将每个窗口放在初始位置，并根据与应用程序的进一步交互更新该位置。