expo-localization
Advanced tools
The expo-localization package provides utilities for determining the locale, language, and region settings of a user's device. It is useful for internationalizing and localizing applications to provide a more personalized user experience.
Get current locale
This feature allows you to get the current locale of the user's device. The locale is a string that represents the language and region settings, such as 'en-US' for English (United States).
import * as Localization from 'expo-localization';
console.log(Localization.locale);Get preferred languages
This feature provides an array of preferred languages set on the user's device. This can be useful for applications that support multiple languages and want to prioritize content based on user preferences.
import * as Localization from 'expo-localization';
console.log(Localization.locales);Get timezone
This feature allows you to get the current timezone of the user's device. The timezone is a string that represents the time zone identifier, such as 'America/Los_Angeles'.
import * as Localization from 'expo-localization';
console.log(Localization.timezone);Get country
This feature provides the country code of the user's device, such as 'US' for the United States. This can be useful for region-specific content or services.
import * as Localization from 'expo-localization';
console.log(Localization.country);The react-native-localize package provides similar functionalities for determining the locale, language, and region settings of a user's device. It offers more comprehensive support for React Native applications and includes additional features like currency and calendar type detection.
The i18next package is a powerful internationalization framework for JavaScript applications. While it does not directly provide device locale information, it integrates well with localization packages to manage translations and language switching in applications.
The globalize package is a comprehensive library for internationalization and localization in JavaScript. It provides functionalities for formatting numbers, dates, and strings based on locale settings. It can be used in conjunction with device locale detection packages to provide a complete localization solution.
expo-localization enables you to interface with the native device locale.
Now, you need to install the package from npm registry.
npm install expo-localization or yarn add expo-localization
If you're using Cocoapods, add the dependency to your Podfile:
pod 'EXLocalization', path: '../node_modules/expo-localization/ios'
and if not already included
pod 'EXCore', path: '../node_modules/expo-core/ios'
and run pod install.
Libraries ➜ Add Files to [your project's name].node_modules ➜ expo-localization ➜ ios and add EXLocalization.xcodeproj.libEXLocalization.a to your project's Build Phases ➜ Link Binary With Libraries.Cmd+R).Append the following lines to android/settings.gradle:
include ':expo-localization'
project(':expo-localization').projectDir = new File(rootProject.projectDir, '../node_modules/expo-localization/android')
and if not already included
include ':expo-core'
project(':expo-core').projectDir = new File(rootProject.projectDir, '../node_modules/expo-core/android')
Insert the following lines inside the dependencies block in android/app/build.gradle:
api project(':expo-localization')
and if not already included
api project(':expo-core')
Some Unimodules are not included in the default ExpoKit suite, these modules will needed to be added manually.
If your Android build cannot find the Native Modules, you can add them like this:
./android/app/src/main/java/host/exp/exponent/MainActivity.java
@Override
public List<Package> expoPackages() {
// Here you can add your own packages.
return Arrays.<Package>asList(
new LocalizationPackage() // Include this.
);
}
import React from 'react';
import { Text } from 'react-native';
import { Localization } from 'expo-localization';
import i18n from 'i18n-js';
const en = {
foo: 'Foo',
bar: 'Bar {{someValue}}',
};
const fr = {
foo: 'como telle fous',
bar: 'chatouiller {{someValue}}',
};
i18n.fallbacks = true;
i18n.translations = { fr, en };
i18n.locale = Localization.locale;
export default class LitView extends React.Component {
componentWillMount() {
this._subscription = Localization.addListener(({ locale }) => {
i18n.locale = locale;
});
}
componentWillUnmount() {
if (!!this._subscription) {
this._subscription.remove();
}
}
render() {
return (
<Text>
{i18n.t('foo')} {i18n.t('bar', { someValue: Date.now() })}
</Text>
);
}
}
This API is mostly synchronous and driven by constants.
Localization.locale: stringNative device language, returned in standard format. ex: en-US, es-US.
Localization.locales: Array<string>List of all the native languages provided by the user settings. These are returned in the order the user defines in their native settings.
Localization.country: ?stringCountry code for your device.
Localization.isoCurrencyCodes: ?Array<string>A list of all the supported ISO codes.
Localization.timezone: stringThe current time zone in display format. ex: America/Los_Angeles
Localization.isRTL: booleanThis will return true if the current language is Right-to-Left.
Callbacks are Android only, changing the native locale on iOS will cause all the apps to reset.
Localization.addListener(listener: Listener): ?SubscriptionObserve when a language is added or moved in the Android settings.
Localization.removeAllListeners(): voidClear all language observers.
Localization.removeSubscription(subscription: Subscription): voidStop observing when the native languages are edited.
51.0.0 — 2024-05-07
expo-auth-session
expoClientId field from auth proxy. (#28590 by @EvanBacon)expo-barcode-scanner
expo-barcode-scanner is now deprecated. Please use expo-camera instead. (#26025 by @alanjhughes)expo-constants
expo-face-detector
expo-face-detector is now deprecated. We recommed using react-native-vision-camera instead. (#26026 by @alanjhughes)expo-location
expo-local-authentication
expo-modules-core
expo-sms
sendSMSAsync now throws error code ERR_UNAVAILABLE instead of E_SMS_UNAVAILABLE. (#27437 by @EvanBacon)expo-sqlite
expo-barcode-scanner
BarCodeScannerResult now returns an additional raw field corresponding to the barcode value as it was encoded in the barcode without parsing. Will always be undefined on iOS. (#25391 by @ajacquierbret)expo-blur
expo-asset
expo-camera
BarCodeAnalyzer now passes an additional raw field to its onComplete callback, corresponding to the barcode value as it was encoded in the barcode without parsing. Will always be undefined on iOS. (#25391 by @ajacquierbret)false instead of permission messages. (#28107 by @EvanBacon)pictureSize prop to CameraView component. (#27664 by @alanjhughes)NSMicrophoneUsageDescription and ignore the mute prop if they don't intend to use video. (#28156 by @alanjhughes)animateShutter prop to provide feedback when a picture is taken. Also added shutter sound on android. (#28211 by @alanjhughes)expo-constants
expo-crypto
expo-contacts
expo-font
expo-file-system
expo-haptics
rigid and soft impact types (#28169 by @rodperottoni)expo-image-picker
false instead of permission messages. (#28107 by @EvanBacon)legacy option to ImagePickerOptions to allow using the legacy image picker on android. (#28514 by @alanjhughes)expo-image-manipulator
expo-linear-gradient
expo-keep-awake
expo-location
formattedAddress to the LocationGeocodedAddress. (#26342 by @whysetiawan & @lukmccall) (#26342 by @whysetiawan, @lukmccall) (#26342, #26342 by @whysetiawan, @lukmccall, @whysetiawan, @lukmccall)isAndroidForegroundServiceEnabled config plugin option #27265 by @brentvatne)false instead of permission messages. (#28107 by @EvanBacon)expo-localization
expo-local-authentication
expo-network
expo-modules-core
Date type converter. (#26148 by @alanjhughes)PlatformColor and DynamicColorIOS color props. (#26724 by @dlindenkreuz)BarCodeScannerResult interface now declares an additional raw field corresponding to the barcode value as it was encoded in the barcode without parsing. Will always be undefined on iOS. (#25391 by @ajacquierbret)createWebModule function to wrap web functionality with the NativeModule class. (#27739 by @aleqsio)expo.SharedObject) with a simple mechanism to release native pointer from JS. (#27038 by @tsapeta & #27331 by @lukmccall) (#27038, #27331 by @tsapeta, @lukmccall)AnyExpoView (#27284 by @dominicstop)startObserving and stopObserving in the new EventEmitter class. (#27393 by @tsapeta)NativeModule class that inherits from EventEmitter. (#27510 by @tsapeta)OnStartObserving and OnStopObserving can now be attached to a specific event. (#27766 by @tsapeta)reloadAppAsync to reload the app. (#28400 by @kudo)expo-media-library
expo-screen-capture
expo-secure-store
false instead of permission messages. (#28107 by @EvanBacon)canUseBiometricAuthentication function. (#26767 by @behenate)expo-store-review
StoreReview.isAvailableAsync() on iOS now resolves to false for apps distributed through TestFlight. (#25900 by @gabrieldonadel)expo-sqlite
SQLiteStatement.executeForRawResultAsync() in expo-sqlite/next API which returns array based raw values than key-value based row value. (#26073 by @kudo)expo.sqlite.customBuildFlags gradle property to support custom sqlite3 building flags. (#27385 by @kudo)serializeAsync() and deserializeDatabaseAsync() to serialze and deserialize databases. (#27422 by @kudo)SQLiteProvider.assetSource to import an existing database from assets. (#28291 by @kudo)expo-av
Events to AVModule to prevent event emitter warning. (#26434 by @alanjhughes)AVManager. (#28159 by @lukmccall)HashMap cannot be cast to ReadableNativeMap error on Android. (#28317 by @lukmccall)expo-blur
setNativeProps being removed. (#27721 by @EvanBacon)expo-asset
unstable_path in development. (#26084 by @EvanBacon)TypeError: (0, _ExpoAsset.downloadAsync) is not a function when loading assets using Expo Web. (#28405 by @jamiees2)downloadAsync() does not support Android resources from release builds. (#28604 by @kudo)expo-calendar
expo-camera
iOS, barcode types were not converted correctly causing the scanner to not start immediately. (#26704 by @alanjhughes)iOS, fix maxDuration timescale on videos. (#26882 by @alanjhughes)Android, fix the camera not being released when the view is destroyed. (#27086 by @alanjhughes)iOS, fix the orientation value in onResponsiveOrientationChanged when exif is set to true. (#27314 by @alanjhughes)Android, fix empty qualities being passed to QualitySelector (#27126 by @leonhh)web, prevent creating a webworker when rendering on the server (#27222 by @marklawlor)iOS, fix method call on an optional variable. (#27235 by @alanjhughes)flash being passed to native. (#27394 by @alanjhughes)mute prop is passed to native so it is correctly initialiased even when not provided from JS. (#27546 by @alanjhughes)iOS, fix camera orientation on initial render. (#27545 by @alanjhughes)iOS, fix an issue where the configuration can be interuppted when the dev menu is presented on intial launch. (#27572 by @alanjhughes)iOS, fix getAvailablePictureSizes in the legacy package. (#27642 by @alanjhughes)iOS where the barcode types did not match the typescript representation. Also enabled scanning upc_a codes on iOS. (#28233 by @alanjhughes)iOS, fixed regression where recording a video captures dark frames. Reduced frequency of camera initialization. (#28427 by @alanjhughes)expo-constants
expo-contacts
expo-device
Device.productName now returns Build.PRODUCT instead of Build.DEVICE. (#27230 by @alex-fournier)expo-font
expo-file-system
iOS, set httpMethod on upload requests. (#26516 by @alanjhughes)iOS, fix upload task requests. (#26880 by @alanjhughes)iOS, fix an issue with copyAsync where the copy fails if it is a photo library asset. (#27208 by @alanjhughes)iOS, resolve the promise manually after copying a PHAsset file. (#27381 by @alanjhughes)CookieHandler as it's no longer in the module registry and not necessary. (#28145 by @alanjhughes)expo-gl
react-native-reanimated. (#28414 by @lukmccall)expo-image-picker
fileSize was named filesize which did not match the docs & typescript definition. (#27293 by @WookieFPV) (#27293 by @wookieFPV)expo-intent-launcher
double. However, it must be int. (#26164 by @Alperengozum)expo-location
expo-task-manager module for methods that don't use it. (#26200 by @behenate)NullPointerException: it must not be null. (#26688 by @lukmccall)Android, prevent location service from starting when permission is not in the manifest. (#27355 by @alanjhughes)expo-localization
expo-modules-core
OnCreate was called before the React instance was ready. (#25866 by @lukmccall)SharedObjectRegistry crash for accessing internal data structures from multi-threads. (#25997 by @kudo)SharedObject leakage on Android. (#25995 by @kudo)Enumerable. (#26108 by @alanjhughes)Serializable types are not obfuscated. (#26545 by @alanjhughes)onCreate before OnActivityEntersForeground event. (#26944 by @lukmccall)RCTHost is not retained on iOS bridgeless mode. (#27715 by @kudo)recreateRootViewWithBundleURL parameters. (#27989 by @gabrieldonadel)ExpoBridgeModule.installModules() is broken on Android and bridgeless mode. (#28065 by @kudo)expo::MethodMetadata::convertJSIArgsToJNI. (#28163 by @lukmccall)TypeError: Cannot read property 'NativeModule' of undefined exceptions on Android. (#28200 by @kudo)fallbackToCacheTimeout. (#28227 by @kudo)EXJavaScriptObject accesses to dangling pointers. (#28262 by @kudo)AppContext.onHostResume() sometimes getting null currentActivity on Android. (#28338 by @kudo)std::shared_ptr<JavaCalllback::CallbackContext>::__on_zero_shared. (#28483 by @lukmccall)field operation on NULL object when reloading the app. (#28555 by @lukmccall)expo-media-library
default as sorting key. (#28328 by @aleqsio)expo-notifications
expo-notifications requiring the expo-task-manager module to start. (#26227 by @behenate)UnavailabilityError when trying to use setNotificationCategoryAsync on web. (#26511 by @marklawlor).native hardcoded platform imports (#26511 by @marklawlor)Android, added events to module definition to clear warnings. (#26654 by @alanjhughes)expo-screen-capture
DETECT_SCREEN_CAPTURE permission. (#27148 by @alanjhughes)expo-screen-orientation
expo-sensors
Android, add event name to definition in the DeviceMotionModule. (#26679 by @alanjhughes)expo-store-review
expo-task-manager
Android, added events to module definition to clear warnings. (#26654 by @alanjhughes)expo-sqlite
NativeStatementBinding leakage on Android. (#25996 by @kudo)SQLiteDatabase.getAllAsync() in expo-sqlite/next API. (#26344 by @kudo)expo-sqlite/next cannot be imported from an ESM project. (#27423 by @kudo)NullPointerException on Android when opening the same database multiple times. (#27748 by @kudo)expo-video-thumbnails
expo-web-browser
iOS, fix an issue where rapidly opening and closing the browser would leave the module in a bad state, preventing opening the browser again. (#28452 by @alanjhughes)expo-application
expo-av
com.facebook.react:react-native:+ Android dependency with com.facebook.react:react-android. (#26237 by @kudo)name property. (#27437 by @EvanBacon)expo-background-fetch
name property. (#27437 by @EvanBacon)expo-auth-session
expo-battery
name property. (#27437 by @EvanBacon)expo-brightness
name property. (#27437 by @EvanBacon)expo-barcode-scanner
name property. (#27437 by @EvanBacon)expo-blur
expo-asset
downloadAsync to a native implementation. (#27369 by @aleqsio)expo-calendar
name property. (#27437 by @EvanBacon)expo-cellular
expo-camera
Barcode consistent. (#26900 by @alanjhughes)name property. (#27437 by @EvanBacon)Android, requesting audio permissions was meant to be optional in the config plugin. (#27365 by @alanjhughes)Android, only recreate camera after certain props have changed. (#27952 by @alanjhughes)next package to stable. (#28226 by @alanjhughes)expo-clipboard
expo-constants
expo-crypto
name property. (#27437 by @EvanBacon)https. (#26729 by @EvanBacon)expo-contacts
name property. (#27437 by @EvanBacon)ShareOptions type for shareContactAsync parameter typing. (#26208 by @Simek)expo-device
expo-document-picker
name property. (#27437 by @EvanBacon)expo-font
name property. (#27437 by @EvanBacon)expo-face-detector
name property. (#27437 by @EvanBacon)expo-file-system
expo-gl
expo-haptics
name property. (#27437 by @EvanBacon)expo-image-loader
expo-image-picker
name property. (#27437 by @EvanBacon).jpeg in the ImagePicker result. (#26419 by @NikitaDudin)expo-intent-launcher
name property. (#27437 by @EvanBacon)expo-image-manipulator
name property. (#27437 by @EvanBacon)expo-linear-gradient
expo-keep-awake
expo-location
expo-localization
expo-local-authentication
name property. (#27437 by @EvanBacon)expo-mail-composer
expo-network
expo-modules-core
1.8.10 to 1.8.22. (#25945 by @lukmccall)com.facebook.react:react-native:+ Android dependency with com.facebook.react:react-android. (#26237 by @kudo)expo.modules.core.Promise. (#27471 by @aleqsio)global.ExpoModules. (#26027 by @tsapeta)ObjectDeallocator is now a native state instead of a host object. (#26906 by @tsapeta)SharedObjectRegistry being a singleton. (#27032 by @tsapeta)EXCreateReactBindingRootView to create correct React Native setup for New Architecture mode. (#27216 by @kudo)AppContext in ExpoBridgeModule. (#27378 by @alanjhughes)EXReactRootViewFactory.createDefaultReactRootView: to RCTAppDelegate.recreateRootViewWithBundleURL: category. (#27945 by @kudo)ReactNativeHostHandler.onReactInstanceException() for client to listen for exceptions on Android. (#27815 by @kudo)expo-font and nothing else depends on them. (#26380 by @tsapeta)onDidCreateDevSupportManager handler to support error recovery from expo-updates. (#28177 by @kudo)ExpoReactDelegateHandler.bundleURL for clients to override newer bundleURL. (#28256 by @kudo)expo-media-library
name property. (#27437 by @EvanBacon)ACCESS_MEDIA_LOCATION Android permission should not pulled into by default and should be pulled through Config Plugins. (#28230 by @kudo)expo-notifications
expo-screen-capture
expo-print
name property. (#27437 by @EvanBacon)expo-random
name property. (#27437 by @EvanBacon)expo-screen-orientation
name property. (#27437 by @EvanBacon)expo-sharing
name property. (#27437 by @EvanBacon)expo-secure-store
name property. (#27437 by @EvanBacon)expo-sms
name property. (#27437 by @EvanBacon)expo-speech
expo-sensors
name property. (#27437 by @EvanBacon)expo-store-review
name property. (#27437 by @EvanBacon)expo-task-manager
expo-sqlite
onDatabaseChange event from legacy API as it is not supported natively. (#26655 by @alanjhughes)name property. (#27437 by @EvanBacon)expo-video-thumbnails
name property. (#27437 by @EvanBacon)expo-web-browser
androidx.browser:browser to 1.6.0 #26619 by @zoontekname property. (#27437 by @EvanBacon)https. (#26729 by @EvanBacon)compare-urls and url dependencies in favor of built-in URL support. (#26702 by @EvanBacon)unimodules-app-loader
FAQs
Provides an interface for native user localization information.
The npm package expo-localization receives a total of 158,245 weekly downloads. As such, expo-localization popularity was classified as popular.
We found that expo-localization demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 29 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.