Alpha.Community

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

Обновление проекта без перезапуска

Во время исполнения проекта в Визуализаторе Alpha.HMI можно редактировать проект в Дизайнере Alpha.HMI и загружать изменения без остановки визуализатора. Для этого используется компонент Менеджер проекта.

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

Для работы компонента Менеджер проекта подготовьте две папки:

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

Проверка наличия обновлений

Используйте функцию CheckForUpdates, чтобы проверить, помещён ли в папку обновлений файл проекта.

Чтобы настроить проверку наличия обновлений по нажатию кнопки:

  1. Добавьте на форму компонент Менеджер проекта.
  2. Добавьте на форму кнопку. В свойстве Текст кнопки укажите Проверить обновления.
  3. Добавьте компонент Текст для отображения результата проверки.

  4. В коде обработчика ButtonPressed вызовите функцию CheckForUpdates. В параметрах функции укажите путь к файлу проекта в папке обновлений:

    Text_1.Text = ProjectManager_1.CheckForUpdates("C:\\WORK\\HMI\\PROJECT_update\\PROJECT.hmi") ? "Доступны обновления" : "Обновлений нет";

Чтобы настроить автоматическую проверку наличия обновлений по таймеру:

  1. Добавьте на форму компонент Таймер.
  2. В свойстве Период компонента Таймер укажите интервал проверки обновлений в миллисекундах. Например, для проверки каждые 5 минут укажите:

    Timer_1.Period = 300000; // 5 минут = 300000 миллисекунд
  3. В свойстве Активность компонента Таймер установите значение true, чтобы запустить таймер.
  4. В коде обработчика OnTimer компонента Таймер вызовите функцию CheckForUpdates. В параметрах функции укажите путь к файлу проекта в папке обновлений:

    Text_1.Text = ProjectManager_1.CheckForUpdates("C:\\WORK\\HMI\\PROJECT_update\\PROJECT.hmi") ? "Доступны обновления" : "Обновлений нет";

Загрузка обновлений в запущенный проект

Используйте функцию AsyncReload, чтобы загружать обновлённые файлы проекта в рантайм без остановки визуализатора.

Чтобы настроить загрузку обновлений по нажатию кнопки:

  1. Добавьте на форму кнопку. В свойстве Текст кнопки укажите Обновить проект.

  2. В коде обработчика ButtonPressed вызовите функцию AsyncReload. В параметрах функции укажите путь к файлу проекта в папке обновлений и путь к папке автосохранения копий:

    ProjectManager_1.AsyncReload("C:\\WORK\\HMI\\PROJECT_update\\PROJECT.hmi", "C:\\WORK\\HMI\\PROJECT_backup");
  3. Запустите проект с помощью Визуализатора Alpha.HMI. Для этого в контекстном меню файла с расширением .hmi выполните команду Запустить.
  4. Откройте проект в Дизайнере Alpha.HMI и внесите необходимые изменения.
  5. Сохраните изменения и скопируйте все файлы проекта в папку обновлений.

  6. В запущенном проекте нажмите кнопку Обновить проект. Проект автоматически перезагрузится с новыми изменениями.

Создание резервной копии проекта

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

Чтобы настроить создание резервной копии по нажатию кнопки:

  1. Добавьте на форму кнопку. В свойстве Текст кнопки укажите Создать резервную копию.
  2. В коде обработчика ButtonPressed вызовите функцию AsyncBackup. В параметрах функции укажите путь к папке для сохранения резервных копий:

    ProjectManager_1.AsyncBackup("C:\\WORK\\HMI\\PROJECT_backup");

Чтобы настроить создание резервной копии по таймеру:

  1. Добавьте на форму компонент Таймер.
  2. В свойстве Период компонента Таймер укажите интервал создания резервных копий в миллисекундах. Например, для создания копии каждый час укажите:

    Timer_1.Period = 3600000; // 1 час = 3600000 миллисекунд
  3. В свойстве Активность компонента Таймер установите значение true, чтобы запустить таймер.
  4. В коде обработчика OnTimer компонента Таймер вызовите функцию AsyncBackup. В параметрах функции укажите путь к папке для сохранения резервных копий:

    ProjectManager_1.AsyncBackup("C:\\WORK\\HMI\\PROJECT_backup");

Резервная копия проекта сохраняется в указанную папку. При каждом новом сохранении предыдущая копия проекта в этой папке перезаписывается.

Откат изменений

Используйте функцию AsyncReloadFromBackup, чтобы вернуть проект к предыдущей версии из резервной копии.

Чтобы настроить откат изменений по нажатию кнопки:

  1. Добавьте на форму кнопку. В свойстве Текст кнопки укажите Откатить изменения.
  2. В коде обработчика ButtonPressed вызовите функцию AsyncReloadFromBackup. В параметрах функции укажите путь к папке с резервными копиями проекта:

    ProjectManager_1.AsyncReloadFromBackup("C:\\WORK\\HMI\\PROJECT_backup");

Функция загружает резервную копию из указанной папки и перезапускает проект. Проект вернётся к состоянию на момент создания этой резервной копии.