类: OS

更新: 2026/9/29 字数: 0 字 时长: 0 分钟

device.OS

OS提供获取系统相关信息，比如系统版本号、版本名称。

示例

const { OS } = require('device');
console.log(OS.sdkName); // e.g. "7.1"
console.log(OS.sdkVersionCode); // e.g. 25

目录

属性

• ANDROID_BASE
• ANDROID_BASE_1_1
• ANDROID_CUPCAKE
• ANDROID_DONUT
• ANDROID_ECLAIR
• ANDROID_ECLAIR_0_1
• ANDROID_ECLAIR_MR1
• ANDROID_FROYO
• ANDROID_GINGERBREAD
• ANDROID_GINGERBREAD_MR1
• ANDROID_HONEYCOMB
• ANDROID_HONEYCOMB_MR1
• ANDROID_HONEYCOMB_MR2
• ANDROID_ICE_CREAM_SANDWICH
• ANDROID_ICE_CREAM_SANDWICH_MR1
• ANDROID_JELLY_BEAN
• ANDROID_JELLY_BEAN_MR1
• ANDROID_JELLY_BEAN_MR2
• ANDROID_KITKAT
• ANDROID_KITKAT_WATCH
• ANDROID_L
• ANDROID_LOLLIPOP_MR1
• ANDROID_M
• ANDROID_N
• ANDROID_N_MR1
• ANDROID_O
• ANDROID_O_MR1
• ANDROID_P
• ANDROID_Q
• ANDROID_R
• ANDROID_S

Accessors

• incremental
• release
• sdkName
• sdkVersionCode
• securityPatch

方法

• requiresAndroidVersion

属性

ANDROID_BASE

• Static Readonly ANDROID_BASE: AndroidVersion

Android 1.0

参见

requiresAndroidVersion

---

ANDROID_BASE_1_1

• Static Readonly ANDROID_BASE_1_1: AndroidVersion

Android 1.1

参见

requiresAndroidVersion

---

ANDROID_CUPCAKE

• Static Readonly ANDROID_CUPCAKE: AndroidVersion

Android 1.5

参见

requiresAndroidVersion

---

ANDROID_DONUT

• Static Readonly ANDROID_DONUT: AndroidVersion

Android 1.6

参见

requiresAndroidVersion

---

ANDROID_ECLAIR

• Static Readonly ANDROID_ECLAIR: AndroidVersion

Android 2.0

参见

requiresAndroidVersion

---

ANDROID_ECLAIR_0_1

• Static Readonly ANDROID_ECLAIR_0_1: AndroidVersion

Android 2.0.1

参见

requiresAndroidVersion

---

ANDROID_ECLAIR_MR1

• Static Readonly ANDROID_ECLAIR_MR1: AndroidVersion

Android 2.1.x

参见

requiresAndroidVersion

---

ANDROID_FROYO

• Static Readonly ANDROID_FROYO: AndroidVersion

Android 2.2.x

参见

requiresAndroidVersion

---

ANDROID_GINGERBREAD

• Static Readonly ANDROID_GINGERBREAD: AndroidVersion

Android 2.3

参见

requiresAndroidVersion

---

ANDROID_GINGERBREAD_MR1

• Static Readonly ANDROID_GINGERBREAD_MR1: AndroidVersion

Android 2.3.3

参见

requiresAndroidVersion

---

ANDROID_HONEYCOMB

• Static Readonly ANDROID_HONEYCOMB: AndroidVersion

Android 3.0.x

参见

requiresAndroidVersion

---

ANDROID_HONEYCOMB_MR1

• Static Readonly ANDROID_HONEYCOMB_MR1: AndroidVersion

Android 3.1.x

参见

requiresAndroidVersion

---

ANDROID_HONEYCOMB_MR2

• Static Readonly ANDROID_HONEYCOMB_MR2: AndroidVersion

Android 3.2

参见

requiresAndroidVersion

---

ANDROID_ICE_CREAM_SANDWICH

• Static Readonly ANDROID_ICE_CREAM_SANDWICH: AndroidVersion

Android 4.0

参见

requiresAndroidVersion

---

ANDROID_ICE_CREAM_SANDWICH_MR1

• Static Readonly ANDROID_ICE_CREAM_SANDWICH_MR1: AndroidVersion

Android 4.0.3

参见

requiresAndroidVersion

---

ANDROID_JELLY_BEAN

• Static Readonly ANDROID_JELLY_BEAN: AndroidVersion

Android 4.1

参见

requiresAndroidVersion

---

ANDROID_JELLY_BEAN_MR1

• Static Readonly ANDROID_JELLY_BEAN_MR1: AndroidVersion

Android 4.2

参见

requiresAndroidVersion

---

ANDROID_JELLY_BEAN_MR2

• Static Readonly ANDROID_JELLY_BEAN_MR2: AndroidVersion

Android 4.3

参见

requiresAndroidVersion

---

ANDROID_KITKAT

• Static Readonly ANDROID_KITKAT: AndroidVersion

Android 4.4.2

参见

requiresAndroidVersion

---

ANDROID_KITKAT_WATCH

• Static Readonly ANDROID_KITKAT_WATCH: AndroidVersion

Android 4.4W

参见

requiresAndroidVersion

---

ANDROID_L

• Static Readonly ANDROID_L: AndroidVersion

Android 5.0

参见

requiresAndroidVersion

---

ANDROID_LOLLIPOP_MR1

• Static Readonly ANDROID_LOLLIPOP_MR1: AndroidVersion

Android 5.1

参见

requiresAndroidVersion

---

ANDROID_M

• Static Readonly ANDROID_M: AndroidVersion

Android 6.0

参见

requiresAndroidVersion

---

ANDROID_N

• Static Readonly ANDROID_N: AndroidVersion

Android 7.0

参见

requiresAndroidVersion

---

ANDROID_N_MR1

• Static Readonly ANDROID_N_MR1: AndroidVersion

Android 7.1

参见

requiresAndroidVersion

---

ANDROID_O

• Static Readonly ANDROID_O: AndroidVersion

Android 8.0

参见

requiresAndroidVersion

---

ANDROID_O_MR1

• Static Readonly ANDROID_O_MR1: AndroidVersion

Android 8.1

参见

requiresAndroidVersion

---

ANDROID_P

• Static Readonly ANDROID_P: AndroidVersion

Android 9

参见

requiresAndroidVersion

---

ANDROID_Q

• Static Readonly ANDROID_Q: AndroidVersion

Android 10

参见

requiresAndroidVersion

---

ANDROID_R

• Static Readonly ANDROID_R: AndroidVersion

Android 11

参见

requiresAndroidVersion

---

ANDROID_S

• Static Readonly ANDROID_S: AndroidVersion

Android 12

参见

requiresAndroidVersion

Accessors

incremental

• Static get incremental(): string

系统源码版本控制的内部版本号，比如git的commit id。

参见

INCREMENTAL

返回值

string

---

release

• Static get release(): string

用户可见的版本字符串。 例如，“1.0”或“3.4b5”或“bananas”。不要假设它的值具有任何特定的结构，或者不同版本的 RELEASE 值可以以某种方式排序。

参见

RELEASE

返回值

string

---

sdkName

• Static get sdkName(): string

Android版本名称，例如"10"、"7.0"、"4.4W"等。对于比较新的Android版本，可能返回unknown。

返回值

string

---

sdkVersionCode

• Static get sdkVersionCode(): number

获取当前系统的SDK版本号，即Android API版本号。例如Android 10为29，Android 7.0为24。完整的对应表参见SDK Platform release notes。

参见

SDK_INT

返回值

number

---

securityPatch

• Static get securityPatch(): string

安全补丁的版本号。

参见

SECURITY_PATCH

返回值

string

方法

requiresAndroidVersion

• Static requiresAndroidVersion(version, message?): void

要求最低在给定的Android版本中运行。如果当前系统版本小于给定版本，则抛出异常，异常信息为给定的message字段。

示例

"nodejs";

const { OS } = require('device');
OS.requiresAndroidVersion(OS.ANDROID_N);

参数

名称	类型	描述
version	AndroidVersion	最小Android版本
message	string	异常信息，默认为Requires Android ${version.name}(API ${version.code}) to run this code

返回值

void