本篇教程主要是講解如何實現iOS程序分享自定義內容(文本、圖片、音樂)到微信好友、朋友圈、收藏的功能。
目錄
1. 在微信開放平臺申請賬號并創建移動應用
2. 項目集成微信SDK
3. 配置項目
4. 分享文本和鏈接到微信
5. 對分享結果進行處理
6. 總結
1.在微信開放平臺申請賬號并創建移動應用
要分享內容到微信,必須得在微信公眾平臺注冊一個帳號并且創建一個移動應用。
創建了移動應用還需要審核通過才可以,這一過程大概需要2-3天。
等不及馬上想嘗試?別著急,繼續看下去,稍后我會講如何在沒有申請的情況下實現我們的功能。
2. 項目集成微信SDK
2.1 下載微信iOS SDK
前往微信公眾平臺-資源中心下載微信iOS SDK。
2.2 創建項目,加入SDK
打開XCode,創建一個Single View Application,命名為WechatShareDemo。我們這個教程接下來就在這個項目的基礎上進行。
將2.1下載好的SDK壓縮包解壓后你可以看到以下文件:
其中的README.txt你有時間可以看看。
其他的.a、.h文件是我們需要的,直接導入到我們創建的WechatShareDemo中來。
ok,此時我們已經有了一個導入了微信SDK的項目了,接下來我們需要配置一下!
3 配置SDK環境
3.1 導入需要的動態庫和框架
在工程Build Phases -> Link Binary With Libraries 鏈接以下動態庫和框架文件:
1.SystemConfiguration.framework
2.CoreTelephony.framework
3.Security.framework
4.CFNetwork.framework
5.libsqlite3.0.tbd
6.libz.1.2.8.tbd
7.libc++.tbd
3.2 設置Other Linker Flags為"-Objc -all_load"
3.3 設置URL scheme
為了跳轉至微信后還能跳回我們的app,我們必須將我們的appID添加為URL scheme。
4. 編寫分享代碼
到目前為止,我們導入了微信的SDK,配置了開發環境。試著運行一下吧!如果沒有報錯,就可以進行下一步啦!有報錯可以在評論區評論。
4.1 獲取appID
在我們編寫代碼之前,還有一個東西需要準備的,那就是appID。
什么是appID呢?appID是微信用來標識你的應用的唯一ID,注意與蘋果的app id沒有任何關系。
如果你已經創建了移動應用并且審核通過了的話,點擊應用的查看按鈕進入應用詳情可以看到如下圖:紅框里面的就是appID,這個東西待會有用。
如果你沒有appID呢?你可以先用這個:
wxd930ea5d5a258f4f // 微信SDK demo里的appID
這個appID是微信自己的demo里面的appID,用來測試很方便。
接下來的代碼里都用這個appID。
4.2 在應用里注冊你的appID
在AppDelegate.m文件中,引入WXApi.h
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[WXApi registerApp:@"wxd930ea5d5a258f4f"];//注冊appID
return YES;
}
4.3 分享一段文本到微信
好了!該開始寫分享的代碼了,在Main.storyboard的viewController里放置一個按鈕,在viewController.m文件里引入微信的兩個頭文件:
#import "WXApi.h"
#import "WXApiObject.h"
在按鈕的響應事件里這樣寫:
- (IBAction)shareButtonClick:(id)sender {
SendMessageToWXReq *req = [[SendMessageToWXReq alloc]init];
req.bText = YES; // 指定為發送文本
req.text = @"hello world"; // 要發送的文本
req.scene = WXSceneSession;// 指定發送到會話
[WXApi sendReq:req];
}
運行一下,一切正常的話,你現在應該可以分享文本到微信好友了!
注意req.scene是指定你要分享到哪個場景,在上面的代碼里是分享到會話(聊天界面)里,你還可以選擇分享到朋友圈或者收藏:
/*! @brief 請求發送場景
*
*/
enum WXScene {
WXSceneSession = 0, /**< 聊天界面 */
WXSceneTimeline = 1, /**< 朋友圈 */
WXSceneFavorite = 2, /**< 收藏 */
};
4.4 分享網頁到微信
只需要簡單的代碼,我們可以分享一個網頁到微信:
-(void)sendUrl:(NSString*)url To:(enum WXScene)scene{
SendMessageToWXReq *req = [[SendMessageToWXReq alloc]init];
req.bText = NO;
req.scene = WXSceneSession;// 分享到會話
WXMediaMessage *medMessage = [WXMediaMessage message];
medMessage.title = @"分享網頁的標題"; // 標題
medMessage.description = @"這個就是描述啦";// 描述
WXWebpageObject *webPageObj = [WXWebpageObject object];
[medMessage setThumbImage:[UIImage imageNamed:@"kitty"]];// 縮略圖
webPageObj.webpageUrl = @"http://www.baidu.com";
medMessage.mediaObject = webPageObj;
req.message = medMessage;
[WXApi sendReq:req];
}
效果如圖:
上面是分享到會話里,同樣的也可以分享到微信朋友圈和收藏,只要修改scene(場景)即可。
5 對分享結果進行處理
當微信處理完你的情求,跳回到你的app時,會給你帶上一些信息,在這里你可以對其進行處理,知道是用戶取消了,還是發送成功了。
在AppDelegate.m 里:
- 聲明實現WXApiDelegate協議
- 實現application:handleOpenURL方法,將url交給微信SDK進行處理
- 實現WXApiDelegate協議里的onResp:方法。
// 處理其他app調起的情況
-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
// 交給微信處理,如果它能處理 會回調delegate的相關方法如onResp:
return [WXApi handleOpenURL:url delegate:self];
}
#pragma mark WXApiDelegate
-(void) onResp:(BaseResp*)resp{
NSString *str = [NSString stringWithFormat:@"%d",resp.errCode];
UIAlertView *alertview = [[UIAlertView alloc] initWithTitle:@"微信返回結果" message:str delegate:self cancelButtonTitle:@"好的" otherButtonTitles:nil, nil];
[alertview show];
}
6.總結
iOS分享內容到微信的基本流程到這里就差不多了,如果還想深入可以去看官方的開發文檔和demo。
有什么問題歡迎在評論區提出,大家一起交流!