Repolode
Enviar
roro2239

roro2239/Stellar

Fork profundamente personalizado do Shizuku que permite a apps Android usar APIs de nível de sistema via ADB ou root, com permissões mais granulares e uma camada de compatibilidade com o Shizuku.

Ver no GitHub
Estrelas
1,777
Forks
66
Issues abertas
27
Último commit
há 20 dias

O que é?

Stellar é um fork do Shizuku, framework Android que permite aos apps chamar APIs que exigem privilégios de nível de sistema sem que eles próprios precisem de root. Depois que o serviço do Stellar é iniciado por depuração sem fio via ADB ou root, os apps autorizados podem fazer chamadas privilegiadas por meio dele.

Em comparação com o Shizuku original, o Stellar divide as permissões em categorias mais granulares, como uma permissão para o serviço principal e outra para acompanhar a inicialização, que vincula o ciclo de vida do app ao serviço. Também adiciona opções de inicialização durante o boot, um modo daemon em que o serviço e um processo guardião reiniciam um ao outro, e um modo que reduz os privilégios de root para os do usuário shell (uid 2000). O projeto também inclui uma camada de compatibilidade para que apps desenvolvidos para a API do Shizuku possam funcionar no Stellar sem alterações no código.

O projeto é escrito em Kotlin e inclui uma interface redesenhada para o gerenciador, em Material Design 3. Desenvolvedores integram o Stellar pela biblioteca Stellar-API, distribuída via JitPack, e o repositório oferece um guia de integração para migrar do Shizuku.

Recursos principais

  • 01Inicia um serviço privilegiado via depuração sem fio do ADB ou root.
  • 02Modelo de permissões granular, com permissões separadas para o serviço principal e para acompanhar a inicialização.
  • 03Camada de compatibilidade com a API do Shizuku, para que apps existentes do Shizuku funcionem sem alterações no código.
  • 04Opção de reduzir os privilégios de root para os do usuário shell (uid 2000), para uma operação mais segura.
  • 05Modo daemon em que o serviço e um processo guardião reiniciam um ao outro após encerramentos inesperados.
  • 06Reativa recursos descontinuados do Shizuku, como newProcess() e a concessão/revogação de permissões em tempo de execução.

Casos de uso

  • Criar utilitários Android que precisam de APIs de sistema sem exigir que o usuário faça root no dispositivo.
  • Migrar um app existente baseado no Shizuku para um fork com controles extras de permissões.
  • Executar ferramentas de automação ou ajuste do sistema que iniciam no boot por meio das opções de inicialização do Stellar.

Início rápido

  1. 1

    Adicione a dependência do JitPack com.github.roro2239:Stellar-API:latest.release

  2. 2

    Configure StellarProvider no AndroidManifest

  3. 3

    Inicialize o Stellar e solicite permissão

  4. 4

    Chame as APIs do Stellar para realizar operações privilegiadas

Antes de usar

  • O serviço precisa ser iniciado por meio da depuração sem fio do ADB ou com acesso root.
  • Alguns recursos do Shizuku, como o suporte a rish e Sui, foram removidos; portanto, ele não é um substituto direto completo.

Em coleções

Apps para Android e ferramentas para celular

Tópicos

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

Perguntas frequentes

O que é Stellar?
Fork profundamente personalizado do Shizuku que permite a apps Android usar APIs de nível de sistema via ADB ou root, com permissões mais granulares e uma camada de compatibilidade com o Shizuku. Stellar é um fork do Shizuku, framework Android que permite aos apps chamar APIs que exigem privilégios de nível de sistema sem que eles próprios precisem de root. Depois que o serviço do Stellar é iniciado por depuração sem fio via ADB ou root, os apps autorizados podem fazer chamadas privilegiadas por meio dele.
Stellar é gratuito? Qual é a licença?
Stellar é open source sob a licença MPL-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Stellar ainda é mantido?
Manutenção ativa. O último commit de Stellar foi em 18 de out. de 2026.
Para que posso usar Stellar?
Criar utilitários Android que precisam de APIs de sistema sem exigir que o usuário faça root no dispositivo. Migrar um app existente baseado no Shizuku para um fork com controles extras de permissões. Executar ferramentas de automação ou ajuste do sistema que iniciam no boot por meio das opções de inicialização do Stellar.
Como instalar Stellar?
Adicione a dependência do JitPack com.github.roro2239:Stellar-API:latest.release Configure StellarProvider no AndroidManifest Inicialize o Stellar e solicite permissão Chame as APIs do Stellar para realizar operações privilegiadas
Onde consigo Stellar?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/roro2239/Stellar

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados