uni-app页面路由为框架统一管理,开发者需要在 pages.json 里配置每个路由页面的路径和页面样式。类似的小程序在 app.json 中配置页面路由相同。所以 uni-app 的路由用法与 Vue Router 不同,如仍希望采用 Vue Router 方式管理路由,可在插件市场搜索 Vue-Router。
uni-app 有两种页面路由重定向方式:使用导航器组件扩展,调用 API 重定向。
框架以栈的形式管理当前所有页面,当发生路由切换的时候,页面栈的表现如下:
| 路由方式 | 页面栈表现 | 触发时机 |
|---|---|---|
| 初始化 | 新页面入栈 | uni-app:的第一个页面 |
| 新页面 | 新页面入栈 | 调用 API uni.navigateTo ,使用组件 |
| 页面重启 | 当前页面出栈,新页面入栈 | 调用 API uni.redirectTo ,使用组件 |
| 页面返回 | 页面不断出栈,直到目标返回页 | 调用 API uni.navigateBack ,使用组件 |
| 标签切换 | 页面全部出栈,只留下新的标签页面 | 调用 API uni.switchTab ,使用组件 |
| 重加载 | 页面全部出栈,只留下新的页面 | 调用 API uni.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;
}
如有必要,也可以在条件编译里自己定义的一个变量,赋值。在后续运行代码中动态判断环境。