Vue 项目如何迁移小程序?

开发者想将已有的Vue项目转为小程序,在集成了FinClip SDK的App中运行小程序。这里,用户需要关注两个注意事项:Web项目是适合在手机等移动设备中运行的,屏幕已经兼容;H5项目的代码是前后端分离的。为了处理这个问题,本文选择使用的是一款成熟的跨平台框架uni-app。

1、Web项目是适合在手机等移动设备中运行的,屏幕已经兼容;

2、H5项目的代码是前后端分离的;

第一步:创建uni-app项目

一切都需要先从一个uni-app项目开始,然后再一次进行。

1、全局安装vue-cli

2.通过CLI创建uni-app项目

注意:创建CLI工程时会远程下载dcloudio/uni-preset-vue,拉取失败时如出现如下图所示的错误。这个时候可以通过手动下载模板来创建项目。https://github.com/dcloudio/uni-preset-vue

FinClip

下载完毕后复制当前的文件路径,并且通过命令行来创建项目。

FinClip

进入命令行之后,需要通过vue create-p文件路径名项目名来创建项目,输入命令之后会提示选择项目模板,这里我们选择默认模板。

FinClip

3.在VS Code中打开创建的uni-app项目

FinClip

当我们能够打开这个uni-app的项目时,就意味着至此,一个uni-app项目已经创建好了!接下来我们开始对代码进行一些处理优化。

第二步:代码处理

在代码处理步骤中,我们需要分别对项目文件,标签代码,js代码和css代码进行针对性优化,以下是对应的优化处理内容。

1、文件处理

a.把之前的vue H5项目的前端代码复制到新项目下;

b.如果之前的文件后缀名是.html,需要改为.vue,并注意遵循vue单文件组件SFC规范,比如必须一级根节点为template、script、style,template节点下必须且只能有一个根view节点,所有内容写在这个根view节点下。

c.处理页面路由

uni-app默认是小程序的路由方式,在pages.json里管理页面。如果你使用vue rooter的话,一种是改造为pages.json方式,另一种是使用三方插件,比如vue rooter for uni-app

d.静态文件(如图片)挪到static目录

uni-app工程目录下有个static目录,用于存放静态文件,这个目录不编译,直接整体复制到发行代码里的。如果你希望自定义静态资源目录,可以在vue.config.js中自定义。

2.标签代码处理

a.相同功能的组件自动转换

uni-app的标签组件与小程序相同,比如<div>变成了<view>,<span>变成了<text>。

但uni-app的编译器已经自动处理了这部分转换,如果源码中写了可自动转换的组件,在编译到非H5端时会被自动转换(再编译回到H5端时div还是div)。

  • div改成view
  • span、font改成text
  • a改成navigator
  • img改成image
  • select改成picker
  • iframe改成web-view
  • ul、li没有了,都用view替代

b.区域滚动使用scroll-view,不再使用div的区域滚动处理方式

c.左右、上下滑动切换,有专门的swiper组件,不要使用div模拟

d.input的search,原来的type没用了,改成confirmtype,详见这里

e.audio组件不再推荐使用,改成api方式,详见这里

f.之前的v-html,可以在H5端和App端(需v3编译器)使用,不能在小程序中使用。如需要在小程序使用,请使用rich-text组件或uparse扩展插件,详见这里

3、js代码处理

uni-app的非H5端,不管是App还是各种小程序,都不支持window、navigator、document等web专用对象。uni-app的API与小程序保持一致,需要处理这些不同的API写法。

a.处理window api

  • ajax改成uni.request。(插件市场也有适配uni-app的axios、flyio等封装拦截器)
  • cookie、session.storage没有了,改用uni.storage吧;local.storage也改成uni.storage。另外插件市场有一个垫片mp-storage,可使用之前的代码,兼容运行在uni-app上,
  • alert,confirm改成uni.showmodel
  • window的resize改为了uni.onWindowResize

b.处理navigator api

  • geolocation的定位方式改为uni.getLocation
  • useragent的设备api没有了,改用uni.getSystemInfo

c.处理dom api

  • 如果使用标准vue的数据绑定,是不需要操作dom来修改界面内容的。如果没有使用vue数据绑定,仍然混写了jquery等dom操作,需要改为纯数据绑定
  • 有时获取dom并不是为了修改显示内容,而是为了获取元素的长宽尺寸来做布局。此时uni-app提供了同小程序的另一种api,uni.createSelectorQuery

d.其他js api

  • web中还有canvas、video、audio、websocket、webgl、webbluetooth、webnfc,这些在uni-app中都有专门的api。

f.生命周期

  • uni-app补充了一批类小程序的声明周期,包括App的启动、页面的加载,详见这里
  • vue h5一般在created或者mounted中请求数据,而在uni-app的页面中,使用onLoad或者onShow中请求数据。(组件仍然是created或者mounted)

g.少量不常用的vue语法在非h5端仍不支持,data必须以return的方式编写,注意事项详见这里

注意:如果你使用了一些三方ui框架、js库,其中引用了包括一些使用了dom、window、navigator的三方库,除非你只做H5端,否则需要更换。去uni-app的插件市场寻找替代品。如果找不到对应库,必须使用for web的库,在App端可以使用renderjs来引入这些for web的库。

4、css代码处理

uni-app发布到App(非nvue)、小程序时,显示页面仍然由webview渲染,css大部分是支持的。但需要注意以下内容:

  • 不支持*选择器
  • 没有body元素选择器,改用page元素选择器。(编译到非H5时,编译器会自动处理。所以不改也行)
  • div等元素选择器改为view,span和font改为text,a改为navigator,img改为image…(编译到非H5时,编译器会自动处理。所以不改也行)
  • 不同端的浏览器兼容性仍然存在,避免使用太新的css语法,否则发布为App时,Android低端机(Android 4.4、5.x),会有样式错误。

通过以上步骤,基本上就能够把已有的vue项目转为对应的小程序代码规范了。

第三步:将小程序移动至FinClip中

在完成以上工作任务后,我们应该在uni-app中已经得到了一个结构完整且可以运行的非H5项目了。最后,我们可以通过在uni-app中代码发布为微信小程序,或者直接通过集成FinClip插件的形式进行处理,这两种形式都比较简单。

使用uni-app将小程序发布为微信小程序

FinClip

我们可以直接在编译器中将代码发布为“微信小程序”的相关格式,随后再通过FinClip打开对应的小程序,最后就可以直接运行了。

到这里,将已有基于Vue格式编译的H5页面就可以正常迁移为对应的小程序了。

使用教程

PetaExpress怎么重置Windows云服务器密码?

2024-6-3 11:57:06

使用教程

PetaExpress如何查看云服务器信息?

2024-6-4 11:12:11

相关推荐