IAPMiniProgram SDK designs a unified module dynamic delivery solution that allows the super app to download and install the required modules on demands to run your application. In order to enhance the performance and rendering capability of mini programs, MYWeb module/dynamic feature is supported

Integration ways

To realize the MYWeb feature, you can choose one of the following integrations ways. But it's highly recommended to use the Dynamic integration way.

1. Static integration: The direct dependency is in the project, which is packaged into the APK along with the project.
2. Dynamic integration: Based on Google Dynamic Feature capability, download the APK from the Google Play Store when the application is opened. This can reduce the APK size when downloading and improve users' downloading experience.

Static integration

In the build.gradle file of the project app, add the iapminiprogram-myweb dependency as the following code sample:

dependencies {
    implementation "com.alipay.plus.android:iapminiprogram-myweb:{iapminiprogram_version}"
}

Note: Check the latest iapminiprogram_version version in the Android Release Notes.

Dynamic integration

Prerequisite

Make sure that the module name (supporting the MYWeb feature) is mywebdynamicfeature.

Step 1. Create the mywebdynamicfeature dynamic module

1. In your project, click Create new module > Dynamic Feature to start creating a new module. (see the following figure）
2. Choose the Base Application Module properly.
3. Fill in the module name.

3. Fill in the Module title (see the following figure). By default, "MyWeb Dynamic Feature" is used.

4. Note: In the Install-time inclusion drop-down list, choose (on-deman only).
5. Click Finish to finish creating the mywebdynamicfeature module.

Step 2. Confirm the correctness of the AndroidManifest file

The default configurations in the AndroidManifest file are generated by the system. There is no need to make any changes in this file. You just need to check and confirm the correctness of the file.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:dist="http://schemas.android.com/apk/distribution">

  <dist:module
    dist:instant="false"
    dist:title="@string/title_mywebdynamicfeature">
    <dist:delivery>
      <dist:on-demand />
    </dist:delivery>
    <dist:fusing dist:include="true" />
  </dist:module>
</manifest>

Step 3. Confirm the dynamic repository is imported into the main module

In the build.gradle file of the project app, the system generates the following code by default. (This is because you choose the Base Application Module in Step 1.)

android {
    dynamicFeatures = [':mywebdynamicfeature']
}

In order to make the mywebdynamicfeature dynamic module take effects, must add the following codes in the build.gradle file：

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

Step 4. Import the dependency to support the dynamic feature

Import the dependency in the following files:

1. In the build.gradle file of the project app, add the following codes to import the iapminiprogram-dynamic-feature dependency:

dependencies {
    implementation "com.alipay.plus.android:iapminiprogram-dynamic-feature:${iapminiprogram_version}"
}

2. In the build.gradle file of the dynamic module, add the following codes to import the iapminiprogram-myweb dependency.

dependencies {
    implementation "com.alipay.plus.android:iapminiprogram-myweb:${iapminiprogram_version}"
}

Note: Check the latest iapminiprogram_version version in the Android Release Notes.

Step 5. Configure to use the SplitCompat tool

In order to use the SplitCompat tool, need to finish the following configurations:

1. In the build.gradle file of the project app, add the following codes to import dependencies accordingly:

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:feature-delivery:2.1.0'

    // For Kotlin users, also add the Kotlin extensions library for Play Feature Delivery:
    implementation 'com.google.android.play:feature-delivery-ktx:2.1.0'
    ...
}

2. Turn on the SplitCompat in your application based on different cases.

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        SplitCompat.install(this);
    }
}

public class MyApplication extends SplitCompatApplication {
    ...
}

Next steps

Configure the authorization code

After you integrate the MyWeb module/dynamic feature:

1. You need to provide the package name of your application and SHA256 signature.
   We will provide you with the authorization code for MYWeb accordingly.
2. Then in the Android project, you need to configure the authorization code for release and debug in the AndroidManifest.xml file and the build.gradle file. Refer to the following code sample：

AndroidManifest.xml file:

    <application>
      <!-- configure ${activation_code} placeholder -->
      <meta-data
            android:name="com.alipay.myweb.init.ACTIVATION_CODES"
            android:value="${activation_code}"/>
    </application>

build.gradle file:

android {
    buildTypes {
        release {
            /* configure the Release activation_code */
            manifestPlaceholders = [
                    activation_code: "mg*****...="
            ]
        }
        debug {
            /* configure the Debug activation_code*/
            manifestPlaceholders = [
                    activation_code: "4X*****...=="
            ]
        }
    }
}

Note:

• If the authorization code is incorrect, MYWeb module/dynamic feature will not be enabled and will automatically fall back to the system web view (webview).
• If you have multiple signatures and package names, need to configure the authorization code based on the different environment accordingly.