微信小程序快速入门 | 敏捷开关帮助中心

所有文章

微信小程序快速入门

| 阅读和实践需要约15分钟

快速入门中，我们将快速的实现一个微信小程序功能特性的发布与回滚(功能的开与关)。

在UI中创建一个 feature flag

在《新建开关》弹窗中输入 feature flag 的名称，并自动生成对应的 keyName (feature flag被调动时的识别key id)。

设置 feature flag 返回值

Feature flag 被建立后，会初始化两个返回值 true 和 false ，并将默认返回值设置为 false，并且开关处于 开 的状态。

开关在 开 状态时，返回《默认返回值》对应的配置返回值。初始化时为 false。
开关在 关 状态时，返回《如果开关关闭了，应返回》对应的返回值。初始化时为 false。

当前，我们保留《默认返回值》的开关返回值设置为 false。

在小程序中集成并使用 feature flag

该快速入门教程所用 SDK 版本为 Github Release v0.0.7。可以查看此版本 Demo 示例更好的了解 SDK 集成与使用。
关于完整的 SDK 介绍与使用，可以点击查看教程《微信小程序SDK》。

安装 SDK

使用 npm

前往 project.config.json 文件中 miniprogramRoot 参数指定的文件夹并运行如下命令:

npm install ffc-wechat-miniprogram-sdk --save

引入 SDK:

import ffcClient from 'ffc-wechat-miniprogram-sdk';

不使用 npm

从 github 克隆项目到本地

git clone https://github.com/feature-flags-co/ffc-wechat-miniprogram-sdk.git

运行如下命令编译代码

cd ffc-wechat-miniprogram-sdk
npm i
npm run build

将 dist 文件夹复制到小程序项目根目录并且重新命名为 ffc-wechat-miniprogram-sdk
引入 SDK:

import ffcClient from '/{相对根目录地址}/ffc-wechat-miniprogram-sdk/index';

初始化 SDK

打开小程序的 app.js 文件，使用 .init 方法初始化敏捷开关 SDK，如下方所示，

App({
    onLaunch() {
        // initialize client
        ffcClient.init({ // you can specify the type with IOption if using Typescript
            secret: "your env secret",
            anonymous: true
        });

        ...
    },
})

其中，secret 可以在《组织机构》页面的《项目》标签下找到，如下图所示：

初始化用户(画像)信息

在用户登录后，可以调用 .identify 方法初始化用户画像信息, 如demo中如下代码所示：

ffcClient.identify({ // you can specify the type with IUser if using Typescript
    "userName": "the user's user name",
    "id": "the user's unique identifier" // the unique user Id, can be wechat id
});