react-native-restart

What is react-native-restart?

The react-native-restart package allows you to programmatically restart your React Native application. This can be useful in scenarios where you need to apply updates or reset the app's state.

What are react-native-restart's main functionalities?

Restart the Application

This feature allows you to restart the entire application programmatically. This can be useful after applying updates or when you need to reset the app's state.

import RNRestart from 'react-native-restart';

// Restart the app
RNRestart.Restart();

Other packages similar to react-native-restart

react-native-restart-android

The react-native-restart-android package provides similar functionality but is specifically designed for Android. It allows you to restart the Android application programmatically. Compared to react-native-restart, it is platform-specific and does not support iOS.

react-native-exit-app

The react-native-exit-app package allows you to programmatically exit the application. While it does not provide a restart feature, it can be used in conjunction with other packages to achieve a similar effect. It is more focused on exiting the app rather than restarting it.

README

React Native Restart

Sometimes you want to reload your app bundle during app runtime. This package will allow you to do it.

iOS GIF	Android GIF

Installation

• Using react-native < 0.62? install react-native-restart@0.0.17
• Using 0.71 > react-native >= 0.62? install react-native-restart@0.0.24
• Using react-native >= 0.71? install react-native-restart@0.0.27 and above

With yarn

$ yarn add react-native-restart

With npm

$ npm install --save react-native-restart

Auto-Linking Setup (react-native >= 0.60)

iOS

$ cd ios
$ pod install

Android

No further steps should be taken

Automatic Installation (Without Auto-Linking)

react-native link react-native-restart or npm install -g rnpm && rnpm link react-native-restart

Manual Android Installation

In android/settings.gradle

...

include ':react-native-restart'
project(':react-native-restart').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-restart/android')

In android/app/build.gradle

...

dependencies {
    ...

    implementation project(':react-native-restart')
}

Register module (in MainApplication.java)

import com.reactnativerestart.RestartPackage;  // <--- Import

public class MainApplication extends Application implements ReactApplication {

	private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
  		......

	      /**
	     * A list of packages used by the app. If the app uses additional views
	     * or modules besides the default ones, add more packages here.
	     */
	    @Override
	    protected List<ReactPackage> getPackages() {
	        ...
	        return Arrays.<ReactPackage>asList(
	                new MainReactPackage(),
	                new RestartPackage() // Add this line
	        );
	    }
	};
	......
};

Manual iOS Installation

Importing The Library

• Drag the file Restart.xcodeproj from /node_modules/react-native-restart/ios into the Libraries group in the Project navigator. Ensure that Copy items if needed is UNCHECKED!

• Ensure that libRestart.a is linked through Link Binary With Libraries on Build Phases:

• Ensure that Header Search Paths on Build Settings has the path $(SRCROOT)/../node_modules/react-native-restart set to recursive:

• You're All Set!

CocoaPod iOS Installation

In your ios/Podfile make sure to use react-native-restart from the local node_modules/. With that, only your project Pod needs to be linked and no extra configuration is required:

target 'MyReactApp' do
  # Make sure you're also using React-Native from ../node_modules
  pod 'React', :path => '../node_modules/react-native', :subspecs => [
    'Core',
    'RCTActionSheet',
	# ... whatever else you use
  ]
  # React-Native dependencies such as yoga:
  pod 'yoga', path: '../node_modules/react-native/ReactCommon/yoga'

  # The following line uses react-native-restart, linking with
  # the library and setting the Header Search Paths for you
  pod 'react-native-restart', :path => '../node_modules/react-native-restart'
end

Remember to run cd ios && pod install to update files used by Xcode.

Usage

import RNRestart from 'react-native-restart'; // Import package from node modules

// Immediately reload the React Native Bundle
RNRestart.Restart(); // Deprecated
RNRestart.restart();

Contributing

Contributions are welcome. Please see CONTRIBUTING.md if you like to contribute to this library.

Credits

Thanks to Microsoft CodePush library. I simply extracted the code from their library's logic to reload the React Native Bundle.