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를 앱 이름이나 패키지명으로 사용할 수 없다.
저장소 보기 ↗github.com