An API that provides system information that remains constant throughout the lifetime of your app's installation.
expo-constants
provides system information that remains constant throughout the lifetime of your app's installation.
Platform Compatibility
Android Device | Android Emulator | iOS Device | iOS Simulator | Web |
---|---|---|---|---|
Installation
-
npx expo install expo-constants
If you are installing this in an existing React Native app, make sure to install expo
in your project.
API
import Constants from 'expo-constants';
Interfaces
Property | Type | Description |
---|---|---|
versionCode | number |
The version code set by |
Property | Type | Description |
---|---|---|
buildNumber | null | string | The build number specified in the embedded Info.plist value for |
model | null | string |
The human-readable model name of this device, e.g. |
platform | string |
The Apple internal model identifier for this device, e.g. |
systemVersion | string |
The version of iOS running on this device, e.g. |
userInterfaceIdiom | UserInterfaceIdiom |
The user interface idiom of this device, i.e. whether the app is running on an iPhone, iPad, Mac or Apple TV. |
Property | Type | Description |
---|---|---|
appOwnership | null | AppOwnership | Returns |
debugMode | boolean | - |
deviceName(optional) | string | A human-readable name for the device type. |
deviceYearClass | null | number |
The device year class of this device. |
easConfig | null | EASConfig | The standard EAS config object populated when using EAS. |
executionEnvironment | ExecutionEnvironment | - |
experienceUrl | string | - |
expoConfig | null | ExpoConfig & {
hostUri: string
} | The standard Expo config object defined in |
expoGoConfig | null | ExpoGoConfig | The standard Expo Go config object populated when running in Expo Go. |
expoRuntimeVersion | null | string | - |
expoVersion | null | string | The version string of the Expo Go app currently running.
Returns |
getWebViewUserAgentAsync | () => Promise<null | string> | - |
installationId | string |
An identifier that is unique to this particular device and whose lifetime is at least as long as the installation of the app. |
intentUri(optional) | string | - |
isDetached(optional) | boolean | - |
isDevice | boolean |
|
isHeadless | boolean | - |
linkingUri | string | - |
manifest | null | BareManifest |
Classic manifest for Expo apps using classic updates and the updates embedded in builds.
Returns |
manifest2 | null | NewManifest | Manifest for Expo apps using modern Expo Updates from a remote source, such as apps that
use EAS Update. Returns |
nativeAppVersion | null | string |
The Info.plist value for |
nativeBuildVersion | null | string |
The Info.plist value for |
platform(optional) | PlatformManifest | - |
sessionId | string | 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. |
statusBarHeight | number | 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. |
systemFonts | string[] | A list of the system font names available on the current device. |
systemVersion(optional) | number | - |
Property | Type | Description |
---|---|---|
android(optional) | AndroidManifest | - |
detach(optional) | {
scheme: string
} | - |
developer(optional) | string | - |
hostUri(optional) | string | - |
ios(optional) | IOSManifest | - |
scheme(optional) | string | - |
web(optional) | WebManifest | - |
Types
Type: ManifestsEASConfig
Type: ManifestsExpoGoConfig
Type: NewManifest
Type: ManifestAssetForReExport
Type: ManifestExtraForReExport
Enums
Current supported values are handset
, tablet
, desktop
and tv
. CarPlay will show up
as unsupported
.