Android即时应用示例项目指南

Android即时应用示例项目指南

android-instant-apps Migrated: 项目地址: https://gitcode.com/gh_mirrors/an/android-instant-apps

1. 目录结构及介绍

本指南基于已归档的 googlearchive/android-instant-apps 开源项目，该项目旨在提供Android即时应用的示例代码。请注意，此仓库已迁移至 github.com/android/app-bundle，以获取最新的更新和文档，请参考新位置。

主要目录结构：

• aab-simple: 示例展示了如何创建一个基础的App Bundle。
• analytics: 包含了集成分析的示例。
• cookie-api: 展示如何处理Cookie在即时应用中的使用。
• hello-kotlin: 用Kotlin编写的简单即时应用实例。
• install-api: 关于安装API的示例。
• multi-feature-module: 多特性模块的使用案例。
• service: 即时应用中服务的实现范例。
• storage-api: 存储API的使用方法。
• urlless: 不通过URL触发的即时应用示例。

每个子目录通常包含以下组件：

• src: 源代码文件夹，按模块或组件组织。
• res: 资源文件夹，包括图像、布局等。
• build.gradle: 构建脚本，定义构建规则。
• 可能还会包含manifest.xml用于声明应用组件和权限。

2. 启动文件介绍

在Android即时应用中，没有单一的“启动文件”概念，因为它们通常由多个模块组成，每个模块有自己的入口点。然而，主要的启动逻辑往往在功能模块的Activity中定义，特别是那些被设计为首次交互界面的模块。例如，在hello-kotlin或任何具有用户交互初始屏幕的子项目中，你会找到对应的MainActivity.kt或MainActivity.java。

3. 项目的配置文件介绍

build.gradle

项目根目录和各个模块下的build.gradle文件是关键的配置文件，它们定义了项目构建配置，依赖项，以及是否支持即时应用功能。在根目录下，你会看到项目的版本控制信息，全局的插件版本设置等。在每个模块的build.gradle中，如以下简化示例：

apply plugin: 'com.android.feature'

android {
    compileSdkVersion <version>
    
    defaultConfig {
        minSdkVersion <minSdk>
        targetSdkVersion <targetSdk>
        versionCode <versionCode>
        versionName <versionName>

        // 必须为feature module启用instantAppSupport
        instantRun {
            enabled true
        }
    }

    dependencies {
        implementation project(':common')
        implementation 'com.android.support:appcompat-v7:<version>'
    }
}

AndroidManifest.xml

位于各模块的根目录，它定义了应用组件（如活动、服务），权限需求，以及对模块特性的声明。对于即时应用，可能还包含了 <dist:module> 标签来指定该模块作为即时体验的一部分。

例如：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:dist="http://schemas.android.com/apk/distribution">

    <application>
        <!-- 其他组件声明 -->

        <activity android:name=".MainActivity">
            <!-- 入口点 -->
        </activity>

        <dist:module dist:instant="true" />
    </application>
</manifest>

请注意，上述例子和解释基于项目归档时的状态，并且由于项目已迁移，具体实现细节可能有所变化。务必参考新仓库中的最新实践和技术文档。

android-instant-apps Migrated: 项目地址: https://gitcode.com/gh_mirrors/an/android-instant-apps