工程结构搭建

动态功能模块（Dynamic Feature Module）是 Android App Bundle 的核心扩展机制，允许将功能拆分为独立的模块，按需下发。本章将指导你完成从零搭建支持 SplitInstall 的 Android 项目，包括项目创建、模块添加、Gradle 依赖配置以及应用 ID 的设置。

2.1 动态功能模块的项目架构

一个支持按需加载的 Android 项目包含两类模块：Base 模块（即 app 模块）和若干 动态功能模块。Base 模块包含应用的公共代码、资源及 AndroidManifest；动态功能模块则封装独立的功能，通过 SplitInstallManager 按需下发。

2.2 创建 Android 项目并添加动态功能模块

创建步骤：

1. 通过 File > New > New Project 创建标准 Android 项目，选择“Empty Activity”。
2. 项目创建后，右键点击项目根目录，选择 New > New Module > Dynamic Feature Module。
3. 在向导中设置模块名称（如 feature_on_demand），指定 Base 模块 applicationId（通常为 com.example.app），并勾选“Install-time inclusion”为 Never（按需安装）。
4. 完成向导后，AS 会自动生成模块目录及 build.gradle，并修改根 settings.gradle。

生成的动态功能模块 build.gradle 基础配置示例：

apply plugin: 'com.android.dynamic-feature'

android {
    compileSdk 34

    defaultConfig {
        // 不要在此设置 applicationId，由 Base 模块提供
        minSdk 21
        targetSdk 34
    }
}

dependencies {
    implementation project(':app')  // 依赖 Base 模块
}

2.3 配置 Gradle 模块依赖

动态功能模块必须通过 Base 模块分发，因此需要在 Base 的 build.gradle 中声明对动态模块的 implementation 依赖：

// app/build.gradle
dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation project(':feature_on_demand')
    // 其他依赖...
}

// settings.gradle
include ':app'
include ':feature_on_demand'

在动态功能模块的 build.gradle 中必须配置 distributions，指定模块名称用于 Play Core API 识别：

// feature_on_demand/build.gradle
android {
    dynamicFeatures = [':feature_on_demand']  // 模块标识
}

2.4 设置基础与应用 ID

Base 模块的 applicationId 即应用唯一标识，动态功能模块不需要设置独立的 applicationId，而是使用 distinctApplicationId 或由 Play 自动生成。推荐做法：

• Base 模块：android.defaultConfig.applicationId = "com.example.app"
• 动态功能模块：在 build.gradle 中通过 distinctApplicationId 指定模块后缀，但通常交由系统自动处理，仅需保证 applicationIdSuffix 不被使用。

若需要为动态模块指定不同的基本 ID（例如为了测试），可在 defaultConfig 中配置：

// 动态模块 build.gradle
android {
    defaultConfig {
        // 显式设置 distinctApplicationId（可选）
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            // 模块后缀会在基础 ID 上追加
        }
    }
}

常见的 ID 配置对照：

2.5 常见错误与调试

完成上述配置后，项目结构已满足动态功能模块的构建和分发要求。下一步将实现 SplitInstall 的下载与安装逻辑。