- 作者:Mandarava(鳗驼螺)
- 参考:
- 微信官方文档《iOS接入指南》
- 微信SDK Demo项目
- 微信iOS SDK文档
准备工作
首先到微信开放平台注册开发者帐号,并在后台的“管理中心”创建应用、递交审核,获取应用的AppID后即可用于开发;同时,在微信的“资源中心”下载微信的最新SDK。这些基本的东西某就不曰(yue)了,如果有问题请阅读微信开放平台的帮助。
工具和版本
某这里使用Xcode7.1和微信SDK1.6.2。
微信分享详细步骤
- 使用Xcode新建一个iOS项目,命名为:WeixinShareTest。
-
将SDK压缩包中的 libWeChatSDK.a,WXApi.h,WXApiObject.h 三个文件添加到项目中。
image.png - 建立桥接文件:WeixinShareTest-Bridging-Header.h,文件内容:
@import UIKit; //使用1.6版必须有(PS:1.5版可以不要)
#import "WXApiObject.h"
#import "WXApi.h"
建立桥接(PS:搜索“bridging”可以快速定位)
image.png
-
导入有关的类库:SystemConfiguration.framework,libz.tbd,libsqlite3.0.tbd,libc++.tbd(注:Xcode7开始把.dylib改成了.tbd了,如果是用Xcode6.4这里的.tbd还原成.dylib;另外,实际上,这里还缺少一个依赖包,后面再曰)。
image.png -
设置Url schame:添加一个URL Type,identifier中填写:weixin,URL Schemes中填写你的AppID。
image.png - 另外,按照SDK中说明文件的说法,还需要将下面的内容加入到项目的Info.plist中(用文本编辑器打开,放在倒数第2行上面即可)。
<key>LSApplicationQueriesSchemes</key>
<array>
<string>weixin</string>
</array>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
- 声明AppDelegate实现WXApiDelegate协议
class AppDelegate: UIResponder, UIApplicationDelegate, WXApiDelegate
- 在 AppDelegate的application:didFinishLaunchingWithOptions:函数中向微信注册id
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
WXApi.registerApp("Your_AppID") //改成你实际的AppID
return true
}
- 重写AppDelegate的application:handleOpenURL:和application:openURL:sourceApplication:annotation:方法
func application(application: UIApplication, handleOpenURL url: NSURL) -> Bool {
return WXApi.handleOpenURL(url, delegate: self)
}
func application(application: UIApplication, openURL url: NSURL, sourceApplication: String?, annotation: AnyObject) -> Bool {
return WXApi.handleOpenURL(url, delegate: self)
}
- 实现WXApiDelegate中的方法onReq和onResp方法。这二个方法怎么使用某先不表,后面再曰,这里只空实现它们;这二个方法不影响分享操作,只是你可能需要知道分享结果,如分享是否成功,发生了什么错误等,需要用到onResp;onReq是微信终端向第三方应用发起请求,要求第三方应用响应的操作,咱这里用不到。
func onReq(req: BaseReq!) {
//onReq是微信终端向第三方程序发起请求,要求第三方程序响应。第三方程序响应完后必须调用sendRsp返回。在调用sendRsp返回时,会切回到微信终端程序界面。
}
func onResp(resp: BaseResp!) {
//如果第三方程序向微信发送了sendReq的请求,那么onResp会被回调。sendReq请求调用后,会切到微信终端程序界面。
}
-
到这里,我们可以尝试编译一下,看看到目前为止的工作是否都正常。而事实是,编译结果出现2个错误,主要是前一个错误:
image.png
"_OBJC_CLASS_$_CTTelephonyNetworkInfo", referenced from:
objc-class-ref in libWeChatSDK.a(MTAHelper.o)
这个错误是因为缺少了CoreTelephony.framework,不过微信SDK并没有说这是个依赖库(PS:微信SDK1.5不需要,应该是1.6新增的),但不管它,加进来再说。再次编译,成功!
image.png
- 下面开始实现分享操作,微信有很多分享方式,可以分享文本、链接、图片、音频、视频、文件等,可以将资源分享到朋友圈、聊天界面、收藏等。具体实现方法都可以在参考微信SDK Demo中的WXApiRequestHandler.m中的方法(当然它是OC代码),这里某只实现二个常用的,一个是文本分享,一个图片分享,图片分享自动生成缩略图。具体实现如下,其中inScene可选的值有三个:WXSceneTimeline(朋友圈)、WXSceneSession(聊天界面) 、WXSceneFavorite(收藏)。
//分享文本
func sendText(text:String, inScene: WXScene)->Bool{
let req=SendMessageToWXReq()
req.text=text
req.bText=true
req.scene=Int32(inScene.rawValue)
return WXApi.sendReq(req)
}
///分享图片
func sendImage(image:UIImage, inScene:WXScene)->Bool{
let ext=WXImageObject()
ext.imageData=UIImagePNGRepresentation(image)
let message=WXMediaMessage()
message.title=nil
message.description=nil
message.mediaObject=ext
message.mediaTagName="MyPic"
//生成缩略图
UIGraphicsBeginImageContext(CGSize(width: 100, height: 100))
image.drawInRect(CGRectMake(0, 0, 100, 100))
let thumbImage=UIGraphicsGetImageFromCurrentImageContext()
UIGraphicsEndImageContext()
message.thumbData=UIImagePNGRepresentation(thumbImage)
let req=SendMessageToWXReq()
req.text=nil
req.message=message
req.bText=false
req.scene=Int32(inScene.rawValue)
return WXApi.sendReq(req)
}
- 调用分享方法的代码:
sendText("这是来自Mandarava(鳗驼螺)的分享", inScene: WXSceneTimeline) //分享文本到朋友圈
sendImage(UIImage(named: "MyImage.png")!, inScene: WXSceneTimeline) //分享图片到朋友圈,假设项目中已经添加了一张名曰MyImage.png的大图片作为分享图片
下面是文本分享和图片分享到朋友圈的结果;另外这里显示的是“未审核应用”,因为某这个只是测试应用,用了一个未经审核过的AppID。
image.png
- 事情还没完,如果你想知道用户是否完成了分享,需要实现前面说过的onResp方法,回到AppDelegate.swift中去实现它;这个方法实现起来其实很简单,代码如下;其中,可以用resp.isKindOfClass(SendMessageToWXResp)来确保的是分享操作的回调(当然,因为我们这里只有分享操作,这个检测不要也罢)。
func onResp(resp: BaseResp!) {
if resp.isKindOfClass(SendMessageToWXResp){//确保是对我们分享操作的回调
if resp.errCode == WXSuccess.rawValue{//分享成功
NSLog("分享成功")
}else{//分享失败
NSLog("分享失败,错误码:%d, 错误描述:%@", resp.errCode, resp.errStr)
}
}
}
题外话:写这篇文章时,某用的AppID一直是个乱取的值(并不是来自微信开放平台后台创建应用的AppID),整个开发过程没什么问题,直到测试这个onResp时发现一直没反应,但代码肯定没问题(因为以前在项目中也是这样做的),后来发现原来是这个AppID的问题,用回了在开放平台创建的AppID后就能正常收到onResp了。所以,实践之前,尽量先去开放平台创建应用获得真实的AppID来测试。
- 题外话:可以用
WXApi.isWXAppInstalled()
来检查系统中是否安装了微信,在未安装时隐藏分享按钮,避免Appstore审核被拒;也不要用通过分享来提供应用内奖励,这属于“使用App Store以外的软件提供额外功能”,也会被拒。我纳闷的是,审核的系统中会装有微信吗?通过隐藏微信分享的方式或许能混过去。 - 打完收工!若有错误欢迎批评指证;转载本文请注明来源。
by Mandarava(鳗驼螺)
网友评论