CI/CD

2026 HarmonyOS NEXT RN移行をリリース前にどう受け入れ検証するか?

「コンパイルできて画面が開く」だけでは、HarmonyOS NEXT RN移行の受け入れ条件を満たしません。公開するなら、構築、主要利用経路、原生モジュール、長い一覧と操作性能、端末互換性、公開資料を分けて検証し、重要な経路を回帰できない場合は既存版との併用か全量切り替えの延期を選びます。

この判断は、灰度展開や正式公開の可否を決めるリリース責任者、RN画面と端末差を試験設計する検証責任者、コミュニティ分岐やArkTS改修の責任範囲を切り分けるフロントエンド・クライアント責任者に向いています。

最終更新:2026年9月23日。HarmonyOSのアップグレード適応資料、開発ツール資料、性能診断資料、OpenHarmonyコミュニティのRNリポジトリを基に確認しています。ツール、API、分岐の更新時には再確認が必要です。

受け入れの前提を最初に固定する

第一段階:何を公開するのかを一文で定義する

同じ「RN移行」という呼び方でも、実際の完成条件は異なります。RNコンテナをHarmonyOS NEXT上で公開可能にするのか、一部画面だけArkTSへ改修するのか、全画面を原生化するのかを、受け入れ開始前に明記します。

この境界が曖昧だと、移行しない画面を未対応として扱ったり、逆に仮実装を完成版として扱ったりします。次の項目をリリース票に紐付けてください。

  • [ ] 今回公開する画面と、今回対象外にする画面を一覧化する
  • [ ] ログイン、トップ、検索、一覧、入力、送信など必須の利用経路を定義する
  • [ ] RN画面、ArkTS画面、混在画面の範囲を記録する
  • [ ] 既知の問題ごとに担当者、重要度、回帰方法、公開後の対応期限を記録する
  • [ ] 「未実装」「代替実装」「既存版との併用」を区別する

HarmonyOSのアップグレードでは、開発環境、SDK、APIの変更、HARやHSPの依存関係をまとめて確認する必要があります。公式のHarmonyOSアプリ更新適応ガイドを参照し、画面単位ではなく成果物単位で範囲を確定します。

第二段階:再現できる開発環境を受け入れる

DevEco Studio、対象SDK、API、コマンドラインツール、RN移植分岐、プロジェクトの補正パッチが同じ組み合わせで再現できるかを確認します。開発担当者の端末だけで成功する状態は、公開用の受け入れ環境とはみなしません。

確認対象 受け入れ時に残す証跡 放行条件
DevEco StudioとSDK IDEの版、SDK/API、設定ファイル 新規環境で同じ成果物を作成できる
コマンドラインツール 実行コマンド、環境変数、終了ログ CIまたは別端末でも同じ手順を再現できる
RNの実装層 本体、React Native for OpenHarmony、独自修正の分離 各修正の理由と戻し方が説明できる
依存ライブラリ HAR/HSP、ネイティブモジュールの一覧 未対応依存が主要経路に残っていない
公開成果物 HAPなどの出力物、署名、ハッシュ DebugだけでなくReleaseで検証できる

公式のコマンドラインツール説明と開発ツールの版による差異を確認し、IDEで手動操作した内容をCIの手順へ移します。API変更の確認にはAPIバージョンと更新情報も使います。

開発責任者が分岐と依存関係を切り分ける

公式本体、コミュニティ分岐、独自パッチを混ぜない

React Native本体の公式主線と、OpenHarmonyコミュニティが保守するReact Native for OpenHarmonyは同じものではありません。さらに、各社が追加したC++層、ブリッジ、ビルド設定、原生モジュールの修正があれば、第三の実装層として管理する必要があります。

OpenHarmonyのReact Nativeリポジトリにあるタグ情報を基準に、次の情報を固定します。

  • 使用した分岐名またはタグ
  • RN本体との対応関係
  • プロジェクト独自パッチのコミット
  • C++レンダリング経路に関わる変更
  • 既知の未対応APIと代替策
  • DebugとReleaseで異なる設定

「コミュニティ分岐が動いた」ことを「公式RNの標準機能が利用できる」と表現してはいけません。公開資料には、どの層が問題の原因かを明記します。これにより、次回のSDK更新で再検証すべき場所も絞れます。

原生モジュールは機能名ではなく失敗条件で確認する

ナビゲーション、ジェスチャー、保存領域、通信、通知、画像、地図などは、単に画面へ組み込めたかだけでは判定できません。各モジュールを次の4分類に分け、根拠を残します。

  1. そのまま再利用できるもの
  2. HarmonyOS向けの代替ライブラリへ置き換えるもの
  3. ArkTSまたは原生層で書き直すもの
  4. 今回は利用できず、機能範囲から外すもの

権限を拒否した場合、バックグラウンドから復帰した場合、通信が切れた場合、プロセスを再起動した場合を含めて、最小再現プロジェクトか構築ログを保存します。デバイスAPIとHAPの互換性で問題が出た場合は、公式の互換性トラブルシューティングと照合します。

検証責任者は画面ではなく利用経路を回帰する

第三段階:主要利用経路を最後まで通す

画面を一つずつ開く試験では、RN画面からArkTS画面へ遷移した後の状態消失や、送信完了後の戻り先異常を見落とします。最低限、次のような実利用経路を一本のシナリオとして実施します。

  • ログイン後にトップを開き、一覧を追加読み込みする
  • 一覧から詳細へ移動し、戻った際に位置と状態を確認する
  • 入力途中で権限を求め、許可または拒否した後に処理を続ける
  • ファイルを選択して送信し、通信失敗後に再試行する
  • 決済などの重要操作を完了し、結果画面と履歴へ反映する
  • アプリをバックグラウンドへ移し、復帰後にセッションと入力状態を確認する
  • プロセスを終了して再起動し、必要な状態が復元されることを確認する

RN画面、ArkTS画面、混在画面では、ルートの戻る動作、状態管理、権限ダイアログ、バックグラウンド復帰を分けて記録します。失敗時は、端末、OS/API、成果物、分岐、再現手順、ログの保存先を一つの課題にまとめます。

検証の合格条件を「通過数」にしない

主要経路のログイン、データ送信、権限処理、決済などが再現できない場合、他の画面が通過していても公開可とはしません。通過項目の割合を示す場合でも、重大度の高い失敗を別枠で扱います。

特に次の問題は、原則として公開を止める対象です。

  • 初回起動またはログインが成立しない
  • 主要データの表示と送信結果が一致しない
  • 権限拒否後に復帰できない
  • Release成果物だけでクラッシュする
  • RNとArkTSの境界で状態や戻り先が失われる
  • 重要な外部ライブラリが実機で代替不能になる

性能責任者は体感シナリオとトレースを結び付ける

第四段階:長い一覧と操作応答を分けて調べる

ArkTS改修後の長い一覧は、単一のFPS値だけでは判断できません。初回表示、ページ切り替え、スクロール、入力、画像表示、アニメーションを別シナリオにし、どの操作で遅延が発生したかを記録します。

List、Grid、WaterFlowを採用する場合は、LazyForEachやNodeAdapterを使う前提も明記します。データ更新時に同じノードが重複生成されないか、画面外のノードが適切に解放されるか、キーの変化で不要な再生成が起きないかを確認します。

SmartPerfのシナリオ別収集資料とArkUIのスクロール停滞に関する診断資料を使い、トレースの取得条件と対象コンポーネントを記録します。ツールが示す指標、端末で観測した操作遅延、利用者が感じる待ち時間は同じ意味ではありません。

  • [ ] 初回表示と画面遷移を同じデータ条件で確認する
  • [ ] 長い一覧の追加読み込みと更新を分けて確認する
  • [ ] 入力中のキーボード表示、フォーカス移動、文字反映を確認する
  • [ ] 画像の初回表示、再表示、失敗時の代替表示を確認する
  • [ ] アニメーション中のタップ反応と画面遷移を確認する
  • [ ] トレースの取得日時、成果物、端末、シナリオ名を保存する
  • [ ] 再現しない場合は、単一の性能数値で合格扱いにしない

ここで重要なのは、ArkTSへ書き換えたかではなく、データ更新、UIスレッド、JS側処理、画像や通信の待機がどこで連鎖しているかを説明できることです。性能課題の修正方法そのものは、今回の受け入れ範囲ではなく、原因と再検証条件を残すことが中心です。

交付責任者は端末差と公開材料を確認する

第五段階:端末マトリクスを実利用比率で作る

端末は数を増やすことより、実際の利用者構成を代表しているかが重要です。主力端末、低資源端末、画面サイズや解像度の異なる端末、横画面を使う業務、権限状態が異なる端末を組み合わせ、毎回同じ環境表を保存します。

各行には、端末識別子、OS/API、成果物、テスト日、結果、ログの場所を記録します。具体的な端末台数や合格率は、実際の検証記録がない限り記事や受け入れ票へ固定値として書きません。

第六段階:署名、依存、CI成果物を突き合わせる

公開直前には、機能試験とは別に成果物の完全性を確認します。

  • [ ] 署名設定と公開用証明書の扱いを確認する
  • [ ] 権限、設定ファイル、画像、フォント、ローカライズ資材を確認する
  • [ ] HAR/HSP依存の版と取得元を固定する
  • [ ] 難読化、圧縮、ログ出力の設定をReleaseで確認する
  • [ ] IDEで作った成果物とCIで作った成果物の設定差を比較する
  • [ ] 成果物のハッシュ、保存先、公開担当者を記録する
  • [ ] ロールバック可能な旧版と復旧手順を準備する

自動署名を使う場合も、公開環境で必要な権限と証明書の有効性を確認します。手順は自動署名の公式資料に照らし、担当者個人のIDEだけに秘密情報が残らない運用にします。

未安定のコミュニティライブラリや一時的な補正パッチを使う場合は、受け入れ済みという言葉でリスクを隠さないことが重要です。灰度展開の対象、監視項目、問い合わせ窓口、停止条件、旧版への戻し方まで公開資料へ含めます。

一枚の結論で公開判断を分ける

最終票は、通過項目の多さではなく、問題の種類と回帰証拠で判断します。分類は「公開阻害」「主要体験への影響」「許容可能な不具合」「文書補完」の4つに分け、それぞれに終了条件を置きます。

  • 公開阻害:修正後の実機回帰とReleaseログが必要です
  • 主要体験への影響:灰度条件、監視項目、修正期限が必要です
  • 許容可能な不具合:対象範囲と利用者への影響を記載します
  • 文書補完:手順、担当者、期限が記録されていれば公開判断を妨げません

結論は次の4種類に限定すると、関係者間の解釈がぶれにくくなります。

  1. 正式公開:主要経路、Release成果物、端末差、公開材料が回帰可能です。
  2. 段階展開:限定対象へ出し、監視と停止条件を明示できます。
  3. 既存版との併用継続:RNとHarmonyOS側の一部課題が残り、全量切り替えの根拠が不足しています。
  4. 移行停止または延期:主要経路、原生モジュール、成果物のいずれかが再現不能です。

DevEco StudioやAPI、React Native for OpenHarmonyの分岐が更新された場合は、今回の票をそのまま再利用せず、環境固定情報、依存一覧、性能トレース、端末マトリクスを起点に再受け入れします。

よくある確認事項

HarmonyOS NEXT RN移行を公開前に確認する項目

構築の成功だけでなく、主要利用経路、RNとArkTSの境界、原生モジュール、長い一覧、権限、復帰、Release成果物、署名、端末差、ロールバックを確認します。各項目には担当者と証跡の保存先を付け、再現できない不具合を「確認済み」と扱わないことが重要です。

React Native for OpenHarmonyの公開受け入れ

公式React Native本体、OpenHarmonyコミュニティ分岐、プロジェクト独自パッチを分けて管理します。分岐やタグ、補正コミット、未対応機能を固定し、DebugとReleaseの両方を実機で回帰します。コミュニティ分岐で動作した結果を、公式主線の標準対応とは表現しません。

原生モジュールと外部ライブラリの確認方法

ナビゲーション、ジェスチャー、保存、通信、通知、画像、地図を、再利用、置換、書き直し、未対応に分類します。権限拒否、通信切断、バックグラウンド復帰、プロセス再起動、Releaseビルドを含む最小再現を作り、ログと成果物を一緒に保存します。

ArkTS改修後の長い一覧と性能の判定

初回表示、遷移、スクロール、入力、画像、アニメーションを別シナリオで測り、単一のFPS値で合否を決めません。LazyForEachやNodeAdapterの採用条件、データ更新、ノード再生成、画面外要素の扱いを記録し、公式性能診断のトレースと端末での体感を突き合わせます。

最後に:受け入れ環境を安定させる選択

手元の開発端末だけで検証を続けると、DevEco Studio、SDK、署名情報、CI設定の差が後から発覚しやすく、再現性のない合格判定になりがちです。既存のMac環境を使い続ける方法は、物理機器や社内ネットワークを直接扱える一方、担当者ごとの環境差、利用時間の競合、更新前後の比較管理が負担になります。

公開前の短期間だけ同じ開発環境を複数担当者で使う場合や、遠隔地の交付チームが安定したビルド環境を必要とする場合は、KuzCloudの利用環境を候補に加えられます。まずは利用手順と環境確認の案内で、必要な接続方法、検証手順、成果物の扱いを確認し、長期の高負荷運用や物理インターフェースが必須の案件では自社設備との併用を選ぶのが適切です。

リリース前の検証環境をKuzCloudで整えませんか

KuzCloudなら、移行後のアプリを確認するためのMac環境を必要な期間だけ用意できます。

遠隔操作に対応しているため、開発・検証担当者が場所を問わず同じ環境へアクセスできます。