为新设备添加模块

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

Android Studio 利用模块来简化为项目添加新设备的操作。只需在 Android Studio 中执行几个简单的步骤,便可创建包含 Wear OS 或 Android TV 等设备类型专属代码的模块。Android Studio 会自动创建与设备类型相适的模块目录(例如源代码和资源目录)和默认 build.gradle 文件。此外,Android Studio 还会创建具有建议构建配置的设备模块,例如使用 Android TV 模块专用的 Leanback 库来创建。

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

Android Studio 还简化了为项目添加库或 Google 云模块的操作。有关创建库模块的详情,请参阅创建库模块

创建新模块

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

  1. 点击 File > New > New Module
  2. 在出现的 Create New Module 窗口中,Android Studio 提供了以下设备模块:
    • Phone & Tablet Module
    • Wear OS Module
    • Android TV Module
    • Glass Module
    选择对应于所需设备的模块,然后点击 Next
  3. Configure your new module 表单中,输入下列详情:
    • Application Name:此名称用作新模块的应用启动图标的标题。
    • Module Name:此文本用作您的源代码和资源文件所在文件夹的名称。
    • Package Name:这是模块中代码的 Java 命名空间。它以 package 属性形式添加到模块的 Android manifest 文件中。
    • Minimum SDK:此设置表示应用模块支持的 Android 平台最低版本。该值设置 build.gradle 文件中的 minSdkVersion 属性,您可以稍后对其进行编辑。

    然后,点击 Next

  4. 视您选择的设备模块而定,下一页显示您可以选择作为主操作组件使用的一系列适用代码模板。点击您想作为基础的操作组件模板,然后点击 Next。如果您不需要 Activity,请点击 Add No Activity,点击 Finish,然后即告完成。
  5. 如果您选择了 Activity 模板,请在 Customize the Activity 页面上输入 Activity 的设置。大多数模板都要求提供 Activity NameLayout NameTitle,但每个模板都有 Activity 特有设置。点击 Finish。当您使用 Activity 模板创建应用模块后,可以立即在您的设备上运行和测试模块。

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

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

导入模块

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

  1. 点击 File > New > Import Module
  2. Source directory 框中,键入或选择您想导入的模块的目录:
    • 如果您要导入一个模块,指定其根目录。
    • 如果您要从项目导入多个模块,指定项目文件夹。文件夹内的每个模块都会出现一个对应的框,并指示 Source locationModule name。确保为您想导入的每个模块勾选 Import 框。
    如果您的模块有其他依赖项,它们将作为待导入项列于 Additional required modules 之下。
  3. Module name 字段中键入您想要的模块名称。
  4. 点击 Finish

模块导入后出现在左侧的 Project 窗口中。

后续步骤

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

您还需要添加代码和资源来为新设备提供充分支持。如需了解有关如何为不同设备类型开发应用模块的详细信息,请参阅相应的文档:

在您开发新模块的过程中创建的设备无关代码可能已在其他应用模块中重复使用。您可以考虑不对重复代码进行维护,而是将共享代码转移到一个库模块,然后将库以依赖项形式添加到您的应用模块。如需了解有关创建库模块和以依赖项形式添加库模块的详细信息,请参阅创建 Android 库