Skip to content

Latest commit

 

History

History
97 lines (90 loc) · 4.71 KB

README.md

File metadata and controls

97 lines (90 loc) · 4.71 KB

tinysou-swift

想要在项目中学习，查看demo

一 介绍

微搜索ios-swift-library，通过调用public接口，实现新建微搜索请求、处理微搜索响应等功能。目前支持的接口有：

  • 搜索API
  • 自动补全API

tinysou-swift是一个 Cocoa Touch Framework，你可以直接使用， git clone 后，添加项目到 Workspace ，建立依赖关系即可。

二 如何使用

in Swift

如果你准备在Swift代码中使用tinysou-swift-library，有两种办法：

  • 使用Project：将TinySouClient.swift直接导入到你的ios项目中
  • 使用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来使用我们的库

如何在应用中进行微搜索(swift)

  • 设置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 object-C

如果你准备在object-c代码中使用tinysou-swift-library，有两种办法：

  • 使用Project：
  1. 将TinySouClient.swift直接导入到你的ios项目中
  2. 在object-c文件中，导入系统自动生成的.h文件
      #import "项目名-swift.h"
  • 使用Workspace：（待补充）

如何在应用中进行微搜索(object-C)

  • 设置engine_key
      NSString *engine_key = @"0b732cc0ea3c11874190";
  • 建立微搜索
      //初始化
      TinySouClient *tinySouClient = [[TinySouClient alloc]initWithEngine_key: engine_key]; 
      //设置搜索结果显示的页数
      [tinySouClient setPage:1];
      //设置搜索请求参数，省略则采用默认参数
      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
      //...处理响应结果 (略)