新增了UTS插件，使用wgt更新后白屏降级处理方案

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库内容，针对新增UTS插件后使用wgt更新导致白屏的问题，提供以下分析和解决方案：

问题原因

UTS插件在打包后会编译为纯原生二进制代码，不支持wgt热更新。参考文档

当你通过wgt更新时，仅更新了前端资源，但UTS插件对应的原生二进制代码并未更新，导致新老版本不兼容，出现白屏崩溃。

解决方案

1. 版本号检测与插件条件加载

在App.vue的onLaunch中检测当前版本号，如果版本号低于包含该插件的基线版本，则跳过插件初始化：

// #ifdef APP-PLUS  
plus.runtime.getProperty(plus.runtime.appid, function(widgetInfo) {  
    // widgetInfo.version 获取当前版本号，如 "1.0.0"  
    const currentVersion = widgetInfo.version;  
    const baseVersion = "1.5.0"; // 包含UTS插件的基线版本号  

    // 版本号比较：如果当前版本大于等于基线版本，才加载插件  
    if (compareVersion(currentVersion, baseVersion) >= 0) {  
        // 初始化腾讯直播插件  
        initLivePlugin();  
    } else {  
        console.log('当前版本不支持直播插件，跳过初始化');  
        // 设置全局标志，页面中根据此标志判断是否显示直播功能  
        getApp().globalData.supportLive = false;  
    }  
});  
// #endif  

// 版本号比较函数  
function compareVersion(v1, v2) {  
    const arr1 = v1.split('.');  
    const arr2 = v2.split('.');  
    const len = Math.max(arr1.length, arr2.length);  

    for (let i = 0; i < len; i++) {  
        const num1 = parseInt(arr1[i] || 0);  
        const num2 = parseInt(arr2[i] || 0);  
        if (num1 > num2) return 1;  
        if (num1 < num2) return -1;  
    }  
    return 0;  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

2. 服务器端版本控制

在服务器端配置min_uni_version（最小支持版本），当检测到客户端版本低于此值时，返回整包更新而非wgt更新：

// 服务器check-version接口逻辑示例  
if (clientVersion < baseVersion && updateType === 'wgt') {  
    // 强制返回整包更新，不返回wgt包地址  
    return {  
        update: true,  
        updateType: 'app', // 改为整包更新  
        url: 'https://example.com/app-new.apk'  
    };  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

3. 整包更新替代方案

根据wgt热更新机制说明，如果测试发现新老版本不兼容，不应使用wgt更新，必须整包更新。参考文档

建议在manifest.json中配置版本兼容性检查，或使用uni-upgrade-center进行版本管理，该组件支持：

• 检测wgt包与当前运行时的兼容性
• 自动判断是否需要整包更新
• 支持min_uni_version配置，低于此版本强制整包更新

4. 插件懒加载策略

对于UTS插件，采用动态导入方式，避免启动时立即加载：

// 页面中按需加载，而非全局引用  
export default {  
    methods: {  
        async startLive() {  
            // 再次检查版本兼容性  
            if (!getApp().globalData.supportLive) {  
                uni.showModal({  
                    title: '提示',  
                    content: '当前版本过低，请前往应用商店更新',  
                    success: (res) => {  
                        if (res.confirm) {  
                            // 跳转应用商店  
                        }  
                    }  
                });  
                return;  
            }  

            // 动态导入插件（仅在支持时加载）  
            const liveModule = await import('@/uni_modules/tx-live-plugin');  
            liveModule.start();  
        }  
    }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

关键注意事项

1. UTS插件必须整包更新：由于UTS编译为原生代码，wgt热更新无法更新插件本体，首次集成UTS插件或更新UTS插件时，必须发布整包（apk/ipa）。

2. 版本号管理：建议将包含UTS插件的版本号作为基线版本（如1.5.0），后续wgt更新必须要求客户端版本≥1.5.0。

3. 灰度发布：先小范围发布整包更新，待大部分用户升级后再发布wgt更新，避免旧版本用户通过wgt更新导致崩溃。

如需更完善的更新管理，建议使用App升级中心 uni-upgrade-center，它提供了版本兼容性检测、强制更新、静默更新等功能。

像你这种情况应该毫不犹豫发新安装包。uts会被翻译成原生语言，热更新只能更新前端js的部分。
热更新判断也很容易，遵守一个原则：每次打包apk、ipa、app的时候必定更新versionCode和versionCodeversionName2个字段，热更新永远不更新versionCode只更新versionName。如此一来APP只需判断versionCode，只有本地与远程热更新包一致时才允许热更新。