FinClip为企业提供小程序生态圈技术产品,开发者可在FinClip小程序开发帮助中心找到相关FinClip小程序指引

文档中心
  • 介绍
  • 开发
  • 小程序 SDK
  • 常见问题
  • 数据
  • 设计
  • 运营

# FinClip Cloud 开发中心操作指引（私有化）

本操作指引仅适用于社区版及私有化版，持续更新中

# 1.注册和登录

登录您已经部署好的开发中心，在页面中点击「免费注册」

您需要通过以下几步完成账号注册流程

# 第一步：填写账号信息

输入手机号、验证码、邮箱，并设置登录密码，然后点击「完成」即可注册成功

# 第二步：补充企业信息

完成注册后进入开发中心，逐次点击左下角「用户名-变更为企业账户」，进入企业认证页面

在企业认证页面中，需分别填写企业主体信息、管理员信息

# 第三步：升级当前团队为企业类型

提交无误后，即会出现提交成功的页面，只需等待数字中心进行企业信息审核

# 2.角色和成员管理

开发中心支持自定义角色，并可按照角色区分灵活地自定义权限，从而达到管理成员账号权限的目的，具体操作如下

# 第一步：新增角色

在「用户-角色管理」页面中点击「新增」按钮；

# 第二步：给新角色分配权限

在「新增角色」抽屉中输入角色的名称，并勾选相对应的管理后台和开发者工具权限，点击「确定」保存

# 第三步：给成员赋予角色

开发中心的成员分为合作成员与体验成员：

  • 合作成员：指代能使用开发者工具，可登录开发中心，并对小程序进行查看与管理的人员。
  • 体验成员：指代能够通过 APP 扫码预览本组织的开发版小程序、体验版小程序的人员。无需额外配置角色。

# 给合作成员赋予角色

合作成员为「邀请制」，用户通过邀请链接方可加入本组织。在进行邀请时，需选定角色，用户成功加入后，管理者可再次编辑其角色。如用户没有小程序平台的账号，须先注册后方可加入新组织。

方法一：邀请时勾选角色

点击「用户-人员管理-合作成员-邀请」，在弹窗中勾选角色后，生成链接并复制链接。用户通过邀请链接即可加入本企业。

方法二：用户加入企业后，管理员赋予其特定角色

  • 路径一：用户-角色管理-角色-管理成员

  • 路径二：用户-人员管理-合作成员-用户-编辑角色

# 新增体验成员

区别于合作成员，体验成员为「添加制」，通过添加用户 ID 的方式将外部人员设为体验成员。

此处，用户 ID 应当取用独立于小程序平台外的 APP 的账户体系唯一标识，是 APP 系统在后台校验该用户是否有权限的凭证，建议 APP 在集成 SDK 时将手机号作为用户 ID 进行注入，这样在后台导入用户 ID 时会较为方便。

路径：用户-人员管理-体验成员-新增

# 3.创建小程序

# 3.1 创建新的小程序

您可以从以下 2 个入口进入创建小程序：

入口 1：登录开发中心后，在「首页-我的小程序」中点击「新建小程序」

入口 2：在「小程序」中，点击「新增」

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

# 3.2 修改小程序基本信息

小程序创建成功后，点击小程序，右侧展开小程序的详情，点击「基本信息」中的「编辑」，即可修改小程序信息

基本信息包括小程序名称、小程序类型、分类、简介和详细描述，点击左下角的「语言配置」则可进入多语言配置页面。

在小程序详情中可进行版本管理、隐私设置、灰度发布等。

# 3.3 查看已创建的小程序

查看已创建的小程序，可以通过「首页」或「小程序」菜单进入

  • 路径一：首页-我的小程序

  • 路径二：小程序-小程序列表

# 4.开发小程序

# 4.1 开发工具

  1. 本平台小程序兼容微信、字节、支付宝等小程序，开发者开发过程推荐使用 FinClip Studio (opens new window) 或 微信开发者工具 (opens new window)，或者使用 VSCode （任意您习惯的开发工具） 进行开发，使用 FinClip Studio 或 微信开发者工具做预览和调试；

  2. 开发前建议阅读 小程序开发指南 (opens new window) ，由于本平台与微信小程序的兼容性较高，也可以参考 微信小程序开发文档 (opens new window)进行开发；

  3. 如需使用第三方框架，建议使用如下兼容性较好的第三方框架：

# 4.2 完成域名设置

为了保证小程序应用中具有足够的安全保证，小程序中所有的网络请求域名都需要先行配置，只有在配置后才可以正常访问。

在「开发 - 域名管理」页面中可以管理当前团队所有可使用的小程序域名（即一次配置后所有小程序同时生效），在域名配置处录入当前团队使用的所有域名地址，并使用“回车换行”进行区分后保存即可。

填写域名时，需按照要求填写，如填写带有协议头的完整地址，如 https://example.com/page1.html (opens new window)

若您所需要配置的域名仅需要在指定小程序处生效，则可在小程序详情页面中进行配置。在小程序详情页面中配置的域名仅对当前小程序生效。

# 4.3 预览和调试

您可以通过 FinClip Studio 进行实时预览调试，或将小程序设置为体验版进行调试

方法一：通过 FinClip Studio 进行调试

方法二：通过体验版进行调试

在代码包上传成功后，你可以在「小程序-小程序-详情-版本管理」页面中点击「配置体验版」，将对应版本小程序设置为体验版本；

配置完成后，使用 FinClip APP 扫码（ FinClip APP 的使用请参考： FinClip APP 常见问题 (opens new window) ），即可进行预览和测试

# 4.4 使用 Studio 上传代码包

请下载 FinClip Studio 完成代码包上传工作。FinClip Studio 可在本地本地编译小程序代码后直接上传代码包。详细操作指引请参考：开发者工具操作指引 (opens new window)

上传成功后可在「小程序-详情-其他-历史代码包」中查看。

# 5.小程序提交审核与上下架

# 5.1 完成隐私设置

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

路径：小程序-隐私设置

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

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

# 5.2 提交审核

在配置域名、上传代码包并完成隐私设置后，可在「小程序-详情-版本管理」中新增审核并提交，填写审核补充信息后，并等待数字中心通过或驳回，审核结果会通过「通知中心」告知您。

路径：小程序-详情-详细信息-版本管理-配置审核版本

在「小程序-详情-其他-小程序历史审核记录」中，可查看所当前小程序的版本审核记录

# 5.3 小程序上下架

若您在提交小程序为审核版本时，勾选了“审核通过后自动上架”，则小程序在通过审核后会自动发布为线上版本，否则您需要自行操作。

# 上下架

路径：小程序-详情-版本管理

  • 若无线上版本，则可「配置线上版本」

  • 若有线上版本，可操作「导出离线包」、「版本回退」和「版本下架」
  • 若有审核通过版本，可操作「发布至线上版本」；无审核版本，则可「配置审核版本」

点击「发布至线上版本」，可选择

  • 全量发布
  • 按用户比例灰度：可视为用户比例维度的快捷灰度发布
  • 创建灰度发布计划：可详细设定灰度发布计划

# 灰度发布

创建灰度发布计划，可按指定规则发布，如下图；如需配置更多规则，可前往「开发-灰度规则」进行设置。

此外，可在「小程序-详情-灰度发布」中查看所有可发布/发布中/待发布/已结束状态的小程序版本，针对「可发布」状态的版本，同样可以点击「创建」以进行详细的灰度发布；

# 6.关联移动应用

在完成了小程序新增相关工作后，我们需要在 FinClip 小程序开放平台中配置宿主应用的相关信息。只有在配置了宿主应用的相关信息后，小程序才可以在指定的宿主应用中正常运行。

# 6.1 新增应用

路径：应用-新增

新增应用时，需填写应用名称与应用所属企业名称，上传图标，并确定是否对其他团队可见、BundleID 是否对其他团队可见。其中：

  • 应用名称后续可修改
  • 应用所属企业将不可修改

# 6.2 配置 BundleID

新增应用后，还需要配置应用相关的 Bundle ID，以生成对应的 SDK KEY 与 SDK SECRET，从而完成应用关联操作；

路径：应用-详细信息-BundleID-配置

若 iOS 与 Android 的 Bundle ID 一致，则只需勾选「安卓/iOS 通用」，添加一个 Bundle ID 即可：

# 6.3 配置 SDK Key & Secret

在宿主应用中打开小程序时，SDK 会基于当前 App 的 BundleID ，SDK Key & Secret 进行解密，只有在配置正确的情况下才可以正常运行小程序。

因此您需要在对应 BundleID 的右侧复制对应的 Key 及 Secret，并按照 SDK 配置文档将其填入 SDK 初始化的字段中。

# 6.4 关联小程序

若要在指定应用中打开小程序，则需要关联小程序和应用，

路径：应用-详情-关联小程序-编辑小程序

在弹窗中选择小程序进行关联，如下图。选择小程序后，第三方应用还需在自己的 APP 中增加小程序入口，以使用户可进行正常访问；

注意：

1.私有化客户采购后，此处可对应设置是否需要数字中心审核，即：开发中心新增关联小程序后，需等待数字中心审核，数字中心如审核不通过，开发中心小程序将无法在对应应用中打开；

2.在小程序与宿主应用进行关联时，有如下内容需要注意：

  • 合作应用必须集成 FinClip 小程序 SDK，并配置对应的 SDK Key 和 Secret；
  • 企业需要将上架的小程序与合作应用关联，才能打开对应的小程序；
  • 小程序开放平台将校验 SDK KEY ，应用 Bundle ID 及小程序的关联关系，如果未关联将无法正常打开小程序。

SDK 集成说明请参考：

# 7.用户反馈

开放平台的小程序 SDK 提供收集用户反馈的功能入口，点击小程序左上角的“...”即可看到投诉与反馈的入口，如下图：

其中「功能异常」和「产品建议」的反馈会收集至开发中心的首页-待办中心，请及时处理。

当然，上述投诉信息也可以在屏幕左下角的工单管理中进行查阅与处理。

# 8.待办中心

有其他需要您待处理的操作，可以通过首页中的「待办中心」入口进入，其中会包括您需要处理的相关业务流程（如小程序审核，小程序绑定，自定义 API 调用等相关操作），通过待办中心能够快速进入需要处理的业务流程之中，帮助您开展相关的业务。

# 9.FinClip APP 使用说明

开发者可通过「 FinClip APP 」获得丰富的开发协助，下载请前往：「 FinClip APP 」下载链接 (opens new window)

使用说明

  • 安装「 FinClip APP 」，并进行「登录」
  • 扫码打开小程序：可打开平台内所有小程序，以便利开发者调试
  • 管理小程序：开发者可快速查看自己已经创建的小程序，并便捷的打开曾经上传成功的代码包

© FinClip with ❤ , Since 2017