Integrazione GitLab con PTC
Collega GitLab a PTC per la localizzazione continua. Ricevi le traduzioni tramite merge request automatici ogni volta che il tuo codice cambia.
Come integrare GitLab con PTC
PTC si collega al tuo repository GitLab e mantiene tradotti i tuoi file di risorse mentre lavori. Esegui il push delle modifiche al tuo codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà un merge request.
L'integrazione GitLab è una funzionalità Pro. Diventa disponibile quando attivi il Pay-As-You-Go.
Collega il tuo repository GitLab
PTC supporta sia GitLab.com che i repository GitLab self-hosted. A seconda del punto in cui ti trovi nel tuo flusso di lavoro, ci sono due modi per iniziare:
- Quando crei un nuovo progetto in PTC, seleziona Integrazione Git nella configurazione guidata.
- Per passare un progetto esistente dai caricamenti manuali dei file a un flusso di lavoro continuo basato su Git, vai su Impostazioni → Merge Requests e fai clic su Add Git Integration.
In entrambi i casi, vedrai una schermata in cui potrai inserire l'URL del tuo progetto all'interno del repository. PTC rileverà automaticamente che stai usando GitLab.
Autenticati con GitLab
Per collegare il tuo repository, puoi usare un access token (consigliato) o accedere con OAuth. PTC supporta sia i project access token che i group access token.
PTC richiede l'accesso ai webhook per rilevare le modifiche nel tuo repository. Quando usi un access token, il ruolo e gli scope di cui hai bisogno dipendono da come vuoi che sia configurato il webhook:
| Configurazione automatica del webhook | Configurazione manuale del webhook | |
|---|---|---|
| Come funziona | PTC crea e configura il webhook in GitLab per tuo conto durante il flusso di integrazione. | PTC ti fornisce un URL di callback e un Secret Token. Tu crei un webhook nelle impostazioni di GitLab usando questi dettagli, con Push events e Merge request events come trigger. |
| Creazione del token | Nel tuo progetto, vai su Settings → Access Tokens. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliato per la sicurezza). | Nel tuo gruppo, vai su Settings → Access Tokens. Assegna un nome al token, una descrizione facoltativa e imposta una data di scadenza (consigliato per la sicurezza). |
| Ruolo richiesto | Maintainer | Developer (o equivalente) |
| Scope | api → Consente a PTC di leggere ed eseguire il push sul repository |
read_repository + write_repository |
Conserva il token in modo sicuro e aggiungilo a PTC. Verificherà le tue autorizzazioni e ti permetterà di scegliere quali branch e file di risorse monitorare.
L'accesso rimane limitato ai file che PTC traduce
PTC usa l'accesso in lettura per rilevare le modifiche nei tuoi file di risorse e l'accesso in scrittura per consegnare le traduzioni tramite merge request. PTC interagisce solo con i file che gestisce per la traduzione e non apporta modifiche ad altre parti del tuo repository.
I webhook mantengono le traduzioni sincronizzate automaticamente
I webhook sono il modo in cui PTC viene avvisato quando esegui il push delle modifiche sul tuo repository, così può ritradurre automaticamente le stringhe interessate. Senza l'accesso ai webhook, PTC non può monitorare i tuoi branch per gli aggiornamenti.
Traduci il tuo progetto con PTC
Una volta collegato il tuo repository GitLab, prosegui con i passaggi di configurazione per fornire un po' di contesto sulla tua app o sul tuo software e scegliere le tue lingue di destinazione.
PTC tradurrà quindi i file di risorse nel tuo branch GitLab collegato. Se il tuo repository contiene già file di traduzione, PTC può rilevarli e riutilizzarli.
Rivedi il merge request con le traduzioni
PTC traduce in pochi minuti e invia un merge request con le traduzioni direttamente al tuo repository GitLab. Quando sei pronto, ti basta eseguirne il merge: non sono necessarie altre azioni.
Da quel momento in poi, man mano che esegui il push delle modifiche al tuo codice, PTC le rileverà e invierà nuovi merge request con le traduzioni aggiornate, mantenendo il tuo software completamente localizzato nel tempo.
Genera nuovi merge request manualmente
Oltre agli aggiornamenti automatici, puoi generare un nuovo merge request in qualsiasi momento per sincronizzare le traduzioni che hai modificato o ritradotto.
Per farlo, vai alla scheda Translations. Da qui, puoi rivedere il testo tradotto che supera il limite di lunghezza e modificarlo manualmente oppure lasciare che PTC ne generi una versione più breve. Una volta finito, fai clic su Generate MR per eseguire il push delle traduzioni aggiornate sul tuo repository.
Dai a PTC l'accesso ai nuovi file di risorse man mano che li aggiungi
Se aggiungi nuovi file di risorse al tuo repository dopo l'integrazione iniziale, puoi chiedere a PTC di cercarli.
- Vai su Impostazioni → Monitored Files e fai clic su Rescan your repository. PTC scansionerà il tuo repository e mostrerà tutti i file appena scoperti come bozze.
- Fai clic sull'icona + accanto a un file per includerlo nella traduzione, quindi fai clic su Save with translation per confermare.
Per saltare del tutto la revisione manuale, seleziona la casella di controllo Automatically include new translation files. Da quel momento in poi, PTC rileverà e monitorerà automaticamente tutti i nuovi file di risorse che trova, senza richiederti di confermarli.
Per regolare altre impostazioni come i branch monitorati e le lingue, naviga tra le schede Branch Management, Monitored Files e Languages.
Perché localizzare i progetti GitLab con PTC
Traduzione automatizzata dei file
PTC rileva e traduce automaticamente i tuoi file di risorse, consegnando le traduzioni tramite merge request. Mantieni il controllo usando il flusso di lavoro GitLab che già conosci e di cui ti fidi, e senza la necessità di creare alcuno script.
Meno lavoro manuale
PTC fa risparmiare tempo di sviluppo e velocizza le release monitorando il tuo repository e aggiornando i file di traduzione man mano che esegui il push delle modifiche.
Maggiore precisione della traduzione
PTC elimina il rischio di errori umani come chiavi fuori posto o traduzioni obsolete. Ottieni traduzioni altamente accurate e in linea con il brand.
La localizzazione sta al passo con lo sviluppo software e mobile
PTC è progettato per i team di sviluppo che creano prodotti software e app mobili e che vogliono che la localizzazione stia al passo con lo sviluppo. Una volta collegato il tuo repository GitLab, PTC rileva automaticamente le stringhe nuove e aggiornate e restituisce le traduzioni tramite un merge request, senza richiedere alcun passaggio di consegne manuale.
I formati comuni nei progetti software e mobili, come i file PO e i file JSON, sono pienamente supportati. Per maggiori informazioni su come PTC si inserisce in questi flussi di lavoro, consulta le nostre pagine sulla localizzazione software e sulla localizzazione di app mobili.
Collega GitLab senza costi aggiuntivi
Non ci sono costi aggiuntivi per collegare GitLab. Invece di un modello in abbonamento, PTC usa un semplice prezzo Pay-As-You-Go: ti vengono addebitate solo le parole che traduci e le prime 500 parole di ogni mese sono gratis. Tutti i dettagli si trovano sulla pagina dei prezzi di PTC.
Funziona anche con GitHub e Bitbucket
Oltre a GitLab, PTC si integra con GitHub e Bitbucket, offrendo gli stessi flussi di lavoro di localizzazione automatizzati e le stesse funzionalità per ogni piattaforma.