Socialize SDK Android 技术文档

本文档将详细介绍如何安装、使用 Socialize SDK Android，以及如何调用其 API。

1. 安装指南

环境准备

确保在本地机器上安装以下软件及版本：

• Android SDK（请访问 Android SDK 官网 下载）
• Pip（使用命令 sudo easy_install pip 安装）
• Sphinx 1.2.2（使用命令 sudo pip install sphinx 安装）
• ANT（使用命令 brew install ant 安装）

同时确保安装以下版本的 Android SDK：

• Android 2.2 (API 8)
• Android 4.4 (API 19)

这些版本可以通过 Android SDK 管理器安装：

Android SDK Manager

源码构建

首先克隆本项目：

git clone [e-mail]:socialize/socialize-sdk-android.git

Socialize 依赖于以下三个外部库项目：

git clone [e-mail]:socialize/android-ioc.git
git clone [e-mail]:socialize/loopy-sdk-android.git
git clone [e-mail]:facebook/facebook-android-sdk.git

Facebook SDK 设置

切换到 Facebook SDK 的验证（测试）版本：

cd facebook-android-sdk
git checkout sdk-version-3.17.2
cd ../

此版本的 Facebook SDK（3.17.2）有一些编译警告，会被 Facebook 当作错误处理。要覆盖这些警告，需要更改 facebook ant.properties 中的编译器参数：

vim facebook-android-sdk/facebook/ant.properties

将以下行：

java.compilerargs=-Xlint -Werror

替换为：

java.compilerargs=-Xlint

现在可以构建 SDK 分发：

cd socialize-sdk-android/sdk
ant -Dsdk.dir=/usr/local/android clean build

请确保将 /usr/local/android 替换为您的 Android SDK 的本地路径。

2. 项目使用说明

构建演示应用

要命令行构建并测试演示应用：

cd socialize-sdk-android/demo
ant -Dsdk.dir=/usr/local/android clean release

请确保将 /usr/local/android 替换为您的 Android SDK 的本地路径。

安装演示应用：

/usr/local/android/platform-tools/adb uninstall com.socialize.demo
/usr/local/android/platform-tools/adb install bin/socialize-demo-release.apk

演示应用的名称为 Socialize Demos。

构建文档

构建 HTML 版本的文档：

cd socialize-sdk-android/sdk
ant -Dsdk.dir=/usr/local/android doc

请确保将 /usr/local/android 替换为您的 Android SDK 的本地路径。

现在可以浏览文档：

open build/docs/user_guide/index.html

运行测试

要运行测试，需要有一个 Android 4.4 设备或模拟器。推荐使用 Genymotion Android 虚拟化平台。

确保设备/模拟器已连接并可用：

/usr/local/android/platform-tools/adb devices

如果没有列出任何设备，尝试重启 adb 服务器：

/usr/local/android/platform-tools/adb kill-server
/usr/local/android/platform-tools/adb start-server

在运行测试之前，必须运行 sdk 清理脚本以重置 stage 服务器状态。该脚本位于 test 文件夹中：

cd socialize-sdk-android/test
python sdk-cleanup.py <consumer-key> <consumer-secret> <http://stage.api.socialize.com/v1> [facebook_user_id] [facebook_token]

运行测试：

ant -propertyfile ant.global.properties -Dsdk.dir=/usr/local/android test-with-results

请确保将 /usr/local/android 替换为您的 Android SDK 的本地路径。

现在可以浏览覆盖率结果：

open coverage-results/coverage.html

构建分发版

构建分发版 SDK（zip）：

cd socialize-sdk-android/sdk
ant -Dsdk.dir=/usr/local/android clean build

请确保将 /usr/local/android 替换为您的 Android SDK 的本地路径。

3. 项目 API 使用文档

关于如何将 Socialize 集成到您的应用中以及如何使用其 API，请参考官方文档：

Socialize SDK Android 官方文档

4. 项目安装方式

请参考本文档的“安装指南”部分获取项目安装方式。