expo-build-properties 0.0.0

package/.eslintrc.js

@@ -0,0 +1,2 @@
+// @generated by expo-module-scripts
+module.exports = require('expo-module-scripts/eslintrc.base.js');

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others
+
+## 0.0.0 — 2022-05-02
+
+_This version does not introduce any user-facing changes._

package/README.md

@@ -0,0 +1,49 @@
+# expo-build-properties
+
+**`expo-build-properties`** is a config plugin for managed apps to override the default native build properties.
+
+## API documentation
+
+- [Documentation for the main branch][docs-main]
+- [Documentation for the latest stable release][docs-stable]
+
+### Installation
+
+**Note:** To use this config plugin, your apps must be a managed app and build by either [EAS Build](/build/introduction.md) or `expo run:[android|ios]`.
+
+```
+expo install expo-build-properties
+```
+
+Add plugin to `app.json`. For example:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-build-properties",
+        {
+          "android": {
+            "compileSdkVersion": 31,
+            "targetSdkVersion": 31,
+            "buildToolsVersion": "31.0.0"
+          },
+          "ios": {
+            "deploymentTarget": "13.0"
+          }
+        }
+      ]
+    ]
+  }
+}
+```
+
+## Contributing
+
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide][contributing].
+
+[docs-main]: https://github.com/expo/expo/blob/main/docs/pages/versions/unversioned/sdk/build-properties.md
+[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/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./build/withBuildProperties');

package/build/android.d.ts

@@ -0,0 +1,15 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { PluginConfigType } from './pluginConfig';
+export declare const withAndroidBuildProperties: ConfigPlugin<PluginConfigType>;
+/**
+ * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
+ */
+export declare const withAndroidProguardRules: ConfigPlugin<PluginConfigType>;
+/**
+ * Update `newProguardRules` to original `proguard-rules.pro` contents if needed
+ *
+ * @param contents the original `proguard-rules.pro` contents
+ * @param newProguardRules new proguard rules to add. If the value is null, the generated proguard rules will be cleanup
+ * @returns return string when results is updated or return null when nothing changed.
+ */
+export declare function updateAndroidProguardRules(contents: string, newProguardRules: string | null): string | null;

package/build/android.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateAndroidProguardRules = exports.withAndroidProguardRules = exports.withAndroidBuildProperties = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const { createBuildGradlePropsConfigPlugin } = config_plugins_1.AndroidConfig.BuildProperties;
+exports.withAndroidBuildProperties = createBuildGradlePropsConfigPlugin([
+    {
+        propName: 'android.compileSdkVersion',
+        propValueGetter: (config) => { var _a, _b; return (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.compileSdkVersion) === null || _b === void 0 ? void 0 : _b.toString(); },
+    },
+    {
+        propName: 'android.targetSdkVersion',
+        propValueGetter: (config) => { var _a, _b; return (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.targetSdkVersion) === null || _b === void 0 ? void 0 : _b.toString(); },
+    },
+    {
+        propName: 'android.buildToolsVersion',
+        propValueGetter: (config) => { var _a; return (_a = config.android) === null || _a === void 0 ? void 0 : _a.buildToolsVersion; },
+    },
+    {
+        propName: 'android.kotlinVersion',
+        propValueGetter: (config) => { var _a; return (_a = config.android) === null || _a === void 0 ? void 0 : _a.kotlinVersion; },
+    },
+    {
+        propName: 'android.packagingOptions.pickFirsts',
+        propValueGetter: (config) => { var _a, _b, _c; return (_c = (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.packagingOptions) === null || _b === void 0 ? void 0 : _b.pickFirst) === null || _c === void 0 ? void 0 : _c.join(','); },
+    },
+    {
+        propName: 'android.packagingOptions.excludes',
+        propValueGetter: (config) => { var _a, _b, _c; return (_c = (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.packagingOptions) === null || _b === void 0 ? void 0 : _b.exclude) === null || _c === void 0 ? void 0 : _c.join(','); },
+    },
+    {
+        propName: 'android.packagingOptions.merges',
+        propValueGetter: (config) => { var _a, _b, _c; return (_c = (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.packagingOptions) === null || _b === void 0 ? void 0 : _b.merge) === null || _c === void 0 ? void 0 : _c.join(','); },
+    },
+    {
+        propName: 'android.packagingOptions.doNotStrip',
+        propValueGetter: (config) => { var _a, _b, _c; return (_c = (_b = (_a = config.android) === null || _a === void 0 ? void 0 : _a.packagingOptions) === null || _b === void 0 ? void 0 : _b.doNotStrip) === null || _c === void 0 ? void 0 : _c.join(','); },
+    },
+], 'withAndroidBuildProperties');
+/**
+ * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
+ */
+const withAndroidProguardRules = (config, props) => {
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        'android',
+        async (config) => {
+            var _a, _b;
+            const extraProguardRules = (_b = (_a = props.android) === null || _a === void 0 ? void 0 : _a.extraProguardRules) !== null && _b !== void 0 ? _b : null;
+            const proguardRulesFile = path_1.default.join(config.modRequest.platformProjectRoot, 'app', 'proguard-rules.pro');
+            const contents = await fs_1.default.promises.readFile(proguardRulesFile, 'utf8');
+            const newContents = updateAndroidProguardRules(contents, extraProguardRules);
+            if (newContents) {
+                await fs_1.default.promises.writeFile(proguardRulesFile, newContents);
+            }
+            return config;
+        },
+    ]);
+};
+exports.withAndroidProguardRules = withAndroidProguardRules;
+/**
+ * Update `newProguardRules` to original `proguard-rules.pro` contents if needed
+ *
+ * @param contents the original `proguard-rules.pro` contents
+ * @param newProguardRules new proguard rules to add. If the value is null, the generated proguard rules will be cleanup
+ * @returns return string when results is updated or return null when nothing changed.
+ */
+function updateAndroidProguardRules(contents, newProguardRules) {
+    const mergeTag = 'expo-build-properties';
+    let mergeResults;
+    if (newProguardRules) {
+        mergeResults = (0, generateCode_1.mergeContents)({
+            tag: mergeTag,
+            src: contents,
+            newSrc: newProguardRules,
+            anchor: /^/,
+            offset: contents.length,
+            comment: '#',
+        });
+    }
+    else {
+        mergeResults = (0, generateCode_1.removeContents)({
+            tag: mergeTag,
+            src: contents,
+        });
+    }
+    if (mergeResults.didMerge || mergeResults.didClear) {
+        return mergeResults.contents;
+    }
+    return null;
+}
+exports.updateAndroidProguardRules = updateAndroidProguardRules;

package/build/ios.d.ts

@@ -0,0 +1,4 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+import type { PluginConfigType } from './pluginConfig';
+export declare const withIosBuildProperties: ConfigPlugin<PluginConfigType>;
+export declare const withIosDeploymentTarget: ConfigPlugin<PluginConfigType>;

package/build/ios.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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: 'ios.useFrameworks',
+        propValueGetter: (config) => { var _a; return (_a = config.ios) === null || _a === void 0 ? void 0 : _a.useFrameworks; },
+    },
+], 'withIosBuildProperties');
+const withIosDeploymentTarget = (config, props) => {
+    var _a;
+    const deploymentTarget = (_a = props.ios) === null || _a === void 0 ? void 0 : _a.deploymentTarget;
+    if (!deploymentTarget) {
+        return config;
+    }
+    // Updates deployment target in app xcodeproj
+    config = withIosDeploymentTargetXcodeProject(config, { deploymentTarget });
+    // Updates deployement target in Podfile (Pods project)
+    config = withIosDeploymentTargetPodfile(config, props);
+    return config;
+};
+exports.withIosDeploymentTarget = withIosDeploymentTarget;
+const withIosDeploymentTargetXcodeProject = (config, props) => {
+    return (0, config_plugins_1.withXcodeProject)(config, (config) => {
+        config.modResults = updateDeploymentTargetXcodeProject(config.modResults, props.deploymentTarget);
+        return config;
+    });
+};
+function updateDeploymentTargetXcodeProject(project, deploymentTarget) {
+    const { Target } = config_plugins_1.IOSConfig;
+    const targetBuildConfigListIds = Target.getNativeTargets(project)
+        .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)) {
+            const { buildSettings } = configurations;
+            if (buildSettings === null || buildSettings === void 0 ? void 0 : buildSettings.IPHONEOS_DEPLOYMENT_TARGET) {
+                buildSettings.IPHONEOS_DEPLOYMENT_TARGET = deploymentTarget;
+            }
+        }
+    }
+    return project;
+}
+const withIosDeploymentTargetPodfile = createBuildPodfilePropsConfigPlugin([
+    {
+        propName: 'ios.deploymentTarget',
+        propValueGetter: (config) => { var _a; return (_a = config.ios) === null || _a === void 0 ? void 0 : _a.deploymentTarget; },
+    },
+], 'withIosDeploymentTargetPodfile');

package/build/pluginConfig.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configuration for `expo-build-properties`
+ */
+export interface PluginConfigType {
+    android?: PluginConfigTypeAndroid;
+    ios?: PluginConfigTypeIos;
+}
+/**
+ * Config for Android native build properties
+ */
+export interface PluginConfigTypeAndroid {
+    /** Override the default `compileSdkVersion` version number in `build.gradle` */
+    compileSdkVersion?: number;
+    /** Override the default `targetSdkVersion` version number in `build.gradle` */
+    targetSdkVersion?: number;
+    /** Override the default `buildToolsVersion` version number in `build.gradle` */
+    buildToolsVersion?: string;
+    /** Override the default Kotlin version when building the app */
+    kotlinVersion?: string;
+    /** Enable Proguard (R8) 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` */
+    extraProguardRules?: string;
+    /** AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions) */
+    packagingOptions?: PluginConfigTypeAndroidPackagingOptions;
+}
+/**
+ * Config for iOS native build properties
+ */
+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
+     */
+    deploymentTarget?: string;
+    /** Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang) in `Podfile` */
+    useFrameworks?: 'static' | 'dynamic';
+}
+/**
+ * AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions)
+ */
+export interface PluginConfigTypeAndroidPackagingOptions {
+    /** Adds a first-pick pattern */
+    pickFirst?: string[];
+    /** Adds an excluded pattern */
+    exclude?: string[];
+    /** Adds a merge pattern */
+    merge?: string[];
+    /** Adds a doNotStrip pattern */
+    doNotStrip?: string[];
+}
+/**
+ * @ignore
+ */
+export declare function validateConfig(config: any): PluginConfigType;

package/build/pluginConfig.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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
+ * @ignore
+ */
+const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
+    android: {
+        compileSdkVersion: 31,
+        targetSdkVersion: 31,
+        kotlinVersion: '1.6.10',
+    },
+    ios: {
+        deploymentTarget: '12.0',
+    },
+};
+const schema = {
+    type: 'object',
+    properties: {
+        android: {
+            type: 'object',
+            properties: {
+                compileSdkVersion: { type: 'integer', nullable: true },
+                targetSdkVersion: { type: 'integer', nullable: true },
+                buildToolsVersion: { type: 'string', nullable: true },
+                kotlinVersion: { type: 'string', nullable: true },
+                enableProguardInReleaseBuilds: { type: 'boolean', nullable: true },
+                extraProguardRules: { type: 'string', nullable: true },
+                packagingOptions: {
+                    type: 'object',
+                    properties: {
+                        pickFirst: { type: 'array', items: { type: 'string' }, nullable: true },
+                        exclude: { type: 'array', items: { type: 'string' }, nullable: true },
+                        merge: { type: 'array', items: { type: 'string' }, nullable: true },
+                        doNotStrip: { type: 'array', items: { type: 'string' }, nullable: true },
+                    },
+                    nullable: true,
+                },
+            },
+            nullable: true,
+        },
+        ios: {
+            type: 'object',
+            properties: {
+                deploymentTarget: { type: 'string', pattern: '\\d+\\.\\d+', nullable: true },
+                useFrameworks: { type: 'string', enum: ['static', 'dynamic'], nullable: true },
+            },
+            nullable: true,
+        },
+    },
+};
+/**
+ * Check versions to meet 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
+ * @ignore
+ */
+function maybeThrowInvalidVersions(config) {
+    var _a, _b, _c, _d, _e, _f;
+    const checkItems = [
+        {
+            name: 'android.compileSdkVersion',
+            configVersion: (_a = config.android) === null || _a === void 0 ? void 0 : _a.compileSdkVersion,
+            minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.compileSdkVersion,
+        },
+        {
+            name: 'android.targetSdkVersion',
+            configVersion: (_b = config.android) === null || _b === void 0 ? void 0 : _b.targetSdkVersion,
+            minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.targetSdkVersion,
+        },
+        {
+            name: 'android.kotlinVersion',
+            configVersion: (_c = config.android) === null || _c === void 0 ? void 0 : _c.kotlinVersion,
+            minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.kotlinVersion,
+        },
+        {
+            name: 'ios.deploymentTarget',
+            configVersion: (_d = config.ios) === null || _d === void 0 ? void 0 : _d.deploymentTarget,
+            minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.ios.deploymentTarget,
+        },
+    ];
+    for (const { name, configVersion, minimalVersion } of checkItems) {
+        if (typeof configVersion === 'number' &&
+            typeof minimalVersion === 'number' &&
+            configVersion < minimalVersion) {
+            throw new Error(`\`${name}\` needs to be at least version ${minimalVersion}.`);
+        }
+        if (typeof configVersion === 'string' &&
+            typeof minimalVersion === 'string' &&
+            semver_1.default.lt((_e = semver_1.default.coerce(configVersion)) !== null && _e !== void 0 ? _e : '0.0.0', (_f = semver_1.default.coerce(minimalVersion)) !== null && _f !== void 0 ? _f : '0.0.0')) {
+            throw new Error(`\`${name}\` needs to be at least version ${minimalVersion}.`);
+        }
+    }
+}
+/**
+ * @ignore
+ */
+function validateConfig(config) {
+    const validate = new ajv_1.default().compile(schema);
+    if (!validate(config)) {
+        throw new Error('Invalid expo-build-properties config: ' + JSON.stringify(validate.errors));
+    }
+    maybeThrowInvalidVersions(config);
+    return config;
+}
+exports.validateConfig = validateConfig;

package/build/withBuildProperties.d.ts

@@ -0,0 +1,10 @@
+import type { 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
+ */
+export declare const withBuildProperties: ConfigPlugin<PluginConfigType>;
+export default withBuildProperties;

package/build/withBuildProperties.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withBuildProperties = void 0;
+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
+ */
+const withBuildProperties = (config, props) => {
+    const pluginConfig = (0, pluginConfig_1.validateConfig)(props || {});
+    config = (0, android_1.withAndroidBuildProperties)(config, pluginConfig);
+    config = (0, android_1.withAndroidProguardRules)(config, pluginConfig);
+    config = (0, ios_1.withIosBuildProperties)(config, pluginConfig);
+    config = (0, ios_1.withIosDeploymentTarget)(config, pluginConfig);
+    return config;
+};
+exports.withBuildProperties = withBuildProperties;
+exports.default = exports.withBuildProperties;

package/jest.config.js

@@ -0,0 +1 @@
+module.exports = require('expo-module-scripts/jest-preset-plugin');

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "expo-build-properties",
+  "version": "0.0.0",
+  "description": "Config plugin to customize native build properties on prebuild",
+  "main": "build/withBuildProperties.js",
+  "types": "build/withBuildProperties.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "build",
+    "build-properties"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/expo/expo.git",
+    "directory": "packages/expo-build-properties"
+  },
+  "bugs": {
+    "url": "https://github.com/expo/expo/issues"
+  },
+  "author": "650 Industries, Inc.",
+  "license": "MIT",
+  "homepage": "https://docs.expo.dev/versions/latest/sdk/build-properties",
+  "dependencies": {
+    "@expo/config-plugins": "~4.1.4",
+    "ajv": "^8.11.0",
+    "semver": "^7.3.5"
+  },
+  "devDependencies": {
+    "expo-module-scripts": "^2.0.0"
+  },
+  "jest": {
+    "preset": "expo-module-scripts"
+  },
+  "peerDependencies": {
+    "expo": "*"
+  },
+  "gitHead": "6720e2f264c7439062be002ea343f33090aa89f8"
+}

package/src/android.ts

@@ -0,0 +1,110 @@
+import { AndroidConfig, ConfigPlugin, withDangerousMod } from '@expo/config-plugins';
+import {
+  mergeContents,
+  removeContents,
+  MergeResults,
+} from '@expo/config-plugins/build/utils/generateCode';
+import fs from 'fs';
+import path from 'path';
+
+import type { PluginConfigType } from './pluginConfig';
+
+const { createBuildGradlePropsConfigPlugin } = AndroidConfig.BuildProperties;
+
+export const withAndroidBuildProperties = createBuildGradlePropsConfigPlugin<PluginConfigType>(
+  [
+    {
+      propName: 'android.compileSdkVersion',
+      propValueGetter: (config) => config.android?.compileSdkVersion?.toString(),
+    },
+    {
+      propName: 'android.targetSdkVersion',
+      propValueGetter: (config) => config.android?.targetSdkVersion?.toString(),
+    },
+    {
+      propName: 'android.buildToolsVersion',
+      propValueGetter: (config) => config.android?.buildToolsVersion,
+    },
+    {
+      propName: 'android.kotlinVersion',
+      propValueGetter: (config) => config.android?.kotlinVersion,
+    },
+    {
+      propName: 'android.packagingOptions.pickFirsts',
+      propValueGetter: (config) => config.android?.packagingOptions?.pickFirst?.join(','),
+    },
+    {
+      propName: 'android.packagingOptions.excludes',
+      propValueGetter: (config) => config.android?.packagingOptions?.exclude?.join(','),
+    },
+    {
+      propName: 'android.packagingOptions.merges',
+      propValueGetter: (config) => config.android?.packagingOptions?.merge?.join(','),
+    },
+    {
+      propName: 'android.packagingOptions.doNotStrip',
+      propValueGetter: (config) => config.android?.packagingOptions?.doNotStrip?.join(','),
+    },
+  ],
+  'withAndroidBuildProperties'
+);
+
+/**
+ * Appends `props.android.extraProguardRules` content into `android/app/proguard-rules.pro`
+ */
+export const withAndroidProguardRules: ConfigPlugin<PluginConfigType> = (config, props) => {
+  return withDangerousMod(config, [
+    'android',
+    async (config) => {
+      const extraProguardRules = props.android?.extraProguardRules ?? null;
+      const proguardRulesFile = path.join(
+        config.modRequest.platformProjectRoot,
+        'app',
+        'proguard-rules.pro'
+      );
+
+      const contents = await fs.promises.readFile(proguardRulesFile, 'utf8');
+      const newContents = updateAndroidProguardRules(contents, extraProguardRules);
+      if (newContents) {
+        await fs.promises.writeFile(proguardRulesFile, newContents);
+      }
+      return config;
+    },
+  ]);
+};
+
+/**
+ * Update `newProguardRules` to original `proguard-rules.pro` contents if needed
+ *
+ * @param contents the original `proguard-rules.pro` contents
+ * @param newProguardRules new proguard rules to add. If the value is null, the generated proguard rules will be cleanup
+ * @returns return string when results is updated or return null when nothing changed.
+ */
+export function updateAndroidProguardRules(
+  contents: string,
+  newProguardRules: string | null
+): string | null {
+  const mergeTag = 'expo-build-properties';
+
+  let mergeResults: MergeResults;
+  if (newProguardRules) {
+    mergeResults = mergeContents({
+      tag: mergeTag,
+      src: contents,
+      newSrc: newProguardRules,
+      anchor: /^/,
+      offset: contents.length,
+      comment: '#',
+    });
+  } else {
+    mergeResults = removeContents({
+      tag: mergeTag,
+      src: contents,
+    });
+  }
+
+  if (mergeResults.didMerge || mergeResults.didClear) {
+    return mergeResults.contents;
+  }
+  return null;
+}

package/src/ios.ts

@@ -0,0 +1,77 @@
+import { IOSConfig, ConfigPlugin, withXcodeProject, XcodeProject } from '@expo/config-plugins';
+
+import type { PluginConfigType } from './pluginConfig';
+
+const { createBuildPodfilePropsConfigPlugin } = IOSConfig.BuildProperties;
+
+export const withIosBuildProperties = createBuildPodfilePropsConfigPlugin<PluginConfigType>(
+  [
+    {
+      propName: 'ios.useFrameworks',
+      propValueGetter: (config) => config.ios?.useFrameworks,
+    },
+  ],
+  'withIosBuildProperties'
+);
+
+export const withIosDeploymentTarget: ConfigPlugin<PluginConfigType> = (config, props) => {
+  const deploymentTarget = props.ios?.deploymentTarget;
+  if (!deploymentTarget) {
+    return config;
+  }
+
+  // Updates deployment target in app xcodeproj
+  config = withIosDeploymentTargetXcodeProject(config, { deploymentTarget });
+
+  // Updates deployement target in Podfile (Pods project)
+  config = withIosDeploymentTargetPodfile(config, props);
+
+  return config;
+};
+
+const withIosDeploymentTargetXcodeProject: ConfigPlugin<{ deploymentTarget: string }> = (
+  config,
+  props
+) => {
+  return withXcodeProject(config, (config) => {
+    config.modResults = updateDeploymentTargetXcodeProject(
+      config.modResults,
+      props.deploymentTarget
+    );
+    return config;
+  });
+};
+
+function updateDeploymentTargetXcodeProject(
+  project: XcodeProject,
+  deploymentTarget: string
+): XcodeProject {
+  const { Target } = IOSConfig;
+  const targetBuildConfigListIds = Target.getNativeTargets(project)
+    .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 IOSConfig.XcodeUtils.getBuildConfigurationsForListId(
+      project,
+      buildConfigListId
+    )) {
+      const { buildSettings } = configurations;
+      if (buildSettings?.IPHONEOS_DEPLOYMENT_TARGET) {
+        buildSettings.IPHONEOS_DEPLOYMENT_TARGET = deploymentTarget;
+      }
+    }
+  }
+  return project;
+}
+
+const withIosDeploymentTargetPodfile = createBuildPodfilePropsConfigPlugin<PluginConfigType>(
+  [
+    {
+      propName: 'ios.deploymentTarget',
+      propValueGetter: (config) => config.ios?.deploymentTarget,
+    },
+  ],
+  'withIosDeploymentTargetPodfile'
+);

package/src/pluginConfig.ts

@@ -0,0 +1,184 @@
+import Ajv, { JSONSchemaType } from 'ajv';
+import semver from 'semver';
+
+/**
+ * The minimal supported versions. These values should align to SDK
+ * @ignore
+ */
+const EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS = {
+  android: {
+    compileSdkVersion: 31,
+    targetSdkVersion: 31,
+    kotlinVersion: '1.6.10',
+  },
+  ios: {
+    deploymentTarget: '12.0',
+  },
+};
+
+/**
+ * Configuration for `expo-build-properties`
+ */
+export interface PluginConfigType {
+  android?: PluginConfigTypeAndroid;
+  ios?: PluginConfigTypeIos;
+}
+
+/**
+ * Config for Android native build properties
+ */
+export interface PluginConfigTypeAndroid {
+  /** Override the default `compileSdkVersion` version number in `build.gradle` */
+  compileSdkVersion?: number;
+
+  /** Override the default `targetSdkVersion` version number in `build.gradle` */
+  targetSdkVersion?: number;
+
+  /** Override the default `buildToolsVersion` version number in `build.gradle` */
+  buildToolsVersion?: string;
+
+  /** Override the default Kotlin version when building the app */
+  kotlinVersion?: string;
+
+  /** Enable Proguard (R8) 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` */
+  extraProguardRules?: string;
+
+  /** AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions) */
+  packagingOptions?: PluginConfigTypeAndroidPackagingOptions;
+}
+
+/**
+ * Config for iOS native build properties
+ */
+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
+   */
+  deploymentTarget?: string;
+
+  /** Enable [`use_frameworks!`](https://guides.cocoapods.org/syntax/podfile.html#use_frameworks_bang) in `Podfile` */
+  useFrameworks?: 'static' | 'dynamic';
+}
+
+/**
+ * AGP [PackagingOptions](https://developer.android.com/reference/tools/gradle-api/7.0/com/android/build/api/dsl/PackagingOptions)
+ */
+export interface PluginConfigTypeAndroidPackagingOptions {
+  /** Adds a first-pick pattern */
+  pickFirst?: string[];
+
+  /** Adds an excluded pattern */
+  exclude?: string[];
+
+  /** Adds a merge pattern */
+  merge?: string[];
+
+  /** Adds a doNotStrip pattern */
+  doNotStrip?: string[];
+}
+
+const schema: JSONSchemaType<PluginConfigType> = {
+  type: 'object',
+  properties: {
+    android: {
+      type: 'object',
+      properties: {
+        compileSdkVersion: { type: 'integer', nullable: true },
+        targetSdkVersion: { type: 'integer', nullable: true },
+        buildToolsVersion: { type: 'string', nullable: true },
+        kotlinVersion: { type: 'string', nullable: true },
+
+        enableProguardInReleaseBuilds: { type: 'boolean', nullable: true },
+        extraProguardRules: { type: 'string', nullable: true },
+
+        packagingOptions: {
+          type: 'object',
+          properties: {
+            pickFirst: { type: 'array', items: { type: 'string' }, nullable: true },
+            exclude: { type: 'array', items: { type: 'string' }, nullable: true },
+            merge: { type: 'array', items: { type: 'string' }, nullable: true },
+            doNotStrip: { type: 'array', items: { type: 'string' }, nullable: true },
+          },
+          nullable: true,
+        },
+      },
+      nullable: true,
+    },
+    ios: {
+      type: 'object',
+      properties: {
+        deploymentTarget: { type: 'string', pattern: '\\d+\\.\\d+', nullable: true },
+        useFrameworks: { type: 'string', enum: ['static', 'dynamic'], nullable: true },
+      },
+      nullable: true,
+    },
+  },
+};
+
+/**
+ * Check versions to meet 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
+ * @ignore
+ */
+function maybeThrowInvalidVersions(config: PluginConfigType) {
+  const checkItems = [
+    {
+      name: 'android.compileSdkVersion',
+      configVersion: config.android?.compileSdkVersion,
+      minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.compileSdkVersion,
+    },
+    {
+      name: 'android.targetSdkVersion',
+      configVersion: config.android?.targetSdkVersion,
+      minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.targetSdkVersion,
+    },
+    {
+      name: 'android.kotlinVersion',
+      configVersion: config.android?.kotlinVersion,
+      minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.android.kotlinVersion,
+    },
+    {
+      name: 'ios.deploymentTarget',
+      configVersion: config.ios?.deploymentTarget,
+      minimalVersion: EXPO_SDK_MINIMAL_SUPPORTED_VERSIONS.ios.deploymentTarget,
+    },
+  ];
+
+  for (const { name, configVersion, minimalVersion } of checkItems) {
+    if (
+      typeof configVersion === 'number' &&
+      typeof minimalVersion === 'number' &&
+      configVersion < minimalVersion
+    ) {
+      throw new Error(`\`${name}\` needs to be at least version ${minimalVersion}.`);
+    }
+    if (
+      typeof configVersion === 'string' &&
+      typeof minimalVersion === 'string' &&
+      semver.lt(semver.coerce(configVersion) ?? '0.0.0', semver.coerce(minimalVersion) ?? '0.0.0')
+    ) {
+      throw new Error(`\`${name}\` needs to be at least version ${minimalVersion}.`);
+    }
+  }
+}
+
+/**
+ * @ignore
+ */
+export function validateConfig(config: any): PluginConfigType {
+  const validate = new Ajv().compile(schema);
+  if (!validate(config)) {
+    throw new Error('Invalid expo-build-properties config: ' + JSON.stringify(validate.errors));
+  }
+
+  maybeThrowInvalidVersions(config);
+  return config;
+}

package/src/withBuildProperties.ts

@@ -0,0 +1,24 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+
+import { withAndroidBuildProperties, withAndroidProguardRules } 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
+ */
+export const withBuildProperties: ConfigPlugin<PluginConfigType> = (config, props) => {
+  const pluginConfig = validateConfig(props || {});
+
+  config = withAndroidBuildProperties(config, pluginConfig);
+  config = withAndroidProguardRules(config, pluginConfig);
+  config = withIosBuildProperties(config, pluginConfig);
+  config = withIosDeploymentTarget(config, pluginConfig);
+
+  return config;
+};
+
+export default withBuildProperties;

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "expo-module-scripts/tsconfig.plugin",
+  "compilerOptions": {
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*"]
+}