# react-native: gt.config.json
URL: https://generaltranslation.com/ru/docs/react-native/api/config/gt-config-json.mdx
---
title: gt.config.json
description: Файл gt.config.json
---

{/* СГЕНЕРИРОВАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого измените template в content/docs-templates/. */}


## Обзор

Файл `gt.config.json` хранит конфигурацию вашего проекта.
В нём содержится важная информация, например `projectId` проекта, поддерживаемые локали и многое другое.
Также в нём хранится важная внутренняя информация, например `versionId` проекта.

Этот файл используется (1) компонентом [`<GTProvider>`](/docs/react-native/api/components/gtprovider) и (2) командой [`gt translate`](/docs/cli/translate).
Поэтому мы рекомендуем хранить конфигурацию в `gt.config.json`, а не передавать её через prop в компонент [`<GTProvider>`](/docs/react-native/api/components/gtprovider).

Как правило, всё, что начинается с подчёркивания (например, `_versionId`), — это внутреннее свойство, и его не следует изменять.
Всё остальное можно менять.

***

## Поля

| Поле                | Тип        | Описание                                                                  |
| ------------------- | ---------- | ------------------------------------------------------------------------- |
| `projectId`         | `string`   | Уникальный идентификатор проекта в системе GT                             |
| `locales`           | `string[]` | Массив поддерживаемых кодов локалей для вашего проекта                    |
| `defaultLocale`     | `string`   | Основной код локали, используемый как резервный, если перевод отсутствует |
| `cacheUrl`          | `string`   | URL конечной точки для кэширования данных перевода                        |
| `runtimeUrl`        | `string`   | URL конечной точки для сервисов перевода времени выполнения              |
| `stageTranslations` | `boolean`  | Настройка функций промежуточных и предварительных переводов               |
| `files`             | `object`   | Путь к локальным файлам перевода для разработки и тестирования            |
| `_versionId`        | `string`   | Внутреннее свойство для отслеживания версии проекта (не изменяйте)        |

### `cacheUrl` и `runtimeUrl`

Если вы храните переводы в облаке, `cacheUrl` — это базовый URL кэша.
`runtimeUrl` — это базовый URL времени выполнения и используется только для переводов в режиме разработки.

### `stageTranslations`

`stageTranslations` — это флаг, который инструмент `gt` использует, чтобы пометить ваши переводы как требующие проверки.
Это означает, что они должны быть вручную утверждены, прежде чем их можно будет развернуть в production с помощью команды [`gt translate`](/docs/cli/translate).

### `files`

Поле `files` задаёт путь к переводам, которые хранятся локально, а не в облаке.
В частности, поле `output` указывает, куда будут записываться переводы.

```json
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}
```

Подробнее об использовании поля `files` см. в [справке по настройке CLI](/docs/cli/reference/config).


#### `parsingFlags`

Объект `files.gt.parsingFlags` управляет тем, как компилятор разбирает ваши исходные файлы.

| Flag                     | Type      | Default | Description                                                                                                                                                                                              |
| ------------------------ | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false` | Автоматически оборачивает переводимый текст JSX в компоненты перевода на этапе сборки. См. [auto JSX injection](/docs/cli/features/auto-jsx-injection).                                                  |
| `autoderive`             | `boolean` | `false` | Автоматически обрабатывает интерполированные значения в вызовах `t()`, `gt()` и `msg()` как вызовы [`derive()`](/docs/react-native/api/strings/derive). См. [autoderive](/docs/cli/features/autoderive). |

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json",
      "parsingFlags": {
        "enableAutoJsxInjection": true,
        "autoderive": true
      }
    }
  }
}
```

{/* 
  ### `_versionId`

  Ключевые моменты:
  - внутренний параметр
  - можно указывать собственные названия версий */}

***

## Примеры

### Указание локалей

```json title="gt.config.json"
{
  "defaultLocale": "en", // Основная локаль — английский
  "locales": ["fr", "es"] // Дополнительные локали — французский и испанский
}
```

{/* ### Указание собственного versionId */}

***


## Примечания

* Файл `gt.config.json` используется для задания конфигурации проекта.
* Его читают и компонент [`<GTProvider>`](/docs/react-native/api/components/gtprovider), и команда [`gt translate`](/docs/cli/translate).
* Его следует разместить в корне проекта.

## Следующие шаги