TelemetryCleaner — Shizuku連携でプリインストールモジュールを管理するツール
Eynnzerr/TelemetryCleaner
★ 1,015 ・ Kotlin ・ MIT
概要
TelemetryCleaner は、中国市場向け(いわゆる国行)Android端末に初期状態で組み込まれている通信キャリア向け管理コンポーネントやテレメトリ(データ収集)モジュールを検出し、root権限を取得することなくアンインストールや復元を行うためのオープンソースAndroidアプリケーションです。
一部の端末メーカーのファームウェアには、SystemHelper や RegService といった名称のシステムコンポーネントが組み込まれています。これらはバックグラウンドで定期的に動作し、端末情報やネットワーク情報の収集を行うケースがありますが、ランチャーにアプリアイコンが存在せず、通常のOS設定画面からは権限の剥奪やアプリの無効化・アンインストールができない仕様になっていることがあります。学術研究(WiSec 2023)や作者自身によるパケット・コード解析でも、インストール済みアプリ一覧や端末識別子の送信挙動が確認されています。
本プロジェクトは、こうしたモジュールの状態(インストール状況や付与されている権限)を可視化し、ユーザー自身で整理できるように設計されています。同時に、Androidのパッケージ管理の内部構造やIPC(プロセス間通信)の仕組みを理解・学習するためのリファレンスとしても公開されています。
主な特徴
- Shizuku連携による非rootでの操作: 端末をroot化することなく、Shizuku経由で付与されたシェル権限を利用してシステムアプリの管理を行います。
- 組み込みコンポーネントのプリセット検出: 複数メーカー(OPPO、Xiaomi、vivo、Huaweiなど)で採用されている通信キャリア登録・管理コンポーネントのパッケージ名を保持しており、素早く検出できます。
- マルチユーザー(複数空間)への対応: Androidのマルチユーザー機能(仕事用プロファイルやセカンドスペースなど)に対応しており、対象とする空間を指定してアンインストールを実行可能です。
- アンインストール後の復元機能: 完全な消去ではなく、システム領域に残されている元のAPKを利用してアンインストール状態から元の状態へと復元する機能を提供します。
- 高度なフォールバック機構: 一部のカスタムROMで標準の
pmコマンドがブロックされる挙動を検知し、非公開APIを直接叩くことで処理を試行する仕組みを備えています。 - 定期的な自動クリーン機能: 指定した周期で対象モジュールの状態を監視し、自動的に削除処理を適用するオプション(初期設定は無効)も搭載されています。
使い方
動作要件と前提条件
- OSバージョン: Android 10以上(無線デバッグを利用する場合はAndroid 11以上を推奨)
- 必要ツール: Shizukuがインストールされ、稼働していること
セットアップ手順
-
Shizukuのセットアップ 公式のガイドに従い、PCと接続したADB経由、またはAndroid 11以降に搭載されている「無線デバッグ」機能を利用してShizukuサービスを起動します。
-
アプリのインストール GitHubのReleasesページより最新のAPKファイルをダウンロードし、端末にインストールします。
-
権限の付与と空間の選択
TelemetryCleanerを起動し、Shizukuへのアクセス権限をリクエストするダイアログが表示されたら許可します。その後、検査および操作の対象としたいユーザー空間を選択します。 -
検出と個別/一括操作 スキャンが完了すると検出されたコンポーネントが一覧表示されます。各コンポーネントをタップして付与されている権限の詳細を確認したり、チェックボックスで複数選択してアンインストール(または復元)を実行します。
技術的なポイント
Binderを介したPackageManagerへの直接アクセス
通常、シェル権限でアプリを削除する際はADB経由で pm uninstall -k --user 0 のようなコマンドを実行します。しかし、一部のカスタムROM(メーカー独自カスタマイズOS)では、シェルからの pm コマンド呼び出しに対してフックやインターセプト処理を挟み、システムアプリの削除を明示的に拒否する実装が存在します。
これを回避するため、本アプリでは PackageBinder.kt においてShizukuのプロキシ機能を使い、シェルプロセスの権限を保持したまま IPackageManager のBinderインターフェースへ直接RPCを送信しています。これにより、コマンドラインツールのラッパーを迂回してシステムの内部パッケージ管理サービスへリクエストを伝達しています。
app_process を用いたフォールバック処理
ROMによっては、Binder経由のリクエストであっても Failure [only root can delete system app for a particular user] といったエラーを返すケースがあります。
PackageFallback.kt では、このような特定のエラーを受け取った際の代替手段(フォールバック)として、app_process コマンドを用いてJava仮想マシン環境を立ち上げ、非公開APIである IPackageManager.deletePackageAsUser をシェルのコンテキストから直接呼び出す処理を実装しています。もしこのフォールバック処理でも削除に失敗した場合は、フォールバック側のエラーではなく、最初に返された元のシステムエラーを結果画面に表示することで、問題の切り分けが正確に行えるよう配慮されています。
システムAPKの仕組みを利用した復元
本アプリにおける「アンインストール」は、システムパーティション(/system や /vendor 等)そのものを書き換えるものではありません。Androidの deletePackageAsUser API(更新フラグ付き)の仕組みを利用して、対象ユーザー空間におけるアプリのデータと更新分を消去し、未インストール状態としてマークしています。そのため、復元操作を行う際はシステム領域にあらかじめ保持されているオリジナルのAPKを参照して再インストールをかけることが可能となっています。
注意点
- 学習・研究目的のツール: READMEには、通信事業者の正当なネットワーク接続や障害対応の目的を理解した上で、あくまでAndroidシステム内部のパッケージ管理メカニズムを学ぶための学習用プロジェクトである旨が明記されています。
- 機能不全(文鎮化・アプリ不具合)のリスク: システムアプリの無効化・アンインストールは、端末の他の機能に予期せぬ副作用を及ぼす可能性があります。README内の記載によると、実際に「vivo端末で Device Management(
com.vivo.devicereg)を削除したところ、標準の通話録音機能が動作しなくなった」というフィードバックが寄せられています。 - 端末・ベンダーごとの差異: 作者が検証を完了しているのは一部の環境(OPPO系端末およびSystemHelper等)に限られており、XiaomiやHuawei向けモジュールは他ユーザーの報告に基づく検証、その他のメーカー(Honor、Meizu、Nubia等)向けは「未検証」とされています。また、vivo端末の特定の通信キャリアコンポーネントのように、現行バージョンでは削除がサポートされていない(代替として凍結ポリシーの適用が進められている)ものもあります。
- ライセンス: 本リポジトリは MIT ライセンス のもとで公開されています。
まとめ
TelemetryCleaner は、Androidシステム深部に組み込まれた特定のモジュールをShizuku経由で安全かつ柔軟に操作できるKotlin製ユーティリティです。低レイヤーのBinder呼び出しや非公開APIフォールバックなど、Androidのパッケージマネージャーに関する技術的実装を学ぶ上でも興味深いリポジトリとなっています。





