Mac で失敗する Node-Gyp の再構築を処理する方法

node-gyp は、開発者がネイティブ Node アドオン モジュールを複数のプラットフォームでコンパイルできるようにする気の利いたツールです。現在非常に人気があり、広く使用されているため、多くの場合、ほとんどの NPM パッケージの依存関係として含まれています。

ほとんどのオペレーティング システムでは、node-gyp は問題を引き起こしません。通常、node-gyp と残りの NPM パッケージのインストールはスムーズかつ効率的に行われます。ただし、これはすべてのユーザーに当てはまるわけではありません。一部の開発者は、macOS で node-gyp を再構築する際に問題が発生したと報告しており、その結果、影響を受けた開発者の経験は素晴らしいものではありませんでした。このエラーはまた、多くの落とし穴につながり、さまざまな方法で問題が発生する可能性があります。

この問題は新しいものではありません。古いバージョンの macOS を使用している開発者は、以前にこのエラーに遭遇したことがあります。 macOS Catalina のリリースに伴い、新しい macOS バージョンにアップグレードした後、Mac で node-gyp の再構築が失敗することも複数の開発者から報告されています。このエラーにより、開発者は必要な node-gyp パッケージをインストールできませんでした。

このエラーが発生した場合は、Mac で node-gyp の再構築が失敗することがどれほどイライラするかを理解できます。このエラーを修正しない限り、アプリやソフトウェアの開発を進めることはできません。幸いなことに、私たちはあなたのためにすべての仕事をしました。このエラーが原因でプロジェクトを進めることができない場合は、以下にリストされている解決策のいずれかを試して解決できます。

プロのヒント:Mac をスキャンして、パフォーマンスの問題、ジャンク ファイル、有害なアプリ、セキュリティの脅威がないか調べます
システムの問題やパフォーマンスの低下を引き起こす可能性があります。

Node-Gyp とは?

node-gyp は、C または C++ で記述されたネイティブ Node.js モジュールである Node.js アドオンをコンパイルするために使用されるツールです。これらのモジュールは、node-gyp などのツールを使用してマシン上でコンパイルする必要があります。 Node-gyp は、Windows、macOS、および Linux で動作します。

Node-gyp は、一貫したインターフェイスのため、一般的に使いやすいです。同じコマンドを使用して、異なるプラットフォームでモジュールをビルドまたは再構築することもできます。 Node-gyp は、Node の複数のターゲット バージョンもサポートしています。

Mojave またはそれ以前のバージョンの macOS で npm gyp エラーが発生する場合は、node-gyp が機能するための要件を再確認する必要があります。

node-gyp を macOS で動作させるためにインストールする必要がある要件は次のとおりです。

• Python v2.7、v3.5、v3.6、または v3.7
• Xcode – デベロッパーが macOS、iOS、iPadOS でアプリを作成できるようにするユーティリティ

また、XCode のソフトウェア開発ツールとライブラリのスイートの一部である Xcode コマンド ライン ツールの正しいバージョンをインストールする必要があります。

Xcode コマンド ライン ツールをインストールするには、次の手順に従います。

<オール>

Xcode を起動

設定を選択 Xcode メニューから

将軍の下で パネルで [ダウンロード] をクリックします .

[ダウンロード] ウィンドウが開いたら、[コンポーネント] をクリックします。 タブ

[インストール] をクリックします。 コマンド ライン ツールの横にあるボタン。

Apple Developer アカウントを使用してログインし、インストール プロセスを完了してください。

macOS Catalina を実行している場合は、お使いのバージョンの Catalina に適したバージョンの Command Line Tools for Xcode をここからダウンロードできます。 macOS 10.15.3 の場合、ファイル名は Command_Line_Tools_for_Xcode_11.3.1.dmg になります。 .正しいコンポーネントをインストールしたら、node-gyp を使用して正常にビルドできるはずです。 Mac で node-gyp の再構築が失敗した場合は、これらのコンポーネントを確認して、何が問題なのかを突き止める必要があります。

Node-gyp 再構築エラーの解決方法

ノード モジュールのインストールは簡単なプロセスです。特定のコマンドを実行するだけで、準備完了です。 Mac で node-gyp の再構築が失敗した場合は、何が起こったのかを突き止める必要があります。

ただし、その前に、以下の基本的なトラブルシューティング手順を試してください:

<オール>

コンピュータを再起動して、システムに影響を与えている可能性のある一時的なバグを取り除きます。

不要なアプリをすべて閉じて、コンピューターのリソースを解放してください。

ウイルス対策プログラムやマルウェア対策プログラムなどのセキュリティ ソフトウェアを一時的に無効にします。

Mac 修復アプリを使用してシステムをクリーンアップします .

それでも node-gyp の再構築エラーが発生する場合は、以下の解決策を見て、どれが適切かを確認してください。

修正 #1:必要なコンポーネントを再確認してください。

Mojave またはその他の macOS バージョンで npm gyp エラーが発生したときに最初に行う必要があるのは、node-gyp のインストール要件を再確認することです。上記のセクションで述べたように、それが機能するには次の 3 つのコンポーネントが必要です。

• パイソン
• Xcode
• Xcode コマンド ライン ツール

モジュールのコンパイルに必要な C および C++ 言語をインストールすることを忘れないでください。これらのいずれかが欠落しているか機能していない場合、間違いなく再構築失敗エラーが発生します。欠落または障害のあるコンポーネントを再インストールすると、問題の解決に役立ちます。

修正 #2:Node-Gyp コンポーネントを更新する

これらのコンポーネントをインストールするだけでは不十分な場合があります。 macOS の正しいバージョンを使用していることを確認する必要があります。適切なバージョンに応じて、Python v2.7、v3.5、v3.6、または v3.7 から選択できます。 Xcode については、このリンクからダウンロードできます。念のため、最新バージョンの node-gyp もインストールする必要があります。

解決策 3:酸性テストを実施する

コンピューターに Xcode コマンド ライン ツールが正しくインストールされ、node-gyp で動作するかどうかを確認するには、次の手順に従って酸テストを実行できます。

<オール>

Xcode で、次のコマンドを実行します。
/usr/sbin/pkgutil –packages | grep CL

表示される場合 com.apple.pkg.CLTools_Executables リストされているように、問題はありません。そうでない場合、このテストは失敗したため、再インストールする必要があります。

次のコマンドを実行します。
/usr/sbin/pkgutil –pkg-info com.apple.pkg.CLTools_Executables

バージョン:11.0.0 が表示されます （またはそれ以降）記載されているとおり。そうでない場合は、このテストも失敗したため、再インストールする必要があります。

修正 #4:別の Python バージョンに切り替える

影響を受けた多くの開発者は、アクティブな環境で使用されている Python のバージョンを変更することで、問題を解決できたと述べています。これは、使用している macOS バージョン、Node バージョン、および Python バージョンの間の互換性と関係があります。一部のユーザーは、v2.7 などの古いバージョンの Python が新しいバージョンよりも安定していることに気付きました。さまざまなバージョンを試して、どのバージョンが適切かを確認してください。

まとめ

Mac で node-gyp の再構築が失敗するのは面倒な場合があり、何が問題だったのかを突き止めることは、膨大な時間の無駄になる可能性があります。したがって、このエラーが発生した場合は、上記のガイドを参照して、エラーを修正するために何をすべきかを正確に把握してください。