任务二 初始工程导入与运行
一、任务目标
完成开发环境准备，使用 Android Studio 克隆并导入初始工程，完成 Gradle 同步；认识工程中的主要文件、预置资源和基础类，并在 Android 设备上运行，确认初始页面能够显示。
二、准备开发环境
参照项目一“音乐播放器”单元一的任务二“开发环境准备”，完成 Android Studio、Android SDK 和 Git 的安装与配置，以及 Android 设备连接验证。已经完成环境准备的，确认环境可用后进入下一步骤。
三、克隆初始工程
初始工程保存在 Git 仓库中，仓库地址和初始工程分支如下。
初始工程仓库地址：
https://cnb.cool/sziit-coding/android-coding/project-practice/food初始工程分支： textbook-starter
克隆是将远程仓库及其版本记录复制到本地的操作。启动 Android Studio，在欢迎页点击“克隆仓库”，打开克隆窗口。
按图中的①、②、③完成以下操作：
- 在“版本控制”中选择 Git，在 URL 输入框中填写上方完整仓库地址（①）。
- 在“目录”中设置工程的本地保存位置（②）。选择尚未存放其他工程的目录，避免与已有工程混用。
- 核对仓库地址和保存目录，点击“克隆”（③），等待工程下载完成。
四、导入工程并完成同步
克隆完成后，Android Studio 会自动打开工程。若未自动打开，在欢迎页点击 Open，选择包含 settings.gradle.kts 的工程根目录。该文件声明项目包含的模块，因此应打开工程根目录，而非其中的 app 目录。
工程打开后，Android Studio 开始 Gradle 同步。Gradle 是工程的构建工具；同步会读取构建配置、解析依赖，使 Android Studio 识别工程模块及其所需资源。等待同步完成后，核对以下结果：
| 检查对象 | 应观察到的结果 |
|---|---|
| 工程视图 | 能够看到 app 模块及其 src/main 目录 |
| Gradle 同步 | 同步结果显示成功，没有依赖解析或构建脚本错误 |
| Android SDK | app/build.gradle.kts 中 compileSdk 指定版本的 SDK 已安装，无 SDK 缺失提示 |
| 模块配置 | app 模块被识别为 Android 应用模块，工具栏可选择 app 运行配置 |
同步完成后再运行应用，确保构建所需的模块和依赖已被识别。
五、了解初始工程的基本概况
工程同步完成后，在 Android Studio 左侧工程窗口中选择 Project（项目）视图，查看初始工程的主要内容。下图标出了代码、资源和配置文件的位置。
代码与基础类。 java 目录中包含应用级类 FoodApplication、入口页面 MainActivity，以及 BaseActivity、BaseFragment、BaseViewModel 等基础类。它们分别用于应用初始化、显示初始页面，以及为页面和状态管理提供公共基础。
页面与资源。 res 目录中已准备好页面布局、文字、颜色、尺寸、图标和样式等资源，assets 目录中包含加载动画文件。后续功能开发时，可以直接使用这些资源。
应用与构建配置。 AndroidManifest.xml 用于声明应用信息和启动页面，Gradle 配置文件用于设置工程模块、SDK 版本和依赖。
初始工程已经具备上述基础内容，账号登录、门店列表、购物车和订单等业务功能将在此基础上逐步开发。
六、运行初始工程
在 Android Studio 工具栏中选择 app 运行配置和已连接的 Android 设备，点击 Run（运行），等待应用启动。
运行后，页面显示应用图标和标题“点餐 APP 初始工程”。标题下方显示说明文字：“当前工程已完成基础环境配置与静态资源导入，可作为后续课程开发起点。”
任务小结
本任务完成了开发环境准备和初始工程的导入，了解了工程中的资源与基础类，并在设备上运行了初始页面。