【OSC手机App技术解析】- 集成新浪微博Android SDK

使用 OSChina.NET Android版客户端的用户,应该知道我们的客户端只需要第一次登陆了新浪微博,以后都可以不用再登陆,直接一键分享,这样很方便用户。

由于新浪微博开放平台预计2012年9月份停止旧版接口和OAuth1.0的使用,此次我们的Android客户端v1.5.3已经更新并使用新版接口和OAuth2.0的SDK。

集成到App的效果图:

下面将新浪微博AndroidSDK的集成分享给大家。

下载SDK

下载地址:http://open.weibo.com/wiki/SDK

我们找到AndroidSDK,点击下载。

导入源码包

将com.weibo.net包下面java文件导入项目的src目录下,如下图:

注意:这里我没有导入ShareActivity.java文件以及ShareActivity类里面所需的资源文件。因为我们的App只需一键分享即可,不需要用户去编辑分享的内容。而ShareActivity类实际是个Activity类,涉及到布局等,所以我们这里没有导入。

当然,你可以根据自己的需求,看是否需要导入。

导入相关资源

1、将dialog_bg.9.png图片文件导入到res/drawable-hdpi目录下;

2、将color.xml,dimens.xml,style.xml导入到res/values目录下;

在写导入图片文件的时候,又让我想起SDK中drawable-hdpi目录下一张"刀塔(dota)"的图片。

添加权限

我们需要在AndroidManifest.xml中添加以下权限:
<uses-permission android:name="android.permission.INTERNET"></uses-permission>  
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.WRITE_APN_SETTINGS"></uses-permission>

 在新浪微博SDK提供的例子里面是需要以上5个权限的,其实我测试只要前面3个就OK了。

-----------------------以上热身活动都完成后,开始进入主题了----------------------------

调用新浪微博的SDK,首先你要到新浪微博开放平台申请的你的App的key,secret。同时,你还要进入“我的应用--应用详情--应用信息--高级信息--授权设置--应用回调页”设置你的回调页地址。

以下假设你已经有了CONSUMER_KEY,CONSUMER_SECRET,REDIRECT_URL。

首次授权登录

1、初始化weibo
private static final String CONSUMER_KEY = "your app_key";
private static final String CONSUMER_SECRET = "your app_secret";
private static final String REDIRECT_URL = "your redirect_url";
//REDIRECT_URL 必须与你填写在微博开放平台上的一致
Weibo weibo = Weibo.getInstance();
weibo.setupConsumerConfig(CONSUMER_KEY, CONSUMER_SECRET);
weibo.setRedirectUrl(REDIRECT_URL);

 2、弹出对话框,并授权登录

weibo.authorize(cont, new WeiboDialogListener() {
    @Override
    public void onComplete(Bundle values) {
        try
        {
            String token = values.getString(Weibo.TOKEN);
            String expires_in = values.getString(Weibo.EXPIRES);
            accessToken = new AccessToken(token, CONSUMER_SECRET);
            accessToken.setExpiresIn(expires_in);   
            //此处保存AccessToken
            //your save function
            //微博分享
            weibo.shareToweibo(cont, accessToken.getToken(), accessToken.getSecret(), shareMessage);
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
    }
    @Override
    public void onError(DialogError e) {
        Toast.makeText(context,"授权失败 : " + e.getMessage(), Toast.LENGTH_LONG).show();
    }
    @Override
    public void onCancel() {
        //Toast.makeText(context, "取消授权", Toast.LENGTH_LONG).show();
    }
    @Override
    public void onWeiboException(WeiboException e) {
        Toast.makeText(context,"授权异常 : " + e.getMessage(), Toast.LENGTH_LONG).show();
    }
});

 这里说明下,登录成功后会调用onComplete()方法,在方法里你需要保存AccessToken,同时分享微博。

注意:weibo.shareToweibo()方法是我自己定义的,方便下次直接根据保存的AccessToken分享微博。

这里我把自己写的shareToweibo()方法代码贴出:
/**
 * 分享到微博
 * @author  liux
 */
public boolean shareToweibo(Activity activity, String accessToken, String tokenSecret, String content) throws WeiboException {
    Utility.setAuthorization(new Oauth2AccessTokenHeader());
    WeiboParameters bundle = new WeiboParameters();
    bundle.add("source", APP_KEY);
    bundle.add("status", content);
    String url = SERVER + "statuses/update.json";
    if(mAccessToken == null){
        mAccessToken = new AccessToken(accessToken, tokenSecret);
    }
    request(activity, url, bundle, Utility.HTTPMETHOD_POST, mAccessToken);
    return true;
}

 实际调用上面方法的时候,需要try-catch一下,只要没有获取到WeiboException异常,就是分享成功了。

一键分享

下面说明一下,以后使用一键分享时,不需要再登录,只需要:

1、初始化weibo(同上)

2、获取保存的AccessToken

3、调用shareToweibo()方法

OK,就这么简单。

如果大家有什么疑问的话,欢迎在下面回帖一起探讨。

PS:

OSC Android客户端下载地址: http://www.oschina.net/uploads/osc.apk

OSCiPhone客户端下载地址:http://www.oschina.net/uploads/osc.ipa

OSC Windows Phone客户端下载地址: http://www.oschina.net/uploads/osc.xap

转载:http://www.oschina.net/question/157182_59192

相关推荐