Настройка окружения разработчика в MS Visual Studio Code¶
MS Visual Studio Code - кроссплатформенная среда разработки с бесплатной лицензией, которую можно использовать для разработки в Аксиоме.ГИС. Ее можно скачать с официального сайта: Visual Studio Code.
Перед началом в установленной MS Visual Studio Code необходимо установить расширение Python. Это можно сделать во вкладке Extensions (Ctrl+Shift+X).
Чтобы подключать необходимые для работы модули, не входящие в пакеты Аксиомы.ГИС, требуется создать виртуальное окружение. Для этого в командную строку терминала MS VSC (Ctrl+Shift+`) надо ввести команду «путь\до\python.exe\в\папках\Axioma.GIS» -m venv .venv –system-site-packages».
Например:
"C:\\Axioma.GIS\\bin\\python\\python.exe" -m venv .venv --system-site-packages
В вашей рабочей директории появится папка «.venv», а MS VSC предложит выбрать в качестве нового окружения только что созданное виртуальное (его так же можно выбрать через Ctrl+Shift+P -> Python: Select Interpreter).
Примечание
Установка пакетов выполняется командой в терминале «.venv\Scripts\python.exe» -m pip install package, например для модуля numpy:
".venv\\Scripts\\python.exe" -m pip install numpy
Создание виртуального окружения:
Выбор виртуального окружения:
В силу особенностей Аксиомы.ГИС для корректной работы всех ее пакетов, если вы используете ОС Windows, необходимо в рабочей директории создать файл для переменных среды «.env» и в нем написать строчку «PROJ_LIB=Путь\до\папки\Axioma.GIS\share\proj».
Например:
PROJ_LIB=C:\\Axioma.GIS\\share\\proj
Так же в файле «settings.json» из папки «.vscode» добавить параметр:
"python.envFile": "${workspaceFolder}/.env"
Если же вы используете Linux, то в «settings.json» нужно выполнить те же действия, а в файл «.env» необходимо написать следующие строки (при установке Аксиомы.ГИС в папку «/opt/Axioma.GIS»):
LD_LIBRARY_PATH=/opt/Axioma.GIS/bin:/opt/Axioma.GIS/bin/plugins:/opt/Axioma.GIS/python/lib AXIOMA_HOME=/opt/Axioma.GIS/sbin QT_PLUGIN_PATH=/opt/Axioma.GIS/bin/qtplugins AXIOMA_DATA=/opt/Axioma.GIS/share/axioma AXIOMA_PYTHON_HOME=/opt/Axioma.GIS/python AXIOMA_PYTHON_PLUGINS=/opt/Axioma.GIS/bin/python_plugins AXIOMA_PYTHON_BINDINGS=/opt/Axioma.GIS/python/lib/python3.5/site-packages AXIOMA_PLUGINS=/opt/Axioma.GIS/bin/plugins
Для Windows:
Для Linux:
Для обеих операционных систем:
Далее необходимо создать новую конфигурацию для отладки. Во вкладке Debug нужно выбрать функцию «Add configuration…», а в появившемся списке выбрать Python File.
В возникшем в папке .vscode файле «launch.json» требуется добавить параметр (если этого не произошло автоматически):
"pythonPath": "${config:python.pythonPath}"
Открытие вкладки Debug:
Редактирование файла «launch.json»:
Теперь вы можете использовать MS Visual Studio Code для разработки под Аксиомой.ГИС.