AppCode
 
2022.2
Shortcuts: macOS
Get AppCode
You are viewing the documentation for an earlier version of AppCode.
  1. Work with source code
  2. Auto import

Auto import

Last modified: 21 July 2022

When you start using a class that is not yet imported, or a method from a library that is not yet included, AppCode will suggest adding the corresponding import statement automatically, or on code completion.

note

Auto-import is not available for Swift.

Import a missing header file

  1. Type a reference to a non-imported class or function.

  2. Press ⌥ ⏎. If there are multiple choices, select the desired option from the list.

    https://resources.jetbrains.com/help/img/idea/2022.2/ac_auto_import.png
    Gif

Automatically add import statements (in TypeScript)

In TypeScript files, AppCode can automatically add import statements if there is only one option to choose from.

  1. In the Preferences dialog (⌃ ⌥ S), go to Editor | General | Auto Import | TypeScript/JavaScript.

  2. Select the Add unambiguous imports on the fly checkbox and apply the changes.

When you paste blocks of code that contain references to the symbols that are not yet imported, AppCode will add missing imports automatically.

Disable import tooltips

When tooltips are disabled, unresolved references are underlined and marked with the red bulb icon the Quick-fix button. To view the list of suggestions, click this icon (or press ⌥ ⏎) and select Import class.

Disable all tooltips

  • Hover the mouse over the inspection widget in the top-right corner of the editor, click More, and disable the Show Auto-Import Tooltip option.

    Disable popups

Disable auto import

If you want to completely disable auto-import, make sure that:

Optimize imports

The Optimize Imports feature helps you remove unused imports and organize import statements in the current file or in all files in a directory at once according to the rules specified in Preferences | Editor | Code Style | <language> | Imports.

tip

You can exclude specific files and folders from import optimization. For more information, refer to Exclude files from reformatting.

Optimize all imports

  1. Select a file or a directory in the Project tool window (View | Tool Windows | Project).

  2. Do any of the following:

    • From the main menu, select Code | Optimize Imports (or press ⌃ ⌥ O).

    • From the context menu, select Optimize Imports.

  3. (If you've selected a directory) Choose whether you want to optimize imports in all files in the directory, or only in locally modified files (if your project is under version control), and click Run.

Optimize imports in a single file

  1. Place the caret at the import statement and press ⌥ ⏎ or use the the Intention action button icon.

  2. Select Optimize imports.

tip

To optimize imports in a file, you can also press ⌃ ⌥ ⇧ L, select Optimize imports, and click Run.

Optimize imports when committing changes to Git

If your project is under version control, you can instruct AppCode to optimize imports in modified files before committing them to VCS.

  1. Press ⌃ K or select Git | Commit from the main menu.

  2. Click Show Commit Options and in the Before commit area, select the Optimize imports checkbox.

Optimize imports when reformatting a file (Objective-C)

You can tell AppCode to optimize imports in a file every time it is reformatted.

  • Open the file in the editor, press ⌃ ⌥ ⇧ L, and make sure the Optimize imports checkbox is selected in the Reformat File dialog that opens.

    Reformat file dialog

After that every time you press ⌃ ⌥ L in this project, AppCode will optimize its imports automatically.