Modifying Symbols & Footprints
W skrócie
- Dowiedz się, jak uzyskiwać dostęp do symboli i domyślnych footprintów wskazanych w bazie danych, edytować je i zapisywać.
- Poznaj proces pracy z SVN — od pobierania kopii roboczych bibliotek po odświeżanie statusu, aktualizowanie plików i zatwierdzanie zmian.
- Odkryj, jak wizualnie porównywać rewizje bibliotek i przeglądać wykryte różnice.
Oprócz utrzymywania zawartości samej bazy danych konieczne jest również aktualizowanie w razie potrzeby powiązanych symboli i modeli. Obejmuje to wprowadzanie zmian w symbolach schematowych i modelach obudów, a w przypadku standardowej biblioteki bazodanowej (DbLib) — także w definicjach w plikach modeli symulacyjnych.
Oba typy bibliotek bazodanowych — standardowe i objęte kontrolą wersji — umożliwiają otwieranie powiązanych symboli i modeli obudów do edycji bezpośrednio z głównego widoku dokumentu DbLib/SVNDbLib, gdy jest on aktywnym dokumentem. W kolejnych sekcjach opisano, jak to zrobić. W przypadku SVNDbLib proces ten jest nieco bardziej złożony, ale daje też większe możliwości.
Korzystanie z DbLib
Aby otworzyć do edycji plik biblioteki zawierający powiązany symbol lub model obudowy komponentu, kliknij prawym przyciskiem myszy wpis komponentu w Table Browser, a następnie wybierz z menu kontekstowego odpowiednie polecenie — Open Symbol lub Open Footprint. Odpowiedni plik biblioteki zostanie otwarty, a symbol lub model obudowy pojawi się jako aktywny obiekt w obszarze projektowym, gotowy do edycji.
Po wprowadzeniu wymaganych zmian zapisz plik biblioteki.
Przykład otwierania powiązanego symbolu komponentu bazodanowego bezpośrednio z DbLib.
Korzystanie z SVNDbLib
Jak wspomniano, otwieranie i edytowanie symboli oraz modeli powiązanych z komponentami bazodanowymi za pośrednictwem pliku SVNDbLib jest nieco bardziej złożone, ale daje też większe możliwości. Zmiany wprowadza się w lokalnych kopiach roboczych bibliotek przechowywanych w repozytorium SVN.
Określanie lokalnego obszaru roboczego
Aby wprowadzać zmiany w symbolach komponentów i modelach obudów, należy pobrać pliki z repozytorium do lokalnego katalogu roboczego. Wskaż wymagany katalog na stronie Data Management - SVN Libraries w oknie dialogowym Preferences. Zdefiniowana jest domyślna lokalizacja folderu roboczego — \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. W razie potrzeby zmień ją, klikając przycisk
, aby wskazać istniejący folder, lub wpisując bezpośrednio ścieżkę do folderu.
Określanie lokalnego katalogu roboczego.
Aby szybko pobrać wszystkie biblioteki symboli i modeli obudów z repozytorium do wskazanego lokalnego folderu roboczego, uruchom polecenie Check Out All Working Folders z głównego menu Tools edytora SVNDatabaseLib. Pobrane zostaną foldery określone w sekcji Models Location na karcie SVN Repository w oknie dialogowym Database Library Options.
Przykład symboli i modeli obudów przechowywanych w repozytorium SVN i wskazanych w ramach Database Library Options, pobranych do lokalnego folderu roboczego.
Wprowadzanie zmian
Po pobraniu bibliotek symboli i modeli obudów do wskazanego lokalnego folderu roboczego można w razie potrzeby wprowadzać w nich zmiany. Polega to na modyfikowaniu lokalnych kopii symboli schematowych i modeli obudów, a następnie zatwierdzaniu tych zmian w repozytorium SVN.
Podobnie jak w przypadku DbLib dostępne są następujące sposoby otwierania symbolu lub modelu do edycji:
- W dokumencie SVNDbLib kliknij prawym przyciskiem myszy wpis komponentu w Table Browser, a następnie wybierz z menu kontekstowego odpowiednie polecenie — Open Symbol lub Open Footprint.
- Jeśli plik SVNDbLib został dodany do listy Available File-based Libraries, polecenia edycji są dostępne bezpośrednio w panelu Components. Zaznacz wpis wymaganego komponentu, a następnie użyj odpowiednio polecenia Edit Symbol (z menu kontekstowego otwieranego prawym przyciskiem myszy w Components ) lub polecenia Edit Footprint (z menu kontekstowego otwieranego prawym przyciskiem myszy w Models ).
- Użyj polecenia File » Open w edytorze bibliotek, aby znaleźć i otworzyć wymaganą bibliotekę w lokalnym folderze roboczym.
- Przeciągnij plik biblioteki znajdujący się w lokalnym folderze roboczym z Eksploratora Windows bezpośrednio do Altium Designer.
W każdym przypadku po wprowadzeniu wymaganych zmian zapisz plik biblioteki.
Głównym interfejsem umożliwiającym pracę z folderami i plikami pobranymi do lokalnego folderu roboczego oraz z samym repozytorium jest jednak panel Storage Manager. Gdy plik SVNDbLib jest aktywnym dokumentem, w Storage Manager pojawią się foldery symboli i modeli pobrane do lokalnego folderu roboczego. Lista będzie zawierać dokładnie te foldery, które określono w sekcji Model Locations na karcie SVN Repository w oknie dialogowym Database Library Options.
Panel Storage Manager odzwierciedla zawartość lokalnego folderu roboczego, pod warunkiem że plik SVNDbLib jest aktywnym dokumentem w Altium Designer.
Aby otworzyć plik biblioteki do edycji, kliknij prawym przyciskiem myszy jego wpis w sekcji All Files panelu i wybierz Open z wyświetlonego menu kontekstowego. Wprowadź wymagane zmiany i zapisz plik w zwykły sposób, używając standardowego polecenia Save odpowiedniego edytora.
Zatwierdzanie zmian w repozytorium
Panel page: Storage Manager
Choć bibliotekę można otworzyć do edycji na różne sposoby, zatwierdzanie wprowadzonych zmian — z within Altium Designer — jest możliwe wyłącznie za pośrednictwem panelu Storage Manager.
Podczas korzystania z panelu Storage Manager należy przede wszystkim pamiętać o odświeżaniu stanu powiązania między lokalnymi folderami i plikami roboczymi (wyświetlanymi w panelu) a odpowiadającymi im folderami i plikami w repozytorium kontroli wersji. W przypadku pojedynczej zaznaczonej biblioteki służy do tego polecenie Refresh, dostępne w menu kontekstowym w obszarze All Files panelu. Aby szybko odświeżyć stan całego folderu, użyj skrótu klawiaturowego Ctrl+F5.
Podczas pracy z lokalnymi bibliotekami symboli i modeli istotne są następujące stany:
| Ikona | Stan | Opis |
|---|---|---|
| |
No modification | Lokalna kopia biblioteki jest identyczna z kopią w repozytorium. Możesz otworzyć plik i wprowadzać modyfikacje. |
| |
Out of date | Lokalna kopia pliku (w folderze roboczym) jest starsza niż jej odpowiednik w repozytorium, a zatem jest nieaktualna. Zanim będzie można zmodyfikować plik i zatwierdzić własne zmiany, należy pobrać jego najnowszą wersję z repozytorium, aktualizując lokalną kopię roboczą. Aby pobrać najnowszy plik z repozytorium, użyj polecenia Update (w menu kontekstowym dostępnym po kliknięciu prawym przyciskiem myszy). |
| |
Modified | Lokalna kopia pliku została zmodyfikowana w Altium Designer i zapisana w folderze roboczym. Aby przesłać lokalne zmiany do repozytorium, kliknij prawym przyciskiem myszy pozycję pliku i wybierz z menu kontekstowego polecenie Commit. Po zatwierdzeniu zmian w repozytorium stan powróci do No modification. |
| |
Conflict | Inny użytkownik Altium Designer zatwierdził plik, zanim zatwierdzono jego własną, zmodyfikowaną i zapisaną wersję. Użyj polecenia Update lub Resolve , aby określić, która wersja pliku stanie się najnowszą rewizją w repozytorium. |
| |
Locked | Plik został zablokowany przez Ciebie lub innego użytkownika. Inny użytkownik nie może zaktualizować zablokowanego pliku do nowej rewizji w repozytorium (chyba że wymusi jego odblokowanie). Ten stan może występować w połączeniu z innymi ikonami, takimi jak ikony stanów Modified |
Fizyczne porównywanie rewizji
Porównanie fizyczne można przeprowadzić między dowolnymi dwiema rewizjami tej samej biblioteki symboli lub modeli. Pozwala to wyraźnie zobaczyć zmiany wprowadzone między kolejnymi lub niekolejnymi rewizjami pliku.
W panelu Storage Manager porównanie przeprowadza się w obszarze VCS Revisions u dołu panelu.
Panel Storage Manager przedstawia dwa widoki historii zaznaczonego pliku, z oddzielnymi obszarami dla rewizji VCS i historii lokalnej.
Można porównać dowolne dwie rewizje. Korzystając z metody zaznaczania Ctrl+click w systemie Windows, zaznacz dwie rewizje biblioteki, które chcesz porównać, w obszarze VCS Revisions panelu, kliknij prawym przyciskiem myszy i wybierz Compare.
Po wywołaniu polecenia Compare dwie zaznaczone rewizje dokumentu zostaną otwarte obok siebie w obszarze roboczym i porównane graficznie, a wszelkie wykryte między nimi różnice zostaną wyświetlone w panelu Differences.
Porównanie graficzne bezpośrednio w obszarze projektowym edytora bibliotek.