Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

アプリをビルドして実行する

Android Studio では、Android Emulator や接続されたデバイスへデプロイするための新規プロジェクトの設定が、わずか数回クリックするだけで完了します。アプリのインストール後は、Apply Changes を使用して、新しい APK を作成せずに特定のコードとリソースの変更をデプロイできます。

アプリをビルドして実行する手順は次のとおりです。

  1. ツールバーで、実行構成のプルダウン メニューからアプリを選択します。
  2. ターゲット デバイスのプルダウン メニューから、アプリを実行するデバイスを選択します。

    ターゲット デバイスのプルダウン メニュー

    構成済みのデバイスがない場合は、USB 経由でデバイスを接続するか、AVD を作成して Android Emulator を使用する必要があります。

  3. 実行アイコン をクリックします。

実行 / デバッグ構成の変更

アプリを初めて実行するとき、Android Studio はデフォルトの実行構成を使用します。実行構成では、アプリを APK と Android App Bundle のどちらからデプロイするかに加え、実行するモジュール、デプロイするパッケージ、開始するアクティビティ、ターゲット デバイス、エミュレータ設定、logcat オプションなどを指定します。

デフォルトの実行 / デバッグ構成では、APK をビルドしてデフォルトのプロジェクト アクティビティを起動し、[Select Deployment Target] ダイアログでターゲット デバイスを選択できます。このデフォルトの設定が自身のプロジェクトやモジュールに合わない場合は、実行またはデバッグ用の構成をカスタマイズする、あるいはプロジェクト、デフォルト、モジュール レベルで新規に作成することも可能です。実行またはデバッグ用の構成を編集するには、[Run] > [Edit Configurations] を選択します。詳細については、実行 / デバッグ構成の作成と編集をご覧ください。

ビルド バリアントの変更

実行アイコンをクリックすると、Android Studio はデフォルトでデバッグ版のアプリをビルドして実行します。これは開発中にのみ使用するためのバージョンです。

Android Studio が使用するビルド バリアントを変更するには、[Build] > [Select Build Variant] を選択します。

ネイティブ / C++ コードのないプロジェクトの場合、[Build Variants] パネルには、[Module] と [Active Build Variant] という 2 つの列があります。モジュールの [Active Build Variant] 値により、IDE で接続済みのデバイスにデプロイされ、エディタで表示されるビルド バリアントが決定されます。

図 1. ネイティブ / C++ コードを含まないプロジェクトの場合、[Build Variants] パネルには 2 つの列が表示される

バリアントを切り替えるには、モジュールの [Active Build Variant] セルをクリックし、リスト フィールドから目的のバリアントを選択します。

ネイティブ / C++ コードを使用するプロジェクトの場合、[Build Variants] パネルには、[Module]、[Active Build Variant]、[Active ABI] の 3 つの列が表示されます。モジュールの [Active Build Variant] 値により、IDE で接続済みのデバイスにデプロイされ、エディタで表示されるビルド バリアントが決定されます。ネイティブ モジュールの場合は、[Active ABI] 値によってエディタが使用する ABI が決定されますが、デプロイされるものには影響しません。

図 2. ネイティブ / C++ コードを含むプロジェクトの場合、[Build Variants] パネルには、[Active ABI] 列が追加される

ビルド バリアントまたは ABI を変更するには、[Active Build Variant] または [Active ABI] 列のセルをクリックし、リストから目的のバリアントまたは ABI を選択します。値を変更すると、IDE によりプロジェクトが自動的に同期されます。アプリまたはライブラリ モジュールのいずれかの列を変更すると、すべての依存行に変更が適用されます。

新規プロジェクトにはデフォルトで、debug と release の 2 つのビルド バリアントがセットアップされます。アプリの公式リリースを準備する際には、リリース バリアントをビルドする必要があります。

追加のビルド バリアントを定義して、それぞれ異なる機能またはデバイス要件を持つアプリの他のバリエーションをビルドできます。

プロジェクトのビルド

実行ボタン を押すことにより、アプリのビルドとデバイスへのデプロイが実行されます。ただし、共有または Google Play へアップロードするアプリをビルドする場合、[Build] メニューのオプションのいずれかを使用して、プロジェクトの一部または全部をコンパイルする必要があります。最初に使用するビルド バリアントを選択してから、表 1 にリストされているビルド オプションのいずれかを選択してください。

表 1. [Build] メニューのビルド オプション。

メニュー項目 説明
Make Module 最後のビルド以降に変更された、選択したモジュール内のすべてのソースファイル、および選択したモジュールが再帰的に依存するすべてのモジュールをコンパイルします。コンパイルには、依存ソースファイルと、関連するビルドタスクが含まれます。[Project] ウィンドウでモジュール名またはそのファイルのいずれかを選択することにより、ビルドするモジュールを選択できます。このコマンドは APK を生成しません。
Make Project すべてのモジュールをコンパイルします。
Clean Project すべての中間ビルドファイルおよびキャッシュ ビルドファイルを削除します。
Rebuild Project 選択したビルド バリアントに対して Clean Project を実行し、APK を生成します。
Build Bundle(s) / APK(s) > Build APK(s)

現在のプロジェクトに含まれるすべてのモジュールにつき、選択したバリアントの APK をビルドします。ビルドが完了すると、確認通知が表示され、APK ファイルへのリンクと APK Analyzer で分析するためのリンクが提供されます。

選択したビルド バリアントが debug ビルドタイプである場合、生成された APK はデバッグキーで署名され、いつでもインストールできます。release バリアントを選択した場合、デフォルトでは APK は署名されないため、手動で APK に署名する必要があります。 メニューバーから [Build] > [Generate Signed Bundle / APK] を選択して、署名済みの APK を生成することも可能です。

Android Studio により、ビルドした APK が project-name/module-name/build/outputs/apk/ に保存されます。

Build Bundle(s) / APK(s) > Build Bundle(s)

現在のプロジェクトに含まれるすべてのモジュールにつき、選択したバリアントの Android App Bundle をビルドします。ビルドが完了すると、確認通知が表示され、App Bundle へのリンクと APK Analyzer で分析するためのリンクが提供されます。

選択したビルド バリアントが debug ビルドタイプである場合、デバッグキーで署名された App Bundle が生成され、bundletool を使用して App Bundle から、接続されたデバイスにアプリをデプロイできます。release バリアントを選択した場合、App Bundle はデフォルトで署名されていないため、jarsigner を使用して手動で署名する必要があります。 メニューバーから [Build] > [Generate Signed Bundle / APK] を選択して、署名済みの App Bundle を生成することも可能です。

Android Studio により、ビルドした APK が project-name/module-name/build/outputs/bundle/ に保存されます。

Generate Signed Bundle / APK ウィザードのダイアログを表示して、新しい署名構成をセットアップし、署名済みの App Bundle または APK をビルドします。Play Console にアップロードする前に、リリースキーでアプリに署名する必要があります。アプリ署名の詳細については、アプリの署名をご覧ください。

注: 実行ボタン をクリックすると、testOnly="true" でアプリがビルドされます。これは、Android Studio が使用する adb を介してのみ APK をインストールできることを意味します。ユーザーが adb なしでインストールできるデバッグ可能な APK が必要な場合は、debug バリアントを選択し、[Build Bundle(s) / APK(s)] > [Build APK(s)] をクリックします。

Gradle が各コマンドに対して実行するタスクの詳細を確認するには、次のセクションの説明に沿って [Build] ウィンドウを開きます。Gradle とビルドプロセスの詳細については、ビルドを設定するをご覧ください。

ビルドプロセスのモニタリング

ビルドプロセスの詳細を確認するには、[View] > [Tool Windows] > [Build] をクリックするか、ツールバーでビルドアイコン をクリックします。ウィンドウに、アプリをビルドするために Gradle が実行するタスクが表示されます(図 3 を参照)。

図 3. Android Studio のビルド出力ウィンドウ

  1. [Build] タブ: Gradle が実行するタスクがツリー形式で表示されます。各ノードは、ビルドフェーズまたはタスクの依存関係のグループを表します。ビルド時またはコンパイル時のエラーが発生した場合は、図 4 に示すように、ツリーを調べて要素を選択し、エラー出力を確認します。

    図 4. エラー メッセージ用ビルド出力ウィンドウを調べる

  2. [Sync] タブ: プロジェクト ファイルと同期するために Gradle が実行するタスクが表示されます。[Build] タブと同様に、同期エラーが発生した場合は、ツリー内の要素を選択して、エラーに関する詳細情報を確認します。
  3. 再スタート: プロジェクト内の全モジュールの中間ビルドファイルが生成されます。[Build] >[Make Project] を選択した場合と同じアクションが実行されます。
  4. ビュー切り替え: タスクの実行をグラフィカル ツリーとして表示するか、Gradle からの詳細なテキスト出力を表示するかを切り替えます。テキスト出力は、Android Studio 3.0 以前の Gradle Console ウィンドウ に表示される出力と同じです。

ビルド バリアントでプロダクト フレーバーを使用している場合、Gradle はそのプロダクト フレーバーをビルドをするためのタスクも起動します。使用可能なすべてのビルドタスクのリストを表示するには、[View] > [Tool Windows] > [Gradle] をクリックするか、ツール ウィンドウバーの Gradle アイコン をクリックします。

ビルドプロセス中にエラーが発生した場合、Gradle は --stacktrace--debug など、問題の解決に役立つコマンドライン オプションを推奨する場合があります。ビルドプロセスにコマンドライン オプションを使用する方法は以下のとおりです。

  1. [Settings] または [Preferences] ダイアログを開きます。
    • Windows または Linux では、メニューバーから [File] > [Settings] を選択します。
    • Mac OSX では、メニューバーから [Android Studio] > [Preferences] を選択します。
  2. [Build, Execution, Deployment] > [Compiler] に移動します。
  3. [Command-line Options] の隣にあるテキスト フィールドに、コマンドライン オプションを入力します。
  4. [OK] をクリックして保存し、終了します。

Gradle は、次回アプリをビルドするときにこれらのコマンドライン オプションを適用します。

Apply Changes

Android Studio 3.5 以降で Apply Changes を使用すると、アプリを再起動せずに、場合によっては現在のアクティビティを再起動せずに、コードとリソースの変更を実行中のアプリにプッシュできます。この優れた適応性により、小さな追加変更のテストやデプロイのために何度もアプリを再起動する必要がなくなり、デバイスの状態に影響を及ぼすこともなくなります。Apply Changes では、Android 8.0(API レベル 26)以降を搭載しているデバイスでサポートされる Android JVMTI 実装の機能を使用します。Apply Changes の動作の詳細については、Android Studio Project Marble: Apply Changes をご覧ください。

要件

Apply Changes のアクションは、次の条件を満たす場合にのみ使用できます。

  • debug ビルド バリアントを使用して、アプリの APK をビルドする。
  • Android 8.0(API レベル 26)以降を搭載するターゲット デバイスまたはエミュレータにアプリをデプロイする。

Apply Changes の使用

互換性のあるデバイスに変更をデプロイする場合は、次のオプションを使用します。

変更を適用してアクティビティを再スタート 「変更を適用してアクティビティを再スタート」アイコン

アプリを再起動せずにアクティビティを再起動して、リソースとコードの両方の変更を適用することを試みます。一般に、メソッドの本体のコードを変更したり、既存のリソースを変更したりした場合にこのオプションを使用できます。

このアクションは、Ctrl+Alt+F10(macOS では Control+Shift+Command+R)を押して実行することもできます。

コードの変更を適用 「コードの変更を適用」アイコン

何も再起動せずにコードの変更のみを適用することを試みます。一般に、メソッドの本体のコードを変更したが、リソースを変更していない場合に、このオプションを使用できます。コードとリソースの両方を変更した場合は、代わりに変更を適用してアクティビティを再スタートアイコンを使用します。

このアクションは、Ctrl+F10(macOS では Control+Command+R)を押して実行することもできます。

実行 実行アイコン

すべての変更をデプロイし、アプリを再起動します。いずれの Apply Changes オプションを使用しても変更を適用できない場合に、このオプションを使用します。アプリの再起動が必要な変更の種類の詳細については、Apply Changes の制限をご覧ください。

Apply Changes に対する代替実行を有効にする

変更を適用してアクティビティを再スタートアイコンまたはコードの変更を適用アイコンをクリックすると、Android Studio は新しい APK をビルドし、変更を適用できるかどうかを判断します。変更を適用できず、Apply Changes が失敗する可能性がある場合は、代わりに実行ボタン 実行アイコン をクリックしてアプリをもう一度実行するよう求めるメッセージが表示されます。ただし、この状況が発生するたびにメッセージを表示したくない場合は、変更を適用できないときに自動的にアプリを再実行するよう Android Studio を設定することができます。

この動作を有効にする手順は次のとおりです。

  1. [Settings] ダイアログまたは [Preferences] ダイアログを開きます。

    • Windows または Linux の場合、メニューバーから [File] > [Settings] を選択します。
    • macOS の場合、メニューバーから [Android Studio] > [Preferences] を選択します。
  2. [Build, Execution, Deployment] > [Deployment] に移動します。

  3. チェックボックスを選択して、Apply Changes アクションのいずれかの自動代替実行を有効にします。

  4. [OK] をクリックします。

Apply Changes の制限

Apply Changes は、アプリのデプロイ過程を迅速化するように設計されています。ただし、使用できる場合にはいくつかの制限があります。Apply Changes の使用中に問題が発生した場合は、バグとして報告してください。

アプリの再起動が必要なコードの変更

次のような一部のコードとリソースの変更は、アプリを再起動するまで適用できません。

  • メソッドやフィールドの追加や削除
  • メソッド シグネチャの変更
  • メソッドやクラスの修飾子の変更
  • クラス継承の変更
  • 列挙型内の値の変更
  • リソースの追加や削除
  • アプリ マニフェストの変更
  • ネイティブ ライブラリ(SO ファイル)の変更

ライブラリとプラグイン

一部のライブラリとプラグインは、アプリのマニフェスト ファイルまたはマニフェストで参照されているリソースを自動的に変更します。これらの自動更新は、次のように Apply Changes に干渉する可能性があります。

  • ライブラリまたはプラグインがアプリのマニフェストに変更を加えた場合、コードの変更を適用アイコン 「コードの変更を適用」アイコン または変更を適用してアクティビティを再スタートアイコン 「変更を適用してアクティビティを再スタート」アイコン を使用できないため、変更を反映するにはアプリを再起動する必要があります。
  • ライブラリまたはプラグインがアプリのリソース ファイルに変更を加えた場合、コードの変更を適用アイコン 「コードの変更を適用」アイコン は使用できないため、変更を反映するには変更を適用してアクティビティを再スタートアイコン 「変更を適用してアクティビティを再スタート」アイコン を使用する必要があります。

debug ビルド バリアントのすべての自動更新を無効にすることで、これらの制限を回避できます。

たとえば、Crashlytics は、ビルドごとにアプリリソースを一意のビルド ID で更新します。これにより、コードの変更を適用アイコン 「コードの変更を適用」アイコン を使用できなくなるため、変更を反映するにはアプリのアクティビティを再起動する必要があります。自動更新を無効にすると、debug ビルドで Crashlytics とともにコードの変更を適用アイコンを使用できるようになります。

インストールされた APK のコンテンツを直接参照するコード

デバイスにインストールされているアプリの APK のコンテンツをコードが直接参照している場合、コードの変更を適用アイコン 「コードの変更を適用」アイコン をクリックするとそのコードがクラッシュまたは誤動作を引き起こす可能性があります。この現象は、コードの変更を適用アイコンをクリックすると、参照されているコンテンツを含むデバイス上の APK がインストール中に置き換えられるために発生します。このような場合は、代わりに変更を適用してアクティビティを再スタートアイコン 「変更を適用してアクティビティを再スタート」アイコン または実行アイコン 実行アイコン をクリックします。