自动链接

searchPaths

一个路径列表，相对于应用的根目录，Expo 自动链接应搜索以进行模块自动链接。 在您的项目具有自定义结构或您想要链接来自于与 node_modules 不同目录的本地包时很有用。 您指定的路径仍然必须像 node_modules 目录那样结构化。

{
  "expo": {
    "autolinking": {
      "searchPaths": ["../../packages"]
    }
  }
}

在 SDK 54 之前，此列表默认指向您应用的 node_modules 目录，以及在单体仓库中高于它的所有 node_modules 目录。 要恢复为旧行为，请将此列表设置为您应用的 node_modules 目录，例如：["../../node_modules", "./node_modules"]。

nativeModulesDir

一个路径，相对于应用的根目录，Expo 自动链接应搜索以进行本地模块的自动链接。此选项默认为 "./modules"。更改此选项仅在您需要更改 本地 Expo 模块 的路径时有用。

{
  "expo": {
    "autolinking": {
      "nativeModulesDir": "./modules"
    }
  }
}

exclude

一个要从自动链接中排除的包名称列表。如果您不想链接某些特定平台不使用的包以减少二进制大小，这很有用。 以下在 package.json 中的配置将在 Android 上排除 expo-random 和 third-party-expo-module 的自动链接：

{
  "expo": {
    "autolinking": {
      "android": {
        "exclude": ["expo-random", "third-party-expo-module"]
      }
    }
  }
}

React Native 模块也可以通过在项目的根目录中创建 react-native.config.js 并将应排除的平台配置设置为 null 来排除。以下配置将在 Android 上排除 library-name 的自动链接：

module.exports = {
  dependencies: {
    'library-name': {
      platforms: {
        android: null,
      },
    },
  },
};

在 SDK 54 之前，exclude 选项仅适用于 Expo 模块，而不适用于 React Native 模块。React Native 模块只能通过在您项目的根目录中使用 react-native.config.js 文件进行排除。

flags

传递给每个自动链接的 pod 的 CocoaPods 标志。 inhibit_warnings 可能是大多数开发人员希望使用的唯一标志，以抑制编译自动链接模块时产生的 Xcode 警告。 您可以参考 CocoaPods Podfile 文档 获取可用的标志。

use_expo_modules!({
  flags: {
    :inhibit_warnings => false
  }
})

{
  "expo": {
    "autolinking": {
      "ios": {
        "flags": {
          "inhibit_warnings": true
        }
      }
    }
  }
}

buildFromSource

一个要选择退出预构建 Expo 模块的包名称列表。完整参考，请参见 为 Android 选择退出预构建 Expo 模块.

legacy_shallowReactNativeLinking

在解析您的应用的 React Native 模块时，Expo 自动链接搜索您的应用的依赖以及这些依赖的依赖（符合 Node.js 解析算法）。在 SDK 54 之前，Expo 自动链接未递归搜索依赖项，仅解析您应用的直接依赖。

启用时，此标志让您选择退出新行为，并恢复到 SDK 54 之前的行为，仅搜索您应用的直接依赖项以查找 React Native 模块。此选项在解析 Expo 模块时不予考虑。

search

此命令由构建系统调用以在自动链接的第一阶段解析 Expo 模块。其实现与所有平台共享。 search 的输出将包含每个包的 duplicates 列表（如果找到任何重复）。

上述命令返回一个 JSON 格式的对象，包含 Expo 自动链接找到的 Expo 模块：

{
  "expo-random": {
    "path": "/absolute/path/to/node_modules/expo-random",
    "version": "13.0.0",
    "config": {
      // `expo-module.config.json` 的内容
    },
    "duplicates": [
      // 此模块的冲突重复项列表（优先级较低）
    ]
  }
  // 更多模块...
}

resolve

此命令在自动链接的第二阶段由构建系统调用。它输出每个 Expo 模块的更多（特定平台）详细信息，例如 build.gradle 或 podspec 文件的路径和需要链接的模块类。

例如，使用 --platform apple 选项，它以 JSON 格式返回一个对象，其中包含模块和该平台的解析详细信息的数组：

{
  "modules": [
    {
      "packageName": "expo-random",
      "packageVersion": "13.0.0",
      "pods": [
        {
          "podName": "ExpoRandom",
          "podspecDir": "/absolute/path/to/node_modules/expo-random/ios"
        }
      ],
      "swiftModuleNames": ["ExpoRandom"],
      "modules": ["RandomModule"],
      "appDelegateSubscribers": [],
      "reactDelegateHandlers": [],
      "debugOnly": false
    }
    // 更多模块...
  ]
}

verify

验证自动链接的原生模块，通过检查重复项。对于每个冲突的重复安装，会显示警告。

传递 --verbose 选项以列出所有自动链接的原生模块。

react-native-config

此命令在自动链接 React Native 模块时由构建系统调用。它输出每个 React Native 模块的更多特定平台详细信息，例如 gradle 或 podspec 文件的路径。

例如，使用 --platform ios 选项，它返回一个 react-native.config.js 输出格式的对象，包含每个 React Native 依赖项的信息及其 React Native 安装的路径。

{
  "root": "/absolute/path/to",
  "reactNativePath": "/absolute/path/to/node_modules/react-native",
  "dependencies": {
    "@react-native-async-storage/async-storage": {
      "root": "/absolute/path/to/node_modules/@react-native-async-storage/async-storage",
      "name": "@react-native-async-storage/async-storage",
      "platforms": {
        "ios": {
          "podspecPath": "/absolute/path/to/node_modules/@react-native-async-storage/async-storage/RNCAsyncStorage.podspec",
          "version": "",
          "configurations": [],
          "scriptPhases": []
        }
      }
    }
    // 更多模块...
  }
}