Alpha.Community

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

Совместная разработка проекта несколькими пользователями

Alpha.DevStudio предоставляет возможность совместной разработки одного проекта несколькими пользователями. Для этого можно использовать систему управления версиями SVN или Git. Использование системы управления версиями позволяет хранить разные состояния проекта. Так, в репозитории хранится одна версия проекта, а в локальной копии – другая.

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

SVN

Прежде чем перейти к внедрению SVN, можно ознакомиться с документацией для этой системы: https://svnbook.red-bean.com/.

Чтобы приступить к совместной разработке проекта, выполните описанные ниже шаги.

  1. Создайте репозиторий на SVN сервере для хранения файлов проекта.

    Можно использовать имеющийся или развернуть собственный SVN сервер. Для создания собственного сервера можно использовать, например, программу VisualSVN Server.

    Затем следует создать на SVN сервере репозиторий. Структура репозитория может быть любой. Для примера примем, что файлы проекта будут храниться в папке project репозитория test: https://test.local/svn/test/project.

    Также в репозитории необходимо создать папку для хранения внутренних идентификаторов объектов (сигналов, приложений и пр.) – sysevo. Для примера примем, что такая папка находится по адресу https://test.local/svn/test/sysevo.

  2. На каждом компьютере, где будет вестись разработка проекта, установите клиентское приложение SVN в зависимости от используемой ОС. Скачать такой клиент можно на сайте https://subversion.apache.org/packages.html. Убедиться, что SVN успешно установлен, можно, выполнив консольную команду:

    svn --version

    Если SVN успешно установлен, то появится сообщение с номером версии SVN, списком модулей доступа к репозиторию, и доступным кэшем.

  3. Разместите файлы проекта в предназначенной для этого папке репозитория.

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

Git

Прежде чем перейти к внедрению Git, можно ознакомиться с документацией для этой системы: https://git-scm.com/. При работе с Git в качестве удаленного репозитория можно использовать репозиторий GitHub.

Для начала разместите в локальной папке файлы для совместной разработки. Чтобы передать эти файлы в удаленный репозиторий с помощью Git:

  1. Перейдите в локальную папку, в которой хранятся файлы вашего проекта.

    На ОС Linux вызовите команду:

    cd /home/user/my_project

    На ОС Windows вызовите команду:

    cd C:/Users/user/my_project
  2. Инициализируйте этот репозиторий, вызвав команду:

    git init

    Если все прошло успешно, то появится сообщение о том, что создан новый пустой репозиторий Git, а в локальной папке будет создана папка .git.

    В папке .git содержатся файлы и объекты, необходимые для версионирования проекта. Подробнее об этих файлах можно прочитать в документации на Git.

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

    git add .

    Чтобы установить за этими файлами слежение, вызовите команду:

    git commit
  4. Подключите удаленный репозиторий, вызвав команду:

    git remote add origin https://github.com/user-name/MyRepository
  5. Cвяжите локальную ветку с удаленной веткой, а затем отправьте в удаленную ветку файлы, за которыми вы установили слежение. Это можно сделать, вызвав команду:

    git push -u origin master

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

В результате в удаленном репозитории появятся файлы вашего проекта из локальной папки.

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

Извлечение и работа с локальной копией проекта

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

  • Если вы используете SVN, то извлеките копию проекта из репозитория в локальную папку, выполнив команду:

    svn checkout https://test.local/svn/test/project
  • Если вы используете Git, то клонируйте проект в локальную папку, вызвав команду:

    git clone https://github.com/user-name/MyRepository

Затем в настройках локальной копии проекта необходимо указать параметры хранилища состояний. Под хранилищем состояний подразумевается папка для хранения внутренних идентификаторов объектов. Перейдите в меню Файл → Параметры... → Среда исполнения. Укажите в разделе Хранилище состояния следующее:

  • Тип хранилища: выберите Файловая система или Удаленный репозиторий в зависимости от того, где располагается репозиторий;
  • Репозиторий: адрес папки для хранения внутренних идентификаторов объектов. Если вы используете SVN, то укажите репозиторий, который вы создали в разделе SVN: https://test.local/svn/test/sysevo. Если вы используете Git, то можете указать либо репозиторий SVN, либо локальную папку, для которой настроен общий доступ;
  • учетные данные для доступа к репозиторию.

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

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

Теперь можно приступить к работе с проектом.

После того, как файлы проекта были извлечены из репозитория, в обозревателе решений появятся:

  • Команды в контекстном меню элементов файлов, папок проектов и решения:

    • Фиксировать – отправляет изменения файла в репозиторий (для SVN) или сохраняет изменения локально (для Git).
    • Обновить – подгружает изменения файла, отправленные в репозиторий из других локальных копий. Если вы используете Git, то зафиксируйте изменения перед тем, как обновить проект.
    • Отправить – отправляет зафиксированные изменения файла в удаленный репозиторий с помощью Git.
    • Убрать изменения – отменяет все локальные изменения файла.

  • Иконки, свидетельствующие о состоянии файлов, где:

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

Предположим, в качестве системы управления версиями используется SVN. Два пользователя работают над одним и тем же проектом, внося изменения в свои локальные копии. Первый пользователь создает новый файл в проекте. Сразу после создания рядом с новым файлом (и всеми родительским объектами) появится желтая иконка. Чтобы отправить новый файл в репозиторий, первому пользователю необходимо вызвать команду Фиксировать в контекстном меню файла. Откроется окно, где следует описать внесенное изменение.

Команду можно вызвать для любого родительского объекта файла. Тогда в репозиторий можно будет отправить изменения всех файлов, вложенных в выбранный объект.

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

Рекомендации по работе с локальными копиями проекта

Рекомендуется организовать структуру проекта так, чтобы разные пользователи могли работать с разными файлами. Разбиение проекта на файлы позволяет минимизировать возможные конфликты, возникающие при редактировании одних и тех же файлов разными пользователями. Например, можно описывать ПЛК в одном файле, сервер – в другом, и так далее. На рисунке ниже ПЛК описан в файле testplk.omx, а Alpha.Server – в файле testserver.omx. При открытии файла testserver.omx экземпляры элементов, добавленные в файл testplk.omx, становятся полупрозрачными, но также доступны для редактирования.