Xây dựng OpenWeave

Chuỗi công cụ được hỗ trợ chính để xây dựng OpenWeave là GNU Autotools.

Yêu cầu hệ thống

Tất cả các nền tảng hệ điều hành chính đều hỗ trợ xây dựng và biên dịch chéo OpenWeave. Các công cụ được liệt kê đã được Nest thử nghiệm chính thức.

Điều kiện tiên quyết

Ngoài chuỗi công cụ được hỗ trợ, chúng tôi khuyên bạn nên cài đặt các gói và công cụ sau đây trước khi xây dựng OpenWeave.

Gói

Linux:

 sudo apt-get install python-pip python-setuptools bridge-utils /
               libglib2.0-dev libdbus-1-dev libudev-dev /
               libical-dev libreadline-dev 

Linux và Mac OS X:

 pip install --user google-cloud googleapis-common-protos grpc protobuf pycryptodomex
sudo cpan -i Text::Template 

Tự động GNU

OpenWeave phụ thuộc vào GNU Autotools cho hệ thống xây dựng của nó. Phải có sẵn phiên bản GNU Autotools để xây dựng thành công OpenWeave. Để sử dụng phiên bản autotools do hệ thống cung cấp trên Linux:

 sudo apt-get install libtool autoconf automake 

Đối với các hệ thống mà GNU Autotools không có sẵn hoặc có thể cài đặt (ví dụ: Mac OS) hoặc trên các hệ thống mà phiên bản do hệ thống cung cấp không cung cấp thế hệ xây dựng bên ngoài vững chắc, Nest Labs đã tạo một bản dựng chìa khóa trao tay tùy chỉnh khung hệ thống, dựa trên GNU Autotools. Hệ thống ghim tập hợp các chương trình được sử dụng trong thế hệ xây dựng thành một phiên bản tốt đã biết. Việc ghim các công cụ vào một phiên bản cụ thể cũng đảm bảo số lượng tương đối thấp trong đầu ra của autotools do đó dẫn đến trải nghiệm hỗ trợ và nhà phát triển có thể dự đoán được. Bản dựng GNU Autotools của Nest Labs được khuyến nghị sử dụng với OpenWeave.

Để xây dựng Autotools Nest Labs:

 git clone https://github.com/openweave/openweave-core.git
cd openweave-core
make -C third_party/nlbuild-autotools/repo/ tools 

Vui mừng

Để chạy các tập lệnh thử nghiệm có trong OpenWeave hoặc để sử dụng Cấu trúc liên kết mô phỏng, hãy cài đặt Happy trên máy Linux của bạn. Xem Happy setup để biết thêm thông tin.

Ứng dụng độc lập

Sử dụng ứng dụng độc lập OpenWeave mặc định cho máy chủ phát triển máy tính để bàn hoặc máy chủ.

1. Sao chép kho lưu trữ OpenWeave:

    git clone https://github.com/openweave/openweave-core.git 

2. Xây dựng ứng dụng độc lập OpenWeave:

    cd openweave-core
   make -f Makefile-Standalone 

Sử dụng cờ help với Makefile-Standalone để tìm hiểu các công tắc xây dựng nào có sẵn để tùy chỉnh bản dựng.

 make -f Makefile-Standalone help 

Ví dụ: để bật mã gỡ lỗi Dệt và ghi nhật ký:

 make -f Makefile-Standalone DEBUG=1 

Liên kết dự án

1. Sao chép kho lưu trữ OpenWeave:

    git clone https://github.com/openweave/openweave-core.git 

2. Định cấu hình môi trường xây dựng cho GNU Autotools:

    cd openweave-core
   ./bootstrap
   ./configure 

3. Xây dựng OpenWeave:

    make all 

4. Giai đoạn đầu ra đến một vị trí riêng biệt để liên kết dự án:

    mkdir <openweave-output>
   make DESTDIR= <openweave-output> install 

Sau khi dàn dựng, sử dụng các thư mục trong <openweave-output> để liên kết dự án:

• /usr/local/include - tiêu đề công cộng
• /usr/local/lib - thư viện

Android và iOS

Để xây dựng thư viện cho liên kết dự án Android và iOS, hãy sử dụng Makefiles dành riêng cho nền tảng:

 make -f Makefile-Android
make -f Makefile-iOS 

Sử dụng cờ help với Makefile- <platform> để tìm hiểu các công tắc xây dựng nào có sẵn để tùy chỉnh bản dựng. Ví dụ:

 make -f Makefile-Android help
make -f Makefile-iOS help 

Cấu hình

Trước khi định cấu hình OpenWeave với các tập lệnh và tiêu đề khác nhau, hãy sử dụng tính năng tự động để khởi động các tệp xây dựng có liên quan:

 ./bootstrap 

Bước này cần được thực hiện một lần, sau khi kiểm tra cây và sau đó về bất kỳ thay đổi nào đối với configure.ac hoặc Makefile.am . Không cần lặp lại khi chỉ cần thay đổi cấu hình hoặc mục tiêu bản dựng.

Chữ viết

Sử dụng cờ --help với tập lệnh cấu hình đi kèm để tìm hiểu thêm về các tùy chọn có thể định cấu hình.

 ./configure --help 

Ví dụ: để định cấu hình OpenWeave mà không cần hỗ trợ BlueZ:

 ./configure --without-bluez 

Tiêu đề

Các Makefiles kèm sử dụng hai tệp tiêu đề xác định các hằng số tại thời gian biên dịch:

• /src/inet/InetConfig.h
• /src/lib/core/WeaveConfig.h

Tiêu đề cấu hình dành riêng cho dự án cũng có thể được cung cấp. Đặt các tệp này trong thư mục dự án của bạn, không đặt chúng trong kho OpenWeave. Sử dụng tùy chọn cấu hình phù hợp để chỉ định vị trí của từng tệp trong khi định cấu hình:

Ví dụ: để định cấu hình OpenWeave để sử dụng tệp WeaveProjectConfig.h dành riêng cho dự án nằm trong ~/my-project/headers :

 ./configure --with-weave-project-includes=~/my-project/headers