Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/powermobileweb/firebase-mlkit

React Native wrapper for functionality of https://developers.google.com/ml-kit/
https://github.com/powermobileweb/firebase-mlkit

firebase firebase-mlkit javascript mlkit react-native

Last synced: 17 days ago
JSON representation

React Native wrapper for functionality of https://developers.google.com/ml-kit/

Awesome Lists containing this project

README

        

# react-native-firebase-mlkit
React Native wrapper for functionality of https://developers.google.com/ml-kit/

## Getting started

`$ npm install react-native-firebase-mlkit --save`

## Compatibility

As of the moment, this wrapper of firebase Ml Kit supports Android and iOS.

## Mostly automatic installation

`$ react-native link react-native-firebase-mlkit`

*Don't forget to ...*
- *add google-services.json to the appropriate folder (/android/app/) __(Android only)__*
- *add GoogleService-Info.plist to the appropriate folder (/ios/) __(iOS only)__*
- *install [CocoaPods](https://cocoapods.org/) in your react-native project and add the following line to your Podfile then run `pod install` __(iOS only)__*
```
pod 'Firebase/Core'
pod 'Firebase/MLVision'
pod 'Firebase/MLVisionTextModel'
pod 'Firebase/MLVisionBarcodeModel'
```

### Manual installation

#### iOS

1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]`
2. Go to `node_modules` ➜ `react-native-firebase-mlkit` and add `RNMlKit.xcodeproj`
3. In XCode, in the project navigator, select your project. Add `libRNMlKit.a` to your project's `Build Phases` ➜ `Link Binary With Libraries`
4. Run your project (`Cmd+R`)<

```
Error: MLVisionTextModel duplicate symbols with React Native

Solved enabling the dead code stripping in xcode for debug.
You can enable it in Target > Build Settings > search for "Dead code stripping".

```

#### Android

1. Open up `android/app/src/main/java/[...]/MainActivity.java`
- Add `import com.mlkit.RNMlKitPackage;` to the imports at the top of the file
- Add `new RNMlKitPackage()` to the list returned by the `getPackages()` method
2. Append the following lines to `android/settings.gradle`:
```
include ':react-native-firebase-mlkit'
project(':react-native-firebase-mlkit').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-firebase-mlkit/android')
```
3. Insert the following lines inside the dependencies block in `android/app/build.gradle`:

```
...
dependencies {
implementation 'com.google.firebase:firebase-core:16.0.1'
implementation 'com.google.firebase:firebase-ml-vision:17.0.0'

implementation (project(':react-native-firebase-mlkit')) {
exclude group: 'com.google.firebase'
}
}

// Place this line at the end of file

apply plugin: 'com.google.gms.google-services'

// Work around for onesignal-gradle-plugin compatibility
com.google.gms.googleservices.GoogleServicesPlugin.config.disableVersionCheck = true
```

4. Insert the following lines inside the dependencies block in `android/build.gradle`:

```
buildscript {
repositories {
google()
...
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.1'
classpath 'com.google.gms:google-services:4.0.2' // google-services plugin
}
}
```

## Usage (Example using [react-native-camera](https://github.com/react-native-community/react-native-camera))

```javascript

import RNMlKit from 'react-native-firebase-mlkit';

export class textRecognition extends Component {
...

async takePicture() {
if (this.camera) {
const options = { quality: 0.5, base64: true, skipProcessing: true, forceUpOrientation: true };
const data = await this.camera.takePictureAsync(options);
// for on-device (Supports Android and iOS)
const deviceTextRecognition = await RNMlKit.deviceTextRecognition(data.uri);
console.log('Text Recognition On-Device', deviceTextRecognition);
// for cloud (At the moment supports only Android)
const cloudTextRecognition = await RNMlKit.cloudTextRecognition(data.uri);
console.log('Text Recognition Cloud', cloudTextRecognition);
}
};

...
}
```