Сделать существующий проект доступным в рабочем пространстве
Краткий обзор
- Узнайте, как настроить сведения о проекте и выбрать для него папку в рабочем пространстве с помощью диалогового окна Make Available Online или Make Available On Server.
- Разберитесь в различиях между Simple Sync и встроенной системой контроля версий рабочего пространства, включая возможности просмотра, комментирования и многопользовательского редактирования.
- Изучите возможность переноса проекта из внешней системы контроля версий во встроенное хранилище рабочего пространства с контролем версий.
Рекомендуемый и наиболее эффективный способ работы с проектами — создание нового проекта непосредственно в подключенном рабочем пространстве. Если у вас уже есть проект, его можно перенести в рабочее пространство, предоставив к нему онлайн-доступ и включив полноценный контроль версий. В обоих случаях проект будет храниться и управляться встроенной системой контроля версий (VCS) рабочего пространства. Это обеспечивает доступ ко всем функциям работы с проектом в Altium Designer. Полное управление проектом с помощью VCS рабочего пространства — единственный способ предоставить нескольким пользователям совместный доступ к проекту для редактирования в Altium Designer (при условии, что они являются участниками рабочего пространства), а также использовать дополнительные возможности платформы, такие как отслеживание истории и расширенные функции предоставления доступа к проекту.
Чтобы сделать существующий проект (локальный или находящийся под управлением внешней системы контроля версий) доступным в рабочем пространстве — в виде зеркальной копии (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.

Предоставьте доступ к существующему локальному проекту через рабочее пространство, фактически «зарегистрировав» его в рабочем пространстве и создав его «зеркальную копию».
Параметры и элементы управления диалогового окна Make Available Online
-
Project Name — имя проекта в рабочем пространстве. По умолчанию используется имя исходного проекта.
-
Description — введите желаемое описание проекта.
-
Version Control — установите этот флажок, чтобы добавить локальный проект во встроенную VCS рабочего пространства (Git). Если флажок не установлен, файлы проекта будут просто храниться в рабочем пространстве, обеспечивая базовый доступ и возможность предоставлять другим пользователям доступ только для просмотра и комментирования — своего рода упрощенный вариант Simple Sync. Рекомендуется включить полноценный контроль версий, поскольку это обеспечит доступ к максимальному набору возможностей рабочего пространства и платформы Altium 365. Этот параметр доступен только в том случае, если проект в данный момент не находится под контролем версий.
-
Migrate to Altium 365 Versioned Storage — включите этот параметр, чтобы перенести проект из внешней VCS под полное управление VCS рабочего пространства. После этого проект сможет использовать возможности встроенной VCS рабочего пространства. Этот параметр доступен только в том случае, если проект в данный момент находится под управлением внешней VCS.
-
Advanced — нажмите, чтобы открыть дополнительный параметр.
-
Folder — это поле позволяет указать, где в структуре папок рабочего пространства следует создать папку переносимого проекта. Путь по умолчанию для новых проектов задается на странице Admin – Settings – Projects веб-интерфейса рабочего пространства (по умолчанию это
Projects\<ProjectName>). Нажмите
, чтобы открыть диалоговое окно Choose Folder, представляющее собой упрощенную версию панели Explorer, в котором при необходимости можно найти и выбрать другую папку на сервере.
-
Параметры и элементы управления диалогового окна Make Available On Server
- Project Name — имя проекта в рабочем пространстве. По умолчанию используется имя исходного проекта.
- Description — введите желаемое описание проекта.
- Migrate to Altium Versioned Storage — включите этот параметр, чтобы перенести проект из внешней VCS под полное управление VCS рабочего пространства. После этого проект сможет использовать возможности встроенной VCS рабочего пространства. Этот параметр доступен только в том случае, если проект в данный момент находится под управлением внешней VCS.
-
Advanced — нажмите, чтобы открыть дополнительные параметры.
-
Repository — в этом раскрывающемся списке (если он присутствует) отображаются все репозитории проектов, управляемые службой контроля версий рабочего пространства и предоставленные вам для использования. Выберите репозиторий для хранения нового проекта и его файлов — по умолчанию доступен один репозиторий на основе Git (
Versioned Storage).Дополнительное поле Repository Folder позволяет указать или выбрать другую целевую папку внутри самого репозитория. Нажмите
, чтобы открыть диалоговое окно Add to Version Control, в котором можно перейти к нужному расположению и создать необходимую структуру папок в репозитории.
-
Folder — это поле используется для указания места создания папки переносимого проекта в структуре папок рабочего пространства. Путь по умолчанию для новых проектов задается на странице Admin – Settings – Projects браузерного интерфейса рабочего пространства (по умолчанию это
Projects\<ProjectName>). Нажмите
, чтобы открыть диалоговое окно Choose Folder, представляющее собой сокращенную версию панели Explorer, в котором при необходимости можно найти и выбрать другую папку рабочего пространства.
-
Используйте диалоговое окно Make Available Online, чтобы изменить Name проекта и добавить Description. По умолчанию используется имя исходного проекта.
Установите флажок Version Control, чтобы добавить проект во встроенную систему управления версиями (VCS) рабочего пространства на основе Git. Если этот флажок снят (этот вариант доступен только для рабочего пространства Altium 365), файлы проекта будут просто храниться в рабочем пространстве для базового доступа и предоставления другим пользователям возможности только просматривать и комментировать их — в рамках механизма Simple Sync. Рекомендуется включить управление версиями, поскольку это позволит использовать максимум возможностей рабочего пространства и платформы Altium 365. Обратите внимание: зеркальное отображение проекта в рабочем пространстве (Simple Sync) доступно только при подключении к рабочему пространству Altium 365.
Нажмите ссылку Advanced в диалоговом окне, чтобы отобразить поле Folder. Это поле используется для указания места создания папки зеркальной копии проекта в структуре папок рабочего пространства. Путь по умолчанию для новых проектов задается на странице Admin – Settings – Projects браузерного интерфейса рабочего пространства (по умолчанию это Projects\<ProjectName>). При необходимости нажмите кнопку
, чтобы найти и выбрать другую папку рабочего пространства.
Задав необходимые параметры переноса проекта в диалоговом окне Make Available Online , нажмите OK. Если проект не находится под управлением внешней системы контроля версий и для него включен доступ через Интернет (в рабочем пространстве Altium 365 установлен флажок Version Control), проект и его файлы будут зафиксированы и отправлены в репозиторий проектов Versioned Storage рабочего пространства. После этого панель Projects отобразит состояние полной синхронизации между репозиторием проектов рабочего пространства и локальным репозиторием (рабочей копией), о чем будут свидетельствовать соответствующие значки
. Проект становится полноценным проектом рабочего пространства — он не просто «зарегистрирован» в нем, а действительно зафиксирован и находится под управлением системы контроля версий рабочего пространства. Все изменения проекта необходимо сохранять в репозитории рабочего пространства с помощью операций фиксации и отправки (commit/push).
Ограничения при использовании существующего внешнего репозитория системы контроля версий
Как уже отмечалось, ваши локальные проекты могут уже находиться под управлением существующей внешней системы контроля версий (Git, SVN, EPDM и т. д.). При использовании рабочего пространства Altium 365 можно продолжить работу по этой схеме и просто сделать проекты доступными в рабочем пространстве, зарегистрировав их в нем с помощью функции Make Project Available Online.
В этом режиме каждый раз, когда вы вносите изменения в проект и фиксируете их во внешнем репозитории VCS, данные проекта будут в фоновом режиме зеркально копироваться в рабочее пространство, а вся необходимая обработка будет выполняться как обычно: предварительный просмотр, определение мест использования и т. д. Однако следует учитывать некоторые ограничения:
- Создавать новый проект по-прежнему необходимо по прежней схеме, то есть вручную во внешней системе VCS. Затем проект регистрируется в рабочем пространстве и зеркально копируется в него с помощью функции Make Project Available Online.
-
Если в проект внесены изменения, но их фиксация и отправка (commit/push) выполняются внешними инструментами, а не средствами Altium Designer, эти изменения не отобразятся в зеркальной копии проекта в рабочем пространстве. Это будет исправлено при следующем открытии проекта в Altium Designer, который автоматически синхронизирует локальный проект с зеркальной версией в рабочем пространстве. Если изменения были внесены другим пользователем, повторно открытые файлы проекта будут иметь состояние
Out Of Date; исправить это можно с помощью команды управления версиями Update. - Для открытия проекта другим пользователем потребуется доступ к этому внешнему репозиторию VCS.
- Права доступа придется настраивать и поддерживать в двух местах: в рабочем пространстве и в основном источнике данных — внешнем репозитории VCS (Git, SVN и т. д.).
- Некоторые функции платформы Altium 365 работают только в том случае, если проект находится под управлением встроенной системы контроля версий рабочего пространства. Если вы продолжите использовать внешнюю систему контроля версий, такие функции не будут доступны вам по мере их появления на платформе. Вы можете перейти с внешней VCS на встроенную VCS рабочего пространства — порядок действий описан в следующем разделе.
Работа с GitHub
Использование платформы GitHub в качестве внешней системы контроля версий (VCS) — популярный способ размещения проектов и предоставления общего доступа к ним. Altium Designer поддерживает репозитории Git. Как описано выше для рабочего пространства Altium 365, существующую внешнюю VCS можно синхронизировать с рабочим пространством (создать в нем зеркальную копию), чтобы воспользоваться его расширенными возможностями управления данными и совместной работы.
Порядок работы с самим GitHub зависит от принятых в компании подходов или просто от доступных вам инструментов Git. Однако в общем случае проект создают в локальном репозитории Git, а затем отправляют (Push) в удаленный репозиторий GitHub либо клонируют (Clone) существующий проект из GitHub в локальный репозиторий. После размещения в локальном репозитории Git проект можно открыть в Altium Designer для редактирования — программа распознает локальный и удаленный репозитории GitHub и будет использовать их.
Если для проекта на базе Git создана зеркальная копия в рабочем пространстве Altium 365 (Make Project Available Online), им можно управлять и работать с ним в Altium Designer так же, как с любым другим проектом, хранящимся в рабочем пространстве. При таком подходе рабочее пространство по-прежнему предоставляет все преимущества своей системы управления проектами, а также прозрачно взаимодействует с GitHub для выполнения основных операций VCS: фиксации изменений (commit), отправки (push), получения изменений (pull) и т. д. 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.
Если ваша внешняя система VCS использует протокол, отличный от HTTPS, например подключение GitHub по SSH, этот протокол уже будет задан в репозитории, клонированном из удаленного репозитория. Поскольку такой протокол несовместим с Altium Designer, при попытке интегрировать проект с рабочим пространством Altium возникнет ошибка. В случае подключения по SSH вам будет предложено попробовать перенастроить этот репозиторий на использование поддерживаемого протокола HTTPS (при условии, что сам репозиторий поддерживает этот протокол). Если вы не знаете, какой протокол удаленного URL-адреса используется для локального репозитория Git, это можно проверить с помощью команды git remote – v.
Используйте интерфейс командной строки Git Bash, чтобы проверить настройку удаленного URL-адреса репозитория.
Репозиторий можно перенастроить на другой URL-адрес, например с протоколом HTTPS для обеспечения совместимости с Altium Designer, с помощью команды git remote set-url <name> <URL>, где префикс URL-адреса определяет тип протокола.
Изменение протокола URL-адреса подключения к удаленному репозиторию и последующая проверка с помощью команды remote.
Переход с внешней VCS на встроенную VCS рабочего пространства
При подключении к рабочему пространству Altium 365 программа Altium Designer также позволяет с сохранением данных migrate проекты, использующие внешнюю систему VCS, в полностью управляемые проекты рабочего пространства, файлы которых размещаются в его собственном репозитории Git. Преобразованный проект сохраняет прежнюю историю фиксаций VCS и может использовать встроенные возможности рабочего пространства, связанные с контролем версий, такие как расширенное предоставление общего доступа к проекту, единая аутентификация и хронология событий History.
Функция переноса проекта между 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 в полностью управляемый проект VCS в рабочем пространстве Altium 365, установите флажок переноса VCS при размещении проекта в сети.
Откроется диалоговое окно Migrate Project с предупреждением о том, что проект будет перенесен под полное управление VCS рабочего пространства. Нажмите кнопку Browse, чтобы выбрать папку на жестком диске, в которой будет создан новый локальный репозиторий проекта на базе Git. Нажмите кнопку Migrate, чтобы продолжить перенос.

Диалоговое окно Migrate Project
После выполнения указаний, включая окончательную фиксацию изменений в VCS, проект окажется под контролем версий в репозитории Git рабочего пространства. История фиксаций внешней VCS и соответствующие комментарии и сообщения переносятся в новый проект VCS рабочего пространства. Их можно просмотреть в представлении History Altium Designer: щелкните правой кнопкой мыши имя проекта на панели Projects и выберите команду History & Version Control » Show Project History.
При переносе история фиксаций внешней VCS проекта (показана слева) переносится в представление History Altium Designer (справа).
Если проект из внешней системы контроля версий (VCS) уже находится под управлением рабочего пространства Altium 365 как зеркальный проект (с синхронизацией локальных и серверных файлов), его файлы можно перенести во встроенный репозиторий Git сервера с помощью команды Migrate to Altium Versioned Storage, доступной в представлении Project History, диалоговом окне Project Options или контекстном меню панели Projects History & Version Control, вызываемом щелчком правой кнопки мыши.
Проект VCS, синхронизированный с рабочим пространством (зеркально отображаемый в нем), переносится с помощью параметра Migrate Project to Altium Version Control.
Совместная работа после переноса
-
После переноса проекта в 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 у других участников команды смогут распознать, что проект был перенесен.
Ручной перенос проекта из внешней VCS в VCS рабочего пространства
В некоторых случаях может потребоваться вручную перенести проект, использующий внешний репозиторий VCS, под полное управление рабочего пространства Altium и его встроенного репозитория Git. Для этого можно создать снимок проекта, отсоединив его от внешней VCS и рабочего пространства (если он уже был в нем размещен), а затем снова разместить его в рабочем пространстве, но уже под управлением VCS рабочего пространства — фактически начав с чистого листа. Для этого выполните следующие действия:
- Отсоедините (удалите) проект от внешней системы контроля версий. Это можно сделать с помощью внешнего клиента используемой VCS или через Altium Designer. В последнем случае, хотя команды удаления проекта из-под контроля версий доступны как на панели Projects, так и на панели Storage Manager, наиболее надежный способ — использовать Project Packager. Использование Project Packager позволит создать снимок проекта без данных системы контроля версий, а если проект ранее был размещен в рабочем пространстве — также удалить ссылки на проект в рабочем пространстве.
- Распакуйте «очищенный» проект из ZIP-архива, созданного с помощью Project Packager.
- Откройте проект в Altium Designer. Обратите внимание: он больше не находится ни под управлением рабочего пространства (если находился ранее), ни под контролем версий. Таким образом, это чистый неуправляемый проект.
-
Следующий шаг требуется только в том случае, если вы ранее размещали проект в рабочем пространстве. При упаковке связь проекта была удалена, но зеркальный проект в рабочем пространстве остался без изменений. Сначала следует удалить проект на сервере. Откройте браузерный интерфейс рабочего пространства (через интерфейс платформы Altium 365). На странице Projects щелкните проект, который нужно удалить, затем нажмите элемент управления
и выберите команду Delete в контекстном меню.
- Теперь снова разместите проект в рабочем пространстве для доступа через сеть. Для этого щелкните его запись на панели Projects правой кнопкой мыши и выберите Make Project Available Online в контекстном меню, чтобы открыть диалоговое окно Make Available Online. Обязательно включите параметр Enable Formal Version Control, поскольку именно он добавляет проект под управление встроенной VCS рабочего пространства (Git).
Переход с SVN на Git в рабочем пространстве
Если Altium Designer подключен к рабочему пространству Enterprise Server, а проект хранится в репозитории SVN, управляемом через службу Version Control Service рабочего пространства, этот проект можно перенести из репозитория 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 этой вкладки, чтобы изменить описание проекта. Это изменение затрагивает только проект в рабочем пространстве.
В области Online Availability and Synchronization этой вкладки параметр Version Control отражает текущий способ предоставления доступа через Интернет:
-
Option Enabled — проект и его исходные файлы хранятся под управлением встроенной VCS (Git) рабочего пространства. Это рекомендуемый подход, поскольку он обеспечивает доступ ко всем возможностям рабочего пространства и платформы Altium 365.
-
Option Disabled — файлы проекта хранятся в рабочем пространстве для базового доступа и предоставления другим пользователям возможности только просматривать и комментировать их — режим Simple Sync (только для рабочего пространства Altium 365).
При необходимости используйте этот параметр для переключения между двумя режимами.
Чтобы прекратить синхронизацию между локальным проектом и его экземпляром, доступным в рабочем пространстве, нажмите кнопку
. Откроется окно Turn off project synchronization. Выберите вариант Unlink , затем нажмите OK в диалоговом окне Project Options. Локальный проект больше не будет связан с проектом в рабочем пространстве.
После сохранения локального проекта это изменение отобразится на панели Проекты: проект будет показан в активной группе проектов (*.DsnWrk), а не в активном рабочем пространстве. Сохранение необходимо, поскольку из файла проекта удаляются ссылки на проект в рабочем пространстве.
Проект в рабочем пространстве остается без изменений — это действие не удаляет его.
Вы можете разорвать связь между локальным проектом и его экземпляром, доступным в рабочем пространстве.
Локальный проект всегда можно снова сделать доступным через Интернет — как зеркальную копию или как полноценный проект под управлением VCS (Version Control). При подключении к рабочему пространству Altium 365 на вкладке General диалогового окна Project Options отображается кнопка
, открывающая диалоговое окно Make Available Online.
Локальный проект также можно сделать доступным через Интернет — в рабочем пространстве — на вкладке General диалогового окна Project Options.



