この記事は2017年に動画で解説したものに、2026年11月に文の解説を足しました(2026年11月21日時点の情報。公式ドキュメントで確かめています)。
作ったプログラムを1行ずつ動かして、どう動いているかを確かめたいときは、止めたい行に ブレークポイント を置き、アプリを Debug(デバッグモード) で動かします。
手順だけ先に書くと、こうなります。
- 止めたい行の、行番号の右の余白(ガター)をクリックして、赤い丸(ブレークポイント)を付ける
- ツールバーの Debug ‘app’ のボタンでアプリを動かす
- アプリがその行で止まったら、Step Over で1行ずつ進めながら、変数の中身を見る
Run で動かすとブレークポイントは素通りされ、Debug で動かしたときだけ止まります。 デバッグモードの使い方の芯は、ここなんです。
もくじ
Run と Debug の違い
Android Studio には、アプリを動かすボタンが2つあります。
- Run ‘app’:アプリをふつうに動かす。ブレークポイントを置いていても止まらない
- Debug ‘app’:デバッガー(プログラムを途中で止めて中を見る道具)をつないで動かす。ブレークポイントの行で止まる
公式の Codelab には、はじめからデバッガーを使うとわかっているなら、Debug で動かす方が時間の節約になる、と書かれています。
Run で動かしたあとに「やっぱり止めて見たい」となったときは、Attach Debugger to Android Process のボタンで、動いているアプリにあとからデバッガーをつなげます(出てくる画面で、自分のアプリを選んで OK)。
デバッグモードで動かすには、2つの条件があります(公式の Debug your app より)。
- 端末のデバッグが有効になっていること:エミュレーターは、はじめから有効です。実機は、端末の開発者向けオプションでデバッグを有効にします
- デバッグできるビルドで動かすこと:Android Studio のプロジェクトには、はじめから「debug」のビルドがあり、ふつうはこれで動きます。自分で新しいビルドの種類を足したときは、そのビルドに
isDebuggable = true(Kotlin のビルドスクリプトの場合)を書く必要があります
ブレークポイントを置いてアプリを止める
ブレークポイントは「ここで一度止まって」という目印です。
- 止めたい行の、行番号のすぐ右の余白(ガター)をクリックする。赤い丸が付けば置けている
- キーで置くなら、その行にカーソルを置いて、Windows は
Ctrl+F8、Mac は⌘+F8(Android Studio のもとになっている IntelliJ IDEA の説明書より。キーの割り当ては設定によって変わることがあります) - Debug ‘app’ でアプリを動かし、その行を通る操作(ボタンを押すなど)をする
- 止まると、画面の下に Debug の窓が開く
外すときは、赤い丸をもう一度クリックします。
置くのは、実際に動く行です(IntelliJ IDEA の説明書でも「実行される行」に置く、と書かれています)。
決まった条件のときだけ止める
くり返しの中に置くと、回るたびに止まって先に進みにくくなります。
そういうときは、その行を右クリックして Add Conditional Breakpoint を選び、止まる条件(たとえば i == 50)を書きます。条件に合ったときだけ止まります(IntelliJ IDEA の説明書より)。
1行ずつ動かす(Step Over・Step Into・Step Out)
止まったあとは、Debug の窓のボタンで、プログラムを少しずつ進めます。公式の Codelab で使われている名前は次のとおりです。
| ボタン | すること |
|---|---|
| Step Over | 次の行へ1行進む。その行でメソッドを呼んでいても、メソッドの中には入らない |
| Step Into | その行で呼んでいるメソッドの中に入って、中の1行目で止まる |
| Step Out | Step Into で入ったメソッドを最後まで動かして、呼んだ側に戻る |
| Resume Program | 次のブレークポイントまで、ふつうに動かす(なければ最後まで) |
| Stop | デバッグをやめる |
1行ずつ見たいときは、基本は Step Over をくり返します。
「このメソッドの中で何が起きてるねん?」と思ったら、その行で Step Into を押して中に入ります。
ボタンの形や並びは、Android Studio の版で変わることがあります。キーの割り当ても設定によって異なるので、ボタンの上にマウスを乗せて名前を確かめてください。
止めた所で変数の中身を見る
デバッグモードのいちばんの使いどころは、止めた時点で、変数にどんな値が入っているかを見られることです。
Debug の窓の Debugger のタブには、公式の Codelab の説明では3つの欄があります。
- Frames:今どのメソッドの中で止まっているか(呼ばれてきた順)
- 式を書いて評価したり、見張りたい式(ウォッチ)を足したりする欄
- Variables:今の時点の変数と、その値
となりの Console のタブには、Logcat の出力(ログ)が出ます。
例:正答率が0になる
たとえば、10問中7問正解の正答率を出したいのに、画面に「0%」と出るとします。
val correct = 7
val total = 10
val rate = correct / total * 100
textView.text = "正答率は${rate}%"4行目にブレークポイントを置いて Debug で動かし、止まった所で Variables の欄を見ると、rate が 0 になっているのがわかります。
correct も total も整数(Int)なので、7 / 10 の答えが小数にならず、0 になる。だから100を掛けても0のままなんです。
原因がわかれば、直し方は2つあります。
// 先に100を掛けてから割る(整数のまま)
val rate = correct * 100 / total// 小数に変えてから割る(型の変換)
val rate = correct.toDouble() / total * 100エラーは出ないのに思った値にならない、こういう間違いは、コードを眺めているだけでは気づきにくいものです。
(エラーの種類については、こちらの記事でも書いていますので、よろしければご覧ください)
ログとの使い分け
止めずに、通った所と値を流して見たいときは、デバッグログ(Log.d)を使います。ログで当たりをつけて、怪しい所にブレークポイントを置いて止める、という順で使うと、原因にたどり着きやすくなります。
(デバッグログの出し方については、こちらの記事でも書いていますので、よろしければご覧ください)
この動画でわかること
- Runモードで動かす場合とDebugモードで動かす場合の違い
- プログラムを1行ずつ動かす方法
- ブレークポイントを設定してプログラムを途中で止める方法
動画は2017年の収録で、画面が今と違う所があります。
今(2026年)のやり方との違い
Run と Debug の違い、ブレークポイントで止めて1行ずつ動かすという考え方と手順は、動画のころと同じです。動画の Kotlin のコードでのやり方も、今もそのまま使えます。
変わったのは、次の所です。
- 画面の見た目:Debug の窓の作り(Debugger と Console のタブ・ボタンの形と並び)は、動画のころと違います。ボタンの名前(Step Over など)で探してください
- Compose の画面:今は画面を Jetpack Compose で作るのが主流です。Compose の関数の中にもブレークポイントは置けます。公式の Codelab には、
rememberを使った変数は、Variables の欄でresult$delegateのように名前の後ろに$delegateが付いて出る、と書かれています。「変数が見つからへん」と思ったら、この形を探してください
(Flutter のアプリを Android Studio で止めて、変数を見る方法については、こちらの記事でも書いていますので、よろしければご覧ください)
(Flutter のデバッグモードと、ほかの2つのモードの違いについては、こちらの記事でも書いていますので、よろしければご覧ください)
まとめ
参考:Debug your app(Android Developers、2026年11月21日確認)/Use the debugger in Android Studio(Android Developers の Codelab、2026年11月21日確認)/Breakpoints(IntelliJ IDEA Help、2026年11月21日確認)/Step through the program(IntelliJ IDEA Help、2026年11月21日確認)
何かのお役に立てれば幸いです。
- プログラムを1行ずつ動かすには、止めたい行にブレークポイントを置き、Debug ‘app’ で動かす
- Run で動かすとブレークポイントでは止まらない。動いているアプリには、Attach Debugger to Android Process であとからつなげる
- ブレークポイントは、行番号の右の余白をクリックして置く(キーなら Windows は Ctrl + F8、Mac は ⌘ + F8)。くり返しの中なら条件付きにする
- 止まったら、Step Over で1行ずつ、Step Into でメソッドの中へ、Step Out で呼んだ側へ、Resume Program で次のブレークポイントまで
- 止めた所で Variables の欄を見ると、エラーの出ない計算の間違い(整数どうしの割り算など)が見つけやすい
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。








