旧版本升级到3.8

本文讲介绍如何从旧版本的SDK无缝升级到3.8版本。

在升级之前,请充分阅读3.8版本的文档内容后再进行升级操作

初始化

1、下载最新版对应框架的SDK并替换,请参考集成文档选择正确的开发方式下载。

2、找到初始化代码,修改引用方式。如果您想保留原有 require 的引用方式跳过本步骤即可。

const  = require('./utils/gio/sdk.js').default;
//          修改为 ↓↓↓
import gio from './utils/gio/sdk.js';

3、检查初始化方式,如果使用 setConfig 方法初始化,请参考集成文档重新集成;如果使用 init 方法进行初始化则跳过此步骤。

4、检查配置项,移除usePluginenableEventStoregetLocation(含autoGet和type)配置,如果没有则跳过此步骤。

5、检查配置项,如果您是uni-app vue2taro3 vue2WePY开发的小程序,请移除 vue 配置,并参考集成文档添加对应的实例参数。如果不是则跳过此步骤。例:

gio('init', '您的 GrowingIO 项目ID', 'your AppId', {
    version: 'your miniProgram version',
    // vue: Vue,  移除此配置
    uniVue: Vue, // 新增此配置
    ...other settings
});

页面

1)如果您是阿里(支付宝)小程序,请恢复对App({})Page({})Component({})的原生写法。如果不是则跳过此步骤。

$global.GioApp({ ... });
// 修改回原始写法 ↓↓↓
App({ ... });

$global.GioPage({ ... });
// 修改回原始写法 ↓↓↓
Page({ ... });

$global.GioComponent({ ... });
// 修改回原始写法 ↓↓↓
Component({ ... });

2)检查页面中是否调用getLocation方法,存在则参考文档修改为setLocation。如果没有则跳过此步骤。

其他

如果您调用了gioGlobal中的内容,请尝试从global(阿里(支付宝)小程序是 $global)中重新获取,gioGlobal已经被弃用。

建议性修改

1、如果您使用了旧版动态配置接口的调用方式,建议按新版使用方式进行修改。

2、在<3.8的旧版本中,可能您的 gio 方法是需要您通过手动挂载在例如globalDatavuegioGlobal此类全局对象后再取出。从3.8的版本开始,您可以直接在页面中从 global(阿里(支付宝)是 $global)对象中取出,从而免去了繁杂的存取值流程。例:

const { gio } = global;

Page({ ... });

最后更新于