开发中心-小程序管理

1.功能介绍

在「小程序管理」菜单中，您可以进行

• 创建小程序：新增一个新的小程序，配置相关基本信息
• 版本管理：对小程序进行体验版、审核版、线上版的配置，执行上下架等操作，也可进行版本回退
• 灰度发布：对小程序按照不同版本设置对应的灰度发布计划
• API、菜单配置：为小程序申请应用下的 API、菜单的使用
• 设置第三方平台关联：使 FinClip 小程序能够与第三方平台进行关联（目前主要支持微信平台）
• 隐私协议设置：配置小程序隐私协议
• 开发域名配置：配置小程序开发域名
• 小程序信息查看：查看小程序的基本信息、审核记录信息、代码包信息、操作日志信息等
• 插件管理：

2.名词定义

灰度发布：灰度发布是 FinClip 帮助开发者与运营人员基于设定的规则，让不同分类的用户，体验产品不同的版本特性。在确认灰度用户体验稳定反馈良好的基础上，进一步迁移扩大产品受众范围。

3.使用说明

3.1 新建/编辑小程序

在「小程序列表」中，点击「新增」按钮。

创建小程序时需填写小程序名称、类型、分类与简介等基本信息，如下图所示：

小程序创建成功后，点击小程序，右侧展开小程序的详情，分为基本信息和详细信息。「基本信息」则为创建小程序所填的信息，包括小程序名称、小程序类型、分类、简介和详细描述；「详细信息」则按功能划分为 tab，为版本管理、灰度发布、关联应用、第三方平台管理、开发域名配置、其他。

点击「基本信息」中的「编辑」，即可修改小程序信息。基本信息，点击左下角的「语言配置」则可进入多语言配置页面。

3.2 版本管理

在小程序版本管理中，可以分别对线上版本，审核版本与体验版本进行配置，其中：

• 线上版本代表您当前在线上环境中正式使用的小程序版本；
• 审核版本代表您当前提交审核过程中的小程序版本；
• 体验版本代表从开发版中选择的版本，只有指定人员才能打开的“测试版本”。

首次对小程序进行配置时，需要您手动配置小程序的各版本信息（显示界面如下图所示）。操作流程为通过 FinClip Studio 上传小程序代码信息，将已经上传的小程序设置为体验版或审核版，在审核通过后，即可将小程序上架为线上版本。

配置体验版本

点击卡片中的「配置体验版本」，在打开的弹窗中选择已经上传的小程序版本。

配置完成后，点击体验版的二维码图标，并使用 FinClip App 扫码（ FinClip App 的使用请参考： FinClip App 常见问题 (opens new window) ），即可进行预览和测试；同时在体验版本卡片中您可以点击「配置体验成员」，设置为体验者的成员，可以拥有打开体验版小程序的权限。

您还可以点击「设置页面路径」，输入携带参数的页面路径，设置后体验者将打开体验版小程序特定页面，方便体验者体验小程序功能。修改页面路径后，体验版二维码可能发生改变，您可以重新点击体验版去的最新的二维码进行体验。

配置审核版本

点击卡片中的「配置审核版本」，在打开的弹窗中选择已经上传的小程序版本，并根据需要配置审核时对应的用户登录信息，即可将对应小程序版本提交审核流程。

若您需要小程序能够在审核后自动上架，请点击底部的「审核通过后自动上架」复选框。

审核小程序信息

请注意 小程序上架审核权限受数字中心控制，可由开发中心自行审核或由数字中心审核。

若为开发中心自行审核，则前往待办中心-小程序审核，在审核界面中，点击审核详情中的「同意」按钮即可完成小程序审核操作。

配置线上版本

当完成小程序审核后，点击审核版本卡片中的「发布至线上版本」按钮，在打开的弹窗中选择「全量发布」即可发布为线上版本。若您想了解在不同人群中的产品功能使用情况，可点击「按用户比例灰度」或「创建灰度发布计划」进行版本灰度（详见 3.3 灰度发布）。

当将小程序配置为线上版本之后，会在卡片分别展示三个按钮，在其中您可以导出小程序离线包，下架线上版本，或进行版本回退操作。

导出离线包代表您可以将小程序和基础库离线包与 APP、SDK 一同打包，在首次打开小程序时便可从本地打开，从而提升小程序加载速度。

版本回退则代表您可将小程序回退到指定版本，目前最多支持回退到最近发布或已回退的 5 个版本，回退到指定版本不需要对小程序进行审核操作。

3.3 灰度发布

在灰度发布功能中，可以对小程序按照不同版本设置对应的灰度发布计划，使得不同用户可能会根据自身的用户标签与其他信息，打开不同版本的小程序。

灰度规则配置

灰度发布的规则需要在「开发-灰度规则管理」中进行配置，您可以在其中增加对应的规则信息。FinClip 已经默认为您提供了地理位置（上海范围，广州范围，北京范围，深圳范围），网络（2G，3G，4G，5G，WiFi），运行时版本（iOS，Android），基础库版本等对应规则。

创建灰度发布计划

当完成所需要的规则配置后，就可以正式开始新建灰度发布计划了，使用前小程序还需要满足如下条件：

1. 小程序有一个「通过审核且暂未上架」的版本可供灰度发布使用；
2. 「通过审核且暂未上架」的小程序版本号不能低于线上环境的版本号。

点击「小程序管理-灰度发布」进入灰度发布管理的详情页面。如果当前小程序可以进行灰度发布发布，我们会在下方列表对应序列号的右侧看到「创建」按钮。

点击后右侧拉出抽屉，补充「方案基础信息，方案规则信息」。

• 方案基础信息

  • 发布生效时间：灰度发布计划的生效时间，灰度发布计划会在这个时间段中生效；
  • 发布备注：灰度发布方案的备注与描述说明；

• 方案规则信息

  • 指定用户发布：如果上传了用户信息，则只有当用户的身份信息与此处上传的用户表匹配才可以展示小程序灰度版本（选填项）；
  • 指定规则发布：
    • 第一步：选择规则：在这里选择来自「规则配置」页面中的对应规则，如城市，系统版本等；
    • 第二步：组合规则：配置方案生效方式，当选择了发布规则后，需要在此处配置灰度发布规则的生效方式，若配置了多条规则，则需要补充规则间「与或」的生效规则。
    • 第三步：设置百分比：百分比指在满足组合规则的条件之下后，所圈定的部分人群。即灰度人群=x%*（组合规则命中人群），若未设置组合规则，则百分比作用于全量用户。

请注意 由于 FinClip 小程序未提供用户体系，当您选择「指定用户发布」时，需要通过小程序自定义 API 的形式，将 App 中的用户信息传入小程序，小程序仅在此时才可以按照指定用户发布（使用自定义 API 传入用户 ID 时，默认的规则 ID 为 xUserId）。 如何使用自定义 API 传入用户 ID，请看下方链接：

• iOS 常见问题-如何设置灰度发布自定义规则？ (opens new window)
• Android 常见问题-怎样配置灰度发布规则？ (opens new window)

当完成所有灰度计划的相关内容填写后，点击右下角的「确定」按钮即可创建灰度发布计划。灰度计划发布时，若用户不在规则之中，则会打开当前小程序的线上版本。

快速灰度发布

入口为「小程序管理-版本管理」在审核版卡片处点击「配置线上版本」，弹窗弹出 3 种选项，其中勾选「按用户比例灰度」即可按设置作用于全量用户的百分比，实现快速灰度发布。同时也可以指定的成员名单，使他们可以体验到小程序灰度版本。

确认发布后，所选比例及用户将在 10 分钟内发布完毕，灰度时效为 15 天，15 天后将会自动全量发布。

3.4 关联应用

点击「关联应用」即可查看该小程序所关联的应用。

若需要申请关联 API、菜单，则点击对应应用下的 API 配置、菜单配置，其中可用状态为「公有」的可以直接使用，可用状态为「私有」的需要申请后使用，审批者为该应用创建者。

3.5 第三方平台关联

第三方关联支持功能是小程序管理中的功能子集（目前已支持微信平台关联），当您需要复用已有的微信小程序资源时，则可以直接使用微信关联支持功能页面中的相关功能，将微信二维码，微信小程序进行关联、上架操作。

关联微信二维码

若您需要使用「关联微信小程序二维码功能」，仅需要点击对应按钮后，分别输入关联微信小程序的 APP ID、APP Secret 和小程序页面路径参数，点击确定即可。

请注意 微信官方公告 (opens new window)，自 2021 年 12 月 27 日后不再向开发者输出用户昵称与头像信息，您可能需要自行处理获取用户头像与昵称的相关逻辑。

关联微信登录

FinClip 提供了支持小程序复用微信登录支付的能力, 针对 wx.login, wx.getUserProfile, button - getphonenumber, requestPayment 等常用功能，当小程序运行在 FinClip 中时，在配置了之后，可以自动跳转的微信对应的小程序去获取相关的数据，完成业务闭环。 详见：支持微信登录支付 (opens new window)

微信平台上架

在「微信平台上架」功能功能中，开发者可以对已经上线的 FinClip 小程序与微信小程序进行关联操作，并在 FinClip Studio 中直接上传微信 WXML 语法小程序代码。

随后开发者可以直接通过 FinClip 对小程序代码进行配置，如设置小程序版本为微信环境中的体验版小程序，提交微信小程序的代码审核，发布微信小程序的代码版本。

请注意

1. 微信小程序环境中的代码审核与发布操作均需要经过微信进行审核处理，FinClip 无法保证小程序审核与发布的时效性（会出现如“请上传代码”等提示）；
2. 当前功能仅支持对于 FinClip 中已上架小程序关联微信小程序；
3. 为保证微信环境中小程序代码可用，请务必保证小程序采用微信小程序语法实现（微信小程序可直接在 FinClip 环境中使用）；
4. 使用 FinClip 管理微信小程序需要小程序用户类型为企业，个人类型的小程序将无法提供完善的管理能力；

操作流程如下：

管理微信小程序，首先需要进入「小程序管理 - 微信小程序管理」页面中，找到已有的 FinClip 小程序，点击 AppID 右侧的「关联」按钮，并在新打开的页面中使用微信扫描二维码，完成微信小程序与 FinClip 小程序的授权绑定。

微信小程序绑定成功后，会在 AppID 列显示微信小程序的 AppID（以 wx 开头）。

使用 FinClip 开发者工具打开对应小程序，可以在「详情」页面中查看到对应的微信小程序 ID 信息，在确认小程序代码开发无误后，可以点击 FinClip Studio 界面中的「上传」按钮，并勾选下方的「小程序同步上传至微信」复选框，随后可以返回小程序管理后台，打开「微信平台上架」页面进行后续操作。

操作列中对应功能如下：

• 查看体验版：当已经通过 FinClip Studio 上传小程序代码后，可以点击当前按钮，并通过微信 App 扫描二维码体验小程序；
• 代码审核：将当前体验版小程序代码提交至微信审核，审核结束后会返回审核状态与意见；
• 版本发布：将已经通过代码审核的小程序发布至线上版本。
• 域名配置：进行微信小程序服务器域名配置与业务域名配置

请注意 若您通过营销模版入口发布小程序更新域名，则在营销模版页面进行小程序上架时弹出弹窗提醒“确认更新微信小程序域名”时，点击确认则微信小程序域名更新成功。（前置逻辑：需满足该小程序已与微信小程序关联，且已配置域名）

3.6 隐私设置

隐私设置将在用户使用小程序时，在更多资料页和授权弹窗等场景进行披露。

点击「配置」，须按照页面引导补充对应的小程序隐私信息接口。

• 如您在小程序中并未使用用户填写的内容（UGC），则选中第一项“本小程序开发者承诺井保证，未以任何方式处理用户的任何信息。如后续有处理用户信息，会及时更新 《小程序隐私保护指引》”
• 否则请按照引导选中第二项并录入对应权限。

小程序名称搜索配置，则用于对用户是否能够通过小程序名称检索小程序进行配置。

3.7 开发域名配置

为了保证小程序应用中具有足够的安全保证，小程序中所有的网络请求域名都需要先行配置，只有在配置后才可以正常访问，在「开发域名配置」页点击「新增域名」即可进行域名配置。

3.8 其他

在此处您可以管理小程序历史代码包、查看小程序历史审核记录、查看当前小程序的 openAPIsecret、查看小程序模块的操作日志。

3.9 插件管理

小程序插件是对一组 js 接口，自定义组件 (opens new window)或页面的封装，相对于普通 js 文件或自定义组件，插件拥有更强的独立性。但插件不可以直接调用，必须要嵌入小程序中才能被用户使用，不能独立运行。当第三方小程序在使用插件时，也无法看到插件的代码，因此插件适合用来封装自己的功能或服务，并通过插件的形式提供给第三方小程序进行展示与使用。

开发者可以像开发小程序一样，编写并上传插件，在插件发布之后 FinClip 会托管插件代码，其他小程序调用时，上传的插件代码会随小程序一起下载运行。

在 FinClip 小程序体系内，我们会基于沙箱技术对小程序和小程序使用的每个插件进行数据安全保护，保证它们之间不能窃取其他任何一方的数据（除非数据被主动传递给另一方）。插件中所需要请求的域名需要同样在「域名设置」页面中进行配置，插件中也能够调用所有 FinClip 的 API 功能。

操作说明如下：

对于小程序的插件使用，分别分为开发者开发插件，与小程序开发者使用插件两部分。如果您需要将已有的插件上传至平台中，在小程序列表左上角点击「切换插件」按钮，点击其中的「新增插件」按钮，并在其中分别输入插件名称，头像与介绍信息以完成插件新建。

完成插件新建后，点击右侧的「更新插件」，在其中分别录入插件的版本号，更新日志，并上传代码包，就可以完成插件的上传了。

请注意 为了进一步获得小程序插件使用的 相关信息，您也可以点击开发-指南-小程序插件 (opens new window) 了解详情。

4.环境说明

	社区版	SaaS 版	企业版（年付费或一次性买断）
创建、查看、编辑小程序	✅	✅	✅
版本管理	❌	✅	按需购买
灰度发布	❌	✅	按需购买
关联应用	❌	✅	按需购买
第三方平台关联	❌	✅	按需购买
隐私设置	❌	✅	按需购买
开发域名配置	❌	✅	按需购买
其他	❌	✅	按需购买
插件管理	✅	✅	✅