微信小程序转 Taro

自 v1.2.0 开始支持此功能

Taro 可以将你的原生微信小程序应用转换为 Taro 代码，进而你可以通过 taro build 的命令将 Taro 代码转换为对应平台的代码，或者对转换后的 Taro 代码用 React 的方式进行二次开发。

微信原生小程序转 Taro 的操作非常简单，首先必须安装使用 npm i -g @tarojs/cli 安装 Taro 命令行工具，其次在命令行中定位到小程序项目的根目录，根目录中运行：

  1. $ taro convert

即可完成转换。转换后的代码保存在根目录下的 taroConvert 文件夹下。你需要定位到 taroConvert 目录执行 npm install 命令之后就可以使用 taro build 命令编译到对应平台的代码。

二次开发

假设已有一个转换后文件如下：

  1. import { View } from '@tarojs/components'
  2. import Taro from '@tarojs/taro'
  3. import withWeapp from '@tarojs/with-weapp'
  4. import './index.scss'
  6. var app = Taro.getApp()
  8. @withWeapp('Page')
  9. class _C extends Taro.Component {
  10.   state = {}
  12.   componentWillMount(e) {
  13.     var orderId = e.id
  14.     this.data.orderId = orderId
  15.   }
  17.   componentDidShow() {
  18.     var that = this
  19.     Taro.request({
  20.       url: 'https://api.it120.cc/' + app.globalData.subDomain + '/order/detail',
  21.       data: {
  22.         token: Taro.getStorageSync('token'),
  23.         id: that.data.orderId
  24.       },
  25.       success: res => {
  26.         Taro.hideLoading()
  27.         if (res.data.code != 0) {
  28.           Taro.showModal({
  29.             title: '错误',
  30.             content: res.data.msg,
  31.             showCancel: false
  32.           })
  33.           return
  34.         }
  35.         that.setData({
  36.           orderDetail: res.data.data,
  37.           logisticsTraces: res.data.data.logisticsTraces.reverse()
  38.         })
  39.       }
  40.     })
  41.   }
  43.   config = {
  44.     navigationBarTitleText: '物流详情'
  45.   }
  47.   render() {
  48.     const {
  49.       orderDetail: orderDetail,
  50.       logisticsTraces: logisticsTraces
  51.     } = this.state
  52.     return (
  53.       <View className="container">
  54.         <View className="top-sec">
  55.           <View className="a-row">
  56.             <View className="label">物流单号</View>
  57.             <View className="text">{orderDetail.logistics.trackingNumber}</View>
  58.           </View>
  59.           <View className="a-row">
  60.             <View className="label">物流公司</View>
  61.             <View className="text">{orderDetail.logistics.shipperName}</View>
  62.           </View>
  63.         </View>
  64.         <View className="sec-wrap">
  65.           <View className="details-info">
  66.             <View className="line-box" />
  67.             {logisticsTraces.map((item, index) => {
  68.               return (
  69.                 <View className="a-row" key={index}>
  70.                   <View className="dot">
  71.                     <View
  72.                       className="active-dot"
  73.                       hidden={index == 0 ? false : true}
  74.                     >
  75.                       <View className="yuan-red" />
  76.                     </View>
  77.                     <View
  78.                       className="default-dot"
  79.                       hidden={index == 0 ? true : false}
  80.                     />
  81.                   </View>
  82.                   <View className="info">
  83.                     <View className="date-box">{item.AcceptTime}</View>
  84.                     <View className="text">{item.AcceptStation}</View>
  85.                   </View>
  86.                 </View>
  87.               )
  88.             })}
  89.           </View>
  90.         </View>
  91.       </View>
  92.     )
  93.   }
  94. }
  96. export default _C

它看起来就像普通的 Taro 组件，最重要的区别就在于 @withWeapp() 这个装饰器，你可以将它理解为转换代码的运行时，@withWeapp() 会增加一些原来 Taro 没有方法和属性，例如：

this.setData

转换后的 this.setData 的 API 相当于小程序的 this.setData 的 polyfill，他和 this.setState 最大的区别就在于，this.setData 之后 data 的数据是同步更新，而渲染是异步更新，而 setState 两者都是异步的。

this.data 和 this.properties

this.data 和 this.properties 相当于 Taro 的 this.state 和 this.props 的 alias，当它们的数据更新时，对应的 state 和 props 也会同步更新。

生命周期

Taro 会将原始文件的生命周期钩子函数转换为 Taro 的生命周期，完整对应关系如下：

Page.onLoadcomponentWillMount
onShowcomponentDidShow
onHidecomponentDidHide
onReadycomponentDidMount
onUnloadcomponentWillUnmount
onErrorcomponentDidCatchError
App.onLaunchcomponentWillMount
Component.createdcomponentWillMount
attachedcomponentDidMount
readycomponentDidMount
detachedcomponentWillUnmount
moved保留

常见问题

在小程序 IDE 显示 _createData 错误

这个错误通常是由于原始代码的初始 data 中没有对应的数据，后来通过 this.setData 补充数据造成的。在 Taro 中推荐不管是 state(data) 还是 properties(props) 都要设置一个默认值。你可以在类构造器或修改原始代码提供一个默认值解决这个问题，这也应该是编写代码的最佳实践。

转换 wxParse 报错不存在文件

这是由于 wxParse 的源码使用了一个不存在的 template 声明造成的。你可以修改 wxParse 的源码文件 wxParse.wxml 134 行到 207 行：

  1. <!--循环模版-->
  2. <template name="wxParse1">
  3.   <!--<template is="wxParse1" data="{{item}}" />-->
  4.   <!--判断是否是标签节点-->
  5.   <block wx:if="{{item.node == 'element'}}">
  6.     <block wx:if="{{item.tag == 'button'}}">
  7.       <button type="default" size="mini">
  8.         <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  9.           <template is="wxParse0" data="{{item}}" />
  10.         </block>
  11.       </button>
  12.     </block>
  13.     <!--li类型-->
  14.     <block wx:elif="{{item.tag == 'li'}}">
  15.       <view class="{{item.classStr}} wxParse-li" style="{{item.styleStr}}">
  16.         <view class="{{item.classStr}} wxParse-li-inner">
  17.           <view class="{{item.classStr}} wxParse-li-text">
  18.             <view class="{{item.classStr}} wxParse-li-circle"></view>
  19.           </view>
  20.           <view class="{{item.classStr}} wxParse-li-text">
  21.             <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  22.               <template is="wxParse0" data="{{item}}" />
  23.             </block>
  24.           </view>
  25.         </view>
  26.       </view>
  27.     </block>
  29.     <!--video类型-->
  30.     <block wx:elif="{{item.tag == 'video'}}">
  31.       <template is="wxParseVideo" data="{{item}}" />
  32.     </block>
  34.     <!--img类型-->
  35.     <block wx:elif="{{item.tag == 'img'}}">
  36.       <template is="wxParseImg" data="{{item}}" />
  37.     </block>
  39.     <!--a类型-->
  40.     <block wx:elif="{{item.tag == 'a'}}">
  41.       <view bindtap="wxParseTagATap" class="wxParse-inline {{item.classStr}} wxParse-{{item.tag}}" data-src="{{item.attr.href}}" style="{{item.styleStr}}">
  42.         <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  43.           <template is="wxParse0" data="{{item}}" />
  44.         </block>
  45.       </view>
  46.     </block>
  47.     <block wx:elif="{{item.tag == 'table'}}">
  48.       <view class="{{item.classStr}} wxParse-{{item.tag}}" style="{{item.styleStr}}">
  49.         <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  50.           <template is="wxParse0" data="{{item}}" />
  51.         </block>
  52.       </view>
  53.     </block>
  55.     <block wx:elif="{{item.tag == 'br'}}">
  56.       <template is="WxParseBr"></template>
  57.     </block>
  58.     <!--其他块级标签-->
  59.     <block wx:elif="{{item.tagType == 'block'}}">
  60.       <view class="{{item.classStr}} wxParse-{{item.tag}}" style="{{item.styleStr}}">
  61.         <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  62.           <template is="wxParse0" data="{{item}}" />
  63.         </block>
  64.       </view>
  65.     </block>
  67.     <!--内联标签-->
  68.     <view wx:else class="{{item.classStr}} wxParse-{{item.tag}} wxParse-{{item.tagType}}" style="{{item.styleStr}}">
  69.       <block wx:for="{{item.nodes}}" wx:for-item="item" wx:key="">
  70.         <template is="wxParse0" data="{{item}}" />
  71.       </block>
  72.     </view>
  74.   </block>
  76.   <!--判断是否是文本节点-->
  77.   <block wx:elif="{{item.node == 'text'}}">
  78.     <!--如果是，直接进行-->
  79.     <template is="WxEmojiView" data="{{item}}" />
  80.   </block>
  82. </template>

把 <template name="wxParse1"> 的模板内所有 <template is="wxParse2" data="{{item}}" /> 修改为 <template is="wxParse0" data="{{item}}" /> 再运行 taro convert 即可。这样修改之后还会取消原来 wxParse 只能处理 11 级 HTML 嵌套的问题，理论上内存不爆栈可以处理无限级 HTML 嵌套。

不支持 relations 和 Behavior

目前转换暂只支持转换 Page、Component 、App 三种构造器创造的小程序组件实例。 relations 和 Behavior 在其他许多小程序端中还没有对应的实现，我们认为实现这两个功能意义不大。

转换 wepy 文件不成功

目前只能支持转换使用原生微信小程序开发的应用。