MacでNode-Gypの再構築に失敗した場合の対処方法 (04.25.24)

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

ほとんどのオペレーティングシステムでは、node-gypは問題を引き起こしません。 node-gypと残りのNPMパッケージのインストールは、通常、スムーズかつ効率的に機能します。ただし、これはすべてのユーザーに当てはまるわけではありません。一部の開発者は、macOSでnode-gypを再構築するのに問題があり、影響を受けた開発者のエクスペリエンスが優れていないと報告しました。このエラーはまた、多くの落とし穴につながり、物事がうまくいかないための多くの方法を可能にします。

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

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

Node-Gypとは何ですか？

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

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

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

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

  • Pythonv2.7、v3.5、v3.6、またはv3。 7
  • Xcode –開発者がmacOS、iOS、iPadOSでアプリを作成できるようにするユーティリティ。

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

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

  • Macで Xcode を起動します。
  • 設定を選択します。 strong> Xcodeメニューから。
  • 一般パネルで、ダウンロードをクリックします。
  • [ダウンロード]ウィンドウが開いたら、 [コンポーネント]タブをクリックします。
  • コマンドラインツールの横にある[インストール]ボタンをクリックします。
  • Apple Developerアカウントを使用してログインし、インストールプロセスを完了します。

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

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

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

    ただし、その前に、試すべき基本的なトラブルシューティング手順をいくつか示します。

  • コンピュータを再起動して、システムに影響を及ぼしている可能性のある一時的なバグを取り除きます。
  • 不要なアプリをすべて閉じて、コンピュータのreimgを解放します。
  • ウイルス対策プログラムやマルウェア対策プログラムなどのセキュリティソフトウェアを一時的に無効にします。
  • Mac修復アプリを使用してシステムをクリーンアップします。

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

    修正＃1：必要なコンポーネントを再確認します。

    最初に行う必要があることMojaveまたは他のmacOSバージョンでnpmgypエラーが発生した場合は、node-gypのインストール要件を再確認してください。上記のセクションで説明したように、これを機能させるには3つのコンポーネントが必要です。つまり、

    • Python
    • 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-infocom.apple.pkg。 CLTools_Executables
  • リストされているように、バージョン：11.0.0 （またはそれ以降）が表示されます。そうでない場合は、このテストも失敗するため、再インストールする必要があります。
    • 修正＃4：別のPythonバージョンに切り替える。

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

    まとめ

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

    YouTubeのビデオ: MacでNode-Gypの再構築に失敗した場合の対処方法

    04, 2024