任务三初始工程导入与运行

将课程提供的初始工程导入 Android Studio，完成 Gradle 同步，并在 Android 设备上运行应用。

一、获取并打开初始工程

音乐播放器的初始工程保存在 Git 仓库中。使用 Android Studio 的版本控制功能即可克隆工程，不需要在终端中执行命令。

启动 Android Studio，在欢迎页点击右上方的 克隆仓库。如果 Android Studio 已经打开其他工程，可以通过菜单 File > New > Project from Version Control 打开同一窗口。

在弹出的对话框中完成以下设置：

设置项	内容
Version control	Git
Repository URL	`https://cnb.cool/sziit-coding/android-coding/android-music`
Directory	初始工程在本地的保存位置，目录名保持默认

Clone Project 对话框，顶部显示 Repository URL，下方 Directory 输入框 — 克隆工程对话框

其中，Repository URL 为音乐播放器初始工程的仓库地址，Directory 用于设置工程保存到本地的位置。设置完成后点击 Clone（克隆），等待克隆结束。

克隆完成后 Android Studio 会自动打开该目录。能否正确打开，看目录里有没有 settings.gradle.kts：这个文件声明项目名称和工程包含的模块，本项目当前包含 app 模块。只有从根目录打开，Android Studio 才能识别全部模块并完成 Gradle 同步。如果没有自动打开，或打开的是上层父目录，用菜单 File > Open 重新选择包含 settings.gradle.kts 的目录即可。

二、完成 Gradle 同步

工程打开后，Android Studio 会自动检查 Gradle 配置并显示同步进度。等待同步完成，再观察底部 Build 或 Sync 输出区域。

同步完成后，检查以下结果：

检查对象	应观察到的结果
工程视图	能够看到 `app` 模块及其 `src/main` 目录。
Gradle 同步	输出区域显示同步完成，没有依赖解析或脚本语法错误。
Android SDK	`app/build.gradle.kts` 中的 `compileSdk = 34` 没有红色提示，编辑器不报告缺少对应 SDK。
模块配置	`app` 模块能够显示为 Android Application 模块。

Gradle 同步的作用是根据项目配置读取 Android Gradle Plugin、Kotlin 插件和应用依赖，并生成 Android Studio 编辑和构建项目所需的信息。在同步未完成前运行应用，可能无法正确识别模块或依赖，因此必须先完成同步。

三、认识初始工程文件

在 Android Studio 左侧切换到 Project 视图，展开 app 模块的 src/main 目录，可以看到初始工程的完整目录树。下图标出了后续任务会用到的主要文件，以及它们在目录树中的位置。

Android Studio 的 Project 视图展示音乐播放器初始工程目录树，右侧标注 MainActivity.kt、activity_main.xml、drawable、mipmap、values、AndroidManifest.xml 和 build.gradle.kts 的位置与作用 — 初始工程主要文件位置

图中这些文件按职责分为四类：MainActivity.kt 是当前初始页面的入口 Activity，activity_main.xml 定义该页面的布局；drawable、mipmap 和 values 分别保存图标等 Drawable 资源、应用图标资源，以及字符串、颜色和主题等资源；AndroidManifest.xml 声明应用信息和启动 Activity；app/build.gradle.kts 配置应用模块的 SDK、构建参数和当前依赖。

初始工程已经提供的图标、颜色和应用图标等静态资源，不需要重新创建或修改。

四、运行初始工程

准备任务二中已连接的真机或已启动的模拟器。
使用真机时，在设备上允许 USB 调试授权；如果设备弹出安装确认，选择允许。
在 Android Studio 顶部设备列表中选择该真机或模拟器。
点击 Run，选择 app 运行配置。
等待应用安装并启动。

运行后，初始页面应显示顶部标题“全部音乐”，页面主体显示“音乐列表将在后续任务中实现”。这段提示文字表明当前工程只完成页面起点，歌曲列表将在单元二实现。

音乐播放器初始工程页面，显示全部音乐标题和初始页面提示文字 — 初始工程运行效果

将设备上的页面与上面的效果图对照，检查标题文字、页面背景和提示文字是否一致。初始页面没有歌曲列表和播放控制按钮，这是预期结果，因为这些功能将在单元二和单元三中逐步实现。

五、记录运行结果

任务结束前，记录以下信息：

记录项目	记录内容
工程是否成功同步	记录“成功”或记录同步错误信息。
使用的运行设备	记录设备型号和 Android 版本。
初始页面标题	记录页面显示的标题文字。
初始页面提示	记录页面主体显示的提示文字。
运行问题	记录安装、启动或页面显示过程中出现的问题。

任务小结

本任务完成了初始工程的导入、Gradle 同步和设备运行，并认识了主要工程文件。应用能够显示标题和初始提示，工程已具备继续开发的条件。