mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Kudo Chien
e2b5b6504c
Summary: nowadays, we could only specify metro server by either dev settings or building time ip.txt. this pr adds a new way to specify metro server programmatically which makes rn launcher or testing more feasible. ## Changelog [Internal] [iOS] [Added] - Propose to connect metro server programmatically Pull Request resolved: https://github.com/facebook/react-native/pull/31828 Test Plan: just exposing a public interface for RCTPackagerConnection without much code change. test to call this interface success locally. Reviewed By: sammy-SC Differential Revision: D30878774 Pulled By: yungsters fbshipit-source-id: 5f1d6a4835a983abde7e095d20153e4ba2146a61
79 lines
2.7 KiB
Objective-C
79 lines
2.7 KiB
Objective-C
/*
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#import <React/RCTDefines.h>
|
|
|
|
#if RCT_DEV
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@protocol RCTPackagerClientMethod;
|
|
@class RCTPackagerClientResponder;
|
|
|
|
typedef uint32_t RCTHandlerToken;
|
|
typedef void (^RCTNotificationHandler)(NSDictionary<NSString *, id> *);
|
|
typedef void (^RCTRequestHandler)(NSDictionary<NSString *, id> *, RCTPackagerClientResponder *);
|
|
typedef void (^RCTConnectedHandler)(void);
|
|
|
|
/** Encapsulates singleton connection to React Native packager. */
|
|
@interface RCTPackagerConnection : NSObject
|
|
|
|
+ (instancetype)sharedPackagerConnection;
|
|
|
|
/**
|
|
* Registers a handler for a notification broadcast from the packager. An
|
|
* example is "reload" - an instruction to reload from the packager.
|
|
* If multiple notification handlers are registered for the same method, they
|
|
* will all be invoked sequentially.
|
|
*/
|
|
- (RCTHandlerToken)addNotificationHandler:(RCTNotificationHandler)handler
|
|
queue:(dispatch_queue_t)queue
|
|
forMethod:(NSString *)method;
|
|
|
|
/**
|
|
* Registers a handler for a request from the packager. An example is
|
|
* pokeSamplingProfiler; it asks for profile data from the client.
|
|
* Only one handler can be registered for a given method; calling this
|
|
* displaces any previous request handler registered for that method.
|
|
*/
|
|
- (RCTHandlerToken)addRequestHandler:(RCTRequestHandler)handler
|
|
queue:(dispatch_queue_t)queue
|
|
forMethod:(NSString *)method;
|
|
|
|
/**
|
|
* Registers a handler that runs at most once, when the connection to the
|
|
* packager has been established. The handler will be dispatched immediately
|
|
* if the connection is already established.
|
|
*/
|
|
- (RCTHandlerToken)addConnectedHandler:(RCTConnectedHandler)handler queue:(dispatch_queue_t)queue;
|
|
|
|
/** Removes a handler. Silently does nothing if the token is not valid. */
|
|
- (void)removeHandler:(RCTHandlerToken)token;
|
|
|
|
/** Disconnects and removes all handlers. */
|
|
- (void)stop;
|
|
|
|
/** Reconnect with given packager server. */
|
|
- (void)reconnect:(NSString *)packagerServerHostPort;
|
|
|
|
/**
|
|
* Historically no distinction was made between notification and request
|
|
* handlers. If you use this method, it will be registered as *both* a
|
|
* notification handler *and* a request handler. You should migrate to the
|
|
* new block-based API instead.
|
|
*/
|
|
- (void)addHandler:(id<RCTPackagerClientMethod>)handler
|
|
forMethod:(NSString *)method __deprecated_msg("Use addRequestHandler or addNotificationHandler instead");
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|
|
|
|
#endif
|