UNIAPP开发注意事项
1.static
目录下的 js
文件不会被编译,如果里面有 es6
的代码,不经过转换直接运行,在手机设备上会报错。
2.css
、less/scss
等资源同样不要放在 static
目录下,建议这些公用的资源放在 common
目录下。
3.template
内引入静态资源,如image
、video
等标签的src
属性时,可以使用相对路径或者绝对路径。
4.js文件不支持使用/
开头的方式引入。
5.css
文件或style标签
内引入css
文件时(scss、less文件同理),只能使用相对路径。
6.编译期判断环境可用条件编译,运行期判断可用uni.getSystemInfoSync().platform判断环境。
7.在字体或高度中使用了 rpx ,那么需注意这样的写法意味着随着屏幕变宽,字体会变大、高度会变大。如果你需要固定高度,则应该使用 px 。
8.App端,在 pages.json 里的 titleNView 或页面里写的 plus api 中涉及的单位,只支持 px,不支持 rpx。
9.小程序不支持在css中使用本地文件,包括本地的背景图和字体文件。需以base64方式方可使用。
10.背景图片微信小程序不支持相对路径(真机不支持,开发工具支持)。
11.字体图标网络路径必须加协议头 https
。
12.非 H5 端不支持使用含有 dom、window 等操作的 vue 组件和 js 模块,安装的模块及其依赖的模块使用的 API 必须是 uni-app 已有的 API。
13.小程序组件需要放在项目特殊文件夹 wxcomponents
(或 mycomponents、swancomponents)。
14.当需要在 vue
组件中使用小程序组件时,注意在 pages.json
的 globalStyle
中配置 usingComponents
,而不是页面级配置。
15.以:style=""
这样的方式设置px像素值,其值为实际像素,不会被编译器转换。
16.若需要禁止蒙版下的页面滚动,可使用 @touchmove.stop.prevent="moveHandle"
,moveHandle 可以用来处理 touchmove 的事件,也可以是一个空函数。
17.App端和H5端支持v-html,其他端不支持v-html。
18.uni-app
不需要 plus ready
在html中使用plus的api。
19.在普通的 H5+ 项目中,需要使用 document.addEventListener
监听原生扩展的事件。uni-app
中,没有 document。可以使用 plus.globalEvent.addEventListener
来实现。
20.App端若要使用操作window、document的库,需要通过renderjs来实现。
21.tabbar 切换第一次加载时可能渲染不及时,可以在每个tabbar页面的onLoad生命周期里先弹出一个等待雪花。
22.tabbar 的页面展现过一次后就保留在内存中,再次切换 tabbar 页面,只会触发每个页面的onShow,不会再触发onLoad。
23.分包加载配置,subPackages
为小程序的分包加载机制。在App里始终为整包。subPackages
里的pages的路径是 root
下的相对路径,不是全路径。
24.splash(启动封面)是App必然存在的、不可取消的。splash只能是标准png,不要用jpg改名为png。
25.所有组件与属性名都是小写,单词之间以连字符-
连接。
26.APP-vue和小程序中,请勿在 scroll-view 中使用 map、video 等原生组件。小程序中 scroll-view 中也不要使用 canvas、textarea 原生组件。
27.scroll-view 不适合放长列表,有性能问题。长列表滚动和下拉刷新,应该使用原生导航栏搭配页面级的滚动和下拉刷新实现。
28.除了文本节点以外的其他节点都无法长按选中。
29.如需调节checkbox,radio大小,可通过css的scale方法调节,如缩小到70%style="transform:scale(0.7)"。
30.页面结构复杂,css样式太多的情况,使用 image 可能导致样式生效较慢,出现 “闪一下” 的情况,此时设置 image{will-change: transform}
,可优化此问题。
31.自定义组件里面使用 <image>
时,若 src
使用相对路径可能出现路径查找失败的情况,故建议使用绝对路径。
32.App平台:使用 <video/>
组件,打包 App 时必须勾选 manifest.json->App 模块权限配置->VideoPlayer 模块。
33.App平台:如果使用的视频路径为本地路径,需要配置资源为释放模式:在 manifest.json 文件内 app-plus 节点下新增 runmode 配置,设置值为liberate。
34.webview在App 平台同时支持网络网页和本地网页,但本地网页及相关资源(js、css等文件)必须放在 uni-app 项目根目录->hybrid->html
文件夹下;小程序仅支持加载网络网页,不支持本地html。
35.H5端onBackPress
只能监听页面导航栏的返回按钮的点击事件,不能监听浏览器返回以及手机的返回。
36.发出请求的method的值必须大写,有效值在不同平台差异说明不同。
37.localhost、127.0.0.1等服务器地址,只能在电脑端运行,手机端连接时不能访问。请使用标准IP并保证手机能连接电脑网络。
38.App支持多文件上传,微信小程序只支持单文件上传,传多个文件需要反复调用本API。所以跨端的写法就是循环调用本API。
39.如果想打开web url,在App平台可以使用 plus.runtime.openURL或web-view组件;H5平台使用 window.open;小程序平台使用web-view组件(url需在小程序的联网白名单中)。
40.navigateTo
, redirectTo
只能打开非 tabBar 页面,switchTab
只能打开 tabBar
页面.
41.H5端页面刷新之后页面栈会消失,此时navigateBack
不能返回,如果一定要返回可以使用history.back()
导航到浏览器的其他历史记录.
42.App端如需选择非媒体文件,可在插件市场搜索文件选择,其中Android端可以使用Native.js,无需原生插件,而iOS端需要原生插件。
43.关于一些权限的使用,类似相机,语音,都要先判断一下设备的访问权限是否开启。
44.屏幕高度=状态栏高度+原生导航栏高度+可使用窗口高度+原生tabbar高度。
45.分享到 QQ 必须含有 href 链接,分享文字到 QQ 时,title 必选,不能直接分享到QQ空间,可以分享到QQ,然后在QQ的界面里选择QQ空间。
46.从APP分享到微信时,无法判断用户是否点击取消分享,因为微信官方禁掉了分享成功的返回值。
47.支付的传参要注意orderInfo在不同的环境下传参类型不一致。
48.关于文本超出展示...,需要在超出展示盒子的内部在内嵌一层子元素,否则app端会有问题。