Automatyzacja zadań projektowych za pomocą skryptów

Skryptowanie zapewnia potężny sposób zwiększenia Twoich możliwości i produktywności w Altium Designer. Skrypt zawiera zestaw instrukcji (zautomatyzowanych poleceń), które są interpretowane podczas jego wykonywania w Altium Designer. Skrypty mogą być pisane w wielu językach, wraz z zaawansowanymi oknami dialogowymi, i debugowane w Altium Designer. Skryptów możesz używać do osiągania celów projektowych przy minimalnym udziale użytkownika oraz mniejszej liczbie naciśnięć klawiszy i kliknięć myszą.

Dzięki skryptom możesz automatyzować powtarzalne zadania i wykonywać edycje, które nie są dostępne za pomocą istniejących poleceń w Altium Designer. Na przykład możesz użyć skryptu do wyszukania i zaktualizowania znaczników fiducjalnych w dokumencie PCB albo do wyeksportowania niestandardowej netlisty.

Skrypty można zapisywać w projekcie skryptowym lub w projekcie projektowym. W Altium Designer dostępnych jest kilka języków skryptowych do pisania skryptów.

Przegląd systemu skryptowania i konfiguracja

System skryptowania Altium Designer zapewnia wszystkie narzędzia i funkcje potrzebne do tworzenia skryptów automatyzujących zadania w oprogramowaniu.

Skrypty można pisać w celu automatyzacji powtarzalnych zadań lub rozszerzenia funkcjonalności w Altium Designer. System skryptowania składa się z dwóch głównych części: edytora i debuggera. Edytor skryptów, debugger oraz panele skryptowania współpracują, aby ułatwić pisanie i debugowanie skryptów. Skrypt można uruchomić bezpośrednio z edytora skryptów albo przypisać do menu, paska narzędzi lub skrótu klawiszowego, aby można go było zastosować do bieżącego dokumentu – na przykład PCB – w dowolnym momencie.

► Przeczytaj o Systemie skryptowania w Altium Designer

Tworzenie i przechowywanie skryptów

Skrypty Altium Designer są zwykle tworzone i przechowywane w projekcie skryptowym (*.PrjScr), ale można je dodawać do dowolnego typu projektu lub w nim przechowywać.

Aby rozpocząć pisanie skryptów, zacznij od utworzenia nowego projektu skryptowego i dodania do niego plików skryptów.

Projekt skryptowy pomaga zarządzać skryptami i można go utworzyć, wybierając File » New » Project » Script Project z menu głównego. Nowy projekt zostanie wyświetlony w panelu Projects. Aby dodać nowy skrypt do projektu, kliknij prawym przyciskiem nazwę projektu i wybierz Add New to Project z menu kontekstowego.

Podczas tworzenia nowego skryptu dostępne są dwa typy skryptów do wyboru, zależnie od wymagań projektu – jednostki skryptowe i formularze skryptowe. Jednostki skryptowe pozwalają pisać samodzielne procedury i funkcje. Formularze skryptowe umożliwiają budowanie okien dialogowych z kontrolkami i obsługą zdarzeń, a także procedurami i funkcjami.

► Przeczytaj o Tworzeniu i przechowywaniu skryptów w Altium Designer

Pisanie skryptów

Istnieje szereg kluczowych pojęć i terminów związanych z pisaniem skryptów:

• Procesy to ciągi poleceń, których możesz używać do wykonywania poleceń w skryptach.

• Komponenty to wizualne obiekty kontrolek w panelu Tool Palette, które możesz przeciągać i upuszczać na formularz skryptu, aby manipulować projektem.

• Komponent umieszczony na formularzu skryptu ma metody, właściwości i zdarzenia.

• Interfejsy obiektów to specjalne interfejsy obiektów, których możesz używać do wyodrębniania i modyfikowania danych w dokumentach projektowych z poziomu skryptów.

Domyślny język skryptowy jest ustawiony na DelphiScript (*.pas). Sam silnik skryptowy jest napisany w Embarcadero Delphi, a panel Tool Palette jest oparty na VCL (Visual Component Library) Delphi.

► Przeczytaj o Pisaniu skryptów w Altium Designer

Narzędzia do edycji i debugowania skryptów

System skryptowania Altium Designer składa się z dwóch głównych części – edytora i debuggera. Edytor oferuje szereg funkcji pomocy i inspekcji kodu skryptów, a debugger zapewnia dostęp do komponentów skryptu i funkcji debugowania. Narzędzia edytora skryptów są kluczowym zasobem podczas debugowania skryptów.

W systemie skryptowania dostępny jest zestaw narzędzi pomagających w debugowaniu skryptów. Obejmują one m.in. ustawianie wielu punktów przerwania w skrypcie, używanie panelu Watch List do monitorowania wartości zmiennych, korzystanie z zakładek w celu sprawniejszego poruszania się oraz używanie funkcji krokowego wykonywania (step into i step over) do śledzenia przebiegu skryptów.

► Przeczytaj o Narzędziach edycji skryptów w Altium Designer

► Przeczytaj o Debugowaniu skryptów w Altium Designer

Uruchamianie skryptów

Chociaż system skryptowania Altium Designer zapewnia środki do tworzenia zaawansowanych zautomatyzowanych zadań dla Altium Designer, powstałe skrypty muszą być również łatwo dostępne w trakcie procesu projektowego. Na przykład skrypt utworzony do wykonania złożonego zestawu operacji podczas edycji PCB powinien być łatwo dostępny w samym edytorze PCB, tak aby można go było uruchomić jednym lub dwoma kliknięciami.

Altium Designer umożliwia to, pozwalając przypisać skrypt do uruchamiacza procesu, a tym samym do polecenia, które można przypisać do menu, paska narzędzi i skrótu.

Skrypt można wykonać za pomocą polecenia edytora Run, gdy jest otwarty w edytorze skryptów. Wymaga to, aby projekt skryptowy był otwarty w Altium Designer, co nie jest wygodnym sposobem dostępu do skryptu potrzebnego np. podczas projektowania PCB. Alternatywnie okno dialogowe Select Item To Run (File » Run Script) pozwala wskazać skrypt na lokalnym dysku twardym lub w podłączonym Workspace, a następnie uruchomić żądany proces. Skrypt pozostaje załadowany na czas bieżącej sesji.

Bardziej odpowiednią metodą dostępu do często używanego skryptu jest zainstalowanie projektu jako Global Project na stronie Scripting System – Global Projects okna dialogowego Preferences. W takim przypadku projekt jest automatycznie ładowany przy uruchamianiu Altium Designer i może być wykonywany w dowolnym momencie za pomocą polecenia File » Run Script.

► Przeczytaj o Uruchamianiu skryptów w Altium Designer

Skryptowanie komponentów graficznych

Wizualne komponenty formularzy dostępne do użycia w skryptach Altium Designer w większości pochodzą z Visual Component Library (VCL) firmy Embarcadero, czyli kolekcji zdefiniowanych komponentów wizualnych do tworzenia aplikacji Windows w językach Delphi i C++.

Opracowane jako wizualna biblioteka klas, klasy VCL dziedziczą po obiekcie TComponent (który sam jest potomkiem obiektu bazowego TObject) w liniowej hierarchii obiektów. W związku z tym typowy komponent skryptu, taki jak obiekt TButton, dziedziczy właściwości, metody i zdarzenia po obiektach nadrzędnych. W tym przypadku hierarchia klas to: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Zwróć uwagę, że komponenty dziedziczące po obiekcie TControl są zazwyczaj komponentami wizualnymi (kontrolkami), a typowe komponenty dziedziczące po TWinControl to w większości otoczki (wrappery) wokół Windows API.

Podczas tworzenia formularza w edytorze skryptów Altium Designer komponenty są dostępne w panelu Tool Palette. Formularze skryptowe mają powiązany plik *.DFM, który zawiera szczegóły konfiguracji formularza, rozmieszczenia jego komponentów i inne atrybuty; plik znajduje się w folderze hosta projektu skryptowego. Altium Designer pozwala używać komponentów zarówno w DelphiScript, jak i VBScript podczas projektowania formularzy skryptowych.

► Przeczytaj o Skryptowaniu komponentów graficznych w Altium Designer

Przykłady skryptów

Aby zapewnić lepszy wgląd w ogólne aspekty systemu skryptowania oraz użycie modeli obiektowych Delphi i X2 w skryptach, z perspektywy funkcjonalności omówiono dwa przykładowe projekty – kopiowanie obrysu płytki oraz skrypt generujący netlistę. Skrypty Board Outline Copier i Netlister są opracowane z użyciem modeli obiektowych X2, aby zilustrować możliwości systemu skryptowania w Altium Designer.

Są to istniejące skrypty dostępne w kolekcji przykładowych skryptów. Folder Scripts w pliku ZIP zawiera podfoldery uporządkowane według języków skryptowych.

Zwróć uwagę, że szeroki wybór przydatnych skryptów można znaleźć w kolekcji Altium Designer na GitHub.

► Przeczytaj o Analizie przykładowych skryptów w Altium Designer

► Przeczytaj o Referencji przykładów skryptowania dla Altium Designer

Obsługa języków skryptowych

Skrypty dla Altium Designer można pisać w kilku językach skryptowych. Zwróć uwagę, że językiem podstawowym i najczęściej przywoływanym w dokumentacji skryptowania jest DelphiScript, który jest ściśle powiązany z Embarcadero Delphi™.

► Przeczytaj o Obsłudze języków skryptowych w Altium Designer