About YesGraph

YesGraph helps apps grow by providing incredible social invite flows and recommending which friends a user should invite. Under the the hood is deep social graph analysis and machine learning to make these recommendations.

YesGraph Android SDK is a sharing Android SDK that integrates with YesGraph. It presents user with a share sheet that can be used to share a message to user's friends to multiple sources, such as: Facebook, Twitter, or the user's mobile address book. Read more about that on our blog.

Find detailed documentation about YesGraph on docs.yesgraph.com

Requirements

The SDK is compatible with Android apps with Android SDK version 15 and above.

Installation

The easiest way to integrate is with JCenter. Put this text into your build.gradle file:

repositories {
  jcenter()
}

dependencies {
  classpath 'com.yesgraph.android:yesgraph:1.0'
}

An alternate way to integrate is installing as Static Library

Compile and build the project
Copy the 'aar' file from the [module_home_directory]/build/outputs/yesgraph-[debug/release].aar
Put the 'aar' file into your 'libs' folder
Add these lines to your build.gradle file:

repositories {
   flatDir {
       dirs 'libs'
   }
}

dependencies {
   compile(name:'yesgraph-[debug|release]', ext:'aar')
}

You will also need to fill the manifest metadata for the Twitter and Facebook SDK.

<activity
android:name="com.facebook.FacebookActivity"
android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:label="@string/app_name" />

<meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>

<meta-data android:name="io.fabric.ApiKey" android:value="<API_KEY_FOR_FABRIC>" />

Or integrate it manually.

Example applications

There is an example application included in the repository, that display the share sheet when triggered.

Getting Started with Example applications

Before you can use the example app, you need to configure the app with your YesGraph client key. Because YesGraph treats mobile devices as untrusted clients, first you need a trusted backend to generate client keys.

If you haven't already, sign up for a YesGraph account (it takes seconds). Then go to YesGraph Dashboard: https://www.yesgraph.com/apps/.
Copy the live secret key on the bottom of the page to your trusted backend.
Call your trusted backend with user ID, to get the client key back (you can generate a random user ID, if user is not known, by using Utility class and randomUserId method.

Configure YesGraph Android SDK with received client key and user ID:

private YesGraph yesGraphApplication;

yesGraphApplication = (YesGraph) getApplicationContext();
yesGraphApplication.configureWithUserId("<USER_ID>");
yesGraphApplication.configureWithClientKey("<CLIENT KEY>");

yesGraphApplication.setSource("Name", "+1 123 123 123", "Email");

Run the desired Example app.

Tests

YesGraph Android SDK contains unit tests that can be executed in AndroidStudio.

License

YesGraph Android SDK is released under MIT license. See LICENSE file for more information.