跳转到内容
编程实战文档中心

1.3 实验：导入已有 Android 项目

1.1 下载实验作业表

在开始操作前，先下载本次实验的作业表，后续每完成一个步骤就及时截图填写，避免忘记。

📄 下载实验作业表（Word 版）

1.2 下载本次实验的项目文件

本次实验使用提供的示例项目，请点击下方链接下载压缩包：

📦 下载实验项目压缩包（DebugDemo.zip）

下载完成后继续下一步，将压缩包解压到合适的目录。

1.3 解压到合适目录

如果拿到的是 .zip 压缩包，需要先解压。解压时请注意：

⚠️ 注意事项

  • 目标路径中不能含有中文字符
  • 目标路径中不能含有空格
  • 建议放在非 C 盘的专用目录下，避免系统盘空间不足
┌─────────────────────────────────────────────────────┐
│  ✅ 正确示例                                           │
│  D:\AndroidProjects\DebugDemo                            │
│  E:\workspace\android\DebugDemo                         │
│                                                      │
│  ❌ 错误示例                                           │
│  C:\Users\张三\桌面\我的安卓项目\DebugDemo               │  ← 含中文
│  D:\My Android Projects\DebugDemo                       │  ← 含空格
└─────────────────────────────────────────────────────┘

1.4 识别项目根目录

解压后，包含 settings.gradle.kts（或 settings.gradle）文件的那一层文件夹就是项目根目录，后续导入时需要选到这一层，不多不少。

典型的项目根目录内容如下：

DebugDemo/                     ← 这一层就是项目根目录（需要选择的层级）
├── app/
│   ├── src/
│   └── build.gradle.kts
├── gradle/
├── build.gradle.kts
├── settings.gradle.kts        ← 关键标志文件
├── gradlew
└── gradlew.bat

⚠️ 常见误操作：将 DebugDemo/ 的父文件夹选进去，或双击进入了 app/ 子目录再选，都会导致导入失败。

📌 本步骤作业要求
📋 作业任务 1 项目文件夹截图

打开文件资源管理器，进入项目根目录，截图显示以下内容：

  • 当前文件夹内可以看到 settings.gradle.kts（或 settings.gradle）
  • 地址栏清晰显示完整路径
✅ 完成后，请将结果粘贴或填写到 步骤 1.1 中下载的实验作业表对应任务行内。

2.1 两种进入方式

与新建项目类似，打开已有项目也有两种入口，取决于当前是否已有工程打开：

  1. 如果 AS 显示欢迎页（没有任何项目打开）：直接点击 Open。
  2. 如果 AS 已打开了其他项目：通过菜单 File → Open…。
欢迎页的 Open 入口
通过菜单 File → Open 进入

两种入口最终打开同一个文件选择窗口，后续操作完全一致。

2.2 选择项目根目录

文件选择窗口打开后，导航到你在上一步确认好的项目根目录（即含 settings.gradle.kts 的那一层），单击选中该文件夹，然后点击 Select Folder。

单击选中项目根目录，再点击 Select Folder

注意：只需单击选中，不要双击进入文件夹内部，否则选到的层级会多一层。

2.3 信任项目（Trust Project）

首次打开某个项目时，Android Studio 会弹出安全提示框，询问是否信任该项目。点击 Trust Project 继续。

点击 Trust Project 继续
📌 本步骤作业要求
📋 作业任务 2 AS 中项目目录结构截图

项目加载完成后，截图 Android Studio 左侧 Project 面板中展开的目录结构，确认：

  • 左上方视图模式为 Android 或 Project
  • 能看到 app/ 目录及其下级子目录
✅ 完成后，请将结果粘贴或填写到 步骤 1.1 中下载的实验作业表对应任务行内。

3.1 识别 Sync 进度

打开项目后，Android Studio 会自动触发 Gradle Sync（构建同步）。此时：

  • 底部状态栏会出现进度条和当前正在执行的任务名
  • 底部 Build 窗口（Build → Build Output）会持续滚动输出日志

等待 Sync 完全结束后再进行任何操作，包括修改代码和点击运行按钮。

3.2 Sync 成功的标志

Gradle Sync 完成后，以下现象说明同步成功：

  • 底部状态栏进度条消失，显示 Gradle sync finished
  • Build 窗口末尾出现 BUILD SUCCESSFUL
  • 代码文件语法高亮恢复正常（不再大面积飘红）
  • 工具栏绿色 Run 按钮（▶）变为可点击状态

3.3 常见 Sync 失败原因及处理

① Gradle 下载超时或进度长时间卡住

原因：未配置国内镜像，默认从 Google 服务器下载速度极慢。

处理方法：配置 Gradle 与仓库镜像。步骤与《1.2 创建第一个 Android 项目》中的”配置 Gradle 与仓库镜像”完全相同——请参考《1.2 实验》的第 3 步完成配置，配置完成后通过菜单 File → Sync Project with Gradle Files 重新触发 Sync。

② 报错提示 SDK Platform 未安装

如果 Build 输出中出现类似以下错误：

Failed to find target with hash string 'android-35'

说明项目所需的某个 SDK Platform 本机尚未安装，处理步骤如下：

  1. 通过菜单打开 SDK Manager：File → Settings → Languages & Frameworks → Android SDK
  2. 切换到 SDK Platforms 选项卡，勾选错误信息中对应的 API 版本（如 API Level 35）
  3. 点击 Apply，等待下载安装完成
  4. 安装完成后重新触发 Sync Project with Gradle Files
📌 本步骤作业要求
📋 作业任务 3 Gradle Sync 成功截图

Gradle Sync 成功后，截图 Build 输出窗口，要求：

  • 可清晰看到末尾的 BUILD SUCCESSFUL 字样
  • 或截图底部状态栏显示 Gradle sync finished 的提示
✅ 完成后，请将结果粘贴或填写到 步骤 1.1 中下载的实验作业表对应任务行内。

4.1 选择运行设备

点击工具栏的设备选择下拉框，选择一个已创建好的模拟器。

如果设备列表中没有任何模拟器，需要先创建一个——请参考《1.1 搭建 Android 开发环境》的模拟器创建步骤。

4.2 运行项目

设备选好后，点击工具栏绿色的 Run 按钮（▶）。

Android Studio 会先编译项目，再将 App 安装到模拟器并自动启动。首次编译耗时较长，请耐心等待。

4.3 确认 App 正常运行

模拟器中出现 App 界面，且没有弹出崩溃提示框，即说明项目导入成功。

📌 本步骤作业要求
📋 作业任务 4 App 运行截图

截图模拟器（或真机）上 App 成功运行的界面，确认：

  • App 已正常启动并显示主界面
  • 没有出现”Unfortunately, … has stopped”崩溃弹框
✅ 完成后，请将结果粘贴或填写到 步骤 1.1 中下载的实验作业表对应任务行内。

5.1 填写并提交作业表

作业表已在步骤 1.2 下载。将以下截图依次填写到作业表中：

任务编号需要提交的内容
任务 1项目文件夹截图（含 settings.gradle.kts，路径清晰可见）
任务 2AS 中 Project 面板展开的目录结构截图
任务 3Gradle Sync 成功截图（BUILD SUCCESSFUL）
任务 4App 在模拟器 / 真机上运行的界面截图

5.2 提交说明

填写完成后，按老师要求提交 Word 文件（课程平台、微信群等）。