FLEX

When setting fields of type id or values in NSUserDefaults via FLEX, the tool attempts to parse the input string as JSON. This allows you to provide complex data structures like arrays and dictionaries using strings.

• Complex Types: Use JSON syntax for arrays and dictionaries.
• Strings: To set a literal string value, you must wrap it in quotes (e.g., "value").
• Explicitly Typed Strings: For ivars or properties explicitly typed as NSStrings, quotes are not required.

If you have added FLEX files manually to your Xcode project, you can exclude them from production builds via Xcode settings:

1. Navigate to Build Settings.
2. Locate Build Options > Excluded Source File Names.
3. For the Release configuration, set the value to FLEX* to exclude all files with the FLEX prefix.

When running in the iOS Simulator, you can use the following default keyboard shortcuts to interact with FLEX:

• f: Toggle the FLEX toolbar.
• ?: Show a full list of available shortcuts.
• Esc: Close active modals.
• Arrow Keys: Scroll through content.
• 3D Touch Simulation: Use combinations of Command, Control, and Shift keys. Each key contributes 1/3 of the maximum possible force. Note that you must move the touch slightly to see pressure updates.

FLEX requires an app targeting iOS 9 or higher. Choose the installation method that matches your project's dependency manager.

CocoaPods

Add the following to your Podfile. It is recommended to restrict FLEX to Debug configurations to prevent it from being included in production builds.

Carthage

Add the following to your Cartfile:

Swift Package Manager

Add the repository URL to your Package.swift dependencies and include FLEX in your target's dependencies.

# CocoaPods
pod 'FLEX', :configurations => ['Debug']

# Carthage
gitub "flipboard/FLEX"

// Swift Package Manager
dependencies: [
    .package(url: "https://github.com/FLEXTool/FLEX.git", .upToNextMajor(from: "4.3.0"))
]

// In your target
.target(
    name: "YourDependency",
    dependencies: [
        "FLEX"
    ]
)

FLEX uses certain functions (such as NSGetSizeAndAlignment()) that throw exceptions when they encounter unhandleable input. FLEX catches these exceptions internally to prevent the app from crashing, but if you have exception breakpoints active in Xcode, the debugger will stop at these points.

Recommendation: You may want to disable exception breakpoints while actively using FLEX to avoid unnecessary interruptions.

You can trigger the FLEX toolbar to appear within your application using the FLEXManager singleton. It is highly recommended to wrap these calls in #if DEBUG blocks to ensure the debugging tools are never accessible in production builds.

// Objective-C
[[FLEXManager sharedManager] showExplorer];

// Swift
FLEXManager.shared.showExplorer()

You can extend FLEX by adding your own custom keyboard shortcuts to the simulator using the registerSimulatorShortcutWithKey:modifiers:action:description: method on FLEXManager.

```objc
// Example usage pattern
[FLEXManager sharedManager] registerSimulatorShortcutWithKey:someKey 
                                                 modifiers:someModifiers 
                                                   action:someSelector 
                                                description:@