为新设备添加模块

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

Android Studio 利用模块来简化向项目添加新设备的步骤。您只需在 Android Studio 中执行几个简单的步骤,即可创建模块以容纳专用于某个设备类型(例如 Wear OS 或 Android TV)的代码。Android Studio 会自动创建模块目录(例如源代码目录和资源目录)以及适合相应设备类型的默认 build.gradle 文件。另外,Android Studio 会使用推荐的 build 配置来创建设备模块,例如使用 Leanback 库创建 Android TV 模块。

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

利用 Android Studio,您还可以轻松地将库或 Google Cloud 模块添加到您的项目中。如需详细了解如何创建库模块,请参阅创建库模块

创建新模块

如需针对新设备将新模块添加到您的项目中,请按照下列步骤操作:

  1. 依次点击 File > New > New Module
  2. 在随即显示的 Create New Module 窗口中,Android Studio 会提供以下设备模块:
    • 手机和平板电脑模块
    • Wear OS 模块
    • Android TV 模块
    • Glass 模块
    选择所需设备的模块,然后点击 Next
  3. Configure your new module 表单中,输入以下详细信息:
    • Application Name:此名称用作新模块的应用启动器图标的标题。
    • Module Name:此文本用作存放源代码文件和资源文件的文件夹(其中内容对用户可见)的名称。
    • Package Name:这是模块中代码的 Java 命名空间,作为 package 属性添加到模块的 Android 清单文件中。
    • Minimum SDK:此设置表示应用模块支持的最低 Android 平台版本。此值会设置 build.gradle 文件中的 minSdkVersion 属性(稍后可进行修改)。

    然后,点击 Next

  4. 下一页会显示一系列您可选择用作主 Activity 的适当代码模板(具体取决于您选择的设备模块)。点击您想开始使用的 Activity 模板,然后点击 Next。如果您不需要使用 Activity,请依次点击 Add No ActivityFinish,然后便大功告成了。
  5. 如果您选择了 activity 模板,请在 Customize the Activity 页面上输入 activity 的设置。大多数模板都会要求您设置 Activity NameLayout NameTitleSource Language,但每个模板都有 Activity 专属设置。点击 Finish。在使用 Activity 模板创建应用模块时,您可以立即在设备上运行并测试该模块。

Android Studio 会为新模块创建所有必要的文件,并将项目与新模块 gradle 文件同步。为新设备添加模块也会将目标设备所需的全部依赖项添加到该模块的 build 文件中。

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

导入模块

如需将现有模块导入您的项目中,请按照下列步骤操作:

  1. 依次点击 File > New > Import Module
  2. Source directory 框中,输入或选择要导入的模块所在的目录:
    • 如果您要导入一个模块,请指明其根目录。
    • 如果要从项目导入多个模块,请指明项目的文件夹。对于该文件夹内的每个模块,系统都会显示一个方框并指明 Source locationModule name。请务必选中要导入的每个模块所对应的 Import 框。
    如果您的模块具有其他依赖项,它们会在 Additional required modules 下列出,以便您导入。
  3. Module name 字段中输入所需的模块名称。
  4. 点击 Finish

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

后续步骤

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

您还需要添加代码和资源以正确支持新设备。如需详细了解如何针对不同设备类型开发应用模块,请参阅相应的文档:

在开发新模块时,您可能用到其他应用模块中已有的重复代码,该代码不与设备关联。不妨考虑将这些共用的代码移至某个库模块并将该库作为依赖项添加到应用模块中,而不是保留重复的代码。如需详细了解如何创建库模块并将其添加为依赖项,请参阅创建 Android 库