NetLogger是一个库,用于跟踪您的应用程序发出的所有网络请求。该库可以用于跟踪所有HTTP请求(GET
、POST
、PUT
、UPDATE
、HEAD
等)并查看所有请求的详细信息。详细信息包括请求URL、请求和响应头、请求和响应体、请求和响应时间、往返时间等。
该库可用于调试网络调用,可以直接通过应用程序界面查看请求中发送或接收的确切URL和数据负载。使用该库可以在应用程序内部启动专门的调试用户界面。可以在此UI中查看所有网络请求的详细信息。在调试网络请求时,无需将设备连接到XCode(甚至无线连接都不需要)。
安装
NetLogger作为cocoapod分发,如果您熟悉使用cocoapods,那么这应该是件轻而易举的事情。在Podfile中包含以下内容,然后执行'pod install'或'pod update'
pod 'NetLogger'
使用
使用方法很简单,只需在您的AppDelegate.m
文件中包含以下几行代码即可。
- 在
AppDelegate.m
中导入NetLogger.h
文件
#import <NetLogger/NetLogger.h>
- 在
方法中添加以下几行代码。
NetLogger* nl = [NetLogger sharedManager];
[nl show:ALIGN_RIGHT];
这就是全部。现在运行您的应用程序,您应该在应用程序的右侧看到一个悬浮的启动按钮。点击此按钮可以启动NetLogger界面。
目前,NetLogger启动按钮可以显示在左侧、右侧、顶部或底部位置。您可以使用ALIGN_RIGHT
、ALIGN_LEFT
、ALIGN_TOP
或ALIGN_BOTTOM
来适应您的要求。
示例
如果您喜欢,我们还提供了一个小型的示例项目,您可以快速尝试。要运行示例项目,请克隆存储库,然后先从示例目录运行pod install
。
NetLogger 接口
如果您已正确启用 pod,NetLogger 启动按钮应该显示在应用右侧。启动按钮的 z-index 较高,因此它通常始终显示在您的应用顶部,除非您使用系统对话框或键盘。在有请求进行时,启动按钮会变为黄色。
单击启动按钮将呈现 NetLogger 接口。第一个屏幕展示给您一个带有请求时间的网络请求列表。它还列出了请求类型,例如 GET
、POST
、PUT
等。每个请求旁边显示一个颜色的圆圈(黄色、红色或绿色)。
- 如果圆圈颜色为黄色 - 表示请求已发起,正在等待响应。
- 如果颜色为红色 - 表示请求已发起并收到响应,但响应代码不是 HTTP 2XX(200、201、202 等)。响应可能是 4XX 或 5XX。
- 如果颜色为绿色 - 表示请求已发起,收到的响应代码是 HTTP 2XX。
列表界面是动态的,每当应用中发起请求时都会更新。
单击一个请求将显示该请求的详细信息。这些信息包括请求 URL、请求和响应头、请求和响应正文、请求和响应时间、往返时间等详细信息。
故障排除 & 反馈
寻求帮助的最佳地方是 GitHub 的问题部分。只需发布您需要帮助的内容,我们将与之联系。
如果您有任何反馈,请随时与我们分享。我们计划定期更新库,使其更加强大!
致谢 & 声明
NetLogger 由 VersionN Studios 所拥有和维护。此库旨在调试目的,不应与应用程序一起分发。
许可证
NetLogger 采用 BSD 许可证。请参阅 LICENSE 文件获取更多信息。
贡献
我们欢迎对 NetLogger 的贡献。请提交包含您已修复、添加或更新的详细信息的 pull request,我们将相应地审查和合并/讨论。