Registo de alterações · Tradutor de Recursos

Veja CHANGELOG.md para o registo completo.

Lançamentos

3.2.0 — 2026-07-12

Smart change detection now defaults to smart: a compact provider-neutral state manifest (.github/resource-translator-state.json) tracks parser keys, source hashes, target hashes, and translation-affecting settings so only changed or missing keys are sent to the selected provider. Use changeDetection=disabled or false for legacy always-translate behavior, statePath to relocate the manifest, and snapshotOnly to bootstrap the manifest from existing target files without calling a provider. The same release adds nested {provider} blocks, AWS/Google-native behavior knobs, narrow-friendly reference cards, and official provider-doc links. Key-level audit rule codes are logged for every decision.

3.1.0 — 2026-07-10

Multi-fornecedor: traduzir com Azure AI Translator, AWS Translate ou Google Cloud Translation atrás de uma superfície API unificada. Escolha um único fornecedor por execução com a nova provider entrada; a ação delega para o SDK correspondente atrás de uma fábrica e comporta-se de forma idêntica independentemente do fornecedor. Totalmente compatível com versões anteriores — provider por defeito para azure, por isso os fluxos de trabalho existentes do Azure continuam a funcionar inalterados.
Novo fornecedor AWS Translate (@aws-sdk/client-translate). Autenticar com a cadeia de credenciais padrão da AWS (recomendada: OIDC via aws-actions/configure-aws-credentials) ou com awsAccessKeyId explícito / awsSecretAccessKey; região via awsRegion ou AWS_REGION.
Novo fornecedor de tradução Google Cloud (@google-cloud/translate, v2). Autenticar com uma credencial JSON de conta de serviço (googleCredentials) ou uma chave API (googleApiKey); Opcional googleProjectId.
Novas entradas: provider, awsAccessKeyId, awsSecretAccessKey, awsRegion, googleApiKey, googleCredentials, googleProjectId.
Mapeamento de especificação de intenção: textType mapeia para a format do Google e profanityAction mapas para mascarar palavrões da AWS onde existe um equivalente. Especificadores apenas Azure (categoryId, apiVersion, profanityMarker, allowFallback) são ignorados por outros fornecedores.
As entradas de pedidos do Azure (subscriptionKey, endpoint, region) já não são marcadas como obrigatórias em action.yml para que outros fornecedores possam ser selecionados — ainda validadas em tempo de execução quando provider está azure.
Página de novos fornecedores de tradução, separadores de fornecedores em Como começar, seleção de fornecedores na página de Entradas e uma página inicial atualizada a começar com Azure, AWS e Google.

3.0.2 — 2026-07-10

Corrigido: Solicitações do tradutor agora colocam api-version=3.0 na linha tanto para /translate como para /languages. O Azure SDK só honra a opção de versão da API ao nível do cliente quando uma credencial é passada; a ação autentica-se por pedido através de cabeçalhos, pelo que essa opção foi silenciosamente abandonada e os pedidos passaram por defeito a uma versão API de pré-visualização cujo contrato de /translate rejeitou o corpo com HTTP 400 (código de erro 400074). Conclui a correção iniciada na 3.0.1.

3.0.1 — 2026-07-10

Corrigido: O corpo do pedido /translate é agora um array JSON nu de itens { text } em vez de um objeto { inputs } wrapped, correspondendo ao contrato REST v3.0. Por si só, isto não restaurava as traduções — ver 3.0.2.

3.0.0 — 2026-07-08

Subi para node24 tempo de execução (BREAKING).
Novas entradas: include, exclude, configPath, categoryId, apiVersion, dryRun, failOnError, além de botões avançados do tradutor textType, profanityAction, profanityMarker e allowFallback.
A localização de origem também é agora encaminhada para o Tradutor como from=<locale> para que cadeias curtas não sejam detetadas automaticamente.
Resiliência: retentativa automática em respostas HTTP transitórias (408, 425, 429, 500, 502, 503, 504) que honra o cabeçalho Retry-After do Azure — volta a um recuo exponencial com jitter quando ausente. Ajustável via maxRetries e retryBackoffMs. Fecha a #46.
Proteção provisória: tokens como {{name}}, ${var}, {0}, {0:N2}, %s, %1$s e HTML são enrolados em sentinelas antes da tradução e restaurados depois, por isso o Tradutor deixa de manipular i18next/Mustache/Handlebars/.NET/printf placeholders. Alternar via protectPlaceholders; Estende com customPlaceholderPatterns. Aperta a #16.
Exclusão por chave: nova entrada noTranslatePatterns elimina completamente as chaves correspondentes do pedido do tradutor (preserva os valores fonte para nomes de marcas, códigos de erro, etc.). Compara padrões glob com chaves ao nível do parser (JSON ponted path, RESX name, PO msgid, unidade XLIFF id, INI/restext key). Fecha a #35.
Configuração ao nível do repositório via .github/resource-translator.yml.
Suporte ao glossário, resumo dos passos via core.summary.
esbuild bundler, ESLint 9 flat config, Prettier, EditorConfig.
Auditoria NPM limpa (0 vulnerabilidades).
Site de documentação Astro + Tailwind v4 com transições de visualização e Expressive Code.
Acessibilidade dos documentos: passe WCAG 2.1 AA. Os glifos do logótipo convertidos em caminhos para que já não falhem no contraste de cor com paradas de gradiente, o botão de Back to top flutuante usa inert enquanto está oculto (em vez de um botão de aria-hidden que o deixava tabável), formats.astro secções deixaram de colidir com os seus IDs de cabeçalhos gerados automaticamente, três cartões locais agora expõem atributos de lang válidos para BCP-47 (nya→ny, lug→lg, run→rn), rótulos duplicados Documentation de referência são desambiguados entre a barra lateral e o rodapé, e todas as tabelas de dados no inputs/configuration são enviadas com uma legenda de leitor de ecrã.
Estilo de código inline: prosa documental <code> agora usa o tema quente/âmbar — distinto da paleta → marcassotaque usada para links e títulos.
Fusão automática Dependabot, varredura CodeQL, matriz CI.

2.2.1 — 2024-01-05

Security: bumped axios (1.4.0 → 1.6.0), @babel/traverse, semver, and tough-cookie/@azure/ms-rest-js to clear Dependabot alerts.

2.2.0 — 2023-07-05

Maintenance release (dependency and dist refresh).

2.1.9 — 2023-04-11

Dependency upgrades (including xml2js 0.4.23 → 0.5.0) and a refreshed dist build.

2.1.8 — 2023-01-02

Security: bumped follow-redirects, node-fetch, decode-uri-component, minimist, ansi-regex, jsdom, json5, minimatch, and @actions/core (1.2.6 → 1.9.1).

2.1.7 — 2021-12-09

Use a different delimiter when building the translation map so keys containing the previous separator are handled correctly (#36).
Fixes #32.

2.1.6 — 2021-08-04

Assorted bug fixes and improved logging.

2.1.5 — 2021-07-28

Fix an issue with file names containing four segments.

2.1.4 — 2021-05-20

Added a JSON parser and .json file support.
Fix batching bug (#18).

2.1.3 — 2021-02-22

Maintenance release.

2.1.2 — 2021-02-18

Fixes #15.

2.1.1 — 2020-12-02

Fix the generated step summary.

2.1.0 — 2020-12-01

Support for additional resource file formats beyond .resx: .ini, .po, .restext, and .xliff.

2.0.4 — 2020-11-17

Maintenance release.

2.0.3 — 2020-11-15

Fixes a batching bug and other related issues.

2.0.2 — 2020-11-12

File filtering to limit excessive translations.
Batching of the translate API call to avoid rate limiting.

2.0.1 — 2020-11-12

New action outputs: has-new-translations, summary-title, and summary-details.
Fix a bug where an error was logged but the action failure was not set.

2.0.0 — 2020-11-06

First official, fully functional and verified release.

1.0.1 — 2020-11-05

Build release.

1.0.0 — 2020-11-05

Initial release of the Azure AI Translator resource action (.resx support).

0.0.x — 2020-10-31

Initial prototype pre-releases (tags 0.01–0.09).