Kontrola wersji oparta na Git

Repozytoria typu Git są tworzone poza Altium Designer, a zawartość lokalnego roboczego repozytorium Git jest dostępna poprzez otwieranie plików z jego folderu hosta. Zarządzanie zarówno zdalnymi, jak i lokalnymi roboczymi repozytoriami Git odbywa się zazwyczaj za pośrednictwem systemów firmowych i zewnętrznych narzędzi Git, natomiast operacje na poziomie plików (Commit, Push, Update itp.) są realizowane w środowisku edycji Altium Designer.

  • Aby uzyskać dostęp do funkcji Git Version Control w Altium Designer, należy zainstalować VCS Provider – Git rozszerzenie oprogramowania. To rozszerzenie jest domyślnie instalowane wraz z Altium Designer. Można je zainstalować lub usunąć ręcznie.

    Aby uzyskać więcej informacji o zarządzaniu rozszerzeniami, przejdź do Extending Your Installation strony (Altium Designer Develop, Altium Designer Agile, Altium Designer).

  • Zwróć uwagę, że repozytoria Git są obsługiwane poza Altium Designer.

  • Chociaż Git VCS oferuje szereg protokołów transferu danych, Altium Designer obecnie obsługuje wyłącznie protokół HTTP/HTTPS  dla połączeń pomiędzy lokalnym repozytorium Git a jego zdalnym repozytorium nadrzędnym (master). Dowiedz się więcej o Protocols.
  • Podczas wypychania (push) zmian do projektu, który jest pod kontrolą zewnętrznego Git VCS, jeśli repozytorium, w którym znajduje się projekt, używa protokołu SSH do połączenia, zostanie zaproponowany wybór, aby spróbować zaktualizować to repozytorium tak, by zamiast tego używało obsługiwanego protokołu połączenia HTTPS (o ile samo repozytorium obsługuje ten protokół).
  • Zwróć uwagę, że podczas pracy w Altium Designer z projektem hostowanym na GitHub należy używać personal access token. W przeciwnym razie podczas wypychania projektu do repozytorium pojawi się błąd uwierzytelniania. Dowiedz się więcej o Creating a personal access token.

Dodawanie do Git Version Control

Jako rozproszony system kontroli wersji Git wykorzystuje inny przepływ pracy niż SVN, choć różnica jest minimalna podczas pracy z istniejącymi plikami projektu w Altium Designer. W skrócie: Git opiera się na transferze danych pomiędzy wieloma repozytoriami, zamiast koncentrować się na zależności od pojedynczego docelowego repozytorium.

► Zobacz Git website, aby uzyskać więcej informacji, oraz Version Control Essentials, aby zapoznać się z przeglądem obowiązujących zasad.

System Git VCS jest zazwyczaj oparty na scentralizowanym, zdalnym serwerze Git, który w razie potrzeby może hostować wiele repozytoriów Git. Szybki i lekki charakter Git sprzyja praktyce tworzenia zdalnego repozytorium dla każdego projektu, które następnie może zostać sklonowane (skopiowane) jako repozytorium robocze do dowolnego użytkownika pracującego nad projektem. Zaktualizowane pliki w roboczym repozytorium Git użytkownika są następnie „wypychanie” (push) do zdalnego repozytorium na serwerze Git w celu uzyskania synchronizacji.

Zdalne repozytorium może być również współdzielonym repozytorium Git typu (bare) w dogodnej lokalizacji, na przykład na współdzielonym zasobie sieciowym. Aby utworzyć współdzielone zdalne repozytorium Git za pomocą narzędzi wiersza poleceń Git, użyj polecenia git init --bare.

Metoda zastosowana do umieszczenia projektu Altium Designer w systemie Git będzie zależeć od infrastruktury i praktyk firmy oraz będzie obejmować narzędzia i procesy zewnętrzne względem Altium Designer. Gdy jednak projekt znajdzie się w systemie kontroli wersji i będzie dostępny jako lokalne repozytorium robocze, praca z Git VCS w Altium Designer jest praktycznie taka sama jak praca z SVN VCS.

Dodawanie projektu do Git

Dla przykładu istniejący projekt Altium Designer można dodać do lokalnego repozytorium Git przy użyciu podstawowych Git command line tools. W tym podejściu folder projektu staje się lokalnym (roboczym) repozytorium Git, a następnie jest on powiązany i ostatecznie aktualizowany do dostępnego zdalnego repozytorium Git.

Tutaj narzędzia są używane do:

  1. Utworzenia (initialize) roboczego repozytorium Git w folderze projektu.
  2. Dodania plików projektu do kontroli wersji Git. Specyfikacja plików *.* dodaje pliki, ale nie foldery.
  3. Określenia link reference do współdzielonego zdalnego repozytorium Git na serwerze WWW. PCrepo jest wskazanym lokalnym aliasem adresu URL zdalnego repozytorium.

Projekt dodawany do lokalnego repozytorium GitProjekt dodawany do lokalnego repozytorium Git

Poniższe procesy Commit i Push można również wykonać za pomocą narzędzia wiersza poleceń, ale w tym przykładzie kroki są realizowane w Altium Designer, jak opisano poniżej.

Po otwarciu projektu w Altium Designer status jego plików w panelach Projects i Storage Manager to Scheduled for Addition (). Po wykonaniu commit do repozytorium roboczego pliki zmieniają status na Ahead of Server (), ponieważ nie są jeszcze objęte kontrolą wersji w zdalnym repozytorium Git.

  Pliki zaplanowane jako Scheduled for Addition oraz Ahead of Server

Polecenie Push zaktualizuje pliki lokalnego repozytorium na zdalnym serwerze Git, który może zażądać poprawnych poświadczeń dla docelowego repozytorium – jest to proces jednorazowy.

Pliki są aktualizowane po podaniu poprawnych poświadczeńPliki są aktualizowane po podaniu poprawnych poświadczeń

Projekt Altium Designer, który jest teraz w pełni objęty kontrolą wersji Git, staje się dostępny dla innych użytkowników ze zdalnego repozytorium Git. Inny użytkownik może na przykład clone repozytorium na swój komputer lokalny, a następnie w ramach współpracy wypchnąć swoje edytowane pliki z powrotem do zdalnego repozytorium.

Zwróć uwagę, że powyższy proces to jedynie ręczny przykład tego, jak projekt może zostać dodany do zdalnego serwera Git. Ugruntowane instalacje Git VCS prawdopodobnie mają GUI tools lub zautomatyzowane systemy, działające pod kontrolą administratora, które upraszczają proces zakładania i pobierania roboczych projektów VCS.

Altium Workspace jest przykładem zaawansowanego systemu serwerowego, który wykorzystuje repozytorium Git wraz z funkcjami automatycznymi wspierającymi transparentną interakcję z VCS.

Klonowanie repozytorium Git

Lokalny projekt dodany do Git Version Control może być edytowany przez Altium Designer z lokalnego folderu projektu (repozytorium roboczego), a zatwierdzone zmiany są następnie aktualizowane do zdalnego repozytorium Git. Repozytorium lokalne i zdalne są powiązane i ostatecznie synchronizowane poleceniem VCS Push.

Inni użytkownicy, którzy chcą współpracować nad projektem, mogą uzyskać do niego dostęp poprzez cloning zdalnego repozytorium Git do lokalnego repozytorium roboczego. Chociaż sposób uzyskiwania dostępu do plików ze zdalnego repozytorium Git będzie się różnił w zależności od systemów i metod firmowych, podstawowym sposobem sklonowania zawartości ze zdalnego repozytorium do lokalnego repozytorium roboczego jest użycie polecenia Git; git clone [remote repository URL] [target working repository folder], jak pokazano na poniższym obrazie.

Zatwierdzone zmiany zaktualizowane do zdalnego repozytorium GitZatwierdzone zmiany zaktualizowane do zdalnego repozytorium Git

Proces ten odtworzy współdzielone zdalne repozytorium jako lokalne repozytorium robocze i automatycznie pobierze (check out) najnowszą rewizję (HEAD) z gałęzi master. Następnie pliki można edytować, zapisywać i zatwierdzać (commit) do VCS w Altium Designer, a ostatecznie wypchnąć (push) z powrotem do zdalnego repozytorium Git.

Łączenie z istniejącym repozytorium Git

Altium Designer nie oferuje narzędzi do tworzenia nowego repozytorium Git ani do łączenia się z istniejącym. Możesz jednak skutecznie połączyć się z istniejącym repozytorium tego typu innymi metodami (czyli tradycyjną techniką preferowaną przez użytkowników Git). Aby to zrobić:

  1. Utwórz zdalne repozytorium Git lub uzyskaj dostęp do zewnętrznego repozytorium firmowego – w którym przechowywane są Twoje projekty Altium Designer.
  2. Sklonuj repozytorium, aby utworzyć lokalne robocze repozytorium Git.
  3. Otwórz projekt Altium Designer z lokalnego repozytorium.

Altium Designer rozpozna, że projekt jest objęty kontrolą wersji w repozytorium opartym na Git, i udostępni statusy związane z VCS oraz polecenia/funkcje do pracy z plikami (w tym Commit (do lokalnego roboczego repozytorium Git) oraz Push (z lokalnego repozytorium Git do zdalnego repozytorium Git)).

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Content