uni-app 中文文档 uni-app 路由

2024-02-25 开发教程 uni-app 中文文档 匿名 1

路由

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中,点击“运行”编译出来的代码是开发环境,点击“发行”编译出来的代码是生产环境
  • 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;
}

如有必要,也可以在条件编译里自己定义的一个变量,赋值。在后续运行代码中动态判断环境。