IntentLauncher

expo-intent-launcher provides a way to launch Android intents. For example, you can use this API to open a specific settings screen.

Platform Compatibility

Android Device	Android Emulator	iOS Device	iOS Simulator	Web
✅	✅	✅	✅	❌

Installation

expo install expo-intent-launcher

If you're installing this in a bare React Native app, you should also follow these additional installation instructions.

Example

import * as IntentLauncher from 'expo-intent-launcher';

// Open location settings
IntentLauncher.startActivityAsync(IntentLauncher.ACTION_LOCATION_SOURCE_SETTINGS);

API

import * as IntentLauncher from 'expo-intent-launcher';

Methods

IntentLauncher.startActivityAsync(activityAction, intentParams)

Types

IntentLauncherParams

IntentLauncherResult

Enums

ResultCode

Methods

`IntentLauncher.startActivityAsync(activityAction, intentParams)`

Starts the specified activity. The method will return a promise which resolves when the user returns to the app.

Arguments

activityAction (string) -- The action to be performed, e.g. IntentLauncher.ACTION_WIRELESS_SETTINGS. There are a few pre-defined constants you can use for this parameter. You can find them at expo-intent-launcher/src/IntentLauncher.ts. Required
intentParams (IntentLauncherParams) -- An object of intent parameters.

Returns

A promise resolving to an object of type IntentLauncherResult.

Types

`IntentLauncherParams`

Key	Type	Description
type	string	A string specifying the MIME type of the data represented by the `data` parameter. Ignore this argument to allow Android to infer the correct MIME type.
category	string	Category provides more details about the action the intent performs. See Intent.addCategory.
extra	object	A map specifying additional key-value pairs which are passed with the intent as `extras`. The keys must include a package prefix, for example the app `com.android.contacts` would use names like `com.android.contacts.ShowAll`.
data	string	A URI specifying the data that the intent should operate upon. (Note: Android requires the URI scheme to be lowercase, unlike the formal RFC.)
flags	number	Bitmask of flags to be used. See Intent.setFlags for more details.
packageName	string	Package name used as an identifier of ComponentName. Set this only if you want to explicitly set the component to handle the intent.
className	string	Class name of the ComponentName.

`IntentLauncherResult`

Key	Type	Description
resultCode	number	Result code returned by the activity. See ResultCode for more details.
data	string	Optional data URI that can be returned by the activity.
extra	object	Optional extras object that can be returned by the activity.

Enums

`ResultCode`

Result code	Value	Description
Success	-1	Indicates that the activity operation succeeded.
Canceled	0	Means that the activity was canceled, e.g. by tapping on the back button.
FirstUser	1	First custom, user-defined value that can be returned by the activity.