Kontrola wersji oparta na Git

Repozytoria typu Git są tworzone poza Altium Designer, a dostęp do zawartości lokalnego roboczego repozytorium Git uzyskuje się przez otwieranie plików z 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 itd.) są wykonywane w środowisku edycyjnym Altium Designer.

 
 
 
 
 
  • Aby uzyskać dostęp do funkcji kontroli wersji Git w Altium Designer, musi być zainstalowane 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 na temat zarządzania rozszerzeniami, zobacz stronę Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

  • Należy pamiętać, ż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ń między lokalnym repozytorium Git a jego zdalnym repozytorium głównym. Dowiedz się więcej o Protocols.
  • Podczas wypychania zmian do projektu znajdującego się pod kontrolą zewnętrznego systemu Git VCS, jeśli repozytorium, w którym znajduje się ten projekt, używa do połączenia protokołu SSH, zostanie zaoferowana możliwość podjęcia próby zaktualizowania tego repozytorium tak, aby zamiast tego używało obsługiwanego protokołu połączenia HTTPS (pod warunkiem, że samo repozytorium obsługuje ten protokół).
  • Należy pamiętać, że podczas pracy z projektem hostowanym w GitHub z poziomu Altium Designer należy używać osobistego tokena dostępu. W przeciwnym razie podczas wypychania projektu do repozytorium pojawi się błąd uwierzytelniania. Dowiedz się więcej o tworzeniu osobistego tokena dostępu.

Dodawanie do kontroli wersji Git

Jako rozproszony system kontroli wersji, Git wykorzystuje inny przepływ pracy niż SVN, chociaż różnica jest niewielka podczas pracy z istniejącymi plikami projektu w Altium Designer. Krótko mówiąc, Git stosuje transfer danych między wieloma repozytoriami, zamiast koncentrować się na zależności od pojedynczego repozytorium docelowego.

► Więcej informacji można znaleźć na stronie Git, a przegląd obowiązujących zasad w Version Control Essentials.

System Git VCS jest zazwyczaj oparty na scentralizowanym, zdalnym serwerze Git, który może hostować wiele repozytoriów Git w zależności od potrzeb. 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 dla każdego użytkownika pracującego nad projektem. Zaktualizowane pliki w roboczym repozytorium Git użytkownika są następnie „wypychanie” 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 w udostępnionym zasobie sieciowym. Aby utworzyć współdzielone zdalne repozytorium Git za pomocą narzędzi wiersza poleceń Git, użyj polecenia git init --bare.

Metoda użyta do utworzenia 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. Jednak gdy projekt znajdzie się już 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

Tytułem przykładu, istniejący projekt Altium Designer można dodać do lokalnego repozytorium Git przy użyciu podstawowych narzędzi wiersza poleceń Git. Przy takim podejściu folder projektu staje się lokalnym (roboczym) repozytorium Git, a następnie jest łączony z dostępnym zdalnym repozytorium Git i ostatecznie do niego aktualizowany.

Tutaj narzędzia są używane do:

  1. Utworzenia (inicjalizacji) roboczego repozytorium Git w folderze projektu.
  2. Dodania plików projektu do kontroli wersji Git. Specyfikacja pliku *.* dodaje pliki, ale nie foldery.
  3. Określenia odnośnika łącza 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ą wykonywane w Altium Designer, jak opisano poniżej.

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

  Pliki zaplanowane do dodania i wyprzedzające serwer

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

Pliki są aktualizowane po podaniu prawidłowych poświadczeńPliki są aktualizowane po podaniu prawidłowych 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 sklonować repozytorium na swój komputer lokalny, a następnie w ramach współpracy wypchnąć swoje edytowane pliki z powrotem do zdalnego repozytorium.

Należy pamiętać, że powyższy proces jest jedynie ręcznym przykładem tego, jak projekt można dodać do zdalnego serwera Git. W istniejących instalacjach Git VCS prawdopodobnie stosowane są narzędzia GUI lub zautomatyzowane systemy, pozostające pod kontrolą administratora, które upraszczają proces tworzenia i pobierania roboczych projektów VCS.

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

Klonowanie repozytorium Git

Lokalny projekt dodany do kontroli wersji Git może być edytowany przez Altium Designer z lokalnego folderu projektu (repozytorium roboczego), a zatwierdzone zmiany są następnie aktualizowane do zdalnego repozytorium Git. Lokalne repozytorium i zdalne repozytorium są połączone i ostatecznie synchronizowane za pomocą polecenia Push systemu VCS.

Inni użytkownicy, którzy chcą współpracować nad projektem, mogą uzyskać do niego dostęp przez sklonowanie 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 stosowanych w firmie, 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 najnowszą rewizję (HEAD) z gałęzi głównej. Następnie pliki można edytować, zapisywać i zatwierdzać do VCS w Altium Designer, a ostatecznie wypchnąć z powrotem do zdalnego repozytorium Git.

Łączenie z istniejącym repozytorium Git

Altium Designer nie oferuje mechanizmów do tworzenia nowego repozytorium Git ani łączenia się z istniejącym. Można jednak skutecznie połączyć się z istniejącym repozytorium tego typu innymi sposobami (które są 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 swojej firmy — tego, w którym przechowywane są 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 znajduje się pod 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) i 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