Создание проектов и документов

Отправной точкой для любого проекта, создаваемого в Altium Designer, является проект. Проект Altium Designer объединяет набор проектных документов, выходные данные которых в конечном итоге определяют единственную реализацию того, что вы собираетесь создать. Например, схемы и PCB в PCB‑проекте включают набор файлов, необходимый для изготовления печатной платы. В отличие от этого, набор файлов, который вы формируете в проекте жгута, используется для закупки и сборки кабельного жгута, а логическая схема и файлы физической сборки в многоплатном проекте формируют набор файлов для изготовления и сборки законченного изделия с несколькими соединёнными PCB.

Набор проектных документов может быть собран из любого доступного источника — локального на компьютере или иного — при этом файл проекта связывает их в единый дизайн. Программное обеспечение использует динамическую компиляцию для создания и управления единой моделью данных компонентов проекта и их связности. Затем эту модель данных можно использовать для распространения изменений между доменами проектирования — например, для синхронизации с целью устранения различий между документами в доменах Schematic и PCB.

Документы проекта можно создавать и хранить в вашем Altium Workspace, в вашей системе контроля версий или локально в виде файлов в доступной сети.

В разделах ниже описано, как создать новый проект и добавить проектные документы в существующий проект.

Создание нового проекта с помощью диалога Create Project

Новый проект можно создать в Altium Designer с помощью диалога Create Project (File » New » Project).

1. В списке Locations выберите запись для вашего Workspace (она будет отображаться с заданным для него именем) — чтобы увидеть этот вариант в списке, вы должны быть активно подключены к Workspace. Это будет целевой сервер, на котором будет храниться ваш новый Workspace‑проект.

   Если кратко, управление проектом сосредоточено на безопасном хранении и отслеживании изменений на протяжении всего процесса разработки и, в конечном счёте, на проведении получившегося проекта через этапы до создания физического изделия — например, собранной PCB, которая будет использоваться в конечном продукте. Для удовлетворения этих потребностей Altium Designer предоставляет ряд подходов к управлению проектами, которые предлагают возрастающие уровни сложности и возможностей, но при этом упрощают процесс с точки зрения разработчика. Они варьируются от локального хранения и управления на основе файлов, до подходов хранения в локальной/удалённой системе контроля версий (VCS), и далее — до продвинутой и рекомендуемой формы, где управление проектными данными основано на возможностях Workspace.

   Подключённый Workspace и его внутренняя служба VCS размещают и управляют проектами Altium Designer, а также предоставляют упрощённые операции VCS, встроенные возможности совместной работы над проектированием, расширенный обмен проектными данными, отслеживание истории, управление жизненным циклом и многое другое. Проекты, интегрированные с Workspace, доступны напрямую из Altium Designer, например из панели Projects, или из самого Workspace через его браузерный интерфейс.

   Благодаря интеллекту, встроенному в сервисы Workspace, такие задачи, как операции VCS, упрощаются и автоматизируются, а дополнительные функции совместной работы — такие как управление доступом пользователей (шаринг), комментирование и история — доступны прямо из Altium Designer. В результате получается надёжный и безопасный формат и место хранения проекта, которые могут стать центральной точкой для совместного проектирования.

   При подключении к Workspace с одной или несколькими активными дефинициями процессов для темы процесса Project Creations возможность создания нового проекта через диалог Create Project ограничивается только проектами типов Local и VCS. Вместо этого создание проектов на базе Workspace переходит под контроль активных дефиниций процессов. Подробнее см. Process-based Project Creation.

2. В списке Project Type выберите тип проекта, который вы хотите создать, и при необходимости выберите подходящий шаблон из доступных. Запись <Empty> создаст «пустой» (shell) проект без исходных документов.

   Подробнее см. Creating a Project Template.

3. Введите Project Name и, при необходимости, Description проекта.

   Имя проекта должно начинаться с и может содержать A–Z, a–z или 0–9. Разрешены подчёркивания, дефисы и пробелы, но последние можно использовать только в середине имени (начальные и конечные пробелы будут игнорироваться). Нельзя использовать следующие слова: AUX, COM1-COM9, LPT1-LPT9, CON, NUL и PRN. Кроме того, имя не может содержать следующие символы: \ . / ? % * : | " < >.

Диалог Create Project включает дополнительные параметры:

• Установите параметр Version Control (по умолчанию), чтобы применить к проекту все возможности VCS, такие как история и расширенные возможности совместного доступа. Если флажок снят, проект хранится в Workspace и синхронизируется с локальной копией — «зеркальный» проект в формате Simple Sync.

  Параметр Version Control доступен только при подключении к Altium 365 Workspace. При подключении к Enterprise Server Workspace этот параметр фактически всегда включён.

• При создании проекта типа PCB установите параметр Constraint Management , чтобы управлять ограничениями проектирования для этого проекта с помощью Constraint Manager. Если параметр отключён, для этого проекта будет использоваться система design rules.

  Параметр Constraint Management по умолчанию включён в диалоге Create Project, когда параметр System.ConstraintManager включён в диалоге Advanced Settings dialog.

• При подключении к Enterprise Server Workspace раскрывающееся меню Repository (если присутствует) будет перечислять все репозитории проектирования, управляемые через Version Control Service Workspace, и к которым вам предоставлен доступ. Выберите репозиторий, в котором будут храниться новый проект и его файлы — по умолчанию доступен один Git‑репозиторий (Versioned Storage). Если выбран репозиторий типа SVN, становится доступен дополнительный параметр Repository Folder для указания или выбора альтернативной целевой папки внутри самого репозитория.

  Раскрывающееся меню Repository отображается только в том случае, если вы обновили Enterprise Server с версии или серверного продукта, где было включено использование SVN‑репозиториев. В противном случае Enterprise Server предоставляет один Git‑репозиторий проектирования для размещения всех ваших проектов Workspace, и в этом случае раскрывающееся меню Repository не отображается.

  SVN не поддерживается в Altium On-Prem Enterprise Server начиная с версии 7.2. Чтобы избежать ограничений управления SVN‑проектом, рекомендуется мигрировать SVN‑проекты во встроенный Git‑репозиторий Workspace Enterprise Server. Это можно сделать до обновления сервера, как описано здесь.

  Дополнительные сведения о прекращении поддержки SVN в Altium On-Prem Enterprise Server см. в статье базы знаний SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1 .

• Нажмите элемент управления Advanced, чтобы указать пути к папкам.

  • Используйте поле Folder, чтобы указать, где должна быть создана папка проекта — в структуре папок Workspace. Путь по умолчанию для новых проектов задаётся на странице Admin – Settings – Projects браузерного интерфейса Workspace (по умолчанию это будет Projects\<ProjectName>). При необходимости нажмите кнопку , чтобы перейти к другой папке Workspace и выбрать её.

    Если у пользователя, создающего проект в подключённом Workspace , нет прав на запись в папку проектов по умолчанию, система автоматически создаст пользовательскую структуру Personal Folder для хранения нового проекта. Она отображается как папка верхнего уровня, основанная на адресе электронной почты участника (для Altium 365 Workspace) или имени пользователя (для Enterprise Server Workspace), с подпапкой My Projects , в которой хранятся проекты этого пользователя. Структура/иерархия папок доступна только вошедшему пользователю и администраторам — другим пользователям она не видна. Подробнее см. Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • Используйте поле Local Storage, чтобы указать, где локальная версия проекта будет храниться на вашем жёстком диске. Расположение по умолчанию задаётся на странице System – Default Locations диалога Preferences. При необходимости нажмите кнопку , чтобы выбрать другое расположение папки. Это «рабочая» папка проекта и Git‑репозитория local, в который выполняется коммит. В конечном итоге, либо в момент коммита, проект отправляется (push) в централизованный репозиторий проектирования в Workspace (Versioned Storage), который является Git‑репозиторием remote.

   

• Используйте область списка Parameters, чтобы добавлять или удалять пользовательские пары параметров «Имя/Значение», связанные с проектом и сохраняемые в Workspace. Используйте кнопку , чтобы добавить в список новую пару «Имя–Значение», или кнопку , чтобы удалить выбранную пару. Поля «Имя» и «Значение» допускают максимум 255 символов. При создании проекта в Workspace эти параметры проекта Workspace сохраняются в Workspace вместе с новым проектом как параметры уровня проекта на стороне Workspace.

  Если в списке Project Type диалога выбран шаблон проекта, область списка Parameters будет загружена параметрами из этого шаблона. При необходимости вы можете изменить эти параметры (имена и/или значения) или удалить их. При создании проекта в Workspace параметр из выбранного шаблона будет сохранён как параметр уровня проекта на стороне дизайна, если имя параметра не изменялось. В противном случае он будет сохранён как параметр уровня проекта на стороне Workspace.

  Параметры уровня проекта на стороне Workspace можно редактировать в Workspace. В отличие от них, параметры на стороне дизайна сохраняются в файле проекта (*.PrjPcb) и могут редактироваться в Altium Designer. Параметры уровня проекта обоих типов можно просматривать на вкладке Parameters диалога Project Options (Project » Project Options) и использовать как Special Strings в Altium Designer.

Когда проект настроен должным образом, нажмите кнопку . Новая структура проекта будет создана в указанных локальной папке и папке Workspace. Проект будет открыт в панели Projects panel, которая отразит полностью синхронизированное состояние между файлами в удалённом репозитории дизайна (в Workspace) и локальным репозиторием (рабочей копией) — на что указывают соответствующие значки . Если проект создан с отключённой опцией Version Control (доступно только в Altium 365 Workspace), зеркальный проект будет показан в панели Projects с соответствующим значком .

Вновь созданный проект зафиксирован (committed) в Versioned Storage репозитории дизайна в Workspace.

Либо, если новому проекту not назначен шаблон с входящими в него документами, будет создан только файл проекта (*.PrjPcb) и, следовательно, только структура проекта. Затем проект открывается в панели Projects panel, где он будет показан как Scheduled for addition, что обозначается соответствующим значком . На этом этапе вы можете добавить документы в проект или просто сохранить структуру в Workspace в её текущем «пустом» состоянии. Для этого нажмите элемент управления Save to Server, связанный с записью проекта в панели Projects — он также доступен из контекстного меню по правому клику и из главного меню File. В следующем диалоге Save to Server dialog выберите/снимите выбор файлов для включения, добавьте необязательный Comment, затем подтвердите процесс сохранения кнопкой . После добавления проекта на сервер панель Projects отразит полностью синхронизированное состояние между файлами в серверном репозитории и локальной рабочей копией, на что указывают значки .

Копирование проекта

Чтобы скопировать проект Workspace из Altium Designer, щёлкните правой кнопкой мыши по записи проекта в панели Projects и выберите команду Make a copy  в контекстном меню. Используйте диалог Create Project Copy, чтобы задать Project Name (по умолчанию это будет исходное имя проекта с суффиксом - Copy), Description (не заполняется автоматически), путь Folder (внутри Workspace) и путь Local Storage (к рабочей копии).

Путь в Workspace Folder по умолчанию будет той же папкой, в которой хранится исходный проект. Нажмите , чтобы открыть диалог Choose Folder (урезанную версию панели Explorer) и при необходимости изменить папку. Путь Local Storage по умолчанию будет задан с использованием расположения, определённого на странице System - Default Locations диалога Preferences. Нажмите , чтобы открыть стандартный диалог Windows, в котором при необходимости можно изменить это расположение.

Копирование проекта Workspace из Altium Designer.

Добавление и удаление документа проекта

После создания проекта в активный проект можно добавлять, редактировать или удалять документы проекта. Самый простой способ добавить новые документы проекта — щёлкнуть правой кнопкой мыши по имени проекта в панели Projects и выбрать Add New to Project в параметрах контекстного меню. Либо выберите требуемый тип документа в подменю Project » Add New to Project главных меню, чтобы добавить новый документ в активный проект.

Добавьте в проект конкретный или другой тип документа.

В проект также можно добавлять другие типы документов, относящихся к проекту, например текстовые файлы, PDF, электронные таблицы и т. п. Для этого используйте опцию Add Existing to Project (или команду Project » Add Existing to Project из главного меню редактора активного документа) и установите раскрывающийся список File Type в диалоге браузера Choose Document to Add в значение All Files (*.*), чтобы был доступ ко всем типам файлов.

Чтобы удалить документ из структуры проекта, щёлкните правой кнопкой мыши по его имени в панели Projects и выберите пункт меню Remove from Project или команду Project » Exclude from Project из главных меню. Вам будет предложено выбрать:

• Delete File– для безвозвратного удаления самого исходного файла документа.

• Exclude from Project – для удаления связи проекта с этим документом (без удаления самого исходного файла документа). Если документ в данный момент открыт в окне редактора проекта, он будет удалён из родительского проекта, но останется открытым в панели как свободный документ. Если же он в данный момент не открыт в рабочей области проектирования, удаление фактически закроет его.

  

Удаление проекта

Для локальных проектов удаление проекта сводится к удалению файлов с жёсткого диска. Откройте папку проекта в Проводнике Windows и удалите её содержимое.

Для проектов Workspace (и другого содержимого Workspace, такого как компоненты и выпущенные данные) доступна гибкая функциональность удаления непосредственно из Altium Designer — из панели Explorer panel. Работая как «мягкое удаление» (soft delete), процесс удаления предоставляет расширенные варианты и информацию по мере выполнения, включая соответствующие ссылки на исходные элементы для целей проверки. В Workspace удалённое содержимое перемещается в специальное Trash место, откуда его можно восстановить или полностью удалить на странице Trash в браузерном интерфейсе Workspace.

Чтобы выполнить мягкое удаление проекта Workspace, перейдите в папку проекта в панели Explorer, щёлкните правой кнопкой мыши по его записи и выберите команду Delete Folder в контекстном меню. Подтвердите удаление в появившемся диалоговом окне Confirm Delete. Если проект содержит выпущенные данные, откроется ещё одно диалоговое окно подтверждения, уведомляющее о том, что эти данные также будут удалены. Нажмите Delete, чтобы продолжить.

Мягкое удаление в действии. Здесь удаляется проект вместе со связанным выпуском (если бы по каким-либо выпускам были созданы производственные пакеты, они также были бы удалены).