为新设备添加模块

模块为您的应用源代码、资源文件以及应用级设置(例如模块级构建文件和 Android 清单文件)提供了一个容器。每个模块都可以独立构建、测试和调试。

Android Studio 使用模块让您轻松地为项目添加新设备。通过在 Android Studio 中执行几个简单步骤,您可以创建一个模块来包含特定于设备类型的代码,例如 Wear OS 或 Android TV。Android Studio 会自动创建模块目录(例如源代码和资源目录)以及适合设备类型的默认 build.gradle 文件。此外,Android Studio 还会创建具有推荐构建配置的设备模块,例如将 Leanback 库用于 Android TV 模块。

本页面介绍了如何为特定设备添加新模块。

Android Studio 还让您轻松地为项目添加库或 Google Cloud 模块。有关创建库模块的详细信息,请参阅创建库模块

创建新模块

要为新设备向项目添加新模块,请按以下步骤操作

  1. 依次点击文件 > 新建 > 新模块
  2. 在显示的创建新模块窗口中,Android Studio 提供了以下设备模块
    • 手机和平板电脑模块
    • Wear OS 模块
    • Android TV 模块
    • Glass 模块
    选择所需的设备模块,然后点击下一步
  3. 配置新模块表单中,输入以下详细信息
    • 应用名称:此名称将用作新模块的应用启动器图标的标题。
    • 模块名称:此文本将用作显示源代码和资源文件的文件夹的名称。
    • 软件包名称:这是模块中代码的 Java 命名空间。它将作为 package 属性添加到模块的 Android 清单文件中。
    • 最低 SDK:此设置表示应用模块支持的 Android 平台的最低版本。此值会设置 build.gradle 文件中的 minSdkVersion 属性,您以后可以编辑此属性。

    然后点击下一步

  4. 根据您选择的设备模块,下一页会显示一些合适的代码模板,您可以选择其中一个作为您的主 activity。点击您想要开始的 activity 模板,然后点击下一步。如果您不需要 activity,请点击不添加 Activity,然后点击完成,这样就完成了。
  5. 如果您选择了 activity 模板,请在自定义 Activity 页面上输入您的 activity 设置。大多数模板会要求提供Activity 名称布局名称标题源语言,但每个模板都有 activity 特定设置。点击完成。当您使用 activity 模板创建应用模块时,您可以立即在设备上运行和测试该模块。

Android Studio 会为新模块创建所有必要文件,并将项目与新模块的 Gradle 文件同步。为新设备添加模块还会将目标设备所需的任何依赖项添加到模块的构建文件中。

Gradle 项目同步完成后,新模块会显示在左侧的项目窗口中。如果您没有看到新模块文件夹,请确保窗口显示的是Android 视图

导入模块

要将现有模块导入您的项目,请按以下步骤操作

  1. 依次点击文件 > 新建 > 导入模块
  2. 源目录框中,输入或选择您要导入的模块的目录
    • 如果要导入一个模块,请指明其根目录。
    • 如果您要从一个项目导入多个模块,请指明项目文件夹。对于文件夹中的每个模块,都会出现一个框,指明源位置模块名称。确保选中您要导入的每个模块的导入框。
    如果您的模块具有其他依赖项,它们将列在其他必需模块下进行导入。
  3. 模块名称字段中输入您所需的模块名称。
  4. 点击完成

模块导入后,它会显示在左侧的 项目窗口中。

后续步骤

添加新模块后,您可以修改模块代码和资源、配置模块构建设置并构建模块。您还可以像运行和调试任何其他应用一样运行和调试该模块。

您还需要添加代码和资源以正确支持新设备。有关如何为不同设备类型开发应用模块的更多信息,请参阅相应文档

在开发新模块时,您可能会创建已在不同应用模块中重复的设备无关代码。与其维护重复代码,不如考虑将共享代码移至库模块,并将该库作为依赖项添加到您的应用模块中。有关创建库模块并将其作为依赖项的更多信息,请参阅创建 Android 库