Требования

Для работы с пакетами 1C требуется утилита OneScript и менеджер пакетов opm.

Windows

Cкачать c официального сайта https://oscript.io/downloads установщик и запустить его. Далее следуйте подсказкам по установке на экране.

Linux

Cкачать нужный пакет с официального сайта https://oscript.io/downloads и установить его.

sudo dpkg --install onescript-engine_1.9.1_all.deb

MacOS

Интерактивного установщика нет, но движок можно установить из командной строки:

  1. установить homebrew
  2. установить mono командой brew install mono
  3. скачать ovm
  4. выполнить команду mono ovm.exe install stable
  5. выполнить команду mono ovm.exe use stable
  6. перезапустить терминал

Донастройка Self-Contained варианта поставки (не требующего инсталляции dotnet):

chmod +x ./oscript
xattr -d com.apple.quarantine *.dylib oscript
codesign -s - ./oscript

Обновление

После установки OneScript, для корректной работы необходимо обновить менеджер пакетов:

opm update opm

Регистрация реестра GitFlic

Для добавления пакетов OneScript, необходимо получить транспортный токен Gitflic. С инструкцией по получению токена можно ознакомиться на странице.

В документации ниже встречается атрибут <домен_gitflic> На его место необходимо указать домен, в зависимости от версии:

  • для SaaS версии registry.gitflic.ru

  • для self-hosted localhost:8080

Домен и порт для self-hosted версии может отличаться.

Значение атрибута url зависит от уровня доступа:

Уровень URL
Проект /project/{ownerAlias}/{projectAlias}/package/-/opm/
Компания /company/{companyAlias}/package/-/opm/
Инстанс /package/-/opm/
Переменная в URL Описание
ownerAlias Псевдоним владельца проекта
projectAlias Псевдоним проекта
companyAlias Псевдоним компании

Настройка производится с помощью создания служебного файла opm.cfg. Данный файл настроек можно расположить по таким путям (список приведен в порядке убывания приоритета):

  • ./opm.cfg - текущий каталог запуска + /opm.cfg
  • каталог настроек пользователя
    • linux: ~/.opm.cfg, внимание файла должен называться с точкой .opm.cfg
    • windows: %USERPROFILE%\opm.cfg
  • системная настройка:
    • linux: /etc/opm.cfg
    • windows: c:\ProgramData\opm.cfg
  • OSCRIPT/lib/opm/opm.cfg - каталог установки opm, для совместимости.

Шаблон конфигурационного файла:

{
    "СервераПакетов": [
        {
            "Имя":"СерверУдаленногоХранилища",
            "Сервер": "<домен_gitflic>,
            "Порт": 8080,
            "Авторизация": "OAUTH_TOKEN <транспортный токен>",
            "ПутьНаСервере": "<выбранный url>",
            "РесурсПубликацииПакетов": "<выбранный url>"
        }
    ]
}

Скачивание и установка пакета

Для установки пакета выполните команду:

opm install <имя_пакета>

Публикация пакета

Для публикации пакета выполните команду:

opm push --channel stable <путь_к_файлу>
Навигация