2026 HarmonyOS NEXT:React Nativeのサードパーティライブラリはそのまま再利用できますか?

AndroidやiOSでは動く依存ライブラリが、HarmonyOS NEXTでは読み込めても機能しない。
結論は、各ライブラリのRNOH適応状況、RNとRNOHの版、必要なシステム機能、保守状態を個別に照合し、対象環境で確認できたものだけを残すことです。
企業のモバイルアーキテクト向け:移行対象の依存を残すか判断する材料を整理します。
React Nativeの上級エンジニア向け:コミュニティの適応資料と既存プロジェクトの条件を照合します。
テスト・リリース担当者向け:依存ごとの確認結果を移行リスクとして記録する方法を扱います。
「そのまま使える」ではなく、適応範囲から判断します
React Nativeの依存宣言やJavaScriptの業務ロジックが使えることと、Android・iOS向けのネイティブ実装がHarmonyOS NEXT上で動くことは別です。React Nativeの公式資料も、プラットフォーム固有コードの分離や、プラットフォームごとの実装を扱っています。これはReact Native共通の設計原則であり、HarmonyOS NEXTへの対応を保証する説明ではありません。プラットフォーム別コードの構成方法を、互換性の認定として読み替えないでください。
まず依存を、次の区分に仮置きします。これは調査の入口であり、最終判断ではありません。
- RNOH向けの適応パッケージと対応範囲を確認できるもの。
- プラットフォーム固有の処理を含まないように見えるもの。ただし呼び出し先のAPI確認が必要です。
- 代替ライブラリへの置き換えを検討するもの。
- 事業上必要な機能が他で満たせず、独自適応を検討するもの。
ここでいうReact Native for OpenHarmonyは、HarmonyOS NEXT移行時に参照されるReact Nativeのコミュニティ実装です。公開されたRNOH向けライブラリ一覧や文書は調査材料になりますが、掲載されているだけでHarmonyOS公式の互換認証や、特定プロジェクトでの動作保証になるわけではありません。RNOHの三方ライブラリ文書では、対象パッケージと各説明の内容を分けて確認します。
適応資料と実装内容は分けて照合します
ライブラリ名が一覧にあるかだけでなく、何が公開されているかを確認します。適応パッケージの存在、対象機能、対応範囲、特定環境での検証結果は、それぞれ異なる根拠です。文書に書かれていない対応範囲を、名称やサンプルの存在から推測してはいけません。
特に差が出るのは、JavaScriptだけで完結する依存と、ネイティブ実装を要求する依存です。後者には、ネイティブビュー、システムAPI、権限、アプリのライフサイクルに関わる処理が含まれる場合があります。前者も安全とは限りません。JavaScriptのライブラリが呼び出すAPIや、そのAPIが依存する環境機能まで追います。
たとえば起動画面のような見た目の機能でも、画面表示だけで判断すると不十分です。起動時の呼び出し順、アプリ復帰時の状態、権限や画面遷移との組み合わせが要件に含まれるなら、対応文書の対象範囲と実際の利用条件を照合します。RNOH向けbootsplash接続資料は、個別機能の適応内容を調べる例として使えます。記載範囲を超える動作は、別途確認が必要です。
注意:一覧掲載、ビルド成功、サンプル画面の表示は、それぞれ確認できる事実が異なります。業務で必要な全機能が使えることの証明としてまとめないでください。
RNOH適応パッケージの有無はどう確認しますか?
依存名だけで検索を終えず、プロジェクトが実際に使っているパッケージと照らし合わせます。名称が似ていても、別パッケージや別の実装である可能性があります。RNOH三方ライブラリの適応情報では、ライブラリ本体とRNOH向けパッケージの区別、公開されている機能範囲、導入時の前提を記録してください。
RNのプラットフォーム拡張に関する資料は、React Nativeの対応プラットフォームや拡張の考え方を理解する際に役立ちます。ただし、個別ライブラリがHarmonyOS NEXTに対応する根拠とは別です。React Nativeのプラットフォーム拡張に関する説明を参照するときも、RNOH側の適応パッケージと公開資料を独立して確認します。
確認手順
- 既存プロジェクトの依存一覧から、直接依存と間接依存を洗い出します。
- 各依存について、利用中の機能、ネイティブコードの有無、呼び出すシステムAPIを記録します。
- RNOHのライブラリ資料と該当プロジェクトの公開説明を照合し、適応パッケージと対象機能を特定します。
- RN、RNOH、適応パッケージ、プロジェクトの開発ツールチェーンについて、公開されている版の制約とリリース記録を確認します。
- 文書に対応版がない、版の関係が明らかでない、または適応パッケージの保守状況を確認できない場合は「要検証」とします。推測で対応済みにしません。
- 対象端末で、業務上必要な機能、権限、画面表示、ライフサイクルを確認します。実施した環境と結果を依存ごとに記録します。
- 証拠がそろわない依存は移行リスク一覧に残し、確認資料または端末検証を得てから判断を更新します。
React Nativeのネイティブモジュール資料は、JavaScriptからネイティブ機能を呼び出す仕組みを把握するためのものです。Turbo Native Modulesの概要はRNの一般的な仕組みを説明しますが、HarmonyOS向けに必要な実装がそろっているかは、RNOH側の資料と対象環境で別に確かめます。React Nativeのネイティブプラットフォーム概念も同様に、一般機構と個別のプラットフォーム対応を混同しないための参照先です。
版の記載がない依存は、互換と見なさず保留します
RNOH三方ライブラリの適応パッケージが見つかっても、既存プロジェクトのRNやRNOHと組み合わせられるとは限りません。確認対象は、依存本体だけではありません。適応パッケージ、RN、RNOH、ツールチェーンの組み合わせを、各文書と公開リリース記録で追います。
ohos_react_nativeの公開リリース記録は、プロジェクトの変更履歴を確認する根拠になります。そこに特定の組み合わせが明記されていなければ、互換性があるとも、ないとも断定できません。対象プロジェクトに合わせて「未記載・要検証」とし、端末での検証結果を追記します。
また、RNOHがどのようにReact Nativeの仕組みと接続するかを確認する際は、RNOHのアーキテクチャ説明を参照できます。これは構成を理解する資料です。個々の三方ライブラリの対応版や業務機能を保証するものではありません。
維持・置換・独自適応を保守負担で比べます
適応パッケージがあっても、更新が止まっている、問題への応答が見えない、必要機能が抜けている場合は、運用上のリスクが残ります。独自適応では初回の移植だけでなく、RNやRNOHの更新時に追随する担当と検証責任も必要です。
判断は次のように整理します。
- 維持:適応パッケージ、版の根拠、対象端末での業務機能確認がそろっている場合です。
- 置換:必要な機能を満たし、適応状況や保守をより明確に確認できる同等の依存がある場合です。
- 独自適応:事業上不可欠な機能で、代替では要件を満たせない場合に限ります。初期実装だけでなく、更新追随と継続検証の責任も見積もります。
- 保留:資料が不足する、版の関係が不明、端末での結果がない場合です。保留は互換性の肯定ではなく、移行リスクとして管理します。
経験上の見落としどころは、依存の追加よりも「依存が内部で呼ぶAPI」の確認です。JSのコードが動いていても、ネイティブ側の権限や画面動作が要件を満たさなければ、業務機能としては再利用できません。
依存判断を表に残し、あとから再確認できる形にします
次の項目を依存ごとに記録すると、設計レビューと端末検証の結果を同じ基準で追えます。適応資料の参照先だけでなく、実際の利用機能と未解決事項も残してください。
- [ ] 元のライブラリ名と、プロジェクト内で使う機能を記録した。
- [ ] RNOH適応パッケージと、その公開資料・対応範囲を記録した。
- [ ] RN、RNOH、適応パッケージ、開発ツールチェーンの版と根拠を照合した。
- [ ] 必要なネイティブAPI、権限、画面・ライフサイクル動作を洗い出した。
- [ ] 対象端末で確認した機能、確認環境、結果、未確認の条件を残した。
- [ ] 維持・置換・独自適応・保留の判断と、担当者を記録した。
- [ ] 資料の更新や依存の変更があったときに、再確認する条件を決めた。
| 判断軸 | 維持 | 置換 | 独自適応 |
|---|---|---|---|
| 適応情報 | 対象パッケージと機能範囲を確認できる | 代替候補の適応情報を確認できる | 必要機能の実装範囲を定義できる |
| 版と検証 | 使用版の根拠があり、端末で業務機能を確認済み | 代替の版と業務要件を照合済み | 対象環境での確認方法と担当が明確 |
| 保守責任 | 公開状況を継続確認できる | 代替先の更新・問題対応を確認できる | 更新追随と継続検証を自組織で担う |
| 判断 | 根拠がそろえば採用 | より管理しやすい同等依存がある場合 | 代替できない重要機能に限定 |
最終確認:2026年10月5日。確認対象は、ohos_react_nativeの公開リリース記録、RNOH三方ライブラリ資料、各適応パッケージの公開説明です。記録はRNOH、適応ライブラリ、依存本体の公開情報に変更があったときに見直し、最終的な判断には対象プロジェクトの版と端末検証を加えてください。
既存のAndroid・iOS実装だけを根拠に依存を残すと、対応範囲の誤認、版の不整合、必要機能の欠落が移行後まで持ち越されます。まず依存判断表で、iOS側の並行ビルドやApple向け作業にMac環境が必要な範囲を切り分けてください。短期の並行作業でMacを用意する場合は、ProxyMacの日本向け料金案内で利用条件を確認し、環境を使い始める際はProxyMacのコンソール案内も参照できます。HarmonyOSの開発ツールチェーンや対象端末での確認は、別途その環境で行う必要があります。安定した長期負荷や物理インターフェースが必要な運用では、レンタルより自社環境が適する場合もあります。依存の適応可否そのものは、どのMac環境を選んでもRNOH資料と対象端末で検証してください。