Yarn 1 / 1 | nju33

yarn install 時にフック関数を実行しないようにする

関連

例えばpackage.jsonに以下のように書いてあったとします。

"scripts": {
  "preinstall": "echo 1",
  "postinstall": "echo 2",
  "prepare": "echo 3",
}

そして、yarn（またはyarn install）すると、

yarn
# yarn install v1.12.3
# $ echo 1
# 1
# [1/4] 🔍  Resolving packages...
# success Already up-to-date.
# $ echo 2
# 2
# $ echo 3
# 3

という感じで全部実行されます。ローカルマシンでは自分で叩くようにしていると忘れていたりするのでこの動作は助かります。（特にpublish前のprepare）
ただprepareでビルド処理とかしていると実行時間がただのyarnに比べて3,4倍になってしまっている感じもします。僕の CI 環境は、無料実行時間カツカツな状態なので、フックしなくていいから少しでも早く終わらせたいです。

--ignore-scripts

もう一度ドキュメントを読みました。そうしたら、どうやらこのオプションを使うといけるようです。このオプションを使うと上記と同じscriptsの設定で、

yarn --ignore-scripts
# yarn install v1.12.3
# [1/4] 🔍  Resolving packages...
# success Already up-to-date.
# ✨  Done in 0.79s.

だけのログになりフックされないようにすることができました。

フックに依存しているパッケージを使っている時の注意

nowを CircleCI 上で使おうとした所インストール時のフック処理がされずにおかしなことになりました。どうやらこのオプションは依存のフックも無効化してしまうようです。このような場合は、それ単体で再度インストールコマンドを実行して入れる感じで対応するといいと思います。

npm に公開する

関連

publicコマンドを使うと npm に公開できます。

そのまま使うと対話的に１つずつ確認しながら公開手順を踏めますが、オプションを渡してあげれば一度のコマンド実行で公開まで行ってくれます。

オプション

npmではバージョンはMAJOR.MINOR.PATCH@TAGという形で管理します。TAGはオプショナルです。例えば1.2.3ならMAJORバージョンは1、MINORバージョンは2、PATCHバージョンは3という意味です。

patch

patchオプションはPATCHバージョンを1つ上げて公開します。現在のバージョンが1.2.3なら1.2.4に上げてから公開します。

minor

minorオプションはMINOORバージョンを1つ上げて公開します。現在のバージョンが1.2.3なら1.3.0ですね。

major

これもMAJORバージョンを1つ上げて公開するやつです。現在のバージョンが1.2.3なら2.0.0です。

new-version

好きなバージョンを付けたい時に使います。yarn publish --new-version 2.3.4とすれば2.3.4バージョンで公開できます。

tag

VERSION@TAGの形で公開します。これは上記のどれかと一緒に使います。例えば現在のバージョンが1.2.3だとして、2.0.0@canaryとして公開したい場合、yarn publish --major --tag canaryを実行します。

公開後

Yarn のバージョンが1.15.2の現在、少なくともバージョンを上げた後のpackage.jsonのpushなどは一緒にされないようなので忘れずにpushするようにしましょう。

ワークスペース

関連

ワークスペース機能を使うと１つのプロジェクトで複数のnpmパッケージを管理できるようになり、かつnode_modulesを１箇所にまとめることができます。

設定

プロジェクトルートのpackage.jsonへは以下のような設定が必要になります。

{
  "private": true,
  "workspaces": [
    "packages/**/*",
    "example"
  ]
}

private:trueは必ず設定が必要です。workspacesへはパッケージとなる(package.jsonを持っている）ディレクトリへのパターンや相対パスを記述します。

これで例えば、exampleやpackages/foo/hogeといったディレクトリがpackage.jsonを持っていればnpm管理プロジェクトだとすることができます。
この状態でexampleとpackages/foo/hoge双方でreactをインストールするとルートのnode_modulesだけにreactディレクトリが作られます。（bin系は各ディレクトリに作られる）

ルートへのパッケージインストール

ルートに共通パッケージをインストールしたい時などは-Wオプションが必要になります。

リンク

関連

別に開発しているパッケージを手っ取り早く現在のパッケージで使えるようにします。monorepo の開発プロジェクトを別々にしているような感じです。

yarn link <package-name>とすることで、現在のパッケージのnode_modules/へ<package-name>へのシンボリックリンクを置きます。例えばローカルにしかない開発中のplus-oneを今のプロジェクトに持ってきたい場合は、plus-one側のルートで

yarn link

と実行します。これでyarn link <package-name>の<package-name>に指定可能なリストに登録されます。

あとは、現在のプロジェクトのルートで、

yarn link plus-one

としてあげれば完了です。

const plusOne = require('plus-one');

plusOne(1);

うまくリンクできない場合

package.jsonの必須項目の漏れがあると、うまくリンクできない場合がありました。僕の場合はversionを設定し忘れていた為に、binがうまくリンクされずしばらく悩みました。

エラー

関連

yarn install

An unexpected error occurred: "https://registry.yarnpkg.com/event-stream/-/event-stream-3.3.6.tgz: Request failed \"404 Not Found\"".

yarn.lockを削除して再度インストール

rm yarn.lock
yarn