Архив

Физически модуль представлен в виде папки с уникальным именем, внутри которой расположены файлы и папки с бизнес-логикой, конфигурациями, документацией, зависимостями, графическими формами и прочим. Для гарантии целостности и удобства распространения готовые модули помещаются в архив.

Архив использует формат ZIP и имеет следующую структуру:

my_plugin_archive_v1.axp
└── ru_axioma_gis_axipy_example_plugin_from_package
    ├── __init__.py
    └── manifest.ini

Таким образом архив просто содержит папку с модулем. Имя архива может быть любым и должно заканчиваться на .axp, в то время как имя папки с модулем должно быть уникальным.

Для создания архива достаточно запаковать модуль в ZIP любым поддерживаемым архиватором и указать расширение выходного файла как .axp вместо стандартного .zip.

С помощью архиватора можно проверить целостность архива, например:

zip -Tv my_plugin_archive_v1.axp

Результат проверки:

Archive:  my_plugin_archive_v1.axp
    testing: ru_axioma_gis_axipy_example_plugin_from_package/   OK
    testing: ru_axioma_gis_axipy_example_plugin_from_package/__init__.py   OK
    testing: ru_axioma_gis_axipy_example_plugin_from_package/manifest.ini   OK
No errors detected in compressed data of my_plugin_archive_v1.axp
test of my_plugin_archive_v1.axp OK

Архив с модулем распаковывается в пользовательскую директорию при установке. Архив может быть установлен пользователем через интерфейс программы ГИС «Аксиома» в диалоге «Модули». Все модули, установленные пользователем, могут быть удалены из того же диалога.

Физически модули устанавливаются в installed_modules в пользовательскую папку. Расположение пользовательской папки зависит от операционной системы:

• для Windows – «%APPDATA%ESTIAxioma.GIS»

• для Linux – «$HOME/.local/share/ESTI/Axioma.GIS/»

• для macOS – «$HOME/Library/Application Support/ESTI/Axioma.GIS/»