Android上新浪微博SDK的使用方法介绍

作者：朱凌飞

本文介绍了如何在Android程序中使用新浪微博提供的AndroidSDK，具体新浪API查询请到http://open.weibo.com/查看。

微博Android平台SDK为第三方微博应用提供了文档易用的微博API调用服务，使第三方客户端无需了解复杂的验证，API调用过程。并可以实现分享到微博的功能，可以分享文字，或者多媒体信息到内置的分享页面，并发送到微博。

首先我们需要在新浪微博开放平台上进行注册，之后需要创建一个新的应用，并且需要记下应用的APP key，App Secret Key以及设置应用的回调页以便我们在程序中进行使用。此外，还需要在应用的高级信息里添加测试用户的uid，切记切记，否则会出现登陆不成功等怪现象。

接着我们下载微博提供的Android上的SDK，下载地址在这里http://open.weibo.com/wiki/SDK，选择AndroidSDK进行下载即可。

使用方法：

首先将下载的sdk进行解压，并将其导入到eclipse中，接着在你需要使用sdk的android工程中点击右键，属性，设置library属性，选中刚才导入的weibosdk即可。如图所示



然后在你的工程的Manifest文件中，加入以下权限：

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.WRITE_APN_SETTINGS"></uses-permission>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>


这样我们就能使用weibosdk了

建立工程以后如何在代码中使用weiboAPI呢，下面就由我来为大家介绍使用方法：

首先在你需要使用微博的Activity中加入以下代码：

Weibo weibo = Weibo.getInstance();
weibo.setupConsumerConfig(Constants.CONSUMER_KEY,Constants.CONSUMER_SECRET);

weibo.setRedirectUrl("Your URLhere");
    weibo.authorize(this,
              listener);

注意代码中的Constants.CONSUMER_KEY,Constants.CONSUMER_SECRET即是文章开头介绍的在微博上创建的应用里的两个key，setRedirectUrl中的内容即是在应用中设置的回调页。

Listener则是在进行登陆授权后对执行结果进行处理的Litener，代码如下

public class AuthDialogListener implements WeiboDialogListener {
private Activity context;
private String content;
private String file;
private float lat;
private float lon;
private static boolean isOver=true;
public AuthDialogListener(Activity context,String content,String file,float lat,float lon){
this.context= context;
this.content=content;
this.file=file;
this.lat=lat;
this.lon=lon;
}
@Override
public void onComplete(Bundle values) {
String token = values.getString("access_token");
String expires_in = values.getString("expires_in");
String oauth_verifier = values.getString("oauth_verifier");
AccessToken accessToken = new AccessToken(token, Constants.CONSUMER_SECRET);
accessToken.setExpiresIn(expires_in);
accessToken.setVerifier(oauth_verifier);
Weibo.getInstance().setAccessToken(accessToken);
try {
if (isOver) {
isOver=false;
share2weibo(this.content,null,listener,lat,lon);
}

} catch (WeiboException e) {
e.printStackTrace();
}
}

@Override
public void onError(DialogError e) {
Toast.makeText(context.getApplicationContext(),
"Auth error : " + e.getMessage(), Toast.LENGTH_LONG).show();
}

@Override
public void onCancel() {
Toast.makeText(context.getApplicationContext(), "Auth cancel",
Toast.LENGTH_LONG).show();
}

@Override
public void onWeiboException(WeiboException e) {
Toast.makeText(context.getApplicationContext(),
"Auth exception : " + e.getMessage(), Toast.LENGTH_LONG)
.show();
}

private void share2weibo(String content,String file,RequestListener listener,float lat , float lon) throws WeiboException {
Weibo weibo = Weibo.getInstance();
WeiboParameters params= new WeiboParameters();
params.add("access_token", weibo.getAccessToken().getToken());
params.add("status", content);
params.add("lat", String.valueOf(lat));
params.add("long", String.valueOf(lon));
String url = Weibo.SERVER + "statuses/update.json";
if (file!=null&&!file.equalsIgnoreCase("")) {
params.add("pic", file);
url = Weibo.SERVER + "statuses/upload.json";
}
AsyncWeiboRunner runner = new AsyncWeiboRunner(weibo);
runner.request(this.context, url, params,Utility.HTTPMETHOD_POST,listener);

}
RequestListener listener= new RequestListener() {

@Override
public void onIOException(IOException e) {
isOver=true;
Toast.makeText(context, "RequestListener "+e.getMessage(), Toast.LENGTH_LONG).show();
}

@Override
public void onError(WeiboException e) {
isOver=true;
Toast.makeText(context, "RequestListener "+e.getMessage(), Toast.LENGTH_LONG).show();
}

@Override
public void onComplete(String response) {
isOver=true;
Toast.makeText(context, "Success!", Toast.LENGTH_LONG).show();
}
};
}


需要完成WeiboDialogListener接口中的方法，分别是onComplete，OnError，

OnCancel，OnWeiboException。其中Oncomplete是在微博登陆授权成功后会执行的方法，在这个方法中，你可以调用你想要的功能如发表微博，转发，评论等。使用的代码可参看以下代码：

Weibo weibo = Weibo.getInstance();
WeiboParameters params= new WeiboParameters();
params.add("access_token", weibo.getAccessToken().getToken());
params.add("status", content);
params.add("lat", String.valueOf(lat));
params.add("long", String.valueOf(lon));
String url = Weibo.SERVER + "statuses/update.json";
AsyncWeiboRunner runner = new AsyncWeiboRunner(weibo);
runner.request(this.context,url,params,Utility.HTTPMETHOD_POST,listener);


其中params是调用weibo api中需要的具体参数，可根据需要进行添加

AsyncWeiboRunner 是用来执行具体请求的类，根据你设定的参数发起请求。注意这里又有一个listerner，而这个listener是对发起请求后的结果进行处理的回调类，

RequestListener
listener= new 
RequestListener（）

    需要复写的方法有OnIOException，onError，onComplete，这样可以清楚地对各种情况进行处理。

    这样在程序中就可以使用新浪微博 android sdk了。