Repolode
roro2239

roro2239/Stellar

Сильно доработанный форк Shizuku, позволяющий Android-приложениям использовать системные API через ADB или root с более гибкими разрешениями и слоем совместимости с Shizuku.

Звёзды
1,777
Форки
66
Открытые issues
27
Последний коммит
20 дней назад

Что это?

Stellar — форк Shizuku, Android-фреймворка, который позволяет приложениям вызывать API, требующие системных привилегий, не получая root-доступ самостоятельно. После запуска службы Stellar через беспроводную отладку ADB или root-доступ авторизованные приложения могут обращаться к привилегированным API через неё.

В отличие от оригинального Shizuku, Stellar делит разрешения на более узкие категории, например разрешение для основной службы и разрешение на запуск вслед за ней, связывающее жизненный цикл приложения со службой. В проекте появились параметры запуска при загрузке, режим демона, в котором служба и процесс-наблюдатель перезапускают друг друга, а также режим сброса root-привилегий до уровня пользователя shell (uid 2000). Кроме того, предусмотрен слой совместимости, благодаря которому приложения, использующие API Shizuku, работают со Stellar без изменений кода.

Проект написан на Kotlin и включает переработанный интерфейс менеджера в стиле Material Design 3. Разработчики подключают его через библиотеку Stellar-API, распространяемую через JitPack; в репозитории также есть руководство по переходу с Shizuku.

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

  • 01Запускает привилегированную службу через беспроводную отладку ADB или root-доступ.
  • 02Гибкая модель разрешений с отдельными разрешениями для основной службы и запуска вслед за ней.
  • 03Слой совместимости с API Shizuku, позволяющий существующим приложениям Shizuku работать без изменений кода.
  • 04Необязательный сброс root-привилегий до уровня пользователя shell (uid 2000) для более безопасной работы.
  • 05Режим демона, в котором служба и процесс-наблюдатель перезапускают друг друга после неожиданного завершения.
  • 06Повторно включает устаревшие функции Shizuku, такие как newProcess() и выдача или отзыв разрешений во время выполнения.

Сценарии использования

  • Разработка Android-утилит, которым нужны системные API, но для работы которых не требуется root-доступ на устройстве пользователя.
  • Перенос существующего приложения на базе Shizuku на форк с дополнительными настройками разрешений.
  • Запуск при загрузке средств автоматизации или настройки системы с помощью параметров запуска Stellar.

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

  1. 1

    Добавьте зависимость JitPack com.github.roro2239:Stellar-API:latest.release

  2. 2

    Настройте StellarProvider в AndroidManifest

  3. 3

    Инициализируйте Stellar и запросите разрешение

  4. 4

    Вызывайте API Stellar для выполнения операций с привилегиями

Что важно знать

  • Сервис необходимо запускать через беспроводную отладку ADB или с root-доступом.
  • Некоторые функции Shizuku, например поддержка rish и Sui, были удалены, поэтому это не полноценная прямая замена.

В подборках

Темы

#android#shizuku#adb#root#system-api#kotlin#privileged-api

Частые вопросы

Что такое Stellar?
Сильно доработанный форк Shizuku, позволяющий Android-приложениям использовать системные API через ADB или root с более гибкими разрешениями и слоем совместимости с Shizuku. Stellar — форк Shizuku, Android-фреймворка, который позволяет приложениям вызывать API, требующие системных привилегий, не получая root-доступ самостоятельно. После запуска службы Stellar через беспроводную отладку ADB или root-доступ авторизованные приложения могут обращаться к привилегированным API через неё.
Stellar можно использовать бесплатно? Какая у него лицензия?
Stellar распространяется с открытым исходным кодом под лицензией MPL-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Stellar всё ещё поддерживается?
Активно поддерживается. Последний коммит в Stellar — 18 окт. 2026 г..
Для чего можно использовать Stellar?
Разработка Android-утилит, которым нужны системные API, но для работы которых не требуется root-доступ на устройстве пользователя. Перенос существующего приложения на базе Shizuku на форк с дополнительными настройками разрешений. Запуск при загрузке средств автоматизации или настройки системы с помощью параметров запуска Stellar.
Как установить Stellar?
Добавьте зависимость JitPack com.github.roro2239:Stellar-API:latest.release Настройте StellarProvider в AndroidManifest Инициализируйте Stellar и запросите разрешение Вызывайте API Stellar для выполнения операций с привилегиями
Где скачать Stellar?
Исходный код и инструкции по установке — на GitHub: https://github.com/roro2239/Stellar

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Бесплатное приложение с открытым исходным кодом для Android, которое позволяет создавать резервные копии и восстанавливать данные приложений; требуется root-доступ.

7,6 тыс.+51 за неделю338KotlinGPL-3.0Активно поддерживаетсяОбновлён 13 дней назад