Выпуск проекта разработки

Когда проект считается готовым к «вылету» в большой мир, его необходимо выпустить — процесс, важность которого нередко недооценивают.

Без регламентированного и принципиально надежного процесса выпуска отслеживание постоянно развивающегося продукта с течением времени может быть сопряжено с множеством подводных камней. Только представьте: вам нужно вернуться и выпустить предыдущую ревизию продукта, а затем выясняется, что все необходимые исходные файлы проекта так и не были включены в виде снимка в состав того конкретного релиза! Ничего страшного; достаточно взять сгенерированные выходные файлы из соответствующей папки(ок) этого релиза — надежные Gerber-файлы и любую дополнительную информацию для изготовления и сборки; в конце концов, именно это и нужно. Но представьте, что эти «надежные» выходные данные были перезаписаны или каким-то образом повреждены. Вот если бы процесс выпуска был более надежным.

Altium Designer решает эту задачу, предоставляя мощные и высоконадежные средства управления выпуском проектных релизов. Процесс выпуска проектного релиза автоматизирован, что позволяет выпускать ваши проекты без рисков, связанных с ручными процедурами. При выпуске конкретного проекта создается снимок исходных проектных данных, который архивируется вместе со всеми сгенерированными выходными данными — то есть с тем осязаемым продуктом, который создается на основе этого проекта и продается компанией. Данные релиза сохраняются в указанной папке/Zip на жестком диске или в ревизиях соответствующего элемента, связанного с проектом, в целевом Workspace:

• Source Data (PCB Project Design Item) — снабженная временной меткой копия (снимок) основных проектных файлов, включая все исходные документы. Выпускается в отдельный элемент в Workspace, что позволяет хранить вашу ценную интеллектуальную собственность отдельно от сгенерированных данных для изготовления и сборки, необходимых внешним сторонам для производства продукта.
• Fabrication Data (PCB Fabrication Data Item) — набор данных, необходимый производителю печатных плат для изготовления голой платы (Gerber-файлы, NC Drill-файлы и т. д.)
• Assembly Data (PCB Assembly Data Item) — набор данных, необходимый сборочному производству для установки указанных компонентов на голую плату в соответствии со спецификацией материалов (файлы Pick and Place, сборочные чертежи, BOM и т. д.). Отдельный уникальный элемент используется для базового проекта (полностью укомплектованного) и для каждого определенного варианта проекта (сборочные варианты).

Сгенерированные данные проекта надежно хранятся в Workspace в ревизиях связанных с проектом элементов. Затем эти высоконадежные данные используются цепочкой поставок для изготовления требуемой ревизии продукта.

Итоговый результат — максимально надежное управление выпуском проектных релизов. Под строгим контролем, резервным копированием и управлением версиями находится не только сам проект, но и релизы его данных аналогичным образом в целевом Workspace — надежно, безопасно, защищенно.

Ключевые преимущества

• Интеграция с системой контроля версий. Если ваш проект находится под контролем версий, система требует, чтобы перед выпуском все файлы были зафиксированы и актуальны. Это гарантирует, что никакая «частная копия» важного проектного документа не останется на жестком диске инженера с риском быть утерянной. Это простое правило может сэкономить многие часы дорогостоящих поисков нужного набора проектных документов, использованных для формирования выпущенного продукта.
• «Однократный выпуск». Система позволяет выполнить выпуск только один раз в любую заданную ревизию целевого элемента. Более того, успешный выпуск приводит к фиксации (сохранению) данных релиза в указанной ревизии элемента, после чего эта ревизия закрывается. В ту же самую ревизию больше нельзя сгенерировать и выпустить дополнительные данные.
• Автоматизированный и повторяемый процесс выпуска проекта. Выпуск одним нажатием — без ручных этапов и рисков. От создания снимка проектных файлов до проверки и генерации выходных данных взаимодействие пользователя не требуется. Если какая-либо часть процесса завершается неудачно, не удается и весь выпуск. Все просто. При этом перед окончательной фиксацией данных релиза в ревизии элемента целевого Workspace вы можете просмотреть все сгенерированные данные.

• Возможность проверки проекта как неотъемлемой части процесса выпуска. Процесс выпуска работает на основе «заблокированного» снимка исходных данных проекта (включая зависимости), и предварительная проверка почти наверняка уже была выполнена до запуска выпуска. Но для дополнительной уверенности и обеспечения целостности проектных данных вы можете при необходимости добавить этапы проверки в «поток» процесса выпуска с помощью соответствующим образом настроенных Output Job Configurations. Это и стандартная проверка ERC для исходных схем, и проверка DRC для PCB, а также возможность проверить синхронизацию исходного проекта и PCB и сравнить посадочные места на плате с их исходной библиотекой, чтобы убедиться, что они актуальны и соответствуют друг другу. Выпуск завершится неудачей, если какие-либо проверки не будут пройдены успешно.

  • При проектировании с подключенным Workspace и использовании компонентов Workspace в своем проекте вы можете добавить и настроить дополнительную проверку — Component State Checking. Она проверяет наличие компонентов, находящихся в ограниченных состояниях. В рамках этой настройки вы определяете действие, которое должно выполняться для каждого текущего определенного состояния каждой текущей определенной модели жизненного цикла в целевом Workspace: ничего не делать, выдать предупреждение или сформировать ошибку. Последний вариант предотвратит выпуск проекта. Кроме того, запуск проверки формирует удобный отчет в формате HTML, позволяющий с первого взгляда увидеть, какие компоненты проекта находятся в недопустимых состояниях.
  • Вы также можете включить Environment Configuration Compliance Check. Это дает возможность однозначно проверять и обеспечивать использование в проекте утвержденных компанией элементов данных. Проще говоря, если вы используете элементы данных, не разрешенные конфигурацией среды, доступной для вашей назначенной роли, выпуск завершится неудачей. Это предотвращает «вольный» подход к проектированию и гарантирует соблюдение рабочих проектных сред, централизованно определенных на уровне предприятия. Подробнее см. Environment Configuration Management (Altium 365 Workspace,  Enterprise Server Workspace).
• Все сгенерированные файлы данных процесса выпуска проекта могут при необходимости автоматически получать префикс с ID элемента и ID ревизии элемента, что исключает любую неоднозначность относительно того, для сборки какой ревизии какого элемента должны использоваться эти данные.
• Публикация. Возможность публиковать данные релиза напрямую из Workspace в общее пространство хранения, например Amazon S3, FTP-серверы, Box.com или обычную сетевую папку. Это упрощает безопасный обмен данными Workspace без предоставления внешним сторонам доступа к самому Workspace.

Project Releaser

Altium Designer предоставляет мощные и высоконадежные средства управления выпуском проектных релизов благодаря Project Releaser. Благодаря интуитивно понятному пользовательскому интерфейсу вы можете одновременно генерировать все производственные данные для своего проекта — данные для изготовления, данные для сборки, исходные проектные данные и т. д. Project Releaser также позволяет одновременно генерировать сборочные данные для нескольких обнаруженных вариантов вашего PCB-проекта. Вам даже не придется беспокоиться, если вы не создали файлы Output Job — инструмент сделает это за вас, если вы попросите!

С помощью Project Releaser вы сможете с легкостью генерировать производственные данные с максимальной надежностью. И вы также сможете оценить результаты этой генерации до окончательного подтверждения релиза (например, просмотреть данные Gerber/ODB++ в CAM-редакторе), чтобы убедиться, что сгенерированные данные — именно те, которые необходимы для изготовления вашего проекта в срок и с первого раза.

Предварительные условия для выпуска проектного релиза в Workspace:

• Altium Designer подключен к Workspace, в котором размещен целевой репозиторий для релиза.
• Проект включает подходящие Output Jobs — генераторы выходных проектных данных (для таких выходов, как печать, файл или PDF). Если OutJobs недоступны, Project Releaser предложит создать подходящие Outjob-файлы для выполнения процесса.
• Проект, используемый процессом Release, содержит все необходимые элементы — исходные данные корректны и актуальны, у пользователя достаточно прав для выпуска этого проекта в Workspace и т. д.

Доступ к Project Releaser

Сам процесс выпуска выполняется с помощью Project Releaser Altium Designer, пользовательский интерфейс которого представлен в специальном представлении — представлении Release. Доступ к нему можно получить следующим образом:

• Выбрать команду Project » Project Releaser в главном меню (при этом исходный документ нужного проекта должен быть открыт как активный документ).
• Щелкнуть правой кнопкой мыши по записи нужного проекта на панели Projects panel и выбрать команду Project Releaser в контекстном меню.

Представление Release — пользовательский интерфейс для Project Releaser.

Публикация в PLM

Related page: Интеграция PLM (Altium 365 Workspace, Enterprise Server Workspace)

Если у вас активирован процесс публикации в экземпляр PLM как часть Project Releaser, он будет представлен в подменю Project Releaser для проекта. Запуск этого процесса добавит в представление дополнительный этап именно для этой задачи.

Определение примера процесса Publish to PLM (User selects) доступно в вашем Workspace — как часть темы процесса Project Activities — для выполнения этой стандартной публикации (то есть не публикации как части Project Releaser, как описывалось ранее). Этот процесс позволяет публиковать выходные данные выпущенного проекта в интегрированный экземпляр PLM, при этом пользователь может точно выбрать, какие именно результаты будут опубликованы. Схема рабочего процесса показана ниже.

Схема рабочего процесса для стандартного определения примера процесса Publish to PLM (User selects)

К процессам стандартной публикации в PLM можно получить доступ из Altium Designer через подменю Project » Project Activities для активного проекта.

Доступ к активированному процессу стандартной публикации выпущенных данных проекта Workspace в экземпляр PLM из Altium Designer.

В браузерном интерфейсе Workspace к активированному определению процесса можно получить доступ со страницы Projects интерфейса. Выберите нужный проект, затем нажмите кнопку .

Режим/цель выпуска

Project Releaser поддерживает все типы проектов разработки — локальные/без контроля версий, находящиеся под управлением внешней VCS, или под собственным контролем версий подключенного Workspace — предлагая два режима работы:

• Managed (Online) Mode — выпуск всех сгенерированных данных в ревизии элементов в целевом Workspace. Вам даже не нужно помнить об увеличении ревизий элементов — система всё сделает за вас. И если у вас определён процесс выпуска в экземпляр PLM через Project Releaser, запуск этого процесса добавит в представление дополнительный этап именно для этого.
• Unmanaged (Offline) Mode — выпуск всех сгенерированных данных в структуру на основе папок, которую при необходимости можно упаковать в один Zip-файл.

Project Releaser пытается автоматически определить, какой режим выпуска использовать и какова цель выпуска. Если возможен выбор, обычно когда проект был выпущен в один Workspace, а вы в данный момент активно подключены к другому, система предоставит доступные вам варианты.

Обнаружение файлов Output Job

Основной способ генерации выходных данных проекта в Altium Designer основан на наборе доступных генераторов выходных данных, которые создают файлы данных и графические материалы, необходимые для создания физической версии проекта — другими словами, распечатки схемы и PCB, производственные файлы Gerber и NC Drill, ведомость материалов (BOM), сборочные файлы Pick and Place, производственные чертежи и т. д., которые необходимы для изготовления и сборки устройства.

Выбранные генераторы выходных данных и конкретные выходные файлы, которые они создают для проекта, совместно определяются с помощью Output Job Editor, который сохраняет конфигурации сопоставления «генератор-выход» в файле Output Job (*.OutJob) — создаваемом с помощью команды File » New » Output Job File.

Как основной механизм коллективной генерации производственных файлов для проекта, Output Job в Altium Designer предоставляют следующие дополнительные возможности:

• В один проект можно добавить любое количество OutJob, чтобы были доступны конфигурации для конкретных задач, таких как генерация выходных данных для производства, сборки, архивирования, закупок и документации.
• Файлы OutJob фактически являются переносимыми и могут применяться к любому проекту разработки, где требуется стандартизованный набор выходных данных проекта. Например, выберите [Project] в качестве параметра источника документа вместо конкретного файла проекта, чтобы создать универсальный (и, следовательно, переносимый) Output Job.
• OutJob могут включать файлы для проверок валидации проекта, таких как электрические проверки (ERC), проверки правил (DRC) и сравнение посадочных мест с исходными данными. Таким образом, задания Validation output представляют собой специализированный «активный» случай, когда проект проверяется, а фактический выходной результат (например, PDF-документ) отражает результаты процесса валидации.
• OutJob поддерживают варианты сборки платы, когда для производства альтернативных версий проекта требуются разные наборы выходных файлов — например, стандартные или усиленные версии изделия, использующие дополнительные компоненты или компоненты других типов. См. Design Variants для получения дополнительной информации о вариациях конструкции платы.
  Обратите внимание, что Variant Choice, указанный в Output Job, не применяется, когда OutJob используется в процессе Project Release. В этом случае выбор вариантов автоматически определяется и/или явно задаётся в самом Releaser.

Если с вашим проектом в данный момент не связан ни один файл Output Job, Project Releaser обнаружит это, и вам будет предложено добавить файлы по умолчанию. Если вы согласитесь, будет создано следующее:

• Для проекта PCB:
  • Assembly.OutJob — со следующими определёнными выходными данными:
    • Documentation Outputs: PCB 3D Print, Schematic Prints
    • Assembly Outputs: Generates pick and place files, Assembly Drawings
    • Report Outputs: Bill of Materials
    • Export Outputs: Export STEP
  • Fabrication.OutJob — со следующими определёнными выходными данными:
    • Documentation Outputs: PCB Prints
    • Fabrication Outputs: Gerber Files, NC Drill Files и IPC-2581
    • Validation Outputs: Design Rules Check, Footprint Comparison Report
    • Export Outputs: Save As/Export PCB

  Эти файлы Output Job по умолчанию берутся из следующей папки установки по умолчанию: \Users\Public\Documents\Altium\AD<Solution/Version>\OutputJobs.

• Для проекта жгута:
  • Assembly.OutJob — со следующими определёнными выходными данными:
    • Documentation Outputs: Draftsman
    • Report Outputs: Bill of Materials
    • Validation Outputs: Electrical Rules Check

  Этот файл Output Job по умолчанию берётся из следующей папки установки по умолчанию: \Users\Public\Documents\Altium\AD<Solution/Version>\OutputJobs\Harness.

Обнаружение вариантов

Для проектов PCB очень мощной особенностью Project Releaser является то, что он обнаруживает определённые для вашего проекта варианты и создаёт для каждого наборы Assembly Data, готовые к выпуску. Каждый набор Assembly Data будет отображаться с (по умолчанию) именованием целевого элемента в следующем виде:

PCBA-[ProjectName]-[VariantName]

Суффикс [VariantName] гарантирует, что при генерации данных из назначенного(ых) файла(ов) OutJob используется правильный вариант.

Дополнительные наборы Assembly Data, созданные на основе обнаружения вариантов, определённых для проекта.

Процесс выпуска

Процесс выпуска представляет собой поэтапный поток, при этом записи в левой части представления Release показывают, на каком этапе вы сейчас находитесь.

Чтобы узнать больше о процессе выпуска для режима Online, обратитесь к странице Releasing to a Workspace. Чтобы узнать больше о специфике режима Offline, обратитесь к странице Releasing Locally.

Публикация выпущенных данных

Related page: Работа с местами назначения публикации

Для выпущенных данных, сгенерированных из проекта PCB (только PCB Fabrication Data, PCB Assembly Data и элементы PCB Project Design), у вас есть возможность напрямую публиковать эти данные из вашего Workspace или Output Job в пространство хранения, такое как Box.com, Amazon S3, FTP-сервер или простую папку в общей сети. С точки зрения распространения и совместной работы это даёт непревзойдённое преимущество в мире, где совокупные участники общей «команды продукта» — команда разработки, производственная команда и все остальные, вовлечённые в процесс превращения идеи в реальный продукт, — часто распределены по всему миру.

Публикация заключается в определении Publishing Destination, а затем загрузке выпущенных данных для требуемой ревизии элемента в это место назначения. От производственного предприятия в Китае до команд разработчиков в Киеве, Стэнстед-Эбботтс и Сан-Диего, и до руководителя проекта, летящего где-то над Тихим океаном, — все, кому нужно знать о новом выпуске, могут быть приглашены по ссылке на опубликованную папку, получая общий (и контролируемый) доступ для просмотра, обсуждения и использования данных, необходимых для создания элемента.

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

Глобальный совместный доступ к данным производственного пакета

Ключевой аспект проектов разработки, хранящихся в Altium 365 Workspace, — возможность создать и поделиться с другими пакетом выпуска Build Package. Если предоставить к нему доступ напрямую вашему производителю, его можно рассматривать как Manufacturing Package, поскольку именно этот пакет производитель может просматривать, скачивать и использовать для изготовления и сборки платы.

Поддерживая возможность делиться таким пакетом с другими пользователями и с вашим производителем (который обычно находится вне вашей организации), платформа Altium 365 предоставляет выделенный Manufacturing Package Viewer — элемент поддержки Global Sharing платформы, — который позволяет другим просматривать производственный пакет из любого веб-браузера, из любой точки мира, но вне вашего Workspace, благодаря чему сами проекты и другая ценная интеллектуальная собственность остаются недоступными.

Каждый пользователь, которому предоставлен доступ, получит приглашение по электронной почте со ссылкой для просмотра производственного пакета через Manufacturing Package Viewer. Общие производственные пакеты отображаются на странице Shared with Me браузерного интерфейса платформы Altium 365.

Сам Manufacturing Package Viewer позволяет ключевым заинтересованным сторонам — и в первую очередь производственному персоналу — видеть сводную информацию о проекте с основными данными по плате, а также просматривать структуру исходных данных, данных на изготовление и сборку (и при необходимости загружать любой отдельный файл). Также доступны подстраницы просмотра данных Fabrication, Assembly и BOM, причем страница Fabrication содержит Gerber Viewer и позволяет всем пользователям, которым был предоставлен доступ к пакету, добавлять комментарии.

В конечном итоге производственный персонал может скачать Build Package просмотренного релиза — с любой страницы Viewer — чтобы физически реализовать данную ревизию платы.

Производственный пакет, которым с вами поделились, можно открыть со страницы Shared with Me. Пользователь, который поделился с вами производственным пакетом, получит приглашение по электронной почте для доступа к этому пакету через Altium 365. После нажатия кнопки  в письме он будет перенаправлен на страницу Altium 365 Sign In (если только он уже не выполнил вход в платформу или в свою учетную запись AltiumLive). После входа он будет направлен в Manufacturing Package Viewer с уже загруженным пакетом. Если у пользователя нет учетной записи AltiumLive, ему сначала потребуется зарегистрироваться — ссылка для этого доступна на странице Altium 365 Sign In.

Web Viewer

Related page: Web Viewer (Altium 365 Workspace, Enterprise Server Workspace)

Интерфейс Web Viewer Workspace обеспечивает универсальный доступ к документам проекта PCB через стандартный веб-браузер. Это гораздо больше, чем просто веб-средство просмотра: передовая браузерная технология Web Viewer's позволяет пользователям перемещаться по структуре проекта, взаимодействовать с проектными документами, извлекать информацию об элементах проекта и выделять области или объекты для добавления комментариев.

При просмотре документов визуальное качество схем и PCB не ухудшается из-за веб-формата, который также обеспечивает полноценные возможности панорамирования и масштабирования, а также поиск, кросс-пробинг, выбор и инспектирование компонентов и цепей по всему проекту.

Интерфейс Web Viewer Workspace обеспечивает глубокий интерактивный опыт проверки, например, исходных документов схемы и PCB в вашем проекте. Здесь показана схема в интерфейсе Web Viewer Altium 365 — наведите курсор на изображение, чтобы увидеть PCB (в 3D).

Как независимая браузерная платформа просмотра, интерфейс Web Viewer предоставляет интерактивный доступ только для чтения к проектным документам без необходимости открывать проект в среде редактирования. Действия в пространстве Web Viewer не влияют на других участников, работающих над проектом, например на инженера, который им «владеет», — за исключением связанных уведомлений о комментариях.