title: 微信小程序转 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.onLoad componentWillMount
onShow componentDidShow
onHide componentDidHide
onReady componentDidMount
onUnload componentWillUnmount
onError componentDidCatchError
App.onLaunch componentWillMount
Component.created componentWillMount
attached componentDidMount
ready componentDidMount
detached componentWillUnmount
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 文件不成功

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