@rnx-kit/react-native-host 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @rnx-kit/react-native-host
+
+[![Build](https://github.com/microsoft/rnx-kit/actions/workflows/build.yml/badge.svg)](https://github.com/microsoft/rnx-kit/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/@rnx-kit/react-native-host)](https://www.npmjs.com/package/@rnx-kit/react-native-host)
+
+`@rnx-kit/react-native-host` simplifies React Native initialization.
+
+The aim of this package is to provide a backwards (and forwards) compatible way
+of initializing React Native, regardless of whether you're on New Architecture
+or have gone fully bridgeless.`@rnx-kit/react-native-host` will also a provide a
+simple way to enable split bundles and service delivery.
+
+## Installation
+
+```sh
+yarn add @rnx-kit/react-native-host --dev
+```
+
+or if you're using npm
+
+```sh
+npm add --save-dev @rnx-kit/react-native-host
+```
+
+## Usage
+
+### iOS/macOS
+
+[Autolinking](https://github.com/react-native-community/cli/blob/10.x/docs/autolinking.md)
+should make this module available to your app project.
+
+- Replace instances of `RCTBridgeDelegate` with `RNXHostConfig`. The latter is a
+  superset and is backwards compatible.
+- Replace instantiation of `RCTBridge` with `ReactNativeHost`. `ReactNativeHost`
+  will instantiate the appropriate modules required for your setup. It will also
+  handle New Architecture configuration as necessary.
+- Instead of instantiating `RCTRootView` directly, use
+  `-[ReactNativeHost viewWithModuleName:initialProperties:]` to create your root
+  views.
+
+For example, if you previously had something like this:
+
+```objc
+// AppDelegate.h
+@import React;
+@import UIKit;
+
+@interface AppDelegate : UIResponder <UIApplicationDelegate, RCTBridgeDelegate>
+@end
+
+// AppDelegate.m
+@implementation AppDelegate
+
+- (BOOL)application:(UIApplication *)application
+    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+    ...
+
+    RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self
+                                              launchOptions:launchOptions];
+    RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
+                                                     moduleName:moduleName
+                                              initialProperties:initialProperties];
+
+    ...
+}
+
+@end
+```
+
+You should instead have:
+
+```objc
+// AppDelegate.m
+@import ReactNativeHost;
+@import UIKit;
+
+@interface AppDelegate : UIResponder <UIApplicationDelegate, RNXHostConfig>
+@end
+
+// AppDelegate.m
+@implementation AppDelegate
+
+- (BOOL)application:(UIApplication *)application
+    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+    ...
+
+    ReactNativeHost *host = [[ReactNativeHost alloc] initWithConfig:self];
+    UIView *rootView = [host viewWithModuleName:moduleName
+                              initialProperties:initialProperties];
+
+    ...
+}
+
+@end
+```

package/ReactNativeHost.podspec

@@ -0,0 +1,30 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+version = package['version']
+repository = package['repository']
+
+Pod::Spec.new do |s|
+  s.name      = 'ReactNativeHost'
+  s.version   = version
+  s.author    = { package['author']['name'] => package['author']['email'] }
+  s.license   = package['license']
+  s.homepage  = package['homepage']
+  s.source    = { :git => repository['url'], :tag => "#{package['name']}@#{version}" }
+  s.summary   = package['description']
+
+  s.ios.deployment_target = '13.0'
+  s.osx.deployment_target = '10.15'
+
+  s.dependency 'React-Core'
+
+  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }
+
+  # Include both package and repository relative paths to allow the podspec to
+  # be consumed from both a local path, and as a podspec outside a spec
+  # repository.
+  s.source_files         = 'cocoa/*.{h,m,mm}',                            # :path
+                           "#{repository['directory']}/cocoa/*.{h,m,mm}"  # :podspec
+  s.public_header_files  = 'cocoa/*.h',                                   # :path
+                           "#{repository['directory']}/cocoa/*.h"         # :podspec
+end

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@rnx-kit/react-native-host",
+  "version": "0.1.0",
+  "description": "Simplify React Native initialization",
+  "homepage": "https://github.com/microsoft/rnx-kit/tree/main/packages/react-native-host#readme",
+  "license": "MIT",
+  "author": {
+    "name": "Microsoft Open Source",
+    "email": "microsoftopensource@users.noreply.github.com"
+  },
+  "files": [
+    "ReactNativeHost.podspec",
+    "android/",
+    "mac/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rnx-kit",
+    "directory": "packages/react-native-host"
+  },
+  "engines": {
+    "node": ">=14.15"
+  },
+  "scripts": {
+    "format:c": "clang-format -i $(git ls-files '*.c' '*.cpp' '*.h' '*.m' '*.mm')",
+    "lint:kt": "ktlint --relative --verbose 'android/src/**/*.kt'"
+  },
+  "peerDependencies": {
+    "react": "17.0.1 || 17.0.2 || 18.0.0 || 18.1.0 || 18.2.0",
+    "react-native": "^0.64.2 || ^0.65.0 || ^0.66.0 || ^0.67.0 || ^0.68.0 || ^0.69.0 || ^0.70.0 || ^0.71.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.12.9",
+    "@babel/preset-env": "^7.1.6",
+    "react": "17.0.2",
+    "react-native": "^0.68.0"
+  },
+  "eslintConfig": {
+    "extends": "@rnx-kit/eslint-config"
+  },
+  "rnx-kit": {
+    "alignDeps": {
+      "requirements": {
+        "development": [
+          "react-native@0.68"
+        ],
+        "production": [
+          "react-native@>=0.64 <1.0"
+        ]
+      },
+      "capabilities": [
+        "core-android",
+        "core-ios"
+      ]
+    }
+  }
+}