Node.js パッケージガイドライン - 版の履歴

Kgx: 同期

2025-02-09T17:07:05Z

同期

← 古い版		2025年2月10日 (月) 02:07時点における版
18行目:		18行目:

	<nowiki>https://registry.npmjs.org/$_pkgname/-/$_pkgname-$pkgver.tgz</nowiki>		<nowiki>https://registry.npmjs.org/$_pkgname/-/$_pkgname-$pkgver.tgz</nowiki>

			{{Tip\|また、{{ic\|npm view}} を使用して、より複雑なパッケージ仕様に役立つ tarball の場所を取得することもできます。例えば、{{ic\|npm view @nestjs/cli@10.1.7 dist.tarball}} のように使用します。}}

	== npm を使う ==		== npm を使う ==
53行目:		55行目:

	=== パッケージには $srcdir/$pkgdir への参照が含まれています ===		=== パッケージには $srcdir/$pkgdir への参照が含まれています ===

	{{Out of date\|The package used as an example was [https://lists.archlinux.org/archives/list/aur-requests@lists.archlinux.org/message/SGRO7PXC7M6SJ42XOGKN2TPDVRKWQIYY/ dropped from AUR].}}

	残念ながら、''npm'' はソースディレクトリと pkg ディレクトリへの参照を作成します。これは [https://github.com/npm/cli/issues/3828 既知の問題] です。ただし、これらの参照はまったく使用されないため、手動で削除できます。		残念ながら、''npm'' はソースディレクトリと pkg ディレクトリへの参照を作成します。これは [https://github.com/npm/cli/issues/3828 既知の問題] です。ただし、これらの参照はまったく使用されないため、手動で削除できます。
62行目:		62行目:
	find "$pkgdir" -name package.json -print0 \| xargs -r -0 sed -i '/_where/d'		find "$pkgdir" -name package.json -print0 \| xargs -r -0 sed -i '/_where/d'

	メインパッケージには他の参照も含まれます。これらを削除する最も簡単な方法は、下線付きのプロパティをすべて削除することですが、''sed'' の場合はそれほど簡単ではありません。代わりに、次のように {{Pkg\|jq}} を使用すると同様の結果が得られます。		メインパッケージには他の参照も含まれます。これらを削除する最も簡単な方法は、下線付きのプロパティをすべて削除することですが、''sed'' の場合はそれほど簡単ではありません。代わりに、次のように {{Pkg\|jq}} を使用すると同様の結果が得られます:

	{{bc\|<nowiki>		{{bc\|<nowiki>
72行目:		72行目:
	</nowiki>}}		</nowiki>}}

	{{ic\|$pkgdir}} への参照が見つかるもう 1 つの場所は、パッケージの {{ic\|man}} 属性です。man ページを気にしない場合 (依存関係のためにインストールされ~~るわけでは~~ないので)、次のように削除~~しても構い~~ません。		{{ic\|$pkgdir}} への参照が見つかるもう一つの場所は、パッケージの {{ic\|man}} 属性です。もし man ページに関心がない場合(依存関係のためにはインストールされないため)、次のように削除することができます。

	{{bc\|<nowiki>		{{bc\|<nowiki>
83行目:		83行目:
	</nowiki>}}		</nowiki>}}

	これら 3 つの手法すべての例は、[https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=readability-cli readability-cli ~~の古い~~ PKGBUILD] で見ることができます。		これら 3 つの手法すべての例は、[https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=nodejs-readability-cli nodejs-readability-cli's PKGBUILD] で見ることができます。

	== nvm の使用 ==		== nvm の使用 ==
89行目:		89行目:
	[[node.js]] ベースのアプリケーションで ’’’ビルド''' または '''パッケージ化''' に異なるバージョンが必要な場合は、{{AUR\|nvm}} を活用できます。		[[node.js]] ベースのアプリケーションで ’’’ビルド''' または '''パッケージ化''' に異なるバージョンが必要な場合は、{{AUR\|nvm}} を活用できます。

	{{Warning\|これはアプリケーションの構築/パッケージ~~化のニーズ~~にのみ適用され、~~実行時の~~依存関係は~~置き換えられ~~ません。}}		{{Warning\|これはアプリケーションのビルド/パッケージングに必要な場合にのみ適用され、ランタイム依存関係の代わりにはなりません。}}

	ビルドの依存関係として追加します。		ビルドの依存関係として追加します:

	makedepends=('npm' 'nvm')		makedepends=('npm' 'nvm')
97行目:		97行目:
	{{AUR\|nvm}} は {{ic\|NVM_DIR}} を使います。[[環境変数]] を使ってプレフィックスを探します。プレフィックスは {{ic\|$HOME/.nvm}} に設定されますが、{{AUR\|nvm}} の初期化前に指定されていなければ、{{ic\|$HOME/.nvm}} になります。		{{AUR\|nvm}} は {{ic\|NVM_DIR}} を使います。[[環境変数]] を使ってプレフィックスを探します。プレフィックスは {{ic\|$HOME/.nvm}} に設定されますが、{{AUR\|nvm}} の初期化前に指定されていなければ、{{ic\|$HOME/.nvm}} になります。

	次の関数を使用して、カスタムプレフィックスを作成し、ユーザーの場所から分離できます。		次の関数を使用して、カスタムプレフィックスを作成し、ユーザーの場所から分離できます:

	{{bc\|<nowiki>		{{bc\|<nowiki>

Kgx: 他言語へのリンクを追加

2023-06-26T12:42:31Z

他言語へのリンクを追加

← 古い版		2023年6月26日 (月) 21:42時点における版
1行目:		1行目:
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:Node.js package guidelines]]		[[en:Node.js package guidelines]]
			[[pt:Node.js package guidelines]]
			[[zh-hans:Node.js package guidelines]]
	{{Package Guidelines}}		{{Package Guidelines}}

Kgx: /* パッケージの命名規則 */ 情報を更新

2023-06-26T12:41:22Z

パッケージの命名規則: 情報を更新

← 古い版		2023年6月26日 (月) 21:41時点における版
7行目:		7行目:
	== パッケージの命名規則 ==		== パッケージの命名規則 ==

	{{Tip\|1=~~A custom~~ {{ic\|~~_pkgname~~}} ~~variable can be used instead of~~ {{ic\|~~pkgname~~}}~~. This variable can generically be defined as~~ ~~follows~~: {{ic\|1=_pkgname=${pkgname#nodejs-} }} }}		{{Tip\|1={{ic\|pkgname}} の代わりにカスタムの {{ic\|_pkgname}} 変数を使用できます。この変数は一般に次のように定義できます: {{ic\|1=_pkgname=${pkgname#nodejs-} }} }}

	パッケージの名前には~~最初に~~ {{ic\|nodejs-}} ~~を付け~~る必要があります。		Node.js ライブラリのパッケージ名は、{{ic\|nodejs-}} プレフィックスで始まる必要があります。スタンドアロンアプリケーションの場合は、プログラム名のみを使用します。

	== ソース ==		== ソース ==

Kgx: nvm の使用を翻訳して追加

2023-06-26T12:39:27Z

nvm の使用を翻訳して追加

← 古い版		2023年6月26日 (月) 21:39時点における版
82行目:		82行目:

	これら 3 つの手法すべての例は、[https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=readability-cli readability-cli の古い PKGBUILD] で見ることができます。		これら 3 つの手法すべての例は、[https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=readability-cli readability-cli の古い PKGBUILD] で見ることができます。

			== nvm の使用 ==

			[[node.js]] ベースのアプリケーションで ’’’ビルド''' または '''パッケージ化''' に異なるバージョンが必要な場合は、{{AUR\|nvm}} を活用できます。

			{{Warning\|これはアプリケーションの構築/パッケージ化のニーズにのみ適用され、実行時の依存関係は置き換えられません。}}

			ビルドの依存関係として追加します。

			makedepends=('npm' 'nvm')

			{{AUR\|nvm}} は {{ic\|NVM_DIR}} を使います。[[環境変数]] を使ってプレフィックスを探します。プレフィックスは {{ic\|$HOME/.nvm}} に設定されますが、{{AUR\|nvm}} の初期化前に指定されていなければ、{{ic\|$HOME/.nvm}} になります。

			次の関数を使用して、カスタムプレフィックスを作成し、ユーザーの場所から分離できます。

			{{bc\|<nowiki>
			_ensure_local_nvm() {
			# let's be sure we are starting clean
			which nvm >/dev/null 2>&1 && nvm deactivate && nvm unload
			export NVM_DIR="${srcdir}/.nvm"

			# The init script returns 3 if version specified
			# in ./.nvrc is not (yet) installed in $NVM_DIR
			# but nvm itself still gets loaded ok
			source /usr/share/nvm/init-nvm.sh \|\| [[ $? != 1 ]]
			}
			</nowiki>}}

			この関数は {{AUR\|nvm}} や {{Pkg\|npm}} など、指定されたバージョンを使うべき [[Node.js]] ベースのプログラムとやりとりする前に呼び出す必要があります。

			=== PKGBUILD の使用例 ===

			{{bc\|<nowiki>
			prepare() {
			_ensure_local_nvm
			nvm install 14.15.0
			}

			build() {
			_ensure_local_nvm
			npm install
			}
			</nowiki>}}

			あるいは、素の {{ic\|nvm install}} はカレントディレクトリの {{ic\|.nvrc}} ファイルからバージョン文字列を探します。

			この使用例は、{{AUR\|insomnia}} で見ることができます。詳細については、[[PKGBUILD]] を参照してください。

Kgx: /* npm を使う */ パッケージには $srcdir/$pkgdir への参照が含まれていますを翻訳して追加

2023-06-26T12:34:12Z

npm を使う: パッケージには $srcdir/$pkgdir への参照が含まれていますを翻訳して追加

← 古い版		2023年6月26日 (月) 21:34時点における版
49行目:		49行目:
	それから通常通りにパッケージ化してください:		それから通常通りにパッケージ化してください:
	npm run packager		npm run packager

			=== パッケージには $srcdir/$pkgdir への参照が含まれています ===

			{{Out of date\|The package used as an example was [https://lists.archlinux.org/archives/list/aur-requests@lists.archlinux.org/message/SGRO7PXC7M6SJ42XOGKN2TPDVRKWQIYY/ dropped from AUR].}}

			残念ながら、''npm'' はソースディレクトリと pkg ディレクトリへの参照を作成します。これは [https://github.com/npm/cli/issues/3828 既知の問題] です。ただし、これらの参照はまったく使用されないため、手動で削除できます。

			すべての依存関係には、{{ic\|_where}} 属性に {{ic\|$pkgdir}} への参照が含まれます。通常、次のように ''sed'' マジックを使用してこれらの属性を削除できます。

			find "$pkgdir" -name package.json -print0 \| xargs -r -0 sed -i '/_where/d'

			メインパッケージには他の参照も含まれます。これらを削除する最も簡単な方法は、下線付きのプロパティをすべて削除することですが、''sed'' の場合はそれほど簡単ではありません。代わりに、次のように {{Pkg\|jq}} を使用すると同様の結果が得られます。

			{{bc\|<nowiki>
			local tmppackage="$(mktemp)"
			local pkgjson="$pkgdir/usr/lib/node_modules/$_pkgname/package.json"
			jq '.\|=with_entries(select(.key\|test("_.+")\|not))' "$pkgjson" > "$tmppackage"
			mv "$tmppackage" "$pkgjson"
			chmod 644 "$pkgjson"
			</nowiki>}}

			{{ic\|$pkgdir}} への参照が見つかるもう 1 つの場所は、パッケージの {{ic\|man}} 属性です。man ページを気にしない場合 (依存関係のためにインストールされるわけではないので)、次のように削除しても構いません。

			{{bc\|<nowiki>
			find "$pkgdir" -type f -name package.json \| while read pkgjson; do
			local tmppackage="$(mktemp)"
			jq 'del(.man)' "$pkgjson" > "$tmppackage"
			mv "$tmppackage" "$pkgjson"
			chmod 644 "$pkgjson"
			done
			</nowiki>}}

			これら 3 つの手法すべての例は、[https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=readability-cli readability-cli の古い PKGBUILD] で見ることができます。

Kgx: /* npm を使う */ 情報を更新

2023-06-26T12:30:37Z

npm を使う: 情報を更新

← 古い版		2023年6月26日 (月) 21:30時点における版
19行目:		19行目:
	== npm を使う ==		== npm を使う ==

	~~{{Pkg\|~~npm}} を使ってインストールする場合、~~''npm'' を~~ビルド時の依存~~パッケージに~~追加し~~てください:~~		[[npm]] を使用してインストールする場合は、ビルドの依存関係として追加します。

	makedepends=('npm')		makedepends=('npm')

			通常、tarball を抽出する必要は、ありません。
	以下は最小の {{ic\|package}} 関数です:

			noextract=("${_pkgname}-${pkgver}.tgz")
	{{bc\|

			これは最小限の [[パッケージの作成#関数 package()\|package]] 関数です。

			{{bc\|<nowiki>
	package() {		package() {
	cd $srcdir/$~~pkgname~~-$pkgver		npm install -g --prefix "${pkgdir}/usr" "${srcdir}/${_pkgname}-${pkgver}.tgz"

	npm install -g --user root --prefix "$pkgdir"/usr
			# npm gives ownership of ALL FILES to build user
			# https://bugs.archlinux.org/task/63396
			chown -R root:root "${pkgdir}"
	}		}
			</nowiki>}}
	}}

	=== 一時キャッシュの設定 ===		=== 一時キャッシュの設定 ===

Kgx: /* Source */ 翻訳

2023-06-26T12:25:41Z

Source: 翻訳

← 古い版		2023年6月26日 (月) 21:25時点における版
11行目:		11行目:
	パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。		パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。

	== ~~Source~~ ==		== ソース ==

			[[npm]] は、ダウンロード URL の安定した命名スキームを提供します。[[PKGBUILD#ソース]] {{ic\|1=source=()}} 配列では、次の URL テンプレートを使用できます。
	[[npm]] provides a stable naming scheme for download URLs. [[PKGBUILD#source]] {{ic\|1=source=()}} array can use the following URL template:

	<nowiki>https://registry.npmjs.org/$_pkgname/-/$_pkgname-$pkgver.tgz</nowiki>		<nowiki>https://registry.npmjs.org/$_pkgname/-/$_pkgname-$pkgver.tgz</nowiki>

Kusanaginoturugi: /* npm を使う */ == Source == を挿入

2021-10-07T03:52:42Z

npm を使う: == Source == を挿入

← 古い版		2021年10月7日 (木) 12:52時点における版
10行目:		10行目:

	パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。		パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。

			== Source ==

			[[npm]] provides a stable naming scheme for download URLs. [[PKGBUILD#source]] {{ic\|1=source=()}} array can use the following URL template:

			<nowiki>https://registry.npmjs.org/$_pkgname/-/$_pkgname-$pkgver.tgz</nowiki>

	== npm を使う ==		== npm を使う ==

Kusanaginoturugi: /* パッケージの命名規則 */ Tip を追加

2021-10-07T03:52:07Z

パッケージの命名規則: Tip を追加

← 古い版		2021年10月7日 (木) 12:52時点における版
6行目:		6行目:

	== パッケージの命名規則 ==		== パッケージの命名規則 ==

			{{Tip\|1=A custom {{ic\|_pkgname}} variable can be used instead of {{ic\|pkgname}}. This variable can generically be defined as follows: {{ic\|1=_pkgname=${pkgname#nodejs-} }} }}

	パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。		パッケージの名前には最初に {{ic\|nodejs-}} を付ける必要があります。

Kusakata: 同期

2018-02-19T12:43:13Z

同期

← 古い版		2018年2月19日 (月) 21:43時点における版
11行目:		11行目:
	== npm を使う ==		== npm を使う ==

	''npm'' を使ってインストールする場合、''npm'' をビルド時の依存パッケージに追加してください:		{{Pkg\|npm}} を使ってインストールする場合、''npm'' をビルド時の依存パッケージに追加してください:

	makedepends=('npm')		makedepends=('npm')
23行目:		23行目:
	}		}
	}}		}}

			=== 一時キャッシュの設定 ===

			npm は {{ic\|package.json}} を処理するときにパッケージをビルドするのに必要なパッケージをデフォルトのキャッシュフォルダ {{ic\|$HOME/.npm}} にダウンロードします。ユーザーのホームフォルダに手を加えないようにするために、{{ic\|--cache}} フラグでキャッシュフォルダを一時的に設定すると良いでしょう。

			依存パッケージを {{ic\|${srcdir}/npm-cache}} にダウンロードするには:

			npm install --cache "${srcdir}/npm-cache"

			それから通常通りにパッケージ化してください:
			npm run packager