微信小程序转快应用工具

快应用 Jun 12, 2020

对于已经拥有微信小程序的人来说,为了加入快应用生态而重新开发一套快应用的话,这个过程是很耗时间和精力的,为此我们推出了小程序转快应用工具,用于将微信小程序转换为快应用兼容版。

微信小程序与快应用兼容版的语法有 95% 以上的相似度,通过 IDE 插件或者 npm 包,我们可以实现从微信小程序源码到快应用源码的一键转换。

1. 使用 IDE 插件转换

  1. 下载快应用开发工具
  2. 搜索 hap-transformer 插件并安装。

小程序转快应用插件

  1. 安装完成之后运行插件,mac 电脑上(Cmd + Shift + P),windows 电脑上(Ctrl + Shift + P)打开命令台并输入 transfer wechat miniprogram into quick app,或者在 IDE 3.1.0 版本之后,侧边栏上增加了快捷功能入口也可以运行插件的功能。
  2. 选择相应的小程序输入目录和相应的输出路径,并选择兼容模式,点击转换即可。

小程序转快应用插件

通过以上两种方法你将得到转换后的快应用项目,之后我们就可以在IDE中预览项目结果了

接下来我们要在开发工具中的插件市场中搜索并下载 hap-chimera-toolkit ,安装该插件之后的开发工具就可以预览快应用兼容版了,点击上面的模拟器按钮即会弹出右侧的模拟窗口。

快应用编译插件

  1. 在真机上安装快应用调试引擎之后,点击预览界面上面的二维码标志,用手机调试器的扫码便可以在真机上安装快应用啦~,微信小程序就这样轻松的转换成为了快应用!

2. 使用 npm 包转换

2.1 安装 qa-adapter

qa-adapter 可用于帮助已有微信小程序或者支付宝小程序的开发者,快速将项目适配到快应用兼容版中去。

使用 npm 安装:

npm install -g qa-adapter

使用 yarn 安装:

yarn add -g qa-adapter

2.2 使用 qa-adapter

使用 adt 命令转换项目

adt [sourceDir] [destDir?optional]

参数说明

参数 作用
-v,--version 输出工具版本号
-l,--logs 在转换后项目的根目录中输出转换记录文件 logs.txt
-d,--diff 在转换后项目的 .quickapp 目录中生成转换前后代码的对比报告

2.3 举个栗子

对于我们已经上架了的微信小程序 性能排行榜

小程序demo

只需一条命令就能转换为快应用:

adt ./miniprogram/rank ./quickapp/rank

转换结果:

快应用demo

可以看到转换过来的快应用的界面显示,数据请求,页面路由等过程都是正确的。

也可以使用 -d 生成转换前后的代码对比结果。

adt -d ./miniprogram/rank ./quickapp/rank

小程序转快应用

对于 95% 以上的小程序可以做到一键转换,对于中大型的小程序,转换工具也可以减少 95% 的迁移工作量。

3. Getting deeper

我们截取部分之前提过的 diff.txt 看看转换工具为我们做了哪些转换。

diff.txt 其中 ... 表示省略了部分内容。

- Expected
+ Received

  fileList
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
  [
    ".gitignore",
-   "app.wxss",
+   "app.css",
		.....
-   "pages/index/index.wxss",
+   "pages/index/index.css",
    "pages/index/index.js",
    "pages/index/index.json",
-   "pages/index/index.wxml",
+   "pages/index/index.qxml",
-   "pages/page1/page1.wxss",
+   "pages/page1/page1.css",
    "pages/page1/page1.js",
    "pages/page1/page1.json",
-   "pages/page1/page1.wxml",
+   "pages/page1/page1.qxml",
-   "pages/page2/page2.wxss",
+   "pages/page2/page2.css",
    "pages/page2/page2.js",
    "pages/page2/page2.json",
-   "pages/page2/page2.wxml",
+   "pages/page2/page2.qxml",
-   "pages/sbpk1/one/one.wxss",
+   "pages/sbpk1/one/one.css",
    "pages/sbpk1/one/one.js",
    "pages/sbpk1/one/one.json",
-   "pages/sbpk1/one/one.wxml",
+   "pages/sbpk1/one/one.qxml",
-   "pages/sbpk1/two/two.wxss",
+   "pages/sbpk1/two/two.css",
    "pages/sbpk1/two/two.js",
    "pages/sbpk1/two/two.json",
-   "pages/sbpk1/two/two.wxml",
+   "pages/sbpk1/two/two.qxml",
-   "project.config.json",
+   "quickapp.config.json",
    "sitemap.json"
  ]



  .gitignore
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  test-ignore

+ .quickapp/build
+ .quickapp/dist
+


- app.wxss
+ app.css
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"

  app.js
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
+ // 本次转换使用的转换器版本:1.0.18
  //app.js
  App({
-   onLaunch: function () {
-   },
+   onLaunch: function () {},
-   globalData: {
-   }
+   globalData: {}
- })
+ });



  app.json
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
  {
-   "pages": ["pages\\index\\index", "pages\\page1\\page1", "pages\\page2\\page2"],
+   "package": "com.example.demo",
+   "name": "demo",
+   "icon": "assets/images/logo.png",
+   "versionName": "1.0",
+   "versionCode": 1,
+   "minPlatformVersion": 1062,
+   "pages": [
+   "pages/index/index",
+   "pages/page1/page1",
+   "pages/page2/page2"
+   ],
		....
    "tabBar": {
    "color": "#666666",
    "selectedColor": "#19A0F0",
    "borderStyle": "white",
    "backgroundColor": "#FFFFFF",
    "list": [
    {
-   "pagePath": "pages\\index\\index",
+   "pagePath": "pages/index/index",
-   "iconPath": "images\\icon\\home.svg",
+   "iconPath": "images/icon/home.svg",
-   "selectedIconPath": "images\\icon\\home-selected.svg",
+   "selectedIconPath": "images/icon/home-selected.svg",
    "text": "首页"
    },
    {
-   "pagePath": "pages\\page1\\page1",
+   "pagePath": "pages/page1/page1",
-   "iconPath": "images\\icon\\test.svg",
+   "iconPath": "images/icon/test.svg",
-   "selectedIconPath": "images\\icon\\test-selected.svg",
+   "selectedIconPath": "images/icon/test-selected.svg",
    "text": "测试"
    },
    {
-   "pagePath": "pages\\page2\\page2",
+   "pagePath": "pages/page2/page2",
-   "iconPath": "images\\icon\\test1.svg",
+   "iconPath": "images/icon/test1.svg",
-   "selectedIconPath": "images\\icon\\test1-selected.svg",
+   "selectedIconPath": "images/icon/test1-selected.svg",
    "text": "测试1"
    }
    ]
    },
    "subPackages": [
    {
-   "root": "pages\\sbpk1",
+   "root": "pages/sbpk1",
-   "pages": ["one\\one", "two\\two"]
+   "pages": [
+   "one/one",
+   "two/two"
+   ]
    }
    ],
    "sitemapLocation": "sitemap.json"
  }


- pages/index/index.wxss
+ pages/index/index.css
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"

 ...
 # 省略部分文件


- pages/index/index.wxml
+ pages/index/index.qxml
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"

- <view>{{ a <t
-   ?"a":"taglike"}}</view>
+ <view>{{a < t ? "a" : "taglike"}}</view>




- project.config.json
+ quickapp.config.json
  "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
  {
  	"description": "项目配置文件",
  	"condition": {
  		"search": {
  			"current": -1,
  			"list": []
  		},
  		"conversation": {
  			"current": -1,
  			"list": []
  		},
  		"game": {
  			"currentL": -1,
  			"list": []
  		},
  		"miniprogram": {
  			"current": -1,
  			"list": []
  		}
  	}
  }

从 diff.txt 中可以看出,转换工具帮我们进行了以下转换:

  1. .wxss 文件转换为 .css 文件
  2. .wxml => .qxml 文件
  3. 部分 wx 开头的 api 转换为 qa 开头。
  4. 将小程序项目配置文件 project.config.json 转换为快应用兼容版项目配置文件 quickapp.config.json
  5. 代码格式化
  6. .gitignore 文件内容自动追加 .quickapp/build .quickapp/dist
  7. app.json 中添加了一些默认字段

微信小程序与快应用兼容版的差异请参考这里

4. 总结

快应用兼容版能够大幅度减少微信小程序的拥有者接入快应用生态的成本,简单的转换之后就能够运行在快应用平台上,能极大的节省开发成本。

联系我们

如果您有任何问题以及需求,欢迎随时联系我们~
qrcode

vivo developer

Among with pengjie

快应用引擎、工具开发者、快应用生态拓展达人(vivo)。

Great! You've successfully subscribed.
Great! Next, complete checkout for full access.
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.