反復型コード開発

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

AI を活用した UI の反復

Android Studio の AI エージェントを使用すると、デザイン プレビューから直接 Compose UI を反復的に改良して変換できます。Compose プレビューを右クリックして、次のいずれかの [AI Actions] を選択します。

• [Match UI to target image] を選択して、参照デザインのモックをアップロードします。 エージェントは、実装をデザインにできるだけ近づけるためのコード変更を提案します。

• [Transform UI] を選択して、自然言語プロンプト（「 ボタンの色を青に変更」など）を使用して、UI に加える特定の変更を記述します。

ライブ編集

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

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

• 手動: Control+'（macOS の場合は Command+'）を使用して手動でプッシュすると、コードの変更が適用されます。
• 保存時に手動: Control+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. 設定で [ライブ編集] オプションを選択し、実行するモードを選びます。

   手動モードでは、 Control+'（macOS の場合は Command+'）を押すたびにコードの変更がプッシュされます。保存時に手動モードでは、 キーを押して手動で保存するたびに、コードの変更が適用されます。 Control+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

図 6 に示すように、変更は瞬時にテストデバイスに表示されます。

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

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

ライブ編集の制限事項

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

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

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

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

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

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

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

• ライブ編集で変更したクラスでデバッガを機能させるには、本番実行を行う必要があります。

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

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

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

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

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

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

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

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

• Apply Changes/Apply Code Changes はライブ編集と互換性がなく、実行中のアプリを再起動する必要があります。

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

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

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

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

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

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

• ライブ編集を使わない方がよいのはどのような場合ですか？

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

• Compose プレビューを使うのはどのような場合ですか？

  個々のコンポーザブルを開発する場合に、Compose プレビューを使用します。プレビューは、Compose 要素を視覚化し、コードの変更を反映するように自動的に更新します。さらに、さまざまな構成や状態（ダークテーマ、ロケール、フォント スケールなど）での UI 要素の表示もサポートしています。

Compose を使用した反復型コード開発

Compose Multiplatform のライブ編集とホットリロードは、Compose での開発において時間を節約し、生産性を高めることができる機能です。ただし、 これらの機能はさまざまなタイプの開発のニーズに対応しています。

• ライブ編集は、Jetpack Compose を使用した Android アプリケーション の反復開発をサポートしています。エミュレータと実機でコンポーザブルをリアルタイムに更新できます。アプリの作成環境とビルド環境の切り替えが最小限に抑えられるため、コードの作成により長く集中できるようになります。

• Compose ホットリロードは 同じニーズに対応しますが、 Compose Multiplatform でビルドされたデスクトップ アプリケーション をサポートします。Compose Multiplatform アプリケーションの UI コードを変更すると、コードが変更されるたびにインテリジェントに再読み込みされ、結果がリアルタイムで表示されます。

これらの 2 つの機能は、Compose エンジン内で多くのテクノロジーを共有し、 多くの同様のユースケースをサポートしていますが、適用される Compose 開発のタイプが異なるため、同じ機能はありません 。

Android アプリを開発する場合は、ライブ編集を使用して開発プロセスを加速させる必要があります 。Compose Multiplatform を使用してデスクトップ アプリケーションを開発する場合は、Compose ホットリロードを使用する必要があります。

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

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

• Int
• String
• Color
• Dp
• Boolean

リテラル UI インジケーターのライブ編集を使用してリテラル装飾を有効にすることにより、コンパイル ステップなしでリアルタイム更新をトリガーする定数リテラルを確認できます。

Apply Changes

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

コンポーザブルを追加、変更、削除してから [Apply Code Changes] ボタンをクリックすることで、再デプロイすることなくアプリを更新できます。