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

title: gt download
description: Скачивание готовых переводов из General Translation. Справочник API для команды gt download.

---

Скачивает готовые переводы, которые ранее были отправлены на перевод с помощью [`gt enqueue`](/docs/cli/reference/commands/enqueue) или [`gt stage`](/docs/cli/reference/commands/stage), и сохраняет их по путям вывода, указанным в вашей конфигурации. См. [Управление переводами](/docs/cli/guides/managing-translations#split).

*Примечание: только для использования в Production. Требуются `GT_API_KEY` и `GT_PROJECT_ID` для Production.*

```bash
npx gt download
```

## Как это работает [#how-it-works]

1. Читает `gt.config.json`, чтобы определить конфигурацию файлов.
2. Читает данные подготовленной версии, если включён `stageTranslations`; в противном случае собирает файлы и вычисляет их хеши, чтобы определить, что нужно скачать.
3. Опрашивает API General Translation, чтобы узнать, какие переводы уже готовы.
4. Сохраняет файлы перевода по путям вывода, указанным в вашей конфигурации.

## Флаги [#flags]

`download` принимает полный набор флагов [`gt translate`](/docs/cli/reference/commands/translate#flags), кроме флагов сканирования source (`--src`, `--dictionary`, `--tsconfig`/`--jsconfig`, `--inline`, `--ignore-errors`), которые используются только при сканировании исходного кода. Поддерживаются все перечисленные ниже флаги; на запуск, предназначенный только для скачивания, влияют флаги API, config, timeout, download и branch.

| Параметр                     | Описание                                                                              | Тип        | Необязательно | По умолчанию     |
| ---------------------------- | ------------------------------------------------------------------------------------- | ---------- | ------------- | ---------------- |
| `--api-key <key>`            | production API key.                                                                   | `string`   | Да            | `GT_API_KEY`     |
| `--project-id <id>`          | project ID.                                                                           | `string`   | Да            | `GT_PROJECT_ID`  |
| `--version-id <id>`          | ID версии для скачивания.                                                             | `string`   | Да            | Хэш content      |
| `-c, --config <path>`        | Путь к config file.                                                                   | `string`   | Да            | `gt.config.json` |
| `--default-locale <locale>`  | Исходная локаль проекта.                                                              | `string`   | Да            | `en`             |
| `--locales <locales...>`     | Дополнительные целевые локали, добавляемые к locales из config.                       | `string[]` | Да            | —                |
| `--timeout <seconds>`        | Тайм-аут ожидания в секундах.                                                         | `number`   | Да            | `900`            |
| `--dry-run`                  | Выполнить разбор и проверку без вызова API.                                           | `boolean`  | Да            | `false`          |
| `--force`                    | Сбросить кэш переводов и перевести заново.                                            | `boolean`  | Да            | `false`          |
| `--force-download`           | Перезаписать локальные файлы, пропуская проверки `gt-lock.json`.                      | `boolean`  | Да            | `false`          |
| `--save-local`               | Обнаружить и сохранить local edits перед скачиванием.                                 | `boolean`  | Да            | `false`          |
| `--publish`                  | Опубликовать переводы в CDN.                                                          | `boolean`  | Да            | `false`          |
| `--enable-branching`         | Включить отслеживание на основе branch.                                               | `boolean`  | Да            | —                |
| `--branch <branch>`          | Имя branch вместо автоопределения.                                                    | `string`   | Да            | —                |
| `--disable-branch-detection` | Использовать только указанную branch, без определения связей.                         | `boolean`  | Да            | `false`          |
| `--remote-name <name>`       | Git remote, используемый для определения branch.                                      | `string`   | Да            | `origin`         |
| `--tag [value]`              | Пометить запуск tag; если значение не указано, оно автоматически определяется из git. | `string`   | Да            | —                |
| `-m, --message <message>`    | Сообщение, прикреплённое к tag перевода.                                              | `string`   | Да            | —                |

`download` также принимает экспериментальные флаги, перечисленные в разделе [`gt translate`](/docs/cli/reference/commands/translate#experimental) (например, `--experimental-clear-locale-dirs`, который очищает каталоги локалей перед записью новых переводов).

## Пример [#example]

```bash
# Этап 1: загрузка исходных файлов
npx gt upload

# Этап 2: постановка переводов в очередь
npx gt enqueue

# Этап 3: скачивание готовых переводов (эта команда)
npx gt download
```

## Другие замечания [#notes]

* Когда включён `stageTranslations`, `download` использует данные подготовленной версии; иначе он собирает файлы и вычисляет их хеши, чтобы определить, что нужно скачать.
* `download` опрашивает API, пока переводы не будут готовы или пока не истечёт `--timeout`, поэтому его можно запускать в более поздней задаче CI, чем [`gt enqueue`](/docs/cli/reference/commands/enqueue).