Управление версиями

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

Например, API-интерфейсы FormIt могут меняться от версии к версии. И хотя вы можете предпочитать, чтобы новая версия подключаемого модуля использовала новые API-интерфейсы FormIt или WSM, вам также может понадобиться, чтобы подключаемый модуль работал и в более старых клиентах.

Начиная с версии FormIt v18.0, управление версиями подключаемого модуля можно реализовать за 3 простые действия.

• Добавьте файл versions.json в корневую папку подключаемого модуля.

• Укажите каждую совместимую версию FormIt и каталог, содержащий файлы подключаемых модулей, в файле versions.json.

• Используйте внутренний номер версии FormIt или «номер сборки», который можно найти в разделе «Информация» > «О программе» FormIt.

Организация управления версиями для подключаемого модуля

Упорядочьте каталоги и файлы подключаемых модулей в соответствии с файлом versions.json.

Файл versions.json должен выглядеть следующим образом.

        [
            {
                "version":{
                    "major":18,
                    "minor":0
                },
                "path":"v18_0"
            },
            {
                "version":{
                    "major":19,
                    "minor":1
                },
                "path":"v19_0"
            }
        ]

Указанные выше пути v18_0 и v19_0 должны быть допустимыми вложенными путями из корневого каталога/хранилища.

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

• versions.json (файл)

• v18_0 (каталог)

  • manifest.json (файл)

  • plugin.html (файл)

  • plugin.js (файл)

• v19_0 (каталог)

  • manifest.json (файл)

  • plugin.html (файл)

  • plugin.js (файл)

Дополнительными свойствами версии являются exactVersion и lastVersion. Свойство exactVersion указывает, что версия должна точно соответствовать версии FormIt. Свойство lastVersion указывает последнюю версию, разрешенную для выполнения в FormIt. \

[
    {
      "version":{
        "major":18,
        "minor":0,
        "exactVersion":true
        },
        "path":"v18_0"
    },
    {
        "version":{
            "major":19,
            "minor":1,
            "lastVersion":true
       },
        "path":"v19_0"
    }
 ]

Для путей также можно использовать ветви/теги/фиксации GIT.

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

• Выполните описанные выше действия, за исключением использования файла versions_prerelease.json.

• Если вы зафиксировали файл versions_prerelease в хранилище, его необходимо удалить после выпуска этой предварительной версии FormIt.

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