!NPM version !NPM version

Description

React Native module to open settings screen in Android and more.

Installation

1. npm install react-native-android-settings-tool
2. react-native link react-native-android-settings-tool

Usage

Require the react-native-android-settings-tool module.

``ts
import RNAndroidSettingsTool from "react-native-android-settings-tool";

RNAndroidSettingsTool.ACTION_SETTINGS(); // Open the main settings screen.
`

Expamles

Show notification settings:

`ts
import RNAndroidSettingsTool from "react-native-android-settings-tool";

//In some cases, a matching Activity may not exist, so ensure you safeguard against this
try {
// "null" is your app
RNAndroidSettingsTool.ACTION_APP_NOTIFICATION_SETTINGS(null); // Show notification settings for your app.
// or other app (ex. Facebook)
RNAndroidSettingsTool.ACTION_APP_NOTIFICATION_SETTINGS("com.facebook.katana"); // Show notification settings for another package name "com.facebook.katana" NotificationChannel with id 123.
} catch (e) {
// your code
}
`

Show notification channel settings:

`ts
import RNAndroidSettingsTool from "react-native-android-settings-tool";

//In some cases, a matching Activity may not exist, so ensure you safeguard against this
try {
// "null" is your app
RNAndroidSettingsTool.ACTION_CHANNEL_NOTIFICATION_SETTINGS(null, "123"); // Show notification settings for your app NotificationChannel with id 123.
// or other app (ex. Instagram)
RNAndroidSettingsTool.ACTION_CHANNEL_NOTIFICATION_SETTINGS("com.instagram.android", "123"); // Show notification settings for another package name "com.instagram.android" NotificationChannel with id 123.
} catch (e) {
// your code
}
`

Show application details screen:

`ts
import RNAndroidSettingsTool from "react-native-android-settings-tool";

try {
// "null" is your app
RNAndroidSettingsTool.ACTION_APPLICATION_DETAILS_SETTINGS(null); // Show screen of details about your application.
// or other app (ex. Google Chrome)
RNAndroidSettingsTool.ACTION_APPLICATION_DETAILS_SETTINGS("com.android.chrome"); // Show screen details of about for another package name "com.android.chrome".
} catch (e) {
// your code
}
`

Docs

$3

| Functions | Description | Read more |
| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------: |
| ACTION_SETTINGS(); | Show system settings. | Link |
| ACTION_APP_NOTIFICATION_SETTINGS(packageName); | Show notification settings for a single app. | Link |
| ACTION_APP_NOTIFICATION_BUBBLE_SETTINGS(packageName); | Show notification bubble settings for a single app. | Link |
| ACTION_APPLICATION_DETAILS_SETTINGS(packageName); | Show screen of details about a particular application. | Link |
| ACTION_BATTERY_SAVER_SETTINGS(); | Show battery saver settings. | Link |
| ACTION_BLUETOOTH_SETTINGS(); | Show settings to allow configuration of Bluetooth. | Link |
| ACTION_CAPTIONING_SETTINGS(); | Show settings for video captioning. | Link |
| ACTION_CAST_SETTINGS(); | Show settings to allow configuration of cast endpoints. | Link |
| ACTION_CHANNEL_NOTIFICATION_SETTINGS(packageName, chanelID); | Show notification settings for a single NotificationChannel. | Link |
| ACTION_DATA_ROAMING_SETTINGS(); | Show settings for selection of 2G/3G. | Link |
| ACTION_DATE_SETTINGS(); | Show settings to allow configuration of date and time. | Link |
| ACTION_DEVICE_INFO_SETTINGS(); | Show general device information settings (serial number, software version, phone number, etc.). | Link |
| ACTION_DISPLAY_SETTINGS(); | Show settings to allow configuration of display. | Link |
| ACTION_DREAM_SETTINGS(); | Show Daydream settings. | Link |
| ACTION_FINGERPRINT_ENROLL(); | Show settings to enroll fingerprints, and setup PIN/Pattern/Pass if necessary. | Link |
| ACTION_HARD_KEYBOARD_SETTINGS(); | Show settings to configure the hardware keyboard. | Link |
| ACTION_HOME_SETTINGS(); | Show Home selection settings. | Link |
| ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS(packageName); | Show screen for controlling background data restrictions for a particular application. | Link |
| ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS(); | Show screen for controlling which apps can ignore battery optimizations. | Link |
| ACTION_INPUT_METHOD_SETTINGS(); | Show settings to configure input methods, in particular allowing the user to enable input methods. | Link |
| ACTION_INPUT_METHOD_SUBTYPE_SETTINGS(); | Show settings to enable/disable input method subtypes. | Link |
| ACTION_INTERNAL_STORAGE_SETTINGS(); | Show settings for internal storage. | Link |
| ACTION_LOCALE_SETTINGS(); | Show settings to allow configuration of locale. | Link |
| ACTION_LOCATION_SOURCE_SETTINGS(); | Show settings to allow configuration of current location sources. | Link |
| ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS(); | Show settings to manage all applications. | Link |
| ACTION_MANAGE_APPLICATIONS_SETTINGS(); | Show settings to manage installed applications. | Link |
| ACTION_MANAGE_DEFAULT_APPS_SETTINGS(); | Show Default apps settings. | Link |
| ACTION_MANAGE_OVERLAY_PERMISSION(packageName); | Show screen for controlling which apps can draw on top of other apps. | Link |
| ACTION_MANAGE_UNKNOWN_APP_SOURCES(packageName); | Show settings to allow configuration of trusted external sources. | Link |
| ACTION_MANAGE_WRITE_SETTINGS(packageName); | Show screen for controlling which apps are allowed to write/modify system settings. | Link |
| ACTION_MEMORY_CARD_SETTINGS(); | Show settings for memory card storage. | Link |
| ACTION_NETWORK_OPERATOR_SETTINGS(); | Show settings for selecting the network operator. | Link |
| ACTION_NFCSHARING_SETTINGS(); | Show NFC Sharing settings. This shows UI that allows NDEF Push (Android Beam) to be turned on or off. | Link |
| ACTION_NFC_PAYMENT_SETTINGS(); | Show NFC Tap & Pay settings. This shows UI that allows the user to configure Tap&Pay settings. | Link |
| ACTION_NFC_SETTINGS(); | Show NFC settings. This shows UI that allows NFC to be turned on or off. | Link |
| ACTION_NIGHT_DISPLAY_SETTINGS(); | Show settings to allow configuration of Night display. | Link |
| ACTION_NOTIFICATION_ASSISTANT_SETTINGS(); | Show Notification assistant settings. | Link |
| ACTION_NOTIFICATION_LISTENER_SETTINGS(); | Show Notification listener settings. | Link |
| ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS(); | Show Do Not Disturb access settings. | Link |
| ACTION_PRINT_SETTINGS(); | Show the top level print settings. | Link |
| ACTION_PRIVACY_SETTINGS(); | Show settings to allow configuration of privacy options. | Link |
| ACTION_QUICK_LAUNCH_SETTINGS(); | Show settings to allow configuration of quick launch shortcuts. | Link |
| ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS(packageName); | Ask the user to allow an app to ignore battery optimizations. | Link |
| ACTION_REQUEST_SET_AUTOFILL_SERVICE(packageName); | Show screen that let user select its Autofill Service. | Link |
| ACTION_SEARCH_SETTINGS(); | Show settings for global search. | Link |
| ACTION_SECURITY_SETTINGS(); | Show settings to allow configuration of security and location privacy. | Link |
| ACTION_SOUND_SETTINGS(); | Show settings to allow configuration of sound and volume. | Link |
| ACTION_SYNC_SETTINGS(); | Show settings to allow configuration of sync settings. | Link |
| ACTION_USAGE_ACCESS_SETTINGS(); | Show settings to control access to usage information. | Link |
| ACTION_USER_DICTIONARY_SETTINGS(); | Show settings to manage the user input dictionary. | Link |
| ACTION_VOICE_INPUT_SETTINGS(); | Show settings to configure input methods, in particular allowing the user to enable input methods. | Link |
| ACTION_VPN_SETTINGS(); | Show settings to allow configuration of VPN. | Link |
| ACTION_VR_LISTENER_SETTINGS(); | Show VR listener settings. | Link |
| ACTION_WEBVIEW_SETTINGS(); | Allows user to select current webview implementation. | Link |
| ACTION_WIFI_IP_SETTINGS(); | Show settings to allow configuration of a static IP address for Wi-Fi. | Link |
| ACTION_WIFI_SETTINGS(); | Show settings to allow configuration of Wi-Fi. | Link |
| ACTION_WIRELESS_SETTINGS(); | Show settings to allow configuration of wireless controls such as Wi-Fi, Bluetooth and Mobile networks. | Link |
| ACTION_ZEN_MODE_PRIORITY_SETTINGS(); | Show Zen Mode (aka Do Not Disturb) priority configuration settings. | Link |

$3

| Name | Type | Description |
| :---------- | :----------------- | :------------------------------------------- |
| packageName | String or null | ex. "com.my.app"
null is your app. |
| chanelID | String | Notification chanel ID.
ex. "123"` |