Modifying Symbols & Footprints

Помимо поддержки содержимого самой базы данных, также требуется по мере необходимости поддерживать связанные (referenced) символы и модели. Это включает внесение изменений в условные графические обозначения (схемные символы) и модель(и) посадочного места (footprint). А для стандартной библиотеки базы данных (DbLib) — также определения в файлах моделей симуляции.

Оба типа библиотек базы данных — стандартная и с контролем версий — позволяют получать доступ к связанному символу и модели посадочного места для редактирования прямо из основного представления документа DbLib/SVNDbLib, когда он открыт как активный документ. В следующих разделах рассматривается, как это сделать; при использовании SVNDbLib это немного сложнее, но и несколько мощнее.

При использовании DbLib

Чтобы открыть для редактирования файл библиотеки связанного символа/модели посадочного места компонента, щёлкните правой кнопкой по записи компонента в Table Browser, затем выберите в контекстном меню соответствующую команду — Open Symbol или Open Footprint. Будет открыт применимый файл библиотеки, а символ/посадочное место будет показано как активный объект в рабочей области, готовый к редактированию.

После внесения необходимых изменений сохраните файл библиотеки.

Пример доступа к связанному символу компонента базы данных непосредственно из DbLib.

При использовании SVNDbLib

Как уже упоминалось, возможность доступа и редактирования символов и моделей, на которые ссылаются компоненты базы данных и к которым обращаются через файл SVNDbLib, несколько сложнее, но и более мощная. Изменения вносятся в локальные рабочие копии библиотек, хранящихся в SVN-репозитории.

Задание локального рабочего пространства

Чтобы вносить изменения в символы компонентов и модели посадочных мест, вам нужно выполнить checkout файлов из репозитория в локальный рабочий каталог. Укажите требуемый каталог на странице Data Management - SVN Libraries page диалога Preferences. Задано расположение рабочей папки по умолчанию — \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. При необходимости измените его, нажав кнопку для выбора существующей папки или введя путь к папке вручную.

Задание локального рабочего каталога.

Чтобы быстро выполнить checkout всех библиотек символов и моделей посадочных мест из репозитория в назначенную локальную рабочую папку, выполните команду Check Out All Working Folders из главного меню Tools редактора SVNDatabaseLib. Будут выгружены те папки, которые указаны в области Models Location на вкладке SVN Repository диалога Database Library Options dialog.

Пример символов и посадочных мест, хранящихся в SVN-репозитории и указанных как часть Database Library Options, выгруженных (checked out) в локальную рабочую папку.

Внесение изменений

После того как библиотеки символов и моделей посадочных мест выгружены в назначенную локальную рабочую папку, вы можете вносить изменения по мере необходимости. Это включает изменение локальной копии схемных символов и моделей посадочных мест, а затем commit этих изменений обратно в SVN-репозиторий.

Как и в DbLib, доступны следующие способы доступа к символу/модели для редактирования:

• В документе SVNDbLib щёлкните правой кнопкой по записи компонента в Table Browser, затем выберите в контекстном меню соответствующую команду — Open Symbol или Open Footprint.

• Если SVNDbLib добавлен в список Available File-based Libraries, вы можете вызывать команды редактирования напрямую через панель Components panel. Выберите нужную запись компонента, затем используйте команду Edit Symbol (в контекстном меню по правому клику для области Components ) или команду Edit Footprint (в контекстном меню по правому клику для области Models ) соответственно.
• Используйте команду File » Open редактора библиотек, чтобы перейти к нужной библиотеке и открыть её (в вашей локальной рабочей папке).
• Перетащите файл библиотеки (из вашей локальной рабочей папки) из Windows Explorer прямо в Altium Designer.

В каждом случае после внесения необходимых изменений сохраните файл библиотеки.

Однако основным интерфейсом между папками и файлами, выгруженными в локальную рабочую папку, и самим репозиторием является панель Storage Manager panel. Когда файл SVNDbLib является активным документом, панель Storage Manager заполняется папками символов и моделей, выгруженными в локальную рабочую папку. Точный список папок будет соответствовать тем, что указаны в области Model Locations на вкладке SVN Repository диалога Database Library Options.

Панель Storage Manager отражает локальную рабочую папку — при условии, что файл SVNDbLib является активным документом в Altium Designer.

Чтобы открыть файл библиотеки для редактирования, щёлкните правой кнопкой по его записи в области All Files панели и выберите Open в появившемся контекстном меню. Внесите необходимые изменения и сохраните файл обычным способом, используя стандартную команду Save соответствующего редактора.

Фиксация (commit) изменений в репозиторий

Panel page: Storage Manager

Хотя существуют разные способы открыть библиотеку для редактирования, фиксация любых внесённых изменений — из within Altium Designer — может выполняться только через панель Storage Manager panel.

Одна из самых важных вещей при работе с панелью Storage Manager — обновлять статус связи между локальными рабочими папками/файлами (отображаемыми в панели) и соответствующими папками/файлами в репозитории контроля версий. Для отдельно выбранной библиотеки это делается командой Refresh, доступной в меню по правому клику в области All Files панели. Чтобы быстро обновить статус целой папки, используйте сочетание клавиш Ctrl+F5.

Статусы, относящиеся к работе с локальными библиотеками символов и моделей:

Icon	Status	Description
	No modification	Локальная копия библиотеки идентична версии в репозитории. Вы можете свободно открыть файл и вносить изменения.
	Out of date	Локальная копия файла (в рабочей папке) старее, чем соответствующая версия в репозитории, и поэтому устарела. Прежде чем вы сможете изменять файл и фиксировать свои изменения, нужно получить последнюю версию из репозитория (обновив свою локальную рабочую копию). Используйте команду Update (в контекстном меню по правому клику), чтобы получить последнюю версию файла из репозитория.
	Modified	Локальная копия файла была изменена в Altium Designer и сохранена в рабочую папку. Чтобы отправить локальные изменения в репозиторий, щёлкните правой кнопкой по записи файла и выберите команду Commit в контекстном меню. После check-in в репозиторий статус вернётся к No modification.
	Conflict	Файл был зафиксирован (committed) другим пользователем Altium Designer до того, как вы зафиксировали свою отредактированную и сохранённую версию этого файла. Используйте команду Update или Resolve , чтобы определить, какая версия файла станет последней ревизией в репозитории.
	Locked	Файл заблокирован вами или другим пользователем. Заблокированный файл не может быть обновлён до новой ревизии в репозитории другим пользователем (если только блокировка не будет принудительно снята). Это состояние может сочетаться с другими значками, например для Modified  или No Modification , когда также применимы эти условия статуса.

Физическое сравнение ревизий

Физическое сравнение можно выполнить между любыми двумя ревизиями одного и того же символа (библиотеки моделей). Это позволяет наглядно, в визуальной форме, увидеть изменения, которые были внесены — между последовательными или непоследовательными ревизиями файла.

В панели Storage Manager panel сравнение выполняется из области VCS Revisions в нижней части панели.

Панель Storage Manager отображает два представления истории выбранного файла, с отдельными областями для VCS Revisions и Local History.

Сравнение можно выполнить между любыми двумя ревизиями. Используя стандартный для Windows способ выделения, выберите две ревизии библиотеки, которые вы хотите сравнить, в области VCS Revisions панели, щёлкните правой кнопкой мыши и выберите Compare.

После вызова команды Compare две выбранные ревизии документа будут открыты рядом в рабочей области, будет выполнено графическое сравнение, а все обнаруженные различия между ними будут перечислены в панели Differences.

Графическое сравнение непосредственно в рабочем пространстве редактора библиотек.