news 2026/6/26 3:05:32

《uni-app跨平台开发完全指南》- 13 -获取设备信息

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
《uni-app跨平台开发完全指南》- 13 -获取设备信息

前言

大家好,今天我们聊一个看似简单、实则至关重要的技术话题——如何获取和利用设备信息。在移动应用开发中,许多令人头疼的适配问题,其根源往往就在设备信息的处理上。今天,我们就来一起聊聊这个话题。

一、系统信息

1.1 同步vs异步

很多人都知道用uni.getSystemInfo(),但其实这里有个性能坑:

// 不推荐:每次都调异步APIasyncfunctiongetDeviceInfo(){constinfo=awaituni.getSystemInfo()returninfo}// 推荐:同步获取+缓存letcachedInfo=nullfunctiongetSystemInfo(){if(!cachedInfo){// 首次使用同步API,避免Promise开销cachedInfo=uni.getSystemInfoSync()}returncachedInfo}

为什么同步更好?

  • 无Promise开销,避免微任务队列调度
  • 不用await
  • 应用启动时就应该获取

但同步API有个坑:在极少数情况下可能会阻塞UI。建议:

  • 应用启动时用同步
  • 运行时变化用异步监听

1.2 专业术语解释

constsystemInfo=uni.getSystemInfoSync()// 一下6个字段比较重要:constessentialFields={// 1. 设备识别platform:systemInfo.platform,// "android" | "ios" | "web"model:systemInfo.model,// 具体型号,如"iPhone 13 Pro"// 2. 屏幕信息pixelRatio:systemInfo.pixelRatio,// 设备像素比screenWidth:systemInfo.screenWidth,// 物理像素宽度windowWidth:systemInfo.windowWidth,// 可用宽度// 3. 刘海屏-安全区域safeArea:systemInfo.safeArea,// 安全区域坐标statusBarHeight:systemInfo.statusBarHeight// 状态栏高度}

特别说明一下pixelRatio这个字段,很多新手会忽略它:

像素比的意义:

// 根据像素比加载合适图片functiongetImageUrl(baseUrl,pixelRatio){if(pixelRatio>=3)return`${baseUrl}@3x.png`if(pixelRatio>=2)return`${baseUrl}@2x.png`return`${baseUrl}.png`}// 计算Canvas绘制尺寸functiongetCanvasSize(designSize,pixelRatio){return{width:designSize.width*pixelRatio,height:designSize.height*pixelRatio,styleWidth:designSize.width,styleHeight:designSize.height}}

1.3 平台差异处理

uni-app号称"一套代码,多端运行",但现实是不同平台确实存在差异:

// Platform适配工具类classPlatformAdapter{staticgetStatusBarHeight(){constinfo=uni.getSystemInfoSync()// iOS和Android的状态栏高度if(info.platform==='ios'){// iOS:iPhone X以上有刘海constisNotchScreen=this.isNotchScreen(info)returnisNotchScreen?44:20}elseif(info.platform==='android'){// Android:通常比iOS高,且版本差异大constversion=parseFloat(info.system.split(' ')[1])||0returnversion>=10?28:25}return20// Web端默认}staticisNotchScreen(info){// 判断是否为刘海屏constnotchModels=['iPhone X','iPhone 11','iPhone 12','iPhone 13','iPhone 14','iPhone 15']returnnotchModels.some(model=>info.model.includes(model))}}

二、屏幕适配

2.1 rpx单位

rpx是uni-app的核心创新,让我们深入了解一下rpx吧。

// rpx转换原理functionrpx2px(rpx,windowWidth=375){// 1rpx = windowWidth / 750return(rpx*windowWidth)/750}// 注意事项constdesignWidth=750constdeviceWidth=uni.getSystemInfoSync().windowWidth// 按钮宽度是200rpxconstbuttonDesignWidth=200// 在任何设备上,实际宽度都是:constactualWidth=(buttonDesignWidth/designWidth)*deviceWidth

rpx的好处在于:

  • 750rpx对应设计稿750px
  • 所有元素按屏幕宽度等比缩放
  • 框架自动处理转换

rpx局限性:

  • 不适合需要固定尺寸的场景(如1px边框)
  • 在大屏设备上可能过度拉伸
  • 图片使用rpx需要配合mode="widthFix"

2.2 适配安全区域

随着全面屏普及,安全区域适配成了必修课:

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/24 17:30:53

【Dify依赖管理必知】:90%工程师忽略的5个关键检查点

第一章:Dify工作流依赖检查的核心意义在构建基于Dify平台的自动化工作流时,依赖检查是确保流程稳定性和执行正确性的关键环节。未被妥善管理的依赖关系可能导致任务执行失败、数据不一致甚至系统级异常。通过前置性分析各节点之间的输入输出关联&#xf…

作者头像 李华
网站建设 2026/6/26 12:27:04

文献综述期末项目:基于文献综述的期末项目设计与实践研究

科研新人做综述时最痛苦:一搜就是几十页论文,重复、无关、没用。下面三款工具让我效率翻倍。 ① WisPaper(智能学术搜索 文献管理) 官网:https://www.wispaper.ai WisPaper 能通过关键词和语义搜索快速找到相关文献&…

作者头像 李华
网站建设 2026/6/26 0:49:26

为什么90%的Dify集成项目初期都忽略了结果级权限校验?

第一章:为什么90%的Dify集成项目初期都忽略了结果级权限校验在构建基于 Dify 的 AI 应用集成时,开发者往往聚焦于模型调用、流程编排与前端交互,却普遍忽视了结果级权限校验这一关键安全环节。这种疏忽并非源于技术难度,而是源于对…

作者头像 李华
网站建设 2026/6/25 20:21:18

​多店运动场馆预约小程序、我们这样开发!

多店运动场馆预约小程序、我们这样开发! 网球馆、羽毛球馆、健身房、瑜伽馆、普拉提馆等运动场馆筹备需要准备的东西之定制小🍊序来啦[派对R] 📱​支持场地预约、教务管理、次卡、储值、优惠券、营销活动、财务报表、扫码门禁、到店指引、团购…

作者头像 李华