iOS/逐课课纲/部门课01_第一次运行与SwiftUI组件万花筒.md

部门课 01：第一次运行与 SwiftUI 组件万花筒

教学目标

• 认识 Xcode、SwiftUI 项目、模拟器和运行按钮分别承担什么作用。
• 完整了解 Xcode、必要组件和 iOS Simulator Runtime 的安装配置过程。
• 能从 Xcode 系统模板创建一个基础 SwiftUI App。
• 能将授课干部提供的“SwiftUI 组件万花筒”Demo 放入项目，并在模拟器中成功 Build/Run。
• 通过一个页面观察 SwiftUI 提供的多种标准组件和样式，为后续课程建立兴趣与方向感。
• 知道可以自由修改文字、图标、颜色或控件初始值，但本节不要求理解全部代码。

教学内容

1. 环境与工具

• 课前提前发送安装说明和资料，鼓励先配置以节约上课时间，但不强制提前完成。
• 课堂完整演示 Xcode 下载、安装、首次启动、必要组件和 iOS Simulator Runtime 的配置过程。
• 不集体等待大型下载。尚未完成安装的学员课后继续配置，尽量在部门课 2 开始前跑通环境。
• 简单认识项目区、代码编辑区、运行目标、运行按钮、模拟器和错误提示位置。

2. 创建第一个项目

• 从 Xcode 系统模板创建最基础的 SwiftUI iOS App。
• 选择一个可用的模拟器作为运行目标，完成第一次 Build/Run。
• 说明 ContentView.swift 是本节主要修改位置，不系统讲解工程结构或 Swift 语法。

3. SwiftUI 组件万花筒 Demo

• Demo 使用单页面、可滚动的结构，不依赖网络、外部素材、数据持久化或多页面导航。
• 页面展示以下标准组件及少量简单变体：
  • Text、Label 和 SF Symbols；
  • 普通按钮与强调按钮；
  • Toggle、Slider、Stepper 等简单控件；
  • TextField 等输入组件；
  • ProgressView、基础图形、颜色和圆角卡片。
• 控件可以具有简单的本地反馈，但本节只观察效果，不提前讲授状态管理、信息流或组件 API。
• 告诉学员这些组件会在后续页面、交互和数据课程中逐步拆开学习，本节只需运行、观察和尝试。

4. 自由尝试

• 鼓励学员自由修改一处文字、SF Symbol、颜色、按钮标题或控件初始值。
• 修改属于自由尝试，不作为最低完成条件。
• 演示撤销和重新运行，避免一次改坏后继续无序修改。
• 本节不教授 Git，作品不需要上传仓库。

课后作业

最低完成标准

• Xcode 能正常启动，且至少有一个可用的 iOS Simulator Runtime。
• 使用 Xcode 系统模板创建项目，放入授课干部提供的组件万花筒 Demo。
• 在模拟器中成功 Build/Run，并显示主要组件。
• 保存项目，供后续继续使用或检查。

建议完成标准

• 自由修改一处文字、SF Symbol、颜色或控件初始值，再运行观察变化。
• 探索感兴趣的组件，不要求修改指定数量或解释全部代码。

尚未完成配置的学员课后继续安装；遇到问题时保留完整错误文字、必要截图和已尝试步骤。本节不要求当堂完成大型下载，不要求上传 GitHub、完成个人页面或完整 App。

验收方式

• 以组件万花筒在模拟器中真实 Build/Run 为基础完成标准，个人修改不作为门槛。
• 无需正式提交作业；可以用运行截图记录结果，也可以在下一次上课时现场运行确认。
• 不要求解释完整 Swift 语法、状态管理或全部组件代码。
• 受设备、系统或下载影响未完成时，记录具体卡点并提供帮助，不把尝试记录等同于已经运行成功。
• 部门课 02 开始前尽量完成环境和 Demo 运行，以便进入 AI 与 Git 工具实践。