SmartCoreHub Localization SDK VC
VS Code / Cursor helper for SmartCoreHub.Localization.SDK.
Extensão IDE para o pacote NuGet SmartCoreHub.Localization.SDK (e o npm @smartcorehub/localization-sdk): ligue a Localization API, explore o cliente, teste no playground, use snippets e prepare contexto para Copilot / Cursor.
Pacotes de runtime no projecto (opcionais):
Começar em 4 passos
- Instale a extensão e abra a barra lateral SmartCoreHub Localization (ícone A|文).
- Command Palette → SmartCoreHub Localization: Configure Connection (BaseUrl + ApiKey)
- BaseUrl fica nas Settings da extensão (não é secreto).
- ApiKey é pedida de forma segura (Secret Storage).
- Na árvore SDK Client, confirme o estado da ligação (Show Connection Status).
- Use Open API Playground para testar TypeScript ou .NET sem sair do editor.
Ligação à API
| O quê |
Onde |
| BaseUrl |
Settings → smartcorehub.localization.baseUrl |
| Locale / timeout / cache |
Settings → defaultLocale, timeoutSeconds, cacheEnabled |
| ApiKey |
Configure Connection (não aparece em plain text nas settings) |
Com a ligação OK, pode Refresh Resource Keys, pré-visualizar traduções e inserir chaves / chamadas no código.
Na activity bar SmartCoreHub Localization:
- Ver catálogo do cliente e acções rápidas
- Instalar pacotes (Install NuGet Package / Install npm Package)
- Abrir docs embutidas (.NET README, TypeScript README, AI Context, Client Catalog)
- Refresh Client Tree quando mudar de workspace
API Playground
Command Palette → Open API Playground:
- Escolha o runtime (TypeScript ou .NET).
- Ajuste BaseUrl / locale se precisar (herda a ligação configurada).
- Execute o cenário e veja a resposta no painel.
Útil para validar ApiKey e endpoint antes de integrar no app.
Snippets e inserções
No editor C# / TypeScript / JavaScript:
| Prefixo / comando |
Uso |
Snippets schl-* |
Padrões do Localization SDK |
| Insert Snippet… |
Lista snippets da extensão |
| Insert Resource Key… |
Escolhe uma chave e insere no cursor |
| Preview Translation… |
Pré-visualiza o texto traduzido |
| Insert GetCurrentLanguage Call… |
Stub de chamada GetCurrentLanguage |
| Insert GetByLanguage Call… |
Stub de chamada GetByLanguage |
Menu de contexto do editor → SmartCoreHub Localization para as mesmas acções.
Agentes (Copilot / Cursor)
- Prepare Agent Context — abre docs relevantes e copia um bloco para a clipboard.
- No chat, cole o clipboard e anexe os ficheiros com
@ (Cursor não faz auto-@).
- Peça ao agente alterações de código com BaseUrl/ApiKey e o cliente Localization.
Comandos (Command Palette)
Filtre por SmartCoreHub Localization:
| Comando |
Ação |
| Configure Connection |
BaseUrl + ApiKey |
| Show Connection Status |
Estado da ligação |
| Open API Playground |
Testar a API |
| Install NuGet / npm Package |
Adicionar SDK ao projecto |
| Open NuGet Gallery / npm Page |
Páginas dos pacotes |
| Open .NET / TypeScript README |
Docs do cliente |
| Open AI Context / Client Catalog |
Contexto para agentes |
| Prepare Agent Context |
Docs + clipboard |
| Insert Snippet… / Resource Key… |
Inserir no editor |
| Preview Translation… |
Ver tradução |
| Refresh Resource Keys / Client Tree |
Actualizar dados |
Dicas
- Sem ApiKey válida o playground e as chaves de recurso falham — use Configure Connection primeiro.
- A extensão funciona sozinha no IDE; o NuGet/npm só é necessário no seu projecto para código de produção.
- Cursor e VS Code usam o mesmo VSIX desta página.
