Installation

Follow these steps to include the SDK into your mobile application project.

iOS

Install Swift Package for Xcode 14.3 or newer

1. Open your Xcode project.

2. Go to File > Swift Packages > Add Package Dependency.

3. In the "Add Package Dependency" dialog box, paste the URL: https://github.com/Passiolife/Passio-Nutrition-AI-iOS-SDK-Distribution

4. Click "Next". Xcode will validate the package and its dependencies.

5. In the next dialog box, you'll be asked to specify the version or branch you want to use. You can choose main for the latest version or specify a specific version or branch.

6. After you've made your selection, click "Next".

7. You'll then be prompted to select the targets in your project that should include the package. Check the boxes for the targets you want to include.

8. Click "Finish" to add the package to your project.

9. Xcode will download and add the PassioNutritionAISDK to your project. You can now import and start using the PassioNutritionAISDK.

Manual Installation For Xcode lower than 14.3

• Download the "PassioNutritionAISDK.xcframework.zip" file from https://github.com/Passiolife/Passio-Nutrition-AI-iOS-SDK-Distribution/blob/main/PassioNutritionAISDK.xcframework.zip

• Unzip it and drag and drop it into your project. Make sure to select "Copy items if needed".

• In project "General" -> "Frameworks, Libraries and Embedded Content" Change to "Embed & Sign"

Edit your Info.plist

• If opening from Xcode, right click and select 'open as source code'

• To allow camera usage add:

`<key>>NSCameraUsageDescription</key><string>For real-time food recognition</string>`.

The Passio Android SDK is shipped in the form of an .aar file.

Android

1. Add the dependency using Maven

In the build.gradle file add the PassioSDK dependency

dependencies {
    implementation 'ai.passio.passiosdk:nutrition-ai:3.2.1-3'
}

Sync Project with Gradle Files and the PassioSDK interface should be available for usage.

2. Or download the .aar from our distribution repository

• Visit the releases page of the Android-Passio-SDK-Distribution GitHub repository. Download the passiolib-release.aar file from the latest release.

Include the .aar in your Android Studio project

To include the .aar file into your project go to the module that will contain the food recognition feature. Place the .aar file in the libs folder of the module. If the libs folder is missing, create one. Reference the .aar file in the build.gradle file of the implementing module.

implementation files('libs/passiolib-release.aar')

Sync Project with Gradle Files and be sure that you can reference the PassioSDK class within your code.

Dependencies

Passio Android SDK is powered by TensorFlow and FirebaseVision with the camera being managed by CameraX. Add the dependencies to these three projects by adding these lines to the module's build.gradle file.

dependencies {
    // TensorFlow
    implementation 'org.tensorflow:tensorflow-lite:2.8.0'
    implementation 'org.tensorflow:tensorflow-lite-metadata:0.4.0'

    // CameraX
    def camerax_version = "1.3.0-alpha12"
    implementation "androidx.camera:camera-core:$camerax_version"
    implementation "androidx.camera:camera-camera2:$camerax_version"
    implementation "androidx.camera:camera-lifecycle:$camerax_version"
    implementation 'androidx.camera:camera-view:1.3.0-alpha02'
    implementation 'androidx.camera:camera-extensions:1.3.0-alpha02'

    // Barcode and OCR
    implementation 'com.google.android.gms:play-services-mlkit-text-recognition:19.0.0'
    implementation 'com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0'
}

In order for the SDK to work add the following lines to the android section of the module's build.gradle file.

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Running Sync Project with Gradle Files will enable access to the SDK.

React Native

1. Create a Github Personal Access Token (classic) with read:packages access selected.

2. Create an .npmrc file in the root of your project with the following lines replacing GITHUB_ACCESS_TOKEN with the token you've created.

//npm.pkg.github.com/:_authToken=GITHUB_ACCESS_TOKEN
@passiolife:registry=https://npm.pkg.github.com

3. Add the Passio SDK dependency to your package.json and run npm install or yarn.

npm install @passiolife/nutritionai-react-native-sdk-v3

or

yarn add @passiolife/nutritionai-react-native-sdk-v3

4. Ensure the native dependencies are linked to your app.

For iOS, run pod install.

cd ios; pod install

If pod install is failed with error message Specs satisfying the ReactNativePassioSDK (from ../node_modules/@passiolife/nutritionai-react-native-sdk-v3) dependency were found, but they required a higher minimum deployment target. , ensure Podfile is configured with minimum ios version '13.0'

platform :ios, '13.0'

For Android, add this implementation line to the dependencies section on app/build.gradle file.

dependencies {
    // Add this line below for Passio SDK library
    implementation files("$rootDir/../node_modules/@passiolife/nutritionai-react-native-sdk-v3/android/libs/passiolib-release.aar")
    ...
}

Also for Android, make sure the android project is configured with minSdkVersion 26 or above (check the project's build.gradle file).

buildscript {
    ext {
        ...
        minSdkVersion = 26
        ...
    }
}

Flutter

The Flutter SDK is available as a package on pub.dev

Run the command

 $ flutter pub add nutrition_ai

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

dependencies:
  nutrition_ai: ^3.0.3

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Import

Now in your Dart code, you can use:

import 'package:nutrition_ai/nutrition_ai.dart';

Setup for Android

• Add to top build.gradle file (Project: android)

allprojects {
   repositories {
      ...
      flatDir {
         dirs project(':nutrition_ai').file('libs')
      }
   }
}

• The nutrition_ai build.gradle file dependency section should look like (Module: nutrition_ai)

allprojects {
   repositories {
      ...
      flatDir {
         implementation (name: 'passiolib-release', ext: 'aar')
      }
   }
}