FlyBuy SDK for Xamarin.iOS

Setup

The FlyBuy SDK is published on nuget.org at the following location: https://www.nuget.org/packages/Radiusnetworks.Flybuy.IOS

Add FlyBuySDK to your Xamarin.iOS project

Select Packages in your VS project and go to Manage NuGet Packages.... Search for Radiusnetworks.Flybuy.IOS and click Add Package. The latest SDK will be added to your project and can be referenced with the following:

using FlyBuy;

Initialize SDK on Launch

The iOS SDK is broken up into 3 modules:

• pickup
• presence
• notify

Flybuy needs to be setup and configured at application launch. However, it does not run in the background or use device resources until there is an active order.

The easiest way to configure Flybuy in your app is to call the FlyBuyCore.Configure(...) method from FinishedLaunching() to setup the API token. Also, any modules that are used need to be configured. The example below shows all modules, but make sure to only configure the modules needed.

public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
{
    var opts = new NSDictionary<NSString, NSObject>(
        new NSString("token"), new NSString("TOKEN")
    );

    FlyBuyCore.Configure(opts);
    FlyBuyPickupManager.Shared.Configure();
    FlyBuyPresenceManager.Shared.Configure();
    FlyBuyNotifyManager.Shared.Configure();
}

Components

The following section provides some examples C# syntax for the customer and order components. Refer to the native documentation for complete details on the SDK components.

Use the following to determine if a customer is associated with the app:

Customer currentCustomer = FlyBuyCore.Customer.Current;

If no customer, then create the customer using:

CustomerInfo customerInfo = new FlyBuyCustomerInfo(
        "Marty McFly",
        "DeLorean",
        "Silver",
        "OUTATIME",
        "555-555-5555"
);
FlyBuyCore.Customer.Create(customerInfo, true, true, createCustomerCallback);

Make sure to fetch the order after calling claim using:

FlyBuyCore.Orders.ClaimWithRedemptionCode(redemptionCode, customerInfo, null, claimCallback);
FlyBuyCore.Orders.FetchWithCallback(fetchCallback);

To update an order use:

FlyBuyCore.Orders.UpdateCustomerStateWithOrderID(currentOrder.Id, "completed", completeOrderCallback);

Creating iOS bindings library in Xamarin for FlyBuy

1. Download the latest native SDK release from https://github.com/RadiusNetworks/flybuy-ios/releases

2. Unzip the archive and copy the xcframework directories for each module to their related directories. E.G.

   flybuy-ios-2.1.5/FlyBuyPickup.xcframework --> FlyBuyPickup
   

3. Select Native References in the VS project for each module and add the related framework for the ios-arm64 binary.

4. Install Objective Sharpie to generate the binding API definitions.

5. Start from the project root directory, the use the following command to find the current iOS SDK version installed.

   sharpie xcode -sdks
   

6. Run the following sharpie commands (using current iOS SDK version):

   sharpie bind --output=FlyBuy --namespace=FlyBuy -framework FlyBuy/FlyBuy.xcframework/ios-arm64/FlyBuy.framework -sdk=iphoneos14.4
   

   sharpie bind --output=FlyBuyPickup --namespace=FlyBuy -framework FlyBuyPickup/FlyBuyPickup.xcframework/ios-arm64/FlyBuyPickup.framework -sdk=iphoneos14.4
   

   sharpie bind --output=FlyBuyNotify --namespace=FlyBuy -framework FlyBuyNotify/FlyBuyNotify.xcframework/ios-arm64/FlyBuyNotify.framework -sdk=iphoneos14.4
   

   sharpie bind --output=FlyBuyPresence --namespace=FlyBuy -framework FlyBuyPresence/FlyBuyPresence.xcframework/ios-arm64/FlyBuyPresence.framework -sdk=iphoneos14.4
   

   sharpie bind --output=FlyBuyTableside --namespace=FlyBuy -framework FlyBuyTableside/FlyBuyTableside.xcframework/ios-arm64/FlyBuyTableside.framework -sdk=iphoneos14.4
   

7. In ApiDefinitions.cs, delete the "verify" build errors related to MethodToProperty.

8. The bindings project will now reference the new xcframework and API definition files and can be built.