Skip to content

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 取。

静态属性 ​

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 ​

ObjCJS
UIDevice.currentDeviceUIDevice.currentDevice
device.systemVersiondevice.systemVersion
device.userInterfaceIdiom == UIUserInterfaceIdiomPhonedevice.userInterfaceIdiom === 'phone'
device.identifierForVendor.UUIDStringdevice.identifierForVendor
if (@available(iOS 27.0, *))取 systemVersion 的主版本号比较

参见 ​