网页程序迁移至微信小程序web-view详解

时间: 2018-08-03阅读: 4728标签: 小程序

小程序现在越来越流行,但是公司的很多项目都是用网页写的,小程序语法不兼容原生网页,使得旧有项目迁移至小程序代价很高; 小程序之前开放了webview功能,可以说是网页应用的一大福音了,但是微信的webview有一些坑,这篇文章就是列举一下我在开发过程中遇到的一些问题以及我找到的一些解决方案。


    openid登录问题

    微信webview的使用方法很简单,只要如下设置src就可以展示具体的网站了。

    <!-- wxml -->
    <!-- 指向微信公众平台首页的web-view -->
    <web-view src="https://mp.weixin.qq.com/"></web-view>

    微信环境里的很多网页都是用页面要实现网站的登录功能,只要把登录的信息,比如openid或者其他信息拼接到src里就好了。
    这里有个问题,公众号的账号体系一般是以openid来判断唯一性的,小程序是可以获取openid的,但是小程序的openid和原公众号之类的openid是不一样的,需要将原先的openid账号体系升级为unionid账号体系。

    以下是微信对unionid的介绍

    获取用户基本信息(UnionID机制)

    在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的。对于不同公众号,同一用户的openid不同)。公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间。 
    请注意,如果开发者有在多个公众号,或在公众号、移动应用之间统一用户帐号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才可利用UnionID机制来满足上述需求。

    UnionID机制说明:

    开发者可通过OpenID来获取用户基本信息。特别需要注意的是,如果开发者拥有多个移动应用、网站应用和公众帐号,可通过获取用户基本信息中的unionid来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号,用户的unionid是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。

    做完以上步骤,就可以调用小程序api wx.getUserInfo() 来获取用户信息了,此步骤需要进行后台信息解密过程,在此就不再赘述,结合小程序api文档操作就好。

    获取到unioid之后,将unionid信息拼接到src就可以进行网页登录操作了(前提是网页可以用跳转链接的方式登录,类似公众号页面获取openid的形式)。


    webview动态src

    微信的webview有个坑的地方,不会动态的监听src的变化,这就造成了一个问题,要通过改变src实现页面跳转就不可以了。
    我尝试了一些方法之后,找到了一个解决方案:

    微信webview在页面load的时候会加载一次webview,我们就利用这个特性来实现动态src问题。

    1. 首先把要跳转的链接信息设置成全局变量,要改变src的时候,先把要src以’?‘拆分为链接和参数两部分,存入全局函数,再调用onLoad就可以实现webview刷新了。
    2. 页面跳转时,我们也需要src的动态刷新,所以要把链接信息存入全局函数;页面跳转时,onShow函数会被调用,这时候再调用一次onLoad就可以了。
    data: {
        url: '',
        loaded: false
    }
    // 小程序js里的onLoad函数可以写成这样
    onLoad: function () {
        this.setData({
          url: getApp().globalData.urlToken + '?' +  getApp().globalData.urlData
        })
    },
    changUrl: function () {
        getApp().globalData.urlToken = 'https://www.example.com'
        getApp().globalData.urlToken = 'a=1&b=2'
        // 直接调用onLoad,就会实现src的刷新
        this.onLoad()
    },
    onShow: function () {
        if (!this.data.loaded) {
          // 第一次不运行
          this.setData({
            loaded: true
          })
          return
        }
        // 直接调用onLoad,就会实现src的刷新
        this.onLoad()
      }
    
    // wxml可以写成这样
    <web-view src="{{url}}"></web-view>


    支付功能

    webview里面可以通过jssdk来实现一些小程序功能,但不能直接调用小程序的支付功能,这时候我们就需要转变一下策略了:

    1. 在网页里引入微信jssdk
    2. 在网页需要发起支付的地方,调用跳转页面的接口,控制小程序跳转到小程序的支付页面(这个要在小程序里单独写的),跳转的时候,需要把订单的一些信息都拼接到链接里,订单信息由后台返回,需要通过微信支付系统的统一下单接口,具体参看支付文档。
    3. 跳转到小程序支付页面后,由小程序页面发起支付,支付完成后跳转回webview页面,通过之前设置的动态src,控制webview跳转到特定的页面。
    // 网页引入jssdk
    // 网页发起支付
    wx.miniProgram.navigateTo({
        // payData由后台返回,主要是需要统一下单平台的prepay_id
        url: '../pay/index?data=' + encodeURIComponent(JSON.stringify(payData))
    })
    // 微信支付页面
    onLoad: function (option) {
        let page = this
        try {
          let data = JSON.parse(option.data)
          if (!data || !data.prepay_id) {
            console.error('支付参数错误,请稍后重试', data)
          }
          wx.requestPayment({
            timeStamp: '' + data.timestamp,
            nonceStr: data.nonceStr,
            package: 'prepay_id=' + data.prepay_id,
            paySign: data.paySign,
            signType: data.signType,
            success: function (res) {
              getApp().globalData.urlToken = `paySuccess.html`
              // 支付成功
              getApp().globalData.urlData = 'data=paySuccessData'
              wx.navigateTo({
                url: '/page/home/index',
              })
            },
            fail: function (res) {
              getApp().globalData.urlToken = `payError.html`
              // 支付失败
              getApp().globalData.urlData = 'data=payErrorData'
              wx.navigateTo({
                url: '/page/home/index',
              })
            },
            complete: function (res) {
            }
          })
        } catch (e) {
          console.error('支付错误', e)
        }
      }


    分享功能

    小程序直接分享的webview所在的页面,如果需要加上页面参数,那我们就需要处理一下了。

    1. webview内是不能直接发起分享的,需要先用wx.miniProgram.postMessage接口,把需要分享的信息,推送给小程序;推送给小程序的信息不是实时处理的,而是用户点击了分享按钮之后,小程序才回去读取的,这就要求每个需要分享的页面再进入的时候就发起wx.miniProgram.postMessage推送分享信息给小程序。
    2. 小程序页面通过bindmessage绑定的函数读取post信息,分享的信息会是一个列表,我们取最后一个分享就好,把分享信息处理好,存到data里面以便下一步onShareAppMessage调用。
    3. 用户点击分享时,会触发onShareAppMessage函数,在里面设置好对应的分享信息就好了。
    4. onload函数有一个option参数的,可以读取页面加载时url里带的参数,这时要对原先的onload函数进行改造,实现从option里读取链接信息。
    // 网页wx.miniProgram.postMessage
    wx.miniProgram.postMessage({
      data: {
        link: shareInfo.link,
        title: shareInfo.title,
        imgUrl: shareInfo.imgUrl,
        desc: shareInfo.desc
      }
    })
    // 小程序index wxml设置
    <web-view src="{{url}}" bindmessage="bindGetMsg"></web-view>
    // 小程序index js
    bindGetMsg: function (e) {
        if (!e.detail) {
          return
        }
        let list = e.detail.data
        if (!list || list.length === 0) {
          return
        }
        let info = list[list.length - 1]
        if (!info.link) {
          console.error('分享信息错误', list)
          return
        }
        let tokens = info.link.split('?')
        this.setData({
          shareInfo: {
            title: info.title,
            imageUrl: info.imgUrl,
            path: `/page/index/index?urlData=${encodeURIComponent(tokens[1])}&urlToken=${tokens[0]}`
          }
        })
    },
    onShareAppMessage: function (res) {
        if (res.from === 'button') {
          // 来自页面内转发按钮
          console.log(res.target)
        }
        let that = this
        return {
          title: that.data.shareInfo.title,
          path: that.data.shareInfo.path,
          imageUrl: that.data.shareInfo.imageUrl,
          success: function (res) {
            // 转发成功
          },
          fail: function (res) {
            // 转发失败
          }
        }
    },
    onLoad: function (option) {
        if (option.urlToken) {
          getApp().globalData.urlToken = option.urlToken
        }
        if (option.urlData) {
          getApp().globalData.urlData = option.urlData
        }
        this.setData({
          url: getApp().globalData.urlToken + '?' +  getApp().globalData.urlData
        })
    },


    扫描普通二维码跳转特定页面

    除了分享功能之外,小程序还可以通过配置,实现扫描普通二维码跳转特定页面的功能。

    以下是微信对此功能的介绍

    为了方便小程序开发者更便捷地推广小程序,兼容线下已有的二维码,微信公众平台开放扫描普通链接二维码跳转小程序能力。
    功能介绍
    普通链接二维码,是指开发者使用工具对网页链接进行编码后生成的二维码。
    线下商户可不需更换线下二维码,在小程序后台完成配置后,即可在用户扫描普通链接二维码时打开小程序,使用小程序的功能。
    对于普通链接二维码,目前支持使用微信“扫一扫”或微信内长按识别二维码跳转小程序.

    二维码规则
    根据二维码跳转规则,开发者需要填写需要跳转小程序的二维码规则。要求如下:

    1. 二维码规则的域名须通过ICP备案的验证。
    2. 支持http、https、ftp开头的链接(如:http://wx.qq.com、https://wx.qq.com/mp/、https://wx.qq.com/mp?id=123)。
    3. 一个小程序帐号可配置不多于10个二维码前缀规则。

    前缀占用规则

    开发者可选择是否占用符合二维码匹配规则的所有子规则。如选择占用,则其他帐号不可申请使用满足该前缀匹配规则的其他子规则。

    如:若开发者A配置二维码规则:https://wx.qq.com/mp?id=123,并选择“占用所有子规则“,其他开发者将不可以配置满足前缀匹配的子规则如https://wx.qq.com/mp?id=1234

    我推荐的方式
    webview实现方式

    1. 设置跳转功能小程序后台就可以设置,链接是分为四部分,路https://www.example.com/wxmin...

      https://www.example.com域名
      /wxmini/小程序前置规则,需要在服务器上建一个文件夹,并且把验证文件放在文件夹线
      home.html需要跳转的网页页面
      a=1跳转页面的参数
    2. 对onload函数再进行处理,实现普通二维码跳转。
    // 对index onLoad在进行处理
    onLoad: function (option) {
        this.resetOption(option)
        if (option.urlToken) {
          getApp().globalData.urlToken = option.urlToken
        }
        if (option.urlData) {
          getApp().globalData.urlData = option.urlData
        }
        this.setData({
          url: getApp().globalData.urlToken + '?' +  getApp().globalData.urlData
        })
    },
    resetOption: function (option) {
        if (!option) {
          return
        }
        if (option.q) {
          option.q = decodeURIComponent(option.q)
          if (option.q.indexOf('https://www.example.com/wxmini/') == -1) {
            return
          }
          let tmp = option.q.replace('/wxmini', '')
          let tmps = tmp.split('?')
          option.urlToken = tmps[0]
          option.urlData = tmps[1]
        } else {
          option.urlData = decodeURIComponent(option.urlData)
        }
    }


    返回按钮缺失问题

    如果web页面是在第一个页面的话,这时候会有一个问题,小程序的返回按钮就没有了,webview无法使用微信的返回按钮了,这时候只要在webview页面前多加一个跳转页面就好了(第一个页面也可以设置成获取用户权限的页面,不过我感觉这样体验不好,也不是所有页面都要用户获取了权限才可以使用)

    最终的页面层级
    "pages": [
        "page/index/index", // 首页,处理onload里的option内容,为了返回按钮设置的
        "page/home/index", // webview所在的页面
        "page/auth/index", // 获取用户权限的页面
        "page/pay/index", // 支付页面
        "page/error/index" // 错误信息页面
      ],

    参考链接

    1. webview文档
    2. 小程序unionid介绍
    3. unionid获取方式

    原文来源:NeoPasser 


    站长推荐

    1.云服务推荐: 国内主流云服务商,各类云产品的最新活动,优惠券领取。地址:阿里云腾讯云华为云

    链接: http://www.fly63.com/article/detial/974

    微信小程序遇到的坑

    微信小程序开发之路上遇到的那些坑,微信小程序开发常见之坑总结,在开发过程中碰到的问题和解决:小程序textarea组件字数限制问题 、scroll-view 中不能使用 textarea 组件 、input组件的问题、关于数据绑定的问题、关于生命周期的问题、关于picker组件

    微信小程序版本自动更新

    当用户点击左上角关闭,或者按了设备Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台,只有当小程序进入后台一定时间

    mpvue开发微信小程序基础知识

    mpvue 是一个使用 Vue.js 开发小程序的前端框架。框架基于 Vue.js 核心,mpvue 修改了 Vue.js 的 runtime 和 compiler 实现,使其可以运行在小程序环境中,从而为小程序开发引入了整套 Vue.js 开发体验。mp 即 mini program 的缩写。

    微信小程序通过保存图片分享到朋友圈

    小程序内是不能直接分享到朋友圈的。所以只能通过生成图片,携带小程序二维码,保存到手机相册,让用户自己选择发到朋友圈。然后可以通过在小程序中识别二维码来进入小程序的指定页面

    记一次小程序样式优化重构

    在开发的过程中遇到了一些问题,但是最终减少了不少样式代码,同时功能上也更加强大。进一步来说,如果在后面我们的小程序用户想要自己定制化主题,也可以很快的实现。

    小程序如何改变onLoad 的执行时机?

    也许在小程序所有生命周期里,我们用的最多的就是 onLoad,一大堆代码都要在初始化的时候执行。很多时候,初始化的代码是每个页面共用的,比如获取用户信息、获取定位等:

    微信小程序跳转小程序

    以前小程序跳小程序直接通过api调用跳转即可,但在2018.11.1下午微信公众平台通知需做navigateToMiniProgramAppIdList配置,否则无法提交审核,配置要跳转的微信小程序id ,最多不能超过10个。

    小程序web-view关闭后,页面音频没有关闭

    在web-view的src中,引入了一个HTML5页面,这个页面有个自动播放的音频。在小程序中,点击右上角关闭小程序后,web-view页面中的音频依然会播放。

    小程序返回上一个页面并更新上一个页面的数据

    小程序开发过程中经常有这种需求,需要把当前页面数据传递给上一个页面,但是wx.navigateBack()无法传递数据。

    微信小程序WXS之谜

    微信创造了 WXS ,除了提高性能,还有什么原因?WXS(WeiXin Script)是微信创造的一套脚本语言,它的官方说法是:“WXS 与 JavaScript 是不同的语言,有自己的语法,并不和 JavaScript 一致”。

    点击更多...

    内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!