Voltar aos guias

Como escolher a versão certa do CounterStrikeSharp.API para o seu plugin

Alguns plugins fixam uma versão exata do CounterStrikeSharp.API diretamente no seu ficheiro de projeto, em vez de apenas declarar uma versão de .NET. Quando isso acontece, o nosso compilador mostra um aviso com três botões antes de compilar, Atual, Mais recente e Última, cada um visando uma versão diferente. Escolher a errada é um motivo frequente pelo qual um plugin compila bem mas não arranca, ou comporta-se de forma estranha depois de arrancar.

Porque está a ver este aviso

O autor do plugin fixou o seu projeto numa versão específica do CounterStrikeSharp.API enquanto o escrevia, muito provavelmente porque é a versão contra a qual o testou. O nosso compilador deteta isto e pede-lhe para confirmar qual a versão a usar realmente, em vez de escolher uma silenciosamente.

Atual: a versão para a qual o plugin foi criado

Atual X.Y.Z (.NET 8.0)

Isto compila com a versão exata fixada pelo autor do plugin, na versão exata de .NET que essa versão requer. É isto que recomendamos, especialmente se não estiver familiarizado com o código do plugin e não conseguir dizer facilmente se ele falharia com uma API mais recente. É a versão contra a qual o plugin foi realmente testado.

Mais recente: mesmo .NET, CounterStrikeSharp.API mais recente

Mais recente X.Y.Z (.NET 8.0)

Isto mantém a mesma versão de .NET que o plugin visa, mas compila com a versão mais recente do CounterStrikeSharp.API disponível para essa mesma versão de .NET. Pode funcionar bem, as atualizações do CounterStrikeSharp.API são frequentemente retrocompatíveis, mas nem sempre.

Risco: se um método do qual o plugin depende mudou ou foi removido entre versões, o plugin pode compilar sem erros e mesmo assim não carregar, ou comportar-se incorretamente depois de estar a correr no seu servidor.

Última: as versões mais recentes de .NET e CounterStrikeSharp.API disponíveis

Última X.Y.Z (.NET 10.0)

Isto ignora completamente o que o plugin visava originalmente e compila com a versão mais recente de .NET e a versão mais recente do CounterStrikeSharp.API que temos, seja qual for essa combinação atualmente. Para um plugin mais antigo, isto costuma ser um salto maior do que Mais recente, tanto a versão de .NET como a própria API podem ter mudado.

Risco: na prática, esta opção produz mais frequentemente erros de compilação em plugins mais antigos escritos para uma versão anterior do CounterStrikeSharp.API, não um plugin funcional com bugs subtis. Escolha-a apenas se souber especificamente que o plugin foi atualizado para suportar a versão mais recente, ou estiver preparado para corrigir os erros de compilação você mesmo.

A nossa recomendação

Escolha Atual, a menos que tenha uma razão específica para não o fazer. Corresponde àquilo para que o plugin foi realmente construído e testado, portanto é a opção com menor probabilidade de compilar corretamente e depois falhar de formas difíceis de diagnosticar. Recorra a Mais recente ou Última apenas se precisar especificamente de uma funcionalidade de uma versão mais recente do CounterStrikeSharp.API, e estiver preparado para testar o plugin exaustivamente depois, não apenas confirmar que compilou.

Este tutorial foi útil?

CounterStrikeSharp - Getting Started Guide - NuGet Package - GitHub - Política de cookies - IceGame Romania

Página gerada em 0.014 segundos

CounterStrikeSharp Web Compiler V1.0 - Feito com por Barlap para a comunidade.