Aller au contenu principal

Installation du SDK React Native

Package npm public pas encore disponible

Le SDK React Native n’est pas encore publié sur le registre npm public. Installez depuis le dépôt Bitbucket (accès restreint). Consultez la page Téléchargements & sources d’installation pour l’URL d’installation actuelle et la configuration Android.

Installer le package​

Utilisez l’URL d’installation depuis la page Téléchargements (source unique pour les liens) :

yarn add "https://bitbucket.org/azeoo/react-native-azeoo-lib.git"
# or
npm install "https://bitbucket.org/azeoo/react-native-azeoo-lib.git"

Si l’hôte est privé, configurez l’accès (mot de passe de l’application dans l’URL, URL Git SSH, ou .npmrc / .yarnrc.yml selon les cas).

Optionnel : installer depuis un .tgz​

Certaines équipes fournissent une archive compilée au lieu de Git. Installez le fichier ou l’URL de la même manière que n’importe quel package local/npm, puis ajoutez quand même react-native-nitro-modules ci-dessous.

Dépendance entre pairs : react-native-nitro-modules​

Le SDK s’attend à trouver react-native-nitro-modules dans votre application. Ajoutez-le s’il n’est pas déjà présent :

yarn add react-native-nitro-modules
# or
npm install react-native-nitro-modules

Utilisez une version qui satisfait les peerDependencies de votre release react-native-azeoo-lib (vérifiez le package.json du package ou vos notes de release).

Configuration iOS​

  1. Depuis la racine de votre application (où se trouve ios/), installez les pods :

    cd ios && pod install && cd ..

  2. Les modules natifs sont détectés via autolinking — aucune entrée manuelle dans le Podfile n’est requise pour cette librairie.

Expo (dev client / prebuild) : après un changement des dépendances natives, lancez une build native (npx expo run:ios) ou ouvrez le projet ios et exécutez pod install dans ios/ si vous maintenez un dossier ios.

Configuration Android (requise)​

Dans le fichier android/build.gradle au niveau du projet (à côté du dossier android/, c’est celui qui définit buildscript / repositories — pas android/app/build.gradle), ajoutez :

apply from: "../node_modules/react-native-azeoo-lib/android/azeoolib-dependencies.gradle"

Le chemin est relatif au répertoire android/ de votre application React Native. Si vous utilisez une structure personnalisée (par ex. node_modules “hoisted”), ajustez le segment qui pointe de android/ vers le package sous node_modules.

Cet extrait Gradle connecte les dépôts Maven nécessaires pour le SDK Azeoo natif et le moteur Flutter. Sans cela, Gradle ne résoudra pas ces artefacts.

Après l’installation​

  1. Reconstruisez l’application native (un build propre si vous avez mis à jour des dépendances natives).
  2. Dans le code, importez react-native-azeoo-lib et enveloppez l’arbre qui utilise le SDK avec AzeooProvider.

Ensuite : Démarrage rapide et Intégration.

Android: autolinking / “No variants exist”​

Si Gradle indique aucune variante correspondante ou aucune variante existante pour react-native-azeoo-lib ou react-native-nitro-modules, effacez l’autolinking généré puis reconstruisez (depuis la racine de votre application, souvent android/) :

rm -rf android/build/generated/autolinking

Puis relancez votre build Android.

Prochaines étapes​