add-dependency

name	add-dependency
description	Добавить внешнюю библиотеку в проект. Используй при подключении нового пакета из hub.oscript.io - обновление packagedef, установка, регистрация в lib.config.

Шаги добавления зависимости

1. Найди актуальную версию

Открой страницу пакета на hub.oscript.io и найди последнюю версию.

2. Добавь в packagedef

Открой файл packagedef в корне проекта и добавь строку:

// Runtime-зависимость
.ЗависитОт("имя-пакета", "версия")

// Dev-зависимость (только для тестов)
.РазработкаЗависитОт("имя-пакета", "версия")

Пример:

.ЗависитОт("compressor", "1.1.0")
.РазработкаЗависитОт("moskito", "0.5.0")

3. Установи зависимости

opm install -l --dev

Команда может занять 1+ минуту. Не прерывай.

4. Подключи в исходном коде

В начале .os-файла, где используется библиотека:

#Использовать имя-пакета

5. Если библиотека предоставляет классы для регистрации

Если ты создаёшь СВОЙ класс или модуль (не используешь чужой), зарегистрируй в lib.config:

<class name="ОтелНовыйКласс" file="src/Домен/Классы/ОтелНовыйКласс.os"/>
<module name="ОтелНовыйМодуль" file="src/Домен/Модули/ОтелНовыйМодуль.os"/>

lib.config - источник истины для регистрации классов и модулей проекта. packagedef содержит только метаданные пакета и зависимости.

Важно

• Указывай конкретную версию, не диапазон.
• packagedef - это НЕ место для .ОпределяетКласс() / .ОпределяетМодуль(). Классы и модули регистрируются в lib.config.
• После добавления зависимости прогони тесты, чтобы убедиться, что всё работает.

Текущие зависимости

Актуальный список - в файле packagedef в корне репозитория.