云裂变营销网

标题: 第三方代开发小程序实践 [打印本页]

---

作者: 匿名    时间: 2023-3-7 14:28
标题: 第三方代开发小程序实践
第三方平台文档指引：点击查看

微信开放平台 - 第三方平台（简称第三方平台），由微信团队面向所有通过开发者资质认证的第三方开发者提供提供的官方平台。

在得到公众号或小程序管理员授权后，基于该平台，第三方服务商可以通过调用官方接口能力，为商家提供公众号代运营、小程序代注册、代开发等服务以及提供公众号和小程序相关的行业方案、活动营销、插件能力等全方位服务。

得到小程序授权后，基于该平台可以为业务方提供代开发等服务。接下来，本文将为大家介绍下第三方平台以及如何基于第三方平台实现自定义发布方案。
平台型第三方平台核心优势
安全可靠的授权

• 就服务商而言，此种授权方式更加安全和便捷，服务商无需管理多个商家的账号密码或者 appid 和secret；
  
• 就商家而言，此种授权方式也更加安全和便捷，商家只需要将部分权限授权给服务商即可；无需将公众号/小程序的账号密码或者 appid 和secret都交由服务商；且商家可以随时进行解除授权；
  

可基于官方接口能力批量为商家提供服务

• 获得商家授权后，即可通过官方接口能力批量代商家的公众号和小程序进行批量管理，大大提升效率。
  
• 且，如果是小程序，则可以将小程序代码上传托管到第三方平台的小程序模板库中。利用第三方平台的能力，可基于一个模板进行发布多个小程序，有利于服务商批量为商家开发小程序。
  

一、第三方代开发概念介绍

为了帮助读者更快理解第三方平台方案，打消授权到三方平台的疑虑，这里先介绍下基本概念。
1.1 、授权 vs 绑定

首先业务方为了将公众号和小程序的用户身份打通要将业务方的公众号、小程序绑定到业务方同一个开放平台帐号下，才能实现，这与第三方平台的授权行为是完全不冲突的。

• “绑定”指的是将商家的公众号或者小程序帐号绑定到商家的开放平台下
  

绑定

• “授权”是指商家将其公众号或者小程序扫码授权给服务商的第三方平台帐号
  

授权

具体关系如下图所示：业务方只需要授权到第三方平台即可，不影响原有的绑定行为。



绑定vs授权

1.2、小程序权限集

• 权限集是一个或者多个接口的权限的集合，当小程序或公众号管理员将某权限集授权给服务商，则服务商就获得了该权限集包含的接口的调用权限。
  
• 权限集有是否互斥之分，权限集互斥指的是该权限集只可同时授权给一个第三方平台。
  

小程序权限集部分截图

同一权限集无法细分拆开单独接口进行授权。



开发管理与数据分析权限

1.3、不同类型的token

.token名称	说明
access_token	- 是使用公众号、小程序、网站应用或者移动应用的 Appid 和 secretKey 生成的。- 使用 access_token 调用官方接口，指的是使用商家身份调用接口，常用于自研模式。- 公众号、小程序、网站应用、移动应用的接口均支持使用 access_token 调用。
component_access_token	- 是使用第三方平台帐号的 Appid 和 secretKey 以及 component_verify_ticket 生成的。- 使用 component_access_token 调用官方接口，指的是使用服务商身份调用只开放给服务商的接口。- 第三方平台的部分接口支持使用 component_access_token 调用。
authorizer_access_token	- 是在获得商家授权的情况下，使用 component_access_token 和授权帐号 authorizer_appid 生成的。- 使用 authorizer_access_token 调用官方接口，指的是服务商代商家（服务商以商家身份）调用接口，常用于第三方开发模式。- 公众号、小程序的接口以及第三方平台的部分接口支持使用 authorizer_access_token 调用。- 网站应用、移动应用的接口不支持使用 authorizer_access_token 调用。

• token生成的步骤可查看token生成介绍。
  

引导商家完成授权后，服务商即可获得权限代业务方（商家）调用公众号或者小程序的接口，只是服务商调用的时候要使用authorizer_access_token，而不是access_token






二、第三方代开发实践

2.1、商家授权服务商



医疗云第三方平台
2.2、授权小程序与开发小程序

小程序名称	说明
授权小程序（又名商家小程序）	- 商家可以有小程序，服务商也可以有小程序，为了高效沟通，通常将商家主体的小程序称为商家小程序；- 当商家将其小程序授权给服务商之后，则称之为授权小程序。- 然而，商家可以将公众号和小程序都授权给服务商，统称为授权帐号，指的是已经授权给服务商的帐号（含公众号和小程序帐号）- 与授权帐号相对的是服务商帐号，通常是使用第三方平台帐号来代指服务商帐号。
开发小程序（又名模板小程序）	- 商家小程序通常是最终会发布上线，成为一个可用的应用为 C 端用户提供服务的。- 而开发小程序只是服务商用于进行小程序代码的编写、用于小程序的调试等工作，通常不会发布上线。- 由于一份小程序的代码可以批量复制于无数个商家小程序，这份母版小程序代码又称小程序模板代码，用于开发该母版小程序代码的小程序帐号则是“开发小程序”帐号，也称之为“模板小程序”帐号。- “开发小程序”其实也是一个普通的小程序帐号，只需要将普通小程序绑定到第三方平台帐号中即为“开发小程序”。

• open3rd：第三方平台账号，是认证的第三方开发者账号 详情
  
• 3rdMiniProgramAppid：第三方平台申请的并绑定在该平台上的小程序,指的是“开发小程序”的appid （业务方无需关注）
  
• extAppid: 授权给第三方平台的业务方（商家）小程序的appid
  

第三方平台相关的小程序开发需要做一些特殊的处理：

• 小程序模板的开发
  
• 小程序模板结合 extAppid 的开发调试
  
• 使用 directCommit 直接提交至待审核列表
  

2.3、代业务方开发小程序



官方给出的代开发小程序流程比较复杂，涵盖了代小程序开发、提交代码、提交代码审核、发布上线的全过程。
然而对我们场景来讲，不干涉业务方小程序的开发，只涉及开发完成后代业务小程序提交代码、提审、发布的场景。 也就是我们只关注下图场景：



图中介绍了两种代上传小程序代码的模式，在具体介绍这两种模式之前，我们先看下第三方模式下新增的ext.json配置文件。
前文介绍概念时提到过3rdMiniProgramAppid 和extAppid, 我们都知道小程序的project.config.json中声明了appid, 授权到三方平台后，代业务方小程序操作提交代码、提审发布时，这个appid需要被替换成3rdMiniProgramAppid，因此需要一个配置来管理业务方真实的appid即extAppid。 ext.json就是这样的一个配置文件，用来配置代开发后相关信息。

1. {
2.   "extEnable":true,
3.   "extAppid":"wxbfdd416fcdf80be5",
4.   "directCommit":true// 是否直接提交到审核列表
5. }

复制代码

其中directCommit用来指定是否直接提交到审核列表，上传代码至草稿箱的模式，适用于通过代码模版，开发管理多个授权小程序的模式。再次重申，不干涉业务方小程序的开发，只涉及开发完成后代业务小程序提交代码、提审、发布的场景。因此不论是从目标还是方案的可行性考虑，通过directCommit方案直接提交小程序代码到审核列表都是更加合理的选择。



三、第三方代开发发布平台搭建

前文介绍了第三方平台相关的基本概念，如何基于第三方平台代开发小程序，下面将详细介绍下第三方代开发发布平台是如何基于第三方平台实现平台的自定义授权发布方案。
3.1、方案介绍

第三方代开发平台的授权发布方案整体流程如下图所示。 与未授权方案相比，业务小程序本地开发、特性分支push触发开发版二维码生成的流程没有任何变化。区别在于上传代码生成体验版 及后续的小程序提交审核、发布、上线的流程。后续流程不再基于mp平台进行，而是通过三方平台调用api实现。



为实现上图的效果平台需要实现下述几点能力：

• 提供小程序授权到第三方平台入口
  
• 小程序上传流水线改造
  
• 增加版本管理能力
  
• 管控域名、隐私协议
  

下面也将从这几个方面介绍方案的具体实现。
3.2、api服务层封装

前文提及过，三方平台想调用api接口操作小程序，需要业务方授权，并且提供authorizer_access_token，而不是access_token。




3.3、小程序上传流水线改造

前文介绍ext.json中的 directCommit 是一个 Boolean 类型的字段，用于规定当前的上传操作是否是直接上传到 extAppid 的审核列表中。 当 directCommit 为 true 真时，开发者在工具中的上传操作，会直接上传到对应的 extAppid 的审核列表，第三方平台只需要调用 https://api.weixin.qq.com/wxa/submit_audit?access_token=TOKEN 即可以提交审核。
directCommit可以通过miniprogram-ci ci工具进行上传，ci工具使用说明如下：
miniprogram-ci 从 1.0.28 开始支持第三方平台开发的上传和预览，调用方式与普通开发模式无异。 使用第三方平台开发模式时，应注意：

请确保项目中存在正确的 ext.json
密钥文件是第三方平台绑定的开发小程序 appid 的密钥文件
ip白名单是第三方平台绑定的开发小程序 appid 的 ip 白名单
调用传入的 appid 是第三方平台绑定的开发小程序 appid 关于第三方平台开发模式

也就是说使用miniprogram-ci 配合directCommit配合小程序上传，需要项目具有正确配置的ext.json文件。

• 通过ext.json配置的extAppid字段声明业务小程序的真实appid
  
• 项目project.config.json中的appid需要替换成第三方平台开发小程序的appid
  
• 上传凭证也需要替换成开发小程序的上传凭证。
  

由于要让业务方无需关心上述转换流程，需要对小程序上传代码生成体验版的ci流程进行改造。

• 添加ext.json文件，文件中extAppid为业务小程序appid
  
• 修改project.config.json文件中appid为开发小程序appid
  
• 通过miniprogram-ci 上传下程序代码至第三方平台
  

流程图如下所示：



3.4、 体验版二维码获取

由于前文介绍，对上传小程序代码进行了改造上传至第三方平台，也无法再使用原有miniprogram-ci的方式获取体验版二维码，获取到的会是开发版小程序的体验二维码而不是业务小程序。
因此需要单独提供业务小程序的体验版二维码的获取方式。 通过openAPI获取体验版二维码接口：https://api.weixin.qq.com/wxa/get_qrcode?access_token=ACCESS_TOKEN 获取体验版二维码并通过流水线推送至开发者。

3.5、 版本管理能力

业务小程序授权到三方平台后原mp平台的版本管理页面将无法再使用。


需要为业务方提供新的版本管理页面。



并通过下属openApi实现小程序版本的提审、发布、灰度、全量。

• submitAudit 提交代码审核
  
• getAuditStatus 查询审核状态
  
• release 发布已通过审核的小程序
  
• revertCodeRelease 版本回退
  

可扩展功能点：
1.连接生产服务器的体验版才容许提审。
2.发布前增加审批流。比如必须通过自动化测试/人工测试审批后才可以发布。
3.6、 域名管理

业务小程序授权第三方平台后，需要由第三方平台管理小程序的业务域名和服务器域名，为了避免业务方重复配置，实现无缝切换，前文的授权后流程中也介绍了授权后会小程序域名的同步设置，小程序的域名的设置方式如下图。




无论是业务域名还是服务器域名都支持下面两种方式设置。
方式一

• 将业务域名/服务器域名配置到第三方平台中，再通过调用接口setwebviewdomain或者接口modifyServerDomain将域名配置给业务小程序。
  注意：
  

• 需要先将域名登记到第三方平台的小程序业务/服务器域名中，才可以调用接口进行配置
  
• 业务域名平台最多添加200个
  
• 域名设置每月可提交修改申请50次
  

• 支持通过接口modifyServerDomainDirectly快速配置小程序服务器域名
  注意：
  该接口用于配置小程序服务器域名，不再需要先将域名配置到第三方平台，可通过该接口直接进行配置到授权小程序。但是，配置成功后，需要提交代码或者发布上线后才会真正生效通过该接口配置的域名。
  

方式二

• 支持通过接口modifyJumpDomainDirectly快速配置小程序业务域名
  注意：
  

• 调用该接口前需要先调用接口get_webviewdomain_confirmfile用于获取配置小程序业务域名的校验文件，需要将该校验文件放置在根域名目录下, 之后再调用接口modifyJumpDomainDirectly才能调用成功（与mp平先获取校验文件再配置业务域名逻辑一致）。
  
• 业务小程序在原mp平台下载并上传到域名根目录下的校验文件依然生效，对于这部分域名，直接调用modifyJumpDomainDirectly接口设置即可成功。
  
• 配置成功后，需要提交代码或者发布上线后才会真正生效通过该接口配置的域名。
  

3.7、 隐私协议设置

授权到第三方平台后，授权主体从小程序主体变为第三方平台的主体，因此mp上的隐私设置 配置无效，需要重新填写隐私设置配置
建议： 授权前先前往mp平台 》设置 》基本设置 》功能设置 》用户隐私保护指引设置 保存原有配置，便于授权后重新填写隐私设置配置。
注意： 需要在上传过一次体验版之后再去设置隐私协议
设置隐私协议接口：setPrivacySetting

• 配置后，需重新提交代码审核，审核通过且需要重新发布上线后才会在小程序端生效。
  
• 配置后，可通过查询最新一次提交的审核状态接口查询审核的状态，如果是驳回了则可以查看驳回原因。
  

获取隐私协议接口：getPrivacySetting

• 本接口用于查询第三方代开发小程序的用户隐私保护指引，也可以用来查询有哪些privacy_key可以进行配置
  

---

欢迎光临 云裂变营销网 (https://www.yunliebian.com/yingxiao/)

Powered by Discuz! X3.4