> > >
AMXX Pawn в Visual Studio Code

AMXX Pawn в Visual Studio Code 0.7.5

Нет прав для скачивания
Автор:
KliPPy
Требования:
Наличие Visual Studio Code.

Visual Studio Code(или VSC) — «лёгкий» редактор исходного кода. Включает в себя отладчик, инструменты работы с Git, подсветку синтаксиса, IntelliSense и средства рефакторинга. Имеет широкие возможности для кастомизации: пользовательские темы, сочетания клавиш, файлы конфигурации.
Рассматриваемое нами расширение для VSC поддерживает подсветку кода AMXXPawn, навигацию, компиляцию, поиск, несколько облегчает работу.
Находится в активной разработке, однако уже вполне работоспособно и приятно глазу.
На данный момент реализованы:

  • scr1.png
    scr3.png
    scr2.png
    scr4.png
  • text1.png
  • Если навести курсор на инклюд, вызвать контекстное меню нажатием правой кнопкой мыши и выбрать пункт "Перейти к определению", то откроется этот инклюд.
    text2.png
  • Позволяет видеть сигнатуры функций, переменных и констант при наведении курсора на соответствующий элемент.
    text3.png
  • text5.png
  • text4.png
  • Нажимаем комбинацию клавиш ctrl+shift+o, сверху в окне поиска видим все используемые функции и стоки.
    text6.png
  • Прямо в студии компилируем плагин и видим результат.
    text7.png

  • Скачать Visual Studio Code, установить, следуя инструкции инсталятора, запустить.
  • Перейти во вкладку "Расширения". В строке поиска ввести amxxpawn. Установить расширение от KliPPy.
installVSC1.png


  • Закрыть и снова открыть Visual Studio Code.
  • В левой панели снизу выбрать иконку "Настройки" в виде шестерёнки и пункт "Параметры".
InstallVSC2.png

  • В параметры запуска вставить код
Код:
{
        "amxxpawn.compiler.includePaths": [
            "${workspaceRoot}/include"
        ],
        "amxxpawn.compiler.executablePath": "${workspaceRoot}/amxxpc.exe"
    }
InstallVSC3.png
  • Это мы вставили просто параметры запуска, чтобы студия распознавала инклюды и экзешник, запускающий компиляцию. Но ведь ей ещё надо указать какую рабочую область используем. Пока что студия не понимает, где находится {workspaceRoot} из кода выше. Для этого откроем папку с компилятором, это будет наша рабочая папка. И укажем путь к ней. "Файл" --> "Открыть" --> открываем папку "scripting" вашего AMX Mod X. То есть ту папку, где лежит компилятор.
InstallVSC4.png

  • При переходе в левой панели на иконку "Проводник" видим результат.
InstallVSC5.png
Компиляция нашего amxx-плагина может осуществляться 2 способами - через задачи и напрямую. Ниже расписаны оба.
Всё просто. Открываем исходник, нажимаем комбинацию клавиш ctrl+shift+p и в окно поиска вставляем директиву.
Код:
AMXXPawn: Compile Plugin
Также директива находится сама при начале набора.
DopInstall1.png
  • На верхней панели выбираем "Задача" --> "Настроить задачу сборки по умолчанию" --> "Создать файл tasks.json из шаблона" --> "Others"
InstallVSC6.png

InstallVSC7.png

InstallVSC8.png

  • Вставляем в шаблон код. Как Вы догадываетесь, читатель, это и есть наша задача. Задача компиляции. {workspaceRoot} - не что иное как ранее открытая папка scripting.
Код:
{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "taskName": "Compile Plugin",
            "type": "process",
            "command": "${workspaceRoot}\\amxxpc.exe",
            "args": [
                "${file}",
                "-i${workspaceRoot}\\include",
                "-o${workspaceRoot}\\compiled\\${fileBasenameNoExtension}.amxx"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}
Обратите внимание на строчку
Код:
"-o${workspaceRoot}\\compiled\\${fileBasenameNoExtension}.amxx"
Задаётся выходной путь компиляции. Удобно при тестировании плагина, можно заливать сразу на локальный сервер.

InstallVSC9.png

  • Сохраняем задачу, закрываем.
  • "Задача" --> "Запустить задачу" --> "Compile Plugin"
InstallVSC10.png
Ряд настроек AMXXPawn для VSC располагаются в "Настройки" -->"Параметры". Наибольший интерес представляют те, которые лежат в подразделе AMXXPawn Configuration.
interesting.png

Давайте их рассмотрим по очереди.

// Минимальный интервал между обновлениями синтаксиса
"amxxpawn.language.reparseInterval": 1500,

// По щелчку на #include открывается ссылка на его web-API. У меня почему-то не заработало.
"amxxpawn.language.webApiLinks": false,


// Расположение компилятора. Мы его ранее прописывали в параметрах запуска как ${workspaceRoot}/amxxpc.exe
"amxxpawn.compiler.executablePath": "",


// Расположение инклюдов
"amxxpawn.compiler.includePaths": [],


// дополнительные опции, указываемые компилятору
"amxxpawn.compiler.options": [],


// Показывает дополнительную информацию, такую как команды, аргументы, выходные коды при компиляции
"amxxpawn.compiler.showInfoMessages": false,


// Вывод выходной информации от amxxpc в более читабельной форме
"amxxpawn.compiler.reformatOutput": true,


// Куда класть скомпилированные файлы .amxx:
// - 'source' (в ту же папку, где исходник)
// - 'path' (настраивается ниже в amxxpawn.compiler.outputPath)
"amxxpawn.compiler.outputType": "source",

// Путь, по которому мы кладём скомпилированные файлы. Полезен при разработке. Можно компилить плагин в студии и автоматом заливать на локальный сервер в папку plugins.
"amxxpawn.compiler.outputPath": "",
Опубликовал
Gudaus
Скачивания
18
Первый выпуск
Обновление
Оценка
5,00 звёзд 4 оценок

Другие ресурсы пользователя Gudaus

Последние рецензии

Давно использую. Мне данное расширение, показалось лучшим и наиболее удобным в совокупности с отличным редактором.
Установил, мельком пробежался по возможностям, написал небольшой плагин для теста. В целом очень даже хорошо всё, но компиляция жуть как неудобна или скорей не привычно просто. А так никаких нареканий 10/10
спасибо
Достойная статья для достойного редактора. Все удобно. Есть нюансы, конечно, небольшие... Крайне неудобный бинд на компиляцию, а так очень даже :)
> > >