Repolode
roro2239

roro2239/Stellar

Android 앱이 ADB 또는 root를 통해 시스템 수준 API를 사용하도록 지원하는 Shizuku의 대폭 커스터마이징된 fork로, 세분화된 권한과 Shizuku 호환성 레이어를 제공합니다.

스타
1,777
포크
66
열린 이슈
27
마지막 커밋
20일 전

어떤 프로젝트인가요?

Stellar는 앱이 직접 root 권한을 보유하지 않고도 시스템 수준 권한이 필요한 API를 호출할 수 있게 해 주는 Android 프레임워크 Shizuku의 fork입니다. ADB 무선 디버깅이나 root를 통해 Stellar 서비스를 시작하면, 권한을 부여받은 앱이 서비스를 통해 권한이 필요한 호출을 수행할 수 있습니다.

Stellar는 upstream Shizuku와 달리 권한을 핵심 서비스 권한, 앱의 생명주기를 서비스에 연동하는 시작 시 실행 권한 등으로 더 세분화합니다. 부팅 시 실행 옵션, 서비스와 guardian 프로세스가 서로를 재시작하는 daemon 모드, root 권한을 shell 사용자(uid 2000)로 낮추는 모드도 추가했습니다. 또한 Shizuku API를 대상으로 작성된 앱을 코드를 변경하지 않고 Stellar에서 실행할 수 있도록 호환성 레이어를 포함합니다.

프로젝트는 Kotlin으로 작성되었으며 Material Design 3를 적용해 새롭게 설계한 manager UI를 포함합니다. 개발자는 JitPack을 통해 배포되는 Stellar-API 라이브러리로 연동할 수 있으며, 저장소에는 Shizuku에서 마이그레이션하는 연동 가이드가 제공됩니다.

핵심 기능

  • 01ADB 무선 디버깅이나 root를 통해 권한이 필요한 서비스를 시작합니다.
  • 02핵심 권한과 시작 시 실행 권한을 분리한 세분화된 권한 모델을 제공합니다.
  • 03기존 Shizuku 앱을 코드 변경 없이 실행할 수 있도록 Shizuku API 호환성 레이어를 제공합니다.
  • 04더 안전하게 사용할 수 있도록 root 권한을 shell 권한(uid 2000)으로 낮추는 옵션을 제공합니다.
  • 05예기치 않게 종료된 경우 서비스와 guardian 프로세스가 서로를 재시작하는 daemon 모드를 제공합니다.
  • 06newProcess() 및 runtime permission grant/revoke 같은 deprecated Shizuku 기능을 다시 활성화합니다.

활용 사례

  • 기기를 root할 필요 없이 시스템 API를 사용해야 하는 Android 유틸리티를 개발할 때.
  • 기존 Shizuku 기반 앱을 추가 권한 제어 기능이 있는 fork로 마이그레이션할 때.
  • Stellar의 시작 옵션을 통해 부팅 시 실행되는 자동화 도구나 시스템 튜닝 도구를 구동할 때.

빠른 시작

  1. 1

    JitPack 의존성 com.github.roro2239:Stellar-API:latest.release를 추가합니다

  2. 2

    AndroidManifest에서 StellarProvider를 구성합니다

  3. 3

    Stellar를 초기화하고 권한을 요청합니다

  4. 4

    Stellar API를 호출해 권한이 필요한 작업을 수행합니다

사용 전 알아둘 점

  • 서비스는 ADB 무선 디버깅 또는 root 액세스를 통해 시작해야 합니다.
  • rish 및 Sui 지원과 같은 일부 Shizuku 기능이 제거되어 완전한 드롭인 대체품은 아닙니다.

포함된 컬렉션

토픽

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

자주 묻는 질문

Stellar은(는) 무엇인가요?
Android 앱이 ADB 또는 root를 통해 시스템 수준 API를 사용하도록 지원하는 Shizuku의 대폭 커스터마이징된 fork로, 세분화된 권한과 Shizuku 호환성 레이어를 제공합니다. Stellar는 앱이 직접 root 권한을 보유하지 않고도 시스템 수준 권한이 필요한 API를 호출할 수 있게 해 주는 Android 프레임워크 Shizuku의 fork입니다. ADB 무선 디버깅이나 root를 통해 Stellar 서비스를 시작하면, 권한을 부여받은 앱이 서비스를 통해 권한이 필요한 호출을 수행할 수 있습니다.
Stellar은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Stellar은(는) MPL-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Stellar은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Stellar의 마지막 커밋은 2026년 10월 18일입니다.
Stellar은(는) 어디에 사용할 수 있나요?
기기를 root할 필요 없이 시스템 API를 사용해야 하는 Android 유틸리티를 개발할 때. 기존 Shizuku 기반 앱을 추가 권한 제어 기능이 있는 fork로 마이그레이션할 때. Stellar의 시작 옵션을 통해 부팅 시 실행되는 자동화 도구나 시스템 튜닝 도구를 구동할 때.
Stellar는 어떻게 설치하나요?
JitPack 의존성 com.github.roro2239:Stellar-API:latest.release를 추가합니다 AndroidManifest에서 StellarProvider를 구성합니다 Stellar를 초기화하고 권한을 요청합니다 Stellar API를 호출해 권한이 필요한 작업을 수행합니다
Stellar은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/roro2239/Stellar

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트