SwiftUI极简开发最新章节_李智威著

1.6　项目文件结构详解

最左侧的项目文件导航区域会存放所有与项目相关的文件，包含项目主文件、视图文件、资源库文件、预览配置文件等，开发者也可以自行创建文件和文件夹来完善项目内容。项目文件导航区域如图1-25所示。

图1-25　项目文件导航区域

可以看到视图文件ContentView放置在项目的文件中，通过单击文件，代码编辑区域和实时预览窗口将会自动切换展示内容。

1.6.1　项目主文件

项目文件导航区域中最上面的“Chapter1”文件为项目主文件，所有与项目相关的文件都会放置在此文件的目录层级之下，且该文件还可以用于进行项目的各项配置。项目主文件如图1-26所示。

图1-26　项目主文件

项目主文件分为“PROJECT”和“TARGETS”两部分，PROJECT部分包含配置该项目的基础信息，包括该项目开发和测试的版本、使用的语言，以及使用的第三方库等情况。

由于Apple每年都会更新SwiftUI框架的内容，新推出的UI视图可能需要较高的iOS版本，因此在PROJECT部分可以设置该项目开发的版本，项目开发的版本如图1-27所示。

图1-27　项目开发的版本

其他配置在后续的章节中将会使用，可以先保持默认选项，下面来看TARGETS部分。单个PROJECT下会有多个TARGETS。例如该应用除了iOS端的项目，还包含Widget项目，抑或watchOS端的项目，开发者可以在现有的项目基础上直接创建其他子项目，TARGETS部分就会整合并关联所有的子项目的相关配置。

在当前项目中，可以在TARGETS部分的“Supported Destinations”栏目下配置项目支持的平台，iOS项目默认可以在iOS、iPadOS、macOS（搭载M系列芯片）平台上运行，开发者也可以自行添加或删除项目所支持的平台，项目支持平台如图1-28所示。

图1-28　项目支持平台

与项目支持平台相关联的配置还有“Minimum Deployments”栏目，该栏目用于配置项目运行的最低iOS版本。每年Apple都会对各平台的操作系统进行大版本更新，而每次更新时一些发布较早的产品将不再支持新版本的特性。

当开发iOS项目时，SwiftUI的某些功能特性也会要求最低iOS版本，当该应用正式发布到Apple Store时，也需要制定最低iOS版本。Xcode默认的最低iOS版本为当前最新iOS版本，开发者可以根据项目需求自行选择合适的iOS版本，最低iOS版本如图1-29所示。

图1-29　最低iOS版本

“Identity”栏目用于设置应用的基本信息，包含应用的分类、显示的名称、标识符、版本号等，应用的基本信息如图1-30所示。

图1-30　应用的基本信息

“Deployment Info”栏目可以设置项目运行设备的方向及顶部状态栏配置信息，例如设置在iPhone设备上运行时，只支持用户手持时的纵向布局，而在iPad设备上运行时，支持任意方向布局。

顶部状态栏的配置信息可以根据业务设置为默认，或者只以浅色模式或深色模式固定，抑或在应用运行时不使用顶部状态栏的全屏显示模式。运行设备设置如图1-31所示。

图1-31　运行设备设置

“App Icons and Launch Screen”栏目可以设置应用图标的来源和启动页的文件路径。应用图标的来源和启动页的文件路径设置如图1-32所示。

图1-32　应用图标的来源和启动页的文件路径设置

默认情况下应用图标的来源为资源库Assets中的“AppIcon”文件，对于这个配置项，开发者可以不做调整。启动页默认为空，开发者可以创建一个Storyboard类型的文件，通过绘制的方式完善启动页的UI设计，这部分内容将会在后续的章节中进行更详细的分享。

其他栏目的配置项使用得较少，保持默认即可。TARGETS部分还有一个特别重要的栏目，该栏目可用于权限的配置，在“Info”选项卡下，每当项目中需要调用iOS硬件设备时，都需要在此选项卡下的“Custom macOS Application Target Properties”栏目中配置相关权限。权限配置栏目如图1-33所示。

图1-33　权限配置栏目

1.6.2　项目入口文件

再回到项目主文件Chapter1中，第一个文件是“Chapter1App”，在Chapter1App文件中，可以看到和ContentView文件相似的代码。Chapter1App文件中的代码如图1-34所示。

图1-34　Chapter1App文件中的代码

在Chapter1App中，使用Swift 5.3发布的@main属性包装器修饰整个Chapter1App结构体，即将遵循App协议的Chapter1App结构体中的视图作为App打开时的默认视图。简单来说，当用户打开App时，App默认显示的“首页”就是Chapter1App中配置的视图。

与View协议类似，App协议中也需要一个body属性的视图容器作为入口，而入口遵循Scene协议，通过WindowGroup来显示应用被打开时显示的视图，默认为ContentView视图。

在实际开发过程中，打开App时默认显示的页面可能是“首页”，或者是“登录页”“引导页”。在更复杂的场景下，开发者可以增加判断条件，根据用户是否登录和是否首次进入来呈现不同的页面。

WindowGroup可以更好地处理这种复杂场景，它通过将不同的视图添加到视图组中，自动管理需要显示的视图，甚至通过不同的平台来管理视图的呈现方式。可以按住“option”键并单击WindowGroup，查看Apple官方对WindowGroup的说明，WindowGroup的说明文档如图1-35所示。