harmonyos-dev

HarmonyOS 開発

リポジトリの証拠と最新の公式ドキュメントに基づいて HarmonyOS の作業を実装します。広範で憶測に基づく書き直しよりも、検証済みの小さな変更を優先してください。

ワークフロー

1. プロジェクトのコンテキストを確立する

既存のリポジトリの場合は、質問する前に調査します：

• リポジトリの指示と、リクエストに関連するファイルを読みます。
• build-profile.json5、oh-package.json5、module.json5、app.json5、およびモジュールレベルの設定を特定します。
• コンパイル／互換／ターゲット SDK、Stage モデルまたは FA モデル、デバイスタイプ、状態管理の世代、Kits、パーミッション、ビルドコマンドを導き出します。
• 近隣の実装を検索し、タスクが変更を必要としない限り、確立されたアーキテクチャを維持します。

新規のリクエストの場合は、結果に実質的に影響する決定についてのみ質問します：ターゲットデバイス、最小互換 API、アプリケーションまたはアトミックサービス、および必要なシステム機能。デフォルトの API バージョンやデバイスタイプをでっち上げないでください。

2. バージョンに依存する事実を検証する

次のソース順序を使用します：

1. リポジトリの SDK 設定、生成された型、コンパイラの診断、およびインストール済み SDK。
2. シグネチャ、可用性、パーミッション、SysCaps、エラー、非推奨に関する現在の Huawei API リファレンス。
3. 現在の Huawei 開発ガイド、リリースノート、ベストプラクティス、および公式サンプル。
4. このスキル内のローカルリファレンスファイル（ナビゲーションとレビューのチェックリストとして）。

ローカルリファレンスはスナップショットとして扱い、権威とはみなしません。API 名、シグネチャ、デコレータの制約、パーミッション、可用性レベル、ライフサイクル動作に依存する前に再確認してください。公式の資料が入手できない場合は、何が未検証のままであるかを述べ、推論を事実として提示することを避けてください。

外部調査が必要な場合は、利用可能なドキュメントツールまたはブラウジングツールを使用し、技術的な主張を Huawei の公式ソースに限定してください。Context7 のような特定のツールを必須にしてはいけません。

3. 最小限の整合の取れた変更を設計する

• 実装に影響する互換性とデバイスの前提を述べます。
• 明示的な移行を行っている場合を除き、コンポーネントの境界内で V1 と V2 の状態管理パターンの一貫性を保ちます。
• Kit API を選択する前に、API レベル、デバイス、SysCap、パーミッション、およびアプリケーションフォームの制約を確認します。
• サブスクリプション、タイマー、ネットワークハンドル、ResultSet オブジェクト、ファイル、コントローラー、およびその他のリソースの所有権とクリーンアップを計画します。
• エラーのセマンティクスを維持します。API コントラクトが要求する場合は BusinessError と拒否されたプロミスを処理します。失敗を黙って握りつぶさないでください。
• ハードコードされた文字列、色、サイズ、単一デバイスの前提よりも、リソースと適応型レイアウトを優先します。

関連するリファレンスのみを読み込みます：

• 状態とリアクティビティ：references/state-management.md
• ArkUI とデバイスの適応：references/ui-components.md
• Preferences、RDB、ファイル：references/data-persistence.md
• HTTP、WebSocket、ソケット、転送：references/network.md
• パーミッションの宣言と実行時の認可：references/permissions.md
• 計測主導のパフォーマンス作業：references/performance.md

4. リポジトリのスタイルで実装する

• 証拠なしに並行する抽象化を作成するのではなく、既存の接合部を編集します。
• ArkTS の型を明示的に保ち、プロジェクトのコンパイラルールと互換性を保ちます。
• プロジェクトのログ、エラー、依存性注入、ナビゲーション、リソース、テストの規約を再利用します。
• API の移行では、機械的な互換性の編集と動作の変更を分離します。
• 無関係なコードや生成された成果物を変更しないでください。

5. 検証

まず最も範囲の狭い関連チェックを実行し、利用可能な場合はより広範なチェックを実行します。

• 影響を受けるモジュールをコンパイルまたはビルドします。
• 関連するユニットテスト、統合テスト、UI テスト、または Hvigor テストを実行します。
• API 互換性と ArkTS の制約について診断を確認します。
• UI 作業では、対象範囲に含まれる影響を受けるデバイスクラス、画面の向き、テーマ、フォントスケーリング、および空・エラー・読み込み状態を検証します。
• ライフサイクル作業では、可能な範囲で生成、バックグラウンド/フォアグラウンド、画面遷移による離脱、および終了の各パスを実行します。

必要な環境、SDK、デバイス、アカウント、またはサービスが利用できない場合は、未検証の境界を正確に報告してください。実行していないチェックを合格として説明してはなりません。

ソースと回答の方針

バージョンに敏感な重要な主張については、またはユーザーがソースを求めた場合は、Huawei の公式ドキュメントを引用してください。引用は、裏付けとなる主張の近くに配置します。装飾的な引用を追加したり、ローカルの例が公式の要件であると主張したりしないでください。

実装タスクでは、最後に以下を記載します。

• 何がどこで変更されたか。
• 互換性に関する前提。
• 実行した検証とその結果。
• 未検証の項目または残存するリスク。

説明のみの依頼では、直接回答してください。依頼されない限り、リポジトリを変更しないでください。