Morioh
Login
Mhret Aatifa

Mhret Aatifa

3 years ago

React Native Indy SDK Wrapper

React Native Indy SDK

React Native Indy SDK wrapper.

Installation

with npm: $ npm install rn-indy-sdk --save

with Yarn: $ yarn add rn-indy-sdk

Link (for React Native lower than 0.60)

$ react-native link rn-indy-sdk

Android

See https://github.com/TimoGlastra/ExampleRnIndySDK for an example android react native project that follows this tutorial.

1. Set min SDK version

Make sure there is a min. SDK version setup in android/build.gradle:

buildscript {
    ext {
        ...
        minSdkVersion = 21
        ...
    }
}

2. Add Sovrin Maven repository

Add Sovrin Maven repository into android/build.gradle:

allprojects {
    repositories {
        ...
        maven {
            url 'https://repo.sovrin.org/repository/maven-public'
        }
        ...
    }
}

3. Add JNA library dependency

Add to android/app/build.gradle:

dependencies {
    // ...
    implementation 'net.java.dev.jna:jna:5.2.0'

    // ...
}

4. Add Android libindy binaries

Download Android libindy binaries and copy them into android/app/src/main/jniLibs.

  1. Create android/app/src/main/jniLibs directory in your project
  2. Create subdirectories arm64-v8a, armeabi-v7a, x86 and x86_64 inside android/app/src/main/jniLibs.
  3. Download the required libindy binaries for your release-channel and version
    • with stable channel and version 1.15.0 base url will be https://repo.sovrin.org/android/libindy/stable/1.15.0/
    • download the binaries for arm64, armv7, x86 and x86_64, e.g.:
      • libindy_android_arm64_1.15.0.zip
      • libindy_android_armv7_1.15.0.zip
      • libindy_android_x86_1.15.0.zip
      • libindy_android_x86_64_1.15.0.zip
  4. Extract all downloaded ZIP files and copy libindy.so files to corresponding jniLibs directory
    • libindy_arm64/lib/libindy.so to jniLibs/arm64-v8a/libindy.so
    • libindy_armv7/lib/libindy.so to jniLibs/armeabi-v7a/libindy.so
    • libindy_x86/lib/libindy.so to jniLibs/x86/libindy.so
    • libindy_x86_64/lib/libindy.so to jniLibs/x86_64/libindy.so
  5. Download the required JNA binaries from the JNA GitHub repo
  6. Extract all downloaded JAR files and copy libjnidispatch.so to corresponding jniLibs directory
    • You can extract the .so file from the jar using the jar command. e.g. jar xf android-x86.jar
    • libjnidispatch.so from android-aarch64.jar to jniLibs/arm64-v8a/libjnidispatch.so
    • libjnidispatch.so from android-armv7.jar to jniLibs/armeabi-v7a/libjnidispatch.so
    • libjnidispatch.so from android-x86.jar to jniLibs/x86/libjnidispatch.so
    • libjnidispatch.so from android-x86-64.jar to jniLibs/x86_64/libjnidispatch.so

5. Load indy library

Add the following to MainActivity.java:

//...

import android.os.Bundle;
import android.system.ErrnoException;
import android.system.Os;
import java.io.File;

public class MainActivity extends ReactActivity {
  //...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    try {
      Os.setenv("EXTERNAL_STORAGE", getExternalFilesDir(null).getAbsolutePath(), true);
      System.loadLibrary("indy");
    } catch (ErrnoException e) {
      e.printStackTrace();
    }
  }
}

iOS

Add Indy.framework as dependency into your project. Beware that the library needs to be compiled with the same version of Swift as your project.

React Native wrapper for iOS is written in Swift so you need to Create briding header. In Xcode app menu go to File -> New -> File… Select Swift File from dialog window and click Next and Finish. Xcode shoud ask you “Would you like to configure an Objective-C briding header?” then select Create Bridinging Header.

Usage

import indy from 'rn-indy-sdk'

await indy.createWallet({ id: 'wallet-123' }, { key: 'key' })

You can see example project here https://github.com/jakubkoci/UseReactNativeIndySdk/. It currently shows only usage on Android.

Known Errors

Add setup of external storage permissions (Android)

I found an error with permission while calling createWallet when I was testing this package:

2020-01-27 16:25:02.300 9955-10044/com.usereactnativeindysdk E/log_panics: thread 'unnamed' panicked at 'called `Result::unwrap()` on an `Err` value: Os { code: 13, kind: PermissionDenied, message: "Permission denied" }': libcore/result.rs:945

Modify onCreate method in MainActivity of your project where you want to use this library in a following way:

public class MainActivity extends ReactActivity {
  ...
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ...
    File externalFilesDir = getExternalFilesDir(null);
    String path = externalFilesDir.getAbsolutePath();
    System.out.println("externalFilesDir=" + path);

    try {
      Os.setenv("EXTERNAL_STORAGE", path, true);
    } catch (ErrnoException e) {
      e.printStackTrace();
    }
    ...
  }
  ...
}

This should resolve the issue with permissions.

Download Details:

Author: AbsaOSS

Source Code: https://github.com/AbsaOSS/rn-indy-sdk

#react #react-native #mobile-apps

React Native Indy SDK Wrapper
4.10 GEEK