企微开发踩坑指南

zELm46 · 发表于 2024-5-15 12:51:25

媒介

鉴于企微仄台的 web 开辟属于 app hybrid 开辟的一个典范场景，使用企业微疑民间供给的 JS-SDK ,咱们能够借帮企业微疑下效天使用照相、选图、语音、职位等脚机体系的才气，共时能够间接使用企业微疑分享、扫一扫等企业微疑独有的才气，为企业微诺言户供给更优良的网页体会。
其主要的劣势正在于齐仄台、和分离企微完毕智能营销；今朝企微民间供给了三种场景供咱们挑选，原文介绍的是鉴于 JS-SDK 的企业内部使用。

前端那块前期大要率碰到的坑有那些：
1.鉴权
2.手艺栈挑选、当地调试、企微 webview 的兼容性
登录鉴权过程

企微上的使用开辟，是颠末 webview 去完毕的，战罕见的混淆开辟情势不合，只要登录过程完毕后，前面的营业开辟历程即是咱们熟谙的 html,js 等前端手艺了。
若念使用企微的 api, 需要起首减载并备案 JS-SDK，它是一个 js 文献以是减载能够颠末 script 标签的方法去引进，减载完后需要备案才气使用，其民间供给的备案函数以下

wx.config({
beta: true,//必需这样写，不然wx.invoke挪用方法的jsapi会有成就
debug: true, // 启开调试情势,挪用的统统api的前去值会正在客户端alert进去，若要检察传进的参数，能够正在pc端翻开，参数疑息会颠末log挨出，仅正在pc端时才会挨印。
appId: '', // 必挖，企业微疑的corpID
timestamp: , // 必挖，天生署名的时间戳
nonceStr: '', // 必挖，天生署名的随机串
signature: '',// 必挖，署名，睹附录-JS-SDK使用权力署名算法
jsApiList: [] // 必挖，需要使用的JS交心列表，但凡要挪用的交心皆需要传进来
});
wx.agentConfig({
corpid: '', // 必挖，企业微疑的corpid，必需取目前登录的企业不合
agentid: '', // 必挖，企业微疑的使用id （e.g. 1000247）
timestamp: , // 必挖，天生署名的时间戳
nonceStr: '', // 必挖，天生署名的随机串
signature: '',// 必挖，署名，睹附录-JS-SDK使用权力署名算法
jsApiList: ['selectExternalContact'], //必挖，传进需要使用的交心称呼
success: function(res) {
// 回调
},
fail: function(res) {
if(res.errMsg.indexOf('function not exist') > -1){
alert('版原太低请升级')
}
}
});

复造代码

config 交心是备案目前企业权力，而agengConfig 是目前使用权力，它们的署名算法是完整一致的，部分过程大要以下：
access_token =》jsapi_ticket => signature =》wx.config、wx.agentConfig 备案，那里面涉及到多少个过程：
一、access_token：挪用交心凭据, 用于获得 jsapi_ticket, 一般由营业后端去慢存，没有搁正在前端。
二、jsapi_ticket：H5使用挪用企业微疑JS交心的临时单据，一般情况下，jsapi_ticket的有用期为7200秒，颠末access_token去获得。因为获得jsapi_ticket的api挪用次数十分无限（一小时内乱，一个企业至多可获得400次，且单个使用不克不及超越100次），频仍革新jsapi_ticket会招致api挪用受限，作用自己营业，开辟者必需正在自己的效劳全部慢存jsapi_ticket。
三、signature：署名，具体睹附录-JS-SDK使用权力署名算法
四、config 函数施行完会触收全部 wx.ready 函数，agentConfig 需要正在那个钩子里挪用。️
五、署名疑息，默认的有用期为 7200 秒，也即是2小时，前端能够保留下，掌握下革新频次。
当地开辟调试

一、线上是颠末 Oauth2 登录的方法获得 userId 疑息的，可是当地调试没法如许干，以是需要让后端供给一个 mock 登录的交心；
二、当地也没法挪用企微本死js 的，以是正在 dev方式下能够疏忽企微api备案函数的施行；
三、固然正在Chrome 浏览器里调试很便利，可是究竟结果终极运行是正在企微情况，以是客户端里调试也必不成少的，window 战 mac 下皆需要脚动启开相干设置。

五、企微供给的 api 偶然分需要快速的预览一下，这时候分当地没有太佳模仿，幸亏民间供给了一个交心预览对于页里，能够将那个链交搁到 webview 里翻开尝试下，留神，使用里翻开对于消息才气启动webview 哦，一般谈天框里只会翻开体系默认浏览器。

手艺栈撑持，兼容性

页里调试能够正在浏览器中，也能够正在企微的webview 中，到 2021年国庆前，企微 webview 的 chrome 内乱核版原已经持续 5 年出革新，招致没有撑持 vue3；不外现在果该能够了, 企微终究将 pc 端使用5年+的 chrome:53 内乱核，升级到了chrome:91,;
将此网址正在 webview 中翻开 ping.huatuo.qq.com/ , window 下能够瞅到目前chrome 内乱核版原。
window 下