使用库
React Native 提供了一套内置的核心组件和 API,可供您的应用使用。您不限于 React Native 附带的组件和 API。React Native 拥有一个由数千名开发者组成的社区。如果核心组件和 API 没有您想要的功能,您可以从社区中找到并安装一个库,以将功能添加到您的应用中。
选择包管理器
React Native 库通常使用 Node.js 包管理器(例如npm CLI或Yarn Classic)从npm 注册表安装。
如果您的计算机上安装了 Node.js,那么您已经安装了 npm CLI。一些开发者更喜欢使用 Yarn Classic,因为它安装速度稍快,并提供工作区等额外的进阶功能。这两种工具都与 React Native 完美兼容。为了简化解释,本指南的其余部分将以 npm 为例。
💡 在 JavaScript 社区中,“库”和“包”这两个术语可以互换使用。
安装库
要在项目中安装库,请在终端中导航到您的项目目录并运行安装命令。让我们以 react-native-webview
为例。
- npm
- Yarn
npm install react-native-webview
yarn add react-native-webview
我们安装的库包含原生代码,在使用之前需要将其链接到我们的应用。
在 iOS 上链接原生代码
React Native 使用 CocoaPods 管理 iOS 项目依赖项,并且大多数 React Native 库都遵循相同的约定。如果您使用的库不遵循此约定,请参阅其 README 以获取额外说明。在大多数情况下,以下说明适用。
在 ios
目录中运行 pod install
以将其链接到我们的原生 iOS 项目。无需切换到 ios
目录的快捷方式是运行 npx pod-install
。
npx pod-install
完成后,重新构建应用二进制文件即可开始使用您的新库
- npm
- Yarn
npm run ios
yarn ios
在 Android 上链接原生代码
React Native 使用 Gradle 管理 Android 项目依赖项。安装带有原生依赖项的库后,您需要重新构建应用二进制文件才能使用您的新库
- npm
- Yarn
npm run android
yarn android
查找库
React Native Directory 是一个专门为 React Native 构建的库的可搜索数据库。这是为您的 React Native 应用查找库的首选之地。
您在目录中找到的许多库都来自React Native Community 或 Expo。
由 React Native Community 构建的库由志愿者和依赖 React Native 的公司中的个人推动。它们通常支持 iOS、tvOS、Android、Windows,但这因项目而异。该组织中的许多库曾是 React Native 核心组件和 API。
由 Expo 构建的库都用 TypeScript 编写,并且尽可能支持 iOS、Android 和 react-native-web
。
在 React Native Directory 之后,如果您在目录中找不到专门用于 React Native 的库,npm 注册表是次优选择。npm 注册表是 JavaScript 库的权威来源,但它列出的库可能并非都与 React Native 兼容。React Native 是众多 JavaScript 编程环境之一,包括 Node.js、Web 浏览器、Electron 等,而 npm 包含适用于所有这些环境的库。
确定库兼容性
它与 React Native 兼容吗?
通常,专门为其他平台构建的库将无法与 React Native 配合使用。例如 react-select
专为 Web 构建并专门针对 react-dom
,以及 rimraf
专为 Node.js 构建并与您的计算机文件系统交互。其他库,如 lodash
,仅使用 JavaScript 语言特性,可在任何环境中工作。随着时间的推移,您会对此有所了解,但在那之前,最简单的方法是亲自尝试。如果发现它在 React Native 中不起作用,您可以使用 npm uninstall
删除包。
它适用于我的应用支持的平台吗?
React Native Directory 允许您按平台兼容性进行筛选,例如 iOS、Android、Web 和 Windows。如果您想使用的库目前未在此处列出,请参阅该库的 README 以了解更多信息。
它与我的 React Native 应用版本兼容吗?
库的最新版本通常与 React Native 的最新版本兼容。如果您使用的是旧版本,您应该参考 README 以了解您应该安装哪个版本的库。您可以通过运行 npm install <library-name>@<version-number>
来安装特定版本的库,例如:npm install @react-native-community/netinfo@^2.0.0
。