# gt: General Translation CLI tool: gt download
URL: https://generaltranslation.com/it/docs/cli/reference/commands/download.mdx
---

title: gt download
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.

## 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 <key>`            | Chiave API di produzione.                                                                             | `string`   | Sì          | `GT_API_KEY`       |
| `--project-id <id>`          | ID progetto.                                                                                          | `string`   | Sì          | `GT_PROJECT_ID`    |
| `--version-id <id>`          | ID della versione da scaricare.                                                                       | `string`   | Sì          | hash del contenuto |
| `-c, --config <path>`        | Percorso del file di configurazione.                                                                  | `string`   | Sì          | `gt.config.json`   |
| `--default-locale <locale>`  | Impostazione regionale sorgente del progetto.                                                         | `string`   | Sì          | `en`               |
| `--locales <locales...>`     | Impostazioni regionali di destinazione aggiuntive, aggiunte ai `locales` della configurazione.        | `string[]` | Sì          | —                  |
| `--timeout <seconds>`        | Timeout di attesa in secondi.                                                                         | `number`   | Sì          | `900`              |
| `--dry-run`                  | Analizza e valida senza chiamare l&#39;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`               | Rileva e salva le modifiche locali prima del download.                                                | `boolean`  | Sì          | `false`            |
| `--publish`                  | Pubblica le traduzioni sulla CDN.                                                                     | `boolean`  | Sì          | `false`            |
| `--enable-branching`         | Abilita il tracciamento basato sui branch.                                                            | `boolean`  | Sì          | —                  |
| `--branch <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 <name>`       | Remote Git usato per il rilevamento del branch.                                                       | `string`   | Sì          | `origin`           |
| `--tag [value]`              | Etichetta l&#39;esecuzione; se non viene fornito alcun valore, viene ricavato automaticamente da Git. | `string`   | Sì          | —                  |
| `-m, --message <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&#39;hash per determinare cosa scaricare.
* `download` interroga l&#39;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).