Android App Bundle 示例项目安装与使用指南

Android App Bundle 示例项目安装与使用指南

本指南旨在帮助开发者快速理解并上手由Google提供的App Bundle示例项目。我们将通过分析其目录结构、启动文件以及配置文件来展开。

1. 项目目录结构及介绍

目录结构概览

app-bundle-samples/
├── AddOnsAndSplitCompat
│   ├── app
│   └── ...
├── AssetDelivery
│   ├── dynamic-feature-module
│   └── app
├── ...
└── WelcomeScreenFeature
    ├── dynamic-feature-module
    └── app

说明:

• AddOnsAndSplitCompat: 展示如何在应用中添加额外组件并保持兼容性。
• AssetDelivery: 介绍资产分发的不同策略，如即时加载和按需加载模块。
• ... (其他模块): 每个子目录代表一个独立的主题或功能模块，其中通常包含至少一个动态功能模块(Dynamic Feature Module)和一个宿主应用(app)部分。
• dynamic-feature-module: 存放动态功能模块的代码和资源。
• app: 宿主应用的代码和资源，负责整合各个功能模块。

2. 项目的启动文件介绍

主应用入口

对于大多数模块，宿主应用(app)中的MainActivity往往是启动点。例如，在基础的项目中，这通常位于app/src/main/java/your/domain/MainActivity.java。它负责初始化应用界面，可能还包括对动态功能模块加载的管理逻辑。由于项目结构多样，具体文件路径和名称可能有所不同，但核心职责相似：

package com.example.yourproject;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 可能包括动态功能模块的处理逻辑
    }
}

动态功能模块的接入

动态功能模块的“启动”更多是逻辑上的启动，它们并不直接作为应用的入口。模块被下载并激活后，通过宿主应用调用相关服务或Activity来实现功能。

3. 项目的配置文件介绍

build.gradle（Module级别）

每个模块下的build.gradle文件定义了构建规则，包括模块类型（是否为动态功能模块）、依赖库等。例如，在一个动态特征模块中，你会看到如下配置指明其身份：

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

android {
    // 配置详情...
}

dependencies {
    implementation project(':app') // 或其他依赖项
}

build.gradle（Project级别）

位于项目根目录的build.gradle文件，用于全局配置，比如插件版本、仓库设置等。

manifest.xml

• App Manifest (app/src/main/AndroidManifest.xml): 包含应用程序的基本信息，活动、服务和接收器的声明，权限需求等。
• Feature Manifest: 每个动态功能模块也有自己的AndroidManifest.xml，仅声明该模块特有的组件和服务，系统将这些信息与主应用的清单合并。

每份AndroidManifest.xml都是了解模块功能、所需权限和启动Activity的关键。

---

以上是对App Bundle 示例项目的基本剖析。深入学习每个模块时，建议参考各自模块内的README文件，以获得更详细的信息和特定指导。