首页指南参考教程
This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 51).

Expo Constants

An API that provides system information that remains constant throughout the lifetime of your app's installation.

Android
iOS
tvOS
Web

expo-constants provides system information that remains constant throughout the lifetime of your app's install.

Installation

Terminal
npx expo install expo-constants

If you are installing this in an existing React Native app (bare workflow), start by installing expo in your project. Then, follow the additional instructions as mentioned by library's README under "Installation in bare React Native projects" section.

API

import Constants from 'expo-constants';

Interfaces

Android
iOS
tvOS
Web

AndroidManifest

AndroidManifest Properties

NameTypeDescription
versionCodenumber

Deprecated Use expo-application's Application.nativeBuildVersion.

The version code set by android.versionCode in app.json. The value is set to null in case you run your app in Expo Go.


Android
iOS
tvOS
Web

IOSManifest

IOSManifest Properties

NameTypeDescription
buildNumbernull | string

The build number specified in the embedded Info.plist value for CFBundleVersion in this app. In a standalone app, you can set this with the ios.buildNumber value in app.json. This may differ from the value in Constants.expoConfig.ios.buildNumber because the manifest can be updated, whereas this value will never change for a given native binary. The value is set to null in case you run your app in Expo Go.

modelnull | string

Deprecated Moved to expo-device as Device.modelName.

The human-readable model name of this device. For example, "iPhone 7 Plus" if it can be determined, otherwise will be null.

platformstring

Deprecated Use expo-device's Device.modelId.

The Apple internal model identifier for this device. For example, iPhone1,1.

systemVersionstring

Deprecated Use expo-device's Device.osVersion.

The version of iOS running on this device. For example, 10.3.

userInterfaceIdiomUserInterfaceIdiom

Deprecated Use expo-device's Device.getDeviceTypeAsync().

The user interface idiom of the current device, such as whether the app is running on an iPhone, iPad, Mac or Apple TV.


Android
iOS
tvOS
Web

NativeConstants

NativeConstants Properties

NameTypeDescription
appOwnershipnull | Expo

Returns expo when running in Expo Go, otherwise null.

debugModeboolean

Returns true when the app is running in debug mode (__DEV__). Otherwise, returns false.

deviceName
(optional)
string

A human-readable name for the device type.

deviceYearClassnull | number

Deprecated Moved to expo-device as Device.deviceYearClass.

The device year class of this device.

easConfignull | EASConfig

The standard EAS config object populated when using EAS.

executionEnvironmentExecutionEnvironment

Returns the current execution environment.

experienceUrlstring-
expoConfignull | ExpoConfig & { hostUri: string }

The standard Expo config object defined in app.json and app.config.js files. For both classic and modern manifests, whether they are embedded or remote.

expoGoConfignull | ExpoGoConfig

The standard Expo Go config object populated when running in Expo Go.

expoRuntimeVersionnull | string-
expoVersionnull | string

The version string of the Expo Go app currently running. Returns null in bare workflow and web.

getWebViewUserAgentAsync() => Promise<null | string>

Gets the user agent string which would be included in requests sent by a web view running on this device. This is probably not the same user agent you might be providing in your JS fetch requests.

intentUri
(optional)
string-
isDetached
(optional)
boolean-
isHeadlessboolean

Returns true if the app is running in headless mode. Otherwise, returns false.

linkingUristring-
manifest2null | ExpoUpdatesManifest

Manifest for Expo apps using modern Expo Updates from a remote source, such as apps that use EAS Update. Constants.expoConfig should be used for accessing the Expo config object.

platform
(optional)
PlatformManifest

Returns the specific platform manifest object.

Note: This is distinct from the manifest and manifest2.

sessionIdstring

A string that is unique to the current session of your app. It is different across apps and across multiple launches of the same app.

statusBarHeightnumber

The default status bar height for the device. Does not factor in changes when location tracking is in use or a phone call is active.

systemFontsstring[]

A list of the system font names available on the current device.

systemVersion
(optional)
number-

Android
iOS
tvOS
Web

PlatformManifest

PlatformManifest Properties

NameTypeDescription
android
(optional)
AndroidManifest-
detach
(optional)
{ scheme: string }-
developer
(optional)
string-
hostUri
(optional)
string-
ios
(optional)
IOSManifest-
scheme
(optional)
string-
web
(optional)
WebManifest-

Types

Android
iOS
tvOS
Web

ClientScopingConfig

Type: ClientScopingConfigForReExport

Android
iOS
tvOS
Web

EASConfig

Type: ManifestsEASConfig

Android
iOS
tvOS
Web

ExpoGoConfig

Type: ManifestsExpoGoConfig

Android
iOS
tvOS
Web

ExpoGoPackagerOpts

Type: ExpoGoPackagerOptsForReExport

Android
iOS
tvOS
Web

Manifest

Type: ExpoUpdatesManifest

Android
iOS
tvOS
Web

ManifestAsset

Type: ManifestAssetForReExport

Android
iOS
tvOS
Web

ManifestExtra

Type: ManifestExtraForReExport

Enums

Android
iOS
tvOS
Web

AppOwnership

AppOwnership Values

Deprecated Use Constants.executionEnvironment instead.

Expo

AppOwnership.Expo = "expo"

The experience is running inside of the Expo Go app.

Android
iOS
tvOS
Web

ExecutionEnvironment

ExecutionEnvironment Values

Bare

ExecutionEnvironment.Bare = "bare"

Standalone

ExecutionEnvironment.Standalone = "standalone"

StoreClient

ExecutionEnvironment.StoreClient = "storeClient"
Android
iOS
tvOS
Web

UserInterfaceIdiom

Current supported values are handset, tablet, desktop and tv. CarPlay will show up as unsupported.

UserInterfaceIdiom Values

Desktop

UserInterfaceIdiom.Desktop = "desktop"

Handset

UserInterfaceIdiom.Handset = "handset"

Tablet

UserInterfaceIdiom.Tablet = "tablet"

TV

UserInterfaceIdiom.TV = "tv"

Unsupported

UserInterfaceIdiom.Unsupported = "unsupported"
Expo 中文网 - 粤ICP备13048890号