Pixel Prop Builder: Упрощенное преобразование OTA в build.prop

Легко извлекайте и управляйте системными свойствами из OTA-обновлений Pixel с помощью этого надежного набора инструментов автоматизации. Разработанный как для разработчиков, так и для энтузиастов, он упрощает процесс доступа и настройки свойств сборки Android.

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

Предварительные требования

• Unix-подобная среда: Linux или macOS с Bash.

• Основные утилиты: Убедитесь, что установлены следующие:

  • dos2unix, aria2, zip, unzip, p7zip, curl

• Python ^3.8:

  root@kitploit:~

  sudo apt-get update -y
  sudo apt-get install python3 python3-pip python3-venv -y
  

Установка

1. Клонируйте репозиторий (включая подмодули):

   root@kitploit:~

   git clone --recurse https://github.com/Pixel-Props/build.prop && cd build.prop
   

2. Создайте и активируйте виртуальное окружение (опционально, но рекомендуется):

   root@kitploit:~

   python3 -m venv .venv
   . .venv/bin/activate
   

3. Установите зависимости:

   root@kitploit:~

   python3 -m pip install payload_dumper --break-system-packages
   

Использование

1. Получите образы Pixel: Загрузите нужные заводские или OTA-образы с Google Android Images или страниц бета-OTA.
2. Будьте в курсе обновлений:
   • Загрузите последние OTA-образы с помощью ./download_latest_ota_build.sh <имя_устройства1> <имя_устройства2> ... (например, husky, felix_beta, cheetah, akita_beta15).
3. Простое извлечение:
   • Поместите загруженные файлы образов в рабочую область проекта.
   • Выполните ./extract_images.sh, чтобы автоматически извлечь образы и их свойства сборки в result/Codename_ID ....
4. Простая интеграция модуля:
   • Выполните ./build_module.sh, чтобы автоматически объединить и собрать ваш модуль из каталога result/.

✨ Ключевые возможности

• Автоматическое получение OTA: Загружает последние сборки напрямую из официальных источников Google.
• Бесшовное извлечение образов: Извлекает системные образы как из заводских образов, так и из OTA-обновлений.
• Генерация build.prop: Автоматически создает файлы build.prop из извлеченных системных образов.
• Возможности модулей Magisk:
  • service.sh:
    • Безопасный режим: Предотвращает случайное изменение критических системных настроек путем сравнения свойств модуля с существующими системными значениями.
    • Интегрированные функции мода Sensitive Props: Включает все функции мода Sensitive Props и отключает их, если также присутствует автономный модуль, чтобы избежать конфликтов.
    • PIHooks (PropImitationHooks): Мощная внутренняя система подмены свойств, которая динамически устанавливает важные свойства на основе свойств модуля, определенного в MOD_PROP_CONTENT, который подменяется.
      • Автоматическое отключение PIHooks: PIHooks интеллектуально отключается, когда обнаруживает правильно настроенный модуль Play Integrity Fix.
      • Выборочная интеграция build.prop: PIHooks использует значения из реального build.prop вашего устройства только при установке определенных свойств, например, начальной версии SDK, когда эти значения считаются безопасными и необходимыми.
  • action.sh:
    • PlayIntegrityFix: Автоматически создает конфигурацию PIF.json при использовании бета-OTA. Предоставляет возможности загрузить готовые конфигурации или просканировать страницы OTA Google для создания списка устройств для построения конфигурации.
    • TrickyStore: Автоматически создает список пакетов целевых приложений и обрабатывает некорректный статус TEE.
• Интеграция с GitHub Actions:
  • Запланированные рабочие процессы: Автоматизируйте обновления, сборки и релизы по расписанию.
  • Предотвращение дублирования релизов: Предотвращает избыточные релизы с помощью интеллектуальных проверок.
  • Уведомления в Telegram: Получайте своевременные обновления о процессах сборки.
• Будущие улучшения:
  • Pixel.Features: Добавлена поддержка сборки функций, специфичных для Pixel (в настоящее время включает sysconfigs).

📝 Рекомендации по ответственному использованию

Этот проект предоставляется в образовательных и экспериментальных целях. Несмотря на то, что он разработан для эффективной работы, важно использовать его ответственно.

• Проверка кода: Тщательно изучите и поймите код перед его развертыванием в любой среде.
• Лучшие практики безопасности: Соблюдайте отраслевые стандарты безопасности и требования законодательства.

Создатели этого проекта не несут ответственности за любое неправомерное использование или ущерб, возникший в результате его использования.

---

Готовы упростить свой рабочий процесс настройки Android? Погружайтесь и открывайте возможности автоматического извлечения build.prop! Приветствуются вклады для улучшения функциональности и охвата проекта.