モバイル デベロッパーは多くの場合、一度にすべてを開発するのではなく、アプリの UI を一つずつ開発します。Android Studio では、Jetpack Compose でこの方法を採用しており、検査、値の変更、最終結果の検証に完全なビルドを必要としないツールを提供しています。
ライブ編集
ライブ編集は、エミュレータと物理デバイスでコンポーザブルをリアルタイムで更新できる機能です。アプリの作成環境とビルド環境の切り替えが最小限に抑えられるため、コードの作成により長く集中できるようになります。
ライブ編集には次の 3 つのモードがあります。
- 手動: Ctrl+\(macOS では Command+\)を使用して手動でプッシュすると、コード変更が適用されます。
- 手動保存: コードの変更は、Ctrl+S(macOS では Command+S)を使用して手動で保存した場合に適用されます。
- 自動: コンポーズ可能な関数を更新すると、デバイスまたはエミュレータに変更が適用されます。
ライブ編集は、UI および UX 関連のコード変更に重点を置いています。メソッド シグネチャの更新、新しいメソッドの追加、クラス階層の変更などの変更はサポートしていません。詳しくは、ライブ編集の制限事項のリストをご覧ください。
この機能は、アプリの作成と実行や Apply Changes の代替ではなく、Compose UI の開発におけるビルド、デプロイ、反復のワークフローを最適化するためのものです。
ベスト プラクティスのワークフローは次のとおりです。
- アプリをセットアップして実行できるようにします。
- ライブ編集でサポートされない変更(アプリ実行中の新しいメソッドの追加など)を行う必要性が生じるまで、可能な限りの変更をライブ編集で行います。
- サポートされていない変更を行った後、実行アイコン をクリックしてアプリを再起動し、ライブ編集を再開します。
ライブ編集を使ってみる
まず、以下の手順で空の Compose アクティビティを作成し、プロジェクトのライブ編集を有効にしてから、ライブ編集で変更を加えます。
新しいプロジェクトをセットアップする
始める前に、Android Studio Giraffe 以降がインストールされていることと、実機またはエミュレータの API レベルが 30 以上であることを確認してください。
Android Studio を開き、[Welcome to Android Studio] ダイアログで [New Project] を選択します。すでにプロジェクトを開いている場合は、[File] > [New] > [New Project] に移動して新しいプロジェクトを作成できます。
[Phone and Tablet] の [Empty Compose Activity] テンプレートを選択し、[Next] をクリックします。
[New Project] ダイアログで必要な情報をすべて入力します。具体的には、名前、パッケージ名、保存場所、最小 SDK、ビルド構成の言語です。
[Finish] をクリックします。
ライブ編集を有効にする
設定に移動してライブ編集を有効にします。
- Windows または Linux の場合、[File] > [Settings] > [Editor] > [Live Edit] に移動します。
- macOS の場合、[Android Studio] > [Settings] > [Editor] > [Live Edit] に移動します。
設定で [Live Edit] オプションを選択し、実行するモードを選びます。
手動モードでは、Ctrl+\(macOS では Command+\)を押すたびにコードの変更がプッシュされます。保存時の手動モードでは、Ctrl+S(macOS では Command+S)を使用して手動で保存するたびに、コードの変更が適用されます。自動モードでは、コードの変更はデバイスまたはエミュレータで適用されます。
エディタで、アプリのエントリ ポイントである
MainActivity
ファイルを開きます。実行アイコン をクリックしてアプリをデプロイします。
ライブ編集を有効にすると、[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) ) }
図 4 に示すように、変更はすぐにテストデバイスに反映されます。
ライブ編集のトラブルシューティング
テストデバイスに編集内容が表示されない場合は、Android Studio が編集内容の更新に失敗した可能性があります。ライブ編集インジケーターに、図 5 のようにコンパイル エラーを示す「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] または [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 を使用すると、アプリをエミュレータや実機に再デプロイすることなく、コードとリソースを更新できます(いくつかの制限があります)。
コンポーザブルを追加、変更、削除するときは、[Apply Code Changes] ボタンをクリックして、アプリを再デプロイすることなく更新できます。
あなたへのおすすめ
- 注: JavaScript がオフになっている場合はリンクテキストが表示されます
- アニメーションをカスタマイズする {:#customize-animations}
- 値ベースのアニメーション
- パラメータを追加する