iOS接入指南 ¶

注：本文为微信iOS终端SDK新手使用教程，只涉及教授SDK的使用方法，默认读者已经熟悉XCode开发工具的基本使用方法，以及具有一定的编程知识基础等。

1.向微信注册你的应用程序id¶

请到开发者应用登记页面进行登记，登记并选择移动应用进行设置后，将获得AppID，可立即用于开发。但应用登记完成后还需要提交审核，只有审核通过的应用才能正式发布使用。

2.下载微信终端SDK文件¶

SDK文件包括 libWeChatSDK.a，WXApi.h，WXApiObject.h 三个。如选用手动集成，请前往“资源下载页”下载最新SDK包

3.搭建开发环境¶

3.1 通过CocoaPods集成¶

[1] 在XCode中建立你的工程。

[2] 在工程的Podfile里面添加以下代码：

pod ‘WechatOpenSDK’ 保存并执行pod install,然后用后缀为.xcworkspace的文件打开工程。

注意:

命令行下执行pod search WechatOpenSDK,如显示的WechatOpenSDK版本不是最新的，则先执行pod repo update操作更新本地repo的内容

关于CocoaPods的更多信息请查看 CocoaPods官方网站。

[3] 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏的“URL type“添加“URL scheme”为你所注册的应用程序id（如下图所示）。

Xcode设置URL scheme

[4] 在你需要使用微信终端API的文件中import WXApi.h 头文件，并增加 WXApiDelegate 协议。

#import <UIKit/UIKit.h>
#import "WXApi.h"

@interface AppDelegate : UIResponder<UIApplicationDelegate, WXApiDelegate>

@property (strong, nonatomic) UIWindow *window;

@end

常见问题：

对于之前SDK放在主工程目录下，切换成CocoaPods的形式，执行pod install 之后，出现

Use the $(inherited) flag, or
Remove the build settings from the target.

解决方法是把工程target中的build Setting里面PODS_ROOT的值替换成$(inherited)

Other Linker Flags中 -all_load 替换成$(inherited)

3.2 手动集成¶

[1] 在XCode中建立你的工程。

[2] 将SDK文件中包含的 libWeChatSDK.a，WXApi.h，WXApiObject.h 三个文件添加到你所建的工程中（如下图所示，建立了一个名为Test 的工程，并把以上三个文件添加到Test文件夹下）。

(注：请使用xCode4.5及以上版本)

[3]微信开放平台新增了微信模块用户统计功能，便于开发者统计微信功能模块的用户使用和活跃情况。开发者需要在工程中链接上:SystemConfiguration.framework, libz.dylib, libsqlite3.0.dylib, libc++.dylib, Security.framework, CoreTelephony.framework, CFNetwork.framework，CoreGraphics.framework。

[4] 在你的工程文件中选择Build Setting，在”Other Linker Flags”中加入”-Objc -all_load”，在Search Paths中添加 libWeChatSDK.a ，WXApi.h，WXApiObject.h，文件所在位置（如下图所示）。

(注：请使用xCode4.5及以上版本)

[5] 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏的“URL type“添加“URL scheme”为你所注册的应用程序id（如下图所示）。

Xcode设置URL scheme

[6] 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏的“LSApplicationQueriesSchemes“添加weixin（如下图所示）。

[7] 在你需要使用微信终端API的文件中import WXApi.h 头文件，并增加 WXApiDelegate 协议。

#import <UIKit/UIKit.h>
#import "WXApi.h"

@interface AppDelegate : UIResponder<UIApplicationDelegate, WXApiDelegate>

@property (strong, nonatomic) UIWindow *window;

@end

4.在代码中使用开发工具包¶

[1] 要使你的程序启动后微信终端能响应你的程序，必须在代码中向微信终端注册你的id。（如下图所示，在 AppDelegate 的 didFinishLaunchingWithOptions 函数中向微信注册id）。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //向微信注册
    [WXApi registerApp:@"wxd930ea5d5a258f4f"];
    return YES;
}

[2] 重写AppDelegate的handleOpenURL和openURL方法：

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return  [WXApi handleOpenURL:url delegate:self];
}

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
    return [WXApi handleOpenURL:url delegate:self];
}

[3] 现在，你的程序要实现和微信终端交互的具体请求与回应，因此需要实现WXApiDelegate协议的两个方法：

>-(void) onReq:(BaseReq*)reqonReq

是微信终端向第三方程序发起请求，要求第三方程序响应。第三方程序响应完后必须调用sendRsp返回。在调用sendRsp返回时，会切回到微信终端程序界面。

>-(void) onResp:(BaseResp*)resp

如果第三方程序向微信发送了sendReq的请求，那么onResp会被回调。sendReq请求调用后，会切到微信终端程序界面。

具体在此两方法中所要完成的内容由你定义，具体可参考微信开发工具包中的SDK Sample Demo源码。

[4] 如果你的程序要发消息给微信，那么需要调用WXApi的sendReq函数：

>-(BOOL) sendReq:(BaseReq*)req

其中req参数为SendMessageToWXReq类型。

需要注意的是，SendMessageToWXReq的scene成员，如果scene填WXSceneSession，那么消息会发送至微信的会话内。如果scene填WXSceneTimeline，那么消息会发送至朋友圈。如果scene填WXSceneFavorite,那么消息会发送到“我的收藏”中。scene默认值为WXSceneSession。

至此，你已经能使用微信终端SDK的API内容了。如果想更详细了解每个API函数的用法，请查阅官网API文档或自行下载阅读微信SDK Sample Demo源码。

微信 SDK Sample Demo 源码

iOS接入指南¶