Сделать существующий проект доступным в рабочем пространстве

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

Локальный проект, который не находится под контролем версий или использует внешнюю систему контроля версий, можно зарегистрировать в рабочем пространстве с помощью механизма Simple Sync. В рабочем пространстве создается зеркальная копия проекта, которая затем синхронизируется с оригиналом. После сохранения изменений в локальных файлах (или их сохранения и фиксации во внешнем репозитории проектов) эти изменения автоматически синхронизируются с соответствующими файлами зеркальной копии проекта в рабочем пространстве. Simple Sync позволяет пользоваться средствами совместной работы платформы Altium 365, сохраняя исходный проект в его текущем расположении. Однако имейте в виду: локальный проект, не использующий внешнюю VCS, может редактировать только один человек — владелец проекта, который сделал его доступным онлайн в рабочем пространстве.

Чтобы сделать существующий проект (локальный или находящийся под внешним контролем версий) доступным в рабочем пространстве — в виде зеркальной копии (Simple Sync) в рабочем пространстве Altium 365 или под управлением встроенной системы контроля версий Git рабочего пространства, — откройте проект в Altium Designer обычным способом, затем щелкните правой кнопкой мыши его запись на панели Projects и выберите Make Project Available Online в контекстном меню. Откроется диалоговое окно Make Available Online. При использовании рабочего пространства Enterprise Server команда Make Project Available on Server открывает диалоговое окно Make Available On Server.

Если вы подключены к рабочему пространству, в котором есть одно или несколько активных определений процессов в категории Project Creations, для предоставления существующего проекта в рабочем пространстве щелкните правой кнопкой мыши запись проекта на панели Projects и выберите команду в подменю Convert to Managed Project — подробнее см. в разделе Преобразование проектов с помощью процессов.

Сделайте существующий локальный проект доступным в рабочем пространстве, фактически «зарегистрировав» его и создав его «зеркальную копию».
Сделайте существующий локальный проект доступным в рабочем пространстве, фактически «зарегистрировав» его и создав его «зеркальную копию».

Используйте диалоговое окно Make Available Online, чтобы изменить Name проекта и добавить Description. По умолчанию используется имя исходного проекта.

Установите флажок Version Control, чтобы добавить проект во встроенную систему управления версиями (Git) рабочего пространства. Если этот флажок снят (такая возможность доступна только в рабочем пространстве Altium 365), файлы проекта будут просто храниться в рабочем пространстве для базового доступа и предоставления другим пользователям доступа только для просмотра и комментирования — по схеме Simple Sync. Рекомендуется включить управление версиями: это позволит использовать все возможности рабочего пространства и платформы Altium 365. Обратите внимание, что зеркальное отображение проекта в рабочем пространстве (Simple Sync) доступно только при подключении к рабочему пространству Altium 365.

Если локальный проект уже находится под управлением системы контроля версий (во внешнем репозитории проектов), в диалоговом окне Make Available Online будет доступен параметр Migrate to Altium 365 Versioned Storage. Подробнее см. в разделе Переход с внешней системы управления версиями на встроенную систему рабочего пространства.

Project Sharing in an Altium 365 Workspace:

Если параметр Version Control отключен и для локального проекта, не находящегося под управлением внешней системы контроля версий, используется функция Simple Sync, редактировать проект сможет только один пользователь — его владелец, который сделал проект доступным в рабочем пространстве. Преимущество Simple Sync проявляется в тех случаях, когда вы не хотите, чтобы кто-либо еще редактировал ваш проект, но при этом хотите воспользоваться возможностями глобального совместного доступа Altium 365 и предоставить нескольким пользователям доступ к проекту для просмотра и комментирования.

Если параметр Version Control включен и используется репозиторий проектов Versioned Storage рабочего пространства на базе Git, доступ к проекту для редактирования либо для просмотра и комментирования можно предоставить нескольким пользователям.

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

Задав необходимые параметры переноса проекта в диалоговом окне Make Available Online , нажмите OK. Если проект не находится под управлением внешней системы контроля версий и для него включен онлайн-доступ (в рабочем пространстве Altium 365 установлен флажок Version Control), проект и его файлы будут зафиксированы и отправлены в репозиторий проектов Versioned Storage рабочего пространства. После этого на панели Projects будет отображаться состояние полной синхронизации репозитория проектов рабочего пространства и локального репозитория (рабочей копии), о чем свидетельствуют соответствующие значки . Проект становится полноценным проектом рабочего пространства: он не просто «зарегистрирован» в нем, а фактически зафиксирован в репозитории и находится под управлением системы контроля версий рабочего пространства. Все изменения проекта необходимо сохранять в репозитории рабочего пространства, выполняя фиксацию и отправку.

Изначально доступ на чтение и запись к проекту, размещенному в рабочем пространстве, предоставляется создавшему его разработчику (владельцу) и всем администраторам рабочего пространства. Дополнительные сведения о настройке прав доступа к проекту см. в разделе Предоставление совместного доступа к проекту.

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

При размещении проекта, находящегося под управлением внешней системы контроля версий, в подключенном рабочем пространстве автоматически созданные ссылки на внешние репозитории скрываются на странице Data Management – Design Repositories диалогового окна Preferences.

Эта функция находится на стадии открытого бета-тестирования и доступна, если включен параметр VCS.HideProjectExternalRepositoriesLinks в диалоговом окне Advanced Settings.

Ограничения при использовании существующего внешнего репозитория системы управления версиями

Как упоминалось ранее, ваши локальные проекты уже могут отслеживаться существующей внешней системой управления версиями (Git, SVN, EPDM и т. д.). При использовании рабочего пространства Altium 365 можно продолжать работать по прежней схеме и просто сделать проекты доступными в рабочем пространстве, зарегистрировав их в нем с помощью функции Make Project Available Online.

В этом режиме каждый раз, когда вы вносите изменения в проект и фиксируете их во внешнем репозитории системы управления версиями, данные проекта в фоновом режиме зеркально копируются в рабочее пространство, а вся необходимая обработка выполняется как обычно: формирование предварительного просмотра, определение мест использования и т. д. Однако следует учитывать некоторые ограничения:

  • Создание нового проекта по-прежнему должно выполняться по прежней схеме, то есть вручную во внешней системе управления версиями. Затем проект регистрируется в рабочем пространстве и зеркально копируется в него с помощью функции Make Project Available Online.
  • Если в проект внесены изменения, но их фиксация и отправка выполнены внешними средствами, а не через Altium Designer, эти изменения не отобразятся в зеркальной копии проекта в рабочем пространстве. Это будет исправлено при следующем открытии проекта в Altium Designer: локальный проект автоматически синхронизируется с зеркальной копией в рабочем пространстве. Если изменения внес другой пользователь, после повторного открытия файлы проекта будут отображаться со статусом Out Of Date (); это можно исправить с помощью команды управления версиями Update.
  • Чтобы открыть проект, другому пользователю потребуется доступ к этому внешнему репозиторию системы управления версиями.
  • Настраивать и поддерживать права доступа придется в двух местах: в рабочем пространстве и в основном источнике данных — внешнем репозитории Git, SVN или другой системы управления версиями.
  • Некоторые функции платформы Altium 365 работают только в том случае, если проект находится под управлением встроенной системы контроля версий рабочего пространства. Если оставить проект во внешней системе управления версиями, такие функции по мере их появления на платформе будут вам недоступны. Вы можете перейти с внешней системы управления версиями на встроенную систему рабочего пространства — порядок перехода описан в следующем разделе.

Работа с GitHub

Использование платформы GitHub в качестве внешней системы контроля версий (VCS) — популярный способ хранения проектов и предоставления к ним общего доступа. Altium Designer поддерживает репозитории Git. Как описано выше для рабочего пространства Altium 365, существующую внешнюю систему VCS можно синхронизировать с рабочим пространством (создать в нем зеркало), чтобы воспользоваться его расширенными возможностями управления данными и совместной работы.

Обычный порядок работы с самим GitHub зависит от принятых в компании практик или просто от доступных вам инструментов Git. Однако, как правило, проект создается в локальном репозитории Git, а затем отправляется (Push) в удаленный репозиторий GitHub, либо существующий проект клонируется (Clone) из GitHub в локальный репозиторий. После этого проект можно открыть в Altium Designer для редактирования — программа распознает и будет использовать локальный и удаленный репозитории GitHub.

Если для проекта на базе Git создано зеркало в рабочем пространстве Altium 365 (Make Project Available Online), управлять проектом и работать с ним в Altium Designer можно так же, как с любым другим проектом, хранящимся в рабочем пространстве. При такой организации работы рабочее пространство по-прежнему предоставляет все преимущества своей системы управления проектами и незаметно для пользователя взаимодействует с GitHub для выполнения основных операций VCS — commit, push, pull и т. д. Altium Designer запросит ваши учетные данные GitHub и сохранит их для последующего взаимодействия с GitHub.

Обратите внимание: Altium Designer не может автоматически подключиться к GitHub, если для учетной записи GitHub настроена двухфакторная аутентификация.

Протоколы GitHub

Хотя система контроля версий Git предлагает ряд протоколов передачи данных, Altium Designer в настоящее время поддерживает только протокол HTTP/HTTPS для соединений между локальным репозиторием Git и его удаленным основным репозиторием. На практике используемый протокол определяется префиксом URL-адреса, указанного для подключения к удаленному репозиторию: https://<remote repository>, ssh://<remote repository>, git://<remote repository> и т. д.

GitHub поддерживает протоколы SSH и HTTPS и рекомендует использовать для подключений URL-адреса HTTPS.

► Дополнительные сведения см. в разделе Какой удаленный URL-адрес следует использовать? на GitHub.

Преимущество протокола HTTPS — защищенное соединение, которое легко использовать и настроить. Работа с SSH сложнее из-за необходимости использовать открытые ключи и соблюдать требования к портам межсетевого экрана/прокси-сервера. Кроме того, SSH, возможно, менее безопасен и не предоставляет удобства аутентификации SSO (единого входа).

Аналогичным образом протокол подключения GIT не рекомендуется (и здесь не поддерживается) из-за отсутствия аутентификации и сложности настройки.

Если ваша внешняя система VCS использует протокол, отличный от HTTPS, например подключение SSH к GitHub, этот протокол будет задан в репозитории, клонированном из удаленного репозитория. Поскольку этот протокол несовместим с Altium Designer, при попытке интегрировать проект с рабочим пространством Altium возникнет ошибка. Для подключения SSH вам будет предложено попробовать изменить настройки этого репозитория так, чтобы вместо него использовался поддерживаемый протокол HTTPS (при условии, что сам репозиторий поддерживает этот протокол). Если вы не уверены, какой протокол удаленного URL-адреса используется для локального репозитория Git, это можно проверить с помощью команды git remote – v.

Используйте интерфейс командной строки Git Bash, чтобы проверить настройку удаленного URL-адреса репозитория. Используйте интерфейс командной строки Git Bash, чтобы проверить настройку удаленного URL-адреса репозитория.

Репозиторий можно перенастроить на другой URL-адрес, например с протоколом HTTPS для обеспечения совместимости с Altium Designer, с помощью команды git remote set-url <name> <URL>, где префикс URL-адреса определяет тип протокола.

Изменение протокола URL-адреса подключения к удаленному репозиторию и последующая проверка командой remote.Изменение протокола URL-адреса подключения к удаленному репозиторию и последующая проверка командой remote.

Переход с внешней VCS на встроенную VCS рабочего пространства

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

Функция переноса проекта между системами VCS поддерживает внешние системы контроля версий Git и SVN и доступна при размещении локального файлового проекта в сети либо при переводе зеркального проекта (только синхронизируемого) под управление собственной Git VCS рабочего пространства.

Чтобы перенести проект, хранящийся под управлением внешней системы контроля версий, щелкните правой кнопкой мыши имя проекта на панели Projects и выберите в контекстном меню пункт Make Project Available Online либо выберите Project » Make Available Online в главном меню. В открывшемся диалоговом окне Make Available Online установите флажок Migrate to Altium 365 Versioned Storage и подтвердите операцию (OK).

Включение параметра Migrate to Altium 365 Versioned Storage фактически приводит к замене внешнего репозитория VCS репозиторием Git рабочего пространства, преобразует проект в проект, хранящийся и управляемый в рабочем пространстве Altium 365, и по возможности переносит историю коммитов из внешней VCS. Обратите внимание: если флажок переноса не установлен, в рабочем пространстве создается зеркало проекта (режим простой синхронизации), а внешний репозиторий сохраняется в качестве его хранилища VCS.

Перенос VCS также доступен, когда Altium Designer подключен к рабочему пространству Enterprise Server. В этом случае параметр Migrate to Altium Versioned Storage доступен в диалоговом окне Make Available On Server. Обратите внимание: если флажок переноса не установлен, внешний репозиторий проекта сохраняется в качестве его хранилища VCS (режим Simple Sync не поддерживается для рабочего пространства Enterprise Server).

Чтобы преобразовать локальный проект под контролем версий в полностью управляемый проект VCS в рабочем пространстве Altium 365, установите флажок переноса VCS при размещении проекта в сети.Чтобы преобразовать локальный проект под контролем версий в полностью управляемый проект VCS в рабочем пространстве Altium 365, установите флажок переноса VCS при размещении проекта в сети.

Откроется диалоговое окно Migrate Project с предупреждением о том, что проект будет полностью передан под управление VCS рабочего пространства. Нажмите кнопку Browse, чтобы выбрать папку на жестком диске, в которой будет создан новый локальный репозиторий проекта на базе Git. Нажмите кнопку Migrate, чтобы продолжить перенос.

Диалоговое окно Migrate Project
Диалоговое окно Migrate Project

После выполнения указаний, включая создание заключительного коммита VCS, проект будет находиться под контролем версий в репозитории Git рабочего пространства. История коммитов внешней VCS и соответствующие комментарии/сообщения переносятся в новый проект VCS рабочего пространства. Их можно просмотреть в Altium Designer в представлении History: щелкните правой кнопкой мыши имя проекта на панели Projects и выберите команду History & Version Control » Show Project History.

При переносе история коммитов внешней VCS проекта (показана слева) переносится в представление History Altium Designer (справа).При переносе история коммитов внешней VCS проекта (показана слева) переносится в представление History Altium Designer (справа).

Обратите внимание: при первом открытии истории проекта после переноса может отображаться сообщение о вычислении данных для всех включенных коммитов. Рабочему пространству требуется некоторое время для обработки этих коммитов, а также различий между ними.

Если проект из внешней системы контроля версий (VCS) уже управляется в рабочем пространстве Altium 365 как зеркальный проект (с синхронизацией локальных файлов и файлов на сервере), его файлы VCS можно перенести во встроенный Git-репозиторий сервера с помощью команды Migrate to Altium Versioned Storage, доступной в представлении Project History, диалоговом окне Project Options или в контекстном меню панели Projects History & Version Control, открываемом правой кнопкой мыши. 

Проект VCS, синхронизированный с рабочим пространством (зеркально отображённый в нём), переносится с помощью параметра Migrate Project to Altium Version Control.Проект VCS, синхронизированный с рабочим пространством (зеркально отображённый в нём), переносится с помощью параметра Migrate Project to Altium Version Control.

Перенос выполняется быстрее всего, если исходная внешняя VCS основана на Git: процесс проще, поскольку VCS рабочего пространства Altium 365 также основана на Git. В случае SVN перенос может занять некоторое время в зависимости от размера репозитория и количества коммитов в нём.

VCS Migration limitations

  • Git
    • При подключении к рабочему пространству Altium 365 поддерживаются Git-репозитории, содержащие несколько проектов печатных плат. После нажатия OK в диалоговом окне Make Available Online вам будет предложено выбрать файлы для переноса.
    • Файл проекта (*.PrjPcb) должен находиться в корневой папке Git-репозитория.
  • SVN
    • Базовый протокол SVN File не поддерживается.
    • Если ваш SVN-репозиторий содержит несколько проектов, в процессе переноса будут созданы новые локальные папки в дополнение к существующей рабочей копии SVN. Это связано с тем, что хранилище рабочего пространства Altium 365 основано на Git, а Git-репозиторий нельзя хранить внутри рабочей копии SVN.
    • Коммиты, включающие файл за пределами папки проекта, могут не отображаться, поскольку при переносе распознаются только коммиты в папку проекта.
После успешного переноса проекта из внешней VCS в рабочее пространство Altium 365 связь с внешним репозиторием удаляется автоматически. Эта функция реализована в Altium Designer 23.0. Если проект был размещён в рабочем пространстве Altium 365 с помощью более ранней версии Altium Designer, запись о репозитории может отображаться на странице Data Management - Design Repositories диалогового окна Preferences. Если вы являетесь администратором рабочего пространства и репозиторий не связан ни с одним проектом рабочего пространства, его можно удалить из рабочего пространства, выбрав соответствующую запись и нажав кнопку Remove. Обратите внимание: если проект был удалён с возможностью восстановления (перемещён в корзину), его необходимо удалить окончательно, чтобы можно было удалить связанный с ним репозиторий. Репозиторий Versioned Storage рабочего пространства удалить нельзя.

Совместная работа после переноса

  • После того как участник команды рабочего пространства перенёс проект в Altium Versioned Storage, ему необходимо убедиться, что остальные участники проекта подключились к рабочему пространству команды, а затем обновили свои локальные (рабочие) копии проекта. Необходимость обновления обозначается на панели Projects значком (Out of Date — устарело) рядом с файлом проекта, а само обновление выполняется командой Project » History & Version Control » Update Whole Project.
  • После обновления перенесённого проекта Altium Designer предложит обновить ссылки на новый репозиторий, заново создав локальную рабочую папку проекта. Выберите рекомендуемый вариант в диалоговом окне Fix version control link, чтобы завершить обновление локального проекта.

  • Обратите внимание: если участник проекта not подключится к рабочему пространству команды, а затем выполнит коммит изменений проекта в VCS, эти изменения по-прежнему будут регистрироваться во внешнем репозитории и, следовательно, не будут синхронизированы с перенесённым проектом VCS рабочего пространства.
  • Во время переноса Altium Designer выполняет коммит в исходный репозиторий, чтобы установить уведомляющую отметку, по которой экземпляры Altium Designer других участников команды смогут определить, что проект был перенесён.

Переход с SVN на Git в рабочем пространстве

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

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

Если Altium Designer подключен к рабочему пространству Enterprise Server, а проект хранится в репозитории SVN, управляемом через службу контроля версий рабочего пространства, этот проект можно перенести из репозитория SVN во встроенный репозиторий Git рабочего пространства (Versioned Storage). Для этого щелкните правой кнопкой мыши запись проекта на панели Projects и выберите команду History & Version Control » Migrate Project to Altium Versioned Storage в контекстном меню. Также можно нажать кнопку Migrate to Server Versioned Storage в диалоговом окне Project Options.

После выполнения указаний, включая заключительную фиксацию изменений в VCS, проект будет перенесен под управление системы контроля версий репозитория Git рабочего пространства.

Управление синхронизацией проекта

После того как локальный проект станет доступен в рабочем пространстве, управлять его доступностью в Интернете и синхронизацией можно на вкладке «Общие» диалогового окна Project Options.

Параметры и элементы управления, связанные с доступностью проекта в Интернете, представлены на вкладке General  диалогового окна Project Options.
Параметры и элементы управления, связанные с доступностью проекта в Интернете, представлены на вкладке General диалогового окна Project Options.

Используйте параметр в области General этой вкладки, чтобы изменить описание проекта. Это изменение затрагивает только проект в рабочем пространстве.

В области Online Availability and Synchronization этой вкладки параметр Version Control отражает текущий способ предоставления доступа к проекту в Интернете:

  • Option Enabled — проект и его исходные файлы хранятся под управлением собственной системы контроля версий (Git) рабочего пространства. Этот подход рекомендуется, поскольку он предоставляет доступ ко всем функциональным возможностям рабочего пространства и платформы Altium 365.

  • Option Disabled — файлы проекта хранятся в рабочем пространстве для базового доступа и предоставления другим пользователям возможности только просматривать и комментировать их — вариант Simple Sync (только для рабочего пространства Altium 365).

Используйте этот параметр для переключения между двумя вариантами.

Этот параметр недоступен, если проект хранится во внешнем репозитории VCS.

Чтобы прекратить синхронизацию между локальным проектом и его экземпляром, доступным в рабочем пространстве, нажмите кнопку . Откроется окно Turn off project synchronization. Выберите вариант Unlink , затем нажмите OK в диалоговом окне Project Options. Локальный проект больше не будет связан с проектом в рабочем пространстве.

После сохранения локального проекта это изменение отразится на панели Projects: проект будет отображаться в активной группе проектов (*.DsnWrk), а не в активном рабочем пространстве. Сохранение необходимо, поскольку ссылки на проект в рабочем пространстве удаляются из файла проекта.

Проект в рабочем пространстве остается без изменений — это действие не удаляет его.

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

В любой момент можно снова сделать локальный проект доступным в Интернете — как зеркальную копию или как полноценный проект под управлением VCS (Version Control). При подключении к рабочему пространству Altium 365 на вкладке General диалогового окна Project Options отображается кнопка , которая открывает диалоговое окно Make Available Online.

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

Локальный проект также можно сделать доступным в Интернете — в рабочем пространстве — на вкладке General  диалогового окна Project Options.Локальный проект также можно сделать доступным в Интернете — в рабочем пространстве — на вкладке General диалогового окна Project Options.

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

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

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

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

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

Contents