UIDevice
UIDevice 表示运行 App 的这台设备。从它读到设备的种类、操作系统的名字和版本,以及一个用来区分设备的标识。
整个 App 只有一个 UIDevice 对象,由运行时提供,从 UIDevice.currentDevice 取。
这七项信息全部只读,在 App 运行期间不会变化,读一次保存下来即可。
继承关系:EventTarget → NSObject → UIDevice
判断系统版本、给设备一个标识的写法,见指南读设备和系统的信息。
构造函数
不能用 new 创建。new UIDevice() 抛 TypeError: Illegal constructor: UIDevice is created by the runtime, not by new。实例从 UIDevice.currentDevice 取。
静态属性
运行 App 的这台设备。每次读得到同一个对象。
实例属性
还继承 NSObject 的属性。下面的属性全部只读,在 App 运行期间不变。
| 属性 | 说明 |
|---|---|
systemName 只读 | 操作系统的名字,iPhone 上是 'iOS' |
systemVersion 只读 | 操作系统的版本,字符串,形如 '26.1' |
model 只读 | 设备的种类,iPhone 上是 'iPhone'。不是具体的型号 |
localizedModel 只读 | model 按系统语言翻译后的写法 |
name 只读 | 设备的名字。读不到用户给设备起的名字 |
userInterfaceIdiom 只读 | 界面的类型,iPhone 上是 'phone' |
identifierForVendor 只读 | 同一个开发者的 App 在这台设备上共用的 UUID,可能是 null |
示例
下面的代码输出设备和系统的信息。它不需要界面,写在 main.js 顶层。
js
const device = UIDevice.currentDevice;
console.log(device.systemName + ' ' + device.systemVersion);
console.log(device.model);
console.log(device.userInterfaceIdiom);结果:在 iPhone 上,控制台输出三行,形如:
iOS 26.1
iPhone
phone验收用例是在 sceneconnect 的回调里读这些属性的。写在脚本顶层读未在模拟器验证。
对应的 iOS API
| ObjC | JS |
|---|---|
UIDevice.currentDevice | UIDevice.currentDevice |
device.systemVersion | device.systemVersion |
device.userInterfaceIdiom == UIUserInterfaceIdiomPhone | device.userInterfaceIdiom === 'phone' |
device.identifierForVendor.UUIDString | device.identifierForVendor |
if (@available(iOS 27.0, *)) | 取 systemVersion 的主版本号比较 |
参见
- 读设备和系统的信息:比较系统版本、给设备一个标识
application:App 自己的信息,版本号、包名crypto:randomUUID(),自己生成标识时用- 本地存储、Keychain:保存自己生成的标识
UITraitCollection:屏幕是几倍的、深色还是浅色,这些不在UIDevice上