创建和管理虚拟设备

Android Virtual Device (AVD) 是一个配置，用于定义您想要在 Android Emulator 中模拟的 Android 手机、平板电脑、Wear OS 或 Android TV 设备的特征。 AVD Manager 是一个可以在 Android Studio 中启动的界面，可以帮助您创建和管理 AVD。

要打开 AVD Manager，请执行以下操作之一：

• 选择 Tools > AVD Manager。
• 点击工具栏中的 AVD Manager。
  

关于 AVD

AVD 包括硬件配置、系统映像、存储区域、皮肤和其他属性。

我们建议您根据清单中的 <uses-sdk> 设置为您的应用可能支持的每个系统映像创建一个 AVD。

硬件配置

硬件配置定义设备出厂时的特征。 AVD Manager 会预加载特定的硬件配置，如 Pixel 设备，您可以根据需要定义或自定义硬件配置。

请注意，只有部分硬件配置显示为包括应用商店。 这表示这些配置完全符合CTS 标准，可以使用包括“应用商店”应用的系统映像。

系统映像

使用 Google API 标记的系统映像包括对 Google Play 服务的访问权。 使用 Play Store 列的 Google Play 徽标标记的系统映像包括 Google Play 商店应用和对 Google Play 服务的访问权，其中包括 Extended controls 对话框中的 Google Play 标签，可提供便于在设备上更新 Google Play 服务的按钮。

为确保应用安全并且与物理设备的体验一致，包括 Google Play 商店的系统映像使用发布密钥进行签署，这意味着您无法获得这些映像的高级权限（根权限）。 如果需要高级权限（根权限）以帮助您的应用排查问题，您可以使用不包括 Google 应用或服务的 Android 开源项目 (AOSP) 系统映像。

存储区域

AVD 在您的开发计算机上有专门的存储区域， 可以存储设备用户数据，如已安装的应用和设置，以及模拟 SD 卡。 必要时，您可以利用 AVD Manager 擦除用户数据，将设备恢复到新设备的数据水平。

皮肤

模拟器皮肤指定设备的外观。 AVD Manager 提供了一些预定义的皮肤。 您也可以自己定义皮肤，或者使用第三方提供的皮肤。

AVD 和应用功能

确保您的 AVD 定义包括您的应用所依赖的设备功能。 请参阅硬件配置属性和 AVD 属性，了解您可以在 AVD 中定义的功能列表。

创建 AVD

提示：如果您想在模拟器中启动您的应用，请改为从 Android Studio 运行您的应用，然后在出现的 Select Deployment Target 对话框中，点击 Create New Virtual Device。

要创建新的 AVD，请执行下列操作：

• 通过点击 Tools > AVD Manager 打开 AVD Manager。

• 点击位于 AVD Manager 对话框底部的 Create Virtual Device。
  出现 Select Hardware 页面。
  
  请注意，只有部分硬件配置显示为包括应用商店。 这表示这些配置完全符合CTS 标准，可以使用包括“应用商店”应用的系统映像。

• 选择硬件配置，然后点击 Next。
  如果您没有看到想要的硬件配置，可以创建 或导入硬件配置。

出现 System Image 页面。

• 选择针对特定 API 级别的系统映像，然后点击 Next。
  Recommended 标签会列出推荐的系统映像。 其他标签包含更完整的列表。 右侧窗格介绍选定的系统映像。 x86 映像在模拟器中运行得最快。

如果您在系统映像旁看到 Download，需要点击它以下载相应的系统映像。 您必须连接到互联网才能下载。

目标设备的 API 级别非常重要，因为您的应用将无法在 API 级别低于应用所需级别（在应用 manifest 文件的 minSdkVersion 属性中定义）的系统映像上运行。 如需了解有关系统 API 级别与 minSdkVersion 之间关系的详细信息，请参阅管理应用版本。

如果您的应用在 manifest 文件中声明了 <uses-library> 元素，应用会要求存在外部库的系统映像。 如果您想要在模拟器上运行应用，请创建包含所需库的 AVD。 为此，您需要使用适用于 AVD 平台的插件组件；例如包含 Google 地图库的 Google API 插件。

出现 Verify Configuration 页面。

• 根据需要更改 AVD 属性，然后点击 Finish。
  点击 Show Advanced Settings 显示更多设置，如皮肤。

新 AVD 出现在 Your Virtual Devices 页面或 Select Deployment Target 对话框中。

要从副本开始创建 AVD，请执行以下操作：

• 从 AVD Manager 的 Your Virtual Devices 页面中，右键点击 AVD，然后选择 Duplicate。
  或点击 Menu 并选择 Duplicate。

出现 Verify Configuration页面。

• 如果您需要在 System Image 和 Select Hardware 页面上进行更改，请点击 Change 或 Previous。
• 进行更改，然后点击 Finish。
  AVD 出现在 Your Virtual Devices 页面中。

创建硬件配置

AVD Manager 会为常见设备提供预定义的硬件配置，这样您就可以轻松地将它们添加至您的 AVD 定义中。 如果您需要定义不同的设备，则可以创建新的硬件配置。您可以从头定义新的硬件配置，也可以复制硬件配置作为基础。 预加载的硬件配置无法编辑。

要从头创建新的硬件配置，请执行以下操作：

• 在 Select Hardware 页面中，点击 New Hardware Profile。
• 在 Configure Hardware Profile 页面中，根据需要更改硬件配置属性。
• 点击 Finish。
  您的新硬件配置出现在 Select Hardware 页面中。 您也可以选择性地点击 Next，使用该硬件配置创建 AVD 。 或者，点击 Cancel 返回至 Your Virtual Devices 页面或 Select Deployment Target 对话框。

要从副本开始创建硬件配置，请执行以下操作：

• 在 Select Hardware 页面中，选择硬件配置，然后点击 Clone Device。

或者，右键点击硬件配置，然后选择 Clone。

• 在 Configure Hardware Profile 页面中，根据需要更改硬件配置属性。

• 点击 Finish。

您的新硬件配置出现在 Select Hardware 页面中。 您也可以选择性地点击 Next，使用该硬件配置创建 AVD 。 或者，点击 Cancel 返回至 Your Virtual Devices 页面或 Select Deployment Target 对话框。

修改现有 AVD

从 Your Virtual Devices 页面，您可以对现有的 AVD 执行以下操作：

• 要修改 AVD，请点击 Edit this AVD，然后进行修改。
• 要删除 AVD，请右键点击 AVD，然后选择 Delete。 或点击 Menu 并选择 Delete。
• 要在磁盘上显示关联的 AVD .ini 和 .img 文件，请右键点击 AVD，然后选择 Show on Disk。 或点击 Menu 并选择 Show on Disk。
• 要查看 AVD 配置详细信息（您可以将其包含在提交给 Android Studio 团队的任何错误报告中），请右键点击 AVD，然后选择 View Details。 或点击 Menu 并选择 View Details。

修改现有的硬件配置

从 Select Hardware 页面，您可以对现有的硬件配置执行以下操作：

• 要修改硬件配置，请选择相应配置，然后点击 Edit Device。 或者，右键点击硬件配置，然后选择 Edit。 接下来，进行修改。

• 要删除硬件配置，请右键点击相应配置，然后选择 Delete。
  您无法修改或删除预定义的硬件配置。

运行和停止模拟器以及清除数据

从 Your Virtual Devices 页面，您可以对模拟器执行以下操作：

• 要运行使用 AVD 的模拟器，请双击 AVD。 或者点击 Launch。
• 要停止运行中的模拟器，请右键点击 AVD，然后选择 Stop。 或点击 Menu 并选择 Stop。
• 要为模拟器清除数据，并返回到首次定义时的状态，请右键点击 AVD，然后选择 Wipe Data。 或点击 Menu 并选择 Wipe Data。

导入和导出硬件配置

从 Select Hardware 页面，您可以导入和导出硬件配置：

• 要导入硬件配置，请点击 Import Hardware Profiles，然后选择您的计算机上包含定义的 XML 文件。

• 要导出硬件配置，请右键点击相应配置，然后选择 Export。 指定您想要存储包含定义的 XML 文件的位置。

硬件配置属性

您可以在 Configure Hardware Profile 页面中指定硬件配置的下列属性。 AVD 配置属性可以替换硬件配置属性，而您在模拟器运行时设置的模拟器属性可以替换前两者。

AVD Manager 包含的预定义硬件配置属性无法修改。 不过，您可以复制它们并修改副本。

AVD 属性

您可以在 Verify Configuration 页面中为 AVD 配置指定下列属性。AVD 配置指定了开发计算机与模拟器之间的交互，以及您想要在硬件配置中替换的属性。

AVD 配置属性可以替换硬件配置属性。您在模拟器运行时设置的模拟器属性可以替换前两者。

创建模拟器皮肤

Android 模拟器皮肤是定义模拟器显示画面的视觉和控制元素的一系列文件。 如果 AVD 设置中可用的皮肤定义无法满足您的要求，您可以创建自己的自定义皮肤定义，然后将其应用到 AVD。

每个模拟器皮肤均包含：

• 一个 hardware.ini 文件
• 用于支持的屏幕方向（横向、纵向）和物理配置的布局文件

• 用于显示元素（如背景、键和按钮）的图片文件
  要创建和使用自定义皮肤，请执行以下操作：

• 创建一个用于保存皮肤配置文件的新目录。

• 在一个名为 layout 的文本文件中定义皮肤的视觉外观。 此文件可以定义皮肤的多个特征，如大小和特定按钮的图像资源。 例如：

parts {
    device {
        display {
            width   320
            height  480
            x       0
            y       0
        }
    }
 
    portrait {
        background {
            image background_port.png
        }
 
        buttons {
            power {
                image  button_vertical.png
                x 1229
                y 616
            }
        }
    }
    ...
}

• 在相同的目录下添加设备映像的位图文件。
• 在代表设备设置的 hardware.ini 文件中指定其他硬件特有设备配置， 例如 hw.keyboard 和 hw.lcd.density。
• 将皮肤文件夹中的文件归档，然后选择归档文件作为自定义皮肤。
  如需了解有关创建模拟器皮肤的更多详细信息，请参阅工具源代码中的 Android Emulator 皮肤文件规范。