Socialize SDK Android
Integrating Socialize into your App
Check out the full documentation to learn how to integrate Socialize into your app:
http://socialize.github.io/socialize-sdk-android/
Building Socialize from Source
Note: This is not required if you simply want to integrate Socialize into your app
Prerequisites
Make sure you have the following installed on your local machine:
Android SDK ( https://developer.android.com/sdk/)
Pip:
sudo easy_install pip
Sphinx 1.2.2:
sudo pip install sphinx
ANT:
brew install ant
Also make sure you have the following versions of the Android SDK installed:
- Android 2.2 (API 8)
- Android 4.4 (API 19)
These are installed using the Android SDK manager:
http://developer.android.com/tools/help/sdk-manager.html
Building Socialize
First clone this repo:
git clone [email protected]:socialize/socialize-sdk-android.git
Socialize depends on 3 external library projects:
git clone [email protected]:socialize/android-ioc.git git clone [email protected]:socialize/loopy-sdk-android.git git clone [email protected]:facebook/facebook-android-sdk.git
Setup the Facebook SDK for Build
Switch to the verified (tested) version of Facebook:
cd facebook-android-sdk git checkout sdk-version-3.17.2 cd ../
This version of the Facebook SDK (3.17.2) has some compilation warnings which are treated as errors by facebook. To override this, we need to change the compiler arguments in the facebook ant.properties:
vim facebook-android-sdk/facebook/ant.properties
Replace the following line:
java.compilerargs=-Xlint -Werror
With:
java.compilerargs=-Xlint
Now you can build the SDK distribution:
cd socialize-sdk-android/sdk ant -Dsdk.dir=/usr/local/android clean build
Make sure you replace /usr/local/android with your local path to the Android SDK
Building the Demo App
To build and test the demo app from the command line:
cd socialize-sdk-android/demo ant -Dsdk.dir=/usr/local/android clean release
Make sure you replace /usr/local/android with your local path to the Android SDK
Now you can install the demo app:
/usr/local/android/platform-tools/adb uninstall com.socialize.demo /usr/local/android/platform-tools/adb install bin/socialize-demo-release.apk
The demo app is called, Socialize Demos
Building the Documentation
Note: Sphinx 1.2.2 is required to generate docs:
sudo pip install sphinx
To build the html version of the documentation:
cd socialize-sdk-android/sdk ant -Dsdk.dir=/usr/local/android doc
Make sure you replace /usr/local/android with your local path to the Android SDK
Now you can browse the documentation:
open build/docs/user_guide/index.html
Running the Tests
In order to run the tests you need either an Android 4.4 device or emulator. We recommend using the Genymotion Android virtualization platform available here: http://www.genymotion.com/
Ensure the device/emulator is connected and available:
/usr/local/android/platform-tools/adb devices
If you do not see any devices listed, try restarting the adb server:
/usr/local/android/platform-tools/adb kill-server /usr/local/android/platform-tools/adb start-server
Prior to running the tests you MUST run an sdk cleanup so that the stage server has its state reset. This is a python script located in the test folder:
cd socialize-sdk-android/test python sdk-cleanup.py <consumer-key> <consumer-secret> \ <http://stage.api.socialize.com/v1> \ [facebook_user_id] [facebook_token]
To run the tests:
ant -propertyfile ant.global.properties -Dsdk.dir=/usr/local/android test-with-results
Make sure you replace /usr/local/android with your local path to the Android SDK
Now you can browse the coverage results:
open coverage-results/coverage.html
Building the Distro
To build the distributable SDK (zip):
cd socialize-sdk-android/sdk ant -Dsdk.dir=/usr/local/android clean build
Make sure you replace /usr/local/android with your local path to the Android SDK