为新设备添加模块

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

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

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

Android Studio 还简化了向您的项目添加库或 Google Cloud 模块的过程。有关创建库模块的详细信息，请参阅创建库模块。

创建新模块

要为新设备向您的项目添加新模块，请执行以下操作

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

    然后点击下一步。

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

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

Gradle 项目同步完成后，新模块将显示在左侧的项目窗口中。如果看不到新的模块文件夹，请确保窗口显示Android 视图。

导入模块

要将现有模块导入您的项目，请执行以下操作

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

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

后续步骤

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

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

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