run-as

読み取りのみ

あるアプリ自身の uid でコマンドを実行します。root なしで debuggable ビルドのプライベートファイルを読む方法です。

コマンド: adb shell run-as
コマンド: システムとログ
リスク: 読み取りのみ

構文

run-as <package> <command> [<args>]

フラグと引数

トークン	意味
<package>	身元を借りるアプリ。インストール済みで、マニフェストで debuggable と宣言されている必要があります。

使用例

```
run-as com.example.debug id
```
プローブ：実際になった uid を印字するので、答えが単に無言ではなく検証可能になります。
```
run-as com.example.debug ls databases/
```
アプリの SQLite ファイルを一覧します。作業ディレクトリは既にアプリのホームです。
```
run-as com.example.debug cat databases/app.db > /sdcard/app.db
```
取り出せる場所にデータベースを複製します。

出力の読み方

実行したコマンドが印字するものがそのまま出ます。拒否は `run-as` 自身から来て、3 つのうちどれが起きたかを教えます。パッケージが debuggable でない、パッケージが不明、あるいはそもそもこのビルドにヘルパーがない。

出力フィールド

フィールド	意味
uid=10234(u0_a234) …	`id` のプローブが成功：あなたはいまそのアプリです。
…is not debuggable	リリースビルドです。root なしにできることはなく、これはプラットフォームが正しく働いている姿です。
unknown package	打ち間違い、またはこのユーザーにアプリがインストールされていません。
run-as: not found	ビルドにヘルパーがありません。まれですが起こります。

バージョンとメーカーに関する注意

これはマニフェストで debuggable を宣言したアプリでしか動かず、実際には自分のアプリの debug ビルドを意味します。Play ストアのアプリは拒否され、その拒否は不具合ではなくセキュリティモデルです。
コマンドはアプリのホームディレクトリで始まるので、`databases/app.db` のような相対パスを使います。他のアプリのディレクトリに向ける手段はありません。
アプリが開いている最中のデータベースを複製すると、書きかけの状態を写し取ることがあります。中身が重要なら先にアプリを止めてください。

これには UI があります

Android ADB Toolbox はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android ADB Toolbox を開く

コマンド	何をするか
logcat	システムログを流し読みします。端末で起きていることすべての実況です。
dumpsys dropbox	クラッシュ、ANR、tombstone を保持するプラットフォームのリングバッファ。root なしで ANR トレースを読む方法です。
pm path	インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。

他のシステムとログコマンド

コマンド	何をするか
top	1 回分のプロセス表：CPU 使用率、メモリ、状態、コマンドライン。
getprop	システムプロパティを表示します。端末自身が語る「これは何か」です。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。

自分の端末では出力が違って見えるのはなぜ？

Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。

端末ではなくブラウザから実行できますか？

多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文