set-up-project-griffon

Set up Project Griffon

{% hint style="warning" %} Project Griffon is a beta product. To use it, you must accept the terms on https://experience.adobe.com/griffon. {% endhint %}

{% hint style="danger" %} Beta products are not supported by Adobe customer care or Adobe Experience Cloud community forums. Please use the Slack channel provided in your beta invite email to ask and resolve concerns. {% endhint %}

How to participate in the Project Griffon beta

1. Request access to Project Griffon by filling out the intake form
2. Setup your app for Project Griffon
3. Visit Project Griffon to start your first session

Request Access to Project Griffon

Please fill out this form to request access for Project Griffon.

{% hint style="info" %} Beta participation requires a valid, active Adobe Experience Cloud contract. Beta participation is subject to terms (as listed above). Project Griffon team do their best to respond on your participation request within 48-72 hours after form submission. {% endhint %}

You may access Project Griffon by visiting https://experience.adobe.com/griffon.

Setup app for Project Griffon

Follow these steps to add Project Griffon to your app:

1. Follow instructions to implement the new Adobe Experience Platform Mobile SDK (skip if already done)
2. Add the Project Griffon Extension to your app
   1. In Experience Platform Launch, click the Extensions tab.
   2. On the Catalog tab, locate the Project Griffon extension, and click Install.
   3. Follow the publishing process to update SDK configuration.
3. Implement Project Griffon SDK APIs in your app

Add Project Griffon Extension to your app

{% hint style="info" %} Use the latest versions of the Adobe Experience Platform Mobile SDK and Project Griffon SDK extension to try out our newest functionality. {% endhint %}

Add Project Griffon

{% tabs %} {% tab title="Android" %} Java

1. Add the following libraries in your project's build.gradle file:

   implementation 'com.adobe.marketing.mobile:core:1+'
   implementation 'com.adobe.marketing.mobile:griffon:1+'

2. Import the Project Griffon libraries with the other SDK libraries:

   import com.adobe.marketing.mobile.Griffon; 
   import com.adobe.marketing.mobile.MobileCore;

{% endtab %}

{% tab title="iOS" %} Add the library to your project via your Cocoapods Podfile

pod 'ACPCore'
pod 'ACPGriffon'

Import the Project Griffon libraries along with other SDK libraries:

Objective-C

#import "ACPCore.h"
#import "ACPGriffon.h" // <-- import the Project Griffon library

Swift

import ACPCore
import ACPGriffon // <-- import the Project Griffon library

{% endtab %}

{% tab title="Flutter" %}

Dart

Flutter install instructions for Griffon can be found here. {% endtab %}

{% tab title="Cordova" %}

Cordova

After creating your Cordova app and adding the Android and iOS platforms, the Project Griffon extension for Cordova can be added with this command:

cordova plugin add https://github.com/adobe/cordova-acpgriffon.git

{% endtab %} {% endtabs %}

Register Griffon with Mobile Core

{% tabs %} {% tab title="Android" %} Registering the extension with Core, sends Experience Platform SDK events to an active Project Griffon session. To start using the extension library, you must first register the extension with the Mobile Core extension.

Java

1. Register the extension when you register other extensions.

     public class MobileApp extends Application {
      @Override
      public void onCreate() {
         super.onCreate();
         MobileCore.setApplication(this);
         MobileCore.configureWithAppId("yourAppId");
         try {
            Griffon.registerExtension();
            MobileCore.start(null);
         } catch (Exception e) {
            // Log the exception
         }
      }
     }

{% endtab %}

{% tab title="iOS" %} Registering the extension with Core sends Experience Platform SDK events to an active Project Griffon session. To start using the extension library, you must first register the extension with the Mobile Core extension.

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [ACPCore configureWithAppId:@"yourAppId"];
    [ACPGriffon registerExtension]; // <-- register Project Griffon with Core
    [ACPCore start:nil];
    // Override point for customization after application launch.
    return YES;
 }

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
     ACPCore.configure(withAppId: "yourAppId")   
     ACPGriffon.registerExtension() // <-- register Project Griffon with Core
     ACPCore.start(nil)
     // Override point for customization after application launch. 
     return true;
}

{% endtab %}

{% tab title="Flutter" %} When using Flutter, registering Griffon with Mobile Core should be done in native code which is shown under the Android and iOS tabs. {% endtab %}

{% tab title="Cordova" %} When using Cordova, registering Griffon with Mobile Core must be done in native code which is shown under the Android and iOS tabs. {% endtab %} {% endtabs %}

Implement Project Griffon session start APIs (iOS)

The startSession API needs to be called to begin a Project Griffon session. When called, SDK displays a PIN authentication overlay to begin a session.

With the latest Project Griffon SDK extensions, Android does not require this API to be called. When the registerExtension API is called, Project Griffon registers the app lifecycle handlers which automatically pick up any deep links and use them to start the session.

{% hint style="info" %} You may call this API when the app launches with a url (see code snippet below for sample usage) {% endhint %}

{% tabs %} {% tab title="iOS" %}

startSession

Objective-C

Syntax

+ (void) startSession: (NSURL* _Nonnull) url;

Example

- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    [ACPGriffon startSession:url];
    return false;
}

In iOS 13 and later, for a scene-based application, use the UISceneDelegate's scene(_:openURLContexts:) method as follows:

- (void) scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    UIOpenURLContext * urlContext = URLContexts.anyObject;
    if (urlContext != nil) {
        [ACPGriffon startSession:urlContext.URL];
    }
}

Swift

Example

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    do {
        ACPGriffon.startSession(url)
        return false
    }
}

In iOS 13 and later, for a scene-based application, use the UISceneDelegate's scene(_:openURLContexts:) method as follows:

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        ACPGriffon.startSession((URLContexts.first!).url)
}

{% endtab %}

{% tab title="Cordova" %}

startSession

Syntax

ACPGriffon.startSession(url, success, error);

Example

ACPGriffon.startSession(sessionUrl, function(handleCallback) {
  console.log("AdobeExperenceSDK: Griffon session start successful: " + handleCallback);
}, function(handleError) {
  console.log("AdobeExperenceSDK: Failed to start griffon session: " + handleError);
});

{% endtab %} {% endtabs %}