-
Notifications
You must be signed in to change notification settings - Fork 24.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(iOS): introduce RCTUIConfiguratorProtocol (#47139)
Summary: This PR introduces `RCTUIConfiguratorProtocol` for better separation of concerns inside of RCTAppDelegate. It's also a prerequisite for #46298 Discussed with cipolleschi ## Changelog: [IOS] [ADDED] - introduce RCTUIConfiguratorProtocol Pull Request resolved: #47139 Test Plan: - CI Green - Test if methods can be overriden Reviewed By: blakef Differential Revision: D65063839 Pulled By: cipolleschi fbshipit-source-id: b63766e245d57f369ab94bd8047d5de9a3447b3e
- Loading branch information
1 parent
e797135
commit 8850736
Showing
2 changed files
with
59 additions
and
43 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
56 changes: 56 additions & 0 deletions
56
packages/react-native/Libraries/AppDelegate/RCTUIConfiguratorProtocol.h
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,56 @@ | ||
/* | ||
* Copyright (c) Meta Platforms, Inc. and affiliates. | ||
* | ||
* This source code is licensed under the MIT license found in the | ||
* LICENSE file in the root directory of this source tree. | ||
*/ | ||
|
||
#import <React/RCTConvert.h> | ||
#import <UIKit/UIKit.h> | ||
|
||
@class RCTRootView; | ||
|
||
@protocol RCTUIConfiguratorProtocol | ||
/** | ||
* The default `RCTColorSpace` for the app. It defaults to `RCTColorSpaceSRGB`. | ||
*/ | ||
- (RCTColorSpace)defaultColorSpace; | ||
|
||
/** | ||
* This method can be used to customize the rootView that is passed to React Native. | ||
* A typical example is to override this method in the AppDelegate to change the background color. | ||
* To achieve this, add in your `AppDelegate.mm`: | ||
* ``` | ||
* - (void)customizeRootView:(RCTRootView *)rootView | ||
* { | ||
* rootView.backgroundColor = [UIColor colorWithDynamicProvider:^UIColor *(UITraitCollection *traitCollection) { | ||
* if ([traitCollection userInterfaceStyle] == UIUserInterfaceStyleDark) { | ||
* return [UIColor blackColor]; | ||
* } else { | ||
* return [UIColor whiteColor]; | ||
* } | ||
* }]; | ||
* } | ||
* ``` | ||
* | ||
* @parameter: rootView - The root view to customize. | ||
*/ | ||
- (void)customizeRootView:(RCTRootView *)rootView; | ||
|
||
/** | ||
* It creates the RootViewController. | ||
* By default, it creates a new instance of a `UIViewController`. | ||
* You can override it to provide your own initial ViewController. | ||
* | ||
* @return: an instance of `UIViewController`. | ||
*/ | ||
- (UIViewController *)createRootViewController; | ||
|
||
/** | ||
* It assigns the rootView to the rootViewController | ||
* By default, it assigns the rootView to the view property of the rootViewController | ||
* If you are not using a simple UIViewController, then there could be other methods to use to setup the rootView. | ||
* For example: UISplitViewController requires `setViewController(_:for:)` | ||
*/ | ||
- (void)setRootView:(UIView *)rootView toRootViewController:(UIViewController *)rootViewController; | ||
@end |