[Android Studio]デバッグモードの使い方(ブレークポイントで止めて1行ずつ動かす)

このページには広告が含まれる場合があります。

 

この記事は2017年に動画で解説したものに、2026年11月に文の解説を足しました(2026年11月21日時点の情報。公式ドキュメントで確かめています)。

作ったプログラムを1行ずつ動かして、どう動いているかを確かめたいときは、止めたい行に ブレークポイント を置き、アプリを Debug(デバッグモード) で動かします。

手順だけ先に書くと、こうなります。

  1. 止めたい行の、行番号の右の余白(ガター)をクリックして、赤い丸(ブレークポイント)を付ける
  2. ツールバーの Debug ‘app’ のボタンでアプリを動かす
  3. アプリがその行で止まったら、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 より)。

  1. 端末のデバッグが有効になっていること:エミュレーターは、はじめから有効です。実機は、端末の開発者向けオプションでデバッグを有効にします
  2. デバッグできるビルドで動かすこと:Android Studio のプロジェクトには、はじめから「debug」のビルドがあり、ふつうはこれで動きます。自分で新しいビルドの種類を足したときは、そのビルドに isDebuggable = true(Kotlin のビルドスクリプトの場合)を書く必要があります

 

ブレークポイントを置いてアプリを止める

ブレークポイントは「ここで一度止まって」という目印です。

  1. 止めたい行の、行番号のすぐ右の余白(ガター)をクリックする。赤い丸が付けば置けている
  2. キーで置くなら、その行にカーソルを置いて、Windows は Ctrl + F8、Mac は ⌘ + F8(Android Studio のもとになっている IntelliJ IDEA の説明書より。キーの割り当ては設定によって変わることがあります)
  3. Debug ‘app’ でアプリを動かし、その行を通る操作(ボタンを押すなど)をする
  4. 止まると、画面の下に 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 OutStep Into で入ったメソッドを最後まで動かして、呼んだ側に戻る
Resume Program次のブレークポイントまで、ふつうに動かす(なければ最後まで)
Stopデバッグをやめる

1行ずつ見たいときは、基本は Step Over をくり返します。

「このメソッドの中で何が起きてるねん?」と思ったら、その行で Step Into を押して中に入ります。

ボタンの形や並びは、Android Studio の版で変わることがあります。キーの割り当ても設定によって異なるので、ボタンの上にマウスを乗せて名前を確かめてください。

 

止めた所で変数の中身を見る

デバッグモードのいちばんの使いどころは、止めた時点で、変数にどんな値が入っているかを見られることです。

Debug の窓の Debugger のタブには、公式の Codelab の説明では3つの欄があります。

  1. Frames:今どのメソッドの中で止まっているか(呼ばれてきた順)
  2. 式を書いて評価したり、見張りたい式(ウォッチ)を足したりする欄
  3. 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 の欄を見ると、エラーの出ない計算の間違い(整数どうしの割り算など)が見つけやすい

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

人気No.1

前向きな気持ちになれる 占星術・タロットリーディング

あすコロ式・相談サロン 【ナビるやん】

人に言えない悩みから使命・運勢診断まで、あなたに寄り添いながら“ナビゲート”する、あすコロ人気No.1のオンライン相談サロン。占星術・心理学・タロットの叡智を活かし、普段認識していない「潜在意識」にアクセスしてあなたの気づいていない可能性を拓かせ、明日から前向きに歩めるようになる60分のリーディングセッション。

今すぐ詳細を見る(メルマガ登録で初回半額) ▶

TOP