uni.getSystemInfo() 是2026年uni-app生态中获取安卓/iOS设备型号与系统版本最可靠、跨端兼容的方式，不依赖原生插件、无需额外权限（H5除外），真机与打包后表现稳定。
uni.getSystemInfo() 是当前最可靠、跨端兼容的获取方式
在 2026 年的 uni-app 生态中，uni.getSystemInfo() 已成为获取安卓（及 iOS）设备型号、系统版本等信息的事实标准。它不依赖原生插件、无需额外权限声明（H5 除外），且真机和打包后表现稳定。uni.getDeviceInfo() 虽然存在，但已明确被官方标注为“H5 端支持有限”，部分 Android 设备甚至返回空 deviceId 或模拟值，不建议作为主力方案。
常见错误现象：
- 调用
uni.getDeviceInfo()后res.model为空或为"Simulator"—— 这是模拟器行为，必须真机测试； - 在 H5 页面里看到
undefined或报错 —— 因为 H5 环境下该 API 不可用，uni.canIUse('getDeviceInfo')返回false； - 误把
res.platform当成手机型号 —— 它只返回"android"或"ios"，不是具体型号（如 “MI 14” 或 “SM-S918B”）。
实操建议：
- 优先使用异步
uni.getSystemInfo()，并在success回调中取res.model； - 若需同步读取（例如在
onLaunch中做平台判断），改用uni.getSystemInfoSync()； - 安卓端
res.model通常包含厂商前缀（如"Xiaomi MI 14"或"samsung SM-S918B"），可配合res.brand做二次清洗； - 别依赖
res.deviceId做唯一标识 —— 安卓 10+ 默认禁用，且不同 App 沙箱隔离，返回值可能每次不同。
需要 IMEI/IMSI？别碰 plus.device，改用 plus.device.getInfo() + 权限适配
如果你真要读取安卓底层硬件标识（比如对接运营商 SDK），plus.device.imei 这类直接属性访问早已失效。从 HBuilderX 2.0.0 起，必须走 plus.device.getInfo() 接口，并手动申请运行时权限。
常见错误现象：
- 直接访问
plus.device.imei返回undefined或空字符串； - 调用
plus.device.getInfo()后 success 回调没触发，也没报错 —— 很可能是没申请android.permission.READ_PHONE_STATE； - Android 12+ 用户拒绝权限后，再次调用仍失败，且无提示 —— 需检查
plus.android.hasPermission()并引导用户去设置页手动开启。
实操建议：
- manifest.json 的 “Android 模块权限配置” 中勾选
读取手机状态； - 代码中先判断权限：
if (!plus.android.hasPermission('android.permission.READ_PHONE_STATE')) { ... }； - 再调用
plus.device.getInfo()，注意它的 success 回调参数是原生对象，字段名大小写敏感（如e.imei，不是e.IMIE）； - 双卡设备
e.imei是逗号分隔字符串，需.split(',')取首项，但部分国产 ROM（如华为 EMUI）会直接返回空 —— 别强依赖。
H5 端想识别安卓机型？靠 UA + screen 和 platform 组合推断
H5 在浏览器里根本拿不到真实 model，uni.getSystemInfo() 返回的 model 是浏览器 UA 解析出的近似值（如 "Android" 或 "Linux arm64"），基本不可用。这时候得自己解析 navigator.userAgent，再辅以屏幕尺寸、DPR 等特征交叉验证。
常见错误现象：
- 在 H5 上打印
res.model总是"Android"—— 这是正常现象，不是 bug； - 仅靠 UA 判断是否为安卓，却忽略 UC、QQ 浏览器等内核伪装 —— 导致误判为 iOS；
- 用
screen.width直接当物理设备宽度 —— 实际是 CSS 像素，受缩放影响极大。
实操建议：
- 基础判断用：
/Android/i.test(navigator.userAgent)，比res.platform === 'android'更准； - 粗略区分中高端机型：结合
window.devicePixelRatio >= 3 && screen.width >= 412（接近 Pixel 6/小米 13 尺寸）； - 避免硬编码机型名，改为按“屏幕密度+OS版本+UA关键词”打标签（如
flag: 'android-flagship-13+'）； - 别在 H5 做设备锁死逻辑 —— 用户换浏览器、开无痕模式就失效。
uni-app x / UTS 场景下，直接调用 Android API 是可行但需谨慎
如果你用的是 uni-app x（非传统 Vue 项目），且目标仅限安卓 App，那确实可以跳过 uni 封装，用 UTS 直接调 android.os.Build.MODEL 或 Build.MANUFACTURER。这能拿到最原始、未被过滤的型号字符串，比如 "XQ-BC52"（索尼 Xperia 1 V）。
常见错误现象：
- 在 .uts 文件里 import
android.os.Build报错 —— 忘了加@Native注解或没配 targetSdk； - 调用
Build.MODEL返回空，但真机调试显示有值 —— 因为某些 OEM（如 OPPO）在系统层做了屏蔽； - 把 UTS 写的安卓逻辑误用到 iOS 编译环境，导致构建失败 —— UTS 不自动做平台条件编译。
实操建议：
- 只在
if (uni.getSystemInfoSync().platform === 'android')成立后才执行 UTS 模块； - UTS 中必须用
@Native('android')显式标注，并 catch 所有可能的Exception； - 返回值要做 trim() 和空值 fallback，例如：
return model?.trim() || 'Unknown Android Device'； - 上线前务必在华为、小米、vivo、三星四家主流 ROM 上实测 —— 型号字段策略差异极大。
真正麻烦的从来不是“怎么拿到型号”，而是“拿到之后敢不敢信”。安卓碎片化之下，model 字段既可能过于宽泛（如 “Redmi Note 12”），也可能过于冷门（如 “RMX3783”），还可能被厂商主动模糊（华为 HarmonyOS 设备常返回 “HUAWEI Phone”）。所以，与其纠结字符串本身，不如聚焦你要解决的实际问题：是适配刘海屏？还是限制低端机功能？—— 那些才是该用 screen、DPR、WebGL 能力检测去回答的问题。
