npm互換のJavaScriptパッケージマネージャーYarn入門

91
114

最近のWebのフロントエンド開発ではライブラリの管理を行うパッケージマネージャーの採用が主流になってきています。たとえば、タスクランナーのGulpやGruntであったり、SassやTypeScriptのコンパイルのためにNode.jsノード・ジェイエスnpm)を導入している方は多いでしょう。

JavaScriptのパッケージマネージャーとしては「npmネヌ・ピー・エヌ」が有名ですが、2016年10月にFacebookが新しいパッケージマネージャー「Yarnヤァン」を公開しました。

Yarnはnpmと互換性のあるJavaScriptのためのパッケージマネージャーで、「インストールが高速」「より厳密にバージョンを固定」「セキュリティが高い」といった魅力があります。弊社はnpmからYarnに乗り換えて早3年、快適に開発に利用しています。本記事では、npmの経験者に向けてYarnの利点と使い方を紹介します。

Yarnの特徴とは

インストールがとにかく早い

一度インストールしたパッケージはキャッシュされるため、オフラインでも再インストールできます。また、npmでは直列にインストールしていましたが、Yarnでは効率的にリクエストキューを発行し並列にインストールを行います。これにより、高速にパッケージをインストールできます。npmもバージョン5から高速化されましたが、Yarnのほうが圧倒的に高速です。記事「npmから乗り換えてわかったYarnの4つのメリット」でも検証済みです。

より厳密にバージョンを固定できる

Yarnではロックファイルによって依存パッケージをより正確なバージョンで管理できます。また、正確なアルゴリズムですべてのマシンに同じファイル構造でインストールされるため、インストールの再現が可能です。複数人での開発時に「一部の人のみエラーが発生する」といったバグを発生しにくい環境にできます

セキュリティーが高い

パッケージのインストール前にチェックサムで整合性を確認します。パッケージに誤りがないかをチェックできるため、信頼性が高まります。

インストールに失敗しづらい

ネットワークへの接続に失敗した場合でも自動的に再試行されるため、インストールに失敗しづらいです。

フラットモード

同パッケージの別バージョンの重複を作成せず、単一のバージョンにすることもできます。これにより、パッケージがインストールされるnode_modulesフォルダー内の肥大化が防げます。

yarn --flatコマンドを使って、フラットモードでインストールしている様子。重複しているバージョンがある場合にバージョンを選んでインストールできる

コマンドライン出力がわかりやすい

多くの絵文字を使用し、シンプルで読みやすいコマンドライン出力がされます。

▲ Yarnからパッケージをインストールしている様子

Yarnをインストールしてみよう

前提として、Node.jsの最新版をインストールしておいてください。Node.jsに付属のパッケージマネージャー「npm」がYarnのインストールに必要だからです。

Windowsの場合

Installation | Yarn」の手順にあるように、Yarnの公式インストーラーを使うのが便利でしょう。

macOSの場合

Yarnはnpmコマンドからインストールできます。コマンドライン(Windowsではコマンドプロンプト、macOSではターミナル。app)を立ち上げ、以下のコマンドを実行します。成功するとYarnがグローバル環境にインストールされ、yarnコマンドを実行できるようになります。

sudo npm install -g yarn

もしくは公式の手順「Installation | Yarn」で進めることも可能です。ただ、公式の手順は手間が多いため、コマンドラインに不慣れな方にとっては敷居が高いでしょう。

Yarnでプロジェクトを管理しよう

Yarnのコマンドはnpmのコマンドと少しだけ異なります。頻繁に使用するコマンドについて紹介します。

はじめからyarnを使ってみる場合(package.jsonがない場合)

パッケージ管理ファイルの作成にはyarn initコマンドを使用します。このコマンドを実行すると、対話形式でプロジェクト名やバージョン情報が聞かれ、package.jsonファイルが作成されます。このファイルを共有することで、プロジェクトにインストールするパッケージの設定情報を他の人と共有できます。中身はnpmで作るpackage.jsonファイルと同じものなので、Yarnで設定したものをそのままnpmで使えます。

yarn init

※ npmコマンドのnpm initと互換のコマンド

yarn initコマンドを実行した時の様子

既存のプロジェクトでYarnを使用する場合(package.jsonがある場合)

既存のpackage.jsonファイルから必要なモジュールをインストールするにはyarnコマンドを使用します。パッケージの情報が記載されている状態で実行するとパッケージのバージョンを固定するためのyarn.lockファイルが作成されます。

yarn

npm installと互換のコマンド

プロジェクトに必要なパッケージをインストールしてみよう

プロジェクトに必須なパッケージをインストールする場合

プロジェクトに必須なパッケージをインストールする場合、yarn addコマンドを実行します。このコマンドを実行すると、node_modulesフォルダーにパッケージがインストールされ、package.jsonファイルのdepenciesの箇所にパッケージ名とバージョンが記載されます。また、パッケージのバージョンを固定するためのyarn.lockファイルが作成されます。

yarn add [package名]

※ npmコマンドのnpm install --saveと互換

devDependenciesへインストールする場合

devDependenciesのパッケージとしてインストールする場合は、yarn add [package名] --devコマンドを使用します。このコマンドを実行すると、package.jsonファイルのdevDepenciesの箇所にパッケージ名とバージョンが記載されます。

yarn add [package名] --dev

もしくは--dev-Dと省略できます。

yarn add [package名] -D

※ npmコマンドのnpm install --save-devと互換

グローバルにインストールする場合

マシンのグローバルにインストールする場合は、yarn global addコマンドを使用します。

yarn global add [package名]

※ npmでのnpm install -gコマンドと互換

パッケージをアンインストールする

パッケージの削除はyarn removeコマンドを使用します。実行するとpackage.jsonファイルやyarn.lockファイルに記載されていたパッケージ名とバージョン情報が削除されます。

yarn remove

npm uninstallと互換。npmコマンドではオプションに指定していた--save--save-devは不要です
※ その他、詳しいコマンドについてはYarn公式のnpm移行ガイド「Yarn - Migrating from npm」を参照ください

コマンドの実行が簡単

yarn run モジュール名

とするだけで、node_modules/.bin/にあるスクリプトを実行できます。たとえば、yarn add typescriptでインストールしたTypeScriptパッケージのコンパイルコマンドを実行するには、次のように実行します。

yarn run tsc

※ npmのnpx tscと互換

また、npm scriptsもyarn runコマンドで実行できます。

Yarnをプロジェクトで使用するか?

インストールの高速化やバージョンの固定機能、オフラインインストールと、とても魅力的な機能がそろっていて、個人的に導入してよかったと思っています

複数人が関わるプロジェクトに導入するには、インストールの手間やnpmコマンドとの違いなどの周知を行う必要があります。npmへ戻るのは難しくないため、まずは気軽にためしてみてはいかがでしょうか?

実際にyarnを導入した体験を記事『npmから乗り換えてわかったYarnの4つのメリット』にまとめたので、あわせて参照ください。

野原 のぞみ

インタラクティブデベロッパー。好きな生き物はハムスター、好きな食べ物は豚汁です。ツールは使うより作りたい派。

この担当の記事一覧