Xcode隐藏Swift代码具体实现、私有方法、属性和类

在使用第三方库的时候，有时候我们想知道别人给我们提供了哪些类、方法和属性，但是打开源文件后，一大坨一大坨的代码都在那儿，一个个的找很是麻烦，就像下面这种

#if os(iOS) || os(tvOS) || os(watchOS)
import UIKit
#else
import Cocoa
#endif

open class HexColorTransform: TransformType {

    #if os(iOS) || os(tvOS) || os(watchOS)
    public typealias Object = UIColor
    #else
    public typealias Object = NSColor
    #endif

    public typealias JSON = String

    var prefix: Bool = false

    var alpha: Bool = false

    public init(prefixToJSON: Bool = false, alphaToJSON: Bool = false) {
        alpha = alphaToJSON
        prefix = prefixToJSON
    }

    open func transformFromJSON(_ value: Any?) -> Object? {
        if let rgba = value as? String {
            if rgba.hasPrefix("#") {
                let index = rgba.index(rgba.startIndex, offsetBy: 1)
                let hex = String(rgba[index...])
                return getColor(hex: hex)
            } else {
                return getColor(hex: rgba)
            }
        }
        return nil
    }

    open func transformToJSON(_ value: Object?) -> JSON? {
        if let value = value {
            return hexString(color: value)
        }
        return nil
    }

    fileprivate func hexString(color: Object) -> String {
        let comps = color.cgColor.components!
        let r = Int(comps[0] * 255)
        let g = Int(comps[1] * 255)
        let b = Int(comps[2] * 255)
        let a = Int(comps[3] * 255)
        var hexString: String = ""
        if prefix {
            hexString = "#"
        }
        hexString += String(format: "%02X%02X%02X", r, g, b)

        if alpha {
            hexString += String(format: "%02X", a)
        }
        return hexString
    }

    fileprivate func getColor(hex: String) -> Object? {
        var red: CGFloat   = 0.0
        var green: CGFloat = 0.0
        var blue: CGFloat  = 0.0
        var alpha: CGFloat = 1.0

        let scanner = Scanner(string: hex)
        var hexValue: CUnsignedLongLong = 0
        if scanner.scanHexInt64(&hexValue) {
            switch (hex.count) {
            case 3:
                red   = CGFloat((hexValue & 0xF00) >> 8)       / 15.0
                green = CGFloat((hexValue & 0x0F0) >> 4)       / 15.0
                blue  = CGFloat(hexValue & 0x00F)              / 15.0
            case 4:
                red   = CGFloat((hexValue & 0xF000) >> 12)     / 15.0
                green = CGFloat((hexValue & 0x0F00) >> 8)      / 15.0
                blue  = CGFloat((hexValue & 0x00F0) >> 4)      / 15.0
                alpha = CGFloat(hexValue & 0x000F)             / 15.0
            case 6:
                red   = CGFloat((hexValue & 0xFF0000) >> 16)   / 255.0
                green = CGFloat((hexValue & 0x00FF00) >> 8)    / 255.0
                blue  = CGFloat(hexValue & 0x0000FF)           / 255.0
            case 8:
                red   = CGFloat((hexValue & 0xFF000000) >> 24) / 255.0
                green = CGFloat((hexValue & 0x00FF0000) >> 16) / 255.0
                blue  = CGFloat((hexValue & 0x0000FF00) >> 8)  / 255.0
                alpha = CGFloat(hexValue & 0x000000FF)         / 255.0
            default:
                // Invalid RGB string, number of characters after '#' should be either 3, 4, 6 or 8
                return nil
            }
        } else {
            // "Scan hex error
            return nil
        }
        #if os(iOS) || os(tvOS) || os(watchOS)
            return UIColor(red: red, green: green, blue: blue, alpha: alpha)
        #else
            return NSColor(calibratedRed: red, green: green, blue: blue, alpha: alpha)
        #endif
    }
}

这是 HandyJSON 中的一个文件，如果我们需要中的一个方法，看着多么难受。

要是可以像看Apple官方提供的框架接口那样多好，用最简洁的方式看非私有的类、方法以及属性。

Xcode提供了这种功能，可以使用快捷键 command + control + ↑/↓ 在源码和接口之间切换。

切换之后，上面的那一大坨代码就会变成下面这个样子:

import UIKit

open class HexColorTransform : TransformType {

    public typealias Object = UIColor

    public typealias JSON = String

    internal var prefix: Bool

    internal var alpha: Bool

    public init(prefixToJSON: Bool = false, alphaToJSON: Bool = false)

    open func transformFromJSON(_ value: Any?) -> Object?

    open func transformToJSON(_ value: Object?) -> JSON?
}

是不是简洁了很多，隐藏了方法的具体实现过程以及使用 private 和 fileprivate 修饰的类、方法和属性，接下来要找到自己需要的方法或者属性应该不难吧。

需要注意的是，这是一种类似于预览的展示，一旦你切换到其他文件中，就会取消预览效果，恢复到正常的代码展示，不过你可以继续使用快捷键打开接口预览的效果。