GitHub Trending오픈소스 · 도구

RikkaApps/Shizuku

안드로이드 일반 앱에서 ADB/루트 권한으로 시스템 API 호출하기

원제 RikkaApps/Shizuku

스타 33,289당일 +110Kotlin
Key Point

루트 방식을 대체하는 새로운 접근이 왜 필요한지, Shizuku의 동작 원리와 제약사항을 이해해야 시스템 권한이 필요한 안드로이드 앱을 올바르게 개발할 수 있다.

핵심 요약

  • Shizuku는 루트나 ADB 권한이 필요한 안드로이드 앱 개발을 위해 일반 앱에서 직접 시스템 API를 호출할 수 있게 해주는 프레임워크이다.
  • 기존 루트 방식은 su 셸에서 pm enable/disable 같은 명령어를 실행하는데, 이는 프로세스 생성이 느리고 텍스트 처리가 불안정하며 가능한 명령어가 제한적이다.
  • Shizuku는 안드로이드의 Binder IPC 메커니즘을 활용해 app_process로 시작한 자바 프로세스를 통해 시스템 API에 접근한다.
  • 사용자가 루트 또는 ADB 권한으로 Shizuku 서버 프로세스를 먼저 실행하면, 앱 시작 시 Shizuku 서버의 Binder를 앱에 전달한다.
  • Shizuku 서버는 앱 요청을 시스템 서버에 전달하고 결과를 돌려주는 중개자 역할을 하며, ShizukuService의 transactRemote 메서드를 통해 구현된다.
  • ADB 권한은 안드로이드 버전마다 제한적이므로 사용 전 ShizukuService#getUid로 ADB 실행 여부를 확인하거나 checkPermission으로 충분한 권한이 있는지 검사해야 한다.
  • Android 9 이상에서 숨겨진 API 사용이 제한되므로 AndroidHiddenApiBypass 같은 방법을 병행해야 한다.
  • API 26에서는 ADB가 registerUidObserver 권한이 없어서 Activity가 아닌 프로세스에서 Shizuku를 사용하려면 투명 Activity 실행으로 Binder 전송을 트리거해야 한다.
  • transactRemote 직접 사용 시 안드로이드 버전마다 API가 다르고 트랜잭션 코드가 버전에 따라 달라질 수 있으므로 주의가 필요하며, ShizukuBinderWrapper 방식 사용을 권장한다.
  • 프로젝트는 Apache 2.0으로 라이선스되며, 런처 이미지 사용이 금지되고 Shizuku를 앱 이름이나 패키지명으로 사용할 수 없다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗