my.ap.updatealipayclient(object object)
基础库 1.10.0 或更高版本； 且 支付宝客户端 10.1.32 或更高版本； 若版本较低，建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
打开支付宝客户端升级界面。
可通过 my.env.clientversion 获取当前客户端版本号，决定是否需要调用此接口。
效果示例
支付宝客户端升级界面示例
默认标题0
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 3 | 发生未知错误。 |
支付宝客户端升级界面未加载成功，出现概率低，可提示用户稍后再试 |
my.ap.updatealipayclient(object object)
// 示例：判断当前支付宝客户端版本是否高于 10.3.20，引导低版本客户端升级
const clientversion = my.env.clientversion || my.getsysteminfosync().clientversion;
if (compareversion(clientversion, "10.3.20") < 0) {
my.alert({
title: '提示',
content: '当前支付宝版本过低，无法使用当前小程序的重要功能，请升级到最新支付宝版本。',
success: () => {
my.ap.updatealipayclient()
}
});
}
// 支付宝版本号判断，若 v1 > v2 则返回值为 1，v1 = v2 则返回值为 0
function compareversion(v1, v2) {
var s1 = v1.split(".");
var s2 = v2.split(".");
var len = math.max(s1.length, s2.length);
for (let i = 0; i < len; i) {
var num1 = parseint(s1[i] || "0");
var num2 = parseint(s2[i] || "0");
if (num1 > num2) {
return 1;
} else if (num1 < num2) {
return -1;
}
}
return 0;
}
-
bug安卓端 10.3.86 版本以下可能出现支付宝客户端并未下载或者下载完成后不会弹出提示安装弹窗的情况。