ASDebugger -- 超简单的 App 网络监控工具

网络监控,抓包,Mock 数据;轻松与 iOS 集成,无需用 Charles 等三方工具,过滤无用信息


安装

1. 申请 AppKey

您需要先注册一个账号,并创建你要监控的 App 信息,点击 这里注册 会引导里一步步操作

2. 用 Cocoapods 安装

使用 Cocoapods 管理第三方插件的话,集成会变得非常简单

pod 'ASDebugger'
* 注:请确保此工具只出现在 调试 Debug 环境,所以建议以下方式集成:
pod 'ASDebugger', :configurations => ['Debug']

* 或者不依赖 Pods 手动安装

下载 framework , 然后拖动它到你的项目中

使用

最简方法

通常放在 AppDelegate 的 didFinishConfiguringLaunch 中开启

切换到
import ASDebugger
ASDebugger.start(withAppKey: "您申请到的 AppKey", secret: "translation missing: cn.your applied AppSecret")

所有的网络请求将发送到这里,您可以在这里查看所有的网络请求

Mock 设置

Mock 指定数据

将指定请求,使用 数据工厂 资源返回

  1. 网络监控 中找到你要 Mock 的请求,点击 Mock 按钮,然后你会跳转到 数据工厂 API 创建界面
  2. 创建成功后,复制 API 资源栏所显示的资源地址,例如: user/profile
  3. 修改初始化代码为:
ASDebugger.shared().enableMock(withPath: "user/profile")
              

重新运行 App 后,所有这个资源请求,都会转发到您所创建的 Mock 数据。您也可以随意修改 Mock 数据内容,以供调试

Mock 所有数据

将所有请求结果,由 数据工厂 提供

ASDebugger.shared().enableMock()
              

Mock 转发

将某个请求,转发到指定资源地址

ASDebugger.shared().enableMock(withPath: "user/profile", mockUrl: "http://www.google.com/user/profile")
              

更多配置

1. 打开或关闭网络监控

ASDebugger.shared().start
ASDebugger.shared().stop

2. 打开或关闭Mock

ASDebugger.shared().enableMock()
ASDebugger.shared().disableMock()

3. 仅仅初始化不启动监控

ASDebugger.initWithAppKey("您申请到的 AppKey", secret:@"translation missing: cn.your applied AppSecret")

更多接口请参考 ASDebugger 接口文档

备注

  1. 如果您想将网络请求发送到本地,需要配置一个私有的服务端去接收请求。不过因为服务端代码目前还不成熟,抱歉未能公开,如果实在需要的同学,可以直接与作者联系
  2. 本 SDK 支持 iOS 原生底层网络组件 NSURLSession ,以及第三方网络组件 AFNetworkSDWebImage 。但未能支持 ASIHttpRequest , 因 ASI 使用了自己定义的协议进行封装,因为时间关系未能支持!

截图

Screenshot01 ef2a7436166dc7041ec0fc107c5219fd9d5500afddb41e251cf25b8bb3d29a02

Demo