创建并运行您的首个 Android 应用

1. 简介

注意：本 Codelab 已过时，我们不再进行维护。如需了解最新的推荐做法，请改为学习 Android 之 Compose 开发基础课程。

在此 Codelab 中，您将基于 Android Studio 提供的基本应用模板创建您的首个 Android 应用（生日快乐）。此外，您还将对 Android 项目有个大致了解，并学习到如何在 Android Studio 中使用不同的窗口。

前提条件

• 熟悉如何设置、配置和使用文字处理器或电子表格等应用

学习内容

• 如何使用模板为 Android 应用创建 Android Studio 项目

构建内容

• 基于模板的基本 Android 应用

所需条件

• 一台安装了 Android Studio 的计算机

2. 构建您的首个应用

在此任务中，您将使用 Android Studio 提供的项目模板创建一个 Android 应用。

项目模板

在 Android Studio 中，项目模板是一个 Android 应用，其中包含所有必要的部件，但不具有什么功能。其宗旨是帮助您更快地入门，为您省去一些工作。Android Studio 中的一些模板示例包括：包含一个地图的应用以及具有多个屏幕的应用。

创建空 Activity 项目

在以下步骤中，您将使用 Empty Activity 项目模板为您的新应用创建一个新的 Android Studio 项目。

1. 点击 Android Studio 图标启动 Android Studio（如果尚未打开）：

2. 系统随即会打开 Welcome to Android Studio 窗口。点击 New Project。

3. New Project 窗口随即会打开，其中列出了 Android Studio 提供的模板。

4. 点击顶部的标签页并滚动浏览模板，了解您可以执行的操作！我们针对许多不同类型的设备（例如手机、平板电脑和手表）以及不同类型的应用（具有可滚动屏幕的应用、包含地图的应用以及采用复杂导航方式的应用）提供了模板。
5. 在窗口左上角，点击 Phone and Tablet 标签页。
6. 点击最上面一行中的 Empty Activity 模板，以选择该模板作为项目的模板。

Empty Activity 模板是可用于创建应用的最简单的模板。它只有一个屏幕，上面显示一条简单的消息“Hello World!”。

7. 点击窗口底部的 Next。New Project 对话框随即会打开。

按如下方式配置项目：

8. Name 是应用的名称。在 Name 下方的框中，输入 Happy Birthday 作为项目的名称。
9. Package name 是 Android 系统用来唯一标识您的应用的名称。通常，该名称默认为贵组织的名称后跟应用的名称，且所有字符均采用小写形式（在此例中为“com.example.happybirthday”）。
10. Save location 是保存与项目相关的所有文件的位置。请记下这些文件在您计算机上的保存位置，以便查找文件。您可以暂时将“Save location”字段保留原样。
11. Language 定义了您要用于构建项目的编程语言。请确保在 Language 字段中选择 Kotlin。
12. Minimum SDK 指示可运行您的应用的最低 Android 版本。从下拉列表中选择 API 19: Android 4.4 (KitKat)。

注意：Android 操作系统有许多不同的版本，每个版本在发布时都按字母顺序指定了名称。

13. 请注意 Minimum SDK 下的信息性说明，该说明指出了如果选择相应 API 级别，您的应用可以在多少设备上运行。如果您有兴趣，请点击 Help me choose 链接，以查看各个 Android 版本的列表，如下所示。然后，返回 New Project 窗口。

14. 在 New Project 窗口中，确保 Use legacy android.support libraries 未选中。如果您想详细了解相关信息，请点击问号图标。
15. 点击 Finish。

Android Studio 会打开项目及其所有文件。

首次打开 Android Studio 时，您会看到以下三个窗口：

(1) Project 窗口显示项目的文件和文件夹。

(2) Editing 窗口用于修改代码。

(3) What's New 窗口显示资讯和实用提示。

在 Android Studio 的右下角，会显示进度条或消息来指示 Android Studio 是否仍在设置您的项目。例如：

16. 等待 Android Studio 完成项目设置。项目设置完成后，系统会在左下角显示一条消息通知您，如下所示。

3. 在虚拟设备（模拟器）上运行您的应用

在该任务中，您将使用设备管理器创建移动设备的软件版本（模拟器），然后在计算机上运行它。虚拟设备（即模拟器）可以模拟特定类型的 Android 设备（如手机）的配置。它可以是搭载您所选 Android 系统版本的任何手机或平板电脑。然后，您将使用该虚拟设备运行通过 Empty Activity 模板创建的应用。

注意：Android 模拟器是一个用于设置虚拟设备的独立应用，有自己的系统要求。虚拟设备可能会占用大量磁盘空间。如果您遇到任何问题，请参阅在 Android 模拟器上运行应用。

创建 Android 虚拟设备 (AVD)

如要在计算机上运行模拟器，首先应为虚拟设备创建配置。

1. 在 Android Studio 菜单栏中，依次选择 Tools > Device Manager。

提示：您也可以通过在工具栏中点击设备管理器的图标 将其打开。

设备管理器显示如下。（如果您以前创建过设备，此处将会列出。）

2. 点击 Create device。

系统随即会显示 Select Hardware 窗口。

Select Hardware 窗口显示了一系列预配置的设备（按 Category 整理），您可以从中进行选择。对于每种设备，该表都提供了 Size 列（提供显示屏尺寸信息）、Resolution 列（提供以像素为单位的屏幕分辨率信息）和 Density 列（提供像素密度信息）。

3. 选择 Phone 类别。
4. 选择一部手机（例如 Pixel 5），然后点击 Next。您可以选择任何手机，但对于此 Codelab，请选择较新的设备。

系统随即会显示 System Image 窗口。在该窗口中，选择要在虚拟设备上运行的 Android 系统版本。这可让您在不同版本的 Android 系统上测试您的应用。

5. 在 Recommended 标签页中，选择 S 作为要在虚拟设备上运行的 Android 系统版本。在撰写本文时，这是最新的 Android 版本，不过您可以选择任何较新的稳定版本。点击此处查看稳定版本列表。

注意：如果您要使用的系统映像旁边显示了 Download 链接，则说明您的计算机上未安装该映像。您必须先安装该映像，然后才能配置虚拟设备。

如需安装系统映像，请点击 Download 链接。请注意，下载可能需要较长时间，具体取决于您的互联网连接。下载完成后，点击 Finish。

重要提示：这些 Android 系统映像会占用大量磁盘空间，因此您的原始安装中只会包含几个。Recommended 标签页中只显示了部分 Android 系统版本，除此之外，还有很多。如要查看这些版本的映像，请点击 x86 Images 和 Other Images 标签页。

6. 点击 Next。

系统随即会显示 Android Virtual Device (AVD) 窗口，您可以从该窗口中为设备选择其他配置详情。

7. 在 AVD Name 字段中，输入您的 Android 虚拟设备的名称。保持其余部分不变。
8. 点击 Finish。

您的新虚拟设备会显示在设备管理器窗口中，并可供使用。

在虚拟设备上运行您的应用

1. 将 Android Studio 调入前台（如果尚不在前台）。
2. 在 Android Studio 中，从工具栏找到虚拟设备下拉菜单（与以下示例类似），然后从下拉列表中选择您创建的虚拟设备。（或者，依次点击 Run > Select Device..，然后从弹出式窗口上显示的可用设备中选择您的虚拟设备。）
3. 在 Android Studio 中，依次选择 Run > Run app，或点击工具栏中的 Run 图标。虚拟设备的启动方式与实体设备类似。这可能需要一些时间，具体取决于您的计算机的速度。

当您的应用准备就绪时，会在虚拟设备上打开，如下所示。

太棒了！您的虚拟设备现已启动，正在运行。请注意，应用名称现在为“Happy Birthday”，且屏幕上显示“Hello World!”。

4. 查找项目文件

配置项目后，Android Studio 会在计算机上为您的所有 Android 项目创建一个名为 AndroidStudioProjects 的文件夹。在 AndroidStudioProjects 文件夹内，Android Studio 还会创建一个与应用同名的文件夹（在本例中为 HappyBirthday）。

HappyBirthday 文件夹是您的项目文件夹。Android Studio 会将您创建的文件和 Android Studio 创建的文件都保存在项目文件夹中。

1. 在 Android Studio 中，查看左侧的 Project 窗口。Project 窗口显示项目的文件和文件夹。

Project 窗口中的文件经过整理，以便您编写代码时可以更轻松地在项目文件之间导航。不过，如果您通过文件浏览器（如 Finder 或 Windows 资源管理器）查看文件，则文件层次结构的组织方式会明显不同。

在该任务中，您将探索项目文件夹层次结构的这两种不同视图。

2. 在 Android Studio 的 Project 窗口中，从左上角的下拉菜单中选择 Android。

您应该会看到类似于下图所示的文件列表：

在为项目编写代码时，这种视图和文件组织方式非常有用。

您还能以文件浏览器（如 Finder [对于 macOS] 或资源管理器 [对于 Windows]）视图形式查看文件。

3. 在 Project 窗口中，从下拉菜单中选择 Project Source Files。

请注意，标题会更改为存储项目文件的文件夹。

现在，您可以像在任何文件浏览器中一样浏览文件。

4. 如需切换回之前的视图，请在 Project 窗口中再次选择 Android。

太好了！您现在可以通过模板创建和运行应用，并可以查找项目文件。

5. 总结

• 如要创建新项目，请启动 Android Studio，点击 + Start a new Android Studio project，为项目命名，选择模板，然后填写详细信息。
• 如要创建 Android 虚拟设备（模拟器）来运行应用，请依次选择 Tools > Device Manager，然后使用设备管理器选择硬件设备和系统映像。
• 如要在虚拟设备上运行应用，请确保您已创建设备，从工具栏下拉菜单中选择相应设备，然后点击工具栏中的 Run 图标 以运行您的应用。
• 如要查找项目文件，请转到 Project 窗口，从下拉列表中选择 Project Source Files。

6. 了解详情

• 《使用 Kotlin 进行 Android 开发的基础知识》相关词汇
• 探索 Android Studio
• 项目概览
• 创建项目
• 从模板添加代码
• 构建和运行您的应用
• 在 Android 模拟器上运行应用