# VS Code Windows

Инструкция написана для версии VS Code 1.86.2.

## Установка расширений.

После запуска VS Code, нужно установить расширение для работы с python. Для этого нужно выбрать из левого бокового меню, вкладку «Extensions» (Ctrl+Shift+X), набрать в поиске «Python» и установить расширение.

## Создание проекта.

Далее, нужно создать папку проекта, например: `C:\Users\User\VSCodeProjects\pythonProject`.

В меню «File», пункт «Open folder…» (Ctrl+O). Нужно выбрать ранее созданную папку.

## Создание виртуального окружения.

Сначала нужно открыть менеджер команд (Ctrl+Shift+P) «Command Palette».
Затем нужно выбрать команду `Python: Create Environment...` и выбрать вариант `Venv`. Далее, нужно ввести путь к питону Аксиомы
в поле `Enter interpreter path...`: `C:\Program Files\Axioma v5\bin\python\python.exe`. Дождаться когда VS Code создаст виртуальное окружение.

## Запуск кода.

Чтобы проверить работу VS Code с axipy, нужно создать файл main.py в папке проекта и выполнить следующий код:

    from axipy import init_axioma, mainwindow

    app = init_axioma()
    mainwindow.show()
    app.exec_()

В процессе ввода кода VS Code будет отображать подсказки.

## Разработка плагинов (модулей) для Аксиомы.

В папке `C:\Program Files\Axioma v5\bin\python_plugins` находятся встроенные модули Аксиомы. Их можно использовать как пример при написании плагинов.

Чтобы начать разработку плагина, можно скопировать минимальный пример модуля ru_axioma_gis_axipy_example_plugin_minimal в папку проекта.

    pythonProject  # папка с проектом
    ├── ru_axioma_gis_axipy_example_plugin_minimal  # модуль
    │   ├── __init__.py  # Точка входа модуля
    │   └── manifest.ini # Описание модуля

Далее, нужно переименовать папку с модулем, например example_plugin_minimal (Название папки является уникальным идентификатором плагина). В файле manifest.ini нужно изменить отображаемое имя, чтобы найти плагин в списке модулей Аксиомы, например: name=Минимальный пользовательский плагин

Затем, нужно запустить Аксиому и добавить папку проекта в Дополнительные пути загрузки модулей. (Вкладка Основные | Настройки | Модули | Дополнительные модули | Настройки) Далее, нужно включить плагин в списке установленных плагинов. Теперь, при каждом запуске Аксиомы, плагин будет автоматически загружаться.

Подробнее о разработке плагинов можно прочитать в разделе Разработка Плагинов (Модулей).