expo-build-properties 0.12.4 → 0.13.0

package/CHANGELOG.md

@@ -10,19 +10,34 @@
 
 ### 💡 Others
 
-## 0.12.4 — 2024-07-30
+## 0.13.0 — 2024-10-22
+
+### 🛠 Breaking changes
+
+- Bumped iOS deployment target to 15.1. ([#30840](https://github.com/expo/expo/pull/30840) by [@tsapeta](https://github.com/tsapeta))
+
+### 💡 Others
+
+- Export missing types. ([#29401](https://github.com/expo/expo/pull/29401) by [@Simek](https://github.com/Simek))
+- Deprecate `android.newArchEnabled` and `ios.newArchEnabled` in favor of app config `newArchEnabled`. ([#31963](https://github.com/expo/expo/pull/31963) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
+## 0.12.5 - 2024-08-07
+
+_This version does not introduce any user-facing changes._
+
+## 0.12.4 - 2024-07-30
 
 ### 🎉 New features
 
 - Add `android.enablePngCrunchInReleaseBuilds` to enable toggling PNG crunching in release builds. ([#30699](https://github.com/expo/expo/pull/30699) by [@brentvatne](https://github.com/brentvatne))
 
-## 0.12.3 — 2024-06-06
+## 0.12.3 - 2024-06-06
 
 ### 🎉 New features
 
 - `ios.privacyManifestAggregationEnabled` is now enabled by default. ([#29439](https://github.com/expo/expo/pull/29439) by [@alanjhughes](https://github.com/alanjhughes))
 
-## 0.12.2 — 2024-06-05
+## 0.12.2 - 2024-06-05
 
 ### 🐛 Bug fixes
 

package/README.md

@@ -4,8 +4,8 @@
 
 ## API documentation
 
-- [Documentation for the main branch][docs-main]
-- [Documentation for the latest stable release][docs-stable]
+- [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/build-properties/)
+- [Documentation for the main branch](https://docs.expo.dev/versions/unversioned/sdk/build-properties/)
 
 ### Installation
 
@@ -39,9 +39,4 @@ Add plugin to `app.json`. For example:
 
 ## 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.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/config-plugins/introduction
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide][https://github.com/expo/expo#contributing].

package/build/android.js

@@ -13,7 +13,12 @@ const { createBuildGradlePropsConfigPlugin } = config_plugins_1.AndroidConfig.Bu
 exports.withAndroidBuildProperties = createBuildGradlePropsConfigPlugin([
     {
         propName: 'newArchEnabled',
-        propValueGetter: (config) => config.android?.newArchEnabled?.toString(),
+        propValueGetter: (config) => {
+            if (config.android?.newArchEnabled !== undefined) {
+                config_plugins_1.WarningAggregator.addWarningAndroid('withAndroidBuildProperties', 'android.newArchEnabled is deprecated, use app config `newArchEnabled` instead.', 'https://docs.expo.dev/versions/latest/config/app/#newarchenabled');
+            }
+            return config.android?.newArchEnabled?.toString();
+        },
     },
     {
         propName: 'android.minSdkVersion',

package/build/ios.js

@@ -6,7 +6,12 @@ const { createBuildPodfilePropsConfigPlugin } = config_plugins_1.IOSConfig.Build
 exports.withIosBuildProperties = createBuildPodfilePropsConfigPlugin([
     {
         propName: 'newArchEnabled',
-        propValueGetter: (config) => config.ios?.newArchEnabled?.toString(),
+        propValueGetter: (config) => {
+            if (config.ios?.newArchEnabled !== undefined) {
+                config_plugins_1.WarningAggregator.addWarningIOS('withIosBuildProperties', 'ios.newArchEnabled is deprecated, use app config `newArchEnabled` instead.', 'https://docs.expo.dev/versions/latest/config/app/#newarchenabled');
+            }
+            return config.ios?.newArchEnabled?.toString();
+        },
     },
     {
         propName: 'ios.useFrameworks',
@@ -53,8 +58,7 @@ function updateDeploymentTargetXcodeProject(project, deploymentTarget) {
         .filter(([_, target]) => Target.isTargetOfType(target, Target.TargetType.APPLICATION))
         .map(([_, target]) => target.buildConfigurationList);
     for (const buildConfigListId of targetBuildConfigListIds) {
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        for (const [_, configurations] of config_plugins_1.IOSConfig.XcodeUtils.getBuildConfigurationsForListId(project, buildConfigListId)) {
+        for (const [, configurations] of config_plugins_1.IOSConfig.XcodeUtils.getBuildConfigurationsForListId(project, buildConfigListId)) {
             const { buildSettings } = configurations;
             if (buildSettings?.IPHONEOS_DEPLOYMENT_TARGET) {
                 buildSettings.IPHONEOS_DEPLOYMENT_TARGET = deploymentTarget;

package/build/pluginConfig.d.ts

@@ -19,6 +19,7 @@ export interface PluginConfigType {
  */
 export interface PluginConfigTypeAndroid {
     /**
+     * @deprecated Use app config [`newArchEnabled`](https://docs.expo.dev/versions/latest/config/app/#newarchenabled) instead.
      * Enable React Native new architecture for Android platform.
      */
     newArchEnabled?: boolean;
@@ -63,7 +64,7 @@ export interface PluginConfigTypeAndroid {
      */
     extraProguardRules?: 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).
+     * 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;
     /**
@@ -75,7 +76,6 @@ export interface PluginConfigTypeAndroid {
     /**
      * Add extra maven repositories to all gradle projects.
      *
-     *
      * Takes an array of objects or strings.
      * Strings are passed as the `url` property of the object with no credentials or authentication scheme.
      *
@@ -90,7 +90,6 @@ export interface PluginConfigTypeAndroid {
      * ```
      *
      * By using an `AndroidMavenRepository` object, you can specify credentials and an authentication scheme.
-     *
      * ```groovy
      * allprojects {
      *   repositories {
@@ -109,9 +108,6 @@ export interface PluginConfigTypeAndroid {
      * ```
      *
      * @see [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:case-for-maven)
-     *
-     * @hide For the implementation details,
-     * this property is actually handled by `expo-modules-autolinking` not the config-plugins inside `expo-build-properties`
      */
     extraMavenRepos?: (AndroidMavenRepository | string)[];
     /**
@@ -138,6 +134,9 @@ export interface PluginConfigTypeAndroid {
      */
     manifestQueries?: PluginConfigTypeAndroidQueries;
 }
+/**
+ * @platform android
+ */
 export interface AndroidMavenRepository {
     /**
      * The URL of the Maven repository.
@@ -147,7 +146,7 @@ export interface AndroidMavenRepository {
      * The credentials to use when accessing the Maven repository.
      * May be of type PasswordCredentials, HttpHeaderCredentials, or AWSCredentials.
      *
-     * @see the authentication schemes section of [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:authentication_schemes) for more information.
+     * @see The authentication schemes section of [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:authentication_schemes) for more information.
      */
     credentials?: AndroidMavenRepositoryCredentials;
     /**
@@ -155,26 +154,39 @@ export interface AndroidMavenRepository {
      */
     authentication?: 'basic' | 'digest' | 'header';
 }
-interface AndroidMavenRepositoryPasswordCredentials {
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryPasswordCredentials {
     username: string;
     password: string;
 }
-interface AndroidMavenRepositoryHttpHeaderCredentials {
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryHttpHeaderCredentials {
     name: string;
     value: string;
 }
-interface AndroidMavenRepositoryAWSCredentials {
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryAWSCredentials {
     accessKey: string;
     secretKey: string;
     sessionToken?: string;
 }
-type AndroidMavenRepositoryCredentials = AndroidMavenRepositoryPasswordCredentials | AndroidMavenRepositoryHttpHeaderCredentials | AndroidMavenRepositoryAWSCredentials;
+/**
+ * @platform android
+ */
+export type AndroidMavenRepositoryCredentials = AndroidMavenRepositoryPasswordCredentials | AndroidMavenRepositoryHttpHeaderCredentials | AndroidMavenRepositoryAWSCredentials;
 /**
  * Interface representing available configuration for iOS native build properties.
  * @platform ios
  */
 export interface PluginConfigTypeIos {
     /**
+     * @deprecated Use app config [`newArchEnabled`](https://docs.expo.dev/versions/latest/config/app/#newarchenabled) instead.
      * Enable React Native new architecture for iOS platform.
      */
     newArchEnabled?: boolean;
@@ -198,15 +210,22 @@ export interface PluginConfigTypeIos {
     /**
      * Add extra CocoaPods dependencies for all targets.
      *
-     * This acts like to add the following code to **ios/Podfile**:
+     * This configuration is responsible for adding the new Pod entries to **ios/Podfile**.
+     *
+     * @example
+     * Creating entry in the configuration like below:
+     * ```json
+     * [
+     *   {
+     *     name: "Protobuf",
+     *     version: "~> 3.14.0",
+     *   }
+     * ]
      * ```
-     * pod '[EXTRA_POD_NAME]', '~> [EXTRA_POD_VERSION]'
-     * # e.g.
+     * Will produce the following entry in the generated **ios/Podfile**:
+     * ```ruby
      * 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[];
     /**
@@ -214,8 +233,8 @@ export interface PluginConfigTypeIos {
      *
      * This speeds up compiling C++ code by caching the results of previous compilations.
      *
-     * @see https://reactnative.dev/docs/build-speed#local-caches
-     * @see https://ccache.dev/
+     * @see [React Native's documentation on local caches](https://reactnative.dev/docs/build-speed#local-caches) and
+     * [Ccache documentation](https://ccache.dev/).
      */
     ccacheEnabled?: boolean;
     /**
@@ -223,8 +242,8 @@ export interface PluginConfigTypeIos {
      * CocoaPods resource bundles. If enabled, the manifests will be merged into a
      * single file. If not enabled, developers will need to manually aggregate them.
      *
-     * @see https://docs.expo.dev/guides/apple-privacy/
-     * @see https://developer.apple.com/documentation/bundleresources/privacy_manifest_files
+     * @see [Privacy manifests](https://docs.expo.dev/guides/apple-privacy/) guide
+     * and [Apple's documentation on Privacy manifest files](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files).
      */
     privacyManifestAggregationEnabled?: boolean;
 }
@@ -293,12 +312,17 @@ export interface ExtraIosPodDependency {
      * Use the bleeding edge version of a Pod.
      *
      * @example
-     * ```
-     * { "name": "AFNetworking", "git": "https://github.com/gowalla/AFNetworking.git", "tag": "0.7.0" }
+     * ```json
+     * {
+     *   "name": "AFNetworking",
+     *   "git": "https://github.com/gowalla/AFNetworking.git",
+     *   "tag": "0.7.0"
+     * }
      * ```
      *
      * This acts like to add this pod dependency statement:
-     * ```
+     *
+     * ```rb
      * pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
      * ```
      */
@@ -317,7 +341,7 @@ export interface ExtraIosPodDependency {
     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).
+ * 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 {
@@ -338,13 +362,16 @@ export interface PluginConfigTypeAndroidPackagingOptions {
      */
     doNotStrip?: string[];
 }
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueries {
     /**
      * Specifies one or more apps that your app intends to access. These other apps might integrate with your app, or your app might use services that these other apps provide.
      */
     package?: string[];
     /**
-     * Specifies an intent filter signature. Your app can discover other apps that have matching <intent-filter> elements.
+     * Specifies an intent filter signature. Your app can discover other apps that have matching `<intent-filter>` elements.
      * These intents have restrictions compared to typical intent filter signatures.
      *
      * @see [Android documentation](https://developer.android.com/training/package-visibility/declaring#intent-filter-signature) for details
@@ -352,13 +379,16 @@ export interface PluginConfigTypeAndroidQueries {
     intent?: PluginConfigTypeAndroidQueriesIntent[];
     /**
      * Specifies one or more content provider authorities. Your app can discover other apps whose content providers use the specified authorities.
-     * There are some restrictions on the options that you can include in this <provider> element, compared to a typical <provider> manifest element. You may only specify the android:authorities attribute.
+     * There are some restrictions on the options that you can include in this `<provider>` element, compared to a typical `<provider>` manifest element. You may only specify the `android:authorities` attribute.
      */
     provider?: string[];
 }
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueriesIntent {
     /**
-     * A string naming the action to perform. Usually one of the platform-defined values, such as ACTION_SEND or ACTION_VIEW
+     * A string naming the action to perform. Usually one of the platform-defined values, such as `ACTION_SEND` or `ACTION_VIEW`.
      */
     action?: string;
     /**
@@ -371,6 +401,9 @@ export interface PluginConfigTypeAndroidQueriesIntent {
      */
     category?: string | string[];
 }
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueriesData {
     /**
      * Specify a URI scheme that is handled
@@ -389,4 +422,3 @@ export interface PluginConfigTypeAndroidQueriesData {
  * @ignore
  */
 export declare function validateConfig(config: any): PluginConfigType;
-export {};

package/build/pluginConfig.js

@@ -18,7 +18,7 @@ const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
         kotlinVersion: '1.6.10',
     },
     ios: {
-        deploymentTarget: '13.4',
+        deploymentTarget: '15.1',
     },
 };
 const schema = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-build-properties",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "description": "Config plugin to customize native build properties on prebuild",
   "main": "build/withBuildProperties.js",
   "types": "build/withBuildProperties.d.ts",
@@ -35,10 +35,10 @@
     "semver": "^7.6.0"
   },
   "devDependencies": {
-    "expo-module-scripts": "^3.0.0"
+    "expo-module-scripts": "^4.0.0"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "10eaf729822bf46ab821a000eb961cf8df40b35b"
+  "gitHead": "7c7d2362fff23bec26cd145ed34edd9c403551bd"
 }

package/src/android.ts

@@ -2,6 +2,7 @@ import {
   AndroidConfig,
   ConfigPlugin,
   History,
+  WarningAggregator,
   withAndroidManifest,
   withDangerousMod,
 } from 'expo/config-plugins';
@@ -18,7 +19,17 @@ export const withAndroidBuildProperties = createBuildGradlePropsConfigPlugin<Plu
   [
     {
       propName: 'newArchEnabled',
-      propValueGetter: (config) => config.android?.newArchEnabled?.toString(),
+      propValueGetter: (config) => {
+        if (config.android?.newArchEnabled !== undefined) {
+          WarningAggregator.addWarningAndroid(
+            'withAndroidBuildProperties',
+            'android.newArchEnabled is deprecated, use app config `newArchEnabled` instead.',
+            'https://docs.expo.dev/versions/latest/config/app/#newarchenabled'
+          );
+        }
+
+        return config.android?.newArchEnabled?.toString();
+      },
     },
     {
       propName: 'android.minSdkVersion',

package/src/ios.ts

@@ -1,4 +1,10 @@
-import { IOSConfig, ConfigPlugin, withXcodeProject, XcodeProject } from 'expo/config-plugins';
+import {
+  IOSConfig,
+  ConfigPlugin,
+  withXcodeProject,
+  XcodeProject,
+  WarningAggregator,
+} from 'expo/config-plugins';
 
 import type { PluginConfigType } from './pluginConfig';
 
@@ -8,7 +14,16 @@ export const withIosBuildProperties = createBuildPodfilePropsConfigPlugin<Plugin
   [
     {
       propName: 'newArchEnabled',
-      propValueGetter: (config) => config.ios?.newArchEnabled?.toString(),
+      propValueGetter: (config) => {
+        if (config.ios?.newArchEnabled !== undefined) {
+          WarningAggregator.addWarningIOS(
+            'withIosBuildProperties',
+            'ios.newArchEnabled is deprecated, use app config `newArchEnabled` instead.',
+            'https://docs.expo.dev/versions/latest/config/app/#newarchenabled'
+          );
+        }
+        return config.ios?.newArchEnabled?.toString();
+      },
     },
     {
       propName: 'ios.useFrameworks',
@@ -73,8 +88,7 @@ function updateDeploymentTargetXcodeProject(
     .map(([_, target]) => target.buildConfigurationList);
 
   for (const buildConfigListId of targetBuildConfigListIds) {
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    for (const [_, configurations] of IOSConfig.XcodeUtils.getBuildConfigurationsForListId(
+    for (const [, configurations] of IOSConfig.XcodeUtils.getBuildConfigurationsForListId(
       project,
       buildConfigListId
     )) {

package/src/pluginConfig.ts

@@ -13,7 +13,7 @@ const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
     kotlinVersion: '1.6.10',
   },
   ios: {
-    deploymentTarget: '13.4',
+    deploymentTarget: '15.1',
   },
 };
 
@@ -39,6 +39,7 @@ export interface PluginConfigType {
  */
 export interface PluginConfigTypeAndroid {
   /**
+   * @deprecated Use app config [`newArchEnabled`](https://docs.expo.dev/versions/latest/config/app/#newarchenabled) instead.
    * Enable React Native new architecture for Android platform.
    */
   newArchEnabled?: boolean;
@@ -83,7 +84,7 @@ export interface PluginConfigTypeAndroid {
    */
   extraProguardRules?: 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).
+   * 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;
 
@@ -94,10 +95,11 @@ export interface PluginConfigTypeAndroid {
    */
   networkInspector?: boolean;
 
+  // For the implementation details, this property is actually handled by `expo-modules-autolinking`
+  // not the config-plugins inside `expo-build-properties`
   /**
    * Add extra maven repositories to all gradle projects.
    *
-   *
    * Takes an array of objects or strings.
    * Strings are passed as the `url` property of the object with no credentials or authentication scheme.
    *
@@ -112,7 +114,6 @@ export interface PluginConfigTypeAndroid {
    * ```
    *
    * By using an `AndroidMavenRepository` object, you can specify credentials and an authentication scheme.
-   *
    * ```groovy
    * allprojects {
    *   repositories {
@@ -131,9 +132,6 @@ export interface PluginConfigTypeAndroid {
    * ```
    *
    * @see [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:case-for-maven)
-   *
-   * @hide For the implementation details,
-   * this property is actually handled by `expo-modules-autolinking` not the config-plugins inside `expo-build-properties`
    */
   extraMavenRepos?: (AndroidMavenRepository | string)[];
   /**
@@ -161,6 +159,10 @@ export interface PluginConfigTypeAndroid {
   manifestQueries?: PluginConfigTypeAndroidQueries;
 }
 
+// @docsMissing
+/**
+ * @platform android
+ */
 export interface AndroidMavenRepository {
   /**
    * The URL of the Maven repository.
@@ -170,7 +172,7 @@ export interface AndroidMavenRepository {
    * The credentials to use when accessing the Maven repository.
    * May be of type PasswordCredentials, HttpHeaderCredentials, or AWSCredentials.
    *
-   * @see the authentication schemes section of [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:authentication_schemes) for more information.
+   * @see The authentication schemes section of [Gradle documentation](https://docs.gradle.org/current/userguide/declaring_repositories.html#sec:authentication_schemes) for more information.
    */
   credentials?: AndroidMavenRepositoryCredentials;
   /**
@@ -179,23 +181,39 @@ export interface AndroidMavenRepository {
   authentication?: 'basic' | 'digest' | 'header';
 }
 
-interface AndroidMavenRepositoryPasswordCredentials {
+// @docsMissing
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryPasswordCredentials {
   username: string;
   password: string;
 }
 
-interface AndroidMavenRepositoryHttpHeaderCredentials {
+// @docsMissing
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryHttpHeaderCredentials {
   name: string;
   value: string;
 }
 
-interface AndroidMavenRepositoryAWSCredentials {
+// @docsMissing
+/**
+ * @platform android
+ */
+export interface AndroidMavenRepositoryAWSCredentials {
   accessKey: string;
   secretKey: string;
   sessionToken?: string;
 }
 
-type AndroidMavenRepositoryCredentials =
+// @docsMissing
+/**
+ * @platform android
+ */
+export type AndroidMavenRepositoryCredentials =
   | AndroidMavenRepositoryPasswordCredentials
   | AndroidMavenRepositoryHttpHeaderCredentials
   | AndroidMavenRepositoryAWSCredentials;
@@ -206,6 +224,7 @@ type AndroidMavenRepositoryCredentials =
  */
 export interface PluginConfigTypeIos {
   /**
+   * @deprecated Use app config [`newArchEnabled`](https://docs.expo.dev/versions/latest/config/app/#newarchenabled) instead.
    * Enable React Native new architecture for iOS platform.
    */
   newArchEnabled?: boolean;
@@ -229,18 +248,27 @@ export interface PluginConfigTypeIos {
    */
   networkInspector?: boolean;
 
+  // For the implementation details, this property is actually handled by `expo-modules-autolinking`
+  // but not the config-plugins inside `expo-build-properties`.
   /**
    * Add extra CocoaPods dependencies for all targets.
    *
-   * This acts like to add the following code to **ios/Podfile**:
+   * This configuration is responsible for adding the new Pod entries to **ios/Podfile**.
+   *
+   * @example
+   * Creating entry in the configuration like below:
+   * ```json
+   * [
+   *   {
+   *     name: "Protobuf",
+   *     version: "~> 3.14.0",
+   *   }
+   * ]
    * ```
-   * pod '[EXTRA_POD_NAME]', '~> [EXTRA_POD_VERSION]'
-   * # e.g.
+   * Will produce the following entry in the generated **ios/Podfile**:
+   * ```ruby
    * 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[];
 
@@ -249,8 +277,8 @@ export interface PluginConfigTypeIos {
    *
    * This speeds up compiling C++ code by caching the results of previous compilations.
    *
-   * @see https://reactnative.dev/docs/build-speed#local-caches
-   * @see https://ccache.dev/
+   * @see [React Native's documentation on local caches](https://reactnative.dev/docs/build-speed#local-caches) and
+   * [Ccache documentation](https://ccache.dev/).
    */
   ccacheEnabled?: boolean;
 
@@ -259,8 +287,8 @@ export interface PluginConfigTypeIos {
    * CocoaPods resource bundles. If enabled, the manifests will be merged into a
    * single file. If not enabled, developers will need to manually aggregate them.
    *
-   * @see https://docs.expo.dev/guides/apple-privacy/
-   * @see https://developer.apple.com/documentation/bundleresources/privacy_manifest_files
+   * @see [Privacy manifests](https://docs.expo.dev/guides/apple-privacy/) guide
+   * and [Apple's documentation on Privacy manifest files](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files).
    */
   privacyManifestAggregationEnabled?: boolean;
 }
@@ -330,12 +358,17 @@ export interface ExtraIosPodDependency {
    * Use the bleeding edge version of a Pod.
    *
    * @example
-   * ```
-   * { "name": "AFNetworking", "git": "https://github.com/gowalla/AFNetworking.git", "tag": "0.7.0" }
+   * ```json
+   * {
+   *   "name": "AFNetworking",
+   *   "git": "https://github.com/gowalla/AFNetworking.git",
+   *   "tag": "0.7.0"
+   * }
    * ```
    *
    * This acts like to add this pod dependency statement:
-   * ```
+   *
+   * ```rb
    * pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
    * ```
    */
@@ -355,7 +388,7 @@ export interface ExtraIosPodDependency {
 }
 
 /**
- * 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).
+ * 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 {
@@ -377,13 +410,17 @@ export interface PluginConfigTypeAndroidPackagingOptions {
   doNotStrip?: string[];
 }
 
+// @docsMissing
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueries {
   /**
    * Specifies one or more apps that your app intends to access. These other apps might integrate with your app, or your app might use services that these other apps provide.
    */
   package?: string[];
   /**
-   * Specifies an intent filter signature. Your app can discover other apps that have matching <intent-filter> elements.
+   * Specifies an intent filter signature. Your app can discover other apps that have matching `<intent-filter>` elements.
    * These intents have restrictions compared to typical intent filter signatures.
    *
    * @see [Android documentation](https://developer.android.com/training/package-visibility/declaring#intent-filter-signature) for details
@@ -391,14 +428,18 @@ export interface PluginConfigTypeAndroidQueries {
   intent?: PluginConfigTypeAndroidQueriesIntent[];
   /**
    * Specifies one or more content provider authorities. Your app can discover other apps whose content providers use the specified authorities.
-   * There are some restrictions on the options that you can include in this <provider> element, compared to a typical <provider> manifest element. You may only specify the android:authorities attribute.
+   * There are some restrictions on the options that you can include in this `<provider>` element, compared to a typical `<provider>` manifest element. You may only specify the `android:authorities` attribute.
    */
   provider?: string[];
 }
 
+// @docsMissing
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueriesIntent {
   /**
-   * A string naming the action to perform. Usually one of the platform-defined values, such as ACTION_SEND or ACTION_VIEW
+   * A string naming the action to perform. Usually one of the platform-defined values, such as `ACTION_SEND` or `ACTION_VIEW`.
    */
   action?: string;
   /**
@@ -412,6 +453,10 @@ export interface PluginConfigTypeAndroidQueriesIntent {
   category?: string | string[];
 }
 
+// @docsMissing
+/**
+ * @platform android
+ */
 export interface PluginConfigTypeAndroidQueriesData {
   /**
    * Specify a URI scheme that is handled