CocoaDebug：一个 iOS 调试工具，支持 Debug 模式下查看 App 日志.zip

| <img alt="logo" src="https://raw.githubusercontent.com/CocoaDebug/CocoaDebug/master/pic/logo.png" width="250"/> | <ul align="left"><li><a href="https://github.com/CocoaDebug/CocoaDebug/wiki/%E4%B8%AD%E6%96%87%E4%BB%8B%E7%BB%8D">中文介绍</a><li><a href="#introduction">Introduction</a><li><a href="#installation">Installation</a><li><a href="#usage">Usage</a><li><a href="#parameters">Parameters</a></ul> | | -------------- | -------------- | | Travis CI | [](https://travis-ci.org/CocoaDebug/CocoaDebug) | | Codacy | [](https://www.codacy.com/app/CocoaDebug/CocoaDebug?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=CocoaDebug/CocoaDebug&amp;utm_campaign=Badge_Grade) | | Codecov | [](https://codecov.io/gh/CocoaDebug/CocoaDebug) | | Frameworks | [](https://github.com/Carthage/Carthage) [](https://img.shields.io/cocoapods/v/CocoaDebug.svg) | | Languages |  | | Platform |  | | Licence | <img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat" alt="License MIT"/> | <span style="float:none" /> ## Introduction  - [x] Shake to hide or show the black bubble. (support both device and simulator) - [x] Long press the black bubble to show `UIDebuggingInformationOverlay`. (Apple's Private API, support iOS 10/11/12) - [x] Application memory usage and *FPS*. - [x] List all `print()` and `NSLog()` messages which have been written by developer in Xcode. - [x] List of all the network requests sent by the application. - [x] List crash errors. - [x] Share network details via email or copy to clipboard when you are in the *Network Details* page. - [x] Copy logs. (long press the text, then select all or select copy) - [x] Search logs by keyword. - [x] List application and device informations, including: *version*, *build*, *bundle name*, *bundle id*, *screen resolution*, *device*, *iOS version* - [x] List all sandbox folders and files, supporting to preview and edit. - [x] List HTML logs, including `console.log()`,`console.debug()`,`console.warn()`,`console.error()`,`console. info()`. (support both `WKWebView` and `UIWebView`). - [x] Support `JSON` and Google's `Protocol buffers` ## Installation ### CocoaPods ```ruby target 'YourTargetName' do pod 'CocoaDebug', :configurations => ['Debug'] end ``` ### Carthage ```ogdl github "CocoaDebug/CocoaDebug" ``` ### Framework [Download](https://github.com/CocoaDebug/CocoaDebug/raw/master/CocoaDebug.framework.zip) > WARNING: Don't submit `.ipa` to AppStore which has been linked with the `CocoaDebug.framework`. This [Integration Guide](https://github.com/CocoaDebug/CocoaDebug/wiki/Integration-Guide) outline a way to use build configurations to isolate linking the framework to `Debug` builds only. ## Usage ### Swift //AppDelegate.swift #if DEBUG import CocoaDebug #endif #if DEBUG CocoaDebug.enable() #endif public func print<T>(file: String = #file, function: String = #function, line: Int = #line, _ message: T, color: UIColor = .white) { #if DEBUG swiftLog(file, function, line, message, color, false) #endif } ### Objective-C //AppDelegate.m #ifdef DEBUG @import CocoaDebug; #endif #ifdef DEBUG [CocoaDebug enable]; #endif > Please check `Example_Swift.xcodeproj` and `Example_Objc.xcodeproj` for more advanced usage. > NOTE: Be careful with `Other Swift Flags` & `Preprocessor Macros` when using Swift & Objective-C in one project. You can refer to [here](https://stackoverflow.com/questions/24111854/in-absence-of-preprocessor-macros-is-there-a-way-to-define-practical-scheme-spe). ## Parameters When you initialize CocoaDebug, you can customize the following parameter values before `CocoaDebug.enable()`. - `serverURL` - If the crawled URLs contain server URL ,set these URLs bold font to be marked. not mark when this value is nil. default value is **nil**. - `ignoredURLs` - Set the URLs which should not crawled, ignoring case, crawl all URLs when the value is nil. default value is **nil**. - `onlyURLs` - Set the URLs which are only crawled, ignoring case, crawl all URLs when the value is nil. default value is **nil**. - `tabBarControllers` - Set controllers to be added as child controllers of UITabBarController. default value is **nil**. - `logMaxCount` - The maximum count of logs which CocoaDebug display. default value is **1000**. - `emailToRecipients` - Set the initial recipients to include in the email’s “To” field when share via email. default value is **nil**. - `emailCcRecipients` - Set the initial recipients to include in the email’s “Cc” field when share via email. default value is **nil**. - `mainColor` - Set the main color with hexadecimal format. default value is **#42d459**. ## TODO - [Unit Testing](https://codecov.io/gh/CocoaDebug/CocoaDebug) ## Thanks Special thanks to [remirobert](https://github.com/remirobert). ## License CocoaDebug is released under the [MIT license](https://github.com/CocoaDebug/CocoaDebug/blob/master/LICENSE).