Home

Awesome

Capacitor Native Settings

Capacitor plugin to open native settings screens for Android and iOS.

Plugin versions

Capacitor versionPlugin version
v6>= v6.0.0
v5>= v5.0.0
v4>= v4.0.0
v3<= v2.0.1

Install

npm install capacitor-native-settings
npx cap sync

Example

import { NativeSettings, AndroidSettings, IOSSettings } from 'capacitor-native-settings';

/**
 * Note that the only supported option by Apple is "App".
 * Using other options might break in future iOS versions
 * or have your app rejected from the App Store.
 */
NativeSettings.open({
  optionAndroid: AndroidSettings.ApplicationDetails, 
  optionIOS: IOSSettings.App
})

NativeSettings.openAndroid({
  option: AndroidSettings.ApplicationDetails,
});

/**
 * Note that the only supported option by Apple is "App".
 * Using other options might break in future iOS versions
 * or have your app rejected from the App Store.
 */
NativeSettings.openIOS({
  option: IOSSettings.App,
});

API

<docgen-index> </docgen-index> <docgen-api> <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

open(...)

open(option: PlatformOptions) => Promise<{ status: boolean; }>

Opens the specified options on android & ios. Note that the only supported option by Apple is "App". Using other options might break in future iOS versions or have your app rejected in the App Store.

ParamTypeDescription
option<code><a href="#platformoptions">PlatformOptions</a></code><a href="#platformoptions">PlatformOptions</a>

Returns: <code>Promise<{ status: boolean; }></code>


openAndroid(...)

openAndroid(option: AndroidOptions) => Promise<{ status: boolean; }>

Opens the specified option in android. Only use this if you have made sure the user is on android. This can be done by checking the platform before hand.

ParamTypeDescription
option<code><a href="#androidoptions">AndroidOptions</a></code><a href="#androidoptions">AndroidOptions</a>

Returns: <code>Promise<{ status: boolean; }></code>


openIOS(...)

openIOS(option: IOSOptions) => Promise<{ status: boolean; }>

Opens the specified option on iOS. Only use this if you have made sure the user is on iOS. This can be done by checking the platform before hand.

Note that the only supported option by Apple is "App". Using other options might break in future iOS versions or have your app rejected in the App Store.

ParamTypeDescription
option<code><a href="#iosoptions">IOSOptions</a></code><a href="#iosoptions">IOSOptions</a>

Returns: <code>Promise<{ status: boolean; }></code>


Interfaces

PlatformOptions

PropType
optionAndroid<code><a href="#androidsettings">AndroidSettings</a></code>
optionIOS<code><a href="#iossettings">IOSSettings</a></code>

AndroidOptions

PropType
option<code><a href="#androidsettings">AndroidSettings</a></code>

IOSOptions

PropType
option<code><a href="#iossettings">IOSSettings</a></code>

Enums

AndroidSettings

MembersValueDescription
Accessibility<code>'accessibility'</code>Show settings for accessibility modules
Account<code>'account'</code>Show add account screen for creating a new account
AirplaneMode<code>'airplane_mode'</code>Show settings to allow entering/exiting airplane mode
Apn<code>'apn'</code>Show settings to allow configuration of APNs
ApplicationDetails<code>'application_details'</code>Show screen of details about a particular application
ApplicationDevelopment<code>'application_development'</code>Show settings to allow configuration of application development-related settings
Application<code>'application'</code>Show settings to allow configuration of application-related settings
AppNotification<code>'app_notification'</code>Show settings to allow configuration of application-specific notifications
BatteryOptimization<code>'battery_optimization'</code>Show screen for controlling which apps can ignore battery optimizations
Bluetooth<code>'bluetooth'</code>Show settings to allow configuration of Bluetooth
Captioning<code>'captioning'</code>Show settings for video captioning
Cast<code>'cast'</code>Show settings to allow configuration of cast endpoints
DataRoaming<code>'data_roaming'</code>Show settings for selection of 2G/3G/4G
Date<code>'date'</code>Show settings to allow configuration of date and time
Display<code>'display'</code>Show settings to allow configuration of display
Dream<code>'dream'</code>Show Daydream settings
Home<code>'home'</code>Show Home selection settings
Keyboard<code>'keyboard'</code>Show settings to configure input methods, in particular allowing the user to enable input methods
KeyboardSubType<code>'keyboard_subtype'</code>Show settings to enable/disable input method subtypes
Locale<code>'locale'</code>Show settings to allow configuration of locale
Location<code>'location'</code>Show settings to allow configuration of current location sources
ManageApplications<code>'manage_applications'</code>Show settings to manage installed applications
ManageAllApplications<code>'manage_all_applications'</code>Show settings to manage all applications
MemoryCard<code>'memory_card'</code>Show settings for memory card storage
Network<code>'network'</code>Show settings for selecting the network operator
NfcSharing<code>'nfcsharing'</code>Show NFC Sharing settings
NfcPayment<code>'nfc_payment'</code>Show NFC Tap & Pay settings
NfcSettings<code>'nfc_settings'</code>Show NFC settings
Print<code>'print'</code>Show the top level print settings
Privacy<code>'privacy'</code>Show settings to allow configuration of privacy options
QuickLaunch<code>'quick_launch'</code>Show settings to allow configuration of quick launch shortcuts
Search<code>'search'</code>Show settings for global search
Security<code>'security'</code>Show settings to allow configuration of security and location privacy
Settings<code>'settings'</code>Show system settings
ShowRegulatoryInfo<code>'show_regulatory_info'</code>Show the regulatory information screen for the device
Sound<code>'sound'</code>Show settings to a llow configuration of sound and volume
Storage<code>'storage'</code>Show settings for internal storage
Sync<code>'sync'</code>Show settings to allow configuration of sync settings
Usage<code>'usage'</code>Show settings to control access to usage information
UserDictionary<code>'user_dictionary'</code>Show settings to manage the user input dictionary
VoiceInput<code>'voice_input'</code>Show settings to configure input methods, in particular allowing the user to enable input methods
Wifi<code>'wifi'</code>Show settings to allow configuration of Wi-Fi
WifiIp<code>'wifi_ip'</code>Show settings to allow configuration of a static IP address for Wi-Fi
Wireless<code>'wireless'</code>Show settings to allow configuration of wireless controls such as Wi-Fi, Bluetooth and Mobile networks

IOSSettings

MembersValueDescription
About<code>'about'</code>Settings > About page
App<code>'app'</code>Opens your app-specific settings screen. Note that this is the only officially supported settings screen by Apple.
AutoLock<code>'autoLock'</code>Used to set if and when the screen should be automatically locked.
Bluetooth<code>'bluetooth'</code>Bluetooth settings. Allows the users to enable/disable bluetooth and to search for devices.
DateTime<code>'dateTime'</code>Date and time settings.
FaceTime<code>'facetime'</code>FaceTime settings.
General<code>'general'</code>Opens iOS general settings screen.
Keyboard<code>'keyboard'</code>Keyboard settings.
ICloud<code>'iCloud'</code>iCloud settings.
ICloudStorageBackup<code>'iCloudStorageBackup'</code>iCloud Storage and Backup settings.
International<code>'international'</code>Language and region settings.
LocationServices<code>'locationServices'</code>Show settings to allow configuration of current location sources
Music<code>'music'</code>Music settings.
Notes<code>'notes'</code>Notes settings.
Notifications<code>'notifications'</code>Notifications settings.
Phone<code>'phone'</code>Phone settings.
Photos<code>'photos'</code>Photos settings.
ManagedConfigurationList<code>'managedConfigurationList'</code>Allows the user to manage configuration profiles that are installed on the phone.
Reset<code>'reset'</code>Screen where the user can reset the phone to factory settings.
Ringtone<code>'ringtone'</code>Ringtone settings.
Sounds<code>'sounds'</code>Used to set phone volume, vibration settings, etc.
SoftwareUpdate<code>'softwareUpdate'</code>Software update screen.
Store<code>'store'</code>Store settings.
Tracking<code>'tracking'</code>Tracking settings.
Wallpaper<code>'wallpaper'</code>Wallpaper settings.
WiFi<code>'wifi'</code>WiFi settings.
Tethering<code>'tethering'</code>Tethering settings (used to create a hotspot with mobile data).
DoNotDisturb<code>'doNotDisturb'</code>Do Not Disturb settings.
TouchIdPasscode<code>'touchIdPasscode'</code>Touch id passcode settings.
ScreenTime<code>'screenTime'</code>Screen Time settings.
Accessibility<code>'accessibility'</code>Accessibility settings.
</docgen-api>