DevOps / CI/CD

HarmonyOS NEXT 2026 : les bibliothèques tierces React Native sont-elles réutilisables directement ?

HarmonyOS NEXT 2026 : les bibliothèques tierces React Native sont-elles réutilisables directement ?

La documentation de React Native décrit deux voies pour isoler du code selon la plateforme : des fichiers spécifiques à la plateforme et le module Platform (guide officiel du code spécifique aux plateformes). Cela ne rend pas les implémentations Android ou iOS exécutables telles quelles sous HarmonyOS NEXT. Pour décider, vérifiez chaque bibliothèque séparément : adaptation RNOH identifiable, versions compatibles, capacités système couvertes et maintenance observable. Ne conservez que les dépendances dont les fonctions requises ont été validées dans l’environnement cible ; remplacez les autres ou traitez leur portage comme un travail à part entière.

Cette décision concerne les architectes mobiles qui doivent justifier le maintien des dépendances existantes, les ingénieurs React Native qui examinent les interfaces natives et les responsables de tests qui suivent les risques de migration. Elle est particulièrement importante lorsque l’application combine des interfaces métier avec de l’audio, de la vidéo ou des outils de création visuelle : une bibliothèque qui s’affiche correctement peut tout de même manquer une permission, une fonction de cycle de vie ou une commande native essentielle.

Dernière mise à jour : 5 octobre 2026. Les informations de compatibilité sont à vérifier dans la documentation RNOH et son catalogue d’adaptations, les publications du projet RNOH et les documents propres aux bibliothèques citées. Une entrée documentaire n’équivaut pas à une certification de compatibilité ni à un essai sur l’appareil cible.

Une dépendance JavaScript n’est pas forcément une dépendance portable

Dans un projet React Native, le nom d’un paquet dans le manifeste ne révèle pas à lui seul ce que son exécution exige. Le même paquet peut réunir une interface JavaScript, du code natif propre à une plateforme et des instructions de configuration destinées à l’outil de compilation. Il faut donc distinguer la réutilisation du code métier de celle de l’implémentation complète.

Une bibliothèque purement JavaScript peut être réutilisable si elle ne s’appuie que sur des fonctions disponibles dans l’environnement et si ses dépendances indirectes le sont aussi. « Sans code natif » ne signifie pas automatiquement « compatible » : une bibliothèque qui appelle une API de stockage, de notification, d’accès média ou de partage doit encore trouver une implémentation correspondante. L’examen doit suivre la chaîne d’appels, et pas s’arrêter au paquet directement déclaré par l’application.

À l’inverse, une dépendance qui présente une interface JavaScript pratique peut appeler des modules ou des vues natifs propres à Android ou à iOS. React Native explique comment organiser le code propre à une plateforme, mais cette convention décrit le fonctionnement général de React Native ; elle ne promet pas qu’une implémentation native donnée existe sous HarmonyOS NEXT. La documentation sur les extensions de React Native à d’autres plateformes confirme que l’ajout d’une plateforme demande une intégration adaptée. Elle ne transforme pas les bibliothèques existantes en composants universels.

Pour une équipe, cette distinction évite trois erreurs de classement coûteuses :

  • Confondre installation et prise en charge. Un paquet que l’outil accepte ou que le code importe peut échouer dès qu’il invoque son module natif.
  • Confondre compilation et équivalence fonctionnelle. Une vue peut s’afficher alors que les permissions, les états en arrière-plan ou les événements attendus par le produit ne sont pas couverts.
  • Confondre disponibilité documentaire et garantie. Une page de catalogue ou un dépôt communautaire est une piste de vérification, pas un engagement de compatibilité pour chaque version et chaque cas d’usage.

Le dépôt d’adaptations RNOH fournit des éléments pour repérer des bibliothèques documentées. Il faut toutefois lire la fiche associée et les consignes du projet, plutôt que déduire une prise en charge du seul fait qu’un nom figure dans un répertoire. Les informations publiées doivent être interprétées dans le contexte de leur auteur, de leur périmètre et de leur date de mise à jour.

Une adaptation répertoriée et une adaptation éprouvée ne donnent pas le même niveau de confiance

Pour chaque dépendance, recherchez d’abord le nom du paquet d’origine dans la documentation des bibliothèques RNOH. Puis vérifiez la nature exacte de l’information trouvée. Une fiche peut documenter une adaptation et ses instructions ; une mention dans un répertoire peut seulement orienter vers un projet. Ni l’une ni l’autre ne démontre, à elle seule, que toutes les fonctions nécessaires sont couvertes dans le projet concerné.

La fiche d’une adaptation doit répondre à des questions opérationnelles : quel paquet faut-il installer ? Quelles étapes d’intégration sont nécessaires ? Quelles fonctions sont déclarées prises en charge ? Existe-t-il des limites, des prérequis ou des cas laissés à l’application ? Si ces renseignements ne sont pas disponibles, inscrivez la dépendance comme « à vérifier ». Ne complétez pas les lacunes en supposant que l’adaptation suit automatiquement les évolutions de la bibliothèque d’origine.

Une documentation particulière peut aussi révéler la forme concrète du travail requis. Par exemple, le guide consacré à l’adaptation RNOH de bootsplash est une référence pour son intégration déclarée. Il ne faut pas en déduire que les autres bibliothèques d’interface, d’animation ou de média suivent les mêmes règles. Chaque paquet a ses propres points de raccordement et son propre périmètre documenté.

Le tri initial peut être organisé en quatre familles :

  • Adaptation RNOH documentée : candidate à la conservation, sous réserve de vérifier les versions et les fonctions nécessaires.
  • Implémentation indépendante d’une plateforme : candidate à la réutilisation, après examen des API appelées directement et indirectement.
  • Solution équivalente mieux suivie : candidate au remplacement lorsque ses capacités répondent au besoin métier et que son adaptation est mieux documentée.
  • Capacité sans alternative validée : candidate à une adaptation interne, après estimation du travail de portage et de la responsabilité de maintenance.

Ce classement permet de bâtir une première liste, pas de rendre une décision finale. Un paquet peut changer de famille lorsque l’analyse de sa dépendance native, de son activité ou de ses contraintes de version apporte de nouveaux éléments.

Les versions doivent se correspondre, pas seulement être récentes

L’existence d’une adaptation ne suffit pas à démontrer qu’elle peut être intégrée au projet. Il faut rapprocher les exigences publiées pour React Native, le socle RNOH, l’adaptation de la bibliothèque et les outils employés par l’équipe. Une version récente d’un élément ne compense pas une incompatibilité documentée avec un autre.

L’équipe peut consigner ces éléments dans le dépôt ou dans son outil de suivi :

  • version de React Native réellement utilisée par l’application ;
  • version du socle RNOH et version de l’adaptation envisagée ;
  • version de la bibliothèque d’origine, si l’adaptation en dépend ;
  • exigences d’outillage et instructions de configuration ;
  • lien vers les documents et publications qui appuient ces valeurs.

Les publications du projet RNOH servent à suivre les changements annoncés par le projet. Elles doivent être lues avec les exigences de l’adaptation, car une publication du socle ne déclare pas automatiquement toutes les bibliothèques compatibles. De même, les versions indiquées dans un exemple de projet ne prouvent pas que des combinaisons différentes ont été testées.

Quand la documentation ne précise pas une contrainte, quand la plage de versions est ambiguë ou quand les notes de publication ne décrivent pas l’adaptation utilisée, l’état doit rester « à vérifier ». Ce statut n’est pas un échec de migration : il empêche simplement une hypothèse non étayée de devenir une décision d’architecture. La décision peut être fermée après confirmation documentaire ou essai reproductible, mais pas par déduction.

La réussite de l’installation ne prouve pas l’équivalence métier

Le test doit porter sur les fonctions réellement employées, pas seulement sur la présence du paquet dans l’application. Les modules natifs de React Native illustrent bien cette séparation entre interface appelée depuis JavaScript et implémentation native : l’introduction officielle aux modules natifs Turbo décrit ce rôle d’interface. Il appartient ensuite à l’environnement visé de fournir l’implémentation et le comportement attendus.

Pour chaque bibliothèque, établissez les scénarios qui comptent pour le produit. Un composant de lecture audio doit être évalué sur le démarrage, l’arrêt, les interruptions pertinentes et le retour à l’écran si ces comportements font partie de l’usage. Un outil de création vidéo peut dépendre de l’accès aux médias, de la sélection des fichiers et du rendu de ses contrôles. Une bibliothèque de conception peut sembler fonctionner dans une démonstration tout en échouant sur un geste, une police ou une ressource utilisée par l’interface réelle.

Cette analyse distingue plusieurs couches, que les comptes rendus de test devraient garder séparées :

  • Chargement : le paquet est résolu et l’application peut atteindre le code concerné.
  • Fonction native : l’appel attendu reçoit une réponse exploitable de l’implémentation disponible.
  • Accès système : permissions, sélection des ressources et autorisations correspondent au scénario métier.
  • Comportement d’interface : vues, interactions et états sont cohérents avec l’usage demandé.
  • Cycle de vie : les transitions pertinentes ne laissent pas une opération bloquée ou dans un état incohérent.

Un résultat positif sur une seule couche ne permet pas de conclure sur les autres. En particulier, « le projet se compile » est une information de construction, pas la preuve que la fonction demandée est présente. Les familles de modules natifs et de plateformes sont expliquées dans la documentation React Native sur la plateforme native ; ce cadre général doit être complété par les documents RNOH et par les essais du projet.

Le coût de maintenance départage souvent conservation et remplacement

Une adaptation communautaire peut être le choix le plus direct lorsque ses fonctions et ses versions correspondent au projet. Son avantage est de réutiliser un travail existant. Sa limite tient à la nécessité d’évaluer son suivi et de savoir qui traitera un blocage futur. L’existence d’un paquet ne signifie pas que son auteur prendra en charge les besoins propres à l’application.

Le remplacement par une autre dépendance évite parfois de porter un module natif devenu isolé. Il peut aussi exiger une modification des appels métier, des écrans ou des processus de test. Cette voie est raisonnable lorsque l’équivalent possède un périmètre fonctionnel suffisant et des documents d’adaptation vérifiables. Il faut comparer la couverture réelle et la charge d’évolution, pas seulement le coût initial du changement.

L’adaptation interne se justifie surtout lorsque la capacité est centrale au produit, qu’aucun substitut validé ne la fournit et que l’équipe peut assumer sa maintenance. Le guide RNOH consacré à l’architecture aide à comprendre l’organisation du projet d’adaptation ; il ne chiffre pas le travail propre à une dépendance. Celui-ci doit être évalué à partir du code natif requis, des interfaces utilisées et des vérifications à maintenir.

Un cas typique est celui d’une application de création de contenu qui réutilise une bibliothèque de sélection média. Si l’adaptation documentée ne couvre que le chemin de sélection simple, mais que le produit dépend aussi d’un retour d’état ou d’une fonction de traitement native, une démonstration réussie ne clôt pas le sujet. L’équipe peut conserver la bibliothèque pour le parcours couvert, remplacer l’ensemble par une solution mieux adaptée ou financer l’extension nécessaire. Le bon choix dépend de la criticité de la fonction et de l’effort récurrent, pas de la fidélité du nom du paquet.

Une liste de contrôle rend les arbitrages vérifiables

Chaque ligne de décision doit relier la dépendance d’origine à ses preuves, à son résultat sur l’environnement cible et à une personne responsable. Gardez les liens vers la fiche d’adaptation et les publications utilisées : un statut sans justificatif devient difficile à réexaminer lorsque le projet évolue.

  • [ ] Relever le nom du paquet, son rôle dans le produit et les fonctions effectivement appelées.
  • [ ] Séparer l’interface JavaScript du code natif, des vues et des dépendances indirectes.
  • [ ] Rechercher une adaptation RNOH et ouvrir sa documentation plutôt que de s’arrêter à une entrée de catalogue.
  • [ ] Consigner les contraintes publiées pour React Native, RNOH, le paquet adapté et l’outillage.
  • [ ] Associer chaque fonction essentielle à un scénario d’essai exécutable dans l’environnement cible.
  • [ ] Enregistrer les résultats, les écarts observés, les références consultées et la personne chargée du suivi.
  • [ ] Choisir une issue explicite : conserver, remplacer, adapter en interne ou maintenir « à vérifier ».
  • [ ] Réexaminer toute décision lorsque le socle RNOH, l’adaptation ou la dépendance change.

La liste aide à comparer les bibliothèques sans transformer une migration en audit indistinct de tout le code source. Elle fournit aussi une explication exploitable en revue d’architecture : une dépendance conservée possède une justification, tandis qu’un point non documenté reste visible dans le registre des risques jusqu’à l’obtention d’une preuve.

Pour les équipes qui doivent parallèlement gérer les accès à un environnement Mac, la page d’aide ProxyMac permet de vérifier les informations de service disponibles avant de planifier cette partie du travail. La console ProxyMac constitue également un point de repère lorsque le flux de travail prévoit la gestion d’un environnement distant. Ces ressources ne remplacent ni l’outillage RNOH ni les essais sur l’appareil HarmonyOS NEXT.

Questions fréquentes sur la réutilisation des bibliothèques

Le code JavaScript d’une bibliothèque peut-il être gardé sans son module Android ou iOS ?

Parfois, si la partie JavaScript peut fonctionner sans appeler le module natif absent, ou si l’application lui fournit une implémentation équivalente. Il faut examiner les chemins d’exécution et les dépendances indirectes, puis tester les fonctions utilisées par le produit. Garder seulement l’importation ou l’interface d’un paquet ne suffit pas si ses opérations essentielles reposent sur du code natif indisponible.

Où vérifier qu’une adaptation RNOH correspond bien au paquet d’origine ?

Commencez par la documentation des adaptations, puis suivez le lien vers les instructions ou le dépôt du paquet concerné. Vérifiez que le nom correspond à la bibliothèque réellement utilisée et que la fiche décrit l’intégration, les fonctions et les limites pertinentes. Si seul un nom apparaît dans une liste, recherchez une preuve complémentaire avant de classer la dépendance comme candidate à la conservation.

Que faire lorsque la documentation ne donne pas les versions requises ?

Ne supposez pas que la combinaison fonctionne parce que chaque composant existe séparément. Notez les versions effectivement utilisées, recherchez les notes de publication correspondantes et demandez une confirmation au responsable de l’adaptation si nécessaire. Tant qu’il n’existe ni exigence claire ni résultat d’essai reproductible, conservez le statut « à vérifier » dans le registre de migration.

Dans quel cas vaut-il mieux adapter soi-même une bibliothèque ?

Le portage interne est à envisager lorsque la fonction est indispensable au produit, qu’aucun remplacement adéquat n’est documenté et que l’équipe peut assumer les changements de l’interface native. Avant de choisir cette voie, délimitez les fonctions à porter et les scénarios à tester. Si une solution équivalente couvre déjà le besoin avec un suivi plus lisible, son adoption peut réduire la charge spécifique à maintenir.

La matrice de dépendances indique aussi quels essais exigent des environnements différents. Un Mac distant peut aider à conduire certains travaux de développement ou de construction parallèles, mais il ne fournit pas le socle RNOH à la place de l’équipe et ne prouve rien sur le comportement d’une bibliothèque dans HarmonyOS NEXT. Si un environnement Mac temporaire répond à un besoin distinct de ce chantier, examinez les possibilités de ProxyMac ; pour les dépendances elles-mêmes, la décision doit rester fondée sur les documents RNOH et les validations de l’environnement cible.

FAQ

Une bibliothèque React Native prévue pour Android fonctionne-t-elle directement sous HarmonyOS NEXT ?+
Pas nécessairement. Une bibliothèque peut exposer une interface JavaScript réutilisable tout en dépendant d’un module natif Android absent de l’environnement HarmonyOS NEXT. Vérifiez si une adaptation RNOH existe, si elle couvre la fonction réellement utilisée et si sa documentation correspond aux versions du projet. En l’absence de ces éléments, traitez la dépendance comme non validée plutôt que comme compatible.
Comment vérifier si une bibliothèque RN possède une adaptation RNOH ?+
Recherchez son nom dans la documentation des bibliothèques RNOH, puis ouvrez la fiche ou le dépôt de l’adaptation mentionnée. Vérifiez qu’il s’agit bien d’un paquet d’adaptation, et non d’une simple entrée de catalogue, puis relevez les fonctions annoncées, les prérequis et les éventuelles limites. Enfin, reproduisez le cas d’usage du projet sur son environnement cible.
Quelles versions faut-il rapprocher avant d’intégrer une bibliothèque RNOH ?+
Consignez les versions de React Native, du socle RNOH, de la bibliothèque adaptée et de l’outillage du projet. Comparez ces valeurs aux prérequis explicites de la documentation et aux notes de publication correspondantes. Si une contrainte manque, si la plage de compatibilité n’est pas indiquée ou si l’adaptation n’est plus suivie, classez le point comme à vérifier au lieu de déduire une compatibilité.
Faut-il remplacer ou porter soi-même une dépendance sans adaptation HarmonyOS ?+
Commencez par chercher une solution équivalente dont l’adaptation et le suivi sont documentés. Si la fonction est périphérique, le remplacement est souvent plus simple à maintenir qu’un portage isolé. Réservez l’adaptation interne aux capacités réellement indispensables, après avoir chiffré le travail de validation, les responsabilités de maintenance et les conséquences d’une évolution de l’API native.

Équipez vos validations React Native avec un Mac dédié

ProxyMac vous donne accès à un Mac mini M4 physique, doté d’un environnement macOS complet pour vos outils de développement.
Configurez votre environnement à distance par SSH ou VNC et examinez vos dépendances dans des conditions maîtrisées.