# Архив

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

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

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

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

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

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

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

Операционная система | Пользовательская папка Аксиомы
Windows | `%APPDATA%\ESTI\Axioma.GIS`
Linux | `$HOME/.local/share/ESTI/Axioma.GIS/`
macOS | `$HOME/Library/Application Support/ESTI/Axioma.GIS/`