序章

Yarn は、 Node.js のパッケージマネージャーであり、速度、セキュリティ、一貫性に重点を置いています。 もともとは、人気のあるNPMパッケージマネージャーのいくつかの問題に対処するために作成されました。 その後、2つのパッケージマネージャーはパフォーマンスと機能の点で収束しましたが、Yarnは、特にReact開発の世界で人気があります。

ヤーンのユニークな機能のいくつかは次のとおりです。

  • プロジェクトごとのキャッシュメカニズム。これにより、後続のインストールとビルドを大幅に高速化できます。
  • インストールされたライブラリの構造が常に同じであることを保証する、一貫性のある決定論的なインストール
  • すべてのパッケージのチェックサムテストにより、それらの整合性を検証します
  • モノリポジトリ（単一のソースコードリポジトリで開発された複数のプロジェクト）でのYarnの使用を容易にする「ワークスペース」

このチュートリアルでは、Yarnをグローバルにインストールし、特定のプロジェクトにYarnを追加し、いくつかの基本的なYarnコマンドを学習します。

前提条件

Yarnパッケージマネージャーをインストールして使用する前に、Node.jsをインストールする必要があります。 Node.jsがすでにインストールされているかどうかを確認するには、ローカルコマンドラインターミナルに次のコマンドを入力します。

  1. node -v

次のようなバージョン番号が表示された場合 v12.16.3 印刷すると、Node.jsがインストールされます。 あなたが得る場合 command not found エラー（または同様の言い回し）の場合は、続行する前にNode.jsをインストールしてください。

Node.jsをインストールするには、 Ubuntu 、 Debian 、 CentOS 、またはmacOSのチュートリアルに従ってください。

Node.jsをインストールしたら、手順1に進んでYarnパッケージマネージャーをインストールします。

ステップ1—Yarnをグローバルにインストールする

Yarnには、JavaScriptプロジェクトにそれ自体をインストールして実行する独自の方法があります。 まず、 yarn グローバルにコマンドを実行し、グローバルを使用します yarn Yarnの特定のローカルバージョンをプロジェクトディレクトリにインストールするコマンド。 これは、プロジェクト（およびプロジェクトの自動テストおよびデプロイメントツールのすべて）で作業しているすべての人がまったく同じバージョンのを実行していることを確認するために必要です。 yarn、一貫性のない動作と結果を回避するため。

Yarnのメンテナは、すべてのNode.jsインストールにデフォルトで含まれているNPMパッケージマネージャーを使用して、Yarnをグローバルにインストールすることをお勧めします。 使用 -g フラグ npm install これをする：

  1. sudo npm install -g yarn

パッケージがインストールされたら、 yarn コマンドは、独自のバージョン番号を出力します。 これにより、正しくインストールされたことを確認できます。

  1. yarn --version



Output
1.22.11

今、あなたは yarn コマンドはグローバルにインストールされ、特定のJavaScriptプロジェクトにYarnをインストールするために使用できます。

ステップ2—プロジェクトにYarnをインストールする

Yarnを使用して既存のYarnベースのプロジェクトを操作している場合は、この手順をスキップできます。 プロジェクトは、ローカルバージョンのYarnと、それを使用するために必要なすべての構成ファイルで既にセットアップされている必要があります。

独自の新しいプロジェクトをセットアップする場合は、プロジェクト固有のバージョンのYarnを今すぐ構成する必要があります。

まず、プロジェクトディレクトリに移動します。

  1. cd ~/my-project

プロジェクトディレクトリがない場合は、次のコマンドで新しいディレクトリを作成できます。 mkdir そしてそれに移動します：

  1. mkdir my-project

  2. cd my-project

今使用します yarn set バージョンをに設定するコマンド berry:

  1. yarn set version berry

これにより、現在アクティブに開発されているバージョンのYarnがダウンロードされます– berry –保存します .yarn/releases/ プロジェクト内のディレクトリを設定し、 .yarnrc.yml 構成ファイルも：

Output
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!

今試してみてください yarn --version もう一度コマンド：

  1. yarn --version



Output
3.0.0

バージョンが表示されます 3.0.0 以上。 これはYarnの最新リリースです。

注： cd プロジェクトディレクトリから実行します yarn --version 繰り返しになりますが、グローバルヤーンのバージョン番号をもう一度取得します。 1.22.11 この場合。 走るたびに yarn、グローバルにインストールされたバージョンのコマンドを使用しています。 グローバル yarn コマンドは最初に、それがYarnプロジェクトディレクトリにあるかどうかを確認します。 .yarnrc.yml ファイルである場合は、プロジェクトで構成されているプロジェクト固有のバージョンのYarnにコマンドを渡します。 yarnPath 設定。

これで、プロジェクトはプロジェクト固有のバージョンのYarnでセットアップされました。 次に、一般的に使用されるいくつかを見ていきます yarn 開始するコマンド。

毛糸の使用

Yarnには多くのサブコマンドがありますが、開始するのに必要なのはほんのわずかです。 使用する最初のサブコマンドを見てみましょう。

ヘルプを取得する

新しいツールを使い始めるときは、オンラインヘルプにアクセスする方法を学ぶと便利です。 毛糸で --help フラグを任意のコマンドに追加して、詳細情報を取得できます。

  1. yarn --help

これにより、全体的なヘルプが印刷されます。 yarn 指図。 サブコマンドに関するより具体的な情報を取得するには、次のように追加します。 --help サブコマンドの後：

  1. yarn install --help

これにより、使用方法の詳細が印刷されます。 yarn install 指図。

新しい糸プロジェクトの開始

プロジェクトを最初から開始する場合は、 init 必要なYarn固有のファイルを作成するためのサブコマンド：

  1. yarn init

これにより、 package.json 構成ファイルと yarn.lock ディレクトリにファイルします。 The package.json 構成とモジュールの依存関係のリストが含まれています。 The yarn.lock これらの依存関係を特定のバージョンにファイルロックして、依存関係ツリーが常に一貫していることを確認します。

プロジェクトのすべての依存関係をインストールする

既存のYarnベースのプロジェクトのすべての依存関係をダウンロードしてインストールするには、 install サブコマンド：

  1. yarn install

これにより、開始するために必要なモジュールがダウンロードおよびインストールされます。

プロジェクトへの新しい依存関係の追加

使用 add プロジェクトに新しい依存関係を追加するサブコマンド：

  1. yarn add package-name

これにより、モジュールがダウンロードされ、インストールされ、更新されます。 package.json と yarn.lock ファイル。

あなたの更新 .gitignore 毛糸のファイル

ヤーンはファイルを .yarn プロジェクトディレクトリ内のフォルダ。 これらのファイルの一部はバージョン管理にチェックインする必要があり、その他は無視する必要があります。 基本 .gitignore Yarnの構成は次のとおりです。

.gitignore
.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

これは全体を無視します .yarn ディレクトリ、および重要なフォルダのいくつかの例外を追加します。 releases プロジェクト固有のバージョンのYarnを含むディレクトリ。

GitとYarnの構成方法の詳細については、.gitignoreの公式Yarnドキュメントを参照してください。

結論

このチュートリアルでは、Yarnをインストールし、いくつかについて学びました。 yarn サブコマンド。 Yarnの使用の詳細については、公式のYarnCLIドキュメントを参照してください。

より一般的なNode.jsとJavaScriptのヘルプについては、 Node.js と JavaScript タグページ。関連するチュートリアル、テクニカルトーク、コミュニティのQ＆Aが掲載されています。