# gt: General Translation CLI tool: Scaricare
URL: https://generaltranslation.com/it/docs/cli/download.mdx
---
title: Scaricare
description: Come scaricare le traduzioni precedentemente messe in coda o messe in staging
---

## Utilizzo

```bash
npx gt download
```

<Callout type="info">
  **Nota:** Questo comando richiede una chiave API di produzione. Puoi ottenerne una sulla
  [piattaforma](https://generaltranslation.com/dashboard).
</Callout>


## Panoramica

Il comando `gt download` scarica le traduzioni completate precedentemente inviate tramite [`gt enqueue`](/docs/cli/enqueue) o [`gt stage`](/docs/cli/stage).

Il flusso di lavoro tipico è il seguente:

1. [`gt upload`](/docs/cli/upload) — carica i file sorgente sulla piattaforma General Translation
2. [`gt enqueue`](/docs/cli/enqueue) — mette in coda i file caricati per la traduzione
3. **`gt download`** — scarica le traduzioni completate

Questa separazione è utile nelle pipeline CI/CD in cui ogni passaggio avviene in una fase o in un job diverso.

<Callout type="warn">
  **Solo per l&#39;uso in produzione!**

  Questo comando è pensato per le build di produzione e **non deve essere usato in fase di sviluppo**.
  Ricorda di specificare la chiave API di produzione (`GT_API_KEY`) e l&#39;ID del progetto (`GT_PROJECT_ID`) nelle variabili d&#39;ambiente.
</Callout>

## Come funziona

1. Legge `gt.config.json` per determinare la configurazione dei file
2. Se `stageTranslations` è abilitato, legge i dati della versione in staging; altrimenti, raccoglie i file e ne calcola l&#39;hash per determinare cosa scaricare
3. Interroga l&#39;API di General Translation per recuperare le traduzioni completate
4. Scarica e salva i file di traduzione nei percorsi di output specificati nella configurazione

## Flag

Il comando `download` accetta gli stessi flag di [`translate`](/docs/cli/translate#flags).

| Parametro         | Descrizione                                                                    | Tipo     | Facoltativo | Predefinito        |
| ----------------- | ------------------------------------------------------------------------------ | -------- | ----------- | ------------------ |
| `--api-key`       | Specifica una chiave API di produzione                                         | `string` | `true`      |                    |
| `--project-id`    | Specifica l&#39;ID del progetto                                                | `string` | `true`      |                    |
| `--version-id`    | Specifica un ID versione (per impostazione predefinita, un hash del contenuto) | `string` | `true`      |                    |
| `--config <path>` | Specifica il percorso del file di configurazione di GT                         | `string` | `true`      | `"gt.config.json"` |

| `--timeout`                     | Timeout della richiesta, in secondi                                            | `number`   | `true`      | `900`              |
| `--new, --locales <locales>`    | Impostazioni regionali di destinazione in cui tradurre il progetto             | `[string]` | `true`      |                    |
| `--default-locale <locale>`     | L&#39;impostazione regionale di origine del progetto                           | `string`   | `true`      | `en`               |
| `--dry-run`                     | Esegui il comando in modalità simulazione                                      | `flag`     | `true`      | `false`            |
| `--force`                       | Forza il download di tutte le traduzioni, sovrascrivendo le modifiche locali   | `flag`     | `true`      | `false`            |
| `--force-download`              | Forza il download di tutte le traduzioni, sovrascrivendo le modifiche locali   | `flag`     | `true`      | `false`            |

## Esempio: pipeline di CI suddivisa

```bash
# Fase 1: Upload dei file sorgente
npx gt upload

# Fase 2: Accoda le traduzioni
npx gt enqueue

# Fase 3: Scarica quando pronto
npx gt download
```