Документация Engee

Пользовательские библиотеки Engee

Пользовательские библиотеки user library 1 — это файлы с расширением .nglib, которые могут содержать любые блоки Engee. Эти файлы позволяют использовать собственные блоки из библиотеки блоков Engee stateflow button library.

Создание собственных библиотек позволяет:

  • Хранить часто используемые блоки в удобном формате, чтобы значительно упростить и ускорить процесс моделирования;

  • Добавлять нужные элементы сразу из пользовательской библиотеки, вместо создания новых блоков для каждой модели.

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

Чтобы скачать файлы пользовательских библиотек других пользователей или загрузить свои — воспользуйтесь сайтом удаленного репозитория Engee. Подробнее о том как работать с удаленным репозиторием читайте в наших статьях по Git.
После добавления своих блоков в библиотеку Engee, вы не сможете их удалить, пока сессия активна. Чтобы убрать эти блоки, нужно полностью остановить сессию Engee и запустить ее заново. Это очистит все пользовательские библиотеки, и если они понадобятся, их придется загрузить повторно.

Для работы с пользовательскими библиотеками:

  1. Создайте файл библиотеки .nglib в окне Файлы file browser icon и задайте желаемое имя:

    user lib create

  2. Создайте нужный блок или подсистему в модели Engee. Подсистема позволяет сохранить внутри себя множество блоков одновременно. Поэтому, чтобы добавить в библиотеку группу блоков, объедините их в подсистему.

    user lib custom blocks

  3. Сохраните файл .nglib в файловом браузере или навигационной панели:

    user lib 2

    Директория, в которой сохранен файл, не влияет на его расположение в библиотеке блоков.

  4. Чтобы блоки появились в окне библиотек Engee stateflow button library, переместите файл .nglib в папку и добавьте ее в путь с помощью редактора пути:

    path editor new

  5. Добавленные файлы будут помещены в раздел Пользовательские библиотеки, где имя файла .nglib станет именем соответствующего подраздела:

    user lib save 1 1

  6. К ранее созданной или загруженной пользовательской библиотеке можно также обратиться через поиск в рабочем пространстве:

    user lib 4

Многоуровневые библиотеки

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

image3

[metadata]
format_version = "1"

[[categories]]
lib_path = "/my-lib_upd"
files = ["foo/a.nglib", "foo/b.nglib"]

[[categories]]
lib_path = "/my-lib_upd/cat1"
files = ["c.nglib"]

[[categories]]
lib_path = "/my-lib_upd/cat1/cat2"
files = ["d.nglib"]

В этом примере:

  • format_version = "1" — версия формата файла.

  • lib_path — путь до раздела библиотеки, как он будет отображаться в окне библиотеки блоков Engee stateflow button library.

  • files — список .nglib файлов, которые будут загружены в этот раздел.

    Файлы можно свободно размещать в разных подкаталогах — главное, чтобы пути в files были указаны корректно.

Таким образом, вы можете:

  • Сгруппировать блоки по папкам и подкатегориям (например, cat1 и cat2);

  • Загружать несколько файлов в один раздел;

  • Четко структурировать большие библиотеки по тематике, типу блоков и т.д.

После создания engee_library.toml и размещения нужных .nglib файлов в указанных папках, добавьте корневую папку библиотеки в Путь через редактор пути, и ваша иерархия появится в окне библиотеке блоков.

Полезные ссылки

  1. Файловый браузер

  2. Импорт данных

  3. Первые шаги. Создание простой модели