mirror of
https://github.com/status-im/react-native.git
synced 2025-01-10 01:25:39 +00:00
6a14f0b449
Summary: This decouples non-UI logic from RCTDevMenu into a new module RCTDevSettings. **Motivation**: This allows developers to change dev settings without depending on the built-in dev menu, e.g. if they want to introduce their own UI, or have other devtools logic that doesn't depend on an action sheet. It also introduces the RCTDevSettingsDataSource protocol for storing dev tools preferences. This could allow a developer to implement alternative behaviors, e.g. loading the settings from some other config, changing settings based on the user, deciding not to persist some settings, or something else. The included data source implementation, RCTDevSettingsUserDefaultsDataSource, uses NSUserDefaults and is backwards compatible with the older implementation, so **no workflows or dependent code will break, and old saved settings will persist.** The RCTDevMenu interface has not changed and is therefore also backwards-compatible, though some methods are now deprecated. In order to ensure that RCTDevSettings Closes https://github.com/facebook/react-native/pull/11613 Reviewed By: mmmulani Differential Revision: D4571773 Pulled By: javache fbshipit-source-id: 25555d0a6eaa81f694343e079ed02439e5845fbc
109 lines
2.7 KiB
Objective-C
109 lines
2.7 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 <UIKit/UIKit.h>
|
|
|
|
#import <React/RCTBridge.h>
|
|
#import <React/RCTBridgeModule.h>
|
|
|
|
@class RCTDevMenuItem;
|
|
|
|
/**
|
|
* Developer menu, useful for exposing extra functionality when debugging.
|
|
*/
|
|
@interface RCTDevMenu : NSObject
|
|
|
|
/**
|
|
* Deprecated, use RCTDevSettings instead.
|
|
*/
|
|
@property (nonatomic, assign) BOOL shakeToShow DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Deprecated, use RCTDevSettings instead.
|
|
*/
|
|
@property (nonatomic, assign) BOOL profilingEnabled DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Deprecated, use RCTDevSettings instead.
|
|
*/
|
|
@property (nonatomic, assign) BOOL liveReloadEnabled DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Deprecated, use RCTDevSettings instead.
|
|
*/
|
|
@property (nonatomic, assign) BOOL hotLoadingEnabled DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Presented items in development menu
|
|
*/
|
|
@property (nonatomic, copy, readonly) NSArray<RCTDevMenuItem *> *presentedItems;
|
|
|
|
/**
|
|
* Detect if actions sheet (development menu) is shown
|
|
*/
|
|
- (BOOL)isActionSheetShown;
|
|
|
|
/**
|
|
* Manually show the dev menu (can be called from JS).
|
|
*/
|
|
- (void)show;
|
|
|
|
/**
|
|
* Deprecated, use -[RCTBRidge reload] instead.
|
|
*/
|
|
- (void)reload DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Deprecated. Use the `-addItem:` method instead.
|
|
*/
|
|
- (void)addItem:(NSString *)title
|
|
handler:(void(^)(void))handler DEPRECATED_ATTRIBUTE;
|
|
|
|
/**
|
|
* Add custom item to the development menu. The handler will be called
|
|
* when user selects the item.
|
|
*/
|
|
- (void)addItem:(RCTDevMenuItem *)item;
|
|
|
|
@end
|
|
|
|
typedef NSString *(^RCTDevMenuItemTitleBlock)(void);
|
|
|
|
/**
|
|
* Developer menu item, used to expose additional functionality via the menu.
|
|
*/
|
|
@interface RCTDevMenuItem : NSObject
|
|
|
|
/**
|
|
* This creates an item with a simple push-button interface, used to trigger an
|
|
* action.
|
|
*/
|
|
+ (instancetype)buttonItemWithTitle:(NSString *)title
|
|
handler:(dispatch_block_t)handler;
|
|
|
|
/**
|
|
* This creates an item with a simple push-button interface, used to trigger an
|
|
* action. getTitleForPresentation is called each time the item is about to be
|
|
* presented, and should return the item's title.
|
|
*/
|
|
+ (instancetype)buttonItemWithTitleBlock:(RCTDevMenuItemTitleBlock)titleBlock
|
|
handler:(dispatch_block_t)handler;
|
|
|
|
@end
|
|
|
|
/**
|
|
* This category makes the developer menu instance available via the
|
|
* RCTBridge, which is useful for any class that needs to access the menu.
|
|
*/
|
|
@interface RCTBridge (RCTDevMenu)
|
|
|
|
@property (nonatomic, readonly) RCTDevMenu *devMenu;
|
|
|
|
@end
|