expo-build-properties 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -10,7 +10,19 @@
 
 ### 💡 Others
 
-## 0.4.1 — 2022-11-24
+## 0.5.1 — 2023-02-09
+
+### 🎉 New features
+
+- Add support for enabling [Flipper](https://fbflipper.com/) as bundled with react-native. ([#20890](https://github.com/expo/expo/pull/20861) by [@jakobo](https://github.com/jakobo))
+
+## 0.5.0 — 2023-02-03
+
+### 🎉 New features
+
+- Add support for enabling [React Native new architecture mode](https://reactnative.dev/docs/new-architecture-intro). ([#20861](https://github.com/expo/expo/pull/20861) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
+## 0.4.1 - 2022-11-24
 
 ### 🐛 Bug fixes
 

package/README.md

@@ -27,10 +27,12 @@ Add plugin to `app.json`. For example:
           "android": {
             "compileSdkVersion": 31,
             "targetSdkVersion": 31,
-            "buildToolsVersion": "31.0.0"
+            "buildToolsVersion": "31.0.0",
+            "flipper": true
           },
           "ios": {
-            "deploymentTarget": "13.0"
+            "deploymentTarget": "13.0",
+            "flipper": true
           }
         }
       ]
@@ -41,9 +43,9 @@ Add plugin to `app.json`. For example:
 
 ## Contributing
 
-Contributions are very welcome! Please refer to guidelines described in the [contributing guide][contributing].
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide][../../contributing.md].
 
-[docs-main]: https://github.com/expo/expo/blob/main/docs/pages/versions/unversioned/sdk/build-properties.md
+[docs-main]: https://github.com/expo/expo/blob/main/docs/pages/versions/unversioned/sdk/build-properties.mdx
 [docs-stable]: https://docs.expo.dev/versions/latest/sdk/build-properties/
 [contributing]: https://github.com/expo/expo#contributing
 [config-plugins]: https://docs.expo.dev/guides/config-plugins/

package/build/android.d.ts

@@ -1,6 +1,7 @@
 import { ConfigPlugin } from 'expo/config-plugins';
 import type { PluginConfigType } from './pluginConfig';
 export declare const withAndroidBuildProperties: ConfigPlugin<PluginConfigType>;
+export declare const withAndroidFlipper: ConfigPlugin<PluginConfigType>;
 /**
  * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
  */

package/build/android.js

@@ -3,13 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateAndroidProguardRules = exports.withAndroidPurgeProguardRulesOnce = exports.withAndroidProguardRules = exports.withAndroidBuildProperties = void 0;
+exports.updateAndroidProguardRules = exports.withAndroidPurgeProguardRulesOnce = exports.withAndroidProguardRules = exports.withAndroidFlipper = exports.withAndroidBuildProperties = void 0;
 const config_plugins_1 = require("expo/config-plugins");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const fileContentsUtils_1 = require("./fileContentsUtils");
 const { createBuildGradlePropsConfigPlugin } = config_plugins_1.AndroidConfig.BuildProperties;
 exports.withAndroidBuildProperties = createBuildGradlePropsConfigPlugin([
+    {
+        propName: 'newArchEnabled',
+        propValueGetter: (config) => config.android?.newArchEnabled?.toString(),
+    },
     {
         propName: 'android.minSdkVersion',
         propValueGetter: (config) => config.android?.minSdkVersion?.toString(),
@@ -51,6 +55,31 @@ exports.withAndroidBuildProperties = createBuildGradlePropsConfigPlugin([
         propValueGetter: (config) => config.android?.enableProguardInReleaseBuilds?.toString(),
     },
 ], 'withAndroidBuildProperties');
+const withAndroidFlipper = (config, props) => {
+    const ANDROID_FLIPPER_KEY = 'FLIPPER_VERSION';
+    const FLIPPER_FALLBACK = '0.125.0';
+    // when not set, make no changes
+    if (props.android?.flipper === undefined) {
+        return config;
+    }
+    return (0, config_plugins_1.withGradleProperties)(config, (c) => {
+        // check for Flipper version in package. If set, use that
+        let existing;
+        const found = c.modResults.find((item) => item.type === 'property' && item.key === ANDROID_FLIPPER_KEY);
+        if (found && found.type === 'property') {
+            existing = found.value;
+        }
+        // strip key and re-add based on setting
+        c.modResults = c.modResults.filter((item) => !(item.type === 'property' && item.key === ANDROID_FLIPPER_KEY));
+        c.modResults.push({
+            type: 'property',
+            key: ANDROID_FLIPPER_KEY,
+            value: (props.android?.flipper ?? existing ?? FLIPPER_FALLBACK),
+        });
+        return c;
+    });
+};
+exports.withAndroidFlipper = withAndroidFlipper;
 /**
  * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
  */

package/build/ios.js

@@ -4,10 +4,23 @@ exports.withIosDeploymentTarget = exports.withIosBuildProperties = void 0;
 const config_plugins_1 = require("expo/config-plugins");
 const { createBuildPodfilePropsConfigPlugin } = config_plugins_1.IOSConfig.BuildProperties;
 exports.withIosBuildProperties = createBuildPodfilePropsConfigPlugin([
+    {
+        propName: 'newArchEnabled',
+        propValueGetter: (config) => config.ios?.newArchEnabled?.toString(),
+    },
     {
         propName: 'ios.useFrameworks',
         propValueGetter: (config) => config.ios?.useFrameworks,
     },
+    {
+        propName: 'ios.flipper',
+        propValueGetter: (config) => {
+            if (typeof config.ios?.flipper === 'string' || typeof config.ios?.flipper === 'boolean') {
+                return config.ios.flipper.toString();
+            }
+            return undefined;
+        },
+    },
 ], 'withIosBuildProperties');
 const withIosDeploymentTarget = (config, props) => {
     const deploymentTarget = props.ios?.deploymentTarget;

package/build/pluginConfig.d.ts

@@ -1,55 +1,120 @@
 /**
- * Configuration for `expo-build-properties`
+ * Interface representing base build properties configuration.
  */
 export interface PluginConfigType {
+    /**
+     * Interface representing available configuration for Android native build properties.
+     * @platform android
+     */
     android?: PluginConfigTypeAndroid;
+    /**
+     * Interface representing available configuration for iOS native build properties.
+     * @platform ios
+     */
     ios?: PluginConfigTypeIos;
 }
 /**
- * Config for Android native build properties
+ * Interface representing available configuration for Android native build properties.
+ * @platform android
  */
 export interface PluginConfigTypeAndroid {
-    /** Override the default `minSdkVersion` version number in `build.gradle` */
+    /**
+     * Enable React Native new architecture for Android platform.
+     */
+    newArchEnabled?: boolean;
+    /**
+     * Override the default `minSdkVersion` version number in **build.gradle**.
+     * */
     minSdkVersion?: number;
-    /** Override the default `compileSdkVersion` version number in `build.gradle` */
+    /**
+     * Override the default `compileSdkVersion` version number in **build.gradle**.
+     */
     compileSdkVersion?: number;
-    /** Override the default `targetSdkVersion` version number in `build.gradle` */
+    /**
+     * Override the default `targetSdkVersion` version number in **build.gradle**.
+     */
     targetSdkVersion?: number;
-    /** Override the default `buildToolsVersion` version number in `build.gradle` */
+    /**
+     *  Override the default `buildToolsVersion` version number in **build.gradle**.
+     */
     buildToolsVersion?: string;
-    /** Override the default Kotlin version when building the app */
+    /**
+     * Override the Kotlin version used when building the app.
+     */
     kotlinVersion?: string;
-    /** Enable Proguard (R8) in release builds to obfuscate Java code and reduce app size */
+    /**
+     * Enable [Proguard or R8](https://developer.android.com/studio/build/shrink-code) in release builds to obfuscate Java code and reduce app size.
+     */
     enableProguardInReleaseBuilds?: boolean;
-    /** Append custom [Proguard rules](https://www.guardsquare.com/manual/configuration/usage) to `android/app/proguard-rules.pro` */
+    /**
+     * Append custom [Proguard rules](https://www.guardsquare.com/manual/configuration/usage) to **android/app/proguard-rules.pro**.
+     */
     extraProguardRules?: string;
-    /** AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions) */
+    /**
+     * Interface representing available configuration for Android Gradle plugin [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions).
+     */
     packagingOptions?: PluginConfigTypeAndroidPackagingOptions;
+    /**
+     * Change the [Flipper](https://fbflipper.com/) version when running your app on Android.
+     * Flipper is by default enabled with the version that comes bundled with react-native.
+     * However, you can set the `flipper` property to a semver string and specify an
+     * alternate Flipper version.
+     */
+    flipper?: string;
 }
 /**
- * Config for iOS native build properties
+ * Interface representing available configuration for iOS native build properties.
+ * @platform ios
  */
 export interface PluginConfigTypeIos {
     /**
-     * Override the default iOS *Deployment Target* version in the following projects:
-     *  - in CocoaPods projects
-     *  - `PBXNativeTarget` with `com.apple.product-type.application` productType in the app project
+     * Enable React Native new architecture for iOS platform.
+     */
+    newArchEnabled?: boolean;
+    /**
+     * Override the default iOS "Deployment Target" version in the following projects:
+     *  - in CocoaPods projects,
+     *  - `PBXNativeTarget` with "com.apple.product-type.application" `productType` in the app project.
      */
     deploymentTarget?: string;
-    /** Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang) in `Podfile` */
+    /**
+     * Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang)
+     * in `Podfile` to use frameworks instead of static libraries for Pods.
+     *
+     * Note: You cannot use `useFrameworks` and `flipper` at the same time
+     */
     useFrameworks?: 'static' | 'dynamic';
+    /**
+     * Enable [Flipper](https://fbflipper.com/) when running your app on iOS in
+     * Debug mode. Setting `true` enables the default version of Flipper, while
+     * setting a semver string will enable a specific version of Flipper you've
+     * declared in your package.json. The default for this configuration is `false`.
+     *
+     * Note: You cannot use `flipper` at the same time as `useFrameworks`, and
+     * doing so will generate an error.
+     */
+    flipper?: boolean | string;
 }
 /**
- * AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions)
+ * Interface representing available configuration for Android Gradle plugin [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions).
+ * @platform android
  */
 export interface PluginConfigTypeAndroidPackagingOptions {
-    /** Adds a first-pick pattern */
+    /**
+     * Array of patterns for native libraries where only the first occurrence is packaged in the APK.
+     */
     pickFirst?: string[];
-    /** Adds an excluded pattern */
+    /**
+     * Array of patterns for native libraries that should be excluded from being packaged in the APK.
+     */
     exclude?: string[];
-    /** Adds a merge pattern */
+    /**
+     * Array of patterns for native libraries where all occurrences are concatenated and packaged in the APK.
+     */
     merge?: string[];
-    /** Adds a doNotStrip pattern */
+    /**
+     * Array of patterns for native libraries that should not be stripped of debug symbols.
+     */
     doNotStrip?: string[];
 }
 /**

package/build/pluginConfig.js

@@ -7,7 +7,7 @@ exports.validateConfig = void 0;
 const ajv_1 = __importDefault(require("ajv"));
 const semver_1 = __importDefault(require("semver"));
 /**
- * The minimal supported versions. These values should align to SDK
+ * The minimal supported versions. These values should align to SDK.
  * @ignore
  */
 const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
@@ -27,6 +27,7 @@ const schema = {
         android: {
             type: 'object',
             properties: {
+                newArchEnabled: { type: 'boolean', nullable: true },
                 minSdkVersion: { type: 'integer', nullable: true },
                 compileSdkVersion: { type: 'integer', nullable: true },
                 targetSdkVersion: { type: 'integer', nullable: true },
@@ -34,6 +35,10 @@ const schema = {
                 kotlinVersion: { type: 'string', nullable: true },
                 enableProguardInReleaseBuilds: { type: 'boolean', nullable: true },
                 extraProguardRules: { type: 'string', nullable: true },
+                flipper: {
+                    type: 'string',
+                    nullable: true,
+                },
                 packagingOptions: {
                     type: 'object',
                     properties: {
@@ -50,19 +55,24 @@ const schema = {
         ios: {
             type: 'object',
             properties: {
+                newArchEnabled: { type: 'boolean', nullable: true },
                 deploymentTarget: { type: 'string', pattern: '\\d+\\.\\d+', nullable: true },
                 useFrameworks: { type: 'string', enum: ['static', 'dynamic'], nullable: true },
+                flipper: {
+                    type: ['boolean', 'string'],
+                    nullable: true,
+                },
             },
             nullable: true,
         },
     },
 };
+// note(Kudo): For the implementation, we check items one by one because Ajv does not well support custom error message.
 /**
- * Check versions to meet expo minimal supported versions.
+ * Checks if specified versions meets Expo minimal supported versions.
  * Will throw error message whenever there are invalid versions.
- * For the implementation, we check items one by one because ajv does not well support custom error message.
  *
- * @param config the validated config passed from ajv
+ * @param config The validated config passed from Ajv.
  * @ignore
  */
 function maybeThrowInvalidVersions(config) {
@@ -110,11 +120,16 @@ function maybeThrowInvalidVersions(config) {
  * @ignore
  */
 function validateConfig(config) {
-    const validate = new ajv_1.default().compile(schema);
+    const validate = new ajv_1.default({ allowUnionTypes: true }).compile(schema);
     if (!validate(config)) {
         throw new Error('Invalid expo-build-properties config: ' + JSON.stringify(validate.errors));
     }
     maybeThrowInvalidVersions(config);
+    // explicitly block using use_frameworks and Flipper in iOS
+    // https://github.com/facebook/flipper/issues/2414
+    if (config?.ios?.flipper !== undefined && config?.ios?.useFrameworks !== undefined) {
+        throw new Error('`ios.flipper` cannot be enabled when `ios.useFrameworks` is set.');
+    }
     return config;
 }
 exports.validateConfig = validateConfig;

package/build/withBuildProperties.d.ts

@@ -1,10 +1,9 @@
-import type { ConfigPlugin } from 'expo/config-plugins';
+import { ConfigPlugin } from 'expo/config-plugins';
 import { PluginConfigType } from './pluginConfig';
 /**
- * Config plugin to customize native Android or iOS build properties for managed apps
- *
- * @param config ExpoConfig
- * @param props Configuration for the config plugin
+ * Config plugin allowing customizing native Android and iOS build properties for managed apps.
+ * @param config Expo config for application.
+ * @param props Configuration for the build properties plugin.
  */
 export declare const withBuildProperties: ConfigPlugin<PluginConfigType>;
 export default withBuildProperties;

package/build/withBuildProperties.js

@@ -5,10 +5,9 @@ const android_1 = require("./android");
 const ios_1 = require("./ios");
 const pluginConfig_1 = require("./pluginConfig");
 /**
- * Config plugin to customize native Android or iOS build properties for managed apps
- *
- * @param config ExpoConfig
- * @param props Configuration for the config plugin
+ * Config plugin allowing customizing native Android and iOS build properties for managed apps.
+ * @param config Expo config for application.
+ * @param props Configuration for the build properties plugin.
  */
 const withBuildProperties = (config, props) => {
     const pluginConfig = (0, pluginConfig_1.validateConfig)(props || {});
@@ -21,6 +20,7 @@ const withBuildProperties = (config, props) => {
     //
     // plugins order matter: the later one would run first
     config = (0, android_1.withAndroidPurgeProguardRulesOnce)(config);
+    config = (0, android_1.withAndroidFlipper)(config, pluginConfig);
     config = (0, ios_1.withIosBuildProperties)(config, pluginConfig);
     config = (0, ios_1.withIosDeploymentTarget)(config, pluginConfig);
     return config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-build-properties",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Config plugin to customize native build properties on prebuild",
   "main": "build/withBuildProperties.js",
   "types": "build/withBuildProperties.d.ts",
@@ -37,11 +37,8 @@
   "devDependencies": {
     "expo-module-scripts": "^3.0.0"
   },
-  "jest": {
-    "preset": "expo-module-scripts"
-  },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "1c5b1b798ecf9801a8004614140441c4d37f3935"
+  "gitHead": "1f8a6a09570fd451378565ca34933018ce48454e"
 }

package/src/android.ts

@@ -1,4 +1,10 @@
-import { AndroidConfig, ConfigPlugin, History, withDangerousMod } from 'expo/config-plugins';
+import {
+  AndroidConfig,
+  ConfigPlugin,
+  History,
+  withDangerousMod,
+  withGradleProperties,
+} from 'expo/config-plugins';
 import fs from 'fs';
 import path from 'path';
 
@@ -9,6 +15,10 @@ const { createBuildGradlePropsConfigPlugin } = AndroidConfig.BuildProperties;
 
 export const withAndroidBuildProperties = createBuildGradlePropsConfigPlugin<PluginConfigType>(
   [
+    {
+      propName: 'newArchEnabled',
+      propValueGetter: (config) => config.android?.newArchEnabled?.toString(),
+    },
     {
       propName: 'android.minSdkVersion',
       propValueGetter: (config) => config.android?.minSdkVersion?.toString(),
@@ -53,6 +63,41 @@ export const withAndroidBuildProperties = createBuildGradlePropsConfigPlugin<Plu
   'withAndroidBuildProperties'
 );
 
+export const withAndroidFlipper: ConfigPlugin<PluginConfigType> = (config, props) => {
+  const ANDROID_FLIPPER_KEY = 'FLIPPER_VERSION';
+  const FLIPPER_FALLBACK = '0.125.0';
+
+  // when not set, make no changes
+  if (props.android?.flipper === undefined) {
+    return config;
+  }
+
+  return withGradleProperties(config, (c) => {
+    // check for Flipper version in package. If set, use that
+    let existing: string | undefined;
+
+    const found = c.modResults.find(
+      (item) => item.type === 'property' && item.key === ANDROID_FLIPPER_KEY
+    );
+    if (found && found.type === 'property') {
+      existing = found.value;
+    }
+
+    // strip key and re-add based on setting
+    c.modResults = c.modResults.filter(
+      (item) => !(item.type === 'property' && item.key === ANDROID_FLIPPER_KEY)
+    );
+
+    c.modResults.push({
+      type: 'property',
+      key: ANDROID_FLIPPER_KEY,
+      value: (props.android?.flipper ?? existing ?? FLIPPER_FALLBACK) as string,
+    });
+
+    return c;
+  });
+};
+
 /**
  * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
  */

package/src/ios.ts

@@ -6,10 +6,23 @@ const { createBuildPodfilePropsConfigPlugin } = IOSConfig.BuildProperties;
 
 export const withIosBuildProperties = createBuildPodfilePropsConfigPlugin<PluginConfigType>(
   [
+    {
+      propName: 'newArchEnabled',
+      propValueGetter: (config) => config.ios?.newArchEnabled?.toString(),
+    },
     {
       propName: 'ios.useFrameworks',
       propValueGetter: (config) => config.ios?.useFrameworks,
     },
+    {
+      propName: 'ios.flipper',
+      propValueGetter: (config) => {
+        if (typeof config.ios?.flipper === 'string' || typeof config.ios?.flipper === 'boolean') {
+          return config.ios.flipper.toString();
+        }
+        return undefined;
+      },
+    },
   ],
   'withIosBuildProperties'
 );

package/src/pluginConfig.ts

@@ -2,7 +2,7 @@ import Ajv, { JSONSchemaType } from 'ajv';
 import semver from 'semver';
 
 /**
- * The minimal supported versions. These values should align to SDK
+ * The minimal supported versions. These values should align to SDK.
  * @ignore
  */
 const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
@@ -18,71 +18,128 @@ const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
 };
 
 /**
- * Configuration for `expo-build-properties`
+ * Interface representing base build properties configuration.
  */
 export interface PluginConfigType {
+  /**
+   * Interface representing available configuration for Android native build properties.
+   * @platform android
+   */
   android?: PluginConfigTypeAndroid;
+  /**
+   * Interface representing available configuration for iOS native build properties.
+   * @platform ios
+   */
   ios?: PluginConfigTypeIos;
 }
 
 /**
- * Config for Android native build properties
+ * Interface representing available configuration for Android native build properties.
+ * @platform android
  */
 export interface PluginConfigTypeAndroid {
-  /** Override the default `minSdkVersion` version number in `build.gradle` */
+  /**
+   * Enable React Native new architecture for Android platform.
+   */
+  newArchEnabled?: boolean;
+  /**
+   * Override the default `minSdkVersion` version number in **build.gradle**.
+   * */
   minSdkVersion?: number;
-
-  /** Override the default `compileSdkVersion` version number in `build.gradle` */
+  /**
+   * Override the default `compileSdkVersion` version number in **build.gradle**.
+   */
   compileSdkVersion?: number;
-
-  /** Override the default `targetSdkVersion` version number in `build.gradle` */
+  /**
+   * Override the default `targetSdkVersion` version number in **build.gradle**.
+   */
   targetSdkVersion?: number;
-
-  /** Override the default `buildToolsVersion` version number in `build.gradle` */
+  /**
+   *  Override the default `buildToolsVersion` version number in **build.gradle**.
+   */
   buildToolsVersion?: string;
-
-  /** Override the default Kotlin version when building the app */
+  /**
+   * Override the Kotlin version used when building the app.
+   */
   kotlinVersion?: string;
-
-  /** Enable Proguard (R8) in release builds to obfuscate Java code and reduce app size */
+  /**
+   * Enable [Proguard or R8](https://developer.android.com/studio/build/shrink-code) in release builds to obfuscate Java code and reduce app size.
+   */
   enableProguardInReleaseBuilds?: boolean;
-
-  /** Append custom [Proguard rules](https://www.guardsquare.com/manual/configuration/usage) to `android/app/proguard-rules.pro` */
+  /**
+   * Append custom [Proguard rules](https://www.guardsquare.com/manual/configuration/usage) to **android/app/proguard-rules.pro**.
+   */
   extraProguardRules?: string;
-
-  /** AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions) */
+  /**
+   * Interface representing available configuration for Android Gradle plugin [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions).
+   */
   packagingOptions?: PluginConfigTypeAndroidPackagingOptions;
+
+  /**
+   * Change the [Flipper](https://fbflipper.com/) version when running your app on Android.
+   * Flipper is by default enabled with the version that comes bundled with react-native.
+   * However, you can set the `flipper` property to a semver string and specify an
+   * alternate Flipper version.
+   */
+  flipper?: string;
 }
 
 /**
- * Config for iOS native build properties
+ * Interface representing available configuration for iOS native build properties.
+ * @platform ios
  */
 export interface PluginConfigTypeIos {
   /**
-   * Override the default iOS *Deployment Target* version in the following projects:
-   *  - in CocoaPods projects
-   *  - `PBXNativeTarget` with `com.apple.product-type.application` productType in the app project
+   * Enable React Native new architecture for iOS platform.
+   */
+  newArchEnabled?: boolean;
+  /**
+   * Override the default iOS "Deployment Target" version in the following projects:
+   *  - in CocoaPods projects,
+   *  - `PBXNativeTarget` with "com.apple.product-type.application" `productType` in the app project.
    */
   deploymentTarget?: string;
 
-  /** Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang) in `Podfile` */
+  /**
+   * Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang)
+   * in `Podfile` to use frameworks instead of static libraries for Pods.
+   *
+   * Note: You cannot use `useFrameworks` and `flipper` at the same time
+   */
   useFrameworks?: 'static' | 'dynamic';
+
+  /**
+   * Enable [Flipper](https://fbflipper.com/) when running your app on iOS in
+   * Debug mode. Setting `true` enables the default version of Flipper, while
+   * setting a semver string will enable a specific version of Flipper you've
+   * declared in your package.json. The default for this configuration is `false`.
+   *
+   * Note: You cannot use `flipper` at the same time as `useFrameworks`, and
+   * doing so will generate an error.
+   */
+  flipper?: boolean | string;
 }
 
 /**
- * AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions)
+ * Interface representing available configuration for Android Gradle plugin [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions).
+ * @platform android
  */
 export interface PluginConfigTypeAndroidPackagingOptions {
-  /** Adds a first-pick pattern */
+  /**
+   * Array of patterns for native libraries where only the first occurrence is packaged in the APK.
+   */
   pickFirst?: string[];
-
-  /** Adds an excluded pattern */
+  /**
+   * Array of patterns for native libraries that should be excluded from being packaged in the APK.
+   */
   exclude?: string[];
-
-  /** Adds a merge pattern */
+  /**
+   * Array of patterns for native libraries where all occurrences are concatenated and packaged in the APK.
+   */
   merge?: string[];
-
-  /** Adds a doNotStrip pattern */
+  /**
+   * Array of patterns for native libraries that should not be stripped of debug symbols.
+   */
   doNotStrip?: string[];
 }
 
@@ -92,6 +149,7 @@ const schema: JSONSchemaType<PluginConfigType> = {
     android: {
       type: 'object',
       properties: {
+        newArchEnabled: { type: 'boolean', nullable: true },
         minSdkVersion: { type: 'integer', nullable: true },
         compileSdkVersion: { type: 'integer', nullable: true },
         targetSdkVersion: { type: 'integer', nullable: true },
@@ -101,6 +159,11 @@ const schema: JSONSchemaType<PluginConfigType> = {
         enableProguardInReleaseBuilds: { type: 'boolean', nullable: true },
         extraProguardRules: { type: 'string', nullable: true },
 
+        flipper: {
+          type: 'string',
+          nullable: true,
+        },
+
         packagingOptions: {
           type: 'object',
           properties: {
@@ -117,20 +180,26 @@ const schema: JSONSchemaType<PluginConfigType> = {
     ios: {
       type: 'object',
       properties: {
+        newArchEnabled: { type: 'boolean', nullable: true },
         deploymentTarget: { type: 'string', pattern: '\\d+\\.\\d+', nullable: true },
         useFrameworks: { type: 'string', enum: ['static', 'dynamic'], nullable: true },
+
+        flipper: {
+          type: ['boolean', 'string'],
+          nullable: true,
+        },
       },
       nullable: true,
     },
   },
 };
 
+// note(Kudo): For the implementation, we check items one by one because Ajv does not well support custom error message.
 /**
- * Check versions to meet expo minimal supported versions.
+ * Checks if specified versions meets Expo minimal supported versions.
  * Will throw error message whenever there are invalid versions.
- * For the implementation, we check items one by one because ajv does not well support custom error message.
  *
- * @param config the validated config passed from ajv
+ * @param config The validated config passed from Ajv.
  * @ignore
  */
 function maybeThrowInvalidVersions(config: PluginConfigType) {
@@ -184,11 +253,18 @@ function maybeThrowInvalidVersions(config: PluginConfigType) {
  * @ignore
  */
 export function validateConfig(config: any): PluginConfigType {
-  const validate = new Ajv().compile(schema);
+  const validate = new Ajv({ allowUnionTypes: true }).compile(schema);
   if (!validate(config)) {
     throw new Error('Invalid expo-build-properties config: ' + JSON.stringify(validate.errors));
   }
 
   maybeThrowInvalidVersions(config);
+
+  // explicitly block using use_frameworks and Flipper in iOS
+  // https://github.com/facebook/flipper/issues/2414
+  if (config?.ios?.flipper !== undefined && config?.ios?.useFrameworks !== undefined) {
+    throw new Error('`ios.flipper` cannot be enabled when `ios.useFrameworks` is set.');
+  }
+
   return config;
 }

package/src/withBuildProperties.ts

@@ -1,18 +1,18 @@
-import type { ConfigPlugin } from 'expo/config-plugins';
+import { ConfigPlugin } from 'expo/config-plugins';
 
 import {
   withAndroidBuildProperties,
   withAndroidProguardRules,
   withAndroidPurgeProguardRulesOnce,
+  withAndroidFlipper,
 } from './android';
 import { withIosBuildProperties, withIosDeploymentTarget } from './ios';
 import { PluginConfigType, validateConfig } from './pluginConfig';
 
 /**
- * Config plugin to customize native Android or iOS build properties for managed apps
- *
- * @param config ExpoConfig
- * @param props Configuration for the config plugin
+ * Config plugin allowing customizing native Android and iOS build properties for managed apps.
+ * @param config Expo config for application.
+ * @param props Configuration for the build properties plugin.
  */
 export const withBuildProperties: ConfigPlugin<PluginConfigType> = (config, props) => {
   const pluginConfig = validateConfig(props || {});
@@ -28,6 +28,7 @@ export const withBuildProperties: ConfigPlugin<PluginConfigType> = (config, prop
   // plugins order matter: the later one would run first
   config = withAndroidPurgeProguardRulesOnce(config);
 
+  config = withAndroidFlipper(config, pluginConfig);
   config = withIosBuildProperties(config, pluginConfig);
   config = withIosDeploymentTarget(config, pluginConfig);