@callstack/react-native-brownfield 2.2.0 → 3.0.0-rc.1

package/src/expo-config-plugin/template/ios/ReactNativeHostManager.swift

@@ -0,0 +1,63 @@
+internal import Expo
+internal import React
+internal import ReactAppDependencyProvider
+internal import React_RCTAppDelegate
+import UIKit
+
+public class ReactNativeHostManager {
+  public static let shared = ReactNativeHostManager()
+  
+  private var reactNativeDelegate: ExpoReactNativeFactoryDelegate?
+  private var reactNativeFactory: RCTReactNativeFactory?
+  private var expoDelegate: ExpoAppDelegate?
+  
+  public func initialize() {
+    let delegate = ReactNativeDelegate()
+    let factory = ExpoReactNativeFactory(delegate: delegate)
+    delegate.dependencyProvider = RCTAppDependencyProvider()
+    
+    reactNativeDelegate = delegate
+    reactNativeFactory = factory
+    
+    expoDelegate = ExpoAppDelegate()
+    expoDelegate?.bindReactNativeFactory(factory)
+    
+    // required to avoid this being file be stripped by the swift compiler
+    let _ = ExpoModulesProvider()
+  }
+  
+  // propagate delegate methods to ExpoAppDelegate
+  public func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+  ) -> Bool {
+    ((expoDelegate?.application(application, didFinishLaunchingWithOptions: launchOptions)) != nil)
+  }
+  
+  // load & present RN UI
+  public func loadView(
+    moduleName: String, initialProps: [AnyHashable: Any]?,
+    launchOptions: [AnyHashable: Any]?
+  ) -> UIView {
+    let bundleURL = reactNativeDelegate?.bundleURL()
+    return (expoDelegate?.recreateRootView(
+      withBundleURL: bundleURL, moduleName: moduleName, initialProps: initialProps,
+      launchOptions: launchOptions))!
+  }
+}
+
+class ReactNativeDelegate: ExpoReactNativeFactoryDelegate {
+  override func sourceURL(for bridge: RCTBridge) -> URL? {
+    // needed to return the correct URL for expo-dev-client.
+    bridge.bundleURL ?? bundleURL()
+  }
+  
+  override func bundleURL() -> URL? {
+#if DEBUG
+    return RCTBundleURLProvider.sharedSettings().jsBundleURL(
+      forBundleRoot: ".expo/.virtual-metro-entry")
+#else
+    return ReactNativeBundle.url(forResource: "main", withExtension: "jsbundle")
+#endif
+  }
+}

package/src/expo-config-plugin/template/ios/patchExpoPre55.sh

@@ -0,0 +1,20 @@
+# Patch by @hurali97, source: https://github.com/callstackincubator/rock/issues/492#issuecomment-3225109837
+# Applicable only to Expo SDK versions prior to 55, which made ExpoModulesProvider internal by default: https://github.com/expo/expo/pull/42317
+# Path to ExpoModulesProvider.swift
+FILE="${SRCROOT}/Pods/Target Support Files/Pods-ExpoApp-{{FRAMEWORK_NAME}}/ExpoModulesProvider.swift"
+
+if [ -f "$FILE" ]; then
+  echo "Patching $FILE to hide Expo from public interface"
+
+  # 1. Replace imports with internal imports
+  sed -i '' 's/^import EX/internal import EX/' "$FILE"
+  
+  sed -i '' 's/^import Ex/internal import Ex/' "$FILE"
+
+  # 2. Replace class visibility
+  sed -i '' 's/public class ExpoModulesProvider/internal class ExpoModulesProvider/' "$FILE"
+
+  echo "Patched $FILE to hide Expo from public interface"
+  echo "Contents of $FILE:"
+  cat "$FILE"
+fi

package/src/expo-config-plugin/types/BrownfieldPluginConfig.ts

@@ -0,0 +1,67 @@
+import type {
+  BrownfieldPluginAndroidConfig,
+  ResolvedBrownfieldPluginAndroidConfig,
+} from './android/BrownfieldPluginAndroidConfig';
+import type {
+  BrownfieldPluginIosConfig,
+  ResolvedBrownfieldPluginIosConfig,
+} from './ios/BrownfieldPluginIosConfig';
+
+/**
+ * Main configuration for the Brownfield Expo config plugin
+ */
+export interface BrownfieldPluginConfig {
+  /**
+   * iOS-specific configuration
+   */
+  ios?: BrownfieldPluginIosConfig;
+
+  /**
+   * Android-specific configuration
+   */
+  android?: BrownfieldPluginAndroidConfig;
+
+  /**
+   * Whether to enable debug logging during plugin execution
+   * @default false
+   */
+  debug?: boolean;
+}
+
+/**
+ * Internal configuration with resolved defaults
+ * Note that the platform-specific configs can be null if the platform is not configured
+ */
+export interface ResolvedBrownfieldPluginConfig extends Required<
+  Omit<BrownfieldPluginConfig, 'ios' | 'android'>
+> {
+  /**
+   * iOS-specific configuration
+   */
+  ios: ResolvedBrownfieldPluginIosConfig | null;
+
+  /**
+   * Android-specific configuration
+   */
+  android: ResolvedBrownfieldPluginAndroidConfig | null;
+}
+
+/**
+ * Resolved Brownfield configuration including Android config
+ */
+export interface ResolvedBrownfieldPluginConfigWithAndroid extends ResolvedBrownfieldPluginConfig {
+  /**
+   * Android-specific configuration
+   */
+  android: ResolvedBrownfieldPluginAndroidConfig;
+}
+
+/**
+ * Resolved Brownfield configuration including iOS config
+ */
+export interface ResolvedBrownfieldPluginConfigWithIos extends ResolvedBrownfieldPluginConfig {
+  /**
+   * iOS-specific configuration
+   */
+  ios: ResolvedBrownfieldPluginIosConfig;
+}

package/src/expo-config-plugin/types/RenderedTemplateFile.ts

@@ -0,0 +1,4 @@
+export interface RenderedTemplateFile {
+  relativePath: string;
+  content: string;
+}

package/src/expo-config-plugin/types/android/BrownfieldPluginAndroidConfig.ts

@@ -0,0 +1,58 @@
+/**
+ * Android-specific configuration for Brownfield config plugin
+ */
+export interface BrownfieldPluginAndroidConfig {
+  /**
+   * The name of the Android library module to create
+   * @default "brownfieldlib"
+   */
+  moduleName?: string;
+
+  /**
+   * The package name for the Android library module
+   * @default app's package name
+   */
+  packageName?: string;
+
+  /**
+   * Minimum SDK version for the Android library
+   * @default 24
+   */
+  minSdkVersion?: number;
+
+  /**
+   * Target SDK version for the Android library
+   * @default 35
+   */
+  targetSdkVersion?: number;
+
+  /**
+   * Compile SDK version for the Android library
+   * @default 35
+   */
+  compileSdkVersion?: number;
+
+  /**
+   * Group ID for Maven publishing
+   * @default package name
+   */
+  groupId?: string;
+
+  /**
+   * Artifact ID for Maven publishing
+   * @default module name
+   */
+  artifactId?: string;
+
+  /**
+   * Version string for Maven publishing
+   * @default "0.0.1-SNAPSHOT"
+   */
+  version?: string;
+}
+
+/**
+ * Android configuration with resolved defaults (all fields required)
+ */
+export type ResolvedBrownfieldPluginAndroidConfig =
+  Required<BrownfieldPluginAndroidConfig>;

package/src/expo-config-plugin/types/index.ts

@@ -0,0 +1,6 @@
+export type * from './android/BrownfieldPluginAndroidConfig';
+export type * from './ios/BrownfieldPluginIosConfig';
+
+export type * from './BrownfieldPluginConfig';
+
+export type * from './RenderedTemplateFile';

package/src/expo-config-plugin/types/ios/BrownfieldPluginIosConfig.ts

@@ -0,0 +1,41 @@
+/**
+ * iOS-specific configuration for Brownfield config plugin
+ */
+export interface BrownfieldPluginIosConfig {
+  /**
+   * The name of the framework to create
+   * This will be used as the XCFramework name
+   * @default "BrownfieldLib"
+   */
+  frameworkName?: string;
+
+  /**
+   * The bundle identifier for the framework
+   * @default app's bundle identifier with ".brownfield" suffix
+   */
+  bundleIdentifier?: string;
+
+  /**
+   * Custom build settings to apply to the framework build
+   */
+  buildSettings?: Record<string, string | boolean | number>;
+
+  /**
+   * Minimum iOS deployment target
+   * @default "15.0"
+   */
+  deploymentTarget?: string;
+
+  /**
+   * The version of the framework, must be an integer or floating point (e.g. 1, or 2.1)
+   * @default 1
+   * @see https://developer.apple.com/documentation/xcode/build-settings-reference#Current-Project-Version
+   */
+  frameworkVersion?: string;
+}
+
+/**
+ * iOS configuration with resolved defaults (all fields required)
+ */
+export type ResolvedBrownfieldPluginIosConfig =
+  Required<BrownfieldPluginIosConfig>;

package/src/expo-config-plugin/withBrownfield.ts

@@ -0,0 +1,112 @@
+import {
+  createRunOncePlugin,
+  withPlugins,
+  type ConfigPlugin,
+  type StaticPlugin,
+} from '@expo/config-plugins';
+import type { ExpoConfig } from '@expo/config-types';
+
+import { withBrownfieldIos } from './ios/withBrownfieldIos';
+import { withBrownfieldAndroid } from './android/withBrownfieldAndroid';
+import type {
+  BrownfieldPluginConfig,
+  ResolvedBrownfieldPluginConfig,
+} from './types';
+
+import { Logger } from './logging';
+
+/**
+ * Resolves the plugin configuration using provided config and config defaults.
+ * @param config The user-provided Brownfield configuration.
+ * @param expoConfig The Expo configuration object.
+ * @returns The resolved Brownfield configuration.
+ */
+function resolveConfig(
+  config: BrownfieldPluginConfig = {},
+  expoConfig: ExpoConfig
+): ResolvedBrownfieldPluginConfig {
+  Logger.setIsDebug(config.debug ?? false);
+
+  const androidPackage = expoConfig.android?.package;
+  const androidModuleName = config.android?.moduleName ?? 'brownfieldlib';
+
+  return {
+    ios: expoConfig.ios
+      ? {
+          frameworkName: config.ios?.frameworkName ?? 'BrownfieldLib',
+          bundleIdentifier:
+            config.ios?.bundleIdentifier ??
+            `${expoConfig.ios.bundleIdentifier}.brownfield`,
+          buildSettings: config.ios?.buildSettings ?? {},
+          deploymentTarget: config.ios?.deploymentTarget ?? '15.0',
+          frameworkVersion: config.ios?.frameworkVersion ?? '1',
+        }
+      : null,
+    android: androidPackage
+      ? {
+          moduleName: androidModuleName,
+          packageName: config.android?.packageName ?? androidPackage,
+          minSdkVersion: config.android?.minSdkVersion ?? 24,
+          targetSdkVersion: config.android?.targetSdkVersion ?? 35,
+          compileSdkVersion: config.android?.compileSdkVersion ?? 35,
+          groupId: config.android?.groupId ?? androidPackage,
+          artifactId: config.android?.artifactId ?? androidModuleName,
+          version: config.android?.version ?? '0.0.1-SNAPSHOT',
+        }
+      : null,
+    debug: config.debug ?? false,
+  };
+}
+
+/**
+ * React Native Brownfield - Expo Config Plugin.
+ *
+ * This plugin configures your Expo project to be packaged as:
+ * - iOS: XCFramework that can be integrated into native iOS apps
+ * - Android: AAR that can be integrated into native Android apps
+ *
+ * The plugin modifies the native project files during expo prebuild.
+ *
+ * @example
+ * ```json
+ * // app.json
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       ["@callstack/react-native-brownfield", {
+ *         "ios": {
+ *           "frameworkName": "MyReactNativeApp"
+ *         },
+ *         "android": {
+ *           "moduleName": "myreactnativeapp"
+ *         }
+ *       }]
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+const withBrownfield: ConfigPlugin<BrownfieldPluginConfig | void> = (
+  config,
+  props = {}
+) => {
+  const resolvedConfig = resolveConfig(props ?? {}, config);
+
+  const plugins: (ConfigPlugin | StaticPlugin)[] = [];
+
+  if (resolvedConfig.ios) {
+    plugins.push([withBrownfieldIos, resolvedConfig]);
+  }
+
+  if (resolvedConfig.android) {
+    plugins.push([withBrownfieldAndroid, resolvedConfig]);
+  }
+
+  return withPlugins(config, plugins);
+};
+
+export default createRunOncePlugin(
+  withBrownfield,
+  process.env.npm_package_name as string,
+  process.env.npm_package_version as string
+);