このチュートリアルでは、糸とは何かについて説明します。 、LinuxにYarnパッケージマネージャーをインストールする方法、そして最後にYarnの基本的な使用法を見ていきます。
糸の紹介
毛糸、 Yの略 et A R esource N avigatorは、Linux、macOS、およびWindowsオペレーティングシステムにJavaScriptプログラムをインストールして管理するための最新のパッケージマネージャーです。
Yarnは、高速で安全で信頼性の高いパッケージマネージャーです。 Yarnはnpm registry
と完全に互換性があります npm
と連携できます パッケージマネージャー。
リソース使用率を最大化するためにすべてを同時に実行し、ダウンロードされたすべてのパッケージをキャッシュします。したがって、同じパッケージを何度もダウンロードする必要はありません。ヤーンは、インストール前にチェックサムを使用して各パッケージの整合性を確保するため、設計上も安全です。
デフォルトでは、Yarnはノードをサポートします 。プラグインを使用して、サポートを他のプログラミング言語に拡張することもできます。 Yarnコマンドの使用法はNpmに似ていますが、いくつかの追加コマンドがあります。たとえば、"yarn why"
があります 特定のパッケージがインストールされている理由を示すコマンド。
Yarnは当初、npmのパフォーマンスとセキュリティの問題に対処して修正するためにFacebookによって開発されました。現在、Yarnは、Facebookや他の企業とは関係のない独立したオープンソースプロジェクトです。
LinuxにYarnパッケージマネージャーをインストールする
Yarnは、私の多くのLinuxディストリビューションのデフォルトのリポジトリで利用できます。ただし、Yarnをインストールするための公式に推奨される方法は、 Npmを使用することです。 、Nodejsパッケージマネージャー。
Npmは、Nodejsのインストールでデフォルトでインストールされます。 Linux上のNodejsについては、次のガイドを参照してください。
- LinuxにNodeJSをインストールする方法
Nodejsをインストールした後、 npmを使用します LinuxマシンにYarnをインストールするには:
$ npm install -g yarn
インストールされているYarnのバージョンを確認します:
$ yarn --version
1.22.10
上記の出力からわかるように、インストールされているYarnのバージョンは 1.22.10です。 。
ヤーン1.xをヤーン2にアップグレード
Yarnの開発者は、高速で安定したYarnエクスペリエンスを実現するために、Yarn1.xバージョンから2.xバージョンに移行することをお勧めします。
Yarn1.xをYarn2に移行するには、プロジェクトフォルダーに移動し、次のコマンドを実行してYarn2バージョンにアップグレードします。
$ yarn set version berry
ここでは、berry
Yarn2リリースバージョンのコードネームです。コマンドを使用してバージョンを確認できます:
$ yarn --version 2.4.1
次のコマンドを使用して、Yarn1.xバージョンをYarn2.xバージョンに永続的にアップグレードすることもできます。
$ yarn set version latest
コマンドを使用して、Yarnが正常にアップグレードされたかどうかを確認します:
$ yarn --version
2.4.1
素晴らしい! Yarnは2.xリリースに移行されました。このガイドを書いている時点で、最新のYarnリリースは 2.4.1でした。 。
Yarnの使用を開始する
Yarnをインストールし、最新バージョンにアップグレードしました。それでは、いくつかの基本的なYarnコマンドを学びましょう。
1。ヘルプセクションを表示する
使用可能なYarnコマンドのリストを表示するには、次のコマンドを実行してYarnヘルプセクションを参照してください。
$ yarn help
このコマンドは、オプション/フラグを含むすべてのYarnコマンドと、各コマンドの簡単な説明を一覧表示します。以下のようなサブコマンドのヘルプセクションを表示することもできます:
$ yarn add -h
または、
$ yarn add --help
私はYarnヘルプセクションに本当に感銘を受けました。各Yarnサブコマンドのヘルプセクションは、サンプルコマンドできれいに書かれています。すべてのコマンドのヘルプセクションは非常に詳細であり、すべてのオプションが徹底的に説明されています。オンラインドキュメントは必要ないと思います。すべてをオフラインから取得できます。
2。新しいプロジェクトを開始する
次のコマンドを実行して、新しいプロジェクトを開始します。
$ yarn init
このコマンドは、現在のユーザーの名前で新しいプロジェクトを作成します。
出力例:
{ name: 'ostechnix' }
3。依存関係をインストールする
新しいプロジェクトに必要なすべての依存関係をインストールするには、次を実行します:
$ yarn
または、
$ yarn install
4。パッケージをインストールする
yarn add
を使用して、追加のパッケージまたは依存関係をインストールできます 指図。ヤーンコマンドを使用して新しいパッケージを追加するには、いくつかの方法があります。
通常のパッケージを追加するには、たとえばlodash
、現在のワークスペースに対して、次を実行します:
$ yarn add lodash
次のコマンドを使用して、特定のバージョンのパッケージを現在のワークスペースに追加できます。
$ yarn add [email protected]
マスターブランチからパッケージを追加することもできます URLを使用したGitHubリポジトリの現在のワークスペースへの変換:
$ yarn add [email protected]://github.com/lodash/lodash
または、以下のようなGitHubプロトコルを使用します:
$ yarn add [email protected]/lodash
依存関係の別のカテゴリを追加する場合は、--dev
を使用します 開発者の依存関係と--peer
を追加するフラグ ピアの依存関係を追加します。
$ yarn add lodash --dev
$ yarn add lodash --peer
すでに述べたように、-h/--help
を使用して、Yarnサブコマンドのヘルプセクションを表示できます。 フラグ:
$ yarn add -h
5。パッケージのアップグレード
Yarnを使用してパッケージをアップグレードするには、次のコマンドを実行します。
$ yarn up lodash
6。パッケージ情報を表示する
パッケージに関連する情報を表示するには、次のコマンドを実行します。
$ yarn info lodash
└─ [email protected]:4.17.21
└─ Version: 4.17.21
ヤーンを使用したパッケージに関する入手可能なすべての情報を表示する場合、コマンドは次のようになります。
$ yarn npm info lodash
7。シェルコマンドを実行する
yarn exec
を使用してシェルコマンドを実行できます コマンド。
たとえば、次のようにYarnを使用してHelloWorldテキストを表示します。
$ yarn exec echo Hello World
Hello World
YarnコマンドでLinuxカーネルのバージョンを表示する:
$ yarn exec uname -mrs
Linux 5.4.0-72-generic x86_64
8。パッケージがインストールされている理由を表示する
これは、ヤーンのユニークな機能の1つです。ヤーンは、パッケージがインストールされた理由を表示できます。
$ yarn why lodash
9。ワークスペースを表示する
Yarnのもう1つの注目すべき機能は、ワークスペースです。ワークスペースを使用すると、ユーザーは複数のpackage.json
から依存関係をインストールできます 単一ルートのサブフォルダー内のファイルpackage.json
ファイル、すべてを一度に。
使用可能なすべてのワークスペースを印刷するには、次のコマンドを実行します:
$ yarn workspaces list
10。現在の構成設定を表示する
現在アクティブな構成設定を印刷するには、次のコマンドを実行します。
$ yarn config
11。プラグインを表示
Yarnリポジトリから直接利用できるプラグインを印刷するには、次のコマンドを実行します。
$ yarn plugin list
上記のコマンドは、利用可能なすべての公式プラグインを表示します。現在アクティブなプラグインのみを表示する場合は、次を実行します。
$ yarn plugin runtime
12。プラグインをダウンロード
プラグインは、公式のYarnリポジトリ、ローカルまたはサードパーティのリポジトリからダウンロードしてアクティブ化できます。サードパーティのリポジトリからプラグインを追加する場合は、プラグインのURLを入力します。ローカルシステムからプラグインを追加する場合は、そのパスを入力するだけです。
プラグインをダウンロードしてアクティブ化するには、たとえばplugin-version
、Yarnリポジトリから、次を実行します:
$ yarn plugin import @yarnpkg/plugin-version
13。プラグインを削除する
Yarnリポジトリからインポートされたプラグインを削除するには、次のコマンドを実行します。
$ yarn plugin remove @yarnpkg/plugin-stage
ローカルシステムからインポートした場合は、名前を入力するだけです。
14。パッケージを削除する
Yarnを使用してパッケージをアンインストールするには、次のコマンドを実行します。
$ yarn remove lodash
15。キャッシュを削除する
すべてのローカルアーカイブを削除するには、次のコマンドを実行します:
$ yarn cache clean
~/.yarn
に保存されているすべてのアーカイブを削除することもできます コマンドを使用したディレクトリ:
$ yarn cache clean --mirror
これらは、Yarnパッケージマネージャーを使い始めるのにちょうど十分です。ただし、使用できるコマンドは多数あります。私はそれらをあなたに任せて学び、実験します。 yarn --help
を使用して、Yarnコマンドの完全なリストを表示できます。 指図。特定のサブコマンドの使用法がわからない場合は、"yarn sub-command -h"
を実行してください。 その特定のコマンドのヘルプセクションを表示します。