Setup

Installation#

You can install the React Native Flybuy SDK with npm or yarn, as follows:

npm
Yarn

npm install --save react-native-bildit-flybuy-core

# RN >= 0.60

cd ios && pod install

# RN < 0.60

react-native link react-native-bildit-flybuy-core

info

This wrapper only tested on React Native version 0.74.x. This wrapper should work with any latest React Native version that using Android Gradle Plugin version 8.2.1 or more. Minimum deployment target for iOS is 13.4

Post-install Steps#

iOS#

Setting Permissions#

Refer to the Flybuy Documentation on configuring permissions on iOS.

Fix Development Build#

By default, you don't have to modify the Podfile to run this library. If you have issue with dynamic framework, you can include the library as static framework by adding this code in Podfile.

  $static_framework += [
    # adjust the packages that you used in your project.
    'bildit-platform-rn-flybuy-core',
    'bildit-platform-rn-flybuy-pickup'
  ]

Fix Release Build#

If you have trouble running the app in Release mode with error Undefined symbol: _OBJC_CLASS_$_Flybuy, you can fix it by changing your project Build Settings and set Build Active Architecture Only to Yes.

XCode change

Android#

Gradle#

Modify android/build.gradle
buildscript {
ext {
buildToolsVersion = "34.0.0"
minSdkVersion = 26 // <-- the minimum supported SDK for the latest FlyBuy SDK
compileSdkVersion = 34
targetSdkVersion = 34
ndkVersion = "26.1.10909125"
kotlinVersion = "1.9.22"
flybuyVersion = "2.12.1" // <-- add this line
}
}

Note: Modify flybuyVersion with your desired SDK version, the default value is 2.12.1
Modify android/app/build.gradle
{
android {
defaultConfig {
applicationId "your.package.name"
minSdkVersion rootProject.ext.minSdkVersion
targetSdkVersion rootProject.ext.targetSdkVersion
versionCode 1
versionName "1.0"

missingDimensionStrategy "flybuy", "default" // <-- add this line
}
}
}

Google API Keys#

Refer to Flybuy Documentation on setting Google API Keys.

Permissions#

Refer to Flybuy Documentation for permission requirements on Android.

Requesting location permissions at runtime#

The following code snipper provides an example of requesting location permissions at runtime.

import {
  requestMultiple,
  PERMISSIONS,
  RESULTS,
} from 'react-native-permissions';

const getLocationPermissions = async () => {
  const granted = await requestMultiple(
    Platform.select({
      android: [
        PERMISSIONS.ANDROID.ACCESS_BACKGROUND_LOCATION,
        PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION,
      ],
      ios: [PERMISSIONS.IOS.LOCATION_WHEN_IN_USE],
    }),
    {
      title: 'ExampleApp',
      message: 'ExampleApp would like access to your location ',
    }
  );
  return granted === RESULTS.GRANTED;
};

React.useEffect(() => {
  getLocationPermissions();
}, []);

info

Whenever the location permission changes (accepted or declined), make sure to call:

// If using pickup module
import * as FlyBuyPickup from 'react-native-bildit-flybuy-pickup'

FlyBuyPickup.onPermissionChanged();

// If using notify module
import * as FlyBuyNotify from 'react-native-bildit-flybuy-notify'

FlyBuyNotify.onPermissionChanged();