ホーム>プログラミング関連>その他のソースコード
ダウンロード

しずく

背景

root を必要とするアプリを開発する場合、最も一般的な方法は、su シェルでいくつかのコマンドを実行することです。たとえば、 pm enable/disableコマンドを使用してコンポーネントを有効または無効にするアプリがあります。

この方法には非常に大きな欠点があります。

  1. 非常に遅い(複数のプロセスの作成)
  2. テキストを処理する必要がある (非常に信頼性が低い)
  3. 可能性は利用可能なコマンドに限定されます
  4. ADB に十分な権限がある場合でも、アプリを実行するには root 権限が必要です

雫は全く違うやり方をします。以下の詳細な説明を参照してください。

ユーザーガイドとダウンロード

https://shizuku.rikka.app/

しずくはどのように機能しますか？

まず、アプリがシステム API をどのように使用するかについて説明する必要があります。たとえば、アプリがインストールされているアプリを取得したい場合、 PackageManager#getInstalledPackages()使用する必要があることは誰もが知っています。これは実際にはアプリ プロセスとシステム サーバー プロセスのプロセス間通信 (IPC) プロセスであり、Android フレームワークが内部処理を行っているだけです。

Android はbinder使用してこのタイプの IPC を実行します。 Binder使用すると、サーバー側がクライアント側の uid と pid を学習できるため、システム サーバーはアプリに操作を実行する権限があるかどうかを確認できます。

通常、アプリが使用する「マネージャー」(例: PackageManager ) がある場合、システム サーバー プロセスに「サービス」(例: PackageManagerService ) が存在する必要があります。アプリが「サービス」のbinder保持していれば、「サービス」と通信できると単純に考えることができます。アプリプロセスは、開始時にシステムサービスのバインダーを受け取ります。

Shizuku は、最初に root または ADB を使用してプロセス (Shizuku サーバー) を実行するようにユーザーをガイドします。アプリ起動時に雫サーバーへのbinderもアプリに送信されます。

雫が提供する最も重要な機能は、アプリからのリクエストを受け取り、システムサーバーに送信し、結果を返す仲介者のようなものです。詳細はrikka.shizuku.server.ShizukuServiceクラスのtransactRemoteメソッド、 moe.shizuku.api.ShizukuBinderWrapperクラスを参照してください。

したがって、より高い権限でシステム API を使用するという目標を達成しました。アプリにとっては、システム API を直接使用するのとほぼ同じです。

開発者ガイド

APIとサンプル

https://github.com/RikkaApps/Shizuku-API

v11 より前のバージョンからの移行

もちろん、既存のアプリケーションは引き続き動作します。

https://github.com/RikkaApps/Shizuku-API#migration-guide-for-existing-applications-use-shizuku-pre-v11

注意

  1. ADB 権限は制限されています

    ADB の権限は限られており、システム バージョンによって異なります。ここで、ADB に付与された権限を確認できます。

    API を呼び出す前に、 ShizukuService#getUid使用して Shizuku がユーザー ADB を実行しているかどうかを確認するか、 ShizukuService#checkPermission使用してサーバーに十分な権限があるかどうかを確認できます。

  2. Android 9 からの隠れた API 制限

    Android 9 以降、通常のアプリでは隠し API の使用が制限されています。他の方法 (https://github.com/LSPosed/AndroidHiddenApiBypass など) を使用してください。

  3. Android 8.0 と ADB

    現時点では、Shizuku サービスがアプリ プロセスを取得する方法は、 IActivityManager#registerProcessObserverとIActivityManager#registerUidObserver (26+) を組み合わせて、アプリの起動時にアプリ プロセスが送信されるようにすることです。ただし、API 26 では、ADB にregisterUidObserver使用する権限がないため、アクティビティによって開始されない可能性のあるプロセスで Shizuku を使用する必要がある場合は、透過的なアクティビティを開始して送信バインダーをトリガーすることをお勧めします。

  4. transactRemoteの直接使用には注意が必要です

    • Android のバージョンによって API が異なる場合がありますので、よくご確認ください。また、 android.app.IActivityManagerには API 26 以降の aidl 形式があり、 android.app.IActivityManager$Stub API 26 にのみ存在します。

    • SystemServiceHelper.getTransactionCode 、 android.content.pm.IPackageManager$Stub.TRANSACTION_getInstalledPackages API 25 に存在せず、 android.content.pm.IPackageManager$Stub.TRANSACTION_getInstalledPackages_47があるなど、正しいトランザクション コードを取得できない可能性があります (この状況は対処されています)ただし、他の状況がある可能性を排除するものではありません）。この問題は、 ShizukuBinderWrapperメソッドでは発生しません。

雫本体の開発

建てる

  • git clone --recurse-submodulesでクローンを作成する
  • gradle タスクを実行します:manager:assembleDebugまたは:manager:assembleRelease

:manager:assembleDebugタスクは、デバッグ可能なサーバーを生成します。 shizuku_serverにデバッガーを接続してサーバーをデバッグできます。サーバーが最新のコードを使用するように、Android Studio では、「実行/デバッグ構成」-「常にパッケージ マネージャーを使用してインストールする」にチェックを入れる必要があることに注意してください。

ライセンス

このプロジェクトのコードは、Apache-2.0 ライセンスの下で利用できます。

例外

  • 以下に挙げる画像ファイルをいかなる目的においても使用することを禁止します（雫本体を表示する場合を除く）。 

     manager/src/main/res/mipmap-hdpi/ic_launcher.png
manager/src/main/res/mipmap-hdpi/ic_launcher_background.png
manager/src/main/res/mipmap-hdpi/ic_launcher_foreground.png
manager/src/main/res/mipmap-xhdpi/ic_launcher.png
manager/src/main/res/mipmap-xhdpi/ic_launcher_background.png
manager/src/main/res/mipmap-xhdpi/ic_launcher_foreground.png
manager/src/main/res/mipmap-xxhdpi/ic_launcher.png
manager/src/main/res/mipmap-xxhdpi/ic_launcher_background.png
manager/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.png
manager/src/main/res/mipmap-xxxhdpi/ic_launcher.png
manager/src/main/res/mipmap-xxxhdpi/ic_launcher_background.png
manager/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.png

  • プロジェクト全体としては、無料ではありません。あなたがコンパイルした apk (アプリ名「Shizuku」を別の名前に変更するなどの変更を含む) をストア (IBNLT Google Play ストア、F-Droid、Amazon アプリストアなど) に配布することは禁止されています。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて
ユーザーコメント