メインコンテンツへスキップ

ライブラリの使用

React Native は、アプリですぐに使用できる一連の組み込みのコアコンポーネントと API を提供しています。React Native にバンドルされているコンポーネントと API に限定されるわけではありません。React Native には、何千もの開発者からなるコミュニティがあります。コアコンポーネントと API に必要な機能がない場合でも、コミュニティからライブラリを見つけてインストールし、アプリに機能を追加できる場合があります。

パッケージマネージャーの選択​

React Native ライブラリは通常、npm CLI や Yarn Classic などの Node.js パッケージマネージャーを使用して、npm レジストリからインストールされます。

コンピューターに Node.js がインストールされている場合、npm CLI はすでにインストールされています。一部の開発者は、インストール時間のわずかな短縮や、Workspaces などの追加の高度な機能のために Yarn Classic を使用することを好みます。どちらのツールも React Native でうまく機能します。説明を簡単にするため、このガイドの残りの部分では npm を使用するものとします。

注

「ライブラリ」と「パッケージ」という用語は、JavaScript コミュニティでは同じ意味で使用されます。

ライブラリのインストール​

プロジェクトにライブラリをインストールするには、ターミナルでプロジェクトディレクトリに移動し、インストールコマンドを実行します。react-native-webview で試してみましょう。

shell
npm install react-native-webview

インストールしたライブラリにはネイティブコードが含まれており、使用する前にアプリにリンクする必要があります。

iOS でのネイティブコードのリンク​

React Native は CocoaPods を使用して iOS プロジェクトの依存関係を管理しており、ほとんどの React Native ライブラリもこの慣例に従っています。使用しているライブラリがこれに従わない場合は、追加の指示についてその README を参照してください。ほとんどの場合、以下の指示が適用されます。

ネイティブ iOS プロジェクトにリンクするために、ios ディレクトリで pod install を実行します。ios ディレクトリに切り替えずにこれを行うショートカットは、npx pod-install を実行することです。

bash
npx pod-install

これが完了したら、アプリのバイナリを再ビルドして、新しいライブラリの使用を開始します。

shell
npm run ios

Android でのネイティブコードのリンク​

React Native は Gradle を使用して Android プロジェクトの依存関係を管理します。ネイティブ依存関係を持つライブラリをインストールした後、新しいライブラリを使用するには、アプリのバイナリを再ビルドする必要があります。

shell
npm run android

ライブラリの検索​

React Native Directory は、React Native 専用に構築されたライブラリの検索可能なデータベースです。React Native アプリ用のライブラリを探すには、ここが最初の場所です。

ディレクトリで見つかるライブラリの多くは、React Native Community または Expo からのものです。

React Native Community によって構築されたライブラリは、ボランティアと React Native に依存する企業の個人によって推進されています。多くの場合、iOS、tvOS、Android、Windows をサポートしますが、これはプロジェクトによって異なります。この組織のライブラリの多くは、かつて React Native Core Components および API でした。

Expo によって構築されたライブラリはすべて TypeScript で記述されており、可能な限り iOS、Android、および react-native-web をサポートしています。

React Native Directory の次に、ディレクトリで React Native 専用のライブラリが見つからない場合は、npm レジストリが次善の場所です。npm レジストリは JavaScript ライブラリの決定的な情報源ですが、リストされているすべてのライブラリが React Native と互換性があるとは限りません。React Native は、Node.js、Web ブラウザー、Electron など、多くの JavaScript プログラミング環境の 1 つであり、npm にはこれらのすべての環境で機能するライブラリが含まれています。

ライブラリの互換性の判断​

React Native で動作しますか？​

通常、_他のプラットフォーム専用に_構築されたライブラリは React Native では動作しません。例としては、Web 用に構築され、特に react-dom をターゲットとする react-select や、Node.js 用に構築され、コンピューターのファイルシステムとやり取りする rimraf などがあります。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。