請到微信開放平臺https://open.weixin.QQ.com/注冊成為開發者,然后創建應用并提交審核,只有審核通過的應用才能進行開發。
Android Studio環境下:
在build.gradle文件中,添加如下依賴即可:
dependencies { compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:1.0.2'}或
dependencies { compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:1.0.2'}(其中,前者包含統計功能)
3.在代碼中使用開發工具包
[1] AndroidManifest.xml 設置
添加必要的權限支持:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.access_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
[2] 注冊到微信
要使你的程序啟動后微信終端能響應你的程序,必須在代碼中向微信終端注冊你的id。(如下圖所示,可以在程序入口Activity的onCreate回調函數處,或其他合適的地方將你的應用id注冊到微信。注冊函數示例如下圖所示。

[3] 發送請求或響應到微信
現在,你的程序要發送請求或發送響應到微信終端,可以通過IWXAPI的 sendReq 和 sendResp 兩個方法來實現。
boolean sendReq(BaseReq req);
sendReq是第三方app主動發送消息給微信,發送完成之后會切回到第三方app界面。
boolean sendResp(BaseResp resp);
sendResp是微信向第三方app請求數據,第三方app回應數據之后會切回到微信界面。
sendReq的實現示例,如下圖所示:

需要注意的是,SendMessageToWX.Req的scene成員,如果scene填WXScenesession,那么消息會發送至微信的會話內。如果scene填WXSceneTimeline(微信4.2以上支持,如果需要檢查微信版本支持API的情況, 可調用IWXAPI的getWXAppSupportAPI方法,0x21020001及以上支持發送朋友圈),那么消息會發送至朋友圈。scene默認值為WXSceneSession。
sendResp的實現與SendReq類似,如下圖所示:

具體要發送的內容由第三方app開發者定義,這里需要說一下,為了實現第三方登陸,這里請求是這樣的:
微信登錄的官方文檔將微信登錄分為3個步驟:
{ // send oauth request Final SendAuth.Req req = new SendAuth.Req(); req.scope = "snsapi_userinfo"; req.state = "wechat_sdk_demo_test"; api.sendReq(req); }1234567812345678用這段代碼向微信開放平臺請求授權碼code,可拉起微信并打開授權登錄頁(前提是你安裝了微信應用并已登錄,未登錄的會引導你先登錄),如下圖:

1.如果微信授權頁不顯示,請檢查你的APP簽名是否和你在騰訊開放平臺的APP簽名一致,不一致可修改騰訊開放平臺中的APP簽名,修改后重裝微信或清除微信數據后重試。
2.在你的包名相應目錄下新建一個wxapi目錄,并在該wxapi目錄下新增一個WXEntryActivity類,該類繼承自Activity(例如應用程序的包名為net.sourceforge,則新的包名為:net.sourceforge.wxapi),此處應注意包名不要弄錯,新增類的名字必須為WXEntryActivity,如下圖示:

并在manifest文件里面加上exported屬性,設置為true,例如:

返回說明 用戶點擊授權后,微信客戶端會被拉起,跳轉至授權界面,用戶在該界面點擊允許或取消,SDK通過SendAuth的Resp返回數據給調用方。通過IWXAPIEventHandler接口的onReq方法進行回調,類似的,應用請求微信的響應結果將通過onResp回調,如下:
@Override public void onResp(BaseResp resp) { int errorCode = resp.errCode; switch (errorCode) { case BaseResp.ErrCode.ERR_OK: //用戶同意 String code = ((SendAuth.Resp) resp).code; //code:授權碼 break; case BaseResp.ErrCode.ERR_AUTH_DENIED: //用戶拒絕 break; case BaseResp.ErrCode.ERR_USER_CANCEL: //用戶取消 break; default: break; } ToastUtil.showMessageLong(this, resp.errStr); }1234567891011121314151617181912345678910111213141516171819客戶端收到授權碼后,向自己的服務器發起登錄請求,并附帶收到的授權碼code ,可以通過code獲取access_token(建議在自己服務器端獲取)
獲取access_token鏈接為:
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
得到的Json對象解析為: JSONObject object = new JSONObject(sb.toString().trim()); accessToken = object.getString("access_token"); openID = object.getString("openid"); refreshToken = object.getString("refresh_token"); expires_in = object.getLong("expires_in");參數說明:
參數 是否必須 說明 appid 是 應用唯一標識,在微信開放平臺提交應用審核通過后獲得secret 是 應用密鑰AppSecret,在微信開放平臺提交應用審核通過后獲得code 是 填寫第一步獲取的code參數grant_type 是 填authorization_code回說明**正確的返回:
{ "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN","openid":"OPENID", "scope":"SCOPE","unionid":"o6_bmasdasdsad6_2sgVt7hMZOPfL"}1234567812345678 參數 說明access_token 接口調用憑證expires_in access_token 接口調用憑證超時時間,單位(秒)refresh_token 用戶刷新access_tokenopenid 授權用戶唯一標識scope 用戶授權的作用域,使用逗號(,)分隔unionid 只有在用戶將公眾號綁定到微信開放平臺帳號后,才會出現該字段。錯誤返回樣例:{"errcode":40029,"errmsg":"invalid code"}客戶端可利用access_token獲取微信用戶信息,但進行接口調用,有以下前提:access_token有效且未超時;微信用戶已授權給第三方應用帳號相應接口作用域(scope)。授權作用域(scope) 接口 接口說明snsapi_base /sns/oauth2/access_token 通過code換取 access_token、refresh_token和已授權scope /sns/oauth2/refresh_token 刷新或續期access_token使用 /sns/auth 檢查access_token有效性snsapi_userinfo /sns/userinfo 獲取用戶個人信息其中snsapi_base屬于基礎接口,若應用已擁有其它scope權限,則默認擁有snsapi_base的權限。使用snsapi_base可以讓移動端網頁授權繞過跳轉授權登錄頁請求用戶授權的動作,直接跳轉第三方網頁帶上授權臨時票據(code),但會使得用戶已授權作用域(scope)僅為snsapi_base,從而導致無法獲取到需要用戶授權才允許獲得的數據和基礎功能。
以獲取用戶信息舉例:
PRivate void getUserInfo() { if (isAccessTokenIsInvalid() && System.currentTimeMillis() < expires_in) { String uri = "https://api.weixin.qq.com/sns/userinfo?access_token=" + accessToken + "&openid=" + openID; HttpClient client = new DefaultHttpClient(); HttpGet get = new HttpGet(URI.create(uri)); try { HttpResponse response = client.execute(get); if (response.getStatusLine().getStatusCode() == 200) { BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8")); StringBuilder builder = new StringBuilder(); for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) { builder.append(temp); } JSONObject object = new JSONObject(builder.toString().trim()); String nikeName = object.getString("nickname"); } } catch (ClientProtocolException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (JSONException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }重復登錄
假設用戶已經獲得授權,則下次登錄時只需要驗證access_token是否有效,無效則重新獲取授權,有效則無需重新獲得授權。
1.用戶向自己的服務器請求登錄,登錄方式為微信登錄,附帶上次登錄返回的的access_token
2.服務器收到用戶的登錄請求,向微信開放平臺發送access_token是否有效的驗證請求如下:
private boolean isAccessTokenIsInvalid() { String url = "https://api.weixin.qq.com/sns/auth?access_token=" + accessToken + "&openid=" + openID; URI uri = URI.create(url); HttpClient client = new DefaultHttpClient(); HttpGet get = new HttpGet(uri); HttpResponse response; try { response = client.execute(get); if (response.getStatusLine().getStatusCode() == 200) { HttpEntity entity = response.getEntity(); BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), "UTF-8")); StringBuilder sb = new StringBuilder(); for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) { sb.append(temp); } JSONObject object = new JSONObject(sb.toString().trim()); int errorCode = object.getInt("errcode"); if (errorCode == 0) { return true; } } } catch (ClientProtocolException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (JSONException e) { // TODO Auto-generated catch block e.printStackTrace(); } return false; }12345678910111213141516171819202122232425262728293031323334351234567891011121314151617181920212223242526272829303132333435返回說明
正確的Json返回結果:{ "errcode":0,"errmsg":"ok"}錯誤的Json返回示例:{ "errcode":40003,"errmsg":"invalid openid"}
1234567812345678如果access_token有效,服務端將信息返回給客戶端,客戶端成功登錄。
如果access_token無效,服務端向微信開放平臺發送刷新access_token的請求如下:
access_token是調用授權關系接口的調用憑證,由于access_token有效期(目前為2個小時)較短,當access_token超時后,可以使用refresh_token進行刷新,access_token刷新結果有兩種:
1.若access_token已超時,那么進行refresh_token會獲取一個新的access_token,新的超時時間; 2.若access_token未超時,那么進行refresh_token不會改變access_token,但超時時間會刷新,相當于續期access_token。
refresh_token擁有較長的有效期(30天),當refresh_token失效的后,需要用戶重新授權。
private void refreshAccessToken() { String uri = "https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=" + ShareUtil.APP_ID + "&grant_type=refresh_token&refresh_token=" + refreshToken; HttpClient client = new DefaultHttpClient(); HttpGet get = new HttpGet(URI.create(uri)); try { HttpResponse response = client.execute(get); if (response.getStatusLine().getStatusCode() == 200) { BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8")); StringBuilder builder = new StringBuilder(); for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) { builder.append(temp); } JSONObject object = new JSONObject(builder.toString().trim()); accessToken = object.getString("access_token"); refreshToken = object.getString("refresh_token"); openID = object.getString("openid"); expires_in = object.getLong("expires_in"); } } catch (ClientProtocolException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (JSONException e) { // TODO Auto-generated catch block e.printStackTrace(); } }123456789101112131415161718192021222324252627282930123456789101112131415161718192021222324252627282930返回說明
正確的返回:{ "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN", "openid":"OPENID", "scope":"SCOPE" }參數 說明access_token 接口調用憑證expires_in access_token接口調用憑證超時時間,單位(秒)refresh_token 用戶刷新access_tokenopenid 授權用戶唯一標識scope 用戶授權的作用域,使用逗號(,)分隔錯誤返回樣例:{"errcode":40030,"errmsg":"invalid refresh_token"}12345678910111213141516171819123456789101112131415161718193.服務端獲取到新的access_token等信息,并返回給客戶端,客戶端成功登錄或者重新獲取授權。
注意事項
[1]如果需要混淆代碼,為了保證sdk的正常使用,需要在proguard.cfg加上下面兩行配置:
-keep class com.tencent.mm.opensdk.** {
*;
}
-keep class com.tencent.wxop.** {
*;
}
-keep class com.tencent.mm.sdk.** {
*;
}
[2]如果需要運行SDK Sample工程,需要通過指定的debug.keystore來進行簽名:
Android Studio環境下:
signingConfigs { debug { storeFile file("../debug.keystore") }}Eclipse環境下:
請查閱文檔《如何運行SDK Demo工程》
至此,你已經能使用微信Android開發工具包的API內容了。如果想更詳細了解每個API函數的用法,請查閱 Android 平臺參考手冊 或自行下載閱讀微信SDK Sample Demo源碼。
微信SDK Sample Demo源碼
參考博文:http://blog.csdn.net/luoyan973387349/article/details/49815225
官網接口地址:開發前需要知道的那些事 、 集成前資源配置 、 授權后接口調用(重)
新聞熱點
疑難解答