Integrazione GitLab con PTC
Collega GitLab a PTC per una localizzazione continua. Ricevi le traduzioni tramite merge request automatiche 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 codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà una 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 da un progetto esistente con 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 puoi 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 necessari dipendono da come vuoi configurare il webhook:
| Configurazione automatica del webhook | Configurazione manuale del webhook | |
|---|---|---|
| Come funziona | PTC crea e configura il webhook in GitLab per conto tuo durante il flusso di integrazione. | PTC ti fornisce un URL di callback e un Secret Token. Crei un webhook nelle impostazioni di GitLab usando questi dettagli, con Push events e Merge request events come trigger. |
| Creazione del token | Vai su Settings → Access Tokens, nel tuo progetto o nel tuo gruppo. Assegna al token un nome, una descrizione facoltativa e imposta una data di scadenza (consigliato per la sicurezza). | Vai su Settings → Access Tokens, nel tuo progetto o nel tuo gruppo. Assegna al token un nome, 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 |
Sia il token di progetto che il token di gruppo funzionano in entrambe le colonne: PTC legge il livello di accesso più alto. Ciò che separa le due colonne è il ruolo, e deriva da ciò che fa ciascuna configurazione: la configurazione automatica gestisce un webhook di progetto per te, che GitLab riserva al ruolo Maintainer, mentre la configurazione manuale si limita a leggere il repository ed eseguire il push su un branch, quindi il ruolo Developer è sufficiente.
Conserva il token in modo sicuro e aggiungilo a PTC. Verificherà i tuoi permessi e ti permetterà di scegliere quali branch e file di risorse monitorare.
L'accesso resta limitato ai file che PTC traduce
PTC utilizza 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 a nessun'altra parte del tuo repository.
I webhook mantengono le traduzioni sincronizzate automaticamente
I webhook sono il modo in cui PTC viene notificato quando esegui il push delle modifiche al 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 la merge request con le traduzioni
PTC traduce in pochi minuti e invia una merge request con le traduzioni direttamente al tuo repository GitLab. Quando sei pronto, ti basta eseguire il merge: non è necessaria nessun'altra azione.
Da quel momento in poi, man mano che esegui il push delle modifiche al tuo codice, PTC le rileverà e invierà nuove merge request con le traduzioni aggiornate, mantenendo il tuo software completamente localizzato nel tempo.
Genera nuove merge request manualmente
Oltre agli aggiornamenti automatici, puoi generare una nuova 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 o 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 per la traduzione, quindi fai clic su Save with translation per confermare.
Per saltare completamente la revisione manuale, seleziona la casella di controllo Automatically include new translation files. Da quel momento in poi, PTC rileverà e monitorerà automaticamente qualsiasi nuovo file di risorse trovato, senza richiederti di confermarlo.
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 automatica 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 bisogno di creare alcuno script.
Meno lavoro manuale
PTC fa risparmiare tempo di sviluppo e accelera le release monitorando il tuo repository e aggiornando i file di traduzione man mano che esegui il push delle modifiche.
Maggiore accuratezza 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 mobile e 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 una merge request, senza richiedere alcun passaggio di consegne manuale.
I formati comuni nei progetti software e mobile, 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 mobile.
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: paghi solo per le parole che traduci e le prime 500 parole di ogni mese sono gratuite. 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.