expo-build-properties 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 0.8.0 — 2023-06-21
+
+### 🛠 Breaking changes
+
+- Replaced `unstable_networkInspector` as `networkInspector` and enabled the feature by default. ([#22994](https://github.com/expo/expo/pull/22994) by [@kudo](https://github.com/kudo))
+
+### 🎉 New features
+
+- Added `android.extraMavenRepos` and `ios.extraPods` support. ([#22785](https://github.com/expo/expo/pull/22785) by [@kudo](https://github.com/kudo))
+
 ## 0.7.0 — 2023-05-08
 
 ### 🐛 Bug fixes

package/build/android.js

@@ -60,7 +60,7 @@ exports.withAndroidBuildProperties = createBuildGradlePropsConfigPlugin([
     },
     {
         propName: 'EX_DEV_CLIENT_NETWORK_INSPECTOR',
-        propValueGetter: (config) => config.android?.unstable_networkInspector?.toString(),
+        propValueGetter: (config) => (config.android?.networkInspector ?? true).toString(),
     },
 ], 'withAndroidBuildProperties');
 const withAndroidFlipper = (config, props) => {

package/build/ios.js

@@ -23,7 +23,7 @@ exports.withIosBuildProperties = createBuildPodfilePropsConfigPlugin([
     },
     {
         propName: 'EX_DEV_CLIENT_NETWORK_INSPECTOR',
-        propValueGetter: (config) => config.ios?.unstable_networkInspector?.toString(),
+        propValueGetter: (config) => (config.ios?.networkInspector ?? true).toString(),
     },
 ], 'withIosBuildProperties');
 const withIosDeploymentTarget = (config, props) => {

package/build/pluginConfig.d.ts

@@ -68,10 +68,29 @@ export interface PluginConfigTypeAndroid {
      */
     flipper?: string;
     /**
-     * Enable the experimental Network Inspector for [Development builds](https://docs.expo.dev/develop/development-builds/introduction/).
-     * SDK 49+ is required.
+     * Enable the Network Inspector.
+     *
+     * @default true
+     */
+    networkInspector?: boolean;
+    /**
+     * Add extra maven repositories to all gradle projects.
+     *
+     * This acts like to add the following code to **android/build.gradle**:
+     * ```groovy
+     * allprojects {
+     *   repositories {
+     *     maven {
+     *       url [THE_EXTRA_MAVEN_REPOSITORY]
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @hide For the implementation details,
+     * this property is actually handled by `expo-modules-autolinking` but not the config-plugins inside expo-build-properties.
      */
-    unstable_networkInspector?: boolean;
+    extraMavenRepos?: string[];
 }
 /**
  * Interface representing available configuration for iOS native build properties.
@@ -107,10 +126,97 @@ export interface PluginConfigTypeIos {
      */
     flipper?: boolean | string;
     /**
-     * Enable the experimental Network Inspector for [Development builds](https://docs.expo.dev/develop/development-builds/introduction/).
-     * SDK 49+ is required.
+     * Enable the Network Inspector.
+     *
+     * @default true
+     */
+    networkInspector?: boolean;
+    /**
+     * Add extra CocoaPods dependencies for all targets.
+     *
+     * This acts like to add the following code to **ios/Podfile**:
+     * ```
+     * pod '[EXTRA_POD_NAME]', '~> [EXTRA_POD_VERSION]'
+     * # e.g.
+     * pod 'Protobuf', '~> 3.14.0'
+     * ```
+     *
+     * @hide For the implementation details,
+     * this property is actually handled by `expo-modules-autolinking` but not the config-plugins inside expo-build-properties.
+     */
+    extraPods?: ExtraIosPodDependency[];
+}
+/**
+ * Interface representing extra CocoaPods dependency.
+ * @see [Podfile syntax reference](https://guides.cocoapods.org/syntax/podfile.html#pod)
+ * @platform ios
+ */
+export interface ExtraIosPodDependency {
+    /**
+     * Name of the pod.
+     */
+    name: string;
+    /**
+     * Version of the pod.
+     * CocoaPods supports various [versioning options](https://guides.cocoapods.org/using/the-podfile.html#pod).
+     * @example `~> 0.1.2`
+     */
+    version?: string;
+    /**
+     * Build configurations for which the pod should be installed.
+     * @example `['Debug', 'Release']`
+     */
+    configurations?: string[];
+    /**
+     * Whether this pod should use modular headers.
+     */
+    modular_headers?: boolean;
+    /**
+     * Custom source to search for this dependency.
+     * @example `https://github.com/CocoaPods/Specs.git`
+     */
+    source?: string;
+    /**
+     * Custom local filesystem path to add the dependency.
+     * @example `~/Documents/AFNetworking`
+     */
+    path?: string;
+    /**
+     * Custom podspec path.
+     * @example `https://example.com/JSONKit.podspec`
+     */
+    podspec?: string;
+    /**
+     * Test specs can be optionally included via the :testspecs option. By default, none of a Pod's test specs are included.
+     * @example `['UnitTests', 'SomeOtherTests']`
+     */
+    testspecs?: string[];
+    /**
+     * Use the bleeding edge version of a Pod.
+     *
+     * @example
+     * ```
+     * { "name": "AFNetworking", "git": "https://github.com/gowalla/AFNetworking.git", "tag": "0.7.0" }
+     * ```
+     *
+     * This acts like to add this pod dependency statement:
+     * ```
+     * pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
+     * ```
+     */
+    git?: string;
+    /**
+     * The git branch to fetch. See the {@link git} property for more information.
+     */
+    branch?: string;
+    /**
+     * The git tag to fetch. See the {@link git} property for more information.
+     */
+    tag?: string;
+    /**
+     * The git commit to fetch. See the {@link git} property for more information.
      */
-    unstable_networkInspector?: boolean;
+    commit?: string;
 }
 /**
  * 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).

package/build/pluginConfig.js

@@ -50,7 +50,8 @@ const schema = {
                     },
                     nullable: true,
                 },
-                unstable_networkInspector: { type: 'boolean', nullable: true },
+                networkInspector: { type: 'boolean', nullable: true },
+                extraMavenRepos: { type: 'array', items: { type: 'string' }, nullable: true },
             },
             nullable: true,
         },
@@ -64,7 +65,29 @@ const schema = {
                     type: ['boolean', 'string'],
                     nullable: true,
                 },
-                unstable_networkInspector: { type: 'boolean', nullable: true },
+                networkInspector: { type: 'boolean', nullable: true },
+                extraPods: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        required: ['name'],
+                        properties: {
+                            name: { type: 'string' },
+                            version: { type: 'string', nullable: true },
+                            configurations: { type: 'array', items: { type: 'string' }, nullable: true },
+                            modular_headers: { type: 'boolean', nullable: true },
+                            source: { type: 'string', nullable: true },
+                            path: { type: 'string', nullable: true },
+                            podspec: { type: 'string', nullable: true },
+                            testspecs: { type: 'array', items: { type: 'string' }, nullable: true },
+                            git: { type: 'string', nullable: true },
+                            branch: { type: 'string', nullable: true },
+                            tag: { type: 'string', nullable: true },
+                            commit: { type: 'string', nullable: true },
+                        },
+                    },
+                    nullable: true,
+                },
             },
             nullable: true,
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-build-properties",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Config plugin to customize native build properties on prebuild",
   "main": "build/withBuildProperties.js",
   "types": "build/withBuildProperties.d.ts",
@@ -40,5 +40,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "4ba50c428c8369bb6b3a51a860d4898ad4ccbe78"
+  "gitHead": "fa5ecca8251986b9f197cc14074eec0ab6dfb6db"
 }

package/src/android.ts

@@ -65,7 +65,7 @@ export const withAndroidBuildProperties = createBuildGradlePropsConfigPlugin<Plu
     },
     {
       propName: 'EX_DEV_CLIENT_NETWORK_INSPECTOR',
-      propValueGetter: (config) => config.android?.unstable_networkInspector?.toString(),
+      propValueGetter: (config) => (config.android?.networkInspector ?? true).toString(),
     },
   ],
   'withAndroidBuildProperties'

package/src/ios.ts

@@ -25,7 +25,7 @@ export const withIosBuildProperties = createBuildPodfilePropsConfigPlugin<Plugin
     },
     {
       propName: 'EX_DEV_CLIENT_NETWORK_INSPECTOR',
-      propValueGetter: (config) => config.ios?.unstable_networkInspector?.toString(),
+      propValueGetter: (config) => (config.ios?.networkInspector ?? true).toString(),
     },
   ],
   'withIosBuildProperties'

package/src/pluginConfig.ts

@@ -90,10 +90,30 @@ export interface PluginConfigTypeAndroid {
   flipper?: string;
 
   /**
-   * Enable the experimental Network Inspector for [Development builds](https://docs.expo.dev/develop/development-builds/introduction/).
-   * SDK 49+ is required.
+   * Enable the Network Inspector.
+   *
+   * @default true
+   */
+  networkInspector?: boolean;
+
+  /**
+   * Add extra maven repositories to all gradle projects.
+   *
+   * This acts like to add the following code to **android/build.gradle**:
+   * ```groovy
+   * allprojects {
+   *   repositories {
+   *     maven {
+   *       url [THE_EXTRA_MAVEN_REPOSITORY]
+   *     }
+   *   }
+   * }
+   * ```
+   *
+   * @hide For the implementation details,
+   * this property is actually handled by `expo-modules-autolinking` but not the config-plugins inside expo-build-properties.
    */
-  unstable_networkInspector?: boolean;
+  extraMavenRepos?: string[];
 }
 
 /**
@@ -133,10 +153,99 @@ export interface PluginConfigTypeIos {
   flipper?: boolean | string;
 
   /**
-   * Enable the experimental Network Inspector for [Development builds](https://docs.expo.dev/develop/development-builds/introduction/).
-   * SDK 49+ is required.
+   * Enable the Network Inspector.
+   *
+   * @default true
+   */
+  networkInspector?: boolean;
+
+  /**
+   * Add extra CocoaPods dependencies for all targets.
+   *
+   * This acts like to add the following code to **ios/Podfile**:
+   * ```
+   * pod '[EXTRA_POD_NAME]', '~> [EXTRA_POD_VERSION]'
+   * # e.g.
+   * pod 'Protobuf', '~> 3.14.0'
+   * ```
+   *
+   * @hide For the implementation details,
+   * this property is actually handled by `expo-modules-autolinking` but not the config-plugins inside expo-build-properties.
+   */
+  extraPods?: ExtraIosPodDependency[];
+}
+
+/**
+ * Interface representing extra CocoaPods dependency.
+ * @see [Podfile syntax reference](https://guides.cocoapods.org/syntax/podfile.html#pod)
+ * @platform ios
+ */
+export interface ExtraIosPodDependency {
+  /**
+   * Name of the pod.
+   */
+  name: string;
+  /**
+   * Version of the pod.
+   * CocoaPods supports various [versioning options](https://guides.cocoapods.org/using/the-podfile.html#pod).
+   * @example `~> 0.1.2`
+   */
+  version?: string;
+  /**
+   * Build configurations for which the pod should be installed.
+   * @example `['Debug', 'Release']`
+   */
+  configurations?: string[];
+  /**
+   * Whether this pod should use modular headers.
+   */
+  modular_headers?: boolean;
+  /**
+   * Custom source to search for this dependency.
+   * @example `https://github.com/CocoaPods/Specs.git`
+   */
+  source?: string;
+  /**
+   * Custom local filesystem path to add the dependency.
+   * @example `~/Documents/AFNetworking`
+   */
+  path?: string;
+  /**
+   * Custom podspec path.
+   * @example `https://example.com/JSONKit.podspec`
+   */
+  podspec?: string;
+  /**
+   * Test specs can be optionally included via the :testspecs option. By default, none of a Pod's test specs are included.
+   * @example `['UnitTests', 'SomeOtherTests']`
+   */
+  testspecs?: string[];
+  /**
+   * Use the bleeding edge version of a Pod.
+   *
+   * @example
+   * ```
+   * { "name": "AFNetworking", "git": "https://github.com/gowalla/AFNetworking.git", "tag": "0.7.0" }
+   * ```
+   *
+   * This acts like to add this pod dependency statement:
+   * ```
+   * pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
+   * ```
+   */
+  git?: string;
+  /**
+   * The git branch to fetch. See the {@link git} property for more information.
+   */
+  branch?: string;
+  /**
+   * The git tag to fetch. See the {@link git} property for more information.
+   */
+  tag?: string;
+  /**
+   * The git commit to fetch. See the {@link git} property for more information.
    */
-  unstable_networkInspector?: boolean;
+  commit?: string;
 }
 
 /**
@@ -195,7 +304,9 @@ const schema: JSONSchemaType<PluginConfigType> = {
           nullable: true,
         },
 
-        unstable_networkInspector: { type: 'boolean', nullable: true },
+        networkInspector: { type: 'boolean', nullable: true },
+
+        extraMavenRepos: { type: 'array', items: { type: 'string' }, nullable: true },
       },
       nullable: true,
     },
@@ -211,7 +322,30 @@ const schema: JSONSchemaType<PluginConfigType> = {
           nullable: true,
         },
 
-        unstable_networkInspector: { type: 'boolean', nullable: true },
+        networkInspector: { type: 'boolean', nullable: true },
+
+        extraPods: {
+          type: 'array',
+          items: {
+            type: 'object',
+            required: ['name'],
+            properties: {
+              name: { type: 'string' },
+              version: { type: 'string', nullable: true },
+              configurations: { type: 'array', items: { type: 'string' }, nullable: true },
+              modular_headers: { type: 'boolean', nullable: true },
+              source: { type: 'string', nullable: true },
+              path: { type: 'string', nullable: true },
+              podspec: { type: 'string', nullable: true },
+              testspecs: { type: 'array', items: { type: 'string' }, nullable: true },
+              git: { type: 'string', nullable: true },
+              branch: { type: 'string', nullable: true },
+              tag: { type: 'string', nullable: true },
+              commit: { type: 'string', nullable: true },
+            },
+          },
+          nullable: true,
+        },
       },
       nullable: true,
     },