mirror of
https://github.com/status-im/react-native.git
synced 2025-01-10 09:35:48 +00:00
e1577df1fd
Summary: To make React Native play nicely with our internal build infrastructure we need to properly namespace all of our header includes. Where previously you could do `#import "RCTBridge.h"`, you must now write this as `#import <React/RCTBridge.h>`. If your xcode project still has a custom header include path, both variants will likely continue to work, but for new projects, we're defaulting the header include path to `$(BUILT_PRODUCTS_DIR)/usr/local/include`, where the React and CSSLayout targets will copy a subset of headers too. To make Xcode copy headers phase work properly, you may need to add React as an explicit dependency to your app's scheme and disable "parallelize build". Reviewed By: mmmulani Differential Revision: D4213120 fbshipit-source-id: 84a32a4b250c27699e6795f43584f13d594a9a82
143 lines
4.9 KiB
Objective-C
143 lines
4.9 KiB
Objective-C
/**
|
|
* Copyright (c) 2015-present, Facebook, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This source code is licensed under the BSD-style license found in the
|
|
* LICENSE file in the root directory of this source tree. An additional grant
|
|
* of patent rights can be found in the PATENTS file in the same directory.
|
|
*/
|
|
|
|
#import <JavaScriptCore/JavaScriptCore.h>
|
|
|
|
#import <React/RCTJavaScriptExecutor.h>
|
|
|
|
typedef void (^RCTJavaScriptValueCallback)(JSValue *result, NSError *error);
|
|
|
|
/**
|
|
* Default name for the JS thread
|
|
*/
|
|
RCT_EXTERN NSString *const RCTJSCThreadName;
|
|
|
|
/**
|
|
* This notification fires on the JS thread immediately after a `JSContext`
|
|
* is fully initialized, but before the JS bundle has been loaded. The object
|
|
* of this notification is the `JSContext`. Native modules should listen for
|
|
* notification only if they need to install custom functionality into the
|
|
* context. Note that this notification won't fire when debugging in Chrome.
|
|
*/
|
|
RCT_EXTERN NSString *const RCTJavaScriptContextCreatedNotification;
|
|
|
|
/**
|
|
* A key to a reference to a JSContext class, held in the the current thread's
|
|
* dictionary. The reference would point to the JSContext class in the JS VM
|
|
* used in React (or ComponenetScript). It is recommended not to access it
|
|
* through the thread's dictionary, but rather to use the `FBJSCurrentContext()`
|
|
* accessor, which will return the current JSContext in the currently used VM.
|
|
*/
|
|
RCT_EXTERN NSString *const RCTFBJSContextClassKey;
|
|
|
|
/**
|
|
* A key to a reference to a JSValue class, held in the the current thread's
|
|
* dictionary. The reference would point to the JSValue class in the JS VM
|
|
* used in React (or ComponenetScript). It is recommended not to access it
|
|
* through the thread's dictionary, but rather to use the `FBJSValue()` accessor.
|
|
*/
|
|
RCT_EXTERN NSString *const RCTFBJSValueClassKey;
|
|
|
|
/**
|
|
* @experimental
|
|
* May be used to pre-create the JSContext to make RCTJSCExecutor creation less costly.
|
|
* Avoid using this; it's experimental and is not likely to be supported long-term.
|
|
*/
|
|
@interface RCTJSContextProvider : NSObject
|
|
|
|
- (instancetype)initWithUseCustomJSCLibrary:(BOOL)useCustomJSCLibrary
|
|
tryBytecode:(BOOL)tryBytecode;
|
|
|
|
/**
|
|
* Marks whether the provider uses the custom implementation of JSC and not the system one.
|
|
*/
|
|
@property (nonatomic, readonly, assign) BOOL useCustomJSCLibrary;
|
|
|
|
/**
|
|
* Marks whether it is safe to try and run bytecode if given the choice.
|
|
*/
|
|
@property (nonatomic, readonly) BOOL tryBytecode;
|
|
|
|
@end
|
|
|
|
/**
|
|
* Uses a JavaScriptCore context as the execution engine.
|
|
*/
|
|
@interface RCTJSCExecutor : NSObject <RCTJavaScriptExecutor>
|
|
|
|
/**
|
|
* Returns whether executor uses custom JSC library.
|
|
* This value is used to initialize RCTJSCWrapper.
|
|
* @default is NO.
|
|
*/
|
|
@property (nonatomic, readonly, assign) BOOL useCustomJSCLibrary;
|
|
|
|
/**
|
|
* Returns the bytecode file format that the underlying runtime supports.
|
|
*/
|
|
@property (nonatomic, readonly) int32_t bytecodeFileFormatVersion;
|
|
|
|
/**
|
|
* Specify a name for the JSContext used, which will be visible in debugging tools
|
|
* @default is "RCTJSContext"
|
|
*/
|
|
@property (nonatomic, copy) NSString *contextName;
|
|
|
|
/**
|
|
* Inits a new executor instance with given flag that's used
|
|
* to initialize RCTJSCWrapper.
|
|
*/
|
|
- (instancetype)initWithUseCustomJSCLibrary:(BOOL)useCustomJSCLibrary;
|
|
|
|
/**
|
|
* @experimental
|
|
* Inits a new executor instance with given configuration flags. Please refer to
|
|
* the documentation for `RCTJSContextProvider` for more information as to their
|
|
* purpose.
|
|
*/
|
|
- (instancetype)initWithUseCustomJSCLibrary:(BOOL)useCustomJSCLibrary
|
|
tryBytecode:(BOOL)tryBytecode;
|
|
|
|
/**
|
|
* @experimental
|
|
* Pass a RCTJSContextProvider object to use an NSThread/JSContext pair that have already been created.
|
|
* The underlying JSContext will be returned in the JSContext pointer if it is non-NULL.
|
|
*/
|
|
+ (instancetype)initializedExecutorWithContextProvider:(RCTJSContextProvider *)JSContextProvider
|
|
JSContext:(JSContext **)JSContext;
|
|
|
|
/**
|
|
* @experimental
|
|
* synchronouslyExecuteApplicationScript:sourceURL:JSContext:error:
|
|
*
|
|
* Run the provided JS Script/Bundle, blocking the caller until it finishes.
|
|
* If there is an error during execution, it is returned, otherwise `NULL` is
|
|
* returned.
|
|
*/
|
|
- (NSError *)synchronouslyExecuteApplicationScript:(NSData *)script
|
|
sourceURL:(NSURL *)sourceURL;
|
|
|
|
/**
|
|
* Invokes the given module/method directly. The completion block will be called with the
|
|
* JSValue returned by the JS context.
|
|
*
|
|
* Currently this does not flush the JS-to-native message queue.
|
|
*/
|
|
- (void)callFunctionOnModule:(NSString *)module
|
|
method:(NSString *)method
|
|
arguments:(NSArray *)args
|
|
jsValueCallback:(RCTJavaScriptValueCallback)onComplete;
|
|
|
|
/**
|
|
* Get the JavaScriptCore context associated with this executor instance.
|
|
*/
|
|
- (JSContext *)jsContext;
|
|
|
|
@end
|