Integra la localizzazione nella tua pipeline CI/CD con l'API di PTC
Scopri come integrare l'API di PTC nella tua pipeline CI/CD per fornire traduzioni con IA di qualità umana come parte del tuo processo di build.
Sicuro fin dalla progettazione: non è richiesto alcun accesso in lettura o scrittura al repository.- Compatibile con qualsiasi sistema CI/CD, con configurazioni pronte all'uso incluse.
- Accesso controllato tramite token API specifici per il progetto.
- Traduzioni di qualità umana consegnate in pochi minuti, direttamente nella tua build.
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 (ad esempio main, feature/new-checkout). Questo mantiene separate le traduzioni, in modo che le traduzioni di funzionalità diverse non si sovrascrivano a vicenda.
Quando usi le configurazioni CI/CD pronte all'uso, questa mappatura viene già gestita automaticamente.
2. Le traduzioni vengono elaborate in modo asincrono
PTC non restituisce le traduzioni immediatamente. Invece:
- Carica i file aggiornati
- Identifica solo le stringhe nuove o modificate
- Traduce le stringhe
- Prepara i file tradotti per il download
3. Un solo script CLI funziona ovunque
Invece di chiamare tu stesso l'API, usa la CLI di PTC:
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 di PTC nella tua pipeline CI/CD
1Iscriviti per una prova.
Ottieni pieno accesso a tutte le funzionalità e traduci fino a 20.000 parole in due lingue a tua scelta.
2Crea un nuovo progetto.
Quando scegli come usare 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 vuoi 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 Settings → PTC API tokens.
4Aggiungi il token API di PTC al tuo repository nella posizione corretta.
| Provider | Dove aggiungere il token |
|---|---|
| GitHub Actions | Vai su Settings → Secrets and variables → Actions e aggiungi PTC_API_TOKEN. Quindi vai su Settings → Actions → General e abilita Workflow permissions in modo che il workflow possa creare pull request. |
| GitLab CI/CD | Vai su Settings → CI/CD → Variables e aggiungi PTC_API_TOKEN. |
| Bitbucket Pipelines | Vai su Repository settings → Pipelines → Repository variables e aggiungi PTC_API_TOKEN. |
5Copia la configurazione CI/CD pronta all'uso.
Su GitHub Actions, aggiungi la PTC Translate action al tuo workflow. Il tuo token API è l'unico input che devi passare. L'action contiene al suo interno una versione fissa della CLI, quindi la tua build non scaricherà mai uno script in fase di esecuzione, e aprirà automaticamente la pull request per la traduzione al posto tuo.
Su GitLab CI, Bitbucket Pipelines o qualsiasi altra piattaforma, copia il job per la tua piattaforma dai template CI/CD della CLI di PTC. Ogni template blocca la CLI a una release specifica e pubblica il checksum con cui verificarla, così una release successiva della CLI non potrà cambiare ciò che la tua build esegue.
6Esegui il workflow.
Puoi attivare il workflow manualmente, sui commit che aggiornano i file di risorse o in modo programmato. Vedi i trigger per GitHub, GitLab e Bitbucket.
Quando viene eseguita, la CLI carica i tuoi file, attende il completamento delle traduzioni e riscrive le traduzioni aggiornate nel tuo repository. Se stai usando le configurazioni pronte all'uso, il workflow creerà anche una create a merge request con le modifiche, così potrai revisionarle e farne il merge come per qualsiasi altro aggiornamento del codice. Da questo momento in poi, le tue traduzioni rimarranno sincronizzate automaticamente.
Esempi CI/CD
Ulteriori letture
- Input della PTC Translate action
- Template CI/CD per GitHub e GitLab
- File di configurazione
- Workflow di elaborazione
- Risoluzione dei problemi
Perché usare PTC per le traduzioni di software?
PTC è un sistema di traduzione completo per gli sviluppatori e per i team di prodotto, creato per mantenere sincronizzati il tuo codice, il tuo brand e il tuo pubblico.
Traduzioni consapevoli del contesto che proteggono il tuo brand
Prima di tradurre, PTC impara a conoscere il tuo prodotto, il tuo pubblico e la tua terminologia. Ecco perché il 99,5% delle frasi va in produzione senza modifiche e l'85% dei progetti non viene modificato affatto.
Come le traduzioni con IA di PTC proteggono il tuo brand →
Ampio supporto per piattaforme e formati di file
PTC funziona con le piattaforme e i formati di file di risorse più diffusi, tra cui: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify e WordPress.
Scopri di più sui formati di file supportati →
Traduci non solo i file di risorse
Hai bisogno di tradurre note di rilascio, email o documentazione? PTC include anche una veloce funzionalità “Paste to translate” che ti offre le stesse traduzioni consapevoli del contesto per i testi al di fuori del codice.
Come tradurre i testi al di fuori dei file di risorse →
Automatizza le traduzioni nella tua CI/CD
Configura PTC una volta sola, e i tuoi file di risorse e le traduzioni rimarranno aggiornati automaticamente nella tua pipeline CI/CD.