android-wear

Wear OS (Kotlin) リファレンス

Wear OS 公式ドキュメントの主要 API を網羅したスキル。 androidx.wear.compose.* はモバイルの androidx.compose.* とは別 API であり、同名コンポーネントでも取り違えに注意する。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。

ディレクトリ構成

skills/android-wear/
  SKILL.md
  references/
    wear-compose/
      README.md
      theme.md
      scaffold.md
      time-text.md
      lists.md
      expandable.md
      button.md
      button-group.md
      edge-button.md
      icon-button.md
      selection-controls.md
      split-selection-controls.md
      card.md
      list-header.md
      animated-text-placeholder.md
      picker.md
      dialogs.md
      dynamic-color-scheme.md
      progress-indicators.md
      slider-stepper.md
      pager.md
      curved-layout.md
      swipe-to-reveal.md
      rotary-input.md
      hierarchical-focus.md
      ambient-mode.md
      swipe-dismissable-nav-host.md
      navigation3.md
      screen-sizes.md
      one-handed-gestures.md
      previews.md
      migrate-to-material3.md
      migrate-to-navigation3.md
      performance.md
    tiles/
      README.md
      tile-service.md
      material3-tile-service.md
      migrate-tiles.md
      tile-builders.md
      dimensions.md
      color-and-type.md
      layout-elements.md
      modifiers.md
      material3-layout.md
      material3-buttons.md
      material3-cards-progress.md
      animations.md
      actions-and-interactivity.md
      updating-tiles.md
      platform-data.md
      tile-preview-debugging.md
      versioning.md
    wear-widgets/
      README.md
      glance-wear-widget-service.md
      migrate-from-tiles.md
      remote-compose-layout.md
      remote-state-and-actions.md
    complications-health/
      README.md
      background-body-sensors.md
      complicationdatasourceservice.md
      shorttextcomplicationdata.md
      longtextcomplicationdata.md
      rangedvaluecomplicationdata.md
      monochromaticimagecomplicationdata.md
      smallimagecomplicationdata.md
      nodatacomplicationdata.md
      complicationtext.md
      complicationdatasourceupdaterequester.md
      compatibility.md
      healthservicesclient.md
      measureclient.md
      exerciseclient.md
      exerciseevent.md
      passivemonitoringclient.md
      datatype.md
      debouncedgoal.md
      datapointcontainer.md
      healthservicescapabilities.md
      healthservicespermissions.md
      healthservicessimulation.md
    watch-face/
      README.md
      overview.md
      setup.md
      root-element.md
      scene-and-parts.md
      shapes.md
      transform.md
      time.md
      text.md
      images.md
      expressions.md
      weather.md
      complications.md
      user-configurations.md
      personalization-and-photos.md
      ambient-mode.md
      effects.md
      versions.md
      memory-optimization.md
      build-and-debug.md
      watch-face-push.md
      watch-face-designer.md
      watch-face-designer-advanced.md
      watch-face-designer-export.md
    data-layer-communication/
      README.md
      data-layer-overview.md
      assets.md
      capabilityclient.md
      channelclient.md
      cloud-backup-restore.md
      dataclient.md
      messageclient.md
      network-access.md
      nodeclient.md
      ongoingactivity.md
      remoteactivityhelper.md
      remoteauthclient.md
      transfer-to-new-mobile.md
      wearablelistenerservice.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

1. 下記マッピング表でタスクに対応するカテゴリを探す
2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスク	カテゴリ	参照 README
Wear Compose でテーマ・画面骨格 (Scaffold/TimeText) を組みたい	wear-compose	references/wear-compose/README.md
ScalingLazyColumn / TransformingLazyColumn でリスト表示したい	wear-compose	references/wear-compose/README.md
Button / IconButton / SelectionControls / Card / Picker / Dialog を使いたい	wear-compose	references/wear-compose/README.md
CurvedLayout / rotary input (クラウン・ベゼル) / ambient mode を実装したい	wear-compose	references/wear-compose/README.md
Material 2.5 → Material 3 / Navigation 2 → Navigation 3 へ移行したい、Compose のパフォーマンスを最適化したい	wear-compose	references/wear-compose/README.md
One-handed gestures (double pinch / wrist turn, Modifier.oneHandedGesture) を実装したい	wear-compose	references/wear-compose/README.md
Wear OS の Compose Preview (@WearPreviewDevices / @WearPreviewFontScales / WearDevices) を設定したい	wear-compose	references/wear-compose/README.md
Material3TileService で Tile を作りたい / Tiles 1.5・ProtoLayout 1.3 (Material 3) へ移行したい	tiles	references/tiles/README.md
Tile (TileService) を実装したい	tiles	references/tiles/README.md
ProtoLayout / Material3 タイル部品でレイアウトを組みたい	tiles	references/tiles/README.md
Tile のアクション・更新・プラットフォームデータ連携をしたい	tiles	references/tiles/README.md
Wear Widget (GlanceWearWidgetService) を実装したい	wear-widgets	references/wear-widgets/README.md
Remote Compose (RemoteBox/RemoteColumn/RemoteText/RemoteButton) でウィジェットのレイアウトを組みたい	wear-widgets	references/wear-widgets/README.md
Remote Compose の状態・アクション (rememberMutableRemote* / valueChange / pendingIntentAction) を扱いたい	wear-widgets	references/wear-widgets/README.md
Tile から Wear Widget への移行を検討したい	wear-widgets	references/wear-widgets/README.md
ComplicationDataSourceService とコンプリケーションデータ型を実装したい	complications-health	references/complications-health/README.md
Health Services (MeasureClient/ExerciseClient/PassiveMonitoringClient) で運動・健康データを扱いたい	complications-health	references/complications-health/README.md
Health Services の権限・シミュレーション・デバイス間互換性・端末機能 (Capabilities) を確認したい	complications-health	references/complications-health/README.md
バックグラウンドで身体センサー (心拍数等) にアクセスする権限フローを実装したい	complications-health	references/complications-health/README.md
Watch Face Format (WFF) の XML 要素・シーン・図形・時刻表示を書きたい	watch-face	references/watch-face/README.md
WFF の式・データソース・コンプリケーションスロット・ユーザー設定を扱いたい	watch-face	references/watch-face/README.md
Watch Face Designer (Figma プラグイン) で WFF の文字盤を作成・エクスポート・Google Play に公開したい	watch-face	references/watch-face/README.md
WFF のビルド・デバッグ・メモリ最適化・バージョン対応を確認したい	watch-face	references/watch-face/README.md
Data Layer API の全体像・client の選び方・ChannelClient (ストリーム / ファイル転送) を知りたい	data-layer-communication	references/data-layer-communication/README.md
クラウドバックアップ・新しいスマートフォンへのデータ移行 (onNodeMigrated)・スタンドアロンのネットワーク通信 (Wi-Fi 要求 / FCM) を扱いたい	data-layer-communication	references/data-layer-communication/README.md
DataClient で端末間 (phone/watch) の DataItem・Asset を同期したい	data-layer-communication	references/data-layer-communication/README.md
MessageClient で端末間メッセージ (RPC 的な一方向/リクエスト-レスポンス) を送りたい	data-layer-communication	references/data-layer-communication/README.md
NodeClient / CapabilityClient でノード・アプリ機能を検出したい	data-layer-communication	references/data-layer-communication/README.md
RemoteActivityHelper / RemoteAuthClient / OngoingActivity でフォンとの連携・認証・進行中アクティビティを扱いたい	data-layer-communication	references/data-layer-communication/README.md

モバイルの Jetpack Compose は android-compose-ui / android-compose-components が担当する（本スキルの対象外）。モバイルのホーム画面ウィジェット（androidx.glance.appwidget / RemoteViews）は android-platform-core が担当するが、本スキルの wear-widgets は Remote Compose ベースの Wear OS 上のウィジェット（フルスクリーンタイルの後継、カルーセル表示）を扱い、これらとは別 API である。