ReactInstanceSettings
Kind: class
Provides settings to create a React instance.
Properties
BundleAppId
string BundleAppId
The name of the app passed to the packager server via the 'app' query parameter. This is useful when bundling multiple applications from the same packager instance. If no value is set, the parameter will not be passed.
BundleRootPath
string BundleRootPath
Default value: ms-appx:///Bundle/
Base path used for the location of the bundle.
This can be an ms-appx:// or ms-appdata:// URI (if the app is UWP or packaged using MSIX), a filesystem path, or a URI pointing at an embedded resource.
Examples:
ms-appx:///Bundle- locates the bundle in the MSIX package. See URI schemes for other UWP/MSIX valid URI formats.C:\\foo\\bar- locates the bundle in the local filesystem. Note UWP app file access permissions.resource://moduleName- locates the bundle as an embedded RCDATA resource in moduleName. Specify the resource ID inJavaScriptBundleFile.resource://- locates the bundle as an embedded RCDATA resource in the running process's module. Specify the resource ID inJavaScriptBundleFile.
ByteCodeFileUri
string ByteCodeFileUri
Set this to a location the application has write access to in order for bytecode to be successfully cached. See EnableByteCodeCaching.
Note that currently the byte code generation is not implemented for UWP applications.
DebugBundlePath
string DebugBundlePath
When loading from a bundle server (such as metro), this is the path that will be requested from the server. If this is not provided, the value of JavaScriptBundleFile is used.
DebuggerBreakOnNextLine
bool DebuggerBreakOnNextLine
For direct debugging, controls whether to break on the next line of JavaScript that is executed.
This can help debug issues hit early in the JavaScript bundle load.
Note: this is not supported with the Chakra JS engine which is the currently used JavaScript engine. As a workaround you could add the debugger keyword in the beginning of the bundle.
DebuggerPort
uint16_t DebuggerPort
Default value: 9229
When UseDirectDebugger is enabled, this controls the port that the JavaScript engine debugger will run on.
DebuggerRuntimeName
string DebuggerRuntimeName
Name to associate with the JavaScript runtime when debugging. This name will show up in the list of JavaScript runtimes to attach to in edge://inspect or other debuggers
EnableByteCodeCaching
bool EnableByteCodeCaching
Default value: false
For JS engines that support bytecode generation, this controls if bytecode should be generated when a JavaScript bundle is first loaded.
Subsequent runs of the application should be faster as the JavaScript will be loaded from bytecode instead of the raw JavaScript.
ByteCodeFileUri must be set to a location the application has write access to in order for the bytecode to be successfully cached.
Note that currently the byte code generation is not implemented for UWP applications.
EnableDefaultCrashHandler
bool EnableDefaultCrashHandler
Default value: false
Enables the default unhandled exception handler that logs additional information into a text file for Windows Error Reporting.
EnableDeveloperMenu
bool EnableDeveloperMenu
Deprecated: This property has been replaced by
UseDeveloperSupport. In version 0.63 both properties will do the same thing. It will be removed in a future version.
This controls whether various developer experience features are available for this instance. In particular the developer menu, and the default RedBox experience.
EnableJITCompilation
bool EnableJITCompilation
Default value: true
Flag controlling whether the JavaScript engine uses JIT compilation.
JSIEngineOverride
JSIEngine JSIEngineOverride
Default value: JSIEngine.Chakra
The JSIEngine override to be used with the React instance.
In order for the override to work, Microsoft.ReactNative must be compiled with support of that engine. This override will be ignored when UseWebDebugger is set to true, since the browser must use its own engine to debug correctly.
JavaScriptBundleFile
string JavaScriptBundleFile
Default value: index.windows
The name of the JavaScript bundle file to load. This should be a relative path from BundleRootPath. The .bundle extension will be appended to the end, when looking for the bundle file.
If using an embedded RCDATA resource, this identifies the resource ID that stores the bundle. See BundleRootPath.
NativeLogger
LogHandler NativeLogger
Function that will be hooked into the JavaScript instance as global.nativeLoggingHook. This allows native hooks for JavaScript's console implementation. If this is not set then logs will print output to the native debug output in debug builds, and no-op in release builds.
Notifications
readonly IReactNotificationService Notifications
Gets a IReactNotificationService to send notifications between components and the application.
Use IReactContext.Notifications to access this IReactNotificationService from native components or view managers.
PackageProviders
readonly IVector<IReactPackageProvider> PackageProviders
Gets a list of IReactPackageProvider.
Add an implementation of IReactPackageProvider to this list to define additional native modules and custom view managers to be included in the React instance.
Auto-linking automatically adds IReactPackageProvider to the application's PackageProviders.
Properties
readonly IReactPropertyBag Properties
Gets a IReactPropertyBag to share values between components and the application.
Use IReactContext.Properties to access this IReactPropertyBag from native components and view managers.
RedBoxHandler
IRedBoxHandler RedBoxHandler
Provides an extension point to allow custom error handling within the react instance. See IRedBoxHandler for more information.
RequestDevBundle
bool RequestDevBundle
When querying the bundle server for a bundle, should it request the dev bundle or release bundle.
RequestInlineSourceMap
bool RequestInlineSourceMap
Default value: true
When using UseFastRefresh, UseLiveReload, or UseWebDebugger this controls whether the bundler should include inline source maps.If set, the bundler will include the source maps inline (this will improve debugging experience, but for very large bundles it could have a significant performance hit)
SourceBundleHost
string SourceBundleHost
Default value: localhost
When using UseFastRefresh, UseLiveReload, or UseWebDebugger this is the server hostname that will be used to load the bundle from.
SourceBundlePort
uint16_t SourceBundlePort
Default value: 8081
When using UseFastRefresh, UseLiveReload, or UseWebDebugger this is the server port that will be used to load the bundle from.
UIDispatcher
IReactDispatcher UIDispatcher
Control the main UI dispatcher to be used by the React instance. If the ReactInstanceSettings object is initially created on a UI thread, then this will default to that thread. The value provided here will be available to native modules and view managers using IReactContext.UIDispatcher
UseDeveloperSupport
bool UseDeveloperSupport
This controls whether various developer experience features are available for this instance. In particular, it enables the developer menu, the default RedBox and LogBox experience.
UseDirectDebugger
bool UseDirectDebugger
Enables debugging in the JavaScript engine (if supported). For Chakra this enables debugging of the JS runtime directly within the app using Visual Studio -> Attach to process (Script)
UseFastRefresh
bool UseFastRefresh
Controls whether the instance triggers the hot module reload logic when it first loads the instance. Most edits should be visible within a second or two without the instance having to reload. Non-compatible changes still cause full reloads. See Fast Refresh for more information on Fast Refresh.
UseLiveReload
bool UseLiveReload
Deprecated: For general use this has been replaced by
UseFastRefresh.
Enables live reload to load the source bundle from the React Native packager. When the file is saved, the packager will trigger reloading.
UseWebDebugger
bool UseWebDebugger
Controls whether the instance JavaScript runs in a remote environment such as within a browser. By default, this is using a browser navigated to http://localhost:8081/debugger-ui served by Metro/Haul. Debugging will start as soon as the react native instance is loaded.
Constructors
ReactInstanceSettings
ReactInstanceSettings()
Events
InstanceCreated
Type: InstanceCreatedEventArgs
InstanceDestroyed
Type: InstanceDestroyedEventArgs
InstanceLoaded
Type: InstanceLoadedEventArgs