Назад к руководствам

Как выбрать правильную версию CounterStrikeSharp.API для вашего плагина

Некоторые плагины фиксируют точную версию CounterStrikeSharp.API прямо в своём файле проекта, а не просто указывают версию .NET. В этом случае наш компилятор перед сборкой показывает окно с тремя кнопками, Текущая, Новее и Последняя, каждая нацелена на свою версию. Выбор не той кнопки, частая причина, по которой плагин компилируется без проблем, но не запускается, или ведёт себя странно после запуска.

Почему вы видите это окно

Автор плагина зафиксировал проект на конкретной версии CounterStrikeSharp.API во время написания, скорее всего потому, что именно на ней он его тестировал. Наш компилятор обнаруживает это и просит вас подтвердить, какую версию использовать на самом деле, вместо того чтобы молча выбрать одну за вас.

Текущая: версия, под которую был написан плагин

Текущая X.Y.Z (.NET 8.0)

Компилирует с точной версией, зафиксированной автором плагина, на той точной версии .NET, которую эта версия требует. Это то, что мы рекомендуем, особенно если вы не знакомы с кодом плагина и не можете легко определить, сломается ли он на более новом API. Это версия, на которой плагин действительно тестировался.

Новее: тот же .NET, более новый CounterStrikeSharp.API

Новее X.Y.Z (.NET 8.0)

Сохраняет ту же версию .NET, на которую нацелен плагин, но компилирует с самой новой версией CounterStrikeSharp.API, доступной для этой же версии .NET. Обычно работает нормально, обновления CounterStrikeSharp.API часто обратно совместимы, но не всегда.

Риск: если метод, от которого зависит плагин, изменился или был удалён между версиями, плагин может скомпилироваться без ошибок и всё равно не загрузиться, или вести себя неправильно после запуска на вашем сервере.

Последняя: самые новые доступные версии .NET и CounterStrikeSharp.API

Последняя X.Y.Z (.NET 10.0)

Полностью игнорирует то, на что изначально был нацелен плагин, и компилирует с самой новой версией .NET и самой новой версией CounterStrikeSharp.API, которая у нас есть, какой бы ни была текущая комбинация. Для старого плагина это обычно более крупный скачок, чем Новее, могут измениться и версия .NET, и сам API.

Риск: на практике этот вариант чаще всего приводит к ошибкам компиляции на старых плагинах, написанных под более старую версию CounterStrikeSharp.API, а не к рабочему плагину с незаметными багами. Выбирайте его только если точно знаете, что плагин обновлён для поддержки последней версии, или готовы сами исправлять ошибки компиляции.

Наша рекомендация

Выбирайте Текущая, если у вас нет конкретной причины поступить иначе. Она соответствует тому, под что плагин действительно был создан и протестирован, поэтому это вариант с наименьшей вероятностью скомпилироваться чисто, а затем сломаться так, что сложно диагностировать. Обращайтесь к Новее или Последняя только если вам конкретно нужна функция из более новой версии CounterStrikeSharp.API, и вы готовы тщательно протестировать плагин после этого, а не просто убедиться, что он скомпилировался.

Было ли это руководство полезным?

CounterStrikeSharp - Getting Started Guide - NuGet Package - GitHub - Политика cookie - IceGame Romania

Страница сформирована за 0.014 секунд

CounterStrikeSharp Web Compiler V1.0 - Сделано с от Barlap для сообщества.