├── .gitignore ├── CONTRIBUTING.md ├── LICENSE ├── NOTICE ├── README.markdown ├── app ├── .gitignore ├── build.gradle ├── proguard-rules.pro └── src │ └── main │ ├── AndroidManifest.xml │ ├── java │ └── com │ │ └── google │ │ └── android │ │ └── samples │ │ └── dynamicfeatures │ │ ├── BaseSplitActivity.kt │ │ └── MainActivity.kt │ └── res │ ├── drawable-v24 │ └── ic_launcher_foreground.xml │ ├── drawable │ └── ic_launcher_background.xml │ ├── layout │ └── activity_main.xml │ ├── mipmap-anydpi-v26 │ ├── ic_launcher.xml │ └── ic_launcher_round.xml │ ├── mipmap-hdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-mdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xxhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xxxhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ └── values │ ├── colors.xml │ ├── feature_names.xml │ ├── strings.xml │ └── styles.xml ├── build.gradle ├── features ├── assets │ ├── .gitignore │ ├── build.gradle │ ├── proguard-rules.pro │ └── src │ │ └── main │ │ ├── AndroidManifest.xml │ │ └── assets │ │ └── assets.txt ├── java │ ├── .gitignore │ ├── build.gradle │ ├── proguard-rules.pro │ └── src │ │ └── main │ │ ├── AndroidManifest.xml │ │ ├── java │ │ └── com │ │ │ └── google │ │ │ └── android │ │ │ └── samples │ │ │ └── dynamicfeatures │ │ │ └── ondemand │ │ │ └── JavaSampleActivity.java │ │ └── res │ │ ├── layout │ │ └── activity_feature_java.xml │ │ └── values │ │ └── strings.xml ├── kotlin │ ├── .gitignore │ ├── build.gradle │ ├── proguard-rules.pro │ └── src │ │ └── main │ │ ├── AndroidManifest.xml │ │ ├── java │ │ └── com │ │ │ └── google │ │ │ └── android │ │ │ └── samples │ │ │ └── dynamicfeatures │ │ │ └── ondemand │ │ │ └── KotlinSampleActivity.kt │ │ └── res │ │ ├── layout │ │ └── activity_feature_kotlin.xml │ │ └── values │ │ └── strings.xml └── native │ ├── .gitignore │ ├── build.gradle │ ├── proguard-rules.pro │ └── src │ └── main │ ├── AndroidManifest.xml │ ├── cpp │ ├── CMakeLists.txt │ └── hello-jni.c │ ├── java │ └── com │ │ └── google │ │ └── android │ │ └── samples │ │ └── dynamicfeatures │ │ └── ondemand │ │ └── NativeSampleActivity.kt │ └── res │ └── layout │ └── activity_hello_jni.xml ├── gradle.properties ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── graphic_assets ├── feature.png ├── icon.png ├── promo.png ├── screenshot-1.png └── screenshot-2.png ├── screenshots └── main.png └── settings.gradle /.gitignore: -------------------------------------------------------------------------------- 1 | *.iml 2 | .gradle 3 | /local.properties 4 | /.idea/libraries 5 | /.idea/modules.xml 6 | /.idea/workspace.xml 7 | /.idea 8 | .DS_Store 9 | /build 10 | /captures 11 | .externalNativeBuild 12 | release 13 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # How to become a contributor and submit your own code 2 | 3 | ## Contributor License Agreements 4 | 5 | We'd love to accept your sample apps and patches! Before we can take them, we 6 | have to jump a couple of legal hurdles. 7 | 8 | Please fill out either the individual or corporate Contributor License Agreement (CLA). 9 | 10 | * If you are an individual writing original source code and you're sure you 11 | own the intellectual property, then you'll need to sign an [individual CLA] 12 | (https://developers.google.com/open-source/cla/individual). 13 | * If you work for a company that wants to allow you to contribute your work, 14 | then you'll need to sign a [corporate CLA] 15 | (https://developers.google.com/open-source/cla/corporate). 16 | 17 | Follow either of the two links above to access the appropriate CLA and 18 | instructions for how to sign and return it. Once we receive it, we'll be able to 19 | accept your pull requests. 20 | 21 | ## Contributing A Patch 22 | 23 | 1. Submit an issue describing your proposed change to the repo in question. 24 | 1. The repo owner will respond to your issue promptly. 25 | 1. If your proposed change is accepted, and you haven't already done so, sign a 26 | Contributor License Agreement (see details above). 27 | 1. Fork the desired repo, develop and test your code changes. 28 | 1. Ensure that your code adheres to the existing style in the sample to which 29 | you are contributing. Refer to the 30 | [Android Code Style Guide] 31 | (https://source.android.com/source/code-style.html) for the 32 | recommended coding standards for this organization. 33 | 1. Ensure that your code has an appropriate set of unit tests which all pass. 34 | 1. Submit a pull request. 35 | 36 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright 2018 Google LLC. 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /NOTICE: -------------------------------------------------------------------------------- 1 | This sample uses the following software: 2 | 3 | Copyright 2018 Google LLC. 4 | 5 | Licensed under the Apache License, Version 2.0 (the "License"); 6 | you may not use this file except in compliance with the License. 7 | You may obtain a copy of the License at 8 | 9 | http://www.apache.org/licenses/LICENSE-2.0 10 | 11 | Unless required by applicable law or agreed to in writing, software 12 | distributed under the License is distributed on an "AS IS" BASIS, 13 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 | See the License for the specific language governing permissions and 15 | limitations under the License. 16 | -------------------------------------------------------------------------------- /README.markdown: -------------------------------------------------------------------------------- 1 | # 🛑 This codelab is deprecated and will be removed soon 🛑 2 | 3 | # On-Demand modules codelab 4 | 5 | This is the code repository for the [Android On-Demand modules 6 | codelab](https://codelabs.developers.google.com) 7 | 8 | Read more at http://g.co/androidappbundle 9 | 10 | ## Introduction 11 | 12 | The sample contains several modules. 13 | 14 | ## Screenshots 15 | 16 | 17 | 18 | 19 | ## Getting Started 20 | 21 | Clone this repository, enter the top level directory and run ./gradlew tasks 22 | to get an overview of all the tasks available for this project. 23 | 24 | ## License 25 | 26 | ``` 27 | Copyright 2018 Google LLC. 28 | 29 | Licensed to the Apache Software Foundation (ASF) under one or more contributor 30 | license agreements. See the NOTICE file distributed with this work for 31 | additional information regarding copyright ownership. The ASF licenses this 32 | file to you under the Apache License, Version 2.0 (the "License"); you may not 33 | use this file except in compliance with the License. You may obtain a copy of 34 | the License at 35 | 36 | http://www.apache.org/licenses/LICENSE-2.0 37 | 38 | Unless required by applicable law or agreed to in writing, software 39 | distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 40 | WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the 41 | License for the specific language governing permissions and limitations under 42 | the License. 43 | ``` 44 | -------------------------------------------------------------------------------- /app/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /app/build.gradle: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright 2018 Google LLC. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | apply plugin: 'com.android.application' 18 | apply plugin: 'kotlin-android' 19 | 20 | android { 21 | 22 | compileSdkVersion versions.compileSdk 23 | 24 | defaultConfig { 25 | applicationId names.applicationId 26 | minSdkVersion versions.minSdk 27 | targetSdkVersion versions.targetSdk 28 | versionCode 1 29 | versionName "1.0" 30 | } 31 | 32 | buildTypes { 33 | debug {} 34 | release { 35 | minifyEnabled true 36 | } 37 | } 38 | 39 | compileOptions { 40 | sourceCompatibility = '1.8' 41 | targetCompatibility = '1.8' 42 | } 43 | 44 | dynamicFeatures = [':assets', 45 | ':kotlin', 46 | ':java', 47 | ':native'] 48 | 49 | } 50 | 51 | dependencies { 52 | // Libraries which can be re-used in other modules should use the `api` keyword. 53 | // This way they can be shared with dependent feature modules. 54 | 55 | implementation 'androidx.annotation:annotation:1.3.0' 56 | implementation 'androidx.appcompat:appcompat:1.4.0' 57 | implementation 'androidx.constraintlayout:constraintlayout:2.1.2' 58 | api 'com.google.android.material:material:1.4.0' 59 | api "com.google.android.play:core:${versions.playcore}" 60 | } 61 | -------------------------------------------------------------------------------- /app/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # You can control the set of applied configuration files using the 3 | # proguardFiles setting in build.gradle. 4 | # 5 | # For more details, see 6 | # http://developer.android.com/guide/developing/tools/proguard.html 7 | 8 | # If your project uses WebView with JS, uncomment the following 9 | # and specify the fully qualified class name to the JavaScript interface 10 | # class: 11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 12 | # public *; 13 | #} 14 | 15 | # Uncomment this to preserve the line number information for 16 | # debugging stack traces. 17 | #-keepattributes SourceFile,LineNumberTable 18 | 19 | # If you keep the line number information, uncomment this to 20 | # hide the original source file name. 21 | #-renamesourcefileattribute SourceFile 22 | -------------------------------------------------------------------------------- /app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 20 | 21 | 29 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | -------------------------------------------------------------------------------- /app/src/main/java/com/google/android/samples/dynamicfeatures/BaseSplitActivity.kt: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright 2018 Google LLC. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.google.android.samples.dynamicfeatures 18 | 19 | import android.content.Context 20 | import androidx.appcompat.app.AppCompatActivity 21 | import com.google.android.play.core.splitcompat.SplitCompat 22 | 23 | /** 24 | * This base activity unifies calls to attachBaseContext as described in: 25 | * https://developer.android.com/guide/app-bundle/playcore#invoke_splitcompat_at_runtime 26 | */ 27 | abstract class BaseSplitActivity : AppCompatActivity() { 28 | 29 | override fun attachBaseContext(newBase: Context?) { 30 | super.attachBaseContext(newBase) 31 | SplitCompat.installActivity(this) 32 | } 33 | 34 | } 35 | -------------------------------------------------------------------------------- /app/src/main/java/com/google/android/samples/dynamicfeatures/MainActivity.kt: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright 2018 Google LLC. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | 17 | package com.google.android.samples.dynamicfeatures 18 | 19 | import android.content.Intent 20 | import android.os.Bundle 21 | import android.util.Log 22 | import android.view.View 23 | import android.widget.ProgressBar 24 | import android.widget.TextView 25 | import android.widget.Toast 26 | import androidx.appcompat.app.AlertDialog 27 | import androidx.appcompat.app.AppCompatActivity 28 | import androidx.constraintlayout.widget.Group 29 | import com.google.android.play.core.splitinstall.SplitInstallManager 30 | import com.google.android.play.core.splitinstall.SplitInstallManagerFactory 31 | import com.google.android.play.core.splitinstall.SplitInstallRequest 32 | import com.google.android.play.core.splitinstall.SplitInstallSessionState 33 | import com.google.android.play.core.splitinstall.SplitInstallStateUpdatedListener 34 | import com.google.android.play.core.splitinstall.model.SplitInstallSessionStatus 35 | 36 | private const val packageName = "com.google.android.samples.dynamicfeatures.ondemand" 37 | private const val kotlinSampleClassname = "$packageName.KotlinSampleActivity" 38 | private const val javaSampleClassname = "$packageName.JavaSampleActivity" 39 | private const val nativeSampleClassname = "$packageName.NativeSampleActivity" 40 | 41 | /** Activity that displays buttons and handles loading of feature modules. */ 42 | class MainActivity : AppCompatActivity() { 43 | 44 | /** Listener used to handle changes in state for install requests. */ 45 | private val listener = SplitInstallStateUpdatedListener { state -> 46 | val multiInstall = state.moduleNames().size > 1 47 | val names = state.moduleNames().joinToString(" - ") 48 | when (state.status()) { 49 | SplitInstallSessionStatus.DOWNLOADING -> { 50 | // In order to see this, the application has to be uploaded to the Play Store. 51 | displayLoadingState(state, "Downloading $names") 52 | } 53 | SplitInstallSessionStatus.REQUIRES_USER_CONFIRMATION -> { 54 | /* 55 | This may occur when attempting to download a sufficiently large module. 56 | 57 | In order to see this, the application has to be uploaded to the Play Store. 58 | Then features can be requested until the confirmation path is triggered. 59 | */ 60 | startIntentSender(state.resolutionIntent()?.intentSender, null, 0, 0, 0) 61 | } 62 | SplitInstallSessionStatus.INSTALLED -> { 63 | onSuccessfulLoad(names, launch = !multiInstall) 64 | } 65 | 66 | SplitInstallSessionStatus.INSTALLING -> displayLoadingState(state, "Installing $names") 67 | SplitInstallSessionStatus.FAILED -> { 68 | toastAndLog("Error: ${state.errorCode()} for module ${state.moduleNames()}") 69 | } 70 | } 71 | } 72 | 73 | private val moduleKotlin by lazy { getString(R.string.module_feature_kotlin) } 74 | private val moduleJava by lazy { getString(R.string.module_feature_java) } 75 | private val moduleNative by lazy { getString(R.string.module_native) } 76 | private val moduleAssets by lazy { getString(R.string.module_assets) } 77 | 78 | private val clickListener by lazy { 79 | View.OnClickListener { 80 | when (it.id) { 81 | R.id.btn_load_kotlin -> loadAndLaunchModule(moduleKotlin) 82 | R.id.btn_load_java -> loadAndLaunchModule(moduleJava) 83 | R.id.btn_load_native -> loadAndLaunchModule(moduleNative) 84 | R.id.btn_load_assets -> loadAndLaunchModule(moduleAssets) 85 | R.id.btn_install_all_now -> installAllFeaturesNow() 86 | R.id.btn_install_all_deferred -> installAllFeaturesDeferred() 87 | R.id.btn_request_uninstall -> requestUninstall() 88 | } 89 | } 90 | } 91 | 92 | private lateinit var manager: SplitInstallManager 93 | 94 | private lateinit var progress: Group 95 | private lateinit var buttons: Group 96 | private lateinit var progressBar: ProgressBar 97 | private lateinit var progressText: TextView 98 | 99 | override fun onCreate(savedInstanceState: Bundle?) { 100 | super.onCreate(savedInstanceState) 101 | setContentView(R.layout.activity_main) 102 | 103 | manager = SplitInstallManagerFactory.create(this) 104 | 105 | initializeViews() 106 | } 107 | 108 | override fun onResume() { 109 | // Listener can be registered even without directly triggering a download. 110 | manager.registerListener(listener) 111 | super.onResume() 112 | } 113 | 114 | override fun onPause() { 115 | // Make sure to dispose of the listener once it's no longer needed. 116 | manager.unregisterListener(listener) 117 | super.onPause() 118 | } 119 | 120 | /** 121 | * Load a feature by module name. 122 | * @param name The name of the feature module to load. 123 | */ 124 | private fun loadAndLaunchModule(name: String) { 125 | updateProgressMessage("Loading module $name") 126 | // Skip loading if the module already is installed. Perform success action directly. 127 | if (manager.installedModules.contains(name)) { 128 | updateProgressMessage("Already installed") 129 | onSuccessfulLoad(name, launch = true) 130 | return 131 | } 132 | 133 | // Create request to install a feature module by name. 134 | val request = SplitInstallRequest.newBuilder() 135 | .addModule(name) 136 | .build() 137 | 138 | // Load and install the requested feature module. 139 | manager.startInstall(request) 140 | 141 | updateProgressMessage("Starting install for $name") 142 | } 143 | 144 | /** Display assets loaded from the assets feature module. */ 145 | private fun displayAssets() { 146 | // Get the asset manager with a refreshed context, to access content of newly installed apk. 147 | val assetManager = createPackageContext(packageName, 0).assets 148 | // Now treat it like any other asset file. 149 | val assets = assetManager.open("assets.txt") 150 | val assetContent = assets.bufferedReader() 151 | .use { 152 | it.readText() 153 | } 154 | 155 | AlertDialog.Builder(this) 156 | .setTitle("Asset content") 157 | .setMessage(assetContent) 158 | .show() 159 | } 160 | 161 | /** Install all features but do not launch any of them. */ 162 | private fun installAllFeaturesNow() { 163 | // Request all known modules to be downloaded in a single session. 164 | val moduleNames = listOf(moduleKotlin, moduleJava, moduleNative, moduleAssets) 165 | val requestBuilder = SplitInstallRequest.newBuilder() 166 | 167 | moduleNames.forEach { name -> 168 | if (!manager.installedModules.contains(name)) { 169 | requestBuilder.addModule(name) 170 | } 171 | } 172 | 173 | val request = requestBuilder.build() 174 | 175 | manager.startInstall(request).addOnSuccessListener { 176 | toastAndLog("Loading ${request.moduleNames}") 177 | }.addOnFailureListener { 178 | toastAndLog("Failed loading ${request.moduleNames}") 179 | } 180 | } 181 | 182 | /** Install all features deferred. */ 183 | private fun installAllFeaturesDeferred() { 184 | 185 | val modules = listOf(moduleKotlin, moduleJava, moduleAssets, moduleNative) 186 | 187 | manager.deferredInstall(modules).addOnSuccessListener { 188 | toastAndLog("Deferred installation of $modules") 189 | }.addOnFailureListener { 190 | toastAndLog("Failed installation of $modules") 191 | } 192 | } 193 | 194 | /** Request uninstall of all features. */ 195 | private fun requestUninstall() { 196 | 197 | toastAndLog("Requesting uninstall of all modules." + 198 | "This will happen at some point in the future.") 199 | 200 | val installedModules = manager.installedModules.toList() 201 | manager.deferredUninstall(installedModules).addOnSuccessListener { 202 | toastAndLog("Uninstalling $installedModules") 203 | } 204 | } 205 | 206 | /** 207 | * Define what to do once a feature module is loaded successfully. 208 | * @param moduleName The name of the successfully loaded module. 209 | * @param launch `true` if the feature module should be launched, else `false`. 210 | */ 211 | private fun onSuccessfulLoad(moduleName: String, launch: Boolean) { 212 | if (launch) { 213 | when (moduleName) { 214 | moduleKotlin -> launchActivity(kotlinSampleClassname) 215 | moduleJava -> launchActivity(javaSampleClassname) 216 | moduleNative -> launchActivity(nativeSampleClassname) 217 | moduleAssets -> displayAssets() 218 | } 219 | } 220 | 221 | displayButtons() 222 | } 223 | 224 | /** Launch an activity by its class name. */ 225 | private fun launchActivity(className: String) { 226 | Intent().setClassName(packageName, className) 227 | .also { 228 | startActivity(it) 229 | } 230 | } 231 | 232 | 233 | /** Display a loading state to the user. */ 234 | private fun displayLoadingState(state: SplitInstallSessionState, message: String) { 235 | displayProgress() 236 | 237 | progressBar.max = state.totalBytesToDownload().toInt() 238 | progressBar.progress = state.bytesDownloaded().toInt() 239 | 240 | updateProgressMessage(message) 241 | } 242 | 243 | /** Set up all view variables. */ 244 | private fun initializeViews() { 245 | buttons = findViewById(R.id.buttons) 246 | progress = findViewById(R.id.progress) 247 | progressBar = findViewById(R.id.progress_bar) 248 | progressText = findViewById(R.id.progress_text) 249 | 250 | setupClickListener() 251 | } 252 | 253 | /** Set all click listeners required for the buttons on the UI. */ 254 | private fun setupClickListener() { 255 | 256 | setClickListener(R.id.btn_load_kotlin, clickListener) 257 | setClickListener(R.id.btn_load_java, clickListener) 258 | setClickListener(R.id.btn_load_assets, clickListener) 259 | setClickListener(R.id.btn_load_native, clickListener) 260 | setClickListener(R.id.btn_install_all_now, clickListener) 261 | setClickListener(R.id.btn_install_all_deferred, clickListener) 262 | setClickListener(R.id.btn_request_uninstall, clickListener) 263 | } 264 | 265 | private fun setClickListener(id: Int, listener: View.OnClickListener) { 266 | findViewById(id).setOnClickListener(listener) 267 | } 268 | 269 | private fun updateProgressMessage(message: String) { 270 | if (progress.visibility != View.VISIBLE) displayProgress() 271 | progressText.text = message 272 | } 273 | 274 | /** Display progress bar and text. */ 275 | private fun displayProgress() { 276 | progress.visibility = View.VISIBLE 277 | buttons.visibility = View.GONE 278 | } 279 | 280 | /** Display buttons to accept user input. */ 281 | private fun displayButtons() { 282 | progress.visibility = View.GONE 283 | buttons.visibility = View.VISIBLE 284 | } 285 | } 286 | 287 | fun MainActivity.toastAndLog(text: String) { 288 | Toast.makeText(this, text, Toast.LENGTH_LONG).show() 289 | Log.d(TAG, text) 290 | } 291 | 292 | private const val TAG = "DynamicFeatures" 293 | -------------------------------------------------------------------------------- /app/src/main/res/drawable-v24/ic_launcher_foreground.xml: -------------------------------------------------------------------------------- 1 | 16 | 17 | 23 | 28 | 29 | 35 | 38 | 41 | 42 | 43 | 44 | 50 | 51 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/ic_launcher_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 17 | 18 | 23 | 26 | 31 | 36 | 41 | 46 | 51 | 56 | 61 | 66 | 71 | 76 | 81 | 86 | 91 | 96 | 101 | 106 | 111 | 116 | 121 | 126 | 131 | 136 | 141 | 146 | 151 | 156 | 161 | 166 | 171 | 176 | 181 | 186 | 187 | -------------------------------------------------------------------------------- /app/src/main/res/layout/activity_main.xml: -------------------------------------------------------------------------------- 1 | 16 | 17 | 23 | 24 | 37 | 38 |