node-gyp --python /path/to/executable/python1 là một công cụ dòng lệnh đa nền tảng được viết bằng Node. js để biên dịch các mô-đun addon gốc cho Node. js. Nó chứa một bản sao của dự án gyp-next đã được nhóm Chromium sử dụng trước đây, được mở rộng để hỗ trợ sự phát triển của Node. addon gốc js
Lưu ý rằng
node-gyp --python /path/to/executable/python1 không được sử dụng để xây dựng Nút. js chính nó
Nhiều phiên bản mục tiêu của Node. js được hỗ trợ [tôi. e.
node-gyp --python /path/to/executable/python4,. ,
node-gyp --python /path/to/executable/python5,
node-gyp --python /path/to/executable/python6,
node-gyp --python /path/to/executable/python7, v.v. ], bất kể phiên bản Node nào. js thực sự đã được cài đặt trên hệ thống của bạn [
node-gyp --python /path/to/executable/python1 tải xuống các tệp hoặc tiêu đề phát triển cần thiết cho phiên bản đích]
Đặc trưng
- Các lệnh xây dựng tương tự hoạt động trên bất kỳ nền tảng được hỗ trợ nào
- Hỗ trợ nhắm mục tiêu các phiên bản khác nhau của Node. js
Cài đặt
Bạn có thể cài đặt
node-gyp --python /path/to/executable/python1 bằng cách sử dụng
npm config set python /path/to/executable/python
0npm install -g node-gyp
Tùy thuộc vào hệ điều hành của bạn, bạn sẽ cần phải cài đặt
Trên Unix
- Python v3. 7, v3. 8, v3. 9 hoặc v3. 10
npm config set python /path/to/executable/python
1- Chuỗi công cụ biên dịch C/C++ thích hợp, như GCC
Trên macOS
CHÚ Ý. Nếu máy Mac của bạn đã được nâng cấp lên macOS Catalina [10. 15] trở lên, vui lòng đọc macOS_Catalina. md
- Python v3. 7, v3. 8, v3. 9 hoặc v3. 10
npm config set python /path/to/executable/python
2 sẽ cài đặtnpm config set python /path/to/executable/python
3,npm config set python /path/to/executable/python
4 vànpm config set python /path/to/executable/python
1- Cài đặt độc lập
npm config set python /path/to/executable/python
2 bằng cách chạynpm config set python /path/to/executable/python
7. -- HOẶC -- - Ngoài ra, nếu bạn đã cài đặt Xcode đầy đủ, bạn có thể cài đặt Công cụ dòng lệnh trong menu
npm config set python /path/to/executable/python
8
- Cài đặt độc lập
Trên Windows
Cài đặt phiên bản hiện tại của Python từ gói Microsoft Store
Cài đặt công cụ và cấu hình thủ công
- Cài đặt môi trường xây dựng Visual C++. Công cụ xây dựng Visual Studio [sử dụng khối lượng công việc "Công cụ xây dựng Visual C++"] hoặc Cộng đồng Visual Studio [sử dụng khối lượng công việc "Phát triển máy tính để bàn với C++"]
- Khởi chạy cmd,
npm config set python /path/to/executable/python
9
Nếu các bước trên không hiệu quả với bạn, vui lòng truy cập Microsoft's Node. js Nguyên tắc dành cho Windows để biết các mẹo bổ sung
Để nhắm mục tiêu Nút ARM64 gốc. js trên Windows 10 trên ARM, hãy thêm các thành phần "Visual C++ trình biên dịch và thư viện cho ARM64" và "Visual C++ ATL cho ARM64"
Định cấu hình phụ thuộc Python
node-gyp --python /path/to/executable/python1 yêu cầu bạn đã cài đặt phiên bản tương thích của Python, một trong. v3. 7, v3. 8, v3. 9 hoặc v3. 10. Nếu bạn đã cài đặt nhiều phiên bản Python, bạn có thể xác định phiên bản Python nào
node-gyp --python /path/to/executable/python1 nên sử dụng theo một trong các cách sau
- bằng cách đặt tùy chọn dòng lệnh
node-gyp --python /path/to/executable/python
12, e. g
node-gyp --python /path/to/executable/python
- Nếu
node-gyp --python /path/to/executable/python
1 được gọi theo cách củanpm config set python /path/to/executable/python
0 và bạn đã cài đặt nhiều phiên bản Python, thì bạn có thể đặt khóa cấu hình 'python' củanpm config set python /path/to/executable/python
0 thành giá trị phù hợp
________số 8
Nếu biến môi trường
node-gyp --python /path/to/executable/python
16 được đặt thành đường dẫn của tệp thực thi Python, thì phiên bản đó sẽ được sử dụng, nếu đó là phiên bản tương thíchNếu biến môi trường
node-gyp --python /path/to/executable/python
17 được đặt thành đường dẫn của tệp thực thi Python, nó sẽ được sử dụng thay cho bất kỳ đường dẫn tìm kiếm Python được định cấu hình hoặc dựng sẵn nào khác. Nếu nó không phải là phiên bản tương thích, sẽ không cần tìm kiếm thêm
Xây dựng cho nút bên thứ ba. thời gian chạy js
Khi xây dựng các mô-đun cho Nút của bên thứ ba. js như Electron, có cấu hình xây dựng khác với Node chính thức. js, bạn nên sử dụng các cờ
node-gyp --python /path/to/executable/python18 hoặc
node-gyp --python /path/to/executable/python19 để chỉ định các tiêu đề của thời gian chạy để xây dựng cho
Ngoài ra, khi các cờ
node-gyp --python /path/to/executable/python18 hoặc
node-gyp --python /path/to/executable/python19 được thông qua, nút-gyp sẽ sử dụng
node-gyp --python /path/to/executable/python32 được vận chuyển trong phân phối tiêu đề để tạo cấu hình bản dựng, khác với chế độ mặc định sẽ sử dụng đối tượng
node-gyp --python /path/to/executable/python33 của Nút đang chạy. ví dụ js
Một số phiên bản cũ của Electron vận chuyển
node-gyp --python /path/to/executable/python32 không đúng định dạng trong các bản phân phối tiêu đề của chúng và bạn có thể cần chuyển
node-gyp --python /path/to/executable/python35 sang nút-gyp để khắc phục các lỗi cấu hình
Cách sử dụng
Để biên dịch addon gốc của bạn, trước tiên hãy chuyển đến thư mục gốc của nó
node-gyp --python /path/to/executable/python1
Bước tiếp theo là tạo các tệp xây dựng dự án phù hợp cho nền tảng hiện tại. Sử dụng
node-gyp --python /path/to/executable/python36 cho điều đó
node-gyp --python /path/to/executable/python3
Tự động phát hiện không thành công cho Visual C++ Build Tools 2015, vì vậy cần thêm
node-gyp --python /path/to/executable/python37 [không cần thiết khi chạy bằng npm như đã định cấu hình ở trên]
node-gyp --python /path/to/executable/python1
Ghi chú. Bước
node-gyp --python /path/to/executable/python36 tìm tệp
node-gyp --python /path/to/executable/python39 trong thư mục hiện tại để xử lý. Xem bên dưới để biết hướng dẫn tạo tệp
node-gyp --python /path/to/executable/python39
Bây giờ bạn sẽ có tệp
node-gyp --python /path/to/executable/python11 [trên nền tảng Unix] hoặc tệp
node-gyp --python /path/to/executable/python12 [trên Windows] trong thư mục
node-gyp --python /path/to/executable/python13. Tiếp theo, gọi lệnh
node-gyp --python /path/to/executable/python14
node-gyp --python /path/to/executable/python9
Bây giờ bạn đã có tệp ràng buộc
node-gyp --python /path/to/executable/python15 đã biên dịch của mình. Các ràng buộc được biên dịch kết thúc bằng
node-gyp --python /path/to/executable/python16 hoặc
node-gyp --python /path/to/executable/python17, tùy thuộc vào chế độ xây dựng. Tại thời điểm này, bạn có thể yêu cầu tệp
node-gyp --python /path/to/executable/python15 với Node. js và chạy thử nghiệm của bạn
Ghi chú. Để tạo bản dựng Gỡ lỗi của tệp liên kết, hãy chuyển công tắc
node-gyp --python /path/to/executable/python19 [hoặc
node-gyp --python /path/to/executable/python90] khi chạy lệnh
node-gyp --python /path/to/executable/python36,
node-gyp --python /path/to/executable/python14 hoặc
node-gyp --python /path/to/executable/python93
Tệp node-gyp --python /path/to/executable/python
39
Tệp
node-gyp --python /path/to/executable/python39 mô tả cấu hình để xây dựng mô-đun của bạn, ở định dạng giống như JSON. Tệp này được đặt trong thư mục gốc của gói của bạn, cùng với
node-gyp --python /path/to/executable/python96
Tệp
node-gyp --python /path/to/executable/python97 barebones phù hợp để xây dựng Nút. js addon có thể trông giống như
node-gyp --python /path/to/executable/python3
đọc thêm
Thư mục tài liệu chứa tài liệu bổ sung về các chủ đề cụ thể của nút-gyp có thể hữu ích nếu bạn gặp sự cố khi cài đặt hoặc xây dựng addon bằng cách sử dụng nút-gyp
Một số tài nguyên bổ sung cho Node. js addons gốc và viết tệp cấu hình
node-gyp --python /path/to/executable/python97
- "Đi bản địa" một nodeschool. hướng dẫn io
- Ví dụ addon nút "Xin chào thế giới"
- tài liệu người dùng gyp
- tham chiếu định dạng đầu vào gyp
- "ràng buộc. gyp" trong trang wiki hoang dã
lệnh
node-gyp --python /path/to/executable/python1 trả lời các lệnh sau
node-gyp --python /path/to/executable/python30Hiển thị hộp thoại trợ giúp
node-gyp --python /path/to/executable/python14Gọi
npm config set python /path/to/executable/python
1/node-gyp --python /path/to/executable/python33 và xây dựng addon gốc
node-gyp --python /path/to/executable/python34Xóa thư mục
node-gyp --python /path/to/executable/python14 nếu nó tồn tại
node-gyp --python /path/to/executable/python36Tạo tệp xây dựng dự án cho nền tảng hiện tại
node-gyp --python /path/to/executable/python93Chạy liên tiếp
node-gyp --python /path/to/executable/python34,
node-gyp --python /path/to/executable/python36 và
node-gyp --python /path/to/executable/python14
node-gyp --python /path/to/executable/python71Cài đặt nút. js cho phiên bản đã cho____772Liệt kê Nút hiện được cài đặt. phiên bản tiêu đề js
node-gyp --python /path/to/executable/python73Xóa nút. tệp tiêu đề js cho phiên bản nhất định
Tùy chọn lệnh
node-gyp --python /path/to/executable/python1 chấp nhận các tùy chọn lệnh sauLệnhMô tả
node-gyp --python /path/to/executable/python75,
node-gyp --python /path/to/executable/python76Chạy song song
npm config set python /path/to/executable/python
1. Giá trị node-gyp --python /path/to/executable/python78 sẽ sử dụng tất cả các lõi CPU có sẵn
node-gyp --python /path/to/executable/python79Node. js để xây dựng cho [mặc định là
npm config set python /path/to/executable/python
60]npm config set python /path/to/executable/python
61, npm config set python /path/to/executable/python
62Ghi lại tất cả tiến trình lên bàn điều khiểnnpm config set python /path/to/executable/python
63, npm config set python /path/to/executable/python
64Ghi lại hầu hết tiến trình lên bàn điều khiểnnpm config set python /path/to/executable/python
65, npm config set python /path/to/executable/python
66Không đăng nhập bất kỳ thứ gì vào bàn điều khiểnnpm config set python /path/to/executable/python
67, node-gyp --python /path/to/executable/python19Tạo bản dựng Gỡ lỗi [mặc định là
npm config set python /path/to/executable/python
69]node-gyp --python /path/to/executable/python00,
node-gyp --python /path/to/executable/python01Make Release build
node-gyp --python /path/to/executable/python02,
node-gyp --python /path/to/executable/python03Run lệnh khác . g.
node-gyp --python /path/to/executable/python06]
node-gyp --python /path/to/executable/python07Kích hoạt thư viện tĩnh mỏng
node-gyp --python /path/to/executable/python08Đặt kiến trúc mục tiêu [e. g. ia32]
node-gyp --python /path/to/executable/python09Nhận tiêu đề từ tarball cục bộ
node-gyp --python /path/to/executable/python10Thư mục tải xuống SDK [mặc định là thư mục bộ đệm của hệ điều hành]
node-gyp --python /path/to/executable/python11Không cài đặt lại tiêu đề nếu đã có
node-gyp --python /path/to/executable/python12Tải xuống tarball tiêu đề từ URL tùy chỉnh
node-gyp --python /path/to/executable/python13Đặt proxy HTTP[S] để tải xuống tarball tiêu đề
node-gyp --python /path/to/executable/python14Đặt url để bỏ qua proxy khi tải xuống tarball tiêu đề
node-gyp --python /path/to/executable/python15Ghi đè chuỗi CA mặc định
Cấu hình
Biến môi trường
Sử dụng biểu mẫu
node-gyp --python /path/to/executable/python23 cho bất kỳ tùy chọn lệnh nào được liệt kê ở trên [dấu gạch ngang trong tên tùy chọn phải được thay thế bằng dấu gạch dưới]
Ví dụ: để đặt
node-gyp --python /path/to/executable/python24 bằng
node-gyp --python /path/to/executable/python25, bạn sẽ
Chạy cái này trên Unix
node-gyp --python /path/to/executable/python7
Hoặc cái này trên Windows
npm config set python /path/to/executable/python
6cấu hình npm config set python /path/to/executable/python
0
Sử dụng biểu mẫu
node-gyp --python /path/to/executable/python27 cho bất kỳ tùy chọn lệnh nào được liệt kê ở trên
Ví dụ: để đặt
node-gyp --python /path/to/executable/python24 bằng
node-gyp --python /path/to/executable/python25, bạn sẽ chạy
node-gyp --python /path/to/executable/python0
Ghi chú. Cấu hình được đặt qua
npm config set python /path/to/executable/python
0 sẽ chỉ được sử dụng khi node-gyp --python /path/to/executable/python1 được chạy qua
npm config set python /path/to/executable/python
0, không phải khi node-gyp --python /path/to/executable/python1 được chạy trực tiếp