Sử dụng hệ thống kiểm soát phiên bản bên ngoài

Sơ lược

Theo dõi các thay đổi thiết kế bằng hệ thống kiểm soát phiên bản Git hoặc Subversion bên ngoài trong Altium Designer. Bài viết này giới thiệu kiến thức cơ bản về cách làm việc với các kho lưu trữ nằm ngoài Workspace được kết nối, giải thích cách truy cập các lệnh kiểm soát phiên bản và thông tin trạng thái tệp, đồng thời trình bày tổng quan về khả năng hỗ trợ cộng tác thiết kế nhiều người dùng. Đọc tiếp để tự tin hơn khi quản lý các tệp thiết kế và lịch sử phiên bản của chúng.

- Tìm hiểu những khác biệt cơ bản giữa quy trình làm việc với kho lưu trữ Git và SVN.
- Tìm hiểu nơi xem trạng thái tệp, truy cập lịch sử phiên bản và thực hiện các thao tác kiểm soát phiên bản trong bảng Projects và Storage Manager.
- Khám phá cách các tính năng so sánh sơ đồ nguyên lý và PCB hỗ trợ các nhóm cùng làm việc trên những thiết kế chung.
Tìm hiểu sâu hơn với AI:

Cách làm việc tiên tiến nhất với các dự án được kiểm soát phiên bản là khai thác các khả năng của một Workspace được kết nối. Workspace cung cấp một cấu trúc dự án tiên tiến, giúp đơn giản hóa quy trình làm việc và lưu trữ, nâng cao khả năng cộng tác cùng nhiều lợi ích khác.

Kho lưu trữ VCS đích trong Workspace được tích hợp chặt chẽ với cả Workspace và Altium Designer (khi đã đăng nhập), nhờ đó không cần thiết lập và cấu hình các kho lưu trữ VCS riêng biệt. Quyền truy cập của người dùng, nội dung kho lưu trữ và trạng thái của các dự án có thể được quản lý thông qua giao diện trình duyệt của Workspace. Nếu bạn đang sử dụng VCS nội bộ của một Workspace được kết nối, thông tin trên trang này không áp dụng cho bạn.

Tài liệu này trình bày chi tiết phương pháp cơ bản để sử dụng hệ thống kiểm soát phiên bản bên ngoài, trong đó kho lưu trữ không được lưu trữ trong một Workspace được kết nối. Các kho lưu trữ kiểm soát phiên bản này có thể nằm trên máy cục bộ, được truy cập qua mạng được kết nối hoặc nằm trên một sản phẩm máy chủ VCS chuyên dụng. Nếu bạn đang sử dụng VCS bên ngoài, hãy đọc tiếp.

Một trong những điểm mạnh lớn nhất của môi trường biên soạn và chỉnh sửa điện tử là khả năng tạo và sửa đổi tệp một cách dễ dàng. Khả năng này cho phép ghi lại, khám phá và hoàn thiện ý tưởng nhanh chóng, nhưng cũng khiến việc theo dõi các thay đổi đối với những tệp có giá trị như mã nguồn và dữ liệu thiết kế điện tử trở nên khó khăn.

Nhu cầu theo dõi các thay đổi đối với tệp, kết hợp với nhu cầu về một giải pháp có hệ thống để quản lý dữ liệu nguồn được ghi lại dưới dạng điện tử, đã dẫn đến sự ra đời của các hệ thống kiểm soát phiên bản (VCS). Hệ thống kiểm soát phiên bản là các công cụ phần mềm không chỉ có khả năng duy trì lịch sử các phiên bản khác nhau của một tệp, mà còn hỗ trợ mở bất kỳ bản sửa đổi nào của tệp đó, cũng như so sánh các thay đổi giữa hai phiên bản bất kỳ của tệp. VCS thường tích hợp với hệ điều hành (OS) cục bộ bằng cách cung cấp thêm các chức năng và thao tác quản lý phiên bản cho thư mục và tệp.

Các hệ thống kiểm soát phiên bản có thể hoạt động hoàn toàn độc lập với môi trường biên soạn và chỉnh sửa được sử dụng để tạo tệp. Chúng thường cung cấp một giao diện cho phép bạn thêm (Add), sau đó ghi nhận (Commit) tệp vào một vùng lưu trữ trung tâm gọi là kho lưu trữ, tính năng Checkout để sao chép tệp từ kho lưu trữ vào thư mục làm việc, tính năng Commit để ghi nhận lại mọi thay đổi vào kho lưu trữ, phương thức ghi nhật ký thông tin về thay đổi và nhiều tính năng khác.

Các tính năng này có trong những tiện ích mở rộng Windows shell như ứng dụng khách Tortoise và cũng được tích hợp ngay trong Altium Designer. Bạn có thể thực hiện các thao tác VCS trong môi trường Altium Designer mà không cần truy cập hệ thống tệp của hệ điều hành.

Việc hiểu rõ thuật ngữ dùng trong các hệ thống kiểm soát phiên bản sẽ rất hữu ích. Mặc dù có nhiều hệ thống khác nhau, nhìn chung chúng đều sử dụng các thuật ngữ tương tự để mô tả chức năng.

Kiến thức cơ bản về kiểm soát phiên bản

Altium Designer hỗ trợ các hệ thống kiểm soát phiên bản (VCS) Subversion (SVN) và Git. Nhờ hỗ trợ nội bộ cho các hệ thống này, Altium Designer cho phép truy cập các lệnh xử lý tệp SVN/Git thông dụng như Commit, Update, v.v. ngay trong phần mềm, cùng với các khả năng bổ sung của Subversion như tạo kho lưu trữ SVN. Khả năng này được tích hợp với các tính năng so sánh sơ đồ nguyên lý và PCB, giúp dễ dàng so sánh nhanh và xác định sự khác biệt giữa hai bản sửa đổi của tài liệu sơ đồ nguyên lý hoặc PCB, đồng thời giải quyết xung đột giữa các bản sửa đổi đồng thời đối với thiết kế PCB.

Phương pháp cơ bản khi làm việc với hệ thống kiểm soát phiên bản (VCS) là lấy một bản sao của các tệp dự án bạn muốn làm việc từ kho lưu trữ, chỉnh sửa các tệp trong Altium Designer, sau đó “ghi nhận” các tệp đã sửa đổi trở lại kho lưu trữ. Việc tương tác với kho lưu trữ được thực hiện thông qua giao diện hệ thống kiểm soát phiên bản mà Altium Designer đã tích hợp vào bảng Storage Manager và bảng Projects.

Điểm cốt lõi trong cách hoạt động của hệ thống kiểm soát phiên bản là giám sát trạng thái của các tệp được lấy từ kho lưu trữ thông qua một thư mục làm việc, từ đó theo dõi bản sửa đổi đang được sử dụng và liệu bản đó đã được sửa đổi hay chưa. Mặc dù kết quả là như nhau, cách bố trí kho lưu trữ và các tệp làm việc có sự khác biệt giữa các loại hệ thống kiểm soát phiên bản – Git hoặc SVN.

Hãy bảo đảm rằng các tiện ích mở rộng phần mềm VCS Provider - SVN và VCS Provider - Git đã được cài đặt trong Altium Designer. Các tiện ích mở rộng này được cài đặt mặc định cùng Altium Designer và có thể được cài đặt hoặc gỡ bỏ thủ công.

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

VCS Git

Hình dưới đây minh họa khái niệm kho lưu trữ Git từ xa dùng chung chứa một chuỗi các bản sửa đổi của tệp thiết kế (đến bản sửa đổi 5), với nội dung đã được sao chép vào kho lưu trữ Git làm việc cục bộ – thường bằng cách nhân bản (Clone) kho lưu trữ từ xa hoặc kéo (Pull) dữ liệu của kho đó vào kho lưu trữ làm việc. Khi các tệp trong kho lưu trữ làm việc được mở trong môi trường Altium Designer, Altium Designer nhận biết rằng tệp dự án đang được Git kiểm soát phiên bản, và trạng thái kiểm soát phiên bản hiện tại của tệp được hiển thị trong cả hai bảng Storage Manager và Projects.

Concept image showing how the files are managed by the Git Version Control System

► Xem trang Kiểm soát phiên bản dựa trên Git để biết thêm thông tin.

VCS Subversion

Hình dưới đây minh họa khái niệm kho lưu trữ Subversion chứa một chuỗi các bản sửa đổi của tệp thiết kế (đến bản sửa đổi 5), với bản sao mới nhất được lấy ra (File » Check Out) vào một thư mục làm việc. Khi các tệp trong thư mục làm việc được mở trong môi trường Altium Designer, Altium Designer nhận biết rằng tệp dự án đang được SVN kiểm soát phiên bản, và trạng thái kiểm soát phiên bản hiện tại của tệp được hiển thị trong cả hai bảng Storage Manager và Projects.

Concept image showing how the files are managed by the Subversion Version Control System

► Xem trang Kiểm soát phiên bản dựa trên SVN để biết thêm thông tin.

Trong cả hai hệ thống VCS nêu trên, liên kết giữa kho lưu trữ nguồn và vị trí làm việc được tham chiếu trong cơ sở dữ liệu VCS tại vị trí làm việc (trong thư mục con hệ thống .svn hoặc .git).

Khi các tệp làm việc VCS được mở trong Altium Designer, menu chuột phải trong bảng Storage Manager (và bảng Projects) cho phép bạn thực hiện các thao tác VCS tiêu chuẩn, chẳng hạn như ghi nhận một tệp đã thay đổi vào kho lưu trữ trung tâm (SVN) hoặc kho lưu trữ làm việc (Git).

Truy cập chức năng kiểm soát phiên bản

Trong Altium Designer, các thao tác liên quan đến VCS có thể được thực hiện thông qua các bảng Projects và Storage Manager, trong đó bảng thứ hai cho phép truy cập trực tiếp vào các lệnh và thông tin VCS bổ sung. Các bảng sẽ hiển thị tài liệu dự án và trạng thái VCS liên quan khi chúng được mở trong Altium Designer.

Bạn có thể mở các bảng từ menu của nút ở góc dưới bên phải của vùng làm việc hoặc từ menu chính View » Panels.

Bảng Projects

Bảng Projects hiển thị tất cả các dự án hiện đang mở trong Altium Designer, cùng với các tài liệu thành phần và trạng thái kiểm soát phiên bản tương ứng của từng tệp.

Trạng thái tệp VCS trong bảng được biểu thị bằng một loạt biểu tượng tương ứng với các tình trạng tệp cụ thể do hệ thống kiểm soát phiên bản phát hiện. Nhìn chung, trạng thái của mỗi tệp được xác định trong tương quan với bản tương ứng đang được kiểm soát phiên bản trong kho lưu trữ được liên kết. Các lệnh VCS trong bảng Projects được truy cập từ tùy chọn Version Control trong menu ngữ cảnh khi nhấp chuột phải của bảng.

Các biểu tượng kiểm soát phiên bản hiển thị trong bảng Projects Các biểu tượng kiểm soát phiên bản hiển thị trong bảng Projects

Các biểu tượng trạng thái VCS của bảng chỉ xuất hiện khi tùy chọn Show VCS status (trong General) được chọn trên trang Hệ thống – Bảng Projects của hộp thoại Preferences. Có thể cần khởi động lại để thay đổi có hiệu lực.

► Xem trang Bảng Projects để biết thêm thông tin.

Bảng Storage Manager

Bảng Storage Manager cung cấp cái nhìn toàn diện về tài liệu hiện hành từ góc độ lưu trữ tệp, đồng thời cho phép truy cập tính năng lịch sử tài liệu cục bộ và trạng thái/lệnh kiểm soát phiên bản.

Trạng thái tệp VCS trong bảng được biểu thị bằng một loạt mô tả và biểu tượng tương ứng, liên quan đến các tình trạng tệp cụ thể do hệ thống kiểm soát phiên bản phát hiện. Nhìn chung, trạng thái của mỗi tệp được xác định trong tương quan với bản tương ứng đang được kiểm soát phiên bản trong kho lưu trữ được liên kết.

Bảng Storage ManagerBảng Storage Manager

Các lệnh VCS trong bảng Storage Manager được truy cập từ menu ngữ cảnh khi nhấp chuột phải. Để thực hiện một thao tác VCS trên một tệp cụ thể, hãy nhấp chuột phải vào mục của tệp đó trong bảng rồi chọn lệnh mong muốn – ví dụ: Commit (Ghi nhận thay đổi), Update (Cập nhật), Resolve conflict (Giải quyết xung đột), v.v.

Lịch sử bản sửa đổi và lịch sử tài liệu cục bộ của tệp đã chọn có thể được xem ở phần dưới của bảng, hoặc dưới dạng dòng thời gian tổng thể của các sự kiện nếu bạn chuyển sang 'chế độ xem cổ điển' – Switch to Classic View trong các tùy chọn khi nhấp chuột phải. Số bản sửa đổi hiển thị sẽ tăng sau mỗi lần ghi nhận thay đổi vào VCS, trong đó bản sửa đổi đầu tiên (Bản sửa đổi 1) tương ứng với thời điểm tạo các thư mục dự án VCS, trước khi thêm tệp.

► Xem trang Bảng Storage Manager để biết thêm thông tin.

Trạng thái kiểm soát phiên bản

Trong cả hai bảng Projects và Storage Manager, trạng thái VCS hiện tại của mỗi tệp đang được kiểm soát phiên bản được hiển thị cùng với mục của tệp đó trong bảng.

Về cơ bản, hệ thống kiểm soát phiên bản theo dõi và so sánh các tệp trong thư mục làm việc với các bản tương ứng trong kho lưu trữ thiết kế. Altium Designer vừa yêu cầu vừa trao đổi thông tin với hệ thống kiểm soát phiên bản thông qua giao diện VCS, đồng thời phản hồi phù hợp với các trạng thái tệp được xác định qua so sánh. Trong thực tế, điều này được thể hiện qua các biểu tượng tệp trong bảng Projects và Storage Manager, qua một loạt cảnh báo VCS, cũng như qua các thay đổi tương ứng đối với những lệnh quản lý tệp khả dụng.

Các biểu tượng và ý nghĩa của chúng được mô tả trong phần Biểu tượng trạng thái kiểm soát phiên bản trên trang Quản lý tài liệu dự án .

Truy cập nhiều người dùng

Trong hầu hết các trường hợp, hạ tầng kiểm soát phiên bản của công ty sẽ dựa trên các kho lưu trữ SVN hoặc Git trung tâm, được cung cấp qua mạng bằng một trong các giao thức hiện có – svn, svn+ssh, https, v.v. Điều này cho phép tất cả người dùng trên mạng truy cập theo quyền được cấp, đồng thời cung cấp phương tiện để cộng tác phát triển dự án từ một nguồn duy nhất.

Nhờ đó, khả năng truy cập đồng thời cho phép các thành viên khác nhau trong nhóm tiếp tục làm việc độc lập trên một dự án mà không phải đợi người khác đưa tệp trở lại kho lưu trữ rồi mới có thể làm việc trên tệp đó. Một hệ thống kiểm soát phiên bản Git phân tán còn phát huy lợi thế này hơn nữa bằng cách cho phép ghi nhận các thay đổi của tệp vào kho lưu trữ làm việc cục bộ trong khi bạn làm việc, rồi ‘đẩy’ những thay đổi đã ghi nhận đó lên kho lưu trữ Git trung tâm vào bất kỳ thời điểm nào sau này – do đó, không cần kết nối mạng cho đến lúc ấy.

Tuy nhiên, một VCS phù hợp cho làm việc nhóm cần có sẵn các công cụ và kỹ thuật để giải quyết tình huống khó tránh khỏi khi hai người dùng cùng sửa đổi một tệp. Khi có những khả năng này, nền tảng cho hoạt động cộng tác thiết kế nhiều người dùng thực sự cùng các lợi ích đi kèm đã được thiết lập.

Để hỗ trợ tình huống này, Altium Designer có các khả năng so sánh sơ đồ nguyên lý và PCB (hay 'diff'), có thể truy cập thông qua bảng Storage Manager.

Kho lưu trữ VCS

Cách tốt nhất để làm việc từ một tập hợp tệp nguồn xác định là lưu trữ dự án thiết kế trong một môi trường được kiểm soát, chẳng hạn như kho lưu trữ kiểm soát phiên bản. Điều này rất quan trọng vì cách duy nhất để bảo đảm đầu ra được tạo từ đúng các tệp nguồn là:

  1. Xác nhận rằng tập hợp tệp nguồn đã được cập nhật.
  2. Tạo bản chụp trạng thái của các tệp đó.
  3. Tạo đầu ra từ bản chụp trạng thái đó.

Trong Altium Designer, kho lưu trữ như vậy được gọi là Design Repository. Thuộc sở hữu của nhóm thiết kế, Kho lưu trữ thiết kế cung cấp cái nhìn chi tiết về lịch sử của quá trình thiết kế và là công cụ cộng tác chính được nhóm thiết kế sử dụng.

Kho lưu trữ thiết kế trở thành kho lưu trữ trung tâm, nơi nhiều thành viên trong nhóm có thể lấy dữ liệu ra và đưa dữ liệu vào, đồng thời duy trì lịch sử bản sửa đổi đầy đủ của tất cả thay đổi đối với thiết kế. Vì vậy, một thiết kế được lưu trữ dưới dạng một chuỗi phiên bản của dự án và các tài liệu nguồn cấu thành, từng bước phác họa ý đồ của nhà thiết kế theo thời gian. Khi sử dụng Kho lưu trữ thiết kế có kiểm soát phiên bản, bạn được bảo đảm rằng không có bản sửa đổi nào của thiết kế bị mất, cho phép các thành viên trong nhóm cộng tác an toàn trên cùng một thiết kế dù ở các vị trí địa lý khác nhau. Bản chất của hệ thống kiểm soát phiên bản cung cấp một dấu vết kiểm toán cho thiết kế. Khả năng quy trách nhiệm đầy đủ được bảo đảm nhờ thông tin minh bạch về ai đã thay đổi nội dung gì, trong tài liệu nguồn nào và vào thời điểm nào. Hệ thống có thể hỗ trợ nhiều Kho lưu trữ thiết kế có kiểm soát phiên bản, với liên kết đến một kho lưu trữ cụ thể được thiết lập thông qua liên kết kiểm soát phiên bản trong thư mục dự án.

Khi kết nối với một Kho lưu trữ thiết kế, về thực chất bạn đang đăng ký kho lưu trữ đó với hệ thống – có thể hiểu là thông báo cho Altium Designer biết về sự tồn tại của nó. Hơn nữa, không có việc chỉ định thủ công đường dẫn đến các kho lưu trữ không chính thức hoặc 'ngoài luồng'. Thông qua Altium Designer, bạn chỉ có thể tương tác với những Kho lưu trữ thiết kế dựa trên VCS mà bạn đã chủ động kết nối với hệ thống.

Trước khi sử dụng tính năng kiểm soát phiên bản, các tệp dự án phải được cả VCS và Altium Designer nhận diện là đang được kiểm soát phiên bản. Quy trình này có thể khác nhau tùy theo phương thức và ứng dụng VCS, nhưng về cơ bản bao gồm việc tạo và/hoặc kết nối với một kho lưu trữ thiết kế, rồi thêm các tệp dự án thiết kế vào kho lưu trữ đó.

Các kho lưu trữ thiết kế dựa trên cấu trúc cơ sở dữ liệu và lưu trữ thông tin nội bộ theo hệ thống phân cấp tệp và thư mục, được gọi là cây tệp. Kho lưu trữ thực tế mà bạn kết nối có thể là kho lưu trữ SVN trung tâm, kho lưu trữ làm việc Git (được liên kết với một kho lưu trữ Git từ xa), hoặc kho lưu trữ bạn đã tạo ở một vị trí có thể truy cập, chẳng hạn như trên máy tính cục bộ hoặc một vị trí chia sẻ trên mạng.

VCS của Workspace được kết nối

Hình thức làm việc tiên tiến nhất với các dự án đang được kiểm soát phiên bản là khai thác các khả năng của một Workspace được kết nối. Workspace cung cấp cấu trúc dự án nâng cao, giúp đơn giản hóa quy trình làm việc và lưu trữ, tăng cường khả năng cộng tác cùng nhiều lợi ích khác.

Kho lưu trữ VCS đích trong Workspace được tích hợp chặt chẽ với cả Workspace và Altium Designer (khi đã đăng nhập), nhờ đó không cần thiết lập và cấu hình các kho lưu trữ VCS riêng biệt. Bạn có thể quản lý quyền truy cập của người dùng, nội dung kho lưu trữ và trạng thái dự án thông qua giao diện trình duyệt của Workspace.

Cập nhật các thay đổi mới vào hệ thống kiểm soát phiên bản

Khi một dự án được thêm vào hệ thống kiểm soát phiên bản, thư mục làm việc cục bộ của dự án sẽ được liên kết với thư mục tương ứng trong kho lưu trữ VCS, thể hiện qua biểu tượng liên kết bên cạnh các mục thư mục dự án trong bảng Storage Manager. Để xác nhận vị trí của thư mục và kho lưu trữ được liên kết, hãy nhấp chuột phải vào bất kỳ mục tệp nào trong bảng rồi chọn tùy chọn VCS Properties (không khả dụng khi sử dụng Git). Hộp thoại Properties xuất hiện sau đó sẽ hiển thị đường dẫn đến các vị trí được liên kết và thông tin về bản sửa đổi VCS mới nhất.

Tệp được đánh dấu bằng biểu tượng liên kết và bảng Properties tương ứng chứa thông tin về bản sửa đổi VCS mới nhất Tệp được đánh dấu bằng biểu tượng liên kết và bảng Properties tương ứng chứa thông tin về bản sửa đổi VCS mới nhất

Hộp thoại Properties cung cấp các thông tin sau (thông tin chỉ để xem; không được phép chỉnh sửa): 

  • Path - đường dẫn đến tài liệu cục bộ trong thư mục làm việc của bạn.
  • URL - URL đến vị trí của tài liệu trong kho lưu trữ VCS.
  • Repository Root - thư mục gốc của kho lưu trữ.
  • Repository UUID - UUID của kho lưu trữ.
  • Revision - bản sửa đổi hiện tại của tài liệu trong thư mục làm việc cục bộ.
  • Last Change Author - tác giả của thay đổi gần nhất.
  • Last Change Revision - bản sửa đổi của thay đổi gần nhất.
  • Last Change Time - ngày và giờ của thay đổi gần nhất.
  • Conflicted - tài liệu có bị xung đột hay không.

Nhờ liên kết VCS đã được đăng ký, hệ thống kiểm soát phiên bản có thể theo dõi và phát hiện mọi khác biệt giữa các tệp trong thư mục dự án cục bộ và các tệp tương ứng trong thư mục kho lưu trữ VCS. Khi phát hiện khác biệt, chẳng hạn như khi một tệp thiết kế đã được chỉnh sửa và lưu trong Altium Designer, hệ thống kiểm soát phiên bản sẽ chuyển trạng thái của tệp cục bộ thành Modified () và Altium Designer sẽ cung cấp tập hợp lệnh VCS phù hợp trong menu chuột phải của các bảng.

Ghi nhận thay đổi

Sau khi một tệp tài liệu dự án được chỉnh sửa và lưu trong Altium Designer, tệp sẽ được đánh dấu là Modified và được biểu thị tương ứng () trong cả bảng Projects và Storage Manager. Để ghi nhận các thay đổi đó thành một bản sửa đổi mới trong VCS, hãy nhấp chuột phải vào mục tệp trong bảng rồi chọn lệnh Commit từ menu ngữ cảnh hoặc chọn lệnh Project » History & Version Control » Commit từ các menu chính.

Khi ghi nhận thay đổi của một tệp, hộp thoại Chỉnh sửa chú thích sẽ mở ra. Sử dụng hộp thoại này để thêm chú thích nêu rõ lý do ghi nhận thay đổi, giúp người khác biết những thay đổi đã được thực hiện. Nếu đã thêm chú thích trước đó, bạn có thể nhanh chóng chọn dùng lại một trong các chú thích này.

Lệnh Commit Lệnh Commit

Bạn cũng có thể sử dụng lệnh Commit Whole Project để ghi nhận tất cả các tệp đã sửa đổi trong dự án. Khi ghi nhận toàn bộ dự án, hộp thoại Commit to Version Control sẽ mở ra.

Hộp thoại Commit to Version Control
Hộp thoại Commit to Version Control

  • When using Subversion (SVN): Quá trình ghi nhận sao chép tệp đã cập nhật từ thư mục cục bộ vào kho lưu trữ, tăng số bản sửa đổi của mục trong VCS và đặt lại trạng thái tệp thành No Modification ().
  • When using Git: Quá trình ghi nhận cập nhật kho lưu trữ làm việc VCS cục bộ, đồng thời tăng số bản sửa đổi của mục và đặt trạng thái tệp thành Ahead of Server (). Bạn có thể tiếp tục chỉnh sửa, lưu và ghi nhận các tệp trong kho lưu trữ làm việc hoặc xác nhận các thay đổi mới bằng lệnh Push để cập nhật kho lưu trữ Git từ xa – khi đó, trạng thái tệp sẽ trở về No Modification ().

Lưu ý rằng đối với các dự án Workspace dùng Git, các lệnh Commit và Commit Whole Project không khả dụng. Bạn có thể sử dụng lệnh Save to Server từ menu chuột phải của mục dự án trong bảng Projects để ghi nhận dự án Workspace vào kho lưu trữ cục bộ và đẩy lên kho lưu trữ từ xa chỉ trong một thao tác.

Nếu cần, bạn có thể bật các lệnh Commit và Commit Whole Project bằng cách bật tùy chọn VCS.AllowGitCommit trong hộp thoại Cài đặt nâng cao.

Sau khi một dự án được thêm vào hệ thống kiểm soát phiên bản, bạn có thể thêm và ghi nhận từng tệp bổ sung vào hệ thống kiểm soát phiên bản bằng các lệnh riêng lẻ Add to Version Control và Commit. Tương tự, bạn có thể loại bỏ từng tệp cụ thể khỏi hệ thống kiểm soát phiên bản (nhưng vẫn giữ lại trong dự án làm việc cục bộ) bằng lệnh Remove from Version Control.

Mở bảng Storage Manager để xem trình tự thao tác trong phần VCS Revisions, bao gồm việc tạo bản sửa đổi VCS mới (với số bản sửa đổi được tăng lên) cho tệp đó – trong trường hợp này là Bản sửa đổi 3 cùng chú thích đã thêm. Biểu tượng cho biết bản sửa đổi mới nhất và hiện tại của tệp đã chọn, hay theo thuật ngữ kiểm soát phiên bản là bản sửa đổi Head.

Mục VCS Revisions của Storage Manager bảng điều khiểnMục VCS Revisions của Storage Manager bảng điều khiển

Để xem kết hợp cả các mục bản sửa đổi và sự kiện lịch sử, hãy chuyển sang chế độ xem Timeline duy nhất bằng cách chọn Switch to Combined View từ menu ngữ cảnh khi nhấp chuột phải.

Lấy về từ hệ thống kiểm soát phiên bản

Như đã nêu ở trên, một dự án cục bộ đã được thêm vào hệ thống kiểm soát phiên bản có thể được chỉnh sửa bằng Altium Designer từ thư mục cục bộ của dự án, sau đó các thay đổi được cập nhật lên kho lưu trữ VCS. Thư mục cục bộ và thư mục trong kho lưu trữ được VCS liên kết và đồng bộ hóa.

Người dùng khác không thể truy cập dự án từ thư mục nguồn của dự án (nằm cục bộ trên PC của bạn) có thể sử dụng quy trình Clone (Git) hoặc Check Out (SVN) để lấy bản sao riêng của các tệp từ kho lưu trữ VCS chứa dự án. Tất cả người dùng muốn cộng tác thiết kế dự án đều cần kết nối với kho lưu trữ thiết kế dùng chung đó, thường được thiết lập để có thể truy cập qua mạng cục bộ hoặc từ máy chủ.

Thư mục dự án được chọn trong kho lưu trữ cùng các tệp bên trong sẽ được lấy về thư mục cục bộ đã chỉ định và mở trong Altium Designer. Lưu ý rằng thư mục cục bộ là thư mục được xác định làm thư mục lấy về cho kho lưu trữ đã chọn, và dự án được lấy về sau đó sẽ được liên kết với bản tương ứng trong kho lưu trữ VCS. Liên kết VCS chỉ dẫn hệ thống kiểm soát phiên bản theo dõi và phát hiện mọi khác biệt giữa các tệp trong thư mục lấy về cục bộ và các tệp tương ứng trong thư mục của kho lưu trữ VCS.

Ghi nhận các thay đổi khi hoàn tất việc chỉnh sửa tệp. Thao tác này sẽ đồng bộ hóa các tệp trong kho lưu trữ thiết kế để khớp với các tệp trong thư mục lấy về, đồng thời tạo một bản sửa đổi VCS mới.

Lấy về so với mở dự án

Khi một dự án local đã được thêm vào hệ thống kiểm soát phiên bản, trên thực tế có hai cách để chỉnh sửa và cập nhật dự án lên VCS:

  • Mở dự án cục bộ (File » Open Project) trong Altium Designer, sau đó ghi nhận các thay đổi đã lưu vào kho lưu trữ VCS. Trong trường hợp này, thư mục dự án cục bộ và thư mục tương ứng trong kho lưu trữ được VCS liên kết với nhau.

  • Lấy dự án (File » Check Out) từ kho lưu trữ VCS, sau đó ghi nhận các thay đổi đã lưu trong Altium Designer trở lại kho lưu trữ. Trong trường hợp này, dự án trong thư mục lấy về đã chỉ định và bản tương ứng trong kho lưu trữ được VCS liên kết với nhau.

Dự án cục bộ là nguồn, hay bản gốc, của dự án VCS đang được chia sẻ với những người dùng khác. Tùy theo cách bạn muốn làm việc, phiên bản nguồn cục bộ này có thể được xóa hoặc khóa để làm bản nguồn dự án lưu trữ, rồi sử dụng phương thức Check Out để tiếp tục chỉnh sửa. Hoặc bạn vẫn có thể tiếp tục mở và làm việc trên các tệp dự án từ thư mục “nguồn” cục bộ (Open Project).

Cách tốt nhất là chỉ sử dụng một phương thức (khuyến nghị dùng phương thức lấy về), vì hai phương thức này sử dụng thư mục làm việc ở các vị trí khác nhau – thư mục dự án nguồn cục bộ hoặc thư mục lấy về VCS đã chỉ định. Ngược lại, nếu sử dụng cả hai phương thức, trên PC cục bộ sẽ có nhiều bản sao đang hoạt động của cùng một dự án. Tuy nhiên, nếu các phiên bản này luôn được ghi nhận đầy đủ vào kho lưu trữ VCS tập trung sau mỗi lần chỉnh sửa, kho lưu trữ sẽ luôn chứa bản sửa đổi mới nhất của dự án, đúng như mục đích sử dụng.

Khi dự án không có sẵn trên máy cục bộ, chẳng hạn đối với người dùng khác, lựa chọn duy nhất là lấy dự án từ kho lưu trữ VCS.

Cũng lưu ý rằng sau lần đầu được lấy về từ kho lưu trữ VCS, dự án đã tồn tại trên máy cục bộ và có thể được mở lại trực tiếp từ thư mục lấy về (File » Open Project). Trong trường hợp này, bạn vẫn có thể chọn lấy dự án từ VCS hoặc mở phiên bản cục bộ, nhưng chỉ có duy nhất một bản sao cục bộ. Xét về cách vận hành thực tế của VCS, hai phương thức này rất giống nhau nhưng sẽ có hành vi khác nhau trong một số tình huống – chẳng hạn khi thiếu một tệp cục bộ, quy trình lấy về sẽ khôi phục tệp đó, trong khi lệnh Open Project sẽ xóa tệp đó khỏi dự án.

Các bản sửa đổi trong hệ thống kiểm soát phiên bản

Trong quá trình làm việc với các tài liệu thiết kế được quản lý bằng hệ thống kiểm soát phiên bản trong Altium Designer, các tệp thiết kế được truy cập từ kho lưu trữ VCS trung tâm (dùng chung) sẽ là bản sửa đổi mới nhất của các tệp đó. Khi hoàn tất các chỉnh sửa cục bộ và ghi nhận (hoặc đẩy lên, đối với Git) trở lại kho lưu trữ VCS dùng chung, các phiên bản tệp này sẽ trở thành các bản sửa đổi mới nhất.

Như vậy, trình tự thông thường gồm lấy về, chỉnh sửa, lưu và ghi nhận (và đẩy lên, đối với Git) sẽ lần lượt bổ sung các bản sửa đổi tệp mới vào VCS trung tâm trong quá trình phát triển thiết kế dự án. Tuy nhiên, khi nhiều nhà thiết kế cùng cộng tác phát triển một dự án, bất kỳ ai trong số họ cũng có thể ghi nhận các bản sửa đổi mới vào kho lưu trữ trung tâm (dùng chung) bất cứ lúc nào.

Bản sửa đổi lỗi thời

Sự tương tác giữa nhiều nhà thiết kế và kho lưu trữ trung tâm có thể biểu hiện theo nhiều cách, trong đó có trường hợp dự án đang mở trên máy cục bộ không còn là bản sửa đổi mới nhất – một dự án được lấy về từ kho lưu trữ hoặc được mở từ thư mục làm việc cục bộ có trạng thái Out of date () trong bảng điều khiển Projects.

Tệp được gắn nhãn Lỗi thờiTệp được gắn nhãn Lỗi thời

Trong trường hợp này, một người dùng khác đã chỉnh sửa và ghi nhận cùng dự án đó vào kho lưu trữ kể từ lần chỉnh sửa cục bộ gần nhất. Ví dụ, người dùng cục bộ Barry đang làm việc trên dự án và đã ghi nhận, chẳng hạn, Revision 14, nhưng một người dùng khác Harold đã ghi nhận Revision 15 sau thời điểm đó, như được chỉ ra trong bảng điều khiển Storage Manager bên dưới. Vì VCS phát hiện sự khác biệt giữa tệp trong thư mục làm việc cục bộ và tệp tương ứng trong kho lưu trữ (mới hơn trong trường hợp này), hệ thống xác định bản sửa đổi local mới nhất (được biểu thị bằng biểu tượng ) là lỗi thời.

Các trạng thái bản sửa đổi khác nhau trong Storage ManagerCác trạng thái bản sửa đổi khác nhau trong Storage Manager

Bạn có thể sử dụng chức năng So sánh của Altium Designer để xác định sự khác biệt giữa các bản sửa đổi tệp.

Tình huống này được khắc phục bằng cách cập nhật các tệp cục bộ cho khớp với các tệp trong kho lưu trữ VCS trung tâm, sử dụng lệnh Update từ menu ngữ cảnh khi nhấp chuột phải trong bảng điều khiển Projects hoặc Storage Manager. Hai phiên bản tệp sau đó được đồng bộ hóa, trong đó phiên bản cục bộ (của người dùng Barry) được cập nhật lên bản sửa đổi mới nhất – trong ví dụ này là Revision 15. Lưu ý rằng nếu bạn Save một tệp khi tệp đó được đánh dấu là Out of date, điều này sẽ tạo ra tình huống Conflict trong VCS, khi VCS phát hiện một bản sửa đổi cũ hơn của tệp đã được cập nhật trong thư mục làm việc.

Kho lưu trữ trung tâm và bản sửa đổi cục bộ trong Storage ManagerKho lưu trữ trung tâm và bản sửa đổi cục bộ trong Storage Manager

Bạn cũng có thể chọn lệnh Update Whole Project để truy cập hộp thoại Update from Version Control cho phép chọn các tệp cần lấy về từ kho lưu trữ dùng chung. Tất cả tài liệu trong dự án đã lỗi thời hoặc có xung đột đều được hiển thị trong hộp thoại. Bạn có thể chọn cập nhật các tài liệu cụ thể hoặc cập nhật tất cả cùng lúc. Các tài liệu được chọn sẽ được cập nhật từ kho lưu trữ và mặc định tất cả tài liệu lỗi thời đều được chọn. Tất cả tài liệu được chọn sẽ được cập nhật lên phiên bản mới nhất trong kho lưu trữ.

Hộp thoại Update from Version Control
Hộp thoại Update from Version Control

Cột Path hiển thị thư mục tệp.  Status hiển thị trạng thái hiện tại của tệp. Nếu trạng thái của tệp được hiển thị là Conflict, việc nhấp vào OK để cập nhật các tệp sẽ mở hộp thoại xác nhận. Nhấp vào OK để cập nhật lên phiên bản mới nhất trong kho lưu trữ hoặc Cancel để thoát và lưu các thay đổi vào phiên bản hiện có trong kho lưu trữ.

Tệp thiết kế sẽ không hiển thị trạng thái Out of date nếu dự án được mở từ thư mục đã lấy về cục bộ, thay vì được lấy ra từ kho lưu trữ. Lệnh Refresh của bảng Storage Manager (hoặc phím F5) có thể khắc phục điều này bằng cách kích hoạt VCS so sánh các thư mục được liên kết. Tuy nhiên, tình huống này cũng cho thấy rằng khi cộng tác qua kho lưu trữ SVN trung tâm, các dự án nên được lấy ra từ kho lưu trữ (thay vì mở trực tiếp từ máy cục bộ).

Xung đột bản sửa đổi

Việc nhiều nhà thiết kế tương tác với kho lưu trữ trung tâm cũng có thể dẫn đến tình huống hai người dùng Altium Designer cùng chỉnh sửa và lưu một tệp trên máy cục bộ, rồi một người đã ghi nhận các thay đổi đó vào kho lưu trữ.

Điều này có nghĩa là trình tự thao tác của một nhà thiết kế (lấy ra, chỉnh sửa, lưu, ghi nhận) đã đan xen với trình tự của nhà thiết kế khác. Vì vậy, tệp mà người dùng đã lấy ra từ kho lưu trữ để chỉnh sửa có thể không remain là bản sửa đổi mới nhất trong lúc đang làm việc — một người dùng khác đã cập nhật bản sửa đổi trong khoảng thời gian đó. Trong trường hợp này, người ghi nhận các chỉnh sửa vào kho lưu trữ trước sẽ chiếm ưu thế bằng cách tạo ra một bản sửa đổi mới, còn người dùng khác đã chỉnh sửa và lưu cùng tệp đó sẽ gặp tình trạng Conflict — được biểu thị bằng biểu tượng .

Ví dụ về xung đột bản sửa đổiVí dụ về xung đột bản sửa đổi

Theo góc nhìn của VCS, vốn so sánh các tệp trong thư mục làm việc với các tệp trong kho lưu trữ, xung đột là tình trạng một bản sửa đổi đã lỗi thời của tệp trong thư mục làm việc được chỉnh sửa và lưu.

Khi sử dụng hệ thống kiểm soát phiên bản Git, xung đột phát sinh khi hai nhà thiết kế đã chỉnh sửa, lưu và ghi nhận cùng một tệp vào thư mục kho lưu trữ Git cục bộ của mình, sau đó một người đẩy các thay đổi đó lên kho lưu trữ Git trung tâm (Remote). Lưu ý rằng các bản sửa đổi Git VCS sẽ được hiển thị dưới dạng chuỗi GUID trong bảng Storage.

Các bản sửa đổi Git VCS trong bảng Storage ManagerCác bản sửa đổi Git VCS trong bảng Storage Manager

Có một số tùy chọn lệnh có thể truy cập từ menu chuột phải History & Version Control của bảng Projects, menu chính Project » History & Version Control và bảng Storage Manager để sử dụng khi tệp có trạng thái Conflict:

  • Commit – tùy chọn này sẽ gây ra lỗi Subversion, vì việc ghi nhận bản sửa đổi đã chỉnh sửa cục bộ (chẳng hạn Revision 15) sẽ ghi đè lên bản sửa đổi mới hơn (Revision 16) mà người dùng khác đã ghi nhận.
  • Update – tùy chọn này sẽ cập nhật bản sửa đổi của tệp cục bộ lên phiên bản mới nhất từ kho lưu trữ trung tâm (Revision 16), do đó làm mất mọi thay đổi cục bộ bạn đã thực hiện đối với Revision 15.
  • Resolve Conflict – tùy chọn này sẽ loại bỏ các thay đổi được ghi nhận vào kho lưu trữ kể từ lần cập nhật gần nhất của bạn. Sau khi chạy lệnh, hộp thoại xác nhận sẽ xuất hiện — nhấp vào Yes để tiếp tục. Tệp dự án trong thư mục làm việc sẽ được cập nhật lên bản sửa đổi mới nhất mà người dùng khác đã đưa vào kho lưu trữ, nhưng trình chỉnh sửa sẽ giữ lại các thay đổi bạn đã thực hiện trên bản sửa đổi trước đó. Vì vậy, tệp cục bộ chuyển sang trạng thái Modified, cho phép bạn ghi nhận các thay đổi đó vào một bản sửa đổi mới trong kho lưu trữ bằng lệnh Commit hoặc lệnh Commit Whole Project. Sau khi bạn ghi nhận tệp dự án, người dùng khác sẽ thấy (các) tệp ở trạng thái Out of date, vì bạn đã tạo một bản sửa đổi mới hơn trong kho lưu trữ.

    Tùy chọn này chỉ được khuyến nghị khi tệp text bị xung đột, vì hệ thống Subversion sẽ cố gắng hợp nhất các khác biệt vào tệp cục bộ. Quá trình đó có thể làm hỏng các loại tệp khác như tài liệu thiết kế, vì vậy cách tốt nhất để giải quyết xung đột là cập nhật lên bản sửa đổi nguồn mới nhất hoặc hoàn tác các thay đổi cục bộ.

    Khi sử dụng Git, lệnh Resolve Conflict sẽ bỏ qua tình trạng xung đột bằng cách ghi nhận tệp vào thư mục kho lưu trữ cục bộ. Sau đó, khi tệp được đẩy lên kho lưu trữ từ xa, tệp của nhà thiết kế kia sẽ được đánh dấu là Out of Date và phải được cập nhật. Tuy nhiên, cũng như khi sử dụng Subversion, cách an toàn nhất là Update tệp bị xung đột lên bản sửa đổi nguồn mới nhất (gọi là Pull trong Git) hoặc Revert các thay đổi cục bộ.
  • Revert – Tùy chọn này sẽ làm mất (hoàn tác) các thay đổi cục bộ, đưa tệp cục bộ trở về bản sửa đổi cơ sở — trong trường hợp này là Revision 15. Nhờ đó, xung đột bản sửa đổi được giải quyết, nhưng tệp sau đó sẽ được đánh dấu là Out of date vì đã có một bản sửa đổi mới hơn (Revision 16) trong kho lưu trữ.

So sánh các bản sửa đổi

Một tính năng hữu ích khi làm việc với hệ thống kiểm soát phiên bản là khả năng so sánh các bản sửa đổi trước đây của tệp thiết kế. Tính năng này được cung cấp bởi công cụ so sánh khác biệt tích hợp trong Altium Designer và được truy cập từ bảng Quản lý lưu trữ. Khi kết hợp với bảng Khác biệt, bạn có thể so sánh về mặt logic hoặc đồ họa giữa các bản sửa đổi VCS, đồng thời tương tác để tìm hiểu các đối tượng bị ảnh hưởng. Có thể so sánh cả các bản sửa đổi sơ đồ nguyên lý lẫn PCB.

Để bắt đầu so sánh hai bản sửa đổi, hãy chọn cả hai mục (sử dụng phương pháp Ctrl+click thông thường) trong danh sách VCS Revisions của bảng Storage Manager, rồi chọn lệnh Compare từ menu ngữ cảnh khi nhấp chuột phải trong bảng.

Bạn cũng có thể sử dụng lệnh History & Version Control » Compare with Head  từ menu chuột phải của tài liệu trong bảng Projects để so sánh tài liệu đang được chọn với bản sửa đổi mới nhất của tài liệu đó trong kho lưu trữ VCS.

Lệnh Compare  trong bảng Storage ManagerLệnh Compare trong bảng Storage Manager

Cả hai bản sửa đổi của tệp sẽ được mở ở chế độ chia đôi màn hình để có thể so sánh trực quan. Các khác biệt được hiển thị phụ thuộc vào những tùy chọn đã chọn cho các kiểu so sánh vật lý trong thẻ Bộ so sánh của hộp thoại Options for Project – Project » Project Options.

Công cụ chính để định vị và xem các khác biệt khi so sánh là bảng Differences, cung cấp danh sách có thể chọn gồm các khác biệt về logic hoặc đồ họa giữa các tài liệu. Các mục được liệt kê trong bảng cho từng bản sửa đổi tài liệu tương tác với trình chỉnh sửa, cho phép tô sáng bằng đồ họa một khác biệt được phát hiện (chẳng hạn đối tượng đã di chuyển) khi được chọn.

Định vị và xem các khác biệt khi so sánh trong bảng DifferencesĐịnh vị và xem các khác biệt khi so sánh trong bảng Differences

Chức năng so sánh cũng áp dụng cho các bản sửa đổi của tài liệu PCB, cùng với các bản sửa đổi của tài liệu sơ đồ nguyên lý và tài liệu dạng văn bản.

  • Đối với tài liệu sơ đồ nguyên lý hoặc PCB (thiết kế hoặc thư viện), việc so sánh được thực hiện bằng đồ họa và các khác biệt phát hiện được sẽ được liệt kê trong bảng Differences. Khi hai phiên bản tài liệu được mở cạnh nhau trong cửa sổ trình chỉnh sửa thiết kế, bạn có thể xem xét các khác biệt một cách trực quan. Nhấp vào thư mục cấp cao nhất của một khác biệt được phát hiện sẽ đồng thời tô sáng khác biệt đó trên cả hai tài liệu.
  • Đối với tài liệu ASCII dạng văn bản, CompareForm hộp thoại sẽ xuất hiện, hiển thị phần so sánh khác biệt bằng đồ họa giữa hai phiên bản của tài liệu. Các tài liệu đã chọn được hiển thị cạnh nhau. Hộp thoại chỉ dùng để so sánh — không thể chỉnh sửa tài liệu đã tải. Bằng cách mã hóa màu, hộp thoại làm nổi bật các khác biệt giữa hai phiên bản tài liệu — dòng được thêm (màu hồng), dòng được sửa (màu xanh lá) và dòng bị xóa (màu xanh dương). Bản tóm tắt các thay đổi và chú giải màu được hiển thị ở góc dưới bên trái hộp thoại.

Chức năng so sánhChức năng so sánh

Lệnh Compare có thể được áp dụng cho bất kỳ cặp bản sửa đổi nào, kể cả giữa bản sửa đổi cục bộ hiện tại (trong thư mục làm việc) và một bản sửa đổi mới hơn trong kho lưu trữ. Trong trường hợp này, bản sửa đổi cục bộ mới nhất được hiển thị trong bảng Storage Manager là Out of date () nhưng vẫn có thể được so sánh với một bản sửa đổi mới hơn do người dùng khác thêm vào kho lưu trữ.

Bản sửa đổi cục bộ được hiển thị trong bảng Storage Manager là Lỗi thờiBản sửa đổi cục bộ được hiển thị trong bảng Storage Manager là Lỗi thời

Cách tiếp cận này cho phép bạn xem trước bằng đồ họa các thay đổi sẽ được áp dụng khi cập nhật lên bản sửa đổi mới. Trong hình minh họa ở trên, bản sửa đổi cục bộ hiện tại (được biểu thị bằng biểu tượng ) là Revision 19 nhưng một người dùng khác đã đưa một bản sửa đổi mới vào kho lưu trữ (Revision 22). Việc bắt đầu so sánh trực quan giữa Revision 19 và Revision 22 giúp bạn có đủ thông tin để quyết định có chấp nhận các thay đổi mới từ kho lưu trữ hay không, và theo đó, liệu bạn sẽ áp dụng lệnh Update hay ghi đè bằng cách tạo ra trạng thái Xung đột – thông quaviệc lưu lại tệp cục bộ và giải quyết xung đột theo hướng ưu tiên phiên bản cục bộ của bạn.

Thuật ngữ kiểm soát phiên bản

Thuật ngữ Ý nghĩa
Base

Bản sửa đổi trong kho lưu trữ mà bạn đã lấy về làm Working Copy cục bộ. Còn được gọi là bản sửa đổi đã lấy về.

Check-in

Lưu bản sao làm việc của tệp vào kho lưu trữ. Được gọi là Commit trong Altium Designer.

Check-out

Lấy một bản sao của tệp từ kho lưu trữ VCS vào thư mục làm việc. Đây thường là bản sửa đổi mới nhất của tệp, nhưng cũng có thể lấy về mọi bản sửa đổi trước đó. Tùy thuộc vào VCS, tệp có thể được đánh dấu là đã lấy về thông thường hoặc đã lấy về độc quyền (bị khóa).

Clone

Một lệnh Git sao chép (nhân bản) kho lưu trữ Git từ xa thành kho lưu trữ Git làm việc trong một thư mục cục bộ, đồng thời tự động lấy phiên bản HEAD (mới nhất) về thư mục đó. Kho lưu trữ cục bộ bao gồm tham chiếu liên kết đến kho lưu trữ từ xa (trong trường hợp này là origin), nhờ đó các tệp được cập nhật trong kho lưu trữ làm việc cục bộ có thể được tải lên kho lưu trữ từ xa bằng lệnh Push.

Commit

Lưu bản sao làm việc của tệp trở lại kho lưu trữ. Được gọi là Check-in trong một số hệ thống kiểm soát phiên bản. Trong Phần mềm Thiết kế Altium, lệnh Save thông thường lưu tệp đã chỉnh sửa vào thư mục làm việc, còn Commit lưu tệp trong thư mục đó vào kho lưu trữ dưới dạng một bản sửa đổi (phiên bản) mới.

Conflict

Tình huống hai người dùng Altium Designer cố gắng đưa các thay đổi ảnh hưởng đến cùng một vùng của cùng một tệp vào kho lưu trữ. Những xung đột này phải được giải quyết bằng công cụ hợp nhất, theo cách thủ công hoặc bằng cách xác định phiên bản nào sẽ được ưu tiên (trở thành bản sửa đổi mới).

Database

Nơi lưu trữ chính của tất cả các tệp được kiểm soát phiên bản (hoặc mã nguồn) — trong thực tế còn được gọi là Repository .

Git

Git là một hệ thống kiểm soát phiên bản mã nguồn mở. Altium Designer tích hợp các chức năng Git (thông qua phần mở rộng VCS Provider - Git), cho phép theo dõi và truy cập trực tiếp các bản sửa đổi từ bảng Quản lý lưu trữ và Dự án.

Head

Bản sửa đổi mới nhất được đưa vào hệ thống kiểm soát phiên bản.

Log message

Chú thích về các thay đổi được thực hiện đối với một bản sửa đổi khi bản đó được đưa trở lại kho lưu trữ (commit). Các thông điệp nhật ký có thể được dùng để tóm tắt tiến trình thay đổi của một tệp.

Project

Nhiều hệ thống kiểm soát phiên bản hỗ trợ khái niệm dự án. Dự án VCS là một tập hợp các tệp liên quan có thể được đưa vào/lấy ra cùng nhau. VCS cũng có thể hỗ trợ các tính năng khác dành cho dự án, chẳng hạn như đặt số phiên bản cho tất cả các tệp trong một dự án. Khái niệm này khác với khái niệm dự án Altium Designer, vốn có thể được thêm vào hệ thống Kiểm soát Phiên bản bằng lệnh Thêm thư mục dự án vào hệ thống Kiểm soát Phiên bản.

Push

Cập nhật kho lưu trữ Git từ xa bằng (các) tệp trong kho lưu trữ làm việc cục bộ — nhằm đồng bộ hóa kho lưu trữ cục bộ và từ xa. Lệnh này khả dụng khi một tệp trong kho lưu trữ Git cục bộ mới hơn tệp tương ứng trong kho lưu trữ Git từ xa. Về mặt khái niệm, đây là thao tác đối ứng với lệnh Git Pull.

Repository

Nơi lưu trữ chính của tất cả các tệp được kiểm soát phiên bản (hoặc mã nguồn) — còn có thể được gọi là Database.

Revision

Một thay đổi đã được ghi nhận trong lịch sử của một tệp hoặc một tập hợp tệp. Đây là mã tham chiếu gồm chữ và số do VCS cung cấp để theo dõi các bản (phiên bản) khác nhau của tệp mà hệ thống đang lưu giữ.

Sandbox

Thư mục chứa các tệp được lấy về từ kho lưu trữ để làm việc — còn được gọi là Working Folder. Các tệp được lấy về từ Phần mềm Thiết kế Altium sẽ tự động được tải.

SVN

Subversion là một hệ thống kiểm soát phiên bản mã nguồn mở. Altium Designer tích hợp các chức năng SVN (thông qua phần mở rộng VCS Provider - SVN), cho phép theo dõi và truy cập trực tiếp các bản sửa đổi từ bảng Quản lý lưu trữ và Dự án.

Update

Thao tác kiểm tra và “kéo về” các thay đổi từ phiên bản của tệp trong kho lưu trữ vào bản sao làm việc (thao tác đối ứng với Commit hoặc Check-in). Quá trình hợp nhất mọi khác biệt cần có công cụ hợp nhất hoặc phải cập nhật thủ công.

VCS

Hệ thống kiểm soát phiên bản: Thuật ngữ chung chỉ mọi công cụ có khả năng quản lý lịch sử phiên bản của tệp và truy xuất tệp.

Version

Thuật ngữ phiên bản thường được dùng để chỉ số tham chiếu bên ngoài do con người gán cho các tệp được kiểm soát hoặc đầu ra của chúng (chẳng hạn như trong trường hợp mã nguồn). Thông thường, đây được xem là một bản sửa đổi.

Working Copy

Bản sao “cục bộ” của một tệp, nơi các thay đổi được thực hiện — thường nằm trong Working Folder.

Working Folder

Thư mục chứa các tệp được lấy về từ kho lưu trữ để làm việc — với Git, đây là Kho lưu trữ Làm việc cục bộ. Các tệp được lấy về từ Altium Designer sẽ tự động được tải.

Tài liệu tham khảo

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.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế 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.

Contents