Releasing Locally

W skrócie

Opublikuj swój projekt lokalnie z poziomu Altium Designer, korzystając z niezarządzanego trybu (Offline) narzędzia Project Releaser, gdy nie używasz przestrzeni roboczej lub nie możesz się z nią obecnie połączyć. W tym artykule wyjaśniamy, jak wybrać lokalny folder lub archiwum ZIP jako miejsce docelowe publikacji, skonfigurować dane wyjściowe i ścieżki oraz przejść przez walidację, generowanie danych, przegląd i końcowy raport z wykonania. Czytaj dalej, aby sprawnie skonfigurować i przeprowadzić lokalną publikację projektu.

- Dowiedz się, jak wybrać publikację do folderu lub archiwum ZIP oraz dostosować foldery docelowe i ścieżki wyjściowe.
- Poznaj kontrole poprzedzające publikację, wymagania dotyczące walidacji i opcje przeglądania wygenerowanych danych przed zakończeniem publikacji.
- Zapoznaj się z ważnymi zabezpieczeniami, w tym zasadami nadpisywania danych i ograniczeniami dotyczącymi zmian w projekcie podczas przygotowywania publikacji.
Zagłęb się w temat dzięki AI:

Oprócz zarządzanego trybu wydawania (Online), Project Releaser umożliwia również lokalne, niezarządzane wydawanie (Offline). Ten tryb jest zwykle używany, gdy nie korzystasz z Workspace lub nie możesz się z nim w danej chwili połączyć. Chociaż Project Releaser w miarę możliwości automatycznie określa tryb, a w mniej jednoznacznych przypadkach udostępnia opcje do wyboru, zawsze możesz wymusić użycie trybu Offline. W tym celu ustaw Release Target na karcie Release Options w oknie dialogowym Project Release Options (kliknij przycisk na etapie 1 procesu wydawania) na jedną z następujących opcji:

  • Unmanaged - Folder: wybierz tę opcję, aby zapisać wygenerowane dane w folderze lokalnym. Ścieżkę folderu głównego określa się na karcie Output Path tego okna dialogowego. Domyślnie jest ona ustawiona na [OutputPath] (z wykorzystaniem ścieżki zdefiniowanej w polu Output Path na karcie Options w oknie dialogowym Project Options).

  • Unmanaged - Zip: wybierz tę opcję, aby zapisać wygenerowane dane w folderze lokalnym. Dane zostaną spakowane do jednego pliku ZIP. Ścieżkę i nazwę pliku ZIP określa się na karcie Output Path tego okna dialogowego. Domyślnie są one ustawione na [OutputPath][ProjectName].zip (z wykorzystaniem ścieżki zdefiniowanej w polu Output Path na karcie Options w oknie dialogowym Project Options).

Podczas definiowania wymaganej ścieżki wyjściowej możesz używać wpisów [ProjectName] i [<ProjectParameterName>].

Możesz szybko sprawdzić, czy Project Releaser jest skonfigurowany w trybie Offline, na podstawie następujących oznak:

  • Tytuł etapu 1 to Configure Local Release, zamiast Configure Server Release (jak w trybie Online).

  • Tytuł etapu 5 to Pack Data, zamiast Upload Data (jak w trybie Online).

Project Releaser skonfigurowany w lokalnym, niezarządzanym trybie (Offline).
Project Releaser skonfigurowany w lokalnym, niezarządzanym trybie (Offline).

Proces wydawania jest bardzo podobny do opisanego dla zarządzanego trybu wydawania (Online), z tą różnicą, że dane są zapisywane w folderach lokalnych. Zamiast powtarzać wcześniejsze informacje, poniżej przedstawiono zarys poszczególnych etapów ze wskazaniem różnic.

Etap 1 w trybie Offline — konfigurowanie lokalnego wydania

W tym miejscu konfigurujesz dane, które mają zostać wygenerowane z projektu. Wydanie zawsze zawiera dane źródłowe i może również obejmować dane produkcyjne, montażowe (podstawowe i/lub warianty) oraz dowolne dane niestandardowe, zależnie od potrzeb.

Dla każdego zestawu danych do wygenerowania należy określić folder docelowy, w którym te dane zostaną zapisane. Domyślne nazwy folderów są następujące:

  • Source Data — dane zostaną wygenerowane w folderze Sources.

  • Fabrication Data (tylko w przypadku projektu PCB) — dane zostaną wygenerowane w folderze Fabrication.

  • Assembly Data for no variant — dane zostaną wygenerowane w folderze Assembly.

  • Assembly Data for <VariantName> (tylko w przypadku projektu PCB) — dane zostaną wygenerowane w folderze Assembly <VariantName>.

  • Custom Data <Custom - n> — dane zostaną wygenerowane w folderze <Custom - n>.

Oczywiście możesz zmienić te domyślne nazwy, dostosowując je do swoich potrzeb. W tym celu kliknij bieżący wpis Target Folder, wprowadź nową nazwę folderu i naciśnij Enter.

Podczas wydawania do folderu lokalnego lub pliku ZIP pamiętaj, że ponowne wydanie z użyciem tych samych nazw folderów spowoduje nadpisanie znajdujących się w nich plików danych.

Po skonfigurowaniu zestawów danych, które mają zostać utworzone w ramach wydania, kliknij przycisk w prawym dolnym rogu widoku, aby kontynuować.

Przycisk ma dwa stany. Różnią się one nieco w zależności od wybranej opcji niezarządzanego wydawania:
  • Unmanaged - Folder: kliknięcie przycisku uruchomi standardowe polecenie Prepare. Proces wydawania zostanie przeprowadzony do etapu Review Data, co pozwoli ponownie sprawdzić, czy wszystko jest w porządku, przed zapisaniem danych w folderach docelowych. Jeśli nie chcesz zatrzymywać procesu w celu przeglądu, skorzystaj z menu rozwijanego powiązanego z przyciskiem i wybierz polecenie Prepare & Explore.
  • Unmanaged - Zip: kliknięcie przycisku uruchomi standardowe polecenie Prepare. Proces wydawania zostanie przeprowadzony do etapu Review Data, co pozwoli ponownie sprawdzić, czy wszystko jest w porządku, przed spakowaniem danych do pliku ZIP. Jeśli nie chcesz zatrzymywać procesu w celu przeglądu, skorzystaj z menu rozwijanego powiązanego z przyciskiem i wybierz polecenie Prepare & Pack.

Teraz wykonywanych jest kilka kontroli przed wydaniem, w tym:

  • Sprawdzenie, czy projekt i wszystkie pliki zostały zapisane.

  • Sprawdzenie, czy projekt i wszystkie odpowiednie pliki zostały zatwierdzone w systemie kontroli wersji (VCS), jeśli jest używany.

  • Sprawdzenie, czy każdemu włączonemu elementowi danych przypisano folder docelowy.

Jeśli zostaną wykryte jakiekolwiek problemy, pojawią się propozycje ich rozwiązania (takie jak zapisanie lokalnie zmodyfikowanych plików i zatwierdzenie ich w VCS).

Jeśli w wydawanym projekcie zostaną znalezione dokumenty zewnętrzne (dokumenty powiązane z projektem, ale przechowywane poza folderem projektu i jego podfolderami), otworzy się okno dialogowe External files z listą dokumentów zewnętrznych (). Aby uniknąć potencjalnych problemów, zaleca się przechowywanie wszystkich dokumentów powiązanych z projektem w folderze projektu lub jego podfolderze.

Na tym etapie generowany jest Source Data, a migawka plików źródłowych projektu zostaje zapisana w folderze docelowym.

Etap 2 w trybie Offline — walidacja projektu

Po pomyślnym zakończeniu etapu 1 ten kolejny etap procesu wydawania jest uruchamiany automatycznie, jeśli w przypisanych plikach OutJob zostanie wykryty co najmniej jeden raport typu Validation. Uruchamiane są wszystkie generatory wyników walidacji zdefiniowane w pliku Output Job przypisanym do wydawanego elementu danych. Ten etap przebiega tak samo jak podczas wydawania w trybie zarządzanym (Online).

Wydanie nie powiedzie się, jeśli którakolwiek z kontroli walidacyjnych zakończy się niepowodzeniem.
Kliknięcie w prawym dolnym rogu widoku zatrzyma proces wydawania.

Etap 3 w trybie Offline — generowanie danych

Po pomyślnym zakończeniu etapu 2 ten kolejny etap procesu wydawania jest uruchamiany automatycznie. Na tym etapie uruchamiane są wszystkie pozostałe zadania wyjściowe — zdefiniowane w plikach OutJob przypisanych do uwzględnionych elementów danych — w celu wygenerowania danych, które mają zostać zapisane w odpowiednich folderach docelowych. Ten etap przebiega tak samo jak podczas wydawania w trybie zarządzanym (Online).

Kliknięcie w prawym dolnym rogu widoku zatrzyma proces wydawania.

Etap 4 w trybie Offline — przegląd danych

Po pomyślnym przejściu wszystkich kontroli walidacyjnych i wygenerowaniu danych wyjściowych ten etap procesu wydawania umożliwia przejrzenie wygenerowanych danych. Przebiega on w zasadzie tak samo jak podczas wydawania w trybie zarządzanym (Online).

Jeśli użyto Prepare & Explore (cel wydania Unmanaged - Folder) lub polecenia Prepare & Pack (cel wydania Unmanaged - Zip), ten etap nie będzie dostępny. Innymi słowy, proces nie zostanie wstrzymany w celu przeglądu — dane zostaną od razu wydane: odpowiednio do folderów docelowych lub spakowane do docelowego pliku ZIP.

Przed zatwierdzeniem wydania przejrzyj wygenerowane dane i sprawdź, czy wszystko jest zgodne z oczekiwaniami. Następnie dane zostaną przesłane do folderów docelowych lub spakowane do lokalnego pliku ZIP, zgodnie z wybraną opcją wydania niezarządzanego.
Przed zatwierdzeniem wydania przejrzyj wygenerowane dane i sprawdź, czy wszystko jest zgodne z oczekiwaniami. Następnie dane zostaną przesłane do folderów docelowych lub spakowane do lokalnego pliku ZIP, zgodnie z wybraną opcją wydania niezarządzanego.

W widoku kompaktowym wygenerowanych danych kliknij łącze View, aby otworzyć powiązany plik danych lub zestaw plików w odpowiednim edytorze w Altium Designer (np. w edytorze CAM w przypadku plików Gerber lub skompresowanych/nieskompresowanych plików ODB++) albo w odpowiedniej aplikacji zewnętrznej (np. Microsoft Excel w przypadku zestawienia materiałowego). W widoku szczegółowym kliknij dwukrotnie wpis, aby wyświetlić tylko dany plik.

Jeśli po przejrzeniu danych okaże się, że konieczne są modyfikacje, kliknij przycisk w prawym dolnym rogu widoku. Pojawi się okno dialogowe z potwierdzeniem i ostrzeżeniem, że wszystkie wygenerowane dane zostaną utracone. Kliknij OK, aby anulować wydanie i powrócić do etapu 1 procesu.

System uniemożliwia modyfikowanie plików projektu między przygotowaniem wydania a wydaniem danych do folderów docelowych. Jeśli w jakikolwiek sposób zmienisz pliki projektu, proces wydawania zostanie przerwany i nastąpi powrót do etapu początkowego, przed przygotowaniem wydania.

Jeśli wszystkie wygenerowane dane są poprawne, kontynuuj wydawanie, klikając przycisk (również w prawym dolnym rogu widoku). Dalszy przebieg zależy od używanej opcji docelowej wydania:

  • Unmanaged - Folder: wygenerowane pliki zostaną wydane do folderów docelowych, a proces przejdzie bezpośrednio do ostatniego etapu, w którym można wyświetlić raport z wykonania.

  • Unmanaged - Zip: proces przejdzie do następnego etapu — Pack Data.

Etap 5 offline — Pakowanie danych

Po potwierdzeniu wydania w poprzednim etapie następuje automatyczne przejście do tego etapu, w którym dane są pakowane do jednego lokalnego pliku ZIP. Ścieżkę i nazwę pliku ZIP określa się na karcie Output Path w oknie dialogowym Project Release Options. Domyślnie ustawiona jest wartość [OutputPath][ProjectName].zip (z użyciem ścieżki zdefiniowanej w polu Output Path na karcie Options w oknie dialogowym Project Options).

Ten etap ma zastosowanie wyłącznie w przypadku korzystania z opcji docelowej wydania Unmanaged - Zip.

Etap 6 offline — Raport z wykonania

Jest to ostatni etap procesu, przedstawiający podsumowanie wydania.

Końcowy raport z wydania, wyświetlany przy użyciu celu wydania Unmanaged - Folder. Najedź kursorem na obraz, aby zobaczyć odpowiedni widok z celem wydania ustawionym na Unmanaged - Zip.
Końcowy raport z wydania, wyświetlany przy użyciu celu wydania Unmanaged - Folder. Najedź kursorem na obraz, aby zobaczyć odpowiedni widok z celem wydania ustawionym na Unmanaged - Zip.

Użyj dostępnego łącza nawigacyjnego, aby szybko przejść w Eksploratorze plików systemu Windows odpowiednio do folderu wyjściowego lub spakowanego pliku ZIP.

Szybkie przechodzenie do folderu wyjściowego z lokalnie wydanymi danymi bezpośrednio z etapu raportu z wykonania w interfejsie. Najedź kursorem na obraz, aby zobaczyć przykład przejścia do pliku ZIP zawierającego lokalnie wydane dane.
Szybkie przechodzenie do folderu wyjściowego z lokalnie wydanymi danymi bezpośrednio z etapu raportu z wykonania w interfejsie. Najedź kursorem na obraz, aby zobaczyć przykład przejścia do pliku ZIP zawierającego lokalnie wydane dane.

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

Dostępne funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, Altium Agile Teams, Altium Agile Enterprise lub Altium Designer (w ramach aktywnej subskrypcji terminowej).

Jeśli opisana funkcja nie jest widoczna w Twoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium, aby dowiedzieć się więcej.

Starsza dokumentacja

Dokumentacja Altium Designer nie jest już wersjonowana. Jeśli potrzebujesz dostępu do dokumentacji dla starszych wersji Altium Designer, odwiedź sekcję Starsza dokumentacja na stronie Inne instalatory.

Contents