Swift 库

    总述

    Swift 库通过调用 public 接口,实现发送搜索请求、接收处理搜索响应等功能,是一个 Cocoa Touch Framework,你可以直接使用, git clone 后,添加项目到 Workspace ,建立依赖关系即可。直接使用这个库能够帮助开发者在 iOS 应用上快速添加微搜索,实现搜索和自动补全的功能。

    所有源码托管在 GitHub, 开发者们可前往查看最新版本。源码同时附带 例子,方便用户学习使用。

    in Swift

    导入

    在 Swift 项目中,导入微搜索的 Swift 库有两种方法:

    1. 使用Project:

    将TinySouClient.swift直接导入到你的ios项目中。

    2. 使用Workspace:

    将library项目添加到Workspace, 为 App 添加依赖。具体用法如下:

    1. 创建 Workspace,用来管理我们的项目及其依赖的第三方库(已有Workspace的可以略过这一步),将App和library都加入同一工作目录中: ![Image text]
    2. 为 App 添加依赖。在你的App的 Genral 选项卡中,添加 Linked Frameworks and Libraries,选择 Workspace 中 TinySouClient的.framework文件: ![Image text]
    3. 可以在 DemoApp 项目代码中 import TinySouClinet来使用我们的库。

    使用

    设置engine_key

          let engine_key: String = "示例key"
    

    建立微搜索

          //初始化
          var tinySouClient = TinySouClient(engine_key: engine_key)
          //设置搜索结果显示的页数
          tinySouClient.setPage(page)
          //设置搜索请求参数,省略则采用默认参数
          var search_params = ["q": search_content, "c": "page", "page": page, "engine_key": EngineKey, "per_page": 10]           as [String: AnyObject]
          tinySouClient.setSearchParams(search_params)
          //新建搜索请求 search_content为待搜索内容
          var request = tinySouClient.buildRequest(search_content)
          //...发送请求(略)推荐采用NSURLSession
          //...处理响应结果 (略) 推荐使用SwiftyJSON
    

    自动补全请求

          //初始化
          var tinySouClient = TinySouClient(engine_key: engine_key)
          //设置自动补全参数,省略则采用默认参数
          var fetch_field: Array = ["title", "sections", "url", "updated_at"]
          var ac_params = ["q": search_content, "c": "page", "engine_key": EngineKey, "per_page": 10, "fetch_fields":            fetch_field] as [String: AnyObject]
          tinySouClient.setSearchParams(ac_params)
          //新建自动补全请求
          var ac_request = tinySouClient.buildAcRequest(search_content)
          //...发送请求(略)推荐采用NSURLSession
          //...处理响应结果 (略) 推荐使用SwiftyJSON
    

    in Objective-C

    导入

    在 Objective-C 项目中,导入tinysou-swift-library,有两种办法:

    1. 使用Project:

    1. 将TinySouClient.swift直接导入到你的ios项目中
    2. 在 Objective-C 文件中,导入系统自动生成的.h文件
          #import "项目名-swift.h"
    

    2. 使用Workspace:(待补充)

    使用

    设置engine_key

          NSString *engine_key = @"0b732cc0ea3c11874190";
    

    建立微搜索

          //初始化
          TinySouClient *tinySouClient = [[TinySouClient alloc]initWithEngine_key: engine_key];
          //设置搜索结果显示的页数
          [tinySouClient setPage:0];
          //设置搜索请求参数,省略则采用默认参数
          NSDictionary *params = [NSDictionary dictionaryWithObjectsAndKeys: search_content, @"q", @"page",@"c", engine_key, @"engine_key",@"2", @"page",@"10",@"per_page",nil];
          [tinySouClient setSearchParams:params];
          //新建搜索请求 search_content为待搜索内容
          NSURLRequest *request = [tinySouClient buildRequest: search_content];
          //...发送请求(略)推荐采用NSURLSession
          //...处理响应结果 (略)
    

    自动补全请求

          //初始化
          TinySouClient *tinySouClient = [[TinySouClient alloc]initWithEngine_key: engine_key];
          //设置自动补全参数,省略则采用默认参数
          NSArray *fetch_fields = [[NSArray alloc] initWithObjects:@"title", @"sections", @"url", @"updated_at",nil];
          NSDictionary *params = [NSDictionary dictionaryWithObjectsAndKeys: search_content, @"q", @"page",@"c", engine_key, @"engine_key",@"0", @"page",@"10",@"per_page",fetch_fields, @"fetch_fields",nil];
      [tinySouClient setAcParams:params]
          //新建自动补全请求
          NSURLRequest *request = [tinySouClient buildAcRequest: search_content];
          //...发送请求(略)推荐采用NSURLSession
          //...处理响应结果 (略)