终端接入指引-iOS版本

1. 引入头文件，声明协议

(1.1)编译对应平台所需的Sonic.framework ,在Build目录找到.framework文件

(1.2)将Sonic.framework引入主工程

在AppDelegate中注册SonicURLProtocol

1. [NSURLProtocol registerClass:[SonicURLProtocol class]];

(1.3)引入 @import Sonic;

1. @interface SonicWebViewController : UIViewController<SonicSessionDelegate,UIWebViewDelegate>

2. 实现SonicSessionDelegate

1. #pragma mark - Sonic Session Delegate

3. /*
4. * sonic请求发起前回调
5. */
6. - (void)sessionWillRequest:(SonicSession *)session
7. {
8. //可以在请求发起前同步Cookie等信息
9. }

11. /*
12. * sonic要求webView重新load指定request
13. */
14. - (void)session:(SonicSession *)session requireWebViewReload:(NSURLRequest *)request
15. {
16. [self.webView loadRequest:request];
17. }

3. 在WebView的ViewController中接入Sonic使用 (Sample:SonicWebViewController)

1. /*
2. * 在初始化ViewController的时候发起sonic的请求
3. */
4. - (instancetype)initWithUrl:(NSString *)aUrl
5. {
6. if (self = [super init]) {

8. self.url = aUrl;

10. self.clickTime = (long long)[[NSDate date]timeIntervalSince1970]*1000;

12. //使用sonic链接创建一个会话
13. [[SonicClient sharedClient] createSessionWithUrl:self.url withWebDelegate:self];
14. }
15. return self;
16. }

18. /*
19. * 在初始化WebView之后立即发起带有sonic信息的请求
20. */
21. - (void)loadView
22. {
23. [super loadView];

25. self.webView = [[UIWebView alloc]initWithFrame:self.view.bounds];
26. self.webView.delegate = self;
27. self.view = self.webView;

29. NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:self.url]];

31. /*
32. * 查询当前ViewController是否成功创建sonic会话，如果已经创建，那么包装request成sonic请求，以便在NSURLProtocol层拦截
33. * 否则走正常模式加载请求，不会在NSURLProtocol层拦截
34. */
35. if ([[SonicClient sharedClient] sessionWithWebDelegate:self]) {
36. [self.webView loadRequest:sonicWebRequest(request)];
37. }else{
38. [self.webView loadRequest:request];
39. }
40. }

4. 调用获取差异的接口，传递sonic会话的结果信息

1. /*
2. * 此接口由页面驱动，由前端sonic组件向终端发起请求获取会话结果
3. */
4. - (void)getDiffData:(NSDictionary *)option withCallBack:(JSValue *)jscallback
5. {
6. /*
7. * 根据发起sonic会话的ViewController来查询需要的结果
8. */
9. [[SonicClient sharedClient] sonicUpdateDiffDataByWebDelegate:self.owner completion:^(NSDictionary *result) {

11. /*
12. * 这里将result传递回页面即可
13. */
14. NSData *json = [NSJSONSerialization dataWithJSONObject:result options:NSJSONWritingPrettyPrinted error:nil];
15. NSString *jsonStr = [[NSString alloc]initWithData:json encoding:NSUTF8StringEncoding];

17. JSValue *callback = self.owner.jscontext.globalObject;
18. [callback invokeMethod:@"getDiffDataCallback" withArguments:@[jsonStr]];

20. }];
21. }

5. 在WebDelegate销毁的时候移除WebDelegate对应的Session

1. - (void)dealloc
2. {
3. [[SonicClient sharedClient] removeSessionWithWebDelegate:self];
4. }