Android 项目开发实战 基于音乐播放器与点餐 APP 的项目化教材

任务二 开发环境准备

这一步安装并配置 Android 应用开发所需的环境：Android Studio 和 Git。Android Studio 是开发和运行 Android 应用的主要工具，通过 Git 从仓库获取工程并管理版本。

一、安装 Android Studio

Android Studio 是 Google 提供的 Android 应用开发工具，包含代码编辑、布局设计、Gradle 构建和设备运行等功能。本教材后续所有 Android 项目都在 Android Studio 中完成。

安装分两部分：先安装 Android Studio，再通过首次启动的设置向导下载 Android SDK。SDK 提供编译 Android 应用所需的平台库和工具。编译本项目需要安装与 compileSdk = 34 对应的 Android SDK Platform，即 Android 14（API 34）。

检查电脑配置

安装前先确认电脑满足基本要求。

项目最低要求推荐配置
操作系统Windows 10 64 位最新的 Windows 64 位版本
内存仅使用 Android Studio 时为 8 GB；同时运行模拟器时为 16 GB32 GB
硬盘可用空间仅使用 Android Studio 时为 8 GB；同时运行模拟器时为 16 GB32 GB 及以上，固态硬盘最佳
屏幕分辨率1280×8001920×1080
CPU支持虚拟化（VT-x / AMD-V）近 3 年内的主流 CPU

CPU 虚拟化只在运行模拟器时需要。使用真机调试的，配置略低也能完成本教材的全部任务。

规划 SDK 存储路径

Android SDK 会占用 3～8 GB 空间，安装前先定好存放位置，避免中途迁移。推荐路径示例：D:\Android\SDK。

下载安装包

  1. 打开浏览器，访问 Android Studio 官方下载页 https://developer.android.google.cn/studio?hl=zh-cn。这是 Google 面向中国大陆提供的站点，国内网络访问更稳定。
  2. 核对页面推荐的版本是否满足上述版本要求，并选择适用于 Windows 的安装包。
  3. 点击下载按钮，在弹出的许可协议确认框中勾选同意，再点击 Download 开始下载。

下载文件名和大小会随版本变化，以下载页面显示的信息为准。

Android Studio 下载页面

安装 Android Studio

  1. 双击下载好的 .exe。弹出 Windows 用户账户控制提示时点击 是；出现 Windows 安全警告时点击 运行。
  2. 安装向导欢迎页直接点击 Next。
  3. 组件选择页面保持 Android Studio 勾选。若显示 Android Virtual Device，可暂不勾选，模拟器将在本任务第三节单独创建。点击 Next。
  4. 选择安装路径。C 盘剩余空间充足时可保持默认；需要改动的，点击 Browse 选择类似 D:\Android\AndroidStudio 的路径。点击 Next。
  5. 开始菜单文件夹名称保持默认，点击 Install，等待安装完成。
  6. 安装完成后点击 Next 进入完成页面，勾选 Start Android Studio，点击 Finish。
安装向导的组件选择页面

下载 Android SDK 组件

关闭安装向导后 Android Studio 自动启动，并运行首次设置的 Setup Wizard。

  1. 向导欢迎页点击 Next。
  2. 询问是否发送匿名使用数据时，选择 Send usage statistics to Google 或 Don’t send 均可，点击 Next。
  3. 向导随后拉取可用组件列表。如果提示无法访问组件列表，先点击弹窗中的 Cancel，再点击页面底部的 Next 继续，不影响后续下载。
无法访问组件列表的提示
  1. 安装类型选择 Custom，点击 Next。选择 Custom 才能手动指定 SDK 路径，避免占用系统盘。
安装类型选择 Custom
  1. 把 Android SDK Location 改成前面规划的路径。可以点击路径右侧的文件夹图标选择，也可以直接输入；文件夹不存在时 Android Studio 会自动创建。按下表确认组件勾选，然后点击 Next。
组件作用处理方式
Android SDKSDK 核心工具保持勾选
Android SDK Platform各 Android 版本的平台库保持勾选
模拟器加速相关组件（部分版本显示）提升模拟器运行速度使用模拟器时按向导提示安装
Android Virtual Device（部分版本显示）默认模拟器配置可保持默认，后续可在 Device Manager 中创建模拟器

不同 Android Studio 版本显示的组件可能不同。未列出的组件可在后面导入工程时按提示安装，不必专门寻找。

SDK 路径与组件设置
  1. 确认页面显示待下载组件和总大小，点击 Next。
  2. 许可协议页面逐个选择 Accept，点击 Next 开始下载。
  3. 等待下载完成后，点击 Finish 进入欢迎页。下载时长取决于网络状况和所选组件。

确认 SDK 安装结果

  1. 在欢迎页点击左下角的齿轮图标，选择 Settings；已经打开工程时通过菜单 File > Settings 打开。
  2. 左侧展开 Languages & Frameworks，选择 Android SDK。
  3. 核对页面顶部的 Android SDK Location 与设置向导中填写的路径一致。
  4. 在组件列表中确认本教材工程需要的 Android 14（API 34） 平台库状态为 Installed。显示 Not installed 的，勾选该行后点击右下角 Apply 下载；列表中没有该版本的，在同一页面勾选对应版本后点击 Apply 安装。
在设置页确认 SDK 路径与安装状态

安装或启动过程中，360 安全卫士、火绒等杀毒软件弹出拦截提示时，把 Android Studio 安装目录、Android SDK 目录和后面的工程目录加入信任区，再重新运行安装程序。

二、安装 Git

Git 是项目开发中常用的版本控制软件。我们可以在 Android Studio 中使用 Git 从远程仓库将项目代码克隆到本地，再继续进行开发。

检查是否已安装 Git

按 Win + R，输入 cmd 后回车打开命令提示符，输入：

Terminal window
git --version
  • 输出类似 git version 2.x.x.windows.x，说明已经安装，直接跳到“让 Android Studio 识别 Git”。
  • 提示“git 不是内部或外部命令”，按下面的步骤安装。

安装 Git

  1. 下载安装包。可以从 Git 官网 https://git-scm.com/download/win 下载；国内网络访问较慢时，改用镜像 https://registry.npmmirror.com/binary.html?path=git-for-windows/ 获取 64 位安装包。文件名中的版本号会随发布版本变化。
  2. 双击安装包，安装向导的选项较多，大部分保持默认，只需确认下面三处。
设置页面应选择的项目原因
Select Components保持默认勾选确保 Git Bash 和 Git GUI 都被安装。
Adjusting your PATH environment第二项 Git from the command line and also from 3rd-party software让命令提示符和 Android Studio 都能直接使用 git 命令。
Configuring the line ending conversions第一项 Checkout Windows-style, commit Unix-style line endings在 Windows 上检出文件、提交时按 Unix 风格记录换行，避免工程文件换行符混乱。
PATH 环境变量设置页面
行尾符设置页面
  1. 其余页面点击 Next，安装结束后点击 Finish。
  2. 重新打开一个命令提示符窗口，再次执行 git --version 确认安装成功。已经打开的窗口不会自动读取新的环境变量，必须重新打开。

让 Android Studio 识别 Git

  1. 打开 Android Studio，进入 File > Settings > Version Control > Git。
  2. 查看 Path to Git executable 输入框。多数情况下 Android Studio 已自动填入 Git 的安装位置；为空时点击右侧文件夹图标，手动定位到 Git 安装目录下的 git.exe。
  3. 点击 Test。弹出类似 Git 2.x.x 的版本提示即配置成功，点击 OK 保存设置。
点击 Test 后显示 Git 版本

三、准备运行设备

应用既可以在真机上运行，也可以在 Android Studio 自带的模拟器上运行，两种方式任选其一。真机运行更流畅，模拟器不依赖实体设备，按手头条件选择即可。

方式一：使用真机

  1. 使用 USB 数据线连接 Android 设备。
  2. 在设备上打开“开发者选项”，开启“USB 调试”。
  3. 设备弹出 USB 调试授权提示时，勾选“始终允许”并选择允许。
  4. 在 Android Studio 顶部的设备列表中确认能够看到该设备。

不同手机的开发者选项开启方式略有不同，通常是在“设置”中连续点击“版本号”后出现。设备连接成功后，Android Studio 顶部设备列表会显示设备名称。

方式二：使用模拟器

  1. 打开 Android Studio 的 Device Manager（设备管理器），点击 Create Device（创建设备）。
  2. 选择一个手机型号（如 Pixel 系列），点击 Next。
  3. 在系统镜像列表中选择 Android 14（API 34），未下载的先点击该行的下载链接完成下载，然后点击 Next。
  4. 保持默认配置，点击 Finish 完成创建。
  5. 在 Device Manager 中点击该设备的启动按钮，等待模拟器开机完成。

为与本教材工程保持一致，建议选择 Android 14（API 34）系统镜像。若选择其他系统版本，应不低于工程的 minSdk。建议选用带 x86_64 标识的镜像，在普通电脑上运行更流畅。模拟器启动后同样出现在 Android Studio 顶部的设备列表中，后续使用方法与真机完全相同。

四、验证环境

完成安装后，按照下表逐项检查环境：

检查项目检查方法预期结果
Android Studio启动 Android Studio能够进入欢迎页
Android SDKSettings > Languages & Frameworks > Android SDKSDK Location 为规划的路径，Android 14（API 34）平台库状态为 Installed
GitSettings > Version Control > Git，点击 Test弹出 Git 版本号提示
运行设备Android Studio 设备列表显示已连接的真机或已启动的模拟器

全部检查通过后，开发环境准备完成。下一任务将使用 Android Studio 从版本控制克隆并导入音乐播放器的初始工程。

任务小结

Android Studio、Git 安装完成，设备调试准备就绪，环境验证也全部通过。接下来可以导入初始工程并完成首次运行。