Cara Menangani Kegagalan Pembuatan Ulang Node-Gyp di Mac (04.20.24)

node-gyp adalah alat bagus yang memungkinkan pengembang untuk mengkompilasi modul add-on Node asli di berbagai platform. Ini sangat populer dan banyak digunakan saat ini, sehingga sering disertakan sebagai dependensi untuk sebagian besar paket NPM.

Pada sebagian besar sistem operasi, node-gyp tidak menyebabkan masalah apa pun. Menginstal node-gyp dan paket NPM lainnya biasanya bekerja dengan lancar dan efisien. Namun, ini tidak berlaku untuk semua pengguna. Beberapa pengembang melaporkan mengalami masalah saat membangun kembali node-gyp di macOS, sehingga menghasilkan pengalaman yang kurang memuaskan bagi pengembang yang terpengaruh. Kesalahan ini juga menyebabkan banyak jebakan dan memungkinkan banyak cara untuk melakukan kesalahan.

Masalah ini bukanlah sesuatu yang baru. Pengembang yang menggunakan versi macOS yang lebih lama telah mengalami kesalahan ini sebelumnya. Dengan dirilisnya macOS Catalina, beberapa pengembang juga melaporkan kegagalan pembangunan kembali node-gyp di Mac setelah memutakhirkan ke versi macOS baru. Kesalahan ini telah mencegah pengembang menginstal paket node-gyp yang mereka butuhkan.

Jika Anda mengalami kesalahan ini, Anda akan memahami betapa frustasinya kegagalan pembangunan kembali node-gyp di Mac. Anda tidak dapat melanjutkan pengembangan aplikasi atau perangkat lunak Anda kecuali jika kesalahan ini diperbaiki. Untungnya, kami telah melakukan semua pekerjaan untuk Anda. Jika Anda merasa tidak mungkin untuk melanjutkan proyek Anda karena kesalahan ini, Anda dapat mencoba salah satu solusi yang tercantum di bawah ini untuk menyelesaikannya.

Apa itu Node-Gyp?

node-gyp adalah alat yang digunakan untuk mengkompilasi Addons Node.js, yang merupakan Modul Node.js asli yang ditulis dalam C atau C++. Modul-modul ini perlu dikompilasi di mesin Anda menggunakan alat seperti node-gyp. Node-gyp berfungsi di Windows, macOS, dan Linux.

Node-gyp umumnya mudah digunakan karena antarmukanya yang konsisten. Anda juga dapat menggunakan perintah yang sama untuk membangun atau membangun kembali modul Anda pada platform yang berbeda. Node-gyp juga mendukung beberapa versi target Node.

Jika Anda mendapatkan kesalahan npm gyp di Mojave atau versi macOS sebelumnya, Anda perlu memeriksa ulang persyaratan agar node-gyp berfungsi.

Berikut adalah persyaratan yang perlu Anda instal agar node-gyp berfungsi di macOS:

  • Python v2.7, v3.5, v3.6, atau v3. 7
  • Xcode – utilitas yang memungkinkan pengembang membuat aplikasi di macOS, iOS, dan iPadOS.

Anda juga perlu menginstal versi Xcode Command Line yang benar Alat, yang merupakan bagian dari rangkaian alat dan pustaka pengembangan perangkat lunak XCode.

Untuk menginstal Alat Baris Perintah Xcode, ikuti petunjuk di bawah ini:

  • Mulai Xcode di Mac Anda.
  • Pilih Preferensi dari menu Xcode.
  • Di bawah panel Umum , klik Unduhan.
  • Saat jendela Unduhan terbuka, klik tab Komponen .
  • Klik tombol Pasang di samping Alat Baris Perintah.
  • Masuk menggunakan akun Pengembang Apple Anda untuk menyelesaikan proses penginstalan.

    • Jika Anda menjalankan macOS Catalina, Anda dapat mengunduh versi yang sesuai dari Alat Baris Perintah untuk Xcode untuk versi Catalina Anda dari sini. Untuk macOS 10.15.3, nama file harus Command_Line_Tools_for_Xcode_11.3.1.dmg. Setelah Anda menginstal komponen yang benar, Anda harus dapat membangun menggunakan node-gyp dengan sukses. Jika Anda mendapatkan kegagalan pembangunan kembali node-gyp di Mac, Anda perlu meninjau komponen ini untuk mengetahui apa yang salah.

    Cara Mengatasi Kesalahan Pembuatan Ulang Node-gyp

    Memasang modul node adalah proses yang mudah. Anda hanya perlu menjalankan perintah tertentu dan Anda harus melakukannya dengan baik. Jika Anda menemukan Fails rekondisi node-gyp di Mac, Anda perlu mundur untuk mencari tahu apa yang terjadi.

    Tetapi sebelum melakukannya, berikut adalah beberapa langkah pemecahan masalah dasar yang harus Anda coba:

  • Mulai ulang komputer Anda untuk menghilangkan bug sementara yang mungkin memengaruhi sistem Anda.
  • Tutup semua aplikasi yang tidak perlu untuk mengosongkan reimg komputer Anda.
  • Nonaktifkan sementara perangkat lunak keamanan Anda, seperti program antivirus atau anti-malware.
  • Bersihkan sistem Anda menggunakan aplikasi perbaikan Mac.

    • Jika Anda 'masih mendapatkan kesalahan pembuatan ulang node-gyp, lihat solusi di bawah dan lihat mana yang cocok untuk Anda.

    Perbaiki #1: Periksa kembali Komponen yang Diperlukan.

    Hal pertama yang perlu Anda lakukan lakukan ketika Anda mendapatkan kesalahan npm gyp di Mojave atau versi macOS lainnya adalah dengan memeriksa ulang persyaratan instalasi node-gyp. Seperti disebutkan di bagian di atas, Anda memerlukan tiga komponen agar dapat berfungsi, yaitu:

    • Python
    • Xcode
    • Alat Baris Perintah Xcode

    Jangan lupa untuk menginstal bahasa C dan C++, yang akan diperlukan untuk mengkompilasi modul. Jika salah satu dari ini hilang atau tidak berfungsi, Anda pasti akan mendapatkan kesalahan gagal membangun kembali. Menginstal ulang komponen yang hilang atau rusak akan membantu memperbaiki masalah.

    Perbaikan #2: Perbarui Komponen Node-Gyp Anda.

    Terkadang menginstal komponen ini tidak cukup. Anda perlu memastikan bahwa Anda menggunakan versi yang benar untuk macOS Anda. Anda dapat memilih antara Python v2.7, v3.5, v3.6, atau v3.7, tergantung versi mana yang cocok untuk Anda. Untuk Xcode, Anda dapat mengunduhnya dari tautan ini. Anda juga perlu menginstal versi terbaru dari node-gyp untuk berjaga-jaga.

    Perbaikan #3: Lakukan Uji Asam.

    Anda dapat memeriksa apakah Alat Baris Perintah Xcode di komputer Anda diinstal dengan benar dan akan berfungsi dengan node-gyp, Anda dapat menjalankan uji asam dengan mengikuti langkah-langkah berikut:

  • Pada Xcode, jalankan perintah ini:
    /usr/sbin/pkgutil –packages | grep CL
  • Jika Anda melihat com.apple.pkg.CLTools_Executables seperti yang tercantum, maka Anda tidak akan mengalami masalah. Jika tidak, maka pengujian ini telah gagal dan Anda perlu menginstalnya kembali.
  • Jalankan perintah berikutnya:
    /usr/sbin/pkgutil –pkg-info com.apple.pkg. CLTools_Executables
  • Anda akan melihat versi: 11.0.0 (atau lebih baru) seperti yang tercantum. Jika tidak, maka pengujian ini juga gagal dan Anda perlu menginstal ulang.
    • Perbaikan #4: Beralih ke Versi Python yang Berbeda.

    Banyak pengembang yang terpengaruh mencatat bahwa mengubah versi Python yang digunakan untuk lingkungan aktif membantu memperbaiki masalah bagi mereka. Ini ada hubungannya dengan kompatibilitas antara versi macOS, versi Node, dan versi Python yang Anda gunakan. Beberapa pengguna menemukan bahwa versi Python yang lebih lama, seperti v2.7, lebih stabil daripada yang lebih baru. Bereksperimenlah dengan versi yang berbeda dan lihat mana yang cocok untuk Anda.

    Ringkasan

    Mendapatkan kegagalan pembangunan kembali node-gyp di Mac bisa merepotkan dan mencari tahu apa yang salah bisa sangat membuang waktu. Jadi, jika Anda mengalami kesalahan ini, lihat panduan di atas sehingga Anda tahu persis apa yang harus dilakukan untuk memperbaiki kesalahan tersebut.

    Video Youtube: Cara Menangani Kegagalan Pembuatan Ulang Node-Gyp di Mac

    04, 2024