cxzlw / dhizuku-api

API of Dhizuku.

Dhizuku API

English | 简体中文

Dhizuku API is the api of Dhizuku. Used to share device owner from Dhizuku.

Import

def dhizuku_version = "version of api"
implementation "io.github.iamr0s:Dhizuku-API:$dhizuku_version"

Initialize

Initialize the dhizuku-API, call other API interfaces may throws an exception when initialization fails.

Dhizuku.init(context) // return boolean

Request Permission

Some API interfaces require permission to run.

if (Dhizuku.isPermissionGranted()) return

Dhizuku.requestPermission(new DhizukuRequestPermissionListener() {
        @Override
        public void onRequestPermission(int grantResult) throws RemoteException {
            if (grantResult == PackageManager.PERMISSION_GRANTED) {
                // do success code
            }else {
                // do failure code
            }
        }
    });

API interface and changes

Binder Wrapper

IBinder is often used for basic communication between applications and systems. Dhizuku provides an interface for proxy IBinder, the applications can communicate with the system as Dhizuku.

BinderWrapper Demo

User Service

Dhizuku.getVersionCode() >= 3

A simple Service based on the AIDL mechanism that runs in the isolated space provided by Dhizuku.

Usage: Declare an AIDL file, implement it in Service, and then launch it through the interface provided by Dhizuku.

UserService Demo

Delegated Scopes

Dhizuku.getVersionCode() >= 5

Invoking the DevicePolicyManager from either the Binder Wrapper or the User Service can be complicated, but Delegated Scopes can simplify this operation.

Usage: You grant Delegated Scopes to your application, which can then invoke the interface included in the Delegated Scopes itself through DevicePolicyManager.

DelegatedScopes Demo