来自官方的内容,也不知道以后是不是能够找得到。所以这里先复制和备份一份;
原文来自:https://ask.dcloud.net.cn/article/36174
如果你已经有了一个基于vue开发的H5站点,想转换为uni-app。
首先注意2个前提:1、你的web站是适合手机屏幕的;2、你的H5代码是全后端分离的,uni-app只处理前端代码。
一切从新建一个uni-app项目开始。然后依次进行
文件处理
- 把之前的vue web项目的前端代码copy到新项目下
- 如果之前的文件后缀名是.html,需要改为.vue,并注意遵循vue单文件组件SFC规范,比如必须一级根节点为template、script、style,template节点下必须且只能有一个根view节点,所有内容写在这个根view节点下。
- 处理页面路由
uni-app默认是小程序的路由方式,在pages.json里管理页面。如果你使用vue rooter的话,一种是改造为pages.json方式,另一种是使用三方插件,比如vue rooter for uni-app
- 静态文件(如图片)挪到static目录
uni-app工程目录下有个static目录,用于存放静态文件,这个目录不编译,直接整体copy到发行代码里的。
如果你希望自定义静态资源目录,可以在vue.config.js中自定义。
标签代码处理
- 相同功能的组件自动转换
uni-app的标签组件与小程序相同,比如<div>
变成了<view>
,<span>
变成了<text>
。
但uni-app的编译器已经自动处理了这部分转换,如果源码中写了可自动转换的组件,在编译到非H5端时会被自动转换(再编译回到H5端时div还是div)。
- 区域滚动使用scroll-view,不再使用div的区域滚动处理方式
- 左右、上下滑动切换,有专门的swiper组件,不要使用div模拟
- input的search,原来的type没用了,改成confirmtype,详见
- audio组件不再推荐使用,改成api方式,背景音频api文档
- 之前的v-html,可以在H5端和App端(需v3编译器)使用,不能在小程序中使用。如需要在小程序使用,请使用rich-text组件或uparse扩展插件,详见
js代码处理
uni-app的非H5端,不管是App还是各种小程序,都不支持window、navigator、document等web专用对象。
uni-app的API与小程序保持一致,需要处理这些不同的API写法
- 处理window api
- 处理navigator api
- 处理dom api
- 如果使用标准vue的数据绑定,是不需要操作dom来修改界面内容的。如果没有使用vue数据绑定,仍然混写了jquery等dom操作,需要改为纯数据绑定
- 有时获取dom并不是为了修改显示内容,而是为了获取元素的长宽尺寸来做布局。此时uni-app提供了同小程序的另一种API,uni.createSelectorQuery
- 其他js api
web中还有canvas、video、audio、websocket、webgl、webbluetooth、webnfc,这些在uni-app中都有专门的API。
- 生命周期
uni-app补充了一批类小程序的声明周期,包括App的启动、页面的加载,详见https://uniapp.dcloud.io/collocation/frame/lifetime
vue h5一般在created或者mounted中请求数据,而在uni-app的页面中,使用onLoad或者onShow中请求数据。(组件仍然是created或者mounted)
- 少量不常用的vue语法在非h5端仍不支持,data必须以return的方式编写,注意事项详见
注意:如果你使用了一些三方ui框架、js库,其中引用了包括一些使用了dom、window、navigator的三方库,除非你只做H5端,否则需要更换。去uni-app的插件市场寻找替代品。如果找不到对应库,必须使用for web的库,在App端可以使用renderjs来引入这些for web的库。
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),会有样式错误。当然在App端也可以引用x5浏览器内核来抹平浏览器差异。
本文是思路,不是工具。我们鼓励和欢迎开发者编写垫片API和转换器,方便更多人使用。
---EOF---
最近因为一些小项目开始做小程序,之前也确实没有用原生的开发过,但毕竟自己相对较熟VUE,所以,这个就相 对方便了一点。taro确实不错,但TS的语法也确实没有那么熟。先用它吧。那天也测试了一下uniCloud,感觉如果可以和其他代码混用的话,倒也不失是个办法。
在用uniapp做小程序开发了。看了一下unicloud,发现其实有不少东西可以混用。嗯,先这样了
用unicloud数据库的时候,不能象平时一样模糊查询 ,不过uniapp提供了jql,就是所谓的javascript sql,其他语法都差不多,主要就是模糊查询
正常用法:
collection.where({name: { $regex: '.*'+value+'.*',$options:'i' }}) // i代表忽略大小写
还有就是
collection.where({name:/value/});,就是正则的写法
不得不说,用了painter确实方便。原来做海报还需要用tk-qrcode/wm-poster配合来生成。普通 链接生成qrcode本身也有问题,一进页面就报:toJSON错误,估计代码是好久没有更新过了。
因为项目里已经用了painter,于是花了一点时间把原来的tk-qrcode/wm-poster一并换掉。突然感觉腰不酸腿不疼了。。。
Kujiale-Mobile/Painter是一个优秀的JS生成canvas的库,如果配合https://lingxiaoyi.github.io/painter-custom-poster/,这个在生制作模板的工具,你会发现哇。原来做个二维码这么容易 。
优秀不代表没有缺点,至少我在使用的时候,真是踩了不少坑。网上的例子都是说直接使用"userComponents":{"painter":"path"}
然而我真的遇到了问题,先申明 ,我是在uniapp下面使用这个
1、各种例子说的组件位置都不一样,有说,放在根目录下:components目录,有说wxcomponents目录,甚至也有人说放在static目录下。我一个个都试了,结果 都是报app.json不正常。查了文档,都说路径不对。各种例子里的路径也是千奇百怪。有的路径用的"./components",有的用的是"/components",也有前面没有任何路径的。后面查到了官方,原来在某个版本的更新后,已经可以不用在前面加"./"或者"/"了。然而我还是不正常。最终我没有用这个办法,我是直接在main.js里采用import的方式解决了。【这个后面还要再提一下】
2、Painter 在网上的例子,都是<painter :palette="xxx" >类似这样,或者<painter palette="{{xxx}}" >这样的类似原生的调用方法。在官方的文档中有说:palette支持的是静态模板,也就是说这里的变量是先生成好的。而不是即时生成。。。。这个就很尴尬了,毕竟我不是做早安图之类的。在进页面前,可能不知道模板中的图片路径是不是确定好。再查的时候,就发现了,原来新版已经支持 dancePalette
3、采用dancePalette,果然是随时可以调用了,但又发生了一个问题,即原来canvas生成的时候,有ImgOK事件。但dancePalette没有ImgOK事件,确实,官方文档中有说,didShow事件是在使用dancePalette模板里触发。直接用最新版,会发现didShow方法报错。于是改代码,在didShow后加了个参数,现在只是不报错了,但还是没啥用。
于是猜想,是不是以前正常,现在不正常了呢?因为发现代码中有使用canvas2d,所以直接下载了canvas2d分支。结果下载后,我原来的import方式不能用了,但是那种:userComponents的方式又正常了。好吧,这不是大事。继续 测试didShow,果然这个分支的didShow输出N多内容。然而最重要的。detail节点没有任何内容,也就是说didShow没有生成Canvas的临时地址。这个事情就尴尬了。
当然我没放弃,我就一直在想,painter的palette静态模板调用,我是不是可以用呢。毕竟,uniapp采用的是vue(或者说是伪VUE),我可以利用v-if,先隐藏painter组件,等 palette的模板生成好了。我再加载painter组件,这时候不是就可以了吗?
说做就做,在<painter>外层加了一个view,默认v-if="templateGenerated == true",data()中先设置为false,然后请求完数据,赋值变量palette后,设置templateGenerate=true;
组件顺利调用,ImgOK方法也触发了。有了路径,什么长按保存,点击预览就都好办了。不是嘛~
至此,踩坑完毕,希望能够给同样踩坑的人有个小帮助。
或许有人说,为什么不看源码,提交PR?大哥,我只是画个太阳码,根本没心思看整个源码。。也没时间啊,先绕过去再说,如果有人能够提交PR,我也可以到时候再试试。
最后,感谢:
1、https://lingxiaoyi.github.io/painter-custom-poster/
2、https://github.com/Kujiale-Mobile/Painter/tree/canvas2d
市面上开发小程序的工具有很多,如果你只是个人开发者,或者是小公司,前端技术没有那么精通的。还是用uniapp吧。确实比较简单,会一点vue就行了。就当开发一个网页就行了。非网页的地方用 #ifndef H5 之类的判断一下处理就OK,然后还能编译成APP。试了一下。在现代的机器下面,性能也确实可以
当然你要说什么ApiCloud/taro/mpvue等都支持,我也没话说。但从便捷性上来说。确实是uniapp更方便一点。而且可找的资料,别人写的代码、插件也确实更多。硬要说不爽的,那就是。。。。公司自己的编辑器HBuilderX实在太烂。连代码跳传都做不到(也可能是我姿势不对。)
这里贴一段别人的长按保存到相册,长按事件是小程序自带的longpress。所以uniapp里的事件就是:
JavaScript代码
-
-
-
-
-
-
-
- saveImage(imgSrc, content="是否允许获取保存相册权限", failTip='暂无图片', successTip="已保存到本地相册,请打开相册扫描") {
- uni.saveImageToPhotosAlbum({
- filePath: imgSrc,
-
- success: (res) => {
- uni.showModal({
- title: '提示',
- content: successTip,
- showCancel: false,
- confirmText: "好的"
- })
- },
-
-
- fail(err) {
- console.error(err);
- if (err.errMsg === "saveImageToPhotosAlbum:fail auth deny" || err.errMsg ===
- "saveImageToPhotosAlbum:fail authorize no response" || err.errMsg === "saveImageToPhotosAlbum:fail auth denied") {
- uni.showModal({
- title: '授权提示',
- content: content,
- success: (res) => {
- if (res.confirm) {
- uni.openSetting({
- success(settingdata) {
- if (settingdata.authSetting["scope.writePhotosAlbum"]) {
- console.log("获取权限成功,再次点击图片保存到相册")
- uni.showToast({
- title: '授权成功,请重试哦~'
- });
- } else {
- console.log("获取权限失败")
- uni.showToast({
- title: '请确定已打开保存权限',
- icon: "none"
- });
- }
- }
- })
- }
- }
- })
- } else if (err.errMsg === "saveImageToPhotosAlbum:fail file not found" || err.errMsg ===
- "saveImageToPhotosAlbum:fail file not exists" || err.errMsg ===
- "saveImageToPhotosAlbum:fail get file data fail"
- ) {
- uni.showToast({
- title: failTip,
- icon: "none"
- });
- }
- }
- })
- },
原文地址在这里:https://blog.csdn.net/liuxin00020/article/details/104843960,如果保存还是失败,那就先用uni.getImageInfo(),会自动调用图片下载的(特别是微信小程序,还要设置downloadFilePath,否则也不能下载图片,这其实就是很多生成canvas失败的原因之一)