Skip to main content

React Native Installation

Public npm package not yet available

The React Native SDK is not yet published to the public npm registry. Install from the Bitbucket repository (restricted access). See the Downloads & install sources page for the current install URL and Android setup.

Install the package​

Use the install URL from the Downloads page (single source for links):

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

If the host is private, configure access (app password in the URL, SSH Git URL, or .npmrc / .yarnrc.yml as appropriate).

Optional: install from a .tgz​

Some teams ship a built archive instead of Git. Install the file or URL the same way as any local/npm package, then still add react-native-nitro-modules below.

Peer dependency: react-native-nitro-modules​

The SDK expects react-native-nitro-modules in your app. Add it if it is not already there:

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

Use a version that satisfies the peerDependencies of your react-native-azeoo-lib release (check that package’s package.json or your release notes).

iOS setup​

  1. From the root of your app (where ios/ lives), install pods:

    cd ios && pod install && cd ..

  2. Native modules are picked up by autolinking — no manual Podfile entry is required for this library.

Expo (dev client / prebuild): after native dependencies change, run a native build (npx expo run:ios) or open the ios project and run pod install in ios/ when you maintain an ios folder.

Android setup (required)​

In the project-level android/build.gradle (next to the android/ folder, the file that defines buildscript / repositories — not android/app/build.gradle), add:

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

The path is relative to the android/ directory of your React Native app. If you use a custom layout (e.g. hoisted node_modules), adjust the segment that points from android/ to the package under node_modules.

This Gradle snippet wires the Maven repositories needed for the native Azeoo SDK and the Flutter engine. Without it, Gradle will not resolve those artifacts.

After installing​

  1. Rebuild the native app (clean build if you upgraded native deps).
  2. In code, import react-native-azeoo-lib and wrap the tree that uses the SDK with AzeooProvider.

Next: Quick Start and Integration.

Android: autolinking / “No variants exist”​

If Gradle reports no matching variant or no variants exist for react-native-azeoo-lib or react-native-nitro-modules, clear generated autolinking and rebuild (from your app root, often android/):

rm -rf android/build/generated/autolinking

Then run your Android build again.

Next steps​