Локальный выпуск

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

Выпустите проект локально из Altium Designer с помощью неуправляемого (автономного) режима инструмента Project Releaser, если вы не используете рабочее пространство или сейчас не можете к нему подключиться. В этой статье объясняется, как выбрать локальную папку или ZIP-архив для выпуска, настроить выходные данные и пути, а также пройти этапы проверки, генерации данных, просмотра результатов и получения итогового отчета о выполнении. Читайте дальше, чтобы уверенно настроить и выполнить локальный выпуск проекта.

- Узнайте, как выбрать выпуск в папку или ZIP-архив и настроить целевые папки и пути для выходных данных.
- Разберитесь в проверках перед выпуском, требованиях к валидации и возможностях просмотра сгенерированных данных перед завершением выпуска.
- Ознакомьтесь с важными мерами предосторожности, включая правила перезаписи и ограничения на изменение проекта во время подготовки к выпуску.
Узнайте больше с ИИ:

Помимо управляемого режима выпуска (Online), Project Releaser также поддерживает локальный неуправляемый выпуск (Offline). Обычно этот режим выпуска используется, если вы не используете рабочее пространство или в данный момент не можете подключиться к нему. Хотя Project Releaser по возможности автоматически определяет режим или предлагает варианты, если выбор неоднозначен, вы всегда можете принудительно включить режим Offline. Для этого задайте для Release Target на вкладке Release Options диалогового окна Project Release Options (нажмите кнопку на этапе 1 процесса выпуска) одно из следующих значений:

  • Unmanaged - Folder: выберите этот вариант, чтобы выпустить сформированные данные в локальную папку. Путь к корневой папке задаётся на вкладке Output Path диалогового окна. По умолчанию установлено значение [OutputPath] (с использованием пути, указанного в поле Output Path на вкладке Options диалогового окна Project Options).

  • Unmanaged - Zip: выберите этот вариант, чтобы выпустить сформированные данные в локальную папку. Данные будут упакованы в один ZIP-файл. Путь и имя ZIP-файла задаются на вкладке Output Path диалогового окна. По умолчанию установлено значение [OutputPath][ProjectName].zip (с использованием пути, указанного в поле Output Path на вкладке Options диалогового окна Project Options).

При задании требуемого пути вывода можно использовать записи [ProjectName] и [<ProjectParameterName>].

Быстро определить, что Project Releaser настроен на работу в режиме Offline, можно по следующим признакам:

  • Заголовок этапа 1 — Configure Local Release, а не Configure Server Release (как в режиме Online).

  • Заголовок этапа 5 — Pack Data, а не Upload Data (как в режиме Online).

Project Releaser настроен на локальный неуправляемый режим (Offline).
Project Releaser настроен на локальный неуправляемый режим (Offline).

Процесс выпуска очень похож на описанный для управляемого режима выпуска (Online), но данные выпускаются в локальные папки. Чтобы не повторять приведённую ранее информацию, ниже кратко описаны этапы процесса с акцентом на различия.

Этап 1 в режиме Offline — настройка локального выпуска

Здесь вы настраиваете данные, которые требуется сформировать из вашего проекта. Выпуск всегда включает исходные данные, а также при необходимости может включать данные для изготовления, сборки (основного исполнения и/или вариантов) и любые пользовательские данные.

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

  • Source Data — будут сформированы в папке Sources.

  • Fabrication Data (только для проекта печатной платы) — будут сформированы в папке Fabrication.

  • Assembly Data for no variant — будут сформированы в папке Assembly.

  • Assembly Data for <VariantName> (только для проекта печатной платы) — будут сформированы в папке Assembly <VariantName>.

  • Custom Data <Custom - n> — будут сформированы в папке <Custom - n>.

Разумеется, вы можете изменить эти имена в соответствии со своими требованиями. Для этого нажмите на текущую запись Target Folder, введите нужное новое имя папки и нажмите Enter.

При выпуске в локальную папку или ZIP-архив учитывайте, что повторный выпуск с теми же именами папок просто перезапишет существующие файлы данных в этих папках.

Настроив нужным образом наборы данных, которые должны быть созданы при выпуске, нажмите кнопку в правом нижнем углу представления, чтобы продолжить.

Кнопка имеет два состояния. Они немного различаются для двух вариантов неуправляемого выпуска:
  • Unmanaged - Folder: нажатие кнопки запускает стандартную команду Prepare. Процесс выпуска дойдёт до этапа Review Data, позволяя ещё раз убедиться, что всё в порядке, прежде чем выпускать данные в целевые папки. Если вы не хотите останавливаться для проверки, откройте раскрывающееся меню кнопки и выберите команду Prepare & Explore.
  • Unmanaged - Zip: нажатие кнопки запускает стандартную команду Prepare. Процесс выпуска дойдёт до этапа Review Data, позволяя ещё раз убедиться, что всё в порядке, прежде чем упаковывать данные в ZIP-файл. Если вы не хотите останавливаться для проверки, откройте раскрывающееся меню кнопки и выберите команду Prepare & Pack.

Затем выполняется несколько предварительных проверок, в том числе:

  • Проверка того, что проект и все файлы сохранены.

  • Проверка того, что проект и все соответствующие файлы зафиксированы в системе контроля версий (VCS), если она используется.

  • Проверка того, что для каждого включённого элемента данных задана целевая папка.

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

Если в выпускаемом проекте обнаружены внешние документы (документы, связанные с проектом, но хранящиеся вне папки проекта и её подпапок), откроется диалоговое окно External files со списком внешних документов (). Во избежание возможных проблем рекомендуется хранить все документы, связанные с проектом, в папке проекта или её подпапке.

На этом этапе формируется Source Data — снимок исходных файлов проекта помещается в целевую папку.

Этап 2 в режиме Offline — проверка проекта

После успешного завершения этапа 1 следующий этап процесса выпуска запускается автоматически, если в назначенных файлах OutJob обнаружен хотя бы один отчёт типа Validation. Запускаются все заданные генераторы выходных данных для проверки, определённые в файле Output Job, назначенном выпускаемому элементу данных. Этот этап выполняется так же, как и при выпуске в управляемом режиме (Online).

Если хотя бы одна проверка не пройдена, выпуск завершится с ошибкой.
Нажатие в правом нижнем углу представления остановит процесс выпуска.

Этап 3 в режиме Offline — формирование данных

После успешного завершения этапа 2 следующий этап процесса выпуска запускается автоматически. На этом этапе выполняется формирование всех остальных выходных данных, заданных в файлах OutJob, назначенных включённым элементам данных, для выпуска в соответствующие целевые папки. Этот этап выполняется так же, как и при выпуске в управляемом режиме (Online).

Нажатие в правом нижнем углу представления остановит процесс выпуска.

Этап 4 в режиме Offline — просмотр данных

После успешного прохождения всех проверок и формирования выходных данных на этом этапе процесса выпуска вы можете просмотреть сформированные данные. Этот этап выполняется практически так же, как при выпуске в управляемом режиме (Online).

Если вы использовали Prepare & Explore (цель выпуска Unmanaged - Folder) или команду Prepare & Pack (цель выпуска Unmanaged - Zip), этот этап будет недоступен. Иными словами, процесс не будет приостановлен для проверки: данные будут сразу выпущены — в целевые папки или упакованы в целевой ZIP-файл соответственно.

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

В компактном представлении сформированных данных нажмите ссылку View, чтобы открыть соответствующий файл или набор файлов данных в подходящем редакторе Altium Designer (например, в CAM-редакторе для файлов Gerber или сжатых и несжатых файлов ODB++) либо во внешнем приложении (например, в Microsoft Excel для спецификации). В подробном представлении дважды щёлкните запись, чтобы просмотреть только этот файл.

Если после проверки данных потребуется внести изменения, нажмите кнопку в правом нижнем углу представления. Появится диалоговое окно подтверждения с предупреждением о том, что все сформированные данные будут потеряны. Нажмите OK, чтобы отменить выпуск и вернуться к этапу 1.

Система не допускает изменения файлов проекта в промежутке между подготовкой выпуска и выпуском данных в целевые папки. Если вы каким-либо образом измените файлы проекта, процесс выпуска будет прерван и вы вернётесь к начальному этапу, предшествующему подготовке выпуска.

Если все сформированные данные в порядке, продолжите выпуск, нажав кнопку (также в правом нижнем углу представления). Дальнейшие действия зависят от выбранного варианта цели выпуска:

  • Unmanaged - Folder: сформированные файлы будут выпущены в целевые папки, после чего процесс сразу перейдёт к последнему этапу для просмотра отчёта о выполнении.

  • Unmanaged - Zip: процесс перейдёт к следующему этапу — Pack Data.

Автономный этап 5 — Упаковка данных

После подтверждения выпуска на предыдущем этапе система автоматически переходит к этому этапу, на котором данные упаковываются в один локальный ZIP-файл. Путь и имя ZIP-файла задаются на вкладке Output Path диалогового окна Project Release Options. По умолчанию используется значение [OutputPath][ProjectName].zip (с путём, заданным в поле Output Path на вкладке Options диалогового окна Project Options).

Этот этап доступен только при использовании варианта цели выпуска Unmanaged - Zip.

Автономный этап 6 — Отчёт о выполнении

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

Итоговый отчёт о выпуске при использовании цели выпуска Unmanaged - Folder. Наведите указатель мыши на изображение, чтобы увидеть аналогичный отчёт для цели выпуска Unmanaged - Zip.
Итоговый отчёт о выпуске при использовании цели выпуска Unmanaged - Folder. Наведите указатель мыши на изображение, чтобы увидеть аналогичный отчёт для цели выпуска Unmanaged - Zip.

Используйте навигационную ссылку, чтобы быстро открыть в Проводнике Windows выходную папку или упакованный ZIP-файл соответственно.

Быстрый переход к выходной папке с локально выпущенными данными непосредственно с этапа «Отчёт о выполнении» в интерфейсе. Наведите указатель мыши на изображение, чтобы увидеть пример перехода к ZIP-файлу с упакованными данными локального выпуска.
Быстрый переход к выходной папке с локально выпущенными данными непосредственно с этапа «Отчёт о выполнении» в интерфейсе. Наведите указатель мыши на изображение, чтобы увидеть пример перехода к ZIP-файлу с упакованными данными локального выпуска.

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

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

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

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

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

Contents