2026年 HarmonyOS NEXT:React Native移行のリリース前受け入れチェックリスト
ビルドは通るのに、対象端末で業務フローや権限処理まで確認できていない状態です。
最初に代表的な業務フローを試験移行し、依存関係、機能、実機、公開準備を段階ごとに確認してください。 コンパイルや画面の起動だけでは移行完了とせず、重要な依存関係や主要フローに未確認事項が残る場合は、移行範囲の拡大を止めます。
移行の範囲や中断条件を決める技術責任者向けです。
React NativeとArkTSの接続、依存関係、ビルドを確認するエンジニアにも役立ちます。
実機での回帰確認や公開判断を担うテスト責任者は、各段階で残す証跡を整理できます。
最終更新:2026年9月29日。OpenHarmonyのArkTS開発資料とReact Native for HarmonyOSの開発文書一覧、版情報を確認対象としています。OpenHarmonyの資料は開発・テスト機能の確認に使い、HarmonyOS NEXTの商用展開状況やコミュニティ分岐の互換性保証とは区別します。
試験移行の前に対象範囲と停止条件を定める
最初の試験対象は、単純な画面ではなく、ログインからデータの取得・更新、画面遷移までを通る代表的な業務フローにします。対象を選ぶ際は、利用者への影響、使用するネイティブモジュール、権限処理、ネットワーク依存などを確認し、後続の移行判断に必要な論点を含めます。
React Nativeプロジェクトの移行前に、何を決めておくべきですか。
対象フロー、移行対象の画面・機能、利用するReact Native for HarmonyOSの分岐と版、確認対象の端末・システム版を記録します。HarmonyOS NEXTの対象端末とシステム版は、実際の試験条件としてチームで固定し、未確認の商用化スケジュールを前提にしないでください。
- [ ] 対象とする業務フローと、試験対象外の機能を記録する。
- [ ] React Nativeのコミュニティ分岐、版情報、導入手順を確認し、採用する条件を残す。
- [ ] 端末名、システム版、ビルド条件など、再現に必要な試験環境を記録する。
- [ ] 合格、作業停止、従来構成への切り戻しを判断する担当者と条件を定める。
- [ ] 重大な依存関係や主要フローが未確認なら、次の機能へ移行を広げないと決める。
React NativeのJavaScriptスレッドと、ArkUIを含むホスト側のUI処理は、同じ実行経路として扱えません。両者の間でデータや処理を受け渡す方法は採用する分岐や実装に左右されるため、「画面が出たから処理も同じ」と推定せず、スレッド境界やネイティブ連携を対象分岐の文書と実行記録で確かめます。OpenHarmonyのArkTS開発ガイドはArkTS側の開発確認に使えますが、React Nativeの全依存関係の動作を保証する資料ではありません。
依存関係とビルドを証跡つきで確認する
依存ライブラリは、名称だけでなく、対象分岐での対応状況、ネイティブ実装の有無、導入手順、再現可能なビルド結果を確認します。コミュニティ分岐の版情報や、サードパーティライブラリの適用状況を確認できる一覧を参照し、対象の版と必要機能が一致するかを照合してください。一覧への掲載だけで、対象アプリでの動作確認済みとは判断できません。
ArkTSへ移行した後、サードパーティ依存の互換性はどう判定しますか。
各依存を「対象環境で再現確認済み」「追加確認が必要」「置換または再実装が必要」に分けます。適用情報が見つからない場合や、ネイティブモジュールの動作を再現できない場合は、未確認として扱い、ビルド成功を互換性の証明にしないでください。
- [ ] JavaScript依存、ネイティブモジュール、プラグイン、ビルドスクリプトを一覧化する。
- [ ] 依存ごとに対象分岐・版、導入元、適用情報、検証方法を記録する。
- [ ] 署名、実行時に必要なリソース、環境変数などの設定を確認する。
- [ ] クリーンな環境からビルドし、手順とログを保存して再現性を確かめる。
- [ ] 未対応の依存は、代替・再実装・対象外化のいずれにするかを決める。
署名については、OpenHarmonyのアプリパッケージ署名ツールの説明を参照し、署名設定や成果物の扱いを確認します。パッケージの生成や署名でエラーが出た場合は、アプリケーションパッケージの一般的な問題も確認し、ビルドの成功と実行時の受け入れを別々に記録します。
OpenHarmony向けの開発資料やテスト機能の説明は、HarmonyOS NEXTの商用リリース時期や、個別のReact Native分岐・ライブラリの互換性を確約するものではありません。対象の版と端末で確認できた結果だけを、プロジェクトの判断根拠にしてください。
業務フローを移植元と照らし合わせる
機能確認では、移植元アプリと移行後アプリに同じ入力・操作条件を与え、結果を比べます。ログインの成否だけでなく、認証失敗、通信切断、再試行、入力不備などの例外経路も含め、画面表示とデータ更新が業務上の期待どおりかを確かめます。
- [ ] ログイン、セッション維持、ログアウトを確認する。
- [ ] データの読み取り・書き込みと、失敗後の再試行を確認する。
- [ ] 画面遷移、戻る操作、画面再表示後の状態を確認する。
- [ ] 権限の許可・拒否・後からの変更を確認する。
- [ ] ネットワークやサービスの異常時に、エラー表示と復旧操作を確認する。
- [ ] React Native側の動作と異なる箇所を記録し、ArkTSまたはホスト側で再実装する担当を決める。
証跡には、入力条件、期待結果、実際の結果、ログ、再現手順、対象ビルドをまとめます。差異が見つかった場合は、仕様変更として承認されたものか、未実装・不具合なのかを分類し、未解決の主要フローは公開判断に持ち越しません。
実機回帰で画面・復帰・安定性を確かめる
公開前は、どの端末と業務フローを回帰確認の対象にすればよいですか。
プロジェクトが対応対象と定めた実機とシステム版を基準にし、代表的な業務フローをその環境で繰り返します。端末の範囲を広げられない場合は、未確認の組み合わせを記録し、カバー済みであるかのように扱わないことが重要です。
画面の見た目だけでなく、アプリのバックグラウンド移行後の復帰、通信状態の変化、長時間利用、権限変更後の挙動を確認します。性能については、同じ端末・ビルド・操作条件で追跡した結果がある場合に限って結論を記載します。測定値がない場合は数値を推測せず、測定条件と未完了の確認項目を残してください。
OpenHarmonyのUIテスト指針は、UIテストで扱える操作の確認に利用できます。また、安定性テストツールの指針は安定性確認の計画に役立ちます。ただし、自動化できるUI操作や安定性確認だけでは、実際の業務データ、利用者の権限、サービス連携を含む受け入れを代替できません。
- [ ] 対応対象として定めた実機・システム版で、主要フローを実行する。
- [ ] バックグラウンドからの復帰、ネットワーク変化、連続利用を確認する。
- [ ] 画面崩れ、操作不能、処理待ちなどの事象を端末条件とともに記録する。
- [ ] 性能を判定する場合は、比較条件と追跡ログを保存する。
- [ ] 自動化の対象外となる業務判断や外部サービス連携を、手動回帰に含める。
リリース候補の証跡をそろえて公開を判断する
移行試験に通らなかった場合、どの作業を止めるべきですか。
重要な依存関係が動かない、主要な業務フローが完了しない、または予定した実機確認が未実施なら、影響する機能の移行拡大とリリース候補の承認を止めます。障害の原因を切り分け、依存の置換・再実装、試験範囲の見直し、従来構成への切り戻しを責任者が選ぶまで、未確認事項を合格扱いにしません。
公開判断では、テスト結果だけでなく、既知の問題、ビルド成果物、署名・公開設定、担当者、切り戻し手順を追跡できる状態にします。停止条件や合格基準はプロジェクトが定める品質ゲートであり、OpenHarmonyの文書が指定する一律の公開基準として扱わないでください。
- [ ] 自動テストと手動回帰の結果、未実施項目を記録する。
- [ ] 既知の問題に影響範囲、回避策、公開可否の判断者を記載する。
- [ ] 成果物、ビルド条件、署名・公開設定を照合できるよう保管する。
- [ ] 切り戻し担当者、戻す版、実行手順、切り戻し後の確認項目を定める。
- [ ] 依存・主要フロー・実機確認のいずれかに重大な未確認があれば、公開を保留する。
ローカル端末や手元のビルド環境だけで検証を進める方法は、設備をすぐに使える一方、端末の空き状況、環境差、チーム間の利用調整が制約になり得ます。リモートのMac環境は、必要なツールチェーンが対応している場合の開発・ビルド資源の補完策として検討できますが、HarmonyOS NEXT対象端末での実機受け入れを代替するものではありません。KuzCloudの日本向け料金案内を確認する場合も、先に必要なホスト環境と実機試験の分担を整理してください。環境の利用条件はサポート案内で確認し、移行の合否はあくまで対象アプリの証跡に基づいて判断します。
移行前後の検証を、専用Macで着実に
KuzCloudの専用Macなら、既存のiOSアプリのビルドや回帰確認に使う環境を専有できます。
SSHやVNCで遠隔接続でき、開発ツールの導入から検証作業まで柔軟に進められます。