Setup Vessel SDK

Step 1: Add internet permission

Your app must request the "INTERNET" and "ACCESS_NETWORK_STATE" permissions. If your app already requests these permissions, skip to the next step.

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>

Step 2: Initialise Vessel SDK

Add following import statement in your Activity before setContentView or in Application Context

import com.vessel.VesselSDK;

public void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    // Initialise Vessel 
    VesselSDK.initialize(getApplicationContext(), secretKey); 
        .......
    //Your code goes here
}

Step 3: Enable Tracking

Add following line in your on create, onPause and onResume as follows.

@Override
protected void onPause() {
    VesselAB.onPause(YOUR_ACTIVITY.this);
    super.onPause();
}

@Override
protected void onResume() {
    VesselAB.onResume();
    super.onResume(YOUR_ACTIVITY.this);
}

Step 4 (Optional)

In case if you are using ProGuard for your application, then add following lines in your proguard.cfg file, It will be located inside your project folder.It will exclude VesselSDK from obfuscation process.

-dontwarn com.vessel.* 
    -dontnote com.vessel.*
    -keep class com.vessel.** { *; }

At this point you have successfully integrated VesselSDK in your application , to test the integration build and install application on your test device or on simulator. Proceed to next tutorial, enable in-app support desk.

Setup Vessel Framework

  • Open your AppDelegate.m file. Import Vessel header as shown below.

    #import <Vessel/Vessel.h>

    To initilize Vessel Framework add the following line inside the application:didFinishLaunchingWithOptions function.

    [[Vessel sharedInstance] initializeWithAppSecret:@"APP_KEY"];

  • Build and run your app.

    • Getting started with Vessel

    Step 1: Download

    1. Login to Vessel Command Center
    2. Add your application
    3. Get Vessel Secret Key
    4. Download the Android SDK and iOS framework:
      Android SDK   iOS Framework

    Step 1: Add plugin to you project

    $ phonegap local plugin add https://github.com/vesselio/PhoneGapPlugin.git

    // To ensure if its added correctly execute following command
    $phonegap local plugin list
    [phonegap] com.vessel.abplugin 

    //Soon it will be available in official plugin directory.

    Step 2: Initialize Vessel A/B Platform

    After adding plugin open your main / index.html file and add

    Attach Event listener on "deviceready" method as follows 

    document.addEventListener("deviceready", onDeviceReady, false);

    function onDeviceReady() {
    // Now safe to use the PhoneGap API

    // Initialize Vessel A/B testing platform. You can simply initialize it once.
    var YOUR_SECRET_KEY = 'YOUR_APP_KEY';
    vesselab.initialize(
    function(){console.log("VesselSDK Init done.");},
    function(error){ console.log("an error occurred:" + error); },
    YOUR_SECRET_KEY
    );
}

    Step 3: For iOS platform

    In case if you experience any problem while building your application for iOS platform then verify

    1. Make sure Vessel.Framework is correctly linked, If not link it from libs folder of plugin.
    2. Make sure libsqlite3.dylib is correctly linked, If not click of Build Settings > Link Binary with Libraries and add libsqlite3.dylib.
    3. If its still giving you problem, then go to Build Settings > Compile Sources settings. And make sure VesselPlugin.m is listed their. If its missing please add VesselPlugin.m in your project.

    Getting started with Vessel


    Step 1: Register Application and get Secret Key

    1. Login to Vessel Command Center
    2. Add your application
    3. Get Vessel Secret Key


    Step 2: Get the Android and iOS Modules

    1. Download Titanium Modules:
      Android Module   iOS Module
    2. Drag the .zip files from the download location into the project, placing it at the root of the project. Choose to "Copy Files".


    Step 3: Add module entry to tiapp.xml

    Open the tiapp.xml and add the following entries.

    <modules>
  <!-- Other modules can be present here -->
  <module platform="android" version="1.0">io.vessel</module>
  <module platform="iphone" version="1.0">io.vessel</module>
</modules>

    Step 4: Initialize Vessel A/B Platform

    After adding module, VesselSDK should be initialized in app.js as follows. 

    var VesselSDK = require('io.vessel');
VesselSDK.initialize('<secret_key>');

    Getting started with Vessel

    Step 1: Register Application and get Secret Key

    1. Login to Vessel Command Center
    2. Add your application
    3. Get Vessel Secret Key

    Step 2: Install

    1. Download the Windows SDK:
      Windows SDK
    2. Add VesselSDK.dll to your project's references in Visual Studio.

    Step 3: Permissions

    In WMAppManifest.xml go to Capabilities tab. Make sure the following options are enabled:

    ID_CAP_IDENTITY_DEVICE
    ID_CAP_NETWORKING
    ID_CAP_LOCATION

    Step 4: Initialize Vessel A/B Platform

    Add sdk initialization to App.xaml.cs:

    using Vessel;
    
    ...
    
    private void Application_Launching(object sender, LaunchingEventArgs e)
    {
    VesselSDK.initialize("secret_key");
}
    Previous
    Next