Find file
Fetching contributors…
Cannot retrieve contributors at this time
87 lines (65 sloc) 3.79 KB

These plugins are known to be compatible with Xcode 5.1, and may work with Xcode 5.01.

For Xcode 4.6.2 and Xcode 5.01, see the xcode_462 branch.

===== DESCRIPTION =====

This project includes plugins (known as fixins) that extend Xcode and fix some of its annoying behaviors.

===== INSTALLATION (Xcode 5) =====

Despite the name, the Xcode 4 Fixins are compatible with Xcode 5.

To install the fixins:

  1. Open the XCFixins workspace
  2. Change the scheme to Build All Fixins
  3. Build the fixins

The fixins will automatically be installed as a part of the build process. Xcode must be relaunched for the fixins to take effect.

Fixins are installed into ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/.

===== THE FIXINS =====

CurrentLineHighlighter: This fixin highlights the line currently being edited in the source editor, making it easier to track the current insertion point. This fixin adds a "Current Line Highlight Color..." menu item to the Editor menu to set the highlight color.

DisableAnimations: This fixin disables Xcode's various NSAnimation-based animations, such as the Show/Hide Debug Area, Show/Hide Navigator, and Show/Hide Utilities animations.

FindFix: By default, when Xcode's inline find bar opens, it doesn't display any options to customize searching. This fixin makes Xcode show all find options (such as "Ignore Case") in the find bar when it opens. This fixin also makes text-replacement the default mode in the inline find bar, giving immediate access to the "Replace" and "Replace All" buttons.

The FindFix fixin also installs an additional option in the Find menu: Auto Populate Find Bar. When ticked, and the find bar is activated, the search text will be set to the text of the current selection, if any, or the word at the cursor.

HideDistractions: This fixin adds a "Hide Distractions" menu item to the View menu, which focuses the current editor by hiding auxiliary views and maximizing the active window. This fixin works best when the XCFixin_DisableAnimations fixin is also installed.

The default key combination for the 'Hide Distractions' menu item is command-shift-D, which interferes with Xcode's default key combination for 'Jump to Instruction Pointer' (under the Navigate menu), so you may want remove that key binding to free up command-shift-D. Alternatively, you can modify the 'Hide Distractions' key combination by editing XCFixin_HideDistractions.m and changing the kHideDistractionsKey and kHideDistractionsKeyModifiers constants at the top of the file.

InhibitTabNextPlaceholder: This fixin disables using the tab key to select between argument placeholders of a synthesized (by Xcode's code completion) method call. Xcode's default tab functionality can be annoying if you've synthesized a method invocation and attempt to indent something nearby before filling-in the argument placeholders; in such a case, Xcode jumps to the nearest argument placeholder instead of indenting. This fixin does not affect the "Jump to Next Placeholder" key binding in the Xcode preferences.

TabAcceptsCompletion: Upon pressing tab, this fixin makes Xcode accept the currently-highlighted completion suggestion in the popup list. (Xcode's default tab behavior accepts only as much of the highlighted completion that is common amongst other suggestions.)

UserScripts: Reinstates some semblance of the Xcode 3.x User Scripts menu. See documentation in the XCFixin_UserScripts directory.

CustomizeWarningErrorHighlights: Customize the inline error/warning message highlight color. Useful if want to be able to read your code when using a dark background color.

Note that the CustomizeWarningErrorHighlights fixin includes a reference to an Xcode framework; to build this fixin, Xcode must be installed in the default location of /Applications/