README.md

DotzuX

中文介绍

中文介紹(繁體)

Next Generation of Dotzu (iOS Debugging Tool)

Introduction

New feature (0.3.8)

When you are in the Network Details page, you can shake device or simulator to share network details via email or copy to clipboard.

Added two new parameters when initialize DotzuX:

• emailToRecipients

    emailToRecipients: sets the initial recipients to include in the email’s “To” field when share via email. default value is `nil`.
  

• emailCcRecipients

    emailCcRecipients: sets the initial recipients to include in the email’s “Cc” field when share via email. default value is `nil`.
  

Installation

CocoaPods

platform :ios, '8.0'
use_frameworks!

target 'YourTargetName' do
    pod 'DotzuX', :configurations => ['Debug']
end

Carthage

github "DotzuX/DotzuX"

WARNING: Don't submit .ipa to AppStore which has been linked with the DotzuX.framework. This Integration Guide outline a way to use build configurations to isolate linking the framework to Debug builds only.

Usage

Swift

//Step 1.
#if DEBUG
    import DotzuX
#endif

//Step 2.
#if DEBUG
    DotzuX.enable()
#endif

//Step 3.
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)
    #endif
}

Objective-C

//Step 1.
#ifdef DEBUG
    @import DotzuX;
#endif

//Step 2.
#ifdef DEBUG
    [DotzuX enable];
#endif

//Step 3.
#ifdef DEBUG
    #define NSLog(fmt, ...) [DotzuX objcLog:[[NSString stringWithUTF8String:__FILE__] lastPathComponent] :NSStringFromSelector(_cmd) :__LINE__ :(fmt, ##__VA_ARGS__) :[UIColor whiteColor]]
#else
    #define NSLog(fmt, ...) nil
#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.

TODO

• Unit Testing

License

DotzuX is released under the MIT license.