旧版本升级到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、检查配置项，移除usePlugin、enableEventStore、getLocation（含autoGet和type）配置，如果没有则跳过此步骤。

5、检查配置项，如果您是uni-app vue2、taro3 vue2、WePY开发的小程序，请移除 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 方法是需要您通过手动挂载在例如globalData、vue、gioGlobal此类全局对象后再取出。从3.8的版本开始，您可以直接在页面中从 global（阿里(支付宝)是 $global）对象中取出，从而免去了繁杂的存取值流程。例：

const { gio } = global;

Page({ ... });