Kiểm soát phiên bản dựa trên Git

Các kho lưu trữ kiểu Git được tạo bên ngoài Altium Designer, và nội dung của một kho Git cục bộ đang làm việc được truy cập bằng cách mở các tệp từ thư mục chứa nó. Việc quản lý cả kho Git từ xa lẫn kho Git cục bộ đang làm việc thường được thực hiện thông qua các hệ thống của công ty và các công cụ Git bên ngoài, trong khi các thao tác ở mức tệp (Commit, Push, Update, v.v.) được xử lý trong môi trường chỉnh sửa của Altium Designer.

  • Để truy cập các khả năng Git Version Control trong Altium Designer, VCS Provider – Git phần mở rộng phần mềm phải được cài đặt. Phần mở rộng này được cài đặt cùng Altium Designer theo mặc định. Bạn cũng có thể tự cài đặt hoặc gỡ bỏ nó.

    Để biết thêm thông tin về cách quản lý các phần mở rộng, hãy tham khảo trang Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

  • Lưu ý rằng các kho Git được xử lý bên ngoài Altium Designer.

  • Khả năng hỗ trợ một phần cho các kho LFS có sẵn khi làm việc với Git version control. CẢNH BÁO: Altium Designer không hỗ trợ đầy đủ việc làm việc với các kho LFS và trong một số trường hợp điều này có thể dẫn đến mất dữ liệu người dùng.

    Tính năng này khả dụng khi tùy chọn VCS.AllowLFSRepos được bật trong hộp thoại Advanced Settings dialog.

  • Mặc dù Git VCS hỗ trợ nhiều giao thức truyền dữ liệu khác nhau, hiện tại Altium Designer chỉ hỗ trợ giao thức HTTP/HTTPS cho các kết nối giữa kho Git cục bộ và kho master từ xa của nó. Tìm hiểu thêm về Protocols.
  • Khi push các thay đổi lên một dự án đang nằm dưới một Git VCS bên ngoài và kho chứa thiết kế đó sử dụng giao thức SSH để kết nối, bạn sẽ được cung cấp tùy chọn thử cập nhật kho đó sang giao thức kết nối HTTPS được hỗ trợ thay thế (miễn là bản thân kho đó hỗ trợ giao thức này).
  • Lưu ý rằng phải sử dụng personal access token khi làm việc với dự án được lưu trữ trên GitHub từ Altium Designer. Nếu không, lỗi xác thực sẽ xuất hiện khi push dự án lên kho lưu trữ. Tìm hiểu thêm về Creating a personal access token.

Thêm vào Git Version Control

Là một hệ thống version control phân tán, Git sử dụng quy trình làm việc khác với SVN, mặc dù sự khác biệt là tối thiểu khi làm việc với các tệp dự án đã được thiết lập trong Altium Designer. Nói ngắn gọn, Git áp dụng việc truyền dữ liệu giữa nhiều kho lưu trữ, thay vì tập trung vào sự phụ thuộc của một kho đích duy nhất.

► Xem Git website để biết thêm thông tin và Version Control Essentials để có cái nhìn tổng quan về các nguyên tắc áp dụng.

Một hệ thống Git VCS thường dựa trên một máy chủ Git từ xa tập trung, có thể lưu trữ nhiều kho Git khi cần. Tính chất nhanh và gọn nhẹ của Git rất phù hợp với việc tạo một kho từ xa cho mỗi dự án, sau đó có thể được clone (sao chép) thành một kho làm việc cho bất kỳ người dùng nào đang tham gia dự án. Các tệp đã cập nhật trong kho Git làm việc của người dùng sau đó được ‘push’ lên kho từ xa trên máy chủ Git để đạt được sự đồng bộ.

Một kho từ xa cũng có thể là một kho Git kiểu dùng chung (bare) ở một vị trí thuận tiện, chẳng hạn như trên một tài nguyên mạng dùng chung. Để tạo một kho Git từ xa dùng chung bằng các công cụ dòng lệnh Git, hãy sử dụng lệnh git init --bare.

Phương pháp dùng để thiết lập một dự án Altium Designer trong hệ thống Git sẽ phụ thuộc vào hạ tầng và quy trình làm việc của công ty, đồng thời sẽ liên quan đến các công cụ và quy trình nằm ngoài Altium Designer. Tuy nhiên, khi dự án đã nằm trong hệ thống version control và sẵn sàng dưới dạng một kho cục bộ đang làm việc, thì làm việc với Git VCS trong Altium Designer hầu như giống với làm việc với SVN VCS.

Thêm một dự án vào Git

Ví dụ, một dự án Altium Designer hiện có có thể được thêm vào một kho Git cục bộ bằng các công cụ dòng lệnh Git cơ bản. Với cách tiếp cận này, thư mục dự án sẽ trở thành kho Git cục bộ (đang làm việc), và kho này được liên kết rồi cuối cùng được cập nhật tới một kho Git từ xa sẵn có.

Ở đây, các công cụ được dùng để:

  1. Tạo (khởi tạo) kho Git làm việc trong thư mục dự án.
  2. Thêm các tệp dự án vào Git version control. Quy ước tệp *.* thêm các tệp nhưng không thêm thư mục.
  3. Chỉ định tham chiếu liên kết đến kho Git từ xa dùng chung trên máy chủ web. PCrepo là bí danh cục bộ được chỉ định cho URL của kho từ xa.

Dự án đang được thêm vào một kho Git cục bộDự án đang được thêm vào một kho Git cục bộ

Các quy trình CommitPush sau đó cũng có thể được thực hiện bằng công cụ dòng lệnh, nhưng trong ví dụ này các bước được hoàn thành trong Altium Designer như trình bày bên dưới.

Khi dự án được mở trong Altium Designer, trạng thái của các tệp trong các panel ProjectsStorage ManagerScheduled for Addition (). Sau khi được commit vào kho làm việc, các tệp chuyển sang trạng thái Ahead of Server () vì tại thời điểm đó chúng vẫn chưa nằm dưới version control trong kho Git từ xa.

 Các tệp được lên lịch là Scheduled for Addition và Ahead of Server

Lệnh Push sẽ cập nhật các tệp của kho cục bộ lên máy chủ Git từ xa; quá trình này có thể yêu cầu thông tin xác thực hợp lệ cho kho đích – đây là bước chỉ cần thực hiện một lần.

Các tệp được cập nhật sau khi cung cấp thông tin xác thực hợp lệCác tệp được cập nhật sau khi cung cấp thông tin xác thực hợp lệ

Dự án Altium Designer, hiện đã hoàn toàn nằm dưới Git version control, sẽ sẵn sàng cho những người dùng khác từ kho Git từ xa. Ví dụ, một người dùng khác có thể clone kho đó về máy cục bộ của họ, rồi cuối cùng push các tệp đã chỉnh sửa của họ trở lại kho từ xa trong một quy trình cộng tác.

Lưu ý rằng quy trình trên chỉ là một ví dụ thủ công về cách một dự án có thể được thêm vào máy chủ Git từ xa. Các hệ thống cài đặt Git VCS hoàn chỉnh có thể sẽ có sẵn các công cụ GUI hoặc hệ thống tự động dưới quyền kiểm soát của quản trị viên, giúp quá trình thiết lập và truy xuất các dự án VCS đang làm việc trở nên đơn giản.

Một Altium Workspace là ví dụ về một hệ thống máy chủ nâng cao sử dụng kho Git với các chức năng tự động hỗ trợ tương tác VCS minh bạch.

Clone một kho Git

Một dự án cục bộ đã được thêm vào Git Version Control có thể được chỉnh sửa bằng Altium Designer từ thư mục cục bộ của dự án (kho đang làm việc), và các thay đổi đã commit sau đó được cập nhật lên kho Git từ xa. Kho cục bộ và kho từ xa được liên kết với nhau và cuối cùng được đồng bộ bằng một lệnh PushVCSPush.

Những người dùng khác muốn cộng tác trên thiết kế có thể truy cập dự án bằng cách clone kho Git từ xa thành một kho cục bộ đang làm việc. Mặc dù cách tiếp cận để truy cập các tệp từ một kho Git từ xa sẽ khác nhau tùy theo hệ thống và phương pháp của từng công ty, một cách cơ bản để clone nội dung từ kho từ xa sang kho cục bộ đang làm việc là dùng lệnh Git; git clone [remote repository URL] [target working repository folder], như minh họa trong hình bên dưới.

Các thay đổi đã commit được cập nhật lên kho Git từ xaCác thay đổi đã commit được cập nhật lên kho Git từ xa

Quy trình này sẽ sao chép kho từ xa dùng chung thành một kho cục bộ đang làm việc và tự động checkout bản revision mới nhất (HEAD) từ nhánh master. Sau đó, các tệp có thể được chỉnh sửa, lưu và commit vào VCS trong Altium Designer, rồi cuối cùng được push trở lại kho Git từ xa.

Kết nối đến một kho Git hiện có

Altium Designer không cung cấp các điều khiển để tạo một kho Git mới hoặc kết nối trực tiếp đến một kho hiện có. Tuy nhiên, bạn vẫn có thể kết nối hiệu quả tới một kho thuộc loại này bằng các cách khác (đây là kỹ thuật truyền thống được người dùng Git ưa dùng). Để thực hiện:

  1. Tạo kho Git từ xa của bạn hoặc truy cập kho lưu trữ bên ngoài của công ty – nơi các dự án Altium Designer của bạn được lưu trữ.
  2. Clone kho đó để tạo kho Git cục bộ đang làm việc của bạn.
  3. Mở một dự án Altium Designer từ kho cục bộ.

Altium Designer sẽ nhận biết rằng dự án đang nằm dưới version control trong một kho dựa trên Git, đồng thời cung cấp các trạng thái liên quan đến VCS và các lệnh/chức năng để làm việc với các tệp (bao gồm Commit (vào kho Git cục bộ đang làm việc) và Push (từ kho Git cục bộ lên kho Git từ xa)).

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Tính khả dụng của tính năng

Các tính năng có sẵn cho bạn phụ thuộc vào giải pháp Altium mà bạn đang sử dụng – Altium Develop, một phiên bản của Altium Agile (Agile Teams hoặc Agile Enterprise), hoặc Altium Designer (đang còn hiệu lực).

Nếu bạn không thấy tính năng được đề cập trong phần mềm của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Nội dung