SmartCoreHub Localization SDK VC
VS Code / Cursor helper for SmartCoreHub.Localization.SDK.
Instalar no Marketplace: SmartCoreHub Localization SDK VC
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, envie traduções com SubmitKeys (API key de escrita em Developer ou Global), use snippets e prepare contexto para Copilot / Cursor / automação.
Pacotes de runtime no projecto (opcionais):
Novidades: Enviar traduções (SubmitKeys) + Drag-and-Drop
Enviar traduções
Na sidebar SDK Client, secção Enviar traduções (SubmitKeys):
| Acção |
Uso |
| Enviar seleção… |
Texto selecionado → escolher/criar chave (stringKey) → idioma (locale) → enfileira |
| Nova chave… |
Mesmo fluxo; pede o texto se não houver seleção |
| Sugerir tradução p/ chave existente… |
Escolhe uma key do catálogo e envia um novo suggestedValue |
| Abrir submitKeys no Playground |
Abre o playground já no cenário submitKeys |
| Envios recentes |
Últimos envios desta sessão (inserir / copiar / reenviar) |
Também:
- Menu de contexto do editor → SmartCoreHub Localization → Enviar seleção…
- Lightbulb (💡) sobre texto selecionado → SmartCoreHub: Enviar seleção como tradução
- Clique numa resource key na árvore → Sugerir tradução…
Sugestão automática de chave: ficheiro home.component.ts + texto "Bem-vindo ao painel" → home.bemVindoAoPainel.
Após sucesso, a notificação oferece:
- Substituir por chamada —
await client.getCurrentLanguage('key') / await _client.GetCurrentLanguageAsync("key", cancellationToken)
- Substituir por chave — literal
'key' / "key"
- Outro idioma — repete language + valor para a mesma key
401/403 → mensagem clara (precisa escrita + Developer/Global) e atalho para Configure Connection.
Drag-and-Drop
Arraste itens da barra lateral SDK Client para o editor:
- Resource Keys: literal (
"key" / 'key')
- Client Methods: chamada assíncrona completa
- Snippets: template com tab-stops
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). Para SubmitKeys use key de escrita em Developer/Global.
- Na árvore SDK Client, confirme o estado da ligação (Show Connection Status).
- Arraste itens da árvore, use Enviar traduções, ou Open API Playground.
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, enviar SubmitKeys e inserir chaves / chamadas no código por clique ou drag-and-drop.
Na activity bar SmartCoreHub Localization:
- Status de conexão
- Ações rápidas (Playground, Configure, Preview, Refresh, Snippet, Agent)
- Enviar traduções (SubmitKeys) — fluxo mínimo de escrita
- Resource keys / Resource calls (drag-and-drop)
- Client methods
- Pacotes e documentação embutida
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.
O cenário submitKeys exige API key com permissão de escrita em Localization e ambiente Developer ou Global (Staging/Production → 403).
Snippets e inserções
No editor C# / TypeScript / JavaScript:
| Prefixo / comando |
Uso |
| Drag & Drop direto |
Arraste nós da árvore para o editor |
Snippets schl-* |
Padrões do Localization SDK |
schl-submit |
Body submitKeys / SubmitKeysAsync |
| 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 (inclui SubmitKeys) 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 leituras ou
SubmitKeys/submitKeys com BaseUrl/ApiKey de escrita em Developer — o agente pode automatizar o envio de traduções via SDK.
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 (incl. submitKeys) |
| Enviar seleção como tradução… |
Fluxo guiado SubmitKeys |
| Nova chave (SubmitKeys)… |
Criar e enfileirar |
| Sugerir tradução p/ chave existente… |
Atualizar sugestão numa key |
| 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.
- SubmitKeys falha com 403 se a key for só leitura ou o ambiente for Staging/Production.
- 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.