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에서 npm gyp 오류가 발생하는 경우 node-gyp가 작동하기위한 요구 사항을 다시 확인해야합니다.

macOS에서 작동하기 위해 node-gyp을 설치하는 데 필요한 요구 사항은 다음과 같습니다.

  • Python v2.7, v3.5, v3.6 또는 v3. 7
  • Xcode – 개발자가 macOS, iOS 및 iPadOS에서 앱을 만들 수 있도록하는 유틸리티입니다.

또한 올바른 버전의 Xcode 명령 줄을 설치해야합니다. XCode의 소프트웨어 개발 도구 및 라이브러리 제품군의 일부인 도구

Xcode 명령 줄 도구를 설치하려면 아래 지침을 따르십시오.

  • Mac에서 Xcode 를 시작합니다.
  • 환경 설정 을 선택합니다. strong> Xcode 메뉴에서.
  • 일반 패널에서 다운로드 를 클릭합니다.
  • 다운로드 창이 열리면 구성 요소 탭을 클릭합니다.
  • 명령 줄 도구 옆에있는 설치 버튼을 클릭합니다.
  • Apple 개발자 계정을 사용하여 로그인하여 설치 프로세스를 완료하십시오.

    • 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 rebuild Fails가 발생하는 경우 뒤로 물러서서 발생한 상황을 파악해야합니다.

    하지만 수행하기 전에 시도해야 할 몇 가지 기본적인 문제 해결 단계는 다음과 같습니다.

  • 컴퓨터를 다시 시작하여 시스템에 영향을 줄 수있는 일시적인 버그를 제거합니다.
  • 불필요한 앱을 모두 닫아 컴퓨터 reimg를 확보합니다.
  • 바이러스 백신 또는 맬웨어 방지 프로그램과 같은 보안 소프트웨어를 일시적으로 비활성화합니다.
  • Mac 복구 앱 을 사용하여 시스템을 정리합니다.

    • 여전히 node-gyp 재 구축 오류가 발생합니다. 아래 솔루션을 살펴보고 어떤 솔루션이 적합한 지 확인하십시오.

    수정 # 1 : 필수 구성 요소를 다시 확인하십시오.

    첫 번째로 필요한 작업 Mojave 또는 기타 macOS 버전에서 npm gyp 오류가 발생하면 node-gyp의 설치 요구 사항을 다시 확인하십시오. 위 섹션에서 언급했듯이 작동하려면 다음 세 가지 구성 요소가 필요합니다.

    • Python
    • Xcode
    • Xcode 명령 줄 도구

    모듈을 컴파일하는 데 필요한 C 및 C ++ 언어를 설치하는 것을 잊지 마십시오. 이들 중 하나라도 누락되거나 작동하지 않는 경우 확실히 재 구축 실패 오류가 발생합니다. 누락되었거나 결함이있는 구성 요소를 다시 설치하면 문제를 해결하는 데 도움이됩니다.

    수정 # 2 : Node-Gyp 구성 요소 업데이트.

    때로는 이러한 구성 요소를 설치하는 것만으로는 충분하지 않습니다. macOS에 맞는 버전을 사용하고 있는지 확인해야합니다. 적합한 버전에 따라 Python v2.7, v3.5, v3.6 또는 v3.7 중에서 선택할 수 있습니다. Xcode의 경우이 링크에서 다운로드 할 수 있습니다. 만일을 대비하여 최신 버전의 node-gyp을 설치해야합니다.

    수정 # 3 : Acid Test를 수행하십시오.

    컴퓨터에 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
  • version : 11.0.0 (또는 그 이상)이 나열된대로 표시되어야합니다. 그렇지 않은 경우이 테스트도 실패하고 다시 설치해야합니다.
    • 수정 # 4 : 다른 Python 버전으로 전환합니다.

    영향을받는 많은 개발자가 활동적인 환경이 문제를 해결하는 데 도움이되었습니다. 이것은 macOS 버전, Node 버전 및 사용중인 Python 버전 간의 호환성과 관련이 있습니다. 일부 사용자는 v2.7과 같은 이전 버전의 Python이 최신 버전보다 더 안정적이라는 사실을 발견했습니다. 여러 버전으로 실험하고 어떤 버전이 적합한 지 확인하세요.

    요약

    Mac에서 node-gyp 재 구축에 실패하는 것은 번거롭고 무엇이 잘못되었는지 파악하는 것은 엄청난 시간 낭비 일 수 있습니다. 따라서이 오류가 발생하면 위의 가이드를 참조하여 오류를 해결하기 위해해야 ​​할 일을 정확히 알 수 있습니다.

    YouTube 비디오: Mac에서 Node-Gyp 재 구축 실패를 처리하는 방법

    04, 2024