Начало работы

Установка

1. Перед установкой самой системы, необходимо установить UniTask - инструмент, для многопоточности и асинхронности в Unity. UPM не сможет установить эту зависимость самостоятельно.

2. После того, как UniTask был установлен через UPM, необходимо установить сам пакет через git url: https://github.com/DaniilDGG/DGG-Localization.git.

Процесс установки пакета через UPM:

Настройка

После того, как установка пакета завершена - можно перейти к настройке.

Первым делом, следует задать языки, используемые в файле локализации:

Вместе с этим, после открытия окна, в случае, если ни один загрузчик не смог обнаружить файлы локализации, то будет автоматически создан LocalizationProfile в Resources и пустая локализация в StreamingAssets, по умолчанию это файл localization.loc.

После изменения пути, необходимо нажать Apply. Путь располагается относительно папки StreamingAssets. В случае, если по пути не обнаружен файл, то он будет автоматически создан.

Можно создать дополнительные LocalizationProfile, чтобы разделить локализацию на несколько файлов, если это необходимо.

Важно!

Система не увидит LocalizationProfile, если разместить его вне пределов папки Resources.

Система работает!

После того, как вы создали необходимые файлы локализации и настроили в них необходимые языки, система полностью работоспособна.

Используйте окно локализации, чтобы задать пары ключ-локализация.

После этого, вы можете разместить встроенные компоненты, для локализации ваших текстовых компонентов, либо, если это необходимо, написать собственные реализации.

Вместе с этим, необязательно каждый раз идти к верхнему меню, чтобы открыть окно локализации, достаточно нажать на "Open Localization" и окно сразу откроется с указанным в компоненте ключом локализации.