内核版本升级-移动开发平台 mPaaS-阿里云

版本列表

版本号

小版本

对应版本信息

changelog

备注

10.2.90

主基线版本

初代 Cube 内核版本，具备基础功能。

无需升级，主基线默认指定版本。

10.7.30（beta）

20251105

渲染引擎：

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

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

Debug 库：

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

10.7.30 升级

支持组件能力
跟随支付宝升级，bugfix

内核版本升级

整体 mPaaS 基线使用主基线即可。
内核版本指定对应的版本信息。

在项目的 build.gradle 中设置基线。

buildscript {
	···
	ext.mpaas_artifact = "mpaas-baseline"
	ext.mpaas_baseline = "10.2.3-72" //版本这里选用最新主基线即可
	···
}

在 module 的 build.gradle 中设置内核版本。

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
    }
	  // 版本号要从上面列表里选择你要的内核版本，以上是以 10.7.30-20251105 版本为例的。
	  ···
}

内核升级差异

10.2.90 > 10.7.30

minSdk

minSdkVersion ≥ 21

卡片 beforeCreate

在卡片的 beforeCreate 中使用 data 数据，要由原来的 this.xxx 变更为 this.data.xxx。

使用新 ACT

10.7.30 及以上内核，需要使用 ACT 4.0 及以上的工具编译。

CCardWidget 新增抽象方法

CCardWidget 新增了 sizeOfWidgetView 方法，当前暂不使用，返回一个实例即可。

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

Debug 路径

新内核 Debug 路径的开启与关闭，不再由内核判断，而是由上层自行调用。开启后，可以通过 innerStorage 的缓存路径，快速访问本地开发的卡片。建议在 Cube init 成功后去开启。

开启方法为：CrystalTemplateLoader.openDebugLoader();

CubeInitParam cubeInitParam
= CubeInitParam.getDefault()
···
.setCubeInitCallback(new CubeInitParam.CubeInitCallback() {
	@Override
	public void onInit() {
		// 建议这里判断下是否debug包，不建议release包也开启
		CrystalTemplateLoader.openDebugLoader();
	}

	@Override
	public void onError(Exception e) {

	}
});

Debug 调试升级

移除老版本 Debug 库，引入对应版本的 Debug 库。并引入 cubedebug.aar、jsi-sdk.aar（如有 Ariver 小程序可以不使用此 aar）。

说明

如需引入 cubedebug.aar、jsi-sdk.aar 请搜索群号 145930007362 加入钉钉群咨询对应的技术支持人员进行申请。

在 module 的 build.gradle 中添加如下代码。

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
    }
}

重要

Debug 相关库请在上线前注释掉，并使用 debugImplementation 方式进行引用。