Các phân hệ phụ¶
Tổng quan¶
Mô-đun con Git cho phép bạn tích hợp các dự án Git khác vào mã của mình mà không cần phải sao chép-dán tất cả mã của chúng .
Thật vậy, các mô-đun tùy chỉnh của bạn có thể phụ thuộc vào các mô-đun từ các kho lưu trữ khác. Về Odoo, tính năng này cho phép bạn thêm các mô-đun từ kho Git khác vào các nhánh của kho lưu trữ của bạn. Việc thêm các phần phụ thuộc này vào nhánh của bạn thông qua các mô-đun con giúp việc triển khai mã và máy chủ của bạn dễ dàng hơn vì bạn có thể sao chép các kho lưu trữ được thêm dưới dạng mô-đun con cùng lúc với việc sao chép kho lưu trữ của riêng mình.
Ngoài ra, bạn có thể chọn nhánh của kho lưu trữ được thêm dưới dạng mô-đun con và bạn có quyền kiểm soát bản sửa đổi mà mình muốn. Bạn có thể quyết định xem bạn có muốn ghim mô-đun con vào một bản sửa đổi cụ thể hay không và khi nào bạn muốn cập nhật lên bản sửa đổi mới hơn.
Trong Odoo.sh, các mô-đun con cung cấp cho bạn khả năng sử dụng và phụ thuộc vào các mô-đun có sẵn trong các kho lưu trữ khác. Nền tảng sẽ phát hiện rằng bạn đã thêm các mô-đun thông qua các mô-đun con trong các nhánh của mình và tự động thêm chúng vào đường dẫn bổ trợ để bạn có thể cài đặt chúng trong cơ sở dữ liệu của mình.
Nếu bạn thêm các kho lưu trữ riêng dưới dạng mô-đun con trong các nhánh của mình, bạn cần định cấu hình khóa triển khai trong cài đặt dự án Odoo.sh và trong cài đặt kho lưu trữ của mình. Nếu không thì Odoo.sh sẽ không được phép tải chúng xuống. Quy trình này được trình bày chi tiết trong chương Settings > Submodules.
Thêm một mô-đun con¶
Với Odoo.sh (đơn giản)¶
Cảnh báo
Hiện tại, không thể thêm kho lưu trữ riêng tư bằng phương pháp này. Tuy nhiên, bạn có thể làm như vậy với Git.
Trên Odoo.sh, trong giao diện nhánh của dự án, hãy chọn nhánh mà bạn muốn thêm mô-đun con vào.
Ở góc trên bên phải, nhấp vào nút Submodule, sau đó nhấp vào Run.

Một hộp thoại có biểu mẫu được hiển thị. Điền thông tin đầu vào như sau:
URL kho lưu trữ: URL SSH của kho lưu trữ.
Chi nhánh: Chi nhánh bạn muốn sử dụng.
Đường dẫn: Thư mục mà bạn muốn thêm mô-đun con này vào nhánh của mình.

Trên Github, bạn có thể lấy URL kho lưu trữ bằng nút Sao chép hoặc tải xuống của kho lưu trữ. Đảm bảo sử dụng SSH.

Với Git (nâng cao)¶
Trong một thiết bị đầu cuối, trong thư mục nơi kho lưu trữ Git của bạn được sao chép, hãy kiểm tra nhánh mà bạn muốn thêm mô hình con:
$ git checkout <branch>
Sau đó, thêm mô hình con bằng lệnh bên dưới:
$ git submodule add -b <branch> <git@yourprovider.com>:<username/repository.git> <path>
Thay thế
<git@yourprovider.com>:<username/repository.git> theo URL SSH của kho lưu trữ mà bạn muốn thêm dưới dạng mô-đun con,
<branch> theo nhánh bạn muốn sử dụng trong kho lưu trữ ở trên,
<path> theo thư mục mà bạn muốn thêm mô-đun con này vào.
Cam kết và đẩy các thay đổi của bạn:
$ git commit -a && git push -u <remote> <branch>
Thay thế
<remote> bởi kho lưu trữ mà bạn muốn đẩy các thay đổi của mình vào đó. Đối với thiết lập Git tiêu chuẩn, đây là origin.
<branch> theo nhánh mà bạn muốn thực hiện các thay đổi của mình. Rất có thể là nhánh bạn đã sử dụng
gitcheck
ở bước đầu tiên.
Bạn có thể đọc tài liệu git-scm.com để biết thêm chi tiết về các mô-đun con Git. Ví dụ: nếu bạn muốn cập nhật các mô-đun con của mình để có bản sửa đổi mới nhất, bạn có thể làm theo chương Thực hiện các thay đổi ngược dòng.
Bỏ qua các mô-đun¶
Nếu bạn đang thêm một kho chứa nhiều mô-đun, bạn có thể muốn bỏ qua một số mô-đun phòng trường hợp có bất kỳ mô-đun nào được cài đặt tự động. Để làm như vậy, bạn có thể thêm .
vào tiền tố thư mục mô-đun con của mình. Nền tảng sẽ bỏ qua thư mục này và bạn có thể tự tay chọn các mô-đun của mình bằng cách tạo liên kết tượng trưng đến chúng từ một thư mục khác.