# gt: General Translation CLI tool: gt download URL: https://generaltranslation.com/it/docs/cli/reference/commands/download.mdx Docs index: https://generaltranslation.com/llms.txt Description: Scarica le traduzioni completate da General Translation. Riferimento API per il comando gt download. Scarica le traduzioni completate inviate in precedenza per la traduzione con [`gt enqueue`](/docs/cli/reference/commands/enqueue) o [`gt stage`](/docs/cli/reference/commands/stage) e le salva nei percorsi di output definiti nella tua configurazione. Vedi [Gestire le traduzioni](/docs/cli/guides/managing-translations#split). *Nota: solo per l'uso in produzione. Richiede un `GT_API_KEY` di produzione e un `GT_PROJECT_ID`.* ```bash npx gt download ``` ## Come funziona [#how-it-works] 1. Legge `gt.config.json` per determinare la configurazione dei file. 2. Legge i dati della versione in stage quando `stageTranslations` è abilitato; altrimenti raccoglie i file e ne calcola l'hash per determinare cosa scaricare. 3. Interroga periodicamente l'API di General Translation per verificare se le traduzioni sono state completate. 4. Salva i file di traduzione nei percorsi di output specificati nella configurazione. I file ancora in elaborazione vengono ignorati. Esegui nuovamente `gt download` per recuperarli in seguito. ## Flag [#flags] `download` accetta l'intero set di flag di [`gt translate`](/docs/cli/reference/commands/translate#flags), esclusi i flag per la scansione del sorgente (`--src`, `--dictionary`, `--tsconfig`/`--jsconfig`, `--inline`, `--ignore-errors`), che si applicano solo durante la scansione del codice sorgente. Tutti i flag seguenti sono accettati; quelli che influiscono su un'esecuzione limitata al download sono i flag API, di configurazione, timeout, download e branch. | Parametro | Descrizione | Tipo | Facoltativo | Predefinito | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------- | ----------- | ------------------ | | `--api-key ` | Chiave API di produzione. | `string` | Sì | `GT_API_KEY` | | `--project-id ` | ID progetto. | `string` | Sì | `GT_PROJECT_ID` | | `--version-id ` | ID della versione da scaricare. | `string` | Sì | hash del contenuto | | `-c, --config ` | Percorso del file di configurazione. | `string` | Sì | `gt.config.json` | | `--default-locale ` | Impostazione regionale sorgente del progetto. | `string` | Sì | `en` | | `--locales ` | Impostazioni regionali di destinazione aggiuntive, aggiunte ai `locales` della configurazione. | `string[]` | Sì | — | | `--timeout ` | Timeout di attesa in secondi. | `number` | Sì | `900` | | `--dry-run` | Analizza e valida senza chiamare l'API. | `boolean` | Sì | `false` | | `--force` | Invalida le traduzioni in cache e le traduce di nuovo. | `boolean` | Sì | `false` | | `--force-download` | Sovrascrive i file locali, ignorando i controlli di `gt-lock.json`. | `boolean` | Sì | `false` | | `--save-local, --no-save-local` | Accettato dal parser di flag condiviso, ma non salva le modifiche durante un'esecuzione limitata al download. | `boolean` | Sì | `false` | | `--publish` | Pubblica le traduzioni sulla CDN. | `boolean` | Sì | `false` | | `--enable-branching` | Abilita il tracciamento basato sui branch. | `boolean` | Sì | — | | `--branch ` | Nome del branch invece del rilevamento automatico. | `string` | Sì | — | | `--disable-branch-detection` | Usa solo il branch specificato, senza rilevamento delle relazioni. | `boolean` | Sì | `false` | | `--remote-name ` | Remote Git usato per il rilevamento del branch. | `string` | Sì | `origin` | | `--tag [value]` | Etichetta l'esecuzione; se non viene fornito alcun valore, viene ricavato automaticamente da Git. | `string` | Sì | — | | `-m, --message ` | Messaggio associato al tag di traduzione. | `string` | Sì | — | `download` accetta anche i flag sperimentali elencati in [`gt translate`](/docs/cli/reference/commands/translate#experimental) (ad esempio `--experimental-clear-locale-dirs`, che svuota le directory delle impostazioni regionali prima di scrivere le nuove traduzioni). ## Esempio [#example] ```bash # Fase 1: carica i file sorgente npx gt upload # Fase 2: accoda le traduzioni npx gt enqueue # Fase 3: scarica le traduzioni completate (questo comando) npx gt download ``` ## Altre note [#notes] * Quando `stageTranslations` è abilitato, `download` legge i dati della versione in stage; altrimenti raccoglie i file e ne calcola l'hash per determinare cosa scaricare. * `download` interroga l'API finché le traduzioni non sono pronte o finché non viene raggiunto `--timeout`, quindi può essere eseguito in un job CI successivo rispetto a [`gt enqueue`](/docs/cli/reference/commands/enqueue). * Un file in stage rimane in stage in `gt-lock.json` finché tutte le impostazioni regionali configurate non sono state scaricate. * `_versionId` è obbligatorio solo quando il download include un template GTJSON inline e `omitConfigIds` è `false`. I progetti contenenti solo file, inclusi i progetti contenenti solo Lottie, non ne hanno bisogno. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.