AppCode 2018.3 Help

Install and set up AppCode

Installation requirements

Hardware requirements

  • 4 GB RAM recommended

  • 1024x768 minimum screen resolution

Software requirements

  • macOS 10.11 or higher

  • Xcode 9.4 - 10.1

JRE 1.8 is bundled with the AppCode distribution. You do not need to install Java on your computer to run AppCode.

Download and install AppCode

To install AppCode

  1. Download AppCode

  2. Open the AppCode-*.dmg package that you've downloaded, and drag AppCode to the Applications folder.

Earlier AppCode versions are available for download on the Previous AppCode Releases page.

Run AppCode for the first time

Import AppCode settings

When you start AppCode for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings:

ac complete installation dialog

If this is your first instance of AppCode, choose the Do not import settings option.

Select behavior

On the next screen you can select the desired behavior (keymap + UI theme) to use in AppCode:
ac set UI theme
  • Select Default or Darcula option if you want to use IntelliJ keymap with the corresponding UI theme (light or dark).

  • Select Xcode behavior in case you want to set the interface theme similar to Xcode and use a special keymap which is close to the Xcode default keymap.

You can always change your theme and keymap later in AppCode preferences.

Disable the unnecessary plugins

AppCode is shipped with a variety of plugins that provide integration with different version control systems and application servers, add support for various frameworks and development technologies, etc.

On the next step you can disable the plugins you do not need. If necessary, you can re-enable them later in the Preferences dialog ( ⌘, under Plugins).

ac FirstRunDisablePlugins

You can click the Disable All link for each group of plugins to disable them all, or Customize to disable individual plugins.

Download and install additional plugins

On the next step, you are prompted to download additional plugins that are not bundled with the IDE from the AppCode plugins repository:

ac FirstRunDownloadPlugins

Start a project in AppCode

After you have completed initial AppCode configuration, the Welcome screen will be displayed. It allows you to:

ac welcomeScreen

Register AppCode

To try and evaluate AppCode, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.

  1. Do one of the following:

    • On the Welcome screen, click Configure | Manage License

    • On the main menu, select Help | Register

    The License Activation dialog
  2. Select how you want to register AppCode:

    Option

    Description

    JetBrains Account

    Register using the JetBrains Account.

    For more information, see What is JetBrains Account?

    Activation code

    Register using an activation code.

    License server

    Register using a License Server.

    To override the URL of the system proxy during initial AppCode startup, use the -Djba.http.proxy property, which can be added as a JVM option.

    When performing silent install or managing AppCode installations on multiple machines, you can set the JETBRAINS_LICENSE_SERVER environment variable to point the installation to the license server URL.

If you have plugins that require a license, then instead of the License Activation dialog, open the Licenses dialog by clicking Help | Licenses from the main menu.

The Licenses dialog

The Licenses dialog contains a list of licenses and shows their states:

  • Expired: Renew your license to continue.

  • Grace period: You have several days until the license expires.

  • Evaluation period: Use without an active license.

  • Active license: Use until the expiry date.

Manage AppCode through Toolbox App

Toolbox App is a control panel that allows you to manage all JetBrains developer tools, including AppCode, as well as your projects, from a single point of access. It lets you launch the IDEs, maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.

  1. Download Toolbox App.

  2. Launch the setup file.

  3. When the installation is complete, accept the JetBrains privacy policy and sign in to your JetBrains Account.

Now you can manage existing tools, install new tools, and download updates:

ac toolbox app
Last modified: 7 December 2018

See Also