merrickp / JumpMarks

Xcode plugin for numbered bookmarks
61 stars 7 forks source link
alcatraz navigation xcode-plugin

logo

Build Status

Overview

JumpMarks is an Xcode plugin to navigate your project files by numbered bookmarks. When developing applications, it is often not enough to be able to jump between just two places in our code by navigating forward and backward in history. There may be logical components that we jump around perhaps between model, view, and controller (or view model). When refactoring, we may jump around to different files in our project to compare the old and new blocks of code. Before a code review, we may set all of the locations that we want reviewed in the IDE.

Whatever the need is to navigate your code efficiently, JumpMarks allows you to set numbered bookmarks (0-9) to jump around these points in your code. Simply type Shift + Option + [0-9] to set a mark at the currently selected line in your open file editor, and then type Option + [0-9] to jump back to that mark later.

In order to use this plugin in Xcode 8 and above, you must unsign the Xcode.

Installation

Install by either:

1. Use Alcatraz (Easy Mode)

or

2. Build from Source (Manual Labor)

To uninstall, remove the plugin file JumpMarks.xcplugin from ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins and restart Xcode.

Usage

Toggling JumpMarks:

Toggle by typing Shift + Option + [0-7] toggle_navigation

Go to specific JumpMark:

Jump directly to numbered mark by typing Option + [0-7] jump_navigation

Go to next/previous JumpMark:

Jump to next/prev set mark by typing Option + ] or Option + [, respectively next_navigation

Other options can be found in the JumpMarks submenu added in the Editor menu in the menu bar.

Marks will be persisted in a plist file named ${USER}.jumpmarks in the project's xcuserdata.

Acknowledgements