news 2026/4/26 13:16:35

《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/4/18 0:52:20

【OpenHarmony】日志服务hilog

HiLog 模块 1. 模块概述 源码:https://gitee.com/openharmony/hiviewdfx_hilog 1.1 功能与目标 主要功能: HiLog是OpenHarmony操作系统的核心日志系统,为系统框架、服务和应用程序提供统一的日志打印、记录和管理功能。 核心目标&#x…

作者头像 李华
网站建设 2026/4/19 19:41:29

Qwen3-8B模型快速体验:pipeline流式与非流式调用

Qwen3-8B模型快速体验:pipeline流式与非流式调用 在AI应用加速落地的今天,一个核心挑战摆在开发者面前:如何在有限硬件资源下运行高性能大模型?尤其对于个人开发者和中小企业而言,部署动辄百亿参数的LLM往往意味着高昂…

作者头像 李华
网站建设 2026/4/20 6:44:40

kotaemon多平台API兼容指南

Kotaemon 多平台 API 兼容实践:构建灵活、安全的智能对话系统 在企业级 AI 应用开发中,一个常见的技术债务是“模型锁定”——项目初期为了快速验证效果,直接绑定某个云厂商的 LLM 接口。但随着业务上线,合规、成本、性能等问题接…

作者头像 李华
网站建设 2026/4/24 2:50:44

量子态测量偏差高达30%?用R优化模拟精度的4步紧急修复方案

第一章:量子态测量偏差高达30%?R模拟精度的紧急响应在近期量子计算模拟实验中,研究人员发现使用R语言进行量子态概率幅模拟时,测量结果与理论值偏差竟高达30%。这一异常引发了对R数值计算精度的深度审查,尤其是在处理复…

作者头像 李华
网站建设 2026/4/26 9:15:11

QTextEdit方法大全

📘 第一部分:构造函数 文本获取与设置方法🔹【构造函数】1. *QTextEdit(QWidget parent nullptr)创建一个空的多行文本输入框。示例:QTextEdit* edit new QTextEdit(this);2. *QTextEdit(const QString &text, QWidget par…

作者头像 李华