package.json

编辑页面

可在 package.json 文件中使用的 Expo 特定属性参考

package.json 是一个包含 JavaScript 项目元数据的 JSON 文件。本文介绍了 Expo 专用属性，可以通过在 package.json 文件中添加 expo 字段来使用这些属性。

`install.exclude`

以下命令会对项目中安装的库执行版本检查，并在库的版本不同于 Expo 推荐的版本时发出警告：

npx expo start 和 npx expo-doctor
npx expo install（安装该库的新版本，或使用 --check 或 --fix 选项时）

通过将库添加到 package.json 文件中的 install.exclude 数组，可以将其从版本检查中排除：

package.json

{
  "expo": {
    "install": {
      "exclude": ["expo-updates", "expo-splash-screen"]
    }
  }
}

`autolinking`

允许通过在 package.json 中使用 autolinking 属性来配置模块解析行为。

package.json

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

完整参考请参阅Autolinking 配置。

`doctor`

允许配置 npx expo-doctor 命令的行为。

`reactNativeDirectoryCheck`

默认情况下，Expo Doctor 会根据 React Native directory 验证项目的软件包。对于未包含在 React Native Directory 中的软件包，此检查会发出警告并列出这些软件包。

你可以通过在项目的 package.json 文件中添加以下配置来自定义此检查：

package.json

{
  "expo": {
    "doctor": {
      "reactNativeDirectoryCheck": {
        "enabled": true,
        "exclude": ["/foo/", "bar"],
        "listUnknownPackages": true
      }
    }
  }
}

默认情况下，此检查处于启用状态，并且会列出未知软件包。

`appConfigFieldsNotSyncedCheck`

Expo Doctor 会检查项目是否包含 android 或 ios 等原生项目目录。如果这些目录存在，但未列在项目的 .gitignore 或 .easignore 文件中，Expo Doctor 会验证应用配置文件是否存在。如果该文件存在，则表示你的项目已配置为使用 Prebuild。

当 android 或 ios 目录存在时，EAS Build 不会将应用配置属性同步到原生项目。如果满足这些条件，Expo Doctor 会发出警告。

你可以通过在项目的 package.json 文件中添加以下配置来禁用或启用此检查：

package.json

{
  "expo": {
    "doctor": {
      "appConfigFieldsNotSyncedCheck": {
        "enabled": false
      }
    }
  }
}