🚀 Этот open source проект стал основой для GeelyLab — комплексного решения для владельцев Geely Galaxy

GGSL — Geely Galaxy Starship Localization

Локализация системных приложений FlymeAuto для автомобилей Geely Galaxy (Starship 7, Boyue L, E5/EX5 и др.)

О проекте

GGSL — набор патчей и скриптов для перевода встроенных китайских приложений на английский и русский языки.

Мы не разрабатываем приложения с нуля — мы модифицируем существующие APK: декомпилируем, заменяем ресурсы (strings.xml, arrays.xml, layouts), пересобираем и подписываем platform-ключом для установки в /system.

Внимание: Все действия выполняются на ваш страх и риск. Авторы не несут ответственности за возможные повреждения устройства или потерю гарантии. Перед изменениями рекомендуется создать резервные копии.

Скриншоты

Поддерживаемые приложения

Приложение	Описание
AutoClimate	Климат-контроль
AutoDvr	Видеорегистратор
AutoEnergy	Энергопотребление
AutoGallery	Галерея
AutoSceneDirector	Сценарии
AutoSettings	Настройки автомобиля
AutoSystemUIPlugin	Системный UI
SmartButton	Умные кнопки
XCOutCarMedia	Внешний медиаплеер

Требования

• Java (JDK 11+)
• ADB с ROOT-доступом к устройству
• adb root и adb remount должны работать

При первой сборке автоматически скачиваются:

• apktool.jar — декомпиляция/сборка APK
• AOSP platform keys — подпись APK

Быстрый старт

# Клонирование
git clone git@github.com:volkv/Geely-Galaxy-Starship-Localization.git
cd Geely-Galaxy-Starship-Localization

# Сборка одного приложения
make AutoSettings

# Сборка всех приложений
make all

# Только сборка (без установки)
make build-AutoSettings

# Проверка переводов
make lint

Структура проекта

apps/<App>/
  original.apk              # Оригинальный APK (скачивается автоматически)
  languages/
    en/strings.xml          # Английский перевод
    ru/strings.xml          # Русский перевод

tools/
  common.sh                 # Общие функции для скриптов
  lint_strings.py           # Проверка на непереведённые строки
  apktool.jar               # Скачивается автоматически
  keys/                     # Platform keys (скачиваются автоматически)

build/                      # Собранные APK
build.sh                    # Скрипт сборки
install.sh                  # Скрипт установки
Makefile                    # Удобные команды

Как переводить

1. Найдите apps/<App>/languages/ru/strings.xml
2. Переведите строки, сохраняя формат <string name="key">Перевод</string>
3. Не изменяйте структуру JSON-payload'ов для голосовых команд (вида {data:[...]})
4. Запустите make lint для проверки
5. Соберите и протестируйте: make <App>

Пример перевода

<!-- До -->
<string name="climate_auto">自动</string>

<!-- После -->
<string name="climate_auto">Авто</string>

Принцип работы

1. Декомпиляция — apktool извлекает ресурсы из оригинального APK
2. Патчинг — EN переводы копируются в res/values-en/, RU в res/values-ru/
3. Сборка — APK пересобирается с новыми ресурсами
4. Подпись — APK подписывается platform-ключом для системных привилегий

Один APK поддерживает три языка (CN, EN, RU) с автоматическим переключением по системной локали.

Установка

# Требуется ROOT и подключение по ADB
./install.sh AutoSettings

# Или через make
make AutoSettings

Скрипт автоматически:

• Определяет путь APK на устройстве (/system/app или /system/priv-app)
• Заменяет файл
• Перезапускает приложение

Если изменения не появились — перезагрузите устройство: adb reboot

Устранение проблем

Ошибка "adb root failed"

• Устройство должно иметь ROOT-доступ
• Проверьте что adb root работает отдельно

Ошибка "apktool failed"

• Убедитесь что Java установлена: java -version
• Попробуйте удалить tools/apktool.jar и запустить сборку заново

Приложение не изменилось после установки

• Попробуйте adb reboot
• Проверьте системную локаль (должна быть English или Russian)

Оффлайн-сборка

Если нужна сборка без интернета:

1. Заранее скачайте apktool.jar в tools/
2. Скачайте original.apk для нужных приложений
3. Положите platform keys в tools/keys/:
   • platform.pk8
   • platform.x509.pem
   • или готовый platform.p12

Для блокировки автоскачивания:

export GGSL_SKIP_APKTOOL_DOWNLOAD=1
export GGSL_SKIP_KEY_DOWNLOAD=1

Disclaimer

This project is provided "as is" without warranty of any kind. Use at your own risk. The authors are not responsible for any damage to your vehicle's infotainment system, loss of warranty, or any other consequences resulting from the use of this software.

Лицензия

MIT License — см. LICENSE