AppCode
 
2022.2
Shortcuts: macOS
Get AppCode
You are viewing the documentation for an earlier version of AppCode.
  1. Work with source code
  2. Code navigation
  3. Bookmarks

Bookmarks

Last modified: 21 July 2022

Add bookmark: anonymous F11, mnemonic ⌃ F11

View all bookmarks: View | Tool Windows | Bookmarks (⌥ 2)

note

Bookmarks have replaced Favorites that existed in earlier versions of the IDE.

If you work with large projects, searching for files and folders can be time-consuming. For such cases, AppCode features bookmarks. You can bookmark the necessary lines of code to be able to find them easier. You can also bookmark the project files and folders that you need more often than other project items.

All your bookmarks are grouped in lists in the Bookmarks tool window that you can open by selecting View | Tool Windows | Bookmarks from the main menu or by pressing ⌥ 2. The tool window also shows all breakpoints that are automatically added to the dedicated list once you place them in your code.

Bookmarks tool window

AppCode has two types of bookmarks:

  • Anonymous bookmarks don't have an identifier and allow you to place as many bookmarks as you want. Files and lines marked with anonymous bookmarks have a bookmark icon.

  • Mnemonic bookmarks allow you to create bookmarks with numbers (0 to 9) or letters (A to Z). Files and lines marked with mnemonic bookmarks have the corresponding letter or number icon in a frame.

Adding bookmarks

Add bookmarks

AppCode adds your bookmarks to the predefined list in the Bookmarks tool window that is created automatically and has the same name as the project. You can create more lists and set another list as default.

Add an anonymous line bookmark

  • In the editor, place the caret at a line of code and press F11.

  • Alternatively, right-click the gutter next to the line of code that you want to bookmark and select Add Bookmark.

    Anonymous bookmark placed in the editor

A bookmark icon appears in the gutter next to the bookmarked line.

Anonymous bookmark placed in the editor

Add a mnemonic line bookmark

  1. In the editor, place the caret at a line of code and press ⌃ F11.

    Alternatively, right-click the gutter next to the line of code that you want to bookmark and select Add Mnemonic Bookmark.

  2. In the popup that opens, select a number or a letter that you want to use as an identifier for this bookmark.

    Adding a mnemonic bookmark: select an identifier

    If the selected mnemonic is already used, the IDE will ask you whether you want to overwrite an existing bookmark with the new one. Select the Don't ask again option to silently overwrite mnemonics.

  3. Optionally, provide a description for the new bookmark.

  4. Press ⏎ to save the bookmark.

A letter or a number bookmark icon appears in the gutter next to the bookmarked line.

tip

If you want to bring back the confirmation dialog that is shown before replacing an existing mnemonic with a new one, click Show Options Menu in the Bookmarks tool window and enable the Ask Before Rewriting Mnemonic option.

tip

To take a look at all line bookmarks that you have in code, press ⇧ F11 or go to Edit | Bookmarks | Show Line Bookmarks.

Bookmark files and folders

  1. In the Project tool window (⌥ 1), right-click an item that you want to bookmark and select Bookmarks | Add Bookmark (F11) or Add Mnemonic Bookmark (⌃ F11).

    note

    To add a bookmark for a folder, switch to the Files view.

  2. For mnemonic bookmarks, select a number or a letter that you want to use as an identifier for this bookmark.

  3. Press ⏎ to save the bookmark.

The corresponding icon appears in the Project tool window next to the bookmarked item.

Bookmark for a file and folder

Navigate between bookmarks

Jump to a mnemonic bookmark with a digit

  • Hold Ctrl and press the mnemonic digit on the keyboard.

    For example, to jump to the bookmark with mnemonic 5, press ⌃ 5.

Navigate line bookmarks in the popup

  1. Press ⇧ F11 or from the main menu, select Edit | Bookmarks | Show Line Bookmarks.

  2. Double-click the bookmark or select it with the keyboard and press ⏎.

    For mnemonic bookmarks, press the corresponding digit or letter.

By default, AppCode shows only line bookmarks in the bookmarks popup. You can configure the settings to see other bookmarked items (for example, files or folders): press ⌃ ⌥ S to open the IDE settings, select Advanced Settings, and disable the Show only line bookmarks in popup option.

Navigate to a bookmark from a list

  • From the main menu, select View | Tool Windows | Bookmarks or press ⌥ 2 to open the Bookmarks tool window.

  • Expand the desired bookmark list or click Expand all to expand all bookmark lists.

  • Double-click a bookmark on the list to navigate to it.

Go to the next or previous bookmark

  • Press ⌃ ⌥ ↓ (Navigate | Next Bookmark Occurrence) to jump to the next bookmark.

  • Press ⌃ ⌥ ↑ (Navigate | Previous Bookmark Occurrence) to return to the previous bookmark.

Modify bookmarks

Rename bookmarks

In the Bookmarks tool window (⌥ 2), bookmarks have short descriptions. By default, they contain the code from the line or the name of the item on which they are placed. If necessary, you can give bookmarks your own short descriptions.

  1. Right-click a bookmark icon in the editor gutter, a bookmarked item in the Project tool window, or a bookmark in the Bookmarks tool window, and select Rename Bookmark.

  2. In the dialog that opens, specify a new description and click OK.

    Renaming a bookmark

Assign a mnemonic to an anonymous bookmark

You can convert a mnemonic bookmark to an anonymous one.

  1. Right-click a bookmark icon in the editor gutter, a bookmarked item in the Project tool window, or a bookmark in the Bookmarks tool window, and select Assign Mnemonic (or press ⌃ F11).

    Assigning mnemonic to anonymous bookmark

  2. In the popup that opens, select a number or a letter that you want to use as an identifier for this bookmark.

  3. Optionally, provide a description. Press ⏎ to save the bookmark.

Change a mnemonic identifier

  1. Right-click a bookmark icon in the editor gutter, a bookmarked item in the Project tool window, or a bookmark in the Bookmarks tool window, and select Change Mnemonic (or press ⌃ F11).

    Changing a mnemonic identifier for a bookmark

  2. In the popup that opens, select another identifier. If necessary, change the description as well.

  3. Press ⏎ to save the changes.

Anonymize mnemonic bookmarks

You can convert a mnemonic bookmark to an anonymous one.

  • Right-click a bookmark icon in the editor gutter, a bookmarked item in the Project tool window, or a bookmark in the Bookmarks tool window, and select Remove Mnemonic.

    Anonymizing a mnemonic bookmark from the gutter

Delete bookmarks

Lists of bookmarks

There's one predefined empty bookmarks list that has the same name as the project. By default, AppCode adds your bookmarks there. If necessary, you can use another list as the default. You can also create multiple lists and move items between them.

Create a bookmarks list

  1. From the main menu, select View | Tool Windows | Bookmarks or press ⌥ 2 to open the Bookmarks tool window.

  2. In the tool window, click Create Bookmarks List and name the new list in the dialog that opens.

  3. Enable the Use as default list option if you want your bookmarks to go to this list automatically and click Create.

    Creating new bookmarks list

Move a bookmark to another list

  • From the main menu, select View | Tool Windows | Bookmarks or press ⌥ 2 to open the Bookmarks tool window and drag a bookmark to another list.

  • In the Project tool window (⌥ 1), right-click a bookmarked item and select Bookmarks | Add Bookmark to Another List.

Sort bookmarks

  • To move a bookmark up or down the list, right-click it in the Bookmarks tool window and select Move Up or Move Down.

  • To display line bookmarks in the tool window grouped by file, click Show Options Menu in the Bookmarks tool window and select the Group Line Bookmarks by File option.

Change the default list

AppCode adds all your bookmarks to the list that is configured as the default one. If necessary, you can use another default list for your bookmarks.

  1. From the main menu, select View | Tool Windows | Bookmarks or press ⌥ 2 to open the Bookmarks tool window.

  2. Right-click the list that you want to use as your default bookmarks list and select Mark List as Default.

    The list is now located above others in the tool window and has the Default tag.

    Another default list is configured in Bookmarks tool window

Delete a list of bookmarks

After you delete a list, all bookmarks from it are removed from code and project items.

  1. From the main menu, select View | Tool Windows | Bookmarks or press ⌥ 2 to open the Bookmarks tool window.

  2. Right-click the list that you want to delete and select Delete Bookmark List.