app-bundle-samples进阶使用SplitInstallManager管理动态功能模块加载的终极指南【免费下载链接】app-bundle-samplesMultiple samples showing the best practices in app bundles on Android.项目地址: https://gitcode.com/gh_mirrors/ap/app-bundle-samplesAndroid App Bundle 动态功能模块是现代应用开发中的强大功能而 SplitInstallManager 则是管理这些模块加载的核心工具。本文将为您深入解析如何在 Android 应用中高效使用 SplitInstallManager 管理动态功能模块加载帮助您掌握这一关键技术。 什么是 SplitInstallManagerSplitInstallManager 是 Android Play Core 库提供的核心 API专门用于管理动态功能模块的安装、卸载和状态监控。通过它开发者可以在运行时按需加载功能模块从而显著减小应用的初始安装大小提升用户体验。在 app-bundle-samples 项目中SplitInstallManager 被广泛应用于各个示例中展示了如何优雅地管理动态模块的生命周期。 动态功能模块加载的核心流程1. 初始化 SplitInstallManager初始化是使用 SplitInstallManager 的第一步。在 MainActivity.kt 中我们可以看到标准的初始化方式private lateinit var manager: SplitInstallManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) manager SplitInstallManagerFactory.create(this) initializeViews() }2. 状态监听器注册与注销为了实时监控模块安装状态需要注册状态监听器。在 AbstractMainViewModel.kt 中展示了最佳实践init { splitInstallManager.registerListener(listener) } override fun onCleared() { splitInstallManager.unregisterListener(listener) super.onCleared() } 模块安装的三种模式即时安装模式即时安装是最常用的模式用户请求后立即开始下载和安装。在 MainActivity.kt 中的实现private fun loadAndLaunchModule(name: String) { if (manager.installedModules.contains(name)) { onSuccessfulLoad(name, launch true) return } val request SplitInstallRequest.newBuilder() .addModule(name) .build() manager.startInstall(request) }延迟安装模式延迟安装允许在后台静默安装模块不干扰用户体验。这在 MainActivity.kt 中有示例private fun installAllFeaturesDeferred() { manager.deferredInstall(installableModules).addOnSuccessListener { toastAndLog(Deferred installation of $installableModules) } }条件安装模式基于设备条件的智能安装如根据 SDK 版本决定是否安装特定模块。在 MainActivity.kt 中展示了 maxSdk 条件模块的处理。 状态管理与错误处理状态监听器实现状态监听器是处理安装过程的关键。在 MainActivity.kt 中完整的监听器实现涵盖了所有状态private val listener SplitInstallStateUpdatedListener { state - when (state.status()) { SplitInstallSessionStatus.DOWNLOADING - { displayLoadingState(state, getString(R.string.downloading, names)) } SplitInstallSessionStatus.REQUIRES_USER_CONFIRMATION - { manager.startConfirmationDialogForResult(state, this, CONFIRMATION_REQUEST_CODE) } SplitInstallSessionStatus.INSTALLED - { onSuccessfulLoad(names, launch !multiInstall) } SplitInstallSessionStatus.INSTALLING - { displayLoadingState(state, getString(R.string.installing, names)) } SplitInstallSessionStatus.FAILED - { toastAndLog(getString(R.string.error_for_module, state.errorCode(), state.moduleNames())) } } }进度显示与用户反馈在 MainActivity.kt 中展示了如何向用户显示下载进度private fun displayLoadingState(state: SplitInstallSessionState, message: String) { displayProgress() progressBar.max state.totalBytesToDownload().toInt() progressBar.progress state.bytesDownloaded().toInt() updateProgressMessage(message) } 多语言模块管理SplitInstallManager 不仅支持功能模块还能管理语言资源模块。在 MainActivity.kt 中展示了语言模块的加载private fun loadAndSwitchLanguage(lang: String) { if (manager.installedLanguages.contains(lang)) { onSuccessfulLanguageLoad(lang) return } val request SplitInstallRequest.newBuilder() .addLanguage(Locale.forLanguageTag(lang)) .build() manager.startInstall(request) } 批量操作与资源管理批量安装多个模块在 MainActivity.kt 中展示了如何一次性安装多个模块private fun installAllFeaturesNow() { val requestBuilder SplitInstallRequest.newBuilder() installableModules.forEach { name - if (!manager.installedModules.contains(name)) { requestBuilder.addModule(name) } } val request requestBuilder.build() manager.startInstall(request) }模块卸载管理延迟卸载功能可以帮助清理不再需要的模块。在 MainActivity.kt 中private fun requestUninstall() { val installedModules manager.installedModules.toList() manager.deferredUninstall(installedModules).addOnSuccessListener { toastAndLog(Uninstalling $installedModules) } } 高级功能与最佳实践1. 资源访问优化动态模块安装后需要正确访问其中的资源。在 MainActivity.kt 中展示了如何访问动态模块中的资产private fun displayAssets() { val assetManager createPackageContext(packageName, 0).also { SplitCompat.install(it) }.assets val assetsStream assetManager.open(assets.txt) val assetContent assetsStream.bufferedReader().use { it.readText() } }2. ViewModel 集成在 AbstractMainViewModel.kt 中展示了如何在 ViewModel 中集成 SplitInstallManagerprivate fun requestStorageInstall() { val request SplitInstallRequest.newBuilder() .addModule(storage) .build() splitInstallManager.startInstall(request) .addOnSuccessListener { id - sessionId id } .addOnFailureListener { exception - Log.e(TAG, Error installing module: , exception) } } 测试与调试技巧本地测试配置使用 FakeSplitInstallManager 和 bundletool 进行本地测试bundletool build-apks --local-testing --bundlepath_to_aab --outputpath_to_apks bundletool install-apks --apkspath_to_apks状态监控与日志在 MainActivity.kt 中提供了统一的日志和 Toast 工具fun MainActivity.toastAndLog(text: String) { Toast.makeText(this, text, Toast.LENGTH_LONG).show() Log.d(TAG, text) } 总结通过 app-bundle-samples 项目的实际示例我们深入了解了 SplitInstallManager 的强大功能。从基础初始化到高级状态管理从单个模块加载到批量操作SplitInstallManager 为 Android 动态功能模块提供了完整的管理解决方案。关键要点按需加载显著减小应用初始大小灵活管理支持即时、延迟和条件安装状态监控完整的安装状态跟踪资源访问无缝访问动态模块资源错误处理完善的异常处理机制掌握 SplitInstallManager 的使用将帮助您构建更加灵活、高效的 Android 应用为用户提供更好的体验。立即开始克隆项目仓库运行./gradlew tasks查看所有可用任务亲身体验动态功能模块的强大功能【免费下载链接】app-bundle-samplesMultiple samples showing the best practices in app bundles on Android.项目地址: https://gitcode.com/gh_mirrors/ap/app-bundle-samples创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考