73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
# Unity Localization
|
||
|
||
## Зачем это нужно
|
||
|
||
`Unity Localization` нужен для локализации строк, ассетов и выбора языков проекта.
|
||
|
||
## Как установить
|
||
|
||
1. Открой `Window > Package Manager`.
|
||
2. Переключи список на `Unity Registry`.
|
||
3. Найди `Localization`.
|
||
4. Нажми `Install`.
|
||
|
||
Если будешь добавлять пакет вручную по имени, используй:
|
||
|
||
```text
|
||
com.unity.localization
|
||
```
|
||
|
||
## Что важно перед настройкой
|
||
|
||
`Localization` тесно завязан на `Addressables`, поэтому сначала лучше установить и инициализировать `Addressables`.
|
||
|
||
## Как настроить после установки
|
||
|
||
### 1. Создать Localization Settings
|
||
|
||
1. Открой `Edit > Project Settings > Localization`.
|
||
2. Нажми `Create`.
|
||
|
||
### 2. Создать локали
|
||
|
||
1. В том же окне нажми `Locale Generator`.
|
||
2. Добавь хотя бы базовый набор локалей для проекта.
|
||
|
||
Для старта проекта обычно достаточно:
|
||
|
||
- `Russian (ru)`
|
||
- `English (en)`
|
||
|
||
### 3. Назначить locale по умолчанию
|
||
|
||
После создания локалей укажи, какая локаль должна использоваться по умолчанию.
|
||
|
||
### 4. Создать таблицы локализации
|
||
|
||
1. Открой `Window > Asset Management > Localization Tables`.
|
||
2. Создай хотя бы одну `String Table Collection`.
|
||
3. Добавь в нее стартовые UI-строки.
|
||
|
||
## Минимальная практическая настройка для проекта
|
||
|
||
Для первого этапа достаточно:
|
||
|
||
- создать `Localization Settings`
|
||
- добавить `ru` и `en`
|
||
- завести одну строковую таблицу
|
||
- локализовать один тестовый UI-текст
|
||
|
||
Если локализуешь UI-компонент, Unity позволяет повесить на него локализацию через `Localize`.
|
||
|
||
## Как проверить, что всё настроено
|
||
|
||
- в `Project Settings` создан `Localization Settings` asset
|
||
- есть минимум две локали
|
||
- создана хотя бы одна `String Table Collection`
|
||
- тестовый UI-текст меняется при смене локали
|
||
|
||
## Официальные источники
|
||
|
||
- https://docs.unity.cn/Packages/com.unity.localization%401.4/manual/QuickStartGuide.html
|
||
- https://docs.unity.cn/Manual/com.unity.localization.html
|