为新设备添加模块

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

Android Studio 利用模块来简化向项目添加新设备的步骤。您只需在 Android Studio 中执行几个简单的步骤,即可创建模块以包含专用于某个设备类型(例如 Wear OS 或 Android TV)的代码。Android Studio 会自动创建模块目录(例如源代码目录和资源目录)以及适合设备类型的默认 build.gradle 文件。另外,Android Studio 会使用推荐的编译配置来创建设备模块,例如使用 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 命名空间,作为模块的 Android 清单文件中的 package 属性添加。
    • Minimum SDK:此设置表示应用模块支持的 Android 平台的最低版本。此值会设置 build.gradle 文件中的 minSdkVersion 属性(稍后可进行更改)。

    然后,点击下一步

  4. 根据您选择的设备模块,下一页上会显示您可选择作为主 Activity 的相应代码模板。点击您想使用的 Activity 模板,然后点击 Next。如果您不需要使用 Activity,请依次点击 Add No ActivityFinish,然后便大功告成了。
  5. 如果您选择了 Activity 模板,请在 Customize the Activity 页面上输入 Activity 的设置。大多数模板都会要求您设置 Activity NameLayout NameTitleSource Language,但每个模板都有 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 库