路由
uni-app页面路由为框架统一管理,开发者需要在 pages.json 里配置每个路由页面的路径和页面样式。类似的小程序在 app.json 中配置页面路由相同。所以 uni-app 的路由用法与 Vue Router 不同,如仍希望采用 Vue Router 方式管理路由,可在插件市场搜索 Vue-Router。
路由路由
uni-app 有两种页面路由重定向方式:使用导航器组件扩展,调用 API 重定向。
页面栈
框架以栈的形式管理当前所有页面,当发生路由切换的时候,页面栈的表现如下:
路由方式 | 页面栈表现 | 触发时机 |
---|---|---|
初始化 | 新页面入栈 | uni-app:的第一个页面 |
新页面 | 新页面入栈 | 调用 API uni.navigateTo ,使用组件 <navigator open-type =“ navigate” /> |
页面重启 | 当前页面出栈,新页面入栈 | 调用 API uni.redirectTo ,使用组件 <navigator open-type =“ redirectTo” /> |
页面返回 | 页面不断出栈,直到目标返回页 | 调用 API uni.navigateBack ,使用组件 <navigator open-type =“ navigateBack” /> ,用户按左上角返回按钮,安卓用户点击物理后退键 |
标签切换 | 页面全部出栈,只留下新的标签页面 | 调用 API uni.switchTab ,使用组件 <navigator open-type =“ switchTab” /> ,用户切换 Tab |
重加载 | 页面全部出栈,只留下新的页面 | 调用 API uni.reLaunch ,使用组件 <navigator open-type =“ reLaunch” /> |
运行环境判断
开发环境和生产环境
uni-app 可通过 process.env.NODE_ENV 判断当前环境是开发环境还是生产环境。一般用于连接测试服务器或生产服务器的动态切换。
快捷代码块
HBuilderX 中敲入代码块 uEnvDev,uEnvProd 可以快速生成对应 development,production 的运行环境判定代码。
-
在 HBuilderX 中,点击 “运行” 编译出来的代码是开发环境,点击 “发行” 编译出来的代码是生产环境
-
cli 模式下,是通行的编译环境处理方式。
if(process.env.NODE_ENV === 'development'){ console.log('开发环境') }else{ console.log('生产环境') }
如果你需要自定义更多环境,某种测试环境:
-
假设只需要对单一平台配置,可以的 package.json 中配置,在 HBuilderX 的运行和发行菜单里会多一个出来。https://uniapp.dcloud.io/collocation/package
-
如果是针对所有平台配置,可以在 VUE-config.js 中配置。https://uniapp.dcloud.io/collocation/vue-config
快捷代码块
HBuilderX 中敲入代码块 uEnvDev,uEnvProd 可以快速生成对应 development,production 的运行环境判定代码。
// uEnvDev
if (process.env.NODE_ENV === 'development') {
// TODO
}
// uEnvProd
if (process.env.NODE_ENV === 'production') {
// TODO
}
判断平台
平台判断有 2 种场景,一种是在编译期判断,一种是在运行期判断。
-
编译期判断编译期判断,即条件编译,不同平台在编译出包后已经是不同的代码。详见:条件编译
// #ifdef H5 alert("只有h5平台才有alert方法") // #endif
如上代码只会编译到 H5 的发行包里,其他平台的包不会包含如上代码。
-
运行期诊断运行期判断是指代码已经打入包中,仍然需要在运行期判断平台,此时可使用 uni.getSystemInfoSync().platform 判断客户端环境是 Android,iOS 还是小程序开发工具(在百度小程序开发工具,微信小程序开发工具,支付宝小程序开发工具中使用 uni.getSystemInfoSync().platform 返回值重置 devtools)。
switch(uni.getSystemInfoSync().platform){ case 'android': console.log('运行Android上') break; case 'ios': console.log('运行iOS上') break; default: console.log('运行在开发者工具上') break; }
如有必要,也可以在条件编译里自己定义的一个变量,赋值。在后续运行代码中动态判断环境。