Visão geral da localização de metadados

Alguns metadados definidos dentro de objetos de configuração oferecem suporte à localização. As propriedades que oferecem suporte à localização são adornadas e LocalizableStringAttribute o compilador emite um aviso se essas propriedades forem definidas como um valor não localizável. Esses valores podem ser localizados incluindo arquivos string-resources.json com sua extensão e cercando a chave de recurso de cadeia de caracteres com % caracteres.

A Command com um localizado DisplayName e ToolTipText tem a seguinte aparência:

public override CommandConfiguration CommandConfiguration => new("%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName%")
{
    ToolTipText = "%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText%"
}

string-resources.json

Sua extensão deve fornecer um arquivo string-resources.json para cada idioma que sua extensão suporta. Esse arquivo JSON é um dicionário de pares chave/valor em que a chave é um identificador exclusivo global (todo do Visual Studio) para um recurso de cadeia de caracteres e o valor é o recurso de cadeia de caracteres localizada. Esses arquivos JSON devem ser implantados com sua extensão sob o .vsextension diretório, com cada idioma que você suporta sendo enviado em uma pasta correspondente ao nome da localidade, ou seja, "de" para alemão, "it" para italiano, etc. O string-resources.json implantado na raiz do .vsextension diretório é usado como padrão se sua extensão não oferece suporte ao idioma que o Visual Studio está definido no momento. Um exemplo de como seria essa estrutura de diretórios pode ser visto aqui:

string-resources.json exemplo:

{
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName": "Sample Remote Command Display Name",
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText": "Sample Remote Command ToolTip"
}

Próximas etapas

Saiba mais sobre os comandos VisualStudio.Extensibility em Adicionar comandos do Visual Studio.