# 致远微协同-微信小程序集成配置
# 1、简介
微信小程序是一种全新的连接用户与服务的方式，它可以在微信内被便捷地获取和传播，同时具有出色的使用体验。
我们通过微协同H5与小程序进行了快速集成，入口更快捷，体验更顺畅。 本文详细介绍小程序通过客开集成的方案，主要分以下几个步骤：
# 2、小程序注册
小程序注册登录地址：https://mp.weixin.qq.com
首先需要完成小程序的注册并且通过微信认证，每个邮箱仅能申请一个小程序，目前有2种方式：
单独注册小程序，通过微信认证（提供企业资质信息，支付认证费用）
【推荐使用】通过已认证公众号快速注册并认证小程序，可复用公众号资质（免认证）
注：小程序名称谨慎填写，因为小程序发布后，只能通过再次认证方式名。
# 3、小程序配置
1.获取AppID和AppSecret
在【设置-开发设置】开发者ID中获取
2.配置服务器域名和业务域名
在【设置-开发设置】服务器域名/业务域名中配置，域名为协同服务器外网地址
服务器域名/业务域名需经过ICP备案，且只支持https安全域名
业务域名配置的时候需要校验，参考腾讯说明：请下载校验文件，并将文件放置在域名根目录下，例如wx.qq.com，并确保可以访问该文件。如配置中遇到问题，请查看具体指引
# 4、V5协同配置
协同版本在V7.0SP2（含）以上
协同有微协同插件
部署《小程序插件》包
在微协同基础配置中配置协同服务器地址
- 协同服务器有外网地址，有经过ICP备案的域名，且只支持https安全协议
# 5、小程序代码开发
下载小程序开发工具
https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
获取代码
申请V5微协同小程序集成代码
解压代码，通过小程序开发工具导入代码，修改AppID
3.修改代码
在config.js中修改相关配置信息
hostPrefix：V5协同服务器域名
appid：小程序AppID
html：要跳转的H5地址，默认为空（微协同首页）
如果遇到以下情况
请将以下内容配置到app.json中
"permission": {
"scope.userLocation": {
"desc": "你的位置信息将用于进行考勤签到"
}
},
"requiredPrivateInfos":["getLocation"]
4.上传代码
# 6、开通获取当前地理位置，速度接口权限
从2022.4.18日起，小程序版本的发布审核需要配置获取位置接口权限，不然审核会失败。
1.首先进入小程序获取当前地理位置接口，找到申请开通项，找到符合当前小程序的类目。小程序获取当前地理位置接口地址为：https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.getLocation.html (opens new window)
2.进入小程序后台管理新增类目，类目包含当前地理位置接口申请开通项的内容。如果当前小程序的类目已经有了当前地理位置接口申请开通项的内容，则可不用再次添加了。
3.去开通获取当前地理位置、速度接口权限
4.接口权限申请过后方可发布小程序版本
注：申请原因可以多写一点，可以介绍小程序的功能点等等，最后突出需要获取地理位置信息的原因(比如说员工打卡需要获取地理位置)。写少了会申请不过。辅助图片可以截图小程序的操作页面。
# 7、小程序代码审核
在【开发管理】中维护，将开发版本提交审核，也可选为体验版本先进行体验测试
- 提交微信审核，可能需要测试账号才能通过审核
# 8、小程序发布
在【开发管理】中维护，将审核通过版本正式发布使用
# 9、小程序使用
公布小程序码，通过扫码使用，使用方式有两种：
手机号一键登录，通过手机号免绑定，前提是微信绑定的手机号和协同账号的手机号一致
协同账号登录，通过协同账号密码绑定
# 10、常见问题
如果小程序在微信开发者工具上调试是正常的，但是发布上线后手机使用却提示“协同服务无响应，点击确定退出小程序”。可以通过体验版测试，在vconsole中看是否有如下报错。如果有的话，那就是域名证书连不完整造成的，请更新证书链即可。
解决方案：
- 通过 https://myssl.com/ 检测证书状态，该网站有缓存，如果有更换过证书记得手动点刷新报告
- 如果是证书链不完整，参照指引 https://blog.myssl.com/faq-miss-ca-certificate/ 解决即可
- 参考链接https://blog.csdn.net/qq_40881695/article/details/125107653
快速跳转
