微信iOS終端SDK新手使用指南
1.向微信注冊(cè)你的應(yīng)用程序id
請(qǐng)到 開發(fā)者應(yīng)用登記頁面 進(jìn)行登記,登記并選擇移動(dòng)應(yīng)用進(jìn)行設(shè)置后,將獲得AppID,可立即用于開發(fā)。但應(yīng)用登記完成后還需要提交審核,只有審核通過的應(yīng)用才能正式發(fā)布使用。
3.搭建開發(fā)環(huán)境
[1] 在XCode中建立你的工程。
[2] 將SDK文件中包含的 libWeChatSDK.a , WXApi.h , WXApiObject.h 三個(gè)文件添加到你所建的工程中(如下圖所示,建立了一個(gè)名為Test 的工程,并把以上三個(gè)文件添加到Test文件夾下)。
(注:如果使用XCode 4.3及以下版本,使用libWeChatSDK.a;如果使用XCode 4.5及以上版本,使用libWeChatSDK_armv7_v7s.a)
[3] 在你的工程文件中選擇Build Setting,在Search Paths中添加 libWeChatSDK.a , WXApi.h , WXApiObject.h 三個(gè)文件所在位置(如下圖所示)。
(注:如果使用XCode 4.3及以下版本,使用libWeChatSDK.a;如果使用XCode 4.5及以上版本,使用libWeChatSDK_armv7_v7s.a)
[4] 在Xcode4中,選擇你的工程設(shè)置項(xiàng),選中“TARGETS”一欄,在“info”標(biāo)簽欄的“URL type“添加“URL scheme”為你所注冊(cè)的應(yīng)用程序id。如果使用的是Xcode3或更低版本,則需要在plist文件中添加(如下圖所示)。
Xcode4設(shè)置URL scheme
[5] 在你需要使 用微信終端API的文件中import WXApi.h 頭文件,并增加 WXApiDelegate 協(xié)議。
4.在代碼中使用開發(fā)工具包
[1] 要使你的程序啟動(dòng)后微信終端能響應(yīng)你的程序,必須在代碼中向微信終端注冊(cè)你的id。(如下圖所示,在 AppDelegate 的 didFinishLaunchingWithOptions 函數(shù)中向微信注冊(cè)id)。
[2] 重寫AppDelegate的handleOpenURL和openURL方法:
[3] 現(xiàn)在,你的程序要實(shí)現(xiàn)和微信終端交互的具體請(qǐng)求與回應(yīng),因此需要實(shí)現(xiàn)WXApiDelegate協(xié)議的兩個(gè)方法:
- -(void) onReq:(BaseReq*)req
- onReq是微信終端向第三方程序發(fā)起請(qǐng)求,要求第三方程序響應(yīng)。第三方程序響應(yīng)完后必須調(diào)用sendRsp返回。在調(diào)用sendRsp返回時(shí),會(huì)切回到微信終端程序界面。
- -(void) onResp:(BaseResp*)resp
- 如果第三方程序向微信發(fā)送了sendReq的請(qǐng)求,那么onResp會(huì)被回調(diào)。sendReq請(qǐng)求調(diào)用后,會(huì)切到微信終端程序界面。
[4] 如果你的程序要發(fā)消息給微信,那么需要調(diào)用WXApi的sendReq函數(shù):
- -(BOOL) sendReq:(BaseReq*)req
- 其中req參數(shù)為SendMessageToWXReq類型。
需要注意的是,SendMessageToWXReq的scene成員,如果scene填WXSceneSession,那么消息會(huì)發(fā)送至微信的會(huì) 話內(nèi)。如果scene填WXSceneTimeline(微信4.2以上支持,如果需要檢查微信版本支持API的情況, 可調(diào)用 [WXApi getWXAppSupportMaxApiVersion],SDK1.1版以上支持發(fā)送朋友圈),那么消息會(huì)發(fā)送至朋友圈。scene默認(rèn)值為WXSceneSession。
至此,你已經(jīng)能使用微信終端SDK的API內(nèi)容了。如果想更詳細(xì)了解每個(gè)API函數(shù)的用法,請(qǐng)查閱 官網(wǎng)API文檔 或自行下載閱讀微信SDK Sample Demo源碼。