跨平台应用开发进阶(六十二)：如何把 uni-app APP项目转换成小程序

一、前言

随着移动互联网的快速发展，移动应用已成为生活中不可或缺的一部分。与此同时，跨平台开发也得到越来越多的关注，因为它可以提高应用程序的效率并降低开发成本。uni-app是一种跨平台开发框架，基于Vue.js，并且可以在多个平台如微信小程序、支付宝小程序、H5等上运行。对于开发人员来说，这意味着他们可以使用同一个代码库来构建多个平台的应用，而不需要开发不同的代码库。

本文接下来将介绍如何把uni-app转换成小程序，并提供一些有用的技巧和经验。

二、走近 uni-app 和 小程序

在转换uni-app到小程序之前，我们需要先了解一下uni-app和小程序的区别和特点。

uni-app是一种用于构建跨平台应用程序的开源框架。它可以生成多个平台的应用程序，包括小程序、H5、移动端应用等。Uniapp是基于Vue.js框架构建的，并且具有Vue.js的所有功能。uni-app提供了一套组件化编程框架，使开发人员可以轻松创建单个代码库，并在多个平台上运行。

而微信小程序是一种轻量级应用程序，可以在微信App内使用。小程序是基于微信生态系统开发的，因此它们可以直接访问微信提供的API和SDK。小程序的主要目标是为用户提供轻量级快捷的应用，通常只有一个基本的功能。

三、Uniapp 转换成 小程序

在将uni-app转换成小程序之前，需要检查uni-app源代码是否符合小程序规范。uniapp使用了一些小程序不支持的组件或API，例如viewBox、image ignore 等。此外，uni-app也有一些针对小程序的特定组件和API。因此，需要做一些调整，以确保uni-app可以在小程序平台上运行。

在转换过程中，还需要了解哪些组件和API可以直接在小程序中使用，哪些需要进行修改，以便更好地满足小程序的标准和需求。以下是一些有用的技巧和经验：

1. 小程序支持的组件和API
   小程序平台支持的组件和API可以在@uni/xxx中找到对应的组件和API，例如uni-app 中的view-box与小程序兼容组件mp-view-box相对应。所以，在转换uni-app时，可以直接使用这些兼容组件和API来替换uni-app中小程序不支持或标准的组件和API。

2. 样式
   一些样式属性在uni-app和小程序之间有所不同。在uni-app中，可以使用CSS变量来快速更改样式。但是，在小程序中，需要编辑组件的样式，以确保它们在微信App中正确显示。例如：:class="getStatusColor()" 需要修改为 :class="[getStatusColor()]"。而且小程序不支持类深度选择>>>。对于一些样式问题，可以参考小程序文档中的样式指南。

• 建议❤️： 开发微信小程序时设计师可以用 iPhone6 作为视觉稿的标准。

3. 事件绑定
   uni-app和小程序之间的事件绑定也有所不同。在uni-app中，可以使用Vue.js的事件系统来绑定事件。但是，在小程序中，需要使用bind:或catch:等前缀来绑定事件。另外，小程序不支持冒泡事件。

4. 数据绑定
   数据绑定在uni-app和小程序之间也有所不同。在uniapp中，可以使用Vue.js的双向绑定来绑定数据。但是，在小程序中，需要使用WXML语言来绑定数据。此外，小程序还需要使用特定的属性来绑定数据，例如bindinput和value。

5. 路由
   在uni-app中，可以使用Vue.js的路由系统来控制应用程序的导航。但是，在小程序中，需要使用小程序提供的导航API来导航页面。需要将Vue.js路由系统中的路由对象转换为小程序中的导航API，例如wx.navigateTo和wx.switchTab等。

那么，是否存在工具或平台可以一键转换呢？

四、结论

把uni-app转换成小程序可以为应用程序开发带来很多便利和效率。但是，在进行转换之前，需要对uni-app和小程序有一定的了解，并进行必要的调整和修改。

五、拓展阅读

• 《跨平台应用开发进阶(六十三)：微信小程序开发》
• 《跨平台应用开发进阶(六十四)：微信小程序开发技术栈原生开发 VS 跨平台开发》
• 《跨平台应用开发进阶(六十五)：小程序分包策略及实战讲解》
• 《微信小程序样式指南》