Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las extensiones de extensibilidad de VisualStudio.Extensibility usan string-resources.json archivos para la localización. Este enfoque localiza los nombres para mostrar de comandos, la información sobre herramientas y otros metadatos de extensión que admiten la localización.
Note
El .vsixlangpack mecanismo usado por las extensiones VSSDK no es compatible con las extensiones de extensibilidad de VisualStudio.Extensibility. Utilice string-resources.json en su lugar.
Funcionamiento de la localización
Las propiedades que admiten la localización usan % delimitadores para hacer referencia a claves de recursos de cadena. El compilador emite una advertencia si estas propiedades se establecen en un valor no localizable. Para localizar una cadena, rodee la clave de recurso de cadena con caracteres %:
public override CommandConfiguration CommandConfiguration => new("%MyExtension.MyCommand.DisplayName%")
{
TooltipText = "%MyExtension.MyCommand.TooltipText%"
};
string-resources.json
Su extensión debe proporcionar un archivo string-resources.json para cada idioma que admita su extensión. Este archivo JSON es un diccionario de pares clave-valor donde la clave es un identificador único global para un recurso de cadena y el valor es la cadena localizada.
Predeterminado (inglés) — .vsextension/string-resources.json:
{
"MyExtension.MyCommand.DisplayName": "My Command",
"MyExtension.MyCommand.TooltipText": "Runs my command"
}
Alemán: .vsextension/de/string-resources.json:
{
"MyExtension.MyCommand.DisplayName": "Mein Befehl",
"MyExtension.MyCommand.TooltipText": "Führt meinen Befehl aus"
}
Estructura de directorios
Implemente los archivos string-resources.json en el directorio .vsextension. Coloque un archivo predeterminado en la raíz y los archivos específicos de cada configuración regional en subcarpetas denominadas por código de configuración regional:
.vsextension/
├── string-resources.json (default / fallback)
├── de/
│ └── string-resources.json (German)
├── es/
│ └── string-resources.json (Spanish)
├── fr/
│ └── string-resources.json (French)
└── ja/
└── string-resources.json (Japanese)
string-resources.json en la raíz de .vsextension se usa como reserva cuando Visual Studio se establece en un idioma para el que la extensión no proporciona un archivo localizado.
Localizar cadenas de interfaz de usuario en tiempo de ejecución
El string-resources.json enfoque anterior abarca los metadatos de extensión (nombres de comandos, información sobre herramientas) que Visual Studio carga automáticamente. Para las cadenas que se muestran en tiempo de ejecución en la interfaz de usuario de la extensión (como etiquetas de ventana de herramientas, texto de cuadro de diálogo o mensajes de estado), debe cargar las traducciones usted mismo.
Enfoque recomendado: archivos de recursos JSON insertados
- Cree archivos JSON para cada configuración regional en el proyecto (por ejemplo,
Strings/en.json,Strings/de.json):
// Strings/en.json
{
"ToolWindow.Title": "My Tool Window",
"Status.Loading": "Loading project data...",
"Error.NotFound": "The requested item was not found."
}
- Márcalos como recursos incrustados en tu
.csproj:
<ItemGroup>
<EmbeddedResource Include="Strings\*.json" />
</ItemGroup>
- Cargue el archivo correcto en tiempo de ejecución en función de la cultura actual:
using System.Globalization;
using System.Reflection;
using System.Text.Json;
public static class LocalizedStrings
{
private static readonly Dictionary<string, string> Strings = LoadStrings();
private static Dictionary<string, string> LoadStrings()
{
var culture = CultureInfo.CurrentUICulture.TwoLetterISOLanguageName;
var assembly = Assembly.GetExecutingAssembly();
// Try culture-specific, then fall back to English
var resourceName = $"MyExtension.Strings.{culture}.json";
var stream = assembly.GetManifestResourceStream(resourceName)
?? assembly.GetManifestResourceStream("MyExtension.Strings.en.json");
if (stream is null) return new();
using var reader = new StreamReader(stream);
return JsonSerializer.Deserialize<Dictionary<string, string>>(reader.ReadToEnd()) ?? new();
}
public static string Get(string key) =>
Strings.TryGetValue(key, out var value) ? value : key;
}
- Use el asistente en el código de la extensión:
// In a tool window, command handler, or dialog
var title = LocalizedStrings.Get("ToolWindow.Title");
Important
No mezcle la localización de metadatos (string-resources.json en .vsextension/) con la localización de cadenas en tiempo de ejecución. Sirven para diferentes propósitos:
-
.vsextension/string-resources.json: cargado por el host de VS para los nombres de comandos y la información sobre herramientas - Archivos de recursos incrustados , cargados por el código de extensión para las cadenas de interfaz de usuario
Tips
✅ HACER
- Mantenga las claves de cadena globalmente únicas y descriptivas.
- Proporcione siempre un archivo de reserva en inglés.
- Pruebe con un paquete de idioma de Visual Studio no en inglés instalado.
- Utilice
CultureInfo.CurrentUICulturepara cadenas de interfaz de usuario.
❌ INCORRECTO
- No uses claves genéricas como
"Label1". - No suponga que la cultura del usuario siempre coincidirá con una configuración regional proporcionada.
- No codifique las cadenas orientadas al usuario directamente en el código.
- No utilice
CultureInfo.CurrentCulturepara las cadenas de interfaz de usuario; es para el formato de número y fecha.