为新设备添加模块

模块为您的应用的源代码、资源文件和应用级设置（例如模块级构建文件和 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 库。