使用第三方库
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
React Native 提供了一套开箱即用的核心组件和 API，但你并不局限于使用这些内置功能。React Native 拥有数千名开发者组成的社区，如果核心组件和 API 无法满足你的需求，你可以从社区中寻找并安装库来扩展应用功能。
选择包管理器
React Native 库通常通过 Node.js 包管理器（如 npm CLI 或 Yarn Classic）从 npm 仓库安装。
安装 Node.js 时会自动包含 npm CLI。部分开发者更倾向使用 Yarn Classic，因其安装速度稍快且提供 Workspaces 等高级功能。两种工具都能完美支持 React Native。为简化说明，本指南后续将默认使用 npm。
在 JavaScript 社区中，"library"（库）和"package"（包）通常作为同义词使用。
安装库
在终端中进入项目目录，执行安装命令即可安装库。我们以安装 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 社区或 Expo。
React Native 社区库由志愿者和依赖 React Native 的公司开发者维护，通常支持 iOS/tvOS/Android/Windows（具体支持因项目而异）。该组织下许多库曾是 React Native 核心组件和 API。
Expo 构建的库均采用 TypeScript 编写，并在可能情况下支持 iOS/Android/react-native-web。
若在 React Native Directory 未找到合适库，可前往 npm 仓库继续搜索。npm 是 JavaScript 库的权威来源，但其中部分库可能不兼容 React Native。React Native 与 Node.js、网页浏览器、Electron 等共同构成 JavaScript 运行环境，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。