反復型コード開発

モバイル デベロッパーは多くの場合、アプリの UI を一つひとつ開発するのではなく、 一度にすべてを開発するよりも はるかに簡単ですAndroid Studio では、Jetpack Compose を使用して、検査、値の変更、最終結果の検証にフルビルドを必要としないツールを提供することで、この段階的なアプローチを実現しています。

ライブ編集

ライブ編集は、エミュレータと実機でコンポーザブルをリアルタイムに更新できる機能です。アプリの作成環境とビルド環境の切り替えが最小限に抑えられるため、コードの作成により長く集中できるようになります。

ライブ編集には次の 3 つのモードがあります。

• 手動: 手動で push すると、コード変更が適用されます。 Ctrl+'（macOS では Command+'）
• 保存時に手動: Ctrl+S（macOS では Command+S）を使用して手動で保存すると、コードの変更が適用されます。
• 自動: コンポーズ可能な関数を更新すると、デバイスまたはエミュレータに変更が適用されます。

ライブ編集は、UI および UX 関連のコード変更に重点を置いています。メソッド シグネチャの更新、新しいメソッドの追加、クラス階層の変更などの変更はサポートしていません。詳しくは、ライブ編集の制限事項のリストをご覧ください。

この機能は、アプリの作成と実行や Apply Changes の代替ではなく、Compose UI の開発におけるビルド、デプロイ、反復のワークフローを最適化するためのものです。

ベスト プラクティスのワークフローは次のとおりです。

1. アプリをセットアップして実行できるようにします。
2. ライブ編集でサポートされない変更（アプリ実行中の新しいメソッドの追加など）を行う必要性が生じるまで、可能な限りの変更をライブ編集で行います。
3. ライブ編集ではサポートされていない変更が済んだら、実行アイコン をクリックしてアプリを再起動し、ライブ編集を再開します。

ライブ編集を使ってみる

まず、以下の手順で空の Compose アクティビティを作成し、 プロジェクトのライブ編集を行い、ライブ編集で変更を加える

新しいプロジェクトをセットアップする

1. 始める前に、Android Studio Giraffe 以降がインストールされていることと、実機またはエミュレータの API レベルが 30 以降であることを確認します。

2. Android Studio を開き、[Welcome to Android Studio] ダイアログで [New Project] を選択します。すでにプロジェクトが開いている場合は、[File] > [New] > [New Project] に移動することで新しいプロジェクトを作成できます。

3. [Phone and Tablet] の [Empty Compose Activity] テンプレートを選択し、[Next] をクリックします。

   

4. [New Project] ダイアログで必要な情報をすべて入力します。具体的には、名前、パッケージ名、保存場所、最小 SDK、ビルド構成の言語です。

   

5. [Finish] をクリックします。

ライブ編集を有効にする

1. 設定に移動してライブ編集を有効にします。

   • Windows または Linux の場合、[File] > [Settings] > [Editor] > [Live Edit] に移動します。
   • macOS の場合、[Android Studio] > [Settings] > [Editor] > [Live Edit] に移動します。

2. 設定で [Live Edit] オプションを選択し、実行するモードを選びます。

   手動モードでは、Ctrl+'（macOS では Command+'）キーを押すたびに、コードの変更が push されます。保存時に手動モードの場合、Ctrl+S（macOS では Command+S）キーを押して手動で保存するたびに、コードの変更が適用されます。自動モードでは、変更するごとにデバイスまたはエミュレータでコードの変更が適用されます。

   

3. エディタで、アプリのエントリ ポイントである MainActivity ファイルを開きます。

4. 実行アイコン をクリックしてアプリをデプロイします。

5. ライブ編集を有効にすると、[Running Devices] ツール ウィンドウの右上に「Up-to-date」（最新）という緑色のチェックマークが表示されます。

   

変更を加えて確認する

エディタでサポートされている変更を行うと、仮想テストデバイスまたは物理的なテストデバイスが自動的に更新されます。

たとえば、MainActivity の既存の Greeting メソッドを次のように編集します。 次のとおりです。

@Composable
fun Greeting(name: String) {
    Text(
        text = "Hello $name!",
        Modifier
            .padding(80.dp) // Outer padding; outside background
            .background(color = Color.Cyan) // Solid element background color
            .padding(16.dp) // Inner padding; inside background, around text)
    )
}
IterativeDevelopmentSnippets.kt

図 4 に示すように、変更はすぐにテストデバイスに反映されます。

ライブ編集のトラブルシューティング

編集した内容がテストデバイスで表示されない場合は、Android Studio での編集内容の更新が失敗している可能性があります。ライブ編集のインジケーターが [Out Of Date]（期限切れが期限切れ）の場合（図 5 を参照）。これはコンパイル エラーを示します。エラーの詳細と解決方法の提案については、このインジケーターをクリックしてください。

ライブ編集の制限事項

現在の制限事項は次のとおりです。

• [Android Studio Giraffe 以降にのみ適用] ライブ編集には Compose ランタイム 1.3.0 以降が必要です。プロジェクトで以前のバージョンの Compose を使用している場合、ライブ編集は 無効です。

• [Android Studio Giraffe 以降にのみ適用] ライブ編集には AGP 8.1.0-alpha05 以降が必要です。プロジェクトでそれより前のバージョンの AGP を使用している場合、ライブ編集は無効になります。

• ライブ編集には、API レベルを搭載した実機またはエミュレータが必要です 30 以上。

• ライブ編集は関数本体の編集のみをサポートします。関数名やシグネチャの変更、関数の追加または削除、関数以外のフィールドの変更はできません。

• ライブ編集では、Compose 関数を初めて変更したときにアプリの状態がリセットされます。 できます。これは最初のコード変更後にのみ発生します。アプリの状態は変更されず、 そのファイル内の Compose 関数に対してその後のコード変更によって、リセットされます。

• ライブ編集で変更したクラスは、パフォーマンスが低下することがあります。まず アプリを評価している場合は、クリーンなリリースビルドを使用します。 向上します。

• 実行したクラスをデバッガで処理するには、フル実行を行う必要があります。 ライブ編集で変更されています。

• 実行中のアプリをライブ編集で編集すると、クラッシュする可能性があります。その場合、実行ボタン でアプリを再デプロイできます。

• ライブ編集では、 ビルドファイルの作成、たとえばバイトコード操作など、 [Build] メニューのオプションを使用してプロジェクトをビルドするときに適用される [Build] ボタンまたは [Run] ボタンをクリックします。

• コンポーズ可能な関数は、デバイスまたはエミュレータでライブにアップデートされ、 完全な再コンポーズがトリガーされます。完全な再コンポーズでは、更新された関数が呼び出されない場合があります。コンポーズ可能な関数以外の関数については、新しく更新された関数をトリガーするか、アプリを再度実行する必要があります。

• アプリを再起動してもライブ編集は再開されません。アプリを再度実行する必要があります。

• ライブ編集はデバッグ可能なプロセスにのみ対応しています。

• ライブ編集はビルド構成で kotlinOptions の moduleName にカスタム値を使用しているプロジェクトはサポートしていません。

• マルチデプロイの導入では、ライブ編集は機能しません。つまり、あるデバイスにデプロイ後、別のデバイスにデプロイすることはできません。ライブ編集が有効なのは アプリがデプロイされた前回のデバイスセットです。

• ライブ編集は、マルチデバイス デプロイ（対象デバイスのプルダウンの [Select Multiple Devices] から作成された複数デバイスへのデプロイ）で機能します。ただし、公式にはサポートされておらず、問題が発生する可能性があります。問題が発生した場合は、ご報告ください。

• Apply Changes/Apply Code Changes がライブ編集に対応していない 実行中のアプリを再起動する必要があります。

• ライブ編集は現在、Android Automotive プロジェクトをサポートしていません。

ライブ編集に関するよくある質問

• ライブ編集の現在のステータスを教えてください。

  ライブ編集は Android Studio Giraffe で利用できます。有効にするには、[File] > [Settings] > [Editor] > [Live Edit]（macOS の場合は [Android Studio] > [Settings] > [Editor] > [Live Edit]）に移動します。

• ライブ編集はどのような場合に使うべきですか？

  UX 要素（修飾子の更新やアニメーションなど）の変更がアプリ エクスペリエンス全体に与える影響をすぐに確認したい場合に、ライブ編集を使用します。

• ライブ編集を使用すべきでないのはどのような場合ですか？

  ライブ編集は、UI および UX 関連のコード変更に重点を置いています。メソッド シグネチャの更新、新しいメソッドの追加、クラス階層の変更などの変更はサポートしていません。詳しくは、ライブ配信に関する制限事項 編集。

• Compose プレビューを使用するタイミング

  個々のコンポーザブルを開発する場合は、Compose プレビューを使用します。プレビュー Compose の要素を可視化し、 影響を軽減できます。プレビューでは UI 要素の表示が さまざまな構成や状態（ダークモード、ロケール、フォントなど） スケールできます。

リテラルのライブ編集（非推奨）

Android Studio は、プレビュー、エミュレータ、物理デバイス内のコンポーザブルで使用されている一部の定数リテラルを、リアルタイムで更新できます。サポートされている型は次のとおりです。

• Int
• String
• Color
• Dp
• Boolean

値を指定せずにリアルタイム更新をトリガーする定数リテラルを表示できます。 のライブ編集でリテラル デコレーションを有効にして、コンパイルの手順を説明します。 リテラル UI インジケーター:

Apply Changes

Apply Changes を使用すると、コードとリソースを更新できます。 エミュレータや実機にアプリを再デプロイすることなく 制限事項）。

コンポーザブルを追加、変更、削除するときはいつでも、変更せずにアプリを更新できます。 [コードの変更を適用] ボタンをクリックして再デプロイします。