Android SDK Setup
(Difference between revisions)
(→Get your Social-ID data) |
|||
Line 1: | Line 1: | ||
− | = | + | = Download the SDK = |
− | + | Import the AAR file into your existing AndroidStudio as a new module and update your project and app .gradle files to include the new module. | |
− | + | ||
− | Import the | + | |
[http://dev.socialidnow.com/index.php/Android_SDK_Download Download the SDK] | [http://dev.socialidnow.com/index.php/Android_SDK_Download Download the SDK] | ||
− | + | = Get your Social-ID data = | |
− | You'll need | + | You'll need 3 variables to configure the SDK: |
* SENDER_ID: Set up a project on Google Developers Console - https://console.developers.google.com/project. Get your project number. This will be used as the SENDER_ID in the SDK. | * SENDER_ID: Set up a project on Google Developers Console - https://console.developers.google.com/project. Get your project number. This will be used as the SENDER_ID in the SDK. | ||
− | * | + | * LOGIN_APP_ID: Set up a Social-ID LoginApp at: https://app.socialidnow.com/marketing/login/apps. Your key is the id of the app. This will be used as the LOGIN_APP_ID in the SDK. |
− | * | + | * LOGIN_APP_CLIENT_SECRET: The client secret can be found on the Call the API menu - https://app.socialidnow.com/marketing/login/apps/APP_ID/apis. This will be used as the LOGIN_APP_CLIENT_SECRET in the SDK. |
− | + | ||
− | + | ||
− | + | = Add the SDK to your app = | |
Add the following import statements to your Activity: | Add the following import statements to your Activity: | ||
Line 26: | Line 22: | ||
Call SocialId.config from the onCreate method of your Activity class to set your application Social-ID configuration: | Call SocialId.config from the onCreate method of your Activity class to set your application Social-ID configuration: | ||
− | SocialId.config(this, "SENDER_ID", " | + | SocialId.config(this, "SENDER_ID", "LOGIN_APP_ID", "LOGIN_APP_CLIENT_SECRET"); |
− | Add the following | + | Add the following variable to the ''res/values/strings.xml'' file: |
+ | <!-- Facebook App ID --> | ||
+ | <string name="app_id">FACEBOOK_APP_ID</string> | ||
− | + | Add the following content to the ''assets/oauth_consumer.properties'' file. Ensure the ''assets'' folder is at the same level as the ''res'' folder. | |
− | + | #twitter | |
− | + | twitter.com.consumer_key = TWITTER_CONSUMER_KEY | |
+ | twitter.com.consumer_secret = TWITTER_CONSUMER_SECRET | ||
+ | |||
+ | #linkedin | ||
+ | api.linkedin.com.consumer_key = LINKEDIN_CLIENT_ID | ||
+ | api.linkedin.com.consumer_secret = LINKEDIN_CLIENT_SECRET | ||
− | + | = Modify app manifest = | |
− | Add the following definitions to AndroidManifest.xml immediately before opening the <application> tag: | + | Add the following definitions to AndroidManifest.xml immediately before opening the ''<application>'' tag: |
<uses-permission android:name="android.permission.INTERNET" /> | <uses-permission android:name="android.permission.INTERNET" /> | ||
<uses-permission android:name="android.permission.GET_ACCOUNTS" /> | <uses-permission android:name="android.permission.GET_ACCOUNTS" /> | ||
<uses-permission android:name="android.permission.USE_CREDENTIALS" /> | <uses-permission android:name="android.permission.USE_CREDENTIALS" /> | ||
− | + | ||
<nowiki><!-- BEGIN: use this if you need push notification support --></nowiki> | <nowiki><!-- BEGIN: use this if you need push notification support --></nowiki> | ||
<uses-permission android:name="android.permission.WAKE_LOCK" /> | <uses-permission android:name="android.permission.WAKE_LOCK" /> | ||
Line 53: | Line 56: | ||
<nowiki><!-- END: use this if you need push notification support --></nowiki> | <nowiki><!-- END: use this if you need push notification support --></nowiki> | ||
− | Add the following definitions to AndroidManifest.xml inside the <application> tag: | + | Add the following definitions to AndroidManifest.xml inside the ''<application>'' tag: |
<meta-data | <meta-data | ||
Line 61: | Line 64: | ||
android:name="com.facebook.sdk.ApplicationId" | android:name="com.facebook.sdk.ApplicationId" | ||
android:value="@string/app_id" /> | android:value="@string/app_id" /> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<activity android:name="com.facebook.LoginActivity" > | <activity android:name="com.facebook.LoginActivity" > | ||
</activity> | </activity> | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<nowiki><!-- BEGIN: use this if you need push notification support --></nowiki> | <nowiki><!-- BEGIN: use this if you need push notification support --></nowiki> | ||
<receiver | <receiver |
Revision as of 19:11, 17 September 2015
Contents |
Download the SDK
Import the AAR file into your existing AndroidStudio as a new module and update your project and app .gradle files to include the new module.
Get your Social-ID data
You'll need 3 variables to configure the SDK:
- SENDER_ID: Set up a project on Google Developers Console - https://console.developers.google.com/project. Get your project number. This will be used as the SENDER_ID in the SDK.
- LOGIN_APP_ID: Set up a Social-ID LoginApp at: https://app.socialidnow.com/marketing/login/apps. Your key is the id of the app. This will be used as the LOGIN_APP_ID in the SDK.
- LOGIN_APP_CLIENT_SECRET: The client secret can be found on the Call the API menu - https://app.socialidnow.com/marketing/login/apps/APP_ID/apis. This will be used as the LOGIN_APP_CLIENT_SECRET in the SDK.
Add the SDK to your app
Add the following import statements to your Activity:
import com.coffeebeantech.socialidsdk.SocialId; import com.coffeebeantech.socialidsdk.notification.NotificationParameters;
Call SocialId.config from the onCreate method of your Activity class to set your application Social-ID configuration:
SocialId.config(this, "SENDER_ID", "LOGIN_APP_ID", "LOGIN_APP_CLIENT_SECRET");
Add the following variable to the res/values/strings.xml file:
<string name="app_id">FACEBOOK_APP_ID</string>
Add the following content to the assets/oauth_consumer.properties file. Ensure the assets folder is at the same level as the res folder.
#twitter twitter.com.consumer_key = TWITTER_CONSUMER_KEY twitter.com.consumer_secret = TWITTER_CONSUMER_SECRET #linkedin api.linkedin.com.consumer_key = LINKEDIN_CLIENT_ID api.linkedin.com.consumer_secret = LINKEDIN_CLIENT_SECRET
Modify app manifest
Add the following definitions to AndroidManifest.xml immediately before opening the <application> tag:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" /> <uses-permission android:name="android.permission.USE_CREDENTIALS" /> <!-- BEGIN: use this if you need push notification support --> <uses-permission android:name="android.permission.WAKE_LOCK" /> <uses-permission android:name="android.permission.VIBRATE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" /> <permission android:name="com.YOUR_PACKAGE.C2D_MESSAGE" android:protectionLevel="signature" /> <uses-permission android:name="com.YOUR_PACKAGE.C2D_MESSAGE" /> <!-- END: use this if you need push notification support -->
Add the following definitions to AndroidManifest.xml inside the <application> tag:
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" /> <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/app_id" /> <activity android:name="com.facebook.LoginActivity" > </activity> <!-- BEGIN: use this if you need push notification support --> <receiver android:name="com.coffeebeantech.socialidsdk.notification.NotificationReceiver" android:permission="com.google.android.c2dm.permission.SEND" > <intent-filter> <action android:name="com.google.android.c2dm.intent.RECEIVE" /> <category android:name="com.YOUR_PACKAGE" /> </intent-filter> </receiver> <receiver android:name="com.coffeebeantech.socialidsdk.registration.ConnectivityMonitor" android:enabled="false" > <intent-filter> <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> <category android:name="com.YOUR_PACKAGE" /> </intent-filter> </receiver> <service android:name="com.coffeebeantech.socialidsdk.notification.NotificationService" /> <service android:name="com.coffeebeantech.socialidsdk.registration.RegistrationService" /> <!-- END: use this if you need push notification support -->