recco

Description:

recco

Recco Flutter Plugin #
This repository holds the codebase for the Recco Flutter plugin. Instructions on how to add and use this plugin can be found in the Usage section.
Overview #
Personalized, and user-friendly approach to health and wellness recommendations based on users' unique interests, motivations, and health behaviors. Whether they are looking to improve their fitness, manage their stress, or simply lead a more fulfilling life. Recco is designed to help them reach their full potential.
Learn more about Recco SDK:

Recco SDK Android
Recco SDK iOS

Usage #
Add this to pubspec.yaml
dependencies:
recco: 1.3.0
copied to clipboard
Setup on Android #
Github Packages #
This Flutter plugin internally depends on the Recco Android SDK, which exposes its components through Github Packages. Therefore, the configuration for Github Packages is required. Please refer to the Personal Access Token section to obtain a valid set of credentials. Once you have a valid Github PAT, proceed to configure your gradle.properties file located under the ~/.gradle/ folder.
gprUser=your-github-user-here
gprKey=your-github-PAT-here
copied to clipboard
After setting the Github credentials, then you have to add to your app build.gradle file the next configuration to be able to fetch the packages:
repositories {
mavenLocal()
maven { url 'https://jitpack.io' }
maven {
name = "GithubPackages"
url = "https://maven.pkg.github.com/SignificoHealth/recco-android-sdk"
credentials {
username = gprUser
password = gprKey
}
}
}
copied to clipboard
Check Android Gradle plugin version and source compatibility #
Ensure that in your root/top level build.gradle file the Android Gradle plugin version is at least 7.4.0
Ensure that in your root/top level build.gradle file the Kotlin version is at least 1.9.0
buildscript {
ext.kotlin_version = '1.9.0'
...
}
copied to clipboard
Make sure also that in your app build.gradle is provided the following source compatibility configuration:
android {
//...
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}

kotlinOptions {
jvmTarget = JavaVersion.VERSION_17.toString()
}
}
copied to clipboard
Hilt dependency #
Recco Android SDK depends internally on Hilt. If your Android app does not use Hilt already, you will have to add this setup:
In your root/top level build.gradle file, add the Hilt plugin:
plugins {
// ...
id 'com.google.dagger.hilt.android' version "2.47" apply false
id 'org.jetbrains.kotlin.android' version '1.8.0' apply false
}
copied to clipboard
Then, in your app build.gradle file, resolve the Kapt and Hilt plugins, and add Hilt dependencies:
apply plugin: 'kotlin-kapt'
apply plugin: 'com.google.dagger.hilt.android'

dependencies {
implementation "com.google.dagger:hilt-android:2.47"
kapt "com.google.dagger:hilt-android-compiler:2.47"
}
copied to clipboard
As the last step, decorate your Application class with the @HiltAndroidApp annotation:
@HiltAndroidApp
class ShowcaseApp : FlutterApplication() {

}
copied to clipboard
and add it to the AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application
android:name=".ShowcaseApp"
copied to clipboard
You can check the Flutter example Android app for more details.
Setup on iOS #
This Flutter plugin internally depends on the Recco iOS SDK, which exposes its components through CocoaPods. Important: Please make sure your Cocoapods master repo is up to date by running pod repo update. After this, you need to add the Recco pod to your Podfile as follow:
pod 'ReccoUI'
copied to clipboard
Note: Make sure you have defined platform :ios, '14.0' or higher in your Podfile.
ReccoPlugin new Instance #
final Recco _reccoPlugin = Recco();
copied to clipboard
Init #
Initialize Recco SDK at the initState of your app.
Future<void> _initializeRecco(String clientSecret) async {
try {
_reccoPlugin.initialize(clientSecret, ReccoStyle.spring(
androidFont: AndroidFont.poppins,
iosFont: IOSFont.sfPro
));
} on PlatformException catch (e) {
debugPrint("Error: '${e.message}'.");
}
}
copied to clipboard
As part of the initialize setup, you need to supply a ReccoStyle instance to configure some customization entry points:

IOSFont & AndroidFont: These components expose the set of available predefined fonts for each platform.
ReccoStyleColors: Defines the available colors to be customized as part of the palette. There already existing palettes to choose from, such as fresh or ocean.

Login #
Future<String> _loginReccoSDK(String userId) async {
try {
_reccoPlugin.login(userId);
} on PlatformException catch (e) {
debugPrint("Error: '${e.message}'.");
}
return userId;
}
copied to clipboard
Logout #
Future<void> _logoutReccoSDK() async {
try {
_reccoPlugin.logout();
} on PlatformException catch (e) {
debugPrint("Error: '${e.message}'.");
}
}
copied to clipboard
OpenReccoUi #
Future<void> _openReccoUI() async {
try {
_reccoPlugin.openReccoUI();
} on PlatformException catch (e) {
debugPrint("Error: '${e.message}'.");
}
}
copied to clipboard