Kernel version upgrade

Updated at:

Lists the available Cube kernel versions and describes how to upgrade your project to a newer kernel version.

Version list

Version Number

Minor Version

Corresponding Version Information

Changelog

Notes

10.2.90

Main baseline version

Main baseline version

First-generation Cube kernel version with basic features.

No upgrade required. This is the default version for the main baseline.

10.7.30 (beta)

20251105

Rendering engine:

com.mpaas.cube.adapter:cubeadapter-build:1.0.0.250923200615

com.mpaas.cube.sdk:cubesdk-build:1.0.0.251104172537

Debug library:

com.mpaas.cubedebug.sdk:cubedebug-build:1.0.0.251106163849

10.7.30 upgrade

  • Adds support for components.

  • Includes Alipay synchronization upgrades and bug fixes.

Kernel version upgrade

  • Use the main baseline for the mPaaS baseline.

  • Set the kernel version to the version you want to use.

Set the baseline in the project's build.gradle file.

buildscript {
	···
	ext.mpaas_artifact = "mpaas-baseline"
	ext.mpaas_baseline = "10.2.3-72" // Use the latest main baseline version.
	···
}

Set the kernel version in the module's build.gradle file.

dependencies {
	  ···
    implementation('com.mpaas.cube.adapter:cubeadapter-build:1.0.0.250923200615@aar') {
        force = true
    }
    implementation('com.mpaas.cube.sdk:cubesdk-build:1.0.0.251104172537@aar') {
        force = true
    }
	  // Select the required kernel version number from the list above. The example uses version 10.7.30-20251105.
	  ···
}

Kernel upgrade differences

10.2.90 to 10.7.30

minSdk

minSdkVersion ≥ 21

Card beforeCreate

When using data in the card's beforeCreate method, the original this.xxx should be changed to this.data.xxx.

Use the new ACT

Kernel versions 10.7.30 and later require ACT 4.0 or later for compilation.

New abstract method in CCardWidget

CCardWidget has a new sizeOfWidgetView abstract method. This method is not currently used, so you can return an empty instance.

@Override
public CSSize sizeOfWidgetView(Map<String, String> map, Map<String, Object> map1, Map<String, Object> map2, int i, int i1) {
    return new CSSize();
}

Debug path

In the new kernel, the upper layer controls whether the debug path is enabled, not the kernel itself. When enabled, you can quickly access locally developed cards through the innerStorage cache path. Enable the debug path after Cube is successfully initialized.

To enable the debug path, call the following method: CrystalTemplateLoader.openDebugLoader();

CubeInitParam cubeInitParam
= CubeInitParam.getDefault()
···
.setCubeInitCallback(new CubeInitParam.CubeInitCallback() {
	@Override
	public void onInit() {
		// Check if it is a debug package. Do not enable this for release packages.
		CrystalTemplateLoader.openDebugLoader();
	}

	@Override
	public void onError(Exception e) {

	}
});

Debug tool upgrade

Replace the old Debug library with the new version. You also need to import cubedebug.aar and jsi-sdk.aar (not required if Ariver Mini Program is already integrated).

Note

To import cubedebug.aar and jsi-sdk.aar, join the DingTalk group by searching for the ID 145930007362. Then, contact the support staff to request the files.

Add the following code to the module's build.gradle file.

configurations {
    all*.exclude group: 'com.alipay.android.phone.wallet', module: 'cubedebug-build'
}

dependencies {
	debugImplementation('com.mpaas.cubedebug.sdk:cubedebug-build:1.0.0.251106163849@aar') {
	    force = true
    }
}
Important

Comment out any debug-related libraries before deployment and use the debugImplementation method to reference them.