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

Altium Training

Altium Essentials: Project Creation and Storage

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Краткий обзор

Любая разработка в Altium Designer начинается с проекта, объединяющего все относящиеся к нему документы. В этой статье рассказывается, как создать проект в Altium Designer, выбрать тип проекта и шаблон, а также настроить хранение в подключенном рабочем пространстве Workspace, внешнем репозитории системы контроля версий или локальной папке. Также рассматриваются такие настройки, как контроль версий, управление ограничениями, пути к папкам и параметры проекта. Читайте дальше, чтобы заложить надежную основу для своей следующей разработки.

- Ознакомьтесь с доступными вариантами хранения проектов и преимуществами управления проектами в Workspace.
- Узнайте, как выбирать шаблоны и настраивать параметры проекта в диалоговом окне Create Project.
- Посмотрите, как новые проекты отображаются на панели Projects и в каких случаях проект содержит только пустую структуру.
Узнайте больше с ИИ:

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

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

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

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

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

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

Диалоговое окно Create Project позволяет создать новый проект в подключенном рабочем пространстве Workspace, добавить новый проект в существующий внешний репозиторий системы управления версиями (с рабочей копией в выбранном вами расположении), а также создать новый проект в указанной папке на локальном жестком диске.

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

    Вкратце, управление проектами направлено на безопасное хранение и отслеживание изменений на протяжении всего процесса проектирования и, в конечном счете, на доведение полученной разработки до изготовления физического изделия — например, собранной печатной платы для использования в конечном продукте. Для решения этих задач 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 осуществляется под управлением активных определений процессов. Подробнее см. в разделе Создание проектов на основе процессов.

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

    Подробнее см. в разделе Создание шаблона проекта.

  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 этот параметр фактически всегда включен.
  • При создании проекта печатной платы установите флажок Constraint Management, чтобы управлять проектными ограничениями с помощью диспетчера ограничений (Constraint Manager). Если этот параметр отключен, в проекте будет использоваться система правил проектирования.

    Параметр Constraint Management включен по умолчанию в диалоговом окне Create Project, если параметр System.ConstraintManager включен в диалоговом окне расширенных настроек (Advanced Settings).

  • При подключении к Enterprise Server Workspace в раскрывающемся списке Repository (если он отображается) будут перечислены все репозитории проектных данных, управляемые службой управления версиями 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 рабочего пространства Enterprise Server. Это можно сделать до обновления сервера, как описано здесь.

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

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

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

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

    • В поле Local Storage укажите, где на жестком диске будет храниться локальная версия проекта. Расположение по умолчанию задается на странице Система — Расположения по умолчанию диалогового окна Preferences. При необходимости нажмите кнопку , чтобы найти и выбрать другую папку. Это «рабочая» папка проекта и репозитория Git local, в котором фиксируются его изменения. В конечном итоге или в момент фиксации изменений проект отправляется в централизованный репозиторий проектов в рабочем пространстве (Versioned Storage), который является репозиторием Git remote.

     

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

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

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

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

Вновь созданный проект, зафиксированный в репозитории проектов Versioned Storage в рабочем пространстве.Вновь созданный проект, зафиксированный в репозитории проектов Versioned Storage в рабочем пространстве.

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

  • Проект появится на панели Projects под записью целевого рабочего пространства, отображающей его имя.

  • Кроме того, запись проекта появится на странице Projects браузерного интерфейса рабочего пространства.

  • Изначально доступ к проекту на чтение и запись предоставляется создавшему его разработчику (владельцу) и всем администраторам рабочего пространства.

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

  • Новый проект также можно создать непосредственно в рабочем пространстве через его браузерный интерфейс на странице проектов (выберите Projects), а затем открыть в Altium Designer для редактирования и добавления содержимого.

  • Вместе с файлом проекта (*.PrjPcb) создается файл структуры проекта (*.PrjPCBStructure). Этот файл содержит сведения об иерархии проекта независимо от того, является ли его структура плоской или иерархической. Файл формируется заново при динамической компиляции проекта (при открытии документа проекта).

  • Диалоговое окно Create Project также можно открыть, щелкнув правой кнопкой мыши запись рабочего пространства на панели Projects  и выбрав в меню команду Create Project.

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

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

Для копирования проекта не требуются специальные разрешения. Скопированный проект является точной копией исходного проекта рабочего пространства и имеет те же возможности редактирования без каких-либо ограничений, то есть создать проект «только для чтения» нельзя. Также обратите внимание, что копия проекта будет создана в том же репозитории проектов, что и оригинал: изменить репозиторий при копировании нельзя.

По умолчанию для Folder в рабочем пространстве используется та же папка, в которой хранится исходный проект. Нажмите , чтобы открыть диалоговое окно Choose Folder (упрощенную версию панели Проводник) и при необходимости выбрать другую папку. По умолчанию для Local Storage используется расположение, заданное на странице Система — Расположения по умолчанию диалогового окна Preferences. Нажмите , чтобы открыть стандартное диалоговое окно Windows и при необходимости изменить это расположение.

Копирование проекта рабочего пространства из Altium Designer.
Копирование проекта рабочего пространства из Altium Designer.

При каждом копировании проекта на временную шкалу истории скопированного проекта добавляется плитка события Project Copied. Кроме того, плитка Project Created копии проекта будет содержать ссылку на исходный проект. Подробнее см. в разделе История проекта.
Существующий проект рабочего пространства можно скопировать из диалогового окна «Открыть проект». Выберите проект в подключенном рабочем пространстве, затем нажмите элемент управления Open Project As Copy в нижней части правой области Information . Кроме того, при просмотре проекта на панели Explorer Altium Designer, настроенной на режим по умолчанию Project View, а не Classic View, проект можно скопировать, нажав кнопку Copy в правом верхнем углу панели.
Копировать можно только проект рабочего пространства, открытый из текущего подключенного рабочего пространства Altium. Если Altium Designer в данный момент не подключен к рабочему пространству проекта или проект не является проектом рабочего пространства, команда Make a copy будет недоступна в контекстном меню.

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

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

  • Если для выбранного типа документа можно задать параметры по умолчанию на странице Управление данными — Шаблоны диалогового окна Preferences, документ выбранного типа будет создан с использованием соответствующего шаблона по умолчанию.
  • Изначально документ не сохранен.

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

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

Проекты могут содержать не только файлы, созданные в Altium Designer, — в проект можно включить практически любой документ. При открытии документа из Altium Designer система попытается определить соответствующее средство создания или просмотра на основе расширения файла и настроек реестра Windows. Если соответствующая программа найдена, Altium Designer запустит связанный редактор — в собственной среде редактирования или как отдельное приложение. Это позволяет включать в проекты всевозможные документы по испытаниям, сопроводительные и справочные материалы, а также спецификации и быть уверенным, что при переносе проекта вся сопроводительная документация останется вместе с ним.
При добавлении существующих документов в проект рабочего пространства Altium 365 учитывайте ограничение для файлов zip, 7z и rar размером более 256 МБ. Проекты, содержащие такие файлы, невозможно сохранить в рабочем пространстве — возникнет ошибка Git. О том, как устранить эту проблему, см. в статье базы знаний Как восстановить данные проекта после ошибки Git с кодом состояния 471.

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

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

Также можно удалить из родительского проекта все документы выбранной категории (вложенной папки): щелкните правой кнопкой мыши запись нужной категории и выберите команду Remove All в контекстном меню.

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

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

Чтобы быстро открыть Проводник Windows в папке, где хранится проект, щелкните правой кнопкой мыши запись проекта на панели Projects и выберите команду Explore.

Для проектов рабочего пространства (и другого его содержимого, например компонентов и выпущенных данных) предусмотрены гибкие возможности удаления непосредственно из Altium Designer, с панели «Проводник». Используется механизм «мягкого удаления»: в процессе удаления доступны дополнительные действия и сведения, включая ссылки на исходные элементы для их проверки. В рабочем пространстве удаленное содержимое перемещается в специальное расположение Trash , откуда его можно восстановить или окончательно удалить на странице Trash веб-интерфейса рабочего пространства.

Только владелец проекта или администратор может окончательно удалить его из Trash или восстановить оттуда.

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

Чтобы быстро открыть панель Explorer с выбранной папкой проекта, щёлкните запись проекта правой кнопкой мыши на панели Projects и выберите команду Show in Explorer.

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

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

Если вы не видите описанную функцию в используемом вами программном обеспечении, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.

Contents