Zalecaną i najbardziej efektywną metodą pracy nad projektami jest stworzenie nowego projektu bezpośrednio w połączonym Workspace. Jeśli masz już istniejący projekt, możesz przenieść go do swojego Workspace, udostępniając go online i decydując się na włączenie formalnej kontroli wersji. W każdym przypadku projekt będzie przechowywany i zarządzany przez natywny system kontroli wersji (VCS) Workspace. Daje to pełną funkcjonalność projektu podczas pracy z nim za pomocą Altium Designer. Posiadanie projektu pod pełną kontrolą VCS Workspace jest jedynym sposobem na udostępnienie tego projektu wielu osobom do edycji przez Altium Designer (pod warunkiem, że są członkami Workspace) i korzystanie z dodatkowych funkcji platformy, takich jak śledzenie historii i zaawansowane udostępnianie projektu.
Lokalny projekt, który nie jest pod kontrolą wersji lub jest pod zewnętrzną kontrolą wersji, może zostać zarejestrowany w twoim Workspace za pomocą metody nazywanej
Prosta Synchronizacja. W Workspace tworzone jest lustro twojego projektu i jest synchronizowane. Gdy lokalne zmiany w plikach zostaną zapisane (lub zapisane i zatwierdzone w zewnętrznym repozytorium projektowym), te zmiany są automatycznie synchronizowane z ich odpowiednikami w projekcie w Workspace. Prosta Synchronizacja pozwala korzystać z funkcji współpracy dostępnych przez platformę Altium 365, zachowując oryginalny projekt tam, gdzie jest. Należy jednak pamiętać, że dla lokalnego projektu projektowego (nie pod zewnętrzną kontrolą VCS), projekt ten może być edytowany tylko przez jedną osobę (właściciela tego projektu – tego, który udostępnił go online w Workspace).
Aby udostępnić istniejący projekt (lokalny projekt lub projekt aktualnie pod zewnętrzną kontrolą wersji) w Workspace – jako projekt zwierciadlany (Prosta Synchronizacja) w Workspace Altium 365 lub jeden pod natywną kontrolą wersji Git Workspace, otwórz projekt jak zwykle w Altium Designer, a następnie kliknij prawym przyciskiem myszy na jego wpis w panelu Projekty i wybierz Udostępnij Projekt Online z menu kontekstowego, dając dostęp do okna dialogowego Udostępnij Online. Podczas korzystania z Workspace Enterprise Server, polecenie Udostępnij Projekt na Serwerze otwiera okno dialogowe Udostępnij na Serwerze.
Podczas połączenia z Workspace z jedną lub więcej aktywnymi definicjami procesów dla tematu Tworzenia Projektów, udostępnianie istniejącego projektu w Workspace odbywa się przez kliknięcie prawym przyciskiem myszy na wpisie projektu w panelu
Projekty i wybranie polecenia z podmenu
Konwertuj na Zarządzany Projekt – dowiedz się więcej o
Konwertowaniu Projektu na Podstawie Procesu.
Udostępnij istniejący lokalny projekt w Workspace, zasadniczo 'rejestrując' go w Workspace i tworząc 'lustro' tego projektu.
Opcje i Kontrolki Okna Dialogowego Udostępniania Online
-
Nazwa Projektu – nazwa projektu w Workspace. Domyślnie nazwa będzie taka jak oryginalnego projektu.
-
Opis – wprowadź żądany opis projektu.
-
Kontrola Wersji – zaznacz tę opcję, aby dodać lokalny projekt do wbudowanego VCS (Git) Workspace. Jeśli ta opcja jest niezaznaczona, pliki projektu będą po prostu przechowywane w Workspace dla podstawowego dostępu i umożliwienia udostępniania innym do przeglądania i komentowania – mniej formalna Prosta Synchronizacja jakby. Zaleca się włączenie formalnej kontroli wersji, ponieważ dzięki temu uzyskasz dostęp do maksymalnej funkcjonalności oferowanej przez Workspace i platformę Altium 365. Ta opcja jest dostępna tylko, jeśli projekt aktualnie nie jest pod kontrolą wersji.
-
Migracja do Wersjonowanego Magazynu Altium 365 – włącz tę opcję, aby zmigrować projekt korzystający z zewnętrznego VCS do projektu pod pełną kontrolą VCS Workspace. Taki projekt może wtedy korzystać z natywnych funkcji VCS Workspace. Ta opcja jest dostępna tylko, jeśli projekt aktualnie jest pod zewnętrzną kontrolą VCS.
-
Zaawansowane – kliknij, aby uzyskać dostęp do dodatkowej opcji.
-
Folder – to pole służy do określenia, gdzie ma zostać utworzony folder dla migrowanego projektu – w strukturze folderów Workspace. Domyślna ścieżka dla nowych projektów jest określona na stronie Admin – Ustawienia – Projekty w interfejsie przeglądarki Workspace (domyślnie będzie to
Projekty\<NazwaProjektu>). Kliknij 
, aby otworzyć okno dialogowe Wybierz Folder, które jest uproszczoną wersją panelu Eksplorator, skąd możesz przeglądać i wybrać inny folder serwera, jeśli jest to wymagane.
Opcje i Kontrolki Okna Dialogowego Udostępniania na Serwerze
-
Nazwa Projektu – nazwa projektu w Workspace. Domyślnie nazwa będzie taka jak oryginalnego projektu.
-
Opis – wprowadź żądany opis projektu.
-
Migracja do Wersjonowanego Magazynu Altium – włącz tę opcję, aby zmigrować projekt korzystający z zewnętrznego VCS do projektu pod pełną kontrolą VCS Workspace. Taki projekt może wtedy korzystać z natywnych funkcji VCS Workspace. Ta opcja jest dostępna tylko, jeśli projekt aktualnie jest pod zewnętrzną kontrolą VCS.
-
Zaawansowane – kliknij, aby uzyskać dostęp do dodatkowych opcji.
-
Folder Repozytorium – to pole służy do określenia, gdzie ma zostać utworzony folder dla migrowanego projektu – w strukturze repozytorium Workspace. Kliknij , aby otworzyć okno dialogowe Dodaj do Kontroli Wersji, skąd możesz nawigować i utworzyć wymaganą strukturę folderów w repozytorium.
Udostępnij Online, kliknij
OK. Dla projektu, który nie jest pod zewnętrzną kontrolą wersji i gdy jest udostępniany online (w przestrzeni roboczej Altium 365, opcja
Kontrola Wersji została zaznaczona), projekt i pliki zostaną zatwierdzone i przesłane do repozytorium projektowego
Przechowywanie Wersjonowane w przestrzeni roboczej. Panel
Projekty następnie odzwierciedli w pełni zsynchronizowany stan istniejący między repozytorium projektowym w przestrzeni roboczej a lokalnym (kopia robocza) repozytorium, jak wskazują powiązane ikony
. Projekt staje się prawdziwym projektem przestrzeni roboczej – nie tylko 'zarejestrowanym' w przestrzeni roboczej, ale faktycznie zatwierdzonym i pod kontrolą wersji przestrzeni roboczej. Wszelkie zmiany wprowadzone w projekcie muszą być zapisane (zatwierdzone/przesłane) z powrotem do repozytorium w przestrzeni roboczej.
Projekt udostępniony w przestrzeni roboczej będzie następnie dostępny ze strony Projekty interfejsu przeglądarki przestrzeni roboczej.
Projekt udostępniony w przestrzeni roboczej początkowo będzie udostępniony z dostępem do odczytu/zapisu dla projektanta, który go utworzył (Właściciel), oraz wszystkich Administratorów przestrzeni roboczej. Aby uzyskać więcej informacji na temat konfigurowania uprawnień dostępu do projektu, zobacz
Udostępnianie projektu.
Ograniczenia przy użyciu istniejącego zewnętrznego repozytorium kontroli wersji
Jak wspomniano wcześniej, lokalne projekty mogą być już śledzone pod istniejącym, zewnętrznym systemem kontroli wersji (Git, SVN, EPDM itp.). Korzystając z przestrzeni roboczej Altium 365, możesz kontynuować korzystanie z tej konfiguracji jak wcześniej i po prostu udostępnić projekty w przestrzeni roboczej, rejestrując je w tej przestrzeni roboczej – używając funkcji Udostępnij Projekt Online.
W tym trybie, za każdym razem, gdy dokonujesz zmian w projekcie i zatwierdzasz te zmiany w zewnętrznym repozytorium VCS, dane projektu będą odbijane w przestrzeni roboczej w tle, i wszystkie potrzebne przetwarzania będą wykonywane jak zwykle – podgląd, gdzie używane itp. Istnieją jednak pewne ograniczenia, o których należy wiedzieć:
-
Tworzenie nowego projektu projektowego nadal musi następować zgodnie z poprzednim przepływem, tj. jest ręcznie tworzone w zewnętrznym systemie VCS. Projekt jest następnie rejestrowany i odbijany w przestrzeni roboczej za pomocą funkcji Udostępnij Projekt Online.
-
Jeśli zmiany w projekcie są dokonywane, ale zatwierdzenie/wysłanie jest wykonywane przez zewnętrzne narzędzia, a nie przez Altium Designer, wówczas te zmiany nie pojawią się dla odbitego projektu w przestrzeni roboczej. Jest to korygowane, gdy projekt jest ponownie otwierany w Altium Designer, który automatycznie synchronizuje lokalny projekt z odbitą wersją w przestrzeni roboczej. Jeśli zmiany zostały dokonane przez innego użytkownika, wówczas ponownie otwarte pliki projektu będą pokazywane jako
Nieaktualne (
) i mogą być skorygowane za pomocą polecenia kontroli wersji Aktualizuj.
-
Otwarcie projektu przez drugą osobę będzie wymagało dostępu do tego zewnętrznego repozytorium VCS.
-
Zarządzanie prawami będzie musiało być ustawione/utrzymywane w dwóch miejscach – w przestrzeni roboczej i w głównym źródle (zewnętrznym repozytorium VCS Git/SVN/itp.).
-
Niektóre funkcje dostarczane przez platformę Altium 365 działają tylko w przypadku, gdy projekt znajduje się pod natywnym systemem kontroli wersji przestrzeni roboczej. Zachowując projekt pod zewnętrznym systemem kontroli wersji, takie funkcje, gdy staną się dostępne dla platformy, nie będą dla Ciebie dostępne. Możesz przejść z korzystania z zewnętrznego VCS do natywnego VCS przestrzeni roboczej – zobacz następną sekcję aby poznać procedurę osiągnięcia tego.
Praca z GitHub
Korzystanie z platformy GitHub jako zewnętrznego systemu kontroli wersji (VCS) jest popularnym sposobem na hosting i udostępnianie projektów projektowych, a repozytoria Git są obsługiwane przez Altium Designer. Jak opisano powyżej dla przestrzeni roboczej Altium 365, istniejąca zewnętrzna konfiguracja VCS może być zsynchronizowana z (odbijana do) przestrzeni roboczej, co pozwala korzystać z jej zaawansowanych funkcji zarządzania danymi i współpracy.
Jak zwykle pracujesz z GitHubem, będzie zależeć od praktyk firmy lub po prostu narzędzi Git, które masz pod ręką. Ogólnie rzecz biorąc, projekt projektowy jest tworzony w lokalnym repozytorium Git, a następnie Wysyłany do repozytorium GitHub (zdalnego), lub istniejący projekt jest Klonowany do lokalnego repozytorium z GitHuba. Po umieszczeniu w lokalnym repozytorium Git, projekt może być otwarty w Altium Designer do edycji – oprogramowanie rozpozna i użyje lokalnych/zdalnych repozytoriów GitHub.
Jeśli projekt oparty na Gicie jest odbijany do przestrzeni roboczej Altium 365 (Udostępnij Projekt Online), projekt może być zarządzany i pracowany w Altium Designer jak każdy inny projekt przechowywany w przestrzeni roboczej. W tej konfiguracji przestrzeń robocza nadal zapewnia wszystkie zalety swojego systemu zarządzania projektami i również transparentnie komunikuje się z GitHubem, aby wykonać główne działania VCS – zatwierdzenie, wysyłanie, pobieranie itp. Altium Designer poprosi o dane logowania do GitHuba i zachowa je na potrzeby kolejnych interakcji z GitHubem.
Zauważ, że Altium Designer nie jest w stanie automatycznie połączyć się z GitHubem, jeśli konto GitHub zostało skonfigAby przenieść lokalny projekt VCS do w pełni zarządzanego projektu VCS w Twojej przestrzeni roboczej Altium 365, zaznacz opcję migracji VCS podczas udostępniania go online.
Okno dialogowe Migrate Project otworzy się i ostrzeże Cię, że projekt zostanie przeniesiony pod pełne zarządzanie VCS przestrzeni roboczej. Kliknij przycisk Browse , aby wybrać folder na dysku twardym, gdzie zostanie utworzone nowe (oparte na git) lokalne repozytorium projektu. Kliknij przycisk Migrate , aby kontynuować migrację.
Okno dialogowe Migrate Project
Po wykonaniu poleceń, które obejmują wykonanie ostatniego zatwierdzenia VCS, projekt jest teraz pod kontrolą wersji w repozytorium Git przestrzeni roboczej. Historia zatwierdzeń zewnętrznego VCS oraz jej komentarze/wiadomości są przenoszone do nowego projektu VCS przestrzeni roboczej, który można uzyskać w Altium Designer w widoku History – kliknij prawym przyciskiem myszy na nazwę projektu w panelu Projects i wybierz polecenie History & Version Control » Show Project History.
Po migracji, historia zatwierdzeń zewnętrznego VCS projektu (pokazana po lewej) jest przenoszona do widoku Historii Altium Designer (po prawej).
Zauważ, że pierwszym razem, gdy otworzysz Historię Projektu po procesie migracji, możesz zobaczyć, że dane dla wszystkich zawartych zatwierdzeń są obliczane. Przestrzeń robocza potrzebuje trochę czasu, aby przetworzyć te zatwierdzenia oraz różnice między nimi.
Jeśli zewnętrzny projekt VCS jest już zarządzany w przestrzeni roboczej Altium 365 jako mirrored project (synchronizowane pliki lokalno-serwerowe), jego pliki VCS mogą być przeniesione do natywnego repozytorium Git serwera za pomocą polecenia Migrate to Altium Versioned Storage, które jest dostępne z widoku Project History, okna dialogowego Project Options lub z menu kontekstowego prawego przycisku myszy panelu Projects History & Version Control.
Projekt VCS, który został zsynchronizowany z (odzwierciedlony do) Twojej przestrzeni roboczej, jest migrowany za pomocą opcji Migrate Project to Altium Version Control.
Wydajność migracji jest najszybsza, gdy źródłowy zewnętrzny VCS jest oparty na Git – proces jest prostszy, ponieważ VCS przestrzeni roboczej Altium 365 również opiera się na Git. Jednak w przypadku SVN, migracja może zająć trochę czasu w zależności od rozmiaru repozytorium i liczby zawartych zatwierdzeń.
Ograniczenia migracji VCS
-
Git
-
Repozytoria Git zawierające wiele projektów PCB są obsługiwane, gdy są połączone z przestrzenią roboczą Altium 365. Po kliknięciu OK w oknie dialogowym Make Available Online, zostaniesz poproszony o wybranie plików do migracji.
-
Plik projektu (
*.PrjPcb) powinien znajdować się w głównym folderze repozytorium Git.
-
SVN
-
Podstawowy protokół SVN
File nie jest obsługiwany.
-
Jeśli Twoje repozytorium SVN zawiera wiele projektów, proces migracji utworzy nowe lokalne foldery oprócz istniejącej kopii roboczej SVN. Dzieje się tak, ponieważ magazyn przestrzeni roboczej Altium 365 opiera się na Git, a repozytorium Git nie może być przechowywane wewnątrz kopii roboczej SVN.
-
Zatwierdzenia, które zawierają zewnętrzny plik względem folderu projektu, mogą nie być pokazane, ponieważ proces migracji rozpoznaje zatwierdzenia tylko do folderu projektu.
Po pomyślnej migracji zewnętrznego projektu VCS do przestrzeni roboczej Altium 365, link do zewnętrznego repozytorium jest automatycznie usuwany. Ta funkcja została wprowadzona w Altium Designer 23.0. Jeśli projekt został udostępniony w przestrzeni roboczej Altium 365 przy użyciu wcześniejszej wersji Altium Designer, wpis dla repozytorium może pojawić się na stronie
Data Management - Design Repositories w oknie dialogowym
Preferences. Jeśli jesteś administratorem przestrzeni roboczej i repozytorium nie ma odniesienia do projektu w przestrzeni roboczej, repozytorium można usunąć z przestrzeni roboczej, wybierając jego wpis i klikając przycisk
Remove. Należy zauważyć, że jeśli projekt został miękko usunięty (przeniesiony do Kosza), musi być trwale usunięty, aby repozytorium odnoszące się do niego mogło być usunięte. Repozytorium
Versioned Storage przestrzeni roboczej nie może być usunięte.
Współpraca po migracji
-
Gdy członek zespołu przestrzeni roboczej migruje projekt do Altium Versioned Storage, musi upewnić się, że inni współpracownicy projektu połączą się z przestrzenią roboczą zespołu, a następnie zaktualizują swoje lokalne (robocze) kopie projektu. Ostatnie jest wskazane w panelu Projects przez ikonę (Nieaktualne) skojarzoną z plikiem projektu i realizowane przez polecenie Project » History & Version Control » Update Whole Project.
-
Po zaktualizowaniu zmigrowanego projektu, Altium Designer zaoferuje aktualizację linków do nowego repozytorium poprzez odbudowę lokalnego folderu roboczego projektu. Wybierz zalecaną opcję w oknie dialogowym Fix version control link, aby zakończyć aktualizację lokalnego projektu.
-
Zauważ, że jeśli współpracownik projektu nie połączy się z przestrzenią roboczą zespołu, a następnie zatwierdzi zmiany projektowe VCS, będą one nadal rejestrowane w zewnętrznym repozytorium i w związku z tym nie będą zsynchronizowane z zmigrowanym projektem VCS przestrzeni roboczejNależy zauważyć, że projekt zasadniczo rozpoczyna swoją historię od nowa – nie zachowuje się żadna poprzednia historia wersji. Korzystając z Project Packager i wykonując migawkę projektu w tym momencie, zamiast usuwać projekt z kontroli wersji, zachowasz historię poprzedniego projektu powiązanego z VCS do tego momentu w czasie.
Przechodzenie z SVN Przestrzeni Roboczej do Git Przestrzeni Roboczej
Gdy Altium Designer jest połączony z Przestrzenią Roboczą Enterprise Server, a projekt konstrukcyjny jest przechowywany w repozytorium SVN zarządzanym przez usługę kontroli wersji Przestrzeni Roboczej Version Control Service, możesz zmigrować ten projekt z repozytorium SVN do wbudowanego repozytorium Git Przestrzeni Roboczej (Versioned Storage). Aby to zrobić, kliknij prawym przyciskiem myszy jego wpis w panelu Projects i wybierz polecenie History & Version Control » Migrate Project to Altium Versioned Storage z menu kontekstowego. Alternatywnie, kliknij przycisk Migrate to Server Versioned Storage w oknie dialogowym Project Options.
Po wykonaniu poleceń, które obejmują ostatnie zatwierdzenie VCS, projekt zostanie zmigrowany do kontroli wersji repozytorium Git Przestrzeni Roboczej.
Kontrolowanie synchronizacji projektu
Po udostępnieniu lokalnego projektu w Przestrzeni Roboczej Altium 365, kontrola jego dostępności online i synchronizacji jest zapewniona przez zakładkę General w oknie dialogowym Project Options.
Należy zauważyć, że zakładka General jest prezentowana tylko wtedy, gdy Altium Designer jest połączony z Przestrzenią Roboczą Altium 365, a nie z Przestrzenią Roboczą Enterprise Server.
Należy zauważyć, że zakładka General jest prezentowana tylko wtedy, gdy Altium NEXUS jest połączony z Przestrzenią Roboczą Altium 365, a nie z Przestrzenią Roboczą NEXUS Server.
Opcje i kontrole dotyczące udostępnienia projektu online są prezentowane na zakładce General okna dialogowego Project Options.
Użyj opcji dostępnej w obszarze General zakładki, aby dokonać zmian w opisie projektu. Dotyczy to tylko projektu odbitego w Przestrzeni Roboczej.
W obszarze Online Availability and Synchronization zakładki, opcja Version Control odzwierciedla obecny styl dostępności online:
-
Opcja Włączona – projekt (i jego pliki źródłowe) są przechowywane pod własnym natywnym systemem kontroli wersji Przestrzeni Roboczej (Git). Jest to zalecane podejście, ponieważ dzięki temu masz dostęp do maksymalnej funkcjonalności oferowanej przez Przestrzeń Roboczą i platformę Altium 365.
-
Opcja Wyłączona – pliki projektu są przechowywane w Przestrzeni Roboczej do podstawowego dostępu i umożliwienia udostępniania innym do przeglądania i komentowania tylko – układ Simple Sync.
Użyj opcji, aby zmieniać między tymi dwoma według potrzeb.
Ta opcja nie jest dostępna, jeśli projekt jest przechowywany w zewnętrznym repozytorium kontroli wersji.
Jeśli chcesz zatrzymać synchronizację między lokalnym projektem a zarządzaną inkarnacją tego projektu, która została udostępniona w Przestrzeni Roboczej, kliknij przycisk 
. Okno Turn off project synchronization pojawi się. Kliknij na opcję Unlink , a następnie kliknij OK z powrotem w oknie dialogowym Project Options. Lokalny projekt nie będzie już powiązany z projektem w Przestrzeni Roboczej.
Jest to odzwierciedlone w panelu Projects po zapisaniu lokalnego projektu, poprzez prezentację projektu pod aktywną Grupą Projektów (*.DsnWrk), a nie jako wpis pod aktywną Przestrzenią Roboczą. Zapis jest wymagany, ponieważ linki do projektu w Przestrzeni Roboczej są usuwane z pliku projektu.
Projekt w Przestrzeni Roboczej pozostaje nietknięty – nie jest usuwany przez tę akcję.
Możesz przerwać połączenie między lokalnym projektem a inkarnacją tego projektu udostępnioną w Przestrzeni Roboczej.
Zawsze możesz ponownie udostępnić lokalny projekt online, jako projekt odbity lub pełny projekt VCS (Version Control). Zakładka General okna dialogowego Project Options przedstawi przycisk 
, za pomocą którego można uzyskać dostęp do okna dialogowego Make Available Online.
Jeśli ponownie udostępniasz lokalny projekt online po wyłączeniu synchronizacji, możesz potrzebować zmienić nazwę projektu. Ponieważ wyłączenie synchroniz
