このページでは、Watch Face Format を使用するウォッチフェイスの構造と、そのビルド方法およびデプロイ方法について説明します。
WFF ウォッチフェイスの構造
Watch Face Format のウォッチフェイスは、他のアプリと同様に AAB または APK として Google Play ストアに送信されます。そのため、AndroidManifest.xml ファイルが必要であるなど、他のアプリと共通する属性が多くありますが、独自の構造も備えています。
- ウォッチフェイスのすべてのコンテンツは、リソース フォルダ(
res/)にあります。 - すべてのウォッチフェイス定義は
res/raw/にあります。これには、res/raw/watchface.xmlや、さまざまなデバイスサイズへの対応を表すその他の XML 定義が含まれます。 - ウォッチフェイスに必要なすべてのリソースは、通常のアプリケーションと同様に、適切なリソース フォルダにあります。次に例を示します。
- フォント用の
/res/font /res/drawable(画像アセットとアニメーション アセットの場合)- 文字列リソースの
/res/values/strings.xml
- フォント用の
Android Studio を使用してウォッチフェイスをビルドする
Android Studio には、XML 定義の作成とデバッグに役立つ Watch Face Format のエディタ サポートが用意されています。
具体的な機能は次のとおりです。
- 公式のウォッチフェイス フォーマット スキーマに基づくタグと属性のコード補完。
- ライブ検証により、属性の欠落や同様の構文エラーを特定します。
- リソースのリンク。XML ファイルで参照されているドローアブル リソース、データソース、その他の要素にすばやく移動できます。
- デバイスでウォッチフェイスを確認できる実行構成。
Gradle を使用してウォッチフェイスをビルドする
Gradle を使用してウォッチフェイスをビルドするプロセスを確認する最も簡単な方法は、GitHub のサンプルを参照することです。
これらのプロジェクトの Gradle スクリプトは、ウォッチフェイスをビルドするだけでなく、バリデータ ツールを使用してウォッチフェイス XML の有効性をチェックします。
Google Play に送信する前にウォッチフェイスを確認する
ウォッチフェイスを作成し、ビルドプロセスに慣れたら、Google Play に送信する前に、ウォッチフェイス AAB の送信前チェックを行います。
Google Play でも同様のチェックが行われるため、送信前のチェックに合格していることを確認することで、送信と審査のプロセスにかかる時間を大幅に短縮できます。
送信前チェックの実行例を以下に示します。
これらのチェックでは、ウォッチフェイスが使用しているメモリ量を検査するだけでなく、リソースの不足などの他の問題を特定し、XML を検証します。
ツールの入手方法とビルド方法については、メモリ使用量評価ツールをご覧ください。