Localizzazione nella CI/CD: traduci a ogni commit

Aggiungi la traduzione alla tua pipeline CI/CD con PTC: un token, un file di workflow e i file tradotti ritornano sotto forma di pull request su GitHub, GitLab o Bitbucket.

In breve: quattro passaggi

1. Crea un progetto PTC e scegli API integration. Descrivi il prodotto, scegli le lingue e ottieni un token API del progetto.
2. Aggiungi il token al tuo repository come segreto PTC_API_TOKEN.
3. Aggiungi il workflow preconfigurato per la tua CI. Vedi gli esempi per GitHub Actions e GitLab CI.
4. Esegui il push. PTC traduce solo le stringhe nuove e modificate, e i file tradotti ritornano sotto forma di pull request.

La configurazione completa è riportata di seguito. La configuri una volta sola; dopodiché ogni commit viene tradotto senza che nessuno debba avviare il processo.

I file di origine cambiano, PTC traduce automaticamente, i file tradotti ritornano nel tuo repository come merge request e AI Visual QA verifica l'app visualizzata prima che la release venga rilasciata. Nessuno spostamento di file tra i team, nessun passaggio di consegne alle agenzie tra una release e l'altra.

Il flusso di localizzazione che sta rallentando il tuo team

La maggior parte dei team di sviluppo adotta la localizzazione nello stesso modo. E si scontra con gli stessi tre problemi:

• Le traduzioni scombinano l'interfaccia. Le parole in tedesco sono circa il 30% più lunghe rispetto all'inglese. Scopri che i tuoi pulsanti vanno in overflow solo in produzione.
• La localizzazione è sempre l'ultimo passaggio. Esporti manualmente i file .json, .po o .strings. Le traduzioni ritornano in ritardo e posticipano la tua release.
• Le traduzioni non riflettono il tuo brand. I generici strumenti di traduzione del software non conoscono i nomi delle tue funzionalità, la tua terminologia tecnica o se il tuo tono è formale o scherzoso.

PTC sostituisce tutti e tre con un flusso nativo per la CI.

Cosa distingue PTC nella localizzazione del software

Ogni voce qui sotto rimanda alla sezione dettagliata più in basso in questa pagina.

• PTC impara il vocabolario del tuo prodotto e la voce del brand: traduzioni su misura per ogni progetto, con un'accuratezza basata sulle traduzioni contestualizzate in ogni file di risorse.
• Revisione visiva della traduzione del tuo software in esecuzione: PTC esegue la revisione della tua app visualizzata, così puoi rilasciare senza QA manuale per lingua.
• Integrazione CI/CD nativa con GitHub, GitLab e Bitbucket: un push che aggiunge o modifica le stringhe di origine ritorna sotto forma di merge request.
• Glossario e memoria di traduzione per progetto: la terminologia rimane coerente in ogni file di risorse del progetto e in ogni release.
• Tutti i formati di risorse più comuni gestiti fin da subito: JSON, YAML, PO, .strings, .xcstrings, .properties, XLIFF, CSV e altri ancora.

PTC impara il vocabolario del tuo prodotto e la voce del brand

PTC non è uno strumento di traduzione che aiuta il tuo team a tradurre. PTC è il traduttore. Impara il vocabolario, il tono e le regole del tuo prodotto dalle stringhe che carichi e li applica in modo coerente in ogni release.

Creato per i team di sviluppo, non aggiunto in un secondo momento

Uno strumento di traduzione del software si guadagna il suo posto quando si adatta al workflow esistente, comprende i formati di file tecnici e preserva i segnaposto e le variabili. PTC è stato creato esattamente per questo: analizza automaticamente i tuoi file di risorse, impara la terminologia del tuo prodotto e fornisce traduzioni che rispettano i vincoli della tua interfaccia, in modo che i tuoi ingegneri mantengano il loro workflow invece di doversi adattare a un'app di traduzione generica.

• Voce del brand per progetto. Definisci una volta sola lo scopo e il pubblico del tuo prodotto. PTC utilizza questo contesto per ogni stringa, così le tue traduzioni sembreranno scritte dal tuo team. Questo vale indipendentemente dal fatto che il tuo prodotto sia formale o informale, tecnico o rivolto ai consumatori.
• Glossario che si accumula in modo composto. Aggiungi una volta sola i termini specifici del brand, i nomi delle funzionalità e le regole «da non tradurre». “Cart = Carrito” per lo spagnolo. PTC li applica in ogni file, in ogni lingua e in ogni aggiornamento futuro.
• Traduzioni che si adattano alla tua interfaccia. PTC utilizza valori predefiniti intelligenti per la lunghezza di ogni lingua di destinazione e segnala gli overflow durante la traduzione, non dopo la compilazione della build.
• Segnaposto gestiti correttamente. PTC riconosce i segnaposto come %s, {{name}}, {0}, %1$s in ogni formato di file di risorse supportato. Le variabili vengono preservate, per non farti mai rilasciare una stringa difettosa.
• Memoria di traduzione tra un aggiornamento e l'altro. Quando modifichi una parola in un paragrafo, PTC ritraduce solo ciò che è cambiato e preserva il resto.
• Nessuna supposizione. Se una stringa è ambigua (“Submit” è un pulsante o un sostantivo?), PTC si ferma e chiede chiarimenti invece di scegliere un significato sbagliato.

Revisione visiva della traduzione del tuo software in esecuzione: rilascia senza QA manuale per lingua

La traduzione è necessaria, ma non sufficiente per il rilascio di un software multilingue. Una stringa tradotta può portare al rilascio di un prodotto difettoso. Un'etichetta in tedesco che va in overflow in un pulsante. Una parola in francese con la parte del discorso sbagliata. Una stringa in inglese che qualcuno ha dimenticato di racchiudere nell'helper i18n. Intercettare questi errori significa tradizionalmente eseguire un ciclo di QA manuale di più giorni per lingua in ogni release. È la fase più costosa e lenta della localizzazione e il motivo per cui molti team si limitano a due o tre lingue.

L'AI Visual QA di PTC sostituisce quel ciclo con un'automazione nativa per la CI. Due varianti coprono ogni tipo di software:

• Estensione del browser (per software basati su browser come SaaS, interfacce di amministrazione web, app desktop basate su web). Installa l'estensione del browser di PTC e registra una volta sola un percorso guidato dei flussi utente critici della tua app. Da quel momento in poi, PTC riproduce la registrazione dopo ogni release, acquisisce ogni schermata in ogni lingua e ispeziona il risultato visualizzato.
• Caricamento delle schermate (per app desktop native, strumenti CLI server o qualsiasi software non basato su browser). Carica una schermata per lingua per ogni videata. L'IA visiva di PTC ispeziona il risultato visualizzato allo stesso modo.

I problemi che PTC può correggere nei file di risorse (ambiguità verbo/sostantivo, overflow del layout, mancate corrispondenze dei plurali) vengono risolti automaticamente. I problemi che risiedono nel tuo codice sorgente (wrapper mancanti, stringhe hardcoded, concatenazione di frasi) ritornano sotto forma di prompt pronti da incollare per Cursor o Claude Code.

Il risultato finale passa da «file di risorse tradotti» a «software multilingue pronto per il rilascio». Nessun'altra piattaforma di localizzazione offre questo oggi.

Integrazione CI/CD nativa con GitHub, GitLab e Bitbucket

Esegui il commit di un .ptc-config.yml specificando i file che contengono le tue stringhe di origine e la destinazione delle traduzioni:

# .ptc-config.yml
source_locale: en
files:
  - file: src/locales/en.json
    output: src/locales/{{lang}}.json
  - file: app/src/main/res/values/strings.xml
    output: app/src/main/res/values-{{lang}}/strings.xml

Aggiungi poi l'action PTC Translate al tuo workflow. Contiene una versione bloccata della PTC CLI, in modo che la tua build non scarichi nulla a runtime:

# .github/workflows/translate.yml
name: Translate
on:
  push:
    branches: [main]
    paths:
      - 'src/locales/en.json'
      - 'app/src/main/res/values/strings.xml'
  workflow_dispatch: {}

jobs:
  translate:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: OnTheGoSystems/ptc-action@v1
        with:
          api-token: ${{ secrets.PTC_API_TOKEN }}
          create-pr: true

PTC sincronizza le nuove stringhe di origine, le traduce nelle tue lingue di destinazione e apre una pull request con i file es.json, de.json, values-es/strings.xml aggiornati e così via. Il tuo team la revisiona come qualsiasi altra modifica al codice. Un push che lascia invariate le tue stringhe di origine non traduce nulla e non apre nulla.

Per GitLab CI, Bitbucket Pipelines, CircleCI o qualsiasi altro sistema CI, lo stesso flusso funziona tramite REST. Consulta la reference dell'API PTC per l'API completa di webhook e sincronizzazione.

Per i team che rilasciano più release a settimana, PTC scala senza overhead per ogni release. PTC ritraduce solo le stringhe che sono effettivamente cambiate. Un aggiornamento di 10 stringhe non ritraduce le altre 10.000. PTC è operativo 24/7. Non devi mai aspettare la stima di consegna della settimana successiva da parte di un'agenzia.

La localizzazione procede di pari passo con il tuo codice, non dopo

Localizzazione continua significa che la traduzione vive all'interno del tuo ciclo di vita di sviluppo invece di diventare una fase separata alla fine. PTC offre questo risultato connettendosi al tuo repository Git o alla tua pipeline CI/CD. Quando esegui il push di nuovo codice, PTC rileva le nuove stringhe, applica il contesto del tuo prodotto e il glossario, le traduce e le restituisce sotto forma di merge request, in modo che la localizzazione stia al passo con ogni commit anziché bloccare la release successiva.

Come funziona l'integrazione CI/CD

Prima di configurare PTC con il tuo sistema CI, ecco i tre principi alla base dell'API e della CLI di PTC:

1. I file di risorse sono legati a un branch

Ogni file che invii a PTC è collegato al nome di un branch (es. main, feature/new-checkout). Questo mantiene separate le traduzioni, in modo che quelle di funzionalità diverse non si sovrascrivano a vicenda. Quando utilizzi le configurazioni CI/CD predefinite, questa mappatura viene già gestita automaticamente.

2. Le traduzioni vengono elaborate in modo asincrono

PTC non restituisce immediatamente le traduzioni. Al contrario:

• Carica i file aggiornati
• Identifica solo le stringhe nuove o modificate
• Traduce le stringhe
• Prepara i file tradotti per il download

3. Uno script CLI funziona ovunque

Invece di chiamare l'API direttamente, usa la PTC CLI:

Un unico script gestisce l'intero flusso (caricamento → polling → download). La CLI viene eseguita su Linux e macOS e funziona con GitHub Actions, GitLab, Bitbucket o qualsiasi altra piattaforma CI/CD.

Flusso ad alto livello: configura l'API PTC nella tua pipeline CI/CD

1Iscriviti per una prova.

Ottieni l'accesso completo a tutte le funzionalità e traduci fino a 20.000 parole in due lingue a tua scelta.

2Crea un nuovo progetto.

Quando scegli come utilizzare PTC, seleziona API integration. Durante la configurazione, fornirai un po' di contesto sul tuo progetto (cosa fa, a chi è rivolto) e selezionerai le lingue in cui desideri tradurre.

3Ottieni il tuo token API.

Alla fine della configurazione, riceverai un token API specifico per il progetto. Copialo e conservalo in modo sicuro: ti servirà per autenticare tutte le richieste. Puoi sempre ritrovare lo stesso token nel pannello di controllo del tuo progetto in Impostazioni → Token API PTC.

4Aggiungi il token API PTC al tuo repository nella posizione corretta.

5Copia la configurazione CI/CD predefinita.

Su GitHub Actions, aggiungi l'action PTC Translate al tuo workflow. Il tuo token API è l'unico input che devi passare. L'action contiene al suo interno una versione fissa della CLI, in modo che la tua build non scarichi mai uno script a runtime, e quando un'esecuzione produce nuove traduzioni, apre la pull request per te.

Su GitLab CI, Bitbucket Pipelines o qualsiasi altra piattaforma, copia il job per la tua piattaforma dai template CI/CD della PTC CLI. Ogni template blocca la CLI a una specifica release e pubblica il checksum per verificarla, in modo che una release successiva della CLI non possa modificare ciò che viene eseguito dalla tua build.

6Esegui il workflow.

Puoi attivare il workflow manualmente, sui commit che aggiornano i file di risorse o in base a una pianificazione. Consulta i trigger per GitHub, GitLab e Bitbucket. Una pull request ha bisogno di un branch su cui essere aperta, quindi su GitHub Actions l'action PTC Translate ne apre una su un push, in base a una pianificazione e su un'esecuzione manuale da un branch. Su un evento pull_request, pull_request_target o merge_group, oppure su un tag o una release, si ferma invece con una spiegazione: traduci su un push al tuo branch di origine, oppure imposta create-pr: false per quell'esecuzione.

Quando viene eseguita, la CLI carica i tuoi file, attende il completamento delle traduzioni e riscrive le traduzioni aggiornate nel tuo repository. Se stai utilizzando le configurazioni predefinite e l'esecuzione ha prodotto nuove traduzioni, il workflow si occuperà anche di create a merge request con le modifiche, in modo che tu possa revisionarle e fare il merge come per qualsiasi altro aggiornamento del codice. Un'esecuzione che non trova nulla da tradurre non scrive nulla e non apre alcuna merge request. Da questo momento in poi, le tue traduzioni rimangono sincronizzate automaticamente.

Esempi di CI/CD

WordPress

• GitHub Actions
• GitLab CI

Ruby on Rails

• GitHub Actions

File JSON (App React)

• GitHub Actions
• GitLab CI

Glossario e memoria di traduzione per progetto

Aggiungi una voce di glossario una volta sola. Ad esempio: “Cart = Carrito” per lo spagnolo. PTC applica la voce in ogni file dello stesso progetto, ora e in ogni aggiornamento futuro. Non dovrai mai ricaricare i file TMX tra un'esecuzione e l'altra.

Puoi gestire le voci del glossario in due modi. Il pannello di controllo di PTC fornisce un editor per voci ad hoc. L'API REST PTC supporta l'importazione e l'esportazione del glossario per i team che mantengono la terminologia in un sistema separato.

Modifica o ritraduci qualsiasi stringa dopo che è stata generata

PTC non blocca mai una traduzione. Puoi revisionare, modificare o chiedere a PTC di ritradurre qualsiasi stringa dalla scheda Translations in qualsiasi momento, in modo che il tuo team mantenga l'ultima parola su ogni termine rilasciato.

PTC gestisce tutti i formati di risorse più comuni fin da subito

PTC gestisce i formati che il tuo stack utilizza effettivamente. I formati indicati di seguito rimandano alle rispettive pagine di traduzione dedicate:

• Web: JSON (i18next, react-intl, vue-i18n, next-intl), YAML (Rails), PO/POT (Django, WordPress).
• iOS: .strings, .stringsdict, .xcstrings (String Catalogs).
• Android: strings.xml, plurali, array di stringhe.
• Desktop / multipiattaforma: .properties (Java), .po (gettext).
• Dati / cataloghi: CSV, XLIFF.

La localizzazione del software non inizia e finisce con l'interfaccia utente. PTC traduce anche note di rilascio, notifiche via email, documentazione di supporto, materiali di marketing, feedback degli utenti e segnalazioni di bug. Tutto nello stesso progetto, per far sì che la terminologia rimanga coerente in tutto ciò con cui i tuoi utenti interagiscono.

Consulta la matrice completa del supporto per formati e lingue per l'elenco completo.

Rilascia in oltre 40 lingue, dall'arabo al giapponese

PTC traduce in oltre 40 lingue, tra cui arabo, cinese, francese, tedesco, giapponese, coreano, portoghese, spagnolo e altre ancora, così puoi raggiungere nuovi mercati senza aggiungere un nuovo strumento per ciascuno di essi. Consulta l'elenco completo delle lingue supportate per confermare che le tue lingue di destinazione siano coperte.

Traduci note di rilascio multipiattaforma, email per i clienti e documentazione di supporto

Le note di rilascio multipiattaforma, le email rivolte ai clienti, la documentazione di supporto e i testi del sito di marketing vivono tutti al di fuori dei tuoi file di risorse. Paste to Translate di PTC gestisce questi testi nello stesso progetto. Incolla il testo di origine, scegli le lingue di destinazione e ottieni traduzioni che utilizzano lo stesso glossario e la stessa voce del brand delle tue stringhe in-app.

Traduci contenuti generati dagli utenti, ticket di supporto e dati dinamici con l'API PTC

I contenuti generati dagli utenti, i ticket di supporto e i dati dinamici che il tuo software gestisce a runtime necessitano di traduzione nel momento in cui arrivano. L'API REST PTC traduce questi contenuti su richiesta con autenticazione tramite token Bearer, utilizzando lo stesso glossario e la stessa voce del brand delle traduzioni dei tuoi file di risorse.

Prezzi: prova di 30 giorni, poi Pay-As-You-Go

La prova copre 20.000 parole in 2 lingue senza carta di credito. Al termine della prova, PTC offre la modalità Pay-As-You-Go. Nessun abbonamento. Nessun impegno minimo. Le prime 500 parole di ogni mese sono gratuite. Paghi solo per il resto. La pagina dei prezzi include un calcolatore dei costi. Iscriviti con un'email aziendale per una prova estesa per le aziende.

PTC possiede la certificazione ISO 27001 per l'uso enterprise

PTC possiede la certificazione ISO 27001, il che significa che i tuoi dati e quelli dei tuoi utenti vengono trattati secondo standard di sicurezza riconosciuti a livello internazionale. PTC supporta la localizzazione continua per team di sviluppo di ogni dimensione, da una startup con 3 sviluppatori a un'azienda enterprise che rilascia settimanalmente in 12 lingue.

Segui un percorso collaudato dalla prima stringa alla release rilasciata

Iniziare è semplice quando hai una mappa. La nostra guida alla localizzazione del software ti accompagna in ogni fase, dalla preparazione delle stringhe per la traduzione alla gestione degli aggiornamenti man mano che il tuo prodotto cresce, in modo che tu possa adottare PTC con un piano chiaro invece di procedere per tentativi. Leggi la guida alla localizzazione del software per configurare il tuo primo progetto.

Pronto a rilasciare software multilingue verificato?

Collega il tuo repository GitHub o GitLab. PTC traduce i tuoi file di risorse in oltre 40 lingue e revisiona l'app in esecuzione in ognuna di esse a ogni release. Rilascia con sicurezza.

Inizia la tua prova di 30 giorni: 20.000 parole offerte da noi, nessuna carta di credito richiesta.

Per gli sviluppatori pronti ad approfondire:

• Leggi la reference dell'API PTC: endpoint REST, webhook, integrazione CI.
• Consulta il supporto per formati di file e lingue.
• Parlaci delle esigenze enterprise: SLA personalizzati, opzioni on-premise, supporto dedicato.

Ultimo aggiornamento: 11 novembre 2026