注:本文為微信Android終端開發(fā)工具的新手使用教程,,只涉及教授SDK的使用方法,,默認讀者已經(jīng)熟悉IDE的基本使用方法(本文以Eclipse為例),以及具有一定的編程知識基礎(chǔ)等,。 1.申請你的AppID請到 開發(fā)者應(yīng)用登記頁面 進行登記,,登記并選擇移動應(yīng)用進行設(shè)置后,將該應(yīng)用提交審核,,只有審核通過的應(yīng)用才能進行開發(fā),。 2.下載微信終端開發(fā)工具包開發(fā)工具包主要包含3部分內(nèi)容:(其中,只有l(wèi)ibammsdk.jar是必須的)
3.搭建開發(fā)環(huán)境[1] 在Eclipse中建立你的工程。 [2] 在工程中新建一個libs目錄,,將開發(fā)工具包中l(wèi)ibs目錄下的libammsdk.jar復(fù)制到該目錄中(如下圖所示,,建立了一個名為SDK_Sample 的工程,,并把jar包復(fù)制到libs目錄下),。
[3] 右鍵單擊工程,選擇Build Path中的Configure Build Path...,,選中Libraries這個tab,,并通過Add Jars...導入工程libs目錄下的libammsdk.jar文件。(如下圖所示),。
在你需要使用微信終端API的文件中導入相應(yīng)的類,。 import com.tencent.mm.sdk.openapi.WXTextObject; 4.在代碼中使用開發(fā)工具包[1] 注冊到微信 要使你的程序啟動后微信終端能響應(yīng)你的程序,必須在代碼中向微信終端注冊你的id,。(如下圖所示,,可以在程序入口Activity的onCreate回調(diào)函數(shù)處,或其他合適的地方將你的應(yīng)用id注冊到微信,。注冊函數(shù)示例如下圖所示,。
[2] 發(fā)送請求或響應(yīng)到微信 現(xiàn)在,,你的程序要發(fā)送請求或發(fā)送響應(yīng)到微信終端,可以通過IWXAPI的 sendReq 和 sendResp 兩個方法來實現(xiàn),。 boolean sendReq(BaseReq req); sendReq是第三方app主動發(fā)送消息給微信,,發(fā)送完成之后會切回到第三方app界面。 boolean sendResp(BaseResp resp); sendResp是微信向第三方app請求數(shù)據(jù),,第三方app回應(yīng)數(shù)據(jù)之后會切回到微信界面,。 sendReq的實現(xiàn)示例,如下圖所示:
需要注意的是,,SendMessageToWX.Req的scene成員,,如果scene填WXSceneSession,那么消息會發(fā)送至微信的會話內(nèi),。如果scene填WXSceneTimeline(微信4.2以上支持,,如果需要檢查微信版本支持API的情況, 可調(diào)用IWXAPI的getWXAppSupportAPI方法,0x21020001及以上支持發(fā)送朋友圈),,那么消息會發(fā)送至朋友圈,。scene默認值為WXSceneSession。 sendResp的實現(xiàn)與SendReq類似,,如下圖所示:
具體要發(fā)送的內(nèi)容由第三方app開發(fā)者定義,,具體可參考微信開發(fā)工具包中的SDK Sample Demo源碼。 [3] 接收微信的請求及返回值 如果你的程序需要接收微信發(fā)送的請求,,或者接收發(fā)送到微信請求的響應(yīng)結(jié)果,,需要下面3步操作: a. 在你的包名相應(yīng)目錄下新建一個wxapi目錄,并在該wxapi目錄下新增一個WXEntryActivity類,,該類繼承自Activity (例如應(yīng)用程序的包名為net.sourceforge.simcpux,,則新添加的類如下圖所示)
并在manifest文件里面加上exported屬性,設(shè)置為true,,例如:
b. 實現(xiàn)IWXAPIEventHandler接口,,微信發(fā)送的請求將回調(diào)到onReq方法,發(fā)送到微信請求的響應(yīng)結(jié)果將回調(diào)到onResp方法 c. 在WXEntryActivity中將接收到的intent及實現(xiàn)了IWXAPIEventHandler接口的對象傳遞給IWXAPI接口的handleIntent方法,,示例如下圖: 當微信發(fā)送請求到你的應(yīng)用,,將通過IWXAPIEventHandler接口的onReq方法進行回調(diào),類似的,,應(yīng)用請求微信的響應(yīng)結(jié)果將通過onResp回調(diào),。 注意如果需要混淆代碼,為了保證sdk的正常使用,,需要在proguard.cfg加上下面兩行配置: -keep class com.tencent.mm.sdk.openapi.WXMediaMessage {*;} -keep class com.tencent.mm.sdk.openapi.** implements com.tencent.mm.sdk.openapi.WXMediaMessage$IMediaObject {*;} 至此,,你已經(jīng)能使用微信Android開發(fā)工具包的API內(nèi)容了。如果想更詳細了解每個API函數(shù)的用法,,請查閱 Android 平臺參考手冊 或自行下載閱讀微信SDK Sample Demo源碼,。 |
|