平台

示例

---

参考

属性

constants

tsx

static constants: PlatformConstants;

返回一个对象，其中包含所有与平台相关的可用通用和特定常量。

属性：

名称	类型	可选	描述
isTesting	boolean	否
reactNativeVersion	object	否	关于 React Native 版本的信息。键为 major、minor、patch，可选 prerelease，值为 number。
Version Android	number	否	特定于 Android 的操作系统版本常量。
Release Android	string	否
Serial Android	string	否	Android 设备的硬件序列号。
Fingerprint Android	string	否	唯一标识构建的字符串。
Model Android	string	否	Android 设备的最终用户可见名称。
Brand Android	string	否	与产品/硬件关联的消费者可见品牌。
Manufacturer Android	string	否	Android 设备的制造商。
ServerHost Android	string	是
uiMode Android	string	否	可能的值为：'car'、'desk'、'normal'、'tv'、'watch' 和 'unknown'。了解更多关于 Android ModeType。
forceTouchAvailable iOS	boolean	否	指示设备上 3D Touch 的可用性。
interfaceIdiom iOS	string	否	设备的界面类型。了解更多关于 UIUserInterfaceIdiom。
osVersion iOS	string	否	特定于 iOS 的操作系统版本常量。
systemName iOS	string	否	特定于 iOS 的操作系统名称常量。

---

isPad

iOS

tsx

static isPad: boolean;

返回一个布尔值，用于定义设备是否为 iPad。

类型
boolean

---

isTV

tsx

static isTV: boolean;

返回一个布尔值，用于定义设备是否为 TV。

类型
boolean

---

isVision

tsx

static isVision: boolean;

返回一个布尔值，用于定义设备是否为 Apple Vision。如果你使用的是 Apple Vision Pro (专为 iPad 设计)，isVision 将为 false，但 isPad 将为 true

类型
boolean

---

isTesting

tsx

static isTesting: boolean;

返回一个布尔值，用于定义应用程序是否在设置了测试标志的开发者模式下运行。

类型
boolean

---

OS

tsx

static OS: 'android' | 'ios';

返回表示当前操作系统的字符串值。

类型
enum('android', 'ios')

---

Version

tsx

static Version: 'number' | 'string';

返回操作系统的版本。

类型
number Android string iOS

方法

select()

tsx

static select(config: Record<string, T>): T;

返回最适合当前运行平台的值。

参数：

名称	类型	必需	描述
config	object	是	见下方的配置描述。

select 方法返回最适合当前运行平台的值。也就是说，如果你在手机上运行，android 和 ios 键将优先。如果未指定这些，将使用 native 键，然后是 default 键。

config 参数是一个对象，包含以下键：

• android
• ios
• macos（仅在使用 react-native-macos 时适用）
• native（除 web 外所有平台的回退）
• web（仅在使用 react-native-web 时适用）
• windows（仅在使用 react-native-windows 时适用）
• default（所有平台的回退）

使用示例：

tsx

import {Platform, StyleSheet} from 'react-native';

const styles = StyleSheet.create({
  container: {
    flex: 1,
    ...Platform.select({
      android: {
        backgroundColor: 'green',
      },
      ios: {
        backgroundColor: 'red',
      },
      default: {
        // 其他平台，例如 web
        backgroundColor: 'blue',
      },
    }),
  },
});

这将导致容器在所有平台上具有 flex: 1，在 Android 上具有绿色背景色，在 iOS 上具有红色背景色，在其他平台上具有蓝色背景色。

由于对应平台键的值可以是 any 类型，select 方法也可用于返回特定于平台的组件，如下所示：

tsx

const Component = Platform.select({
  ios: () => require('ComponentIOS'),
  android: () => require('ComponentAndroid'),
})();

<Component />;

tsx

const Component = Platform.select({
  native: () => require('ComponentForNative'),
  default: () => require('ComponentForWeb'),
})();

<Component />;