前言

基于企微平台的 web 开发属于 app hybrid 开发的一个典型场景，使用企业微信官方提供的 JS-SDK ,我们可以借助企业微信高效地使用拍照、选图、语音、位置等手机系统的能力，同时可以直接使用企业微信分享、扫一扫等企业微信特有的能力，为企业微信用户提供更优质的网页体验。

其主要的优势在于全平台、以及结合企微实现智能营销；目前企微官方提供了三种场景供我们选择，本文介绍的是基于 JS-SDK 的 企业内部应用。

前端这块前期大概率遇到的坑有这些：

1.鉴权

2.技术栈选择、本地调试、企微 webview 的兼容性

登录鉴权流程

企微上的应用开发，是通过 webview 来实现的，和常见的混合开发模式一致，只要登录流程完成后，后面的业务开发过程就是我们熟悉的 html,js 等前端技术了。

若想使用企微的 api, 需要首先加载并注册 JS-SDK，它是一个 js 文件所以加载可以通过 script 标签的形式来引入，加载完后需要注册才能使用，其官方提供的注册函数如下

因涉及一些执行语句，禁止写入，请联系客服获取

config 接口是注册当前企业权限，而agengConfig 是当前应用权限，它们的签名算法是完全一样的，整体流程大概如下：

access_token =》jsapi_ticket => signature =》wx.config、wx.agentConfig 注册，这里面涉及到几个流程：

1、access_token：调用接口凭证, 用于获取 jsapi_ticket, 一般由业务后端来缓存，不放在前端。

2、jsapi_ticket：H5应用调用企业微信JS接口的临时票据，正常情况下，jsapi_ticket的有效期为7200秒，通过access_token来获取。由于获取jsapi_ticket的api调用次数非常有限（一小时内，一个企业最多可获取400次，且单个应用不能超过100次），频繁刷新jsapi_ticket会导致api调用受限，影响自身业务，开发者必须在自己的服务全局缓存jsapi_ticket。

3、signature：签名，具体见 附录-JS-SDK使用权限签名算法

4、config 函数执行完会触发全局 wx.ready 函数，agentConfig 需要在这个钩子里调用。️

5、签名信息，默认的有效期为 7200 秒，也就是2小时，前端可以保存下，控制下更新频率。

本地开发调试

1、线上是通过 Oauth2 登录的形式获取 userId 信息的，但是本地调试无法这样做，所以需要让后端提供一个 mock 登录的接口；

2、本地也无法调用 企微原生js 的，所以在 dev 模式下可以忽略企微api注册函数的执行；

3、虽然在Chrome 浏览器里调试很方便，但是毕竟最终运行是在 企微环境，所以客户端里调试也必不可少的，window 和 mac 下都需要手动开启相关配置。

5、企微提供的 api 有时候需要快速的预览一下，这时候本地不太好模拟，好在官方提供了一个接口预览对页面，可以将这个链接放到 webview 里打开测试下，注意，应用里打开对消息才能启用webview 哦，普通聊天框里只会打开系统默认浏览器。

技术栈支持，兼容性

页面调试可以在浏览器中，也可以在企微的webview 中，到 2021年国庆前，企微 webview 的 chrome 内核版本已经连续 5 年没更新，导致不支持 vue3；不过现在因该可以了, 企微终于将 pc 端使用5年+的 chrome:53 内核，升级到了chrome:91,;

将此网址在 webview 中打开 ping.huatuo.qq.com/ , window 下可以看到当前chrome 内核版本。

window 下

mac 下

后续

原来的官方文档更像是 api 文档，不过近期我看官方已经在花精力优化开发教程了，希望企微平台的整体开发体验越来越好吧。