Mac'te Node-Gyp Yeniden Oluşturma Başarısızlığı Nasıl Ele Alınır (04.23.24)

node-gyp, geliştiricilerin yerel Node eklenti modüllerini birden çok platformda derlemesine olanak tanıyan şık bir araçtır. Günümüzde çok popüler ve yaygın olarak kullanılmaktadır, bu nedenle çoğu NPM paketine bağımlılık olarak dahil edilir.

Çoğu işletim sisteminde node-gyp herhangi bir soruna neden olmaz. node-gyp ve diğer NPM paketlerinin kurulumu genellikle sorunsuz ve verimli çalışır. Ancak, bu tüm kullanıcılar için geçerli değildir. Bazı geliştiriciler, macOS'ta node-gyp'i yeniden oluşturmakta sorun yaşadıklarını ve bunun da etkilenen geliştiriciler için mükemmel bir deneyime yol açmadığını bildirdi. Bu hata aynı zamanda çok sayıda tuzağa yol açar ve işlerin ters gitmesi için birçok yola izin verir.

Bu sorun yeni bir sorun değil. macOS'un eski sürümlerini kullanan geliştiriciler daha önce bu hatayla karşılaşmıştı. macOS Catalina'nın piyasaya sürülmesiyle birlikte birkaç geliştirici, yeni macOS sürümüne yükseltme yaptıktan sonra Mac'te node-gyp yeniden oluşturma işleminin başarısız olduğunu bildirdi. Bu hata, geliştiricilerin ihtiyaç duydukları node-gyp paketlerini yüklemelerini engelledi.

Bu hatayla karşılaştıysanız, Mac'te node-gyp yeniden oluşturma işleminin başarısız olmasının ne kadar sinir bozucu olabileceğini anlayacaksınız. Bu hatayı düzeltmediğiniz sürece uygulama veya yazılım geliştirme ile ilerleyemezsiniz. Neyse ki, tüm işi sizin için yaptık. Bu hata nedeniyle projenizde ilerlemeyi imkansız buluyorsanız, sorunu çözmek için aşağıda listelenen çözümlerden herhangi birini deneyebilirsiniz.

Node-Gyp nedir?

node-gyp, C veya C++ ile yazılmış yerel Node.js Modülleri olan Node.js Eklentilerini derlemek için kullanılan bir araçtır. Bu modüllerin, node-gyp gibi bir araç kullanılarak makinenizde derlenmesi gerekir. Node-gyp, Windows, macOS ve Linux üzerinde çalışır.

Node-gyp, tutarlı arayüzü nedeniyle genellikle kullanımı kolaydır. Modülünüzü farklı platformlarda oluşturmak veya yeniden oluşturmak için aynı komutları da kullanabilirsiniz. Node-gyp, Node'un birden çok hedef sürümünü de destekler.

Mojave'de veya macOS'in önceki sürümlerinde npm gyp hatası alıyorsanız, node-gyp'in çalışması için gereksinimleri iki kez kontrol etmeniz gerekir.

node-gyp'in macOS'te çalışması için yüklemeniz gereken gereksinimler şunlardır:

  • Python v2.7, v3.5, v3.6 veya v3. 7
  • Xcode – geliştiricilerin macOS, iOS ve iPadOS'ta uygulamalar oluşturmasına olanak tanıyan bir yardımcı programdır.

Ayrıca Xcode Komut Satırının doğru sürümünü yüklemeniz gerekir. XCode'un yazılım geliştirme araçları ve kitaplıkları paketinin parçası olan araçlar.

Xcode Komut Satırı Araçlarını yüklemek için aşağıdaki talimatları izleyin:

  • Mac'inizde Xcode 'u başlatın.
  • Tercihler Xcode menüsünden.
  • Genel panelinin altında, İndirilenler'i tıklayın.
  • İndirilenler penceresi açıldığında, Bileşenler sekmesini tıklayın.
  • Komut Satırı Araçları'nın yanındaki Yükle düğmesini tıklayın.>
  • Yükleme işlemini tamamlamak için Apple Developer hesabınızı kullanarak giriş yapın.

    • macOS Catalina kullanıyorsanız, Catalina sürümünüz için Xcode için Komut Satırı Araçları'nın uygun sürümünü buradan indirebilirsiniz. macOS 10.15.3 için dosya adı Command_Line_Tools_for_Xcode_11.3.1.dmg olmalıdır. Doğru bileşenleri kurduktan sonra, node-gyp kullanarak başarılı bir şekilde oluşturabilmelisiniz. Mac'te bir node-gyp yeniden oluşturma işlemi başarısız olursa, neyin yanlış gittiğini bulmak için bu bileşenleri incelemeniz gerekir.

    Node-gyp Yeniden Oluşturma Hatasını Çözme

    Bir düğüm modülünü kurmak kolay bir işlemdir. Sadece belirli komutları çalıştırmanız gerekiyor ve gitmeye hazır olmalısınız. Mac'te node-gyp yeniden oluşturma Başarısızları ile karşılaşırsanız, ne olduğunu anlamak için geri adım atmanız gerekir.

    Ancak bunu yapmadan önce denemeniz gereken bazı temel sorun giderme adımları şunlardır:

  • Sisteminizi etkileyebilecek geçici hatalardan kurtulmak için bilgisayarınızı yeniden başlatın.
  • Bilgisayarınızın yeniden yapılandırmalarında yer açmak için tüm gereksiz uygulamaları kapatın.
  • Virüsten koruma veya kötü amaçlı yazılımdan koruma programları gibi güvenlik yazılımlarınızı geçici olarak devre dışı bırakın.
  • Sisteminizi Mac onarım uygulamasını kullanarak temizleyin.

    • Eğer hala bir node-gyp yeniden oluşturma hatası alıyorum, aşağıdaki çözümlere bir göz atın ve hangisinin sizin için işe yaradığını görün.

    1. Düzeltme: Gerekli Bileşenleri iki kez kontrol edin.

    Yapmanız gereken ilk şey Mojave veya diğer macOS sürümlerinde bir npm gyp hatası aldığınızda node-gyp'in kurulum gereksinimlerini iki kez kontrol edin. Yukarıdaki bölümde belirtildiği gibi, çalışması için üç bileşene ihtiyacınız vardır:

    • Python
    • Xcode
    • Xcode Komut Satırı Araçları

      • li>

      Modülleri derlemek için gerekli olacak C ve C++ dillerini kurmayı unutmayınız. Bunlardan herhangi biri eksikse veya çalışmıyorsa, kesinlikle yeniden oluşturma hatası hatasını alırsınız. Eksik veya hatalı bileşeni yeniden yüklemek, sorunun çözülmesine yardımcı olacaktır.

      2 Numaralı Düzeltme: Node-Gyp Bileşenlerinizi Güncelleyin.

      Bazen bu bileşenleri yüklemek yeterli olmaz. macOS'unuz için doğru sürümü kullandığınızdan emin olmanız gerekir. Hangi sürümün işinize yaradığına bağlı olarak Python v2.7, v3.5, v3.6 veya v3.7 arasında seçim yapabilirsiniz. Xcode için bu bağlantıdan indirebilirsiniz. Her ihtimale karşı node-gyp'in en son sürümünü de yüklemeniz gerekiyor.

      Düzeltme #3: Bir Asit Testi gerçekleştirin.

      Bilgisayarınızda Xcode Komut Satırı Araçları'nın düzgün yüklenip yüklenmediğini ve çalışıp çalışmadığını kontrol edebilirsiniz. node-gyp ile, aşağıdaki adımları izleyerek bir asit testi çalıştırabilirsiniz:

    • Xcode'da şu komutu çalıştırın:
      /usr/sbin/pkgutil –packages | grep CL
    • com.apple.pkg.CLTools_Executables dosyasını listelenmiş olarak görüyorsanız, sorun yaşamazsınız. Değilse, bu test başarısız olmuştur ve yeniden yüklemeniz gerekir.
    • Bir sonraki komutu çalıştırın:
      /usr/sbin/pkgutil –pkg-info com.apple.pkg. CLTools_Executables
    • Sürüm: 11.0.0'ı (veya daha yenisini) listelendiği gibi görmelisiniz. Değilse, bu test de başarısız olmuştur ve yeniden yüklemeniz gerekir.
      • Düzeltme #4: Farklı Bir Python Sürümüne Geçin.

      Etkilenen birçok geliştirici, Python sürümünün aktif ortam, sorunu onlar için çözmeye yardımcı oldu. Bunun macOS sürümü, Düğüm sürümü ve kullandığınız Python sürümü arasındaki uyumlulukla ilgisi var. Bazı kullanıcılar, v2.7 gibi eski Python sürümlerinin yenilerinden daha kararlı olduğunu buldu. Farklı sürümleri deneyin ve hangisinin işinize yaradığını görün.

      Özet

      Mac'te node-gyp yeniden oluşturma işleminin başarısız olması zor olabilir ve neyin yanlış gittiğini bulmak büyük bir zaman kaybı olabilir. Bu nedenle, bu hatayla karşılaşırsanız, hatayı düzeltmek için tam olarak ne yapmanız gerektiğini öğrenmek için yukarıdaki kılavuza bakın.

      Youtube videosu: Mac'te Node-Gyp Yeniden Oluşturma Başarısızlığı Nasıl Ele Alınır

      04, 2024