跳到主要内容

Codegen CLI

调用 Gradle 或手动调用脚本可能难以记住,并且需要大量繁琐的步骤。

为了简化操作,我们创建了一个 CLI 工具来帮助您运行这些任务:**Codegen** cli。此命令会为您的项目运行 @react-native/codegen。以下选项可用

sh
npx @react-native-community/cli codegen --help
Usage: rnc-cli codegen [options]

Options:
--verbose Increase logging verbosity
--path <path> Path to the React Native project root. (default: "/Users/MyUsername/projects/my-app")
--platform <string> Target platform. Supported values: "android", "ios", "all". (default: "all")
--outputPath <path> Path where generated artifacts will be output to.
-h, --help display help for command

示例

  • 从当前工作目录读取 package.json,根据其 codegenConfig 生成代码。
shell
npx @react-native-community/cli codegen
  • 从当前工作目录读取 package.json,在 codegenConfig 中定义的位置生成 iOS 代码。
shell
npx @react-native-community/cli codegen --platform ios
  • third-party/some-library 读取 package.json,在 third-party/some-library/android/generated 中生成 Android 代码。
shell
npx @react-native-community/cli codegen \
--path third-party/some-library \
--platform android \
--outputPath third-party/some-library/android/generated

将生成的代码包含到库中

Codegen CLI 是一个出色的工具,适用于库开发者。它可用于预览生成的代码,以了解您需要实现哪些接口。

通常,生成的代码不包含在库中,并且使用该库的应用程序负责在构建时运行 Codegen。这在大多数情况下是一个不错的设置,但 Codegen 也提供了一种机制,可以通过 includesGeneratedCode 属性将生成的代码包含在库本身中。

了解使用 includesGeneratedCode = true 的影响非常重要。包含生成的代码具有以下几个好处:

  • 无需依赖应用程序为您运行 **Codegen**,生成的代码始终存在。
  • 实现文件始终与生成的接口保持一致(这使得您的库代码在 codegen API 更改时更具弹性)。
  • 无需包含两套文件来支持 Android 上的两种架构。您只需保留新架构的那一套,并且它保证向后兼容。
  • 由于所有原生代码都已存在,因此可以将库的原生部分作为预构建版本发布。

另一方面,您还需要注意一个缺点

  • 生成的代码将使用您库中定义的 React Native 版本。因此,如果您的库是随 React Native 0.76 一起发布的,那么生成的代码将基于该版本。这可能意味着生成的代码与使用应用程序所用**先前**React Native 版本的应用程序不兼容(例如,运行在 React Native 0.75 上的应用程序)。

启用 includesGeneratedCode

要启用此设置

  • 在您的库的 package.json 文件中,将 includesGeneratedCode 属性添加到 codegenConfig 字段。将其值设置为 true
  • 使用 codegen CLI 在本地运行 **Codegen**。
  • 更新您的 package.json 以包含生成的代码。
  • 更新您的 podspec 以包含生成的代码。
  • 更新您的 build.Gradle 文件以包含生成的代码。
  • 更新 react-native.config.js 中的 cmakeListsPath,以便 Gradle 不在构建目录中查找 CMakeLists 文件,而是在您的 outputDir 中查找。