只需五分钟!Singly助你轻松构建Android社交应用

只需五分钟！Singly助你轻松构建Android社交应用

摘要：Singly是一个单一的API允许访问多个跨平台应用的社交数据。有了Singly，你可以用它来处理身份验证，并且利用这个统一的API来检索社交数据。本文，我们将教你如何利用Singly Android SDK创建Android社交应用，让你了解如何在Eclipse中创建Android 项目以及如何导入现有的项目。

Singly是一个单一的API允许访问多个跨平台应用的社交数据。对于App开发者来说，这意味着可以将Singly Android SDK拖放至App里，包括Facebook, Twitter, Foursquare等其他一些社交应用。有了Singly，你可以用它来处理身份验证并且利用这个统一的API来检索社交数据。本文，我们将教你如何轻易的利用Singly Android SDK创建Android社交应用，让你了解如何在Eclipse中创建Android项目以及如何导入现有的项目。

只需三个步骤：

1.注册Singly并获取API密钥

2.在Github上下载Singly Android SDK

3.在App中使用Singly Android SDK

注册Singly并获取API密钥

首先你得去Singly页面登陆，你可以使用Github账号也可以使用Facebook账号。当你通过验证后，你将获取到Singly Apps页面。在你的应用下方点击“Default Singly App”。之后你可以创建应用并为你的各种服务注册该应用。此时，默认的应用页面将会显示客户端ID 和密码，将这个两个复制下来。

从Github上下载Singly Android SDK

现在就去Github上下载Singly Android SDK项目吧，这里SDK是开源的。你可以利用下面的指令复制到本地系统中。

1.git clone git@:Singly/singly-android.git

这里有2个SDK文件夹，一个是SDK文件另一个是文件示例。你可以在Eclipse菜单中选择“Import Existing Projects”。这里应该设置为两个项目一个名为SinglyAndroidSDK，指Android 库中的SDK；另一个是SinglyAndroidExamples指应用示例。

在App中使用Singly Android SDK

在使用SDK之前首先请先创建一个SinglyClient类，比如在此之前创建的应用中复制客户端ID和密码。

1.SinglyClient api = new SinglyClient(activity, "your_client_id

","your_client_secret");

一旦你拥有SinglyClient ，你可以在多个平台上进行用户身份验证（包括Facebook，Twitter,FourSquare，Github等等)。你只需通过SinglyClient输入应用名称即可。

1.api.authenticate("facebook", new AuthenticationListener() {

2.

3.public void onStart() {

4. }

5.public void onProgress(int progress) {

6. }

7.public void onPageLoaded() {

8. }

9.public void onAuthenticated() {

10.// user is authenticated, make some api calls to get data

11. }

12.public void onError(AuthenticationListener.Errors error) {

13.// uh oh, we got an error during authentication

14. }

15.

16.public void onCancel() {

17. // user cancelled the authenication

18. }

19.});

这里在认证过程中将启动一个对话框，其中有一个Web视图允许用户通过oauth进行身份验证服务。

你可以通过AuthenticationListener类来接收回调（callbacks）过程各个阶段信息。例如一旦用户已经通过onAuthenticated身份验证，这个方法将调用。

使用SinglyClient 类，你可以在任意一个Serivce Singly Supports进行身份验证。当经过身份验证后，你可以利用Singly API来获得数据。

1.api.apiCall("/services/facebook/friends", "GET", null, null,

new APICallListener() {

2.

3.public void onSuccess(JSONObject jsonObj) {

4.

5.// do something with the json returned, show a list of friend

s names...

6. }

7.

8.public void onError(String message) {

9. }

10.});

此外，你可以使用apiCall来调用任意一个Singly api，并且利用任何已通过验证的应用上获取用户数据。这里有Singly API Explorer你可以了解下。

如果你想查看一些示例，请将你的ID和密码复制到MainActivity，你可以在SinglyAndroidExamples项目中查看ProfilesActivity演示示例。