wx2swan/docs/Tutorial.md

微信小程序 转换 百度小程序

# Tutorial

## FAQ

#### 怎么使用这个工具：
1. ```npm install -g wx2swan```;
2. ```wx2swan ./wxmp``` wxmp是你的微信小程序的目录；
3. 运行完命令后，会在`wxmp`同级生成个`wxmp_swan`的目录（命令中不指定目标文件夹的话，则为默认的），用`百度开发者工具`打开刚刚生成的百度小程序（`wxmp_swan`）；

#### WTF~, 通过开发者工具打开后，发现白页
> 一般这种情况，是js报错引起的，入口js文件有报错阻塞了
后续的执行；

1. 由于Runtime不是完全一致，请根据具体的js报错去调代码；
2. 由于API没有完全实现，有些API可能暂不支持，还需要自行根据业务逻辑去绕过；
3. 有些报错是由于没有支持二级API导致的，比如`createInnerAudioContext `会返回一个对象，这个对象还有一系列操作方法，当我们一级API都还没有支持的情况下，二级的自然会报错啦。这种情况，还需要绕过去兼容。不过，我们工程师已经997夜以继日的去磨平啦，在不久的将来，都会有的~~

#### 模板的问题
##### WTF，我的有些标签，为毛没有生效
1. 我们的组件标签可能还没有支持，这个也需要棒棒的你，去手动兼容下，并期待着我们后续的Runtime迭代；
2. 用了import + template，为了工程良好的架构，这种做法的确是值得提倡的。可惜swan小程序目前，对这种方式支持的还不够完善，建议写一个文件里，生活总是很美好，emmmm~~~~ 并期待着我们后续的Runtime迭代；
3. 检查下模板语法中的循环语句，swan小程序支持最基本的用法，够用但不花哨，come on~ [swan模板循环语句](http://smartapp.baidu.com/docs/develop/framework/framework/#%E5%BE%AA%E7%8E%AF)

#### WTF~, 页面出来了，我的样式乱了
1. 首先，可能由于上面标签没有生效，导致你的样式乱了；
2. 微信小程序css用了rpx，swan小程序提倡w3c标准的vw，不标新立异，当然，当你使用了rpx,也不需要手动去转换啦，我们会有算法帮忙转一下。目前已知，对字体`font-size`有差异，这个可能需要机智的你用px去微调一下；
3. 样式嘛，总是需要微调的，页面都出来了，css难不住机智滴你，come on~ 微调一下吧~

#### EXO, 说好的转换log，log文件在哪里讷
- log文件在你执行命令的目录的下面，`log.js`;

#### WTF~, 搬家工具转换失败啦？
1. 这种情况一定需要反馈给我们，邮箱、客服、issue，一切你能找到我们的方式，都是可以的。