H5上架浙里办App、支付宝小程序、微信小程序相关流程

您所在的位置:网站首页 浙里办app怎么登录 H5上架浙里办App、支付宝小程序、微信小程序相关流程

H5上架浙里办App、支付宝小程序、微信小程序相关流程

2024-07-17 00:58| 来源: 网络整理| 查看: 265

这个项目折磨了我挺长时间的,主要卡在上架浙里办的流程上,(网上也看了很多文章,但有的点地方还是解决不了,只能一步一坑的走啦)所以就记录一下吧。

说一下需要注意的点吧(其实也就那么三四点,相信你已经搜过很多文章了):

1、埋点

这埋点咋说呢,就按照这里提供的文档赋值粘贴过来就行了,替换一下你的项目名称和项目Apppid就好了。如果项目没有特定的需求,把基础埋点埋好就行了。

首先在入口文件index.html放入采集的SDK:

//这个是引用浙里办提供的api ,注意版本是1.1.0的,注意更新。网上很多文章都是老文章了,都是1.0.1的。

 

然后把基础的埋点放到script中

//这个是调用浙里办的zwjsbridge.js api 先初始化 ZWJSBridge.onReady(() => { console.log('初始化完成后,执行bridge方法',ZWJSBridge) }) (function(w, d, s, q, i) { w[q] = w[q] || []; var f = d.getElementsByTagName(s)[0], j = d.createElement(s); j.async = true; j.id = "beacon-aplus"; j.src = "https://d.alicdn.com/alilog/mlog/aplus.js?id=202951085"; f.parentNode.insertBefore(j, f); })(window, document, "script", "aplus_queue"); aplus_queue.push({ action: 'aplus.setMetaInfo', arguments: ['aplus-waiting', 'MAN'] }); aplus_queue.push({ action: "aplus.setMetaInfo", arguments: ["aplus-rhost-v", "alog.zjzwfw.gov.cn"], }); aplus_queue.push({ action: "aplus.setMetaInfo", arguments: ["aplus-rhost-g", "alog.zjzwfw.gov.cn"], }); aplus_queue.push({ action: "aplus.setMetaInfo", arguments: ["appId", "60506758"], }); aplus_queue.push({ action: "aplus.sendPV", arguments: [ { is_auto: false }, { miniAppId: "20202xxxxxx", miniAppName: "这里是你项目名", }, ], });

就上面这一段就完成埋点任务了,如果需要采集用户信息的话,就在那个页面埋点:

aplus_queue.push({ action: 'aplus.setMetaInfo', arguments: ['_hold', 'BLOCK'] }); aplus_queue.push({ action: 'aplus.setMetaInfo', arguments: ['_user_nick', this.userName] //这个是用户名称的埋点 }); aplus_queue.push({ action: 'aplus.setMetaInfo', arguments: ['_user_id', this.userId] //这个是用户Id的埋点 }); aplus_queue.push({ action: 'aplus.setMetaInfo', arguments: ['_hold', 'START'] }); //说明一下:单页应用的 sendPV 调用需要置于 _hold:BLOCK 和 _hold:START 配置之间。 //就是说你要埋的点需要在BLOCK和START之间执行 先埋BLOCK 后埋START //上面只是个示例,需要埋什么点,就在LOCK和START 之间埋就行

如何查看是否埋点成功,看控制台或者提供项目ID给对接群里的老师帮忙查看(这里说一下,做浙里办项目都需要去对接的,有问题就问里面老师就完了,别不好意思)

2、zwjsbridge.js的使用

zwjsbridge.js的引用和初始化上面已经说了,因为像上传照片视频(上传到浙里办的服务器上)、跳转外部链接,需要用到他们提供的api,当然了,上传照片也可以喊自己家的后台写一个。不过直接用现成的不香嘛 。下面的照片就是部分的api。完整的api在提供的文档里。这里说一下调试,有些调试需要在浙里办提供的Debug工具上测试,这个到时候去对接群里下载,群文件都有。(用钉钉去搜群号添加,我在的3群人还没满,钉钉号(31419900)你们加的时候不知道有没有满,不过也不用担心,到时候业主提供的浙政钉的文件上都会有每个群的群号,自己去挨个加)

3、适老化

我觉得适老化是最简单的了吧。可以喊自己项目组的经理喊UI做两套图,自己照着画就好了,不然就是自己排版一下适老化版本的布局,需要自己去考虑一下,会花一点点时间(如果项目的页面比较多的话)。

xxxx xxxx

这里的$store.state.style就是走登录接口后使用ZWJSBridge.getUiStyle({}) 获取ui环境存全局,这项用vue2写的(用vuex存储)

ZWJSBridge.getUiStyle({}).then((result) => {    console.log('获取系统UI环境',result); // result: {uiStyle: "normal"} // result: {uiStyle: "elder"} //是适老化版本就是elder 正常版就是normal    this.$store.commit('getStyle',result.uiStyle)  }).catch((error) => { }); 4、接口数据请求  

接口数据的请求也是需要走浙里办那边的提供的rpc接口。这个就需要后端到浙里办开发商工作台配置了,前端就不用管了,负责走接口就完事了

首先呢需要安装一个依赖

npm i @aligov/jssdk-mgop --save

然后在request.js中操作:

import { mgop } from '@aligov/jssdk-mgop' const mgopRequest = (payload) => { return new Promise((resolve, reject) => { // 仿照axios的传参方式 const data = Object.assign({}, { api: payload.zwApi, // 必须,政务中台rpc接口的制定名字。例如‘mgop.xxx.app.login’ // host: 'https://mapi.zjzwfw.gov.cn/',// 固定为这个地址 dataType: 'JSON', // 目前官方只支持JSON格式 Headers: { "Content-Type": "text/html;charset=utf-8" }, data: payload.data, // 不管入参是query还是body都统一用data传入,到时候在工作台里配置即可 type: 'POST', // 和axios一样 // isBuffer: payload.isBuffer, appKey: 'xxxxxxxxxxxxxxxxxx', // 必须,政务中台appKey, 系统申请之后大数据局发过来的excel里有 // 成功后的回调 onSuccess: data => { // console.log(data.data) resolve(data.data) }, // 请求失败后的回调 onFail: err => { console.log(err, 'err') reject(err) } }, ) mgop(data) }) } export default { mgopRequest }

在api.js中走接口:

import api from "@/utils/request.js" export function listApi(query) { const data = { //接口名称 这里就是后端在开发工作台配置好的接口,复制过来就ok,也可以叫后端的好朋友整理成文档给你 //这样方便,不然开发商工作台登录只能喊业主帮忙扫码进去,多累啊 zwApi: "mgop.xxxx.xxxx.xxxxx", data: query }; return api.mgopRequest(data) }

在页面的使用:

import { listApi } from "@/api"; export default { data(){ return{ params:{ content:'', page:1, } } }, created(){ this.getList() }, methods:{ getList(){ listApi(this.params).then(res =>{ if (res.result) { xxxx //请求成功后的操作 } else { xxxx //请求失败后的操作 } }) }, }, } 5、单点登录

单点登录呢,如果不清楚流程可能会比较麻烦。但清楚也是很简单滴。

首页,进入浙里办环境后会先判断你是否处于登录状态,不是的话会跳到浙里办登录页,这里统一走他们的登录接口。已登录状态下直接跳项目首页里,这里呢,我需要一个过度页来处理登录过程。你也可以直接跳首页,但直接跳首页会导致你的首页会刷新两次,可能体验不是很好。所以需要一个过渡页,也就是空白页,在空白页进行登录的操作的时候,给个加载的loading,成功后再跳首页,这样会比较好。当然,这只是我自己个人的体验啦。具体看甲方的需求。具体代码:

过渡页(blank.vue)中:

import { ticketValidation,getPersonInfo,weChatTicket } from "@/api"; export default { data() { return { bIsDtDreamApp :null, bIsAlipayMini :null, weChartApply :null, }; }, created(){ let sUserAgent = window.navigator.userAgent.toLowerCase(); this.bIsDtDreamApp = sUserAgent.indexOf("dtdreamweb") > -1; // 浙里办APP this.bIsAlipayMini = sUserAgent.indexOf('miniprogram') > -1 && sUserAgent.indexOf('alipay') > -1; //支付宝小程序 this.weChartApply = sUserAgent.indexOf('micromessenger') > -1 //微信小程序 //判断是否为第一次进入空白页,存储在全局alreadyLogin为true的话 就是说明不是第一次进入,反之则是第一次进入空白页 这个关于到二次回退的问题 if(this.$store.state.alreadyLogin){ ZWJSBridge.close() //不是第一次进入该页面则执行关闭操作回退到浙里办上。 }else{ this.getUrl() //第一次进入该页面,执行该方法 } }, methods: { getUrl(){ // 判断是否为有票据 if (!window.location.href.includes('ticket')) { //判断环境 if (this.bIsAlipayMini) { //如果是在小程序环境下跳转下面的登录地址 window.location.replace("https://puser.zjzwfw.gov.cn/sso/alipay.do?action=ssoLogin&servicecode=xxxxxxx") } else { //如果是在做这里版app环境下跳转下面的登录地址 window.location.replace("https://puser.zjzwfw.gov.cn/sso/mobile.do?action=oauth&scope=1&servicecode=xxxxxxxxx") } }else{ //有票据的情况下则是已登录过的,只要登录过,进入项目地址上都会有ticket票据,小程序的是ticketId this.$store.commit('getLogin',true) //这个就是首次进入该页面后存储一个全局变量,以便于后面判断是否为第一次进改页面 if(this.weChartApply || this.bIsAlipayMini){ //然后执行 获取地址中的ticket或ticketId方法 this.getQuery('ticketId') }else{ this.getQuery('ticket') } } }, // 获取回调地址中的ticket getQuery(sign){ var reg = new RegExp("(^|&)" + sign + "=([^&]*)(&|$)"); var search = window.location.href.substr(1).match(reg); console.log('拿到了url',search); console.log('拿到了url中的ticket',search[2]); //拿到ticket或ticketId后,执行获取用户信息的接口(其实到这一步单点登录算是走完了) //这边为什么还要判断呢,因为我们后端这边走app和小程序的登录分为两个接口,所以需要判断一下 //如果你的后端就只用一个接口就不用判断了, if(this.weChartApply || this.bIsAlipayMini){ //所处环境 let sec = search[2].split('#') this.getChatUserId(sec[0]) }else{ this.getUserId(search[2]) } }, // 浙里办app获取用户信息 getUserId(ticket){ ticketValidation({st:ticket}).then(res =>{ //获取票证 console.log('票据信息',res); this.getInfo(res) }) }, // 小程序获取用户信息 getChatUserId(ticket){ weChatTicket({ticketId:ticket}).then(res =>{ //获取票证 this.getInfo(res) }) }, getInfo(res){ if(res.result){ getPersonInfo({getUserId:res.data.user_id}).then(res =>{ this.$toast.loading({ message: "加载中...", // forbidClick: true, loadingType: "spinner", duration: 0, }); if(res.result){ window.sessionStorage.setItem("userInfo", JSON.stringify(res.data)); this.$router.push('/index') ZWJSBridge.onReady(() => { // 获取系统环境 ZWJSBridge.getUiStyle({}).then((result) => { console.log('获取系统环境',result); this.$store.commit('getStyle',result.uiStyle) }) }); }else{ this.$router.go(-1) } this.$toast.clear(); }) }else{ this.$router.go(-1) } }, }, }; 二次回退和票据补充说明       

因为网上很多文章关于浙里办二次回退问题都是监听页面返回,然后根据判断来执行关闭操作的,相信大家也都看过。就是下面这个方法

window.addEventListener( "pageshow",function(){  xxxx },false)

但是呢,我这边使用这个监听方法,是没有作用的,就点返回按钮的时候function里的操作怎么都不执行。我也不知道是自己没用对呢,或者没监听到pageshow,还是其他啥问题,哈哈哈哈。所以只能想其他办法了。然后就想在单点登录走通后,使用vuex给存储一个全局变量,然后再回退到空白页时,根据存储的值来判断执行回退到浙里办上。

然后就是票据的问题,浙里办app上拿的是ticket,支付宝小程序正式环境下有ticket和ticketId,开发环境下是ticketId,微信小程序拿到的都是ticketId,所以小程序就可以统一都拿ticketId,这样比方便。并且支付宝小程序和微信小程序在开发阶段,项目没有正式上线前,进入小程序里的个人信息都是默认的debug_user_name名称。这是正常的,项目上线后就会拿到个人的真实信息。

好像就想到这了,上述如有不对或不足之处,欢迎大家批评指正。如有其他疑惑之处也可私我



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3