AppCode Help

Basics and Installation

On this page:

Downloading and installing AppCode

You can download the latest version of AppCode from the JetBrains website.

To install AppCode, open the .dmg package, and drag or copy AppCode to the Applications folder.

Note: Please, make sure that you have Apple Java 6 installed on your computer. If not, you can download it from Apple official support site.

Starting AppCode

  • Go to your /Applications folder and run the AppCode application.

Creating a command-line launcher

The command-line launcher lets you start AppCode from any directory by typing appcode in the Terminal. (When creating the launcher, you can specify any other name and then use it instead of appcode)

To create the launcher:

  1. Open or create a project.
  2. Select Tools | Create Command-line Launcher.
  3. Specify the launcher name and location. (The defaults are appcode and /usr/local/bin respectively.)

Licensing

AppCode provides several types of licenses, to flexibly meet the demands of the customers. In particular, there are such licences as:

  • Personal (for individual developers)
  • Commercial (for companies and organizations)
  • Students (for students and teachers)
  • Classroom (for education and training)
  • Open-source (for open-source projects)

Besides that, AppCode provides additional licensing options.

Find the detailed information about licensing terms and additional options on the Buy&Renew page.

Registering your license key

To register your license key

  1. On the main menu, choose Help | Register. Note that Help | Register menu action is not available for EAP builds.
  2. In the AppCode License Activation dialog box, select the desired option:
    • Enter license key: specify the user name and license key.
    • Enter license server address: specify the license server. If you don't know the address, click Discover.
    • JetBrains Account: specify the user name or e-mail address and enter the password.
    • Evaluate for free for 30 days: select this option to get free evaluation license.
  3. Click OK.

ac_licenseJB

License tickets from the License Server

If you are using a license distributed with the JetBrains License Server, you can get two types of license tickets. By default, the server issues a floating license ticket for you, which lasts as long as you are connected to the server. If you need to work offline, you can get a permanent license ticket.

The table below describes the differences between the two types of the license tickets.

TicketDetailsAdvantagesDisadvantages
Floating license ticket(default)At startup, AppCode finds the License server in the local network and requests a ticket, which is returned to the server and becomes available to other users when AppCode is closed. Both obtaining and returning of the ticket are done automatically.Number of licenses on the license server can be less than the number of AppCode users. For example, if there are 60 engineers who use AppCode but only a maximum of 50 of them can use AppCode concurrently, then 50 licenses on the license server would be enough.Connection to the License Server via a local network or VPN is required to start AppCode.
Permanent license ticketOnce obtained, a permanent ticket stays on a client machine. It is not available to other users until it is returned from the client. Both obtaining and returning of the ticket are done manually on the client or by a license server administrator.The client do not need network connection to start AppCode.The license obtained with a permanent ticket remains unavailable for other users even if the client do not use it.

Troubleshooting

A license key can be rejected by the software in certain cases. The table below outlines the reasons of license rejections, and the possible ways to solve the problem.

ReasonSolution
Wrong user nameMake sure that you are using the User Name which is specified in your license certificate email. If a license is registered in your company name, it will not work with your personal name.
Misspelled User Name/License KeyTo avoid misspellings, we recommend that you copy your User Name and license key from the license certificate e-mail rather than enter them manually in the software. You can do so by using the ⌘C and ⌘V shortcuts.
A license key does not qualify for upgrade to a higher versionIf your license key does not work with the newly installed version of the software, please make sure that your current license key allows you to upgrade for free to the latest version. If it does not, please contact sales (sales@jetbrains.com) in order to upgrade your license.
Concurrent use of a license keyMake sure that your license key is not being used by another developer in your company at the same time. Concurrent use of a single license on multiple instances of the software is restricted by our software license agreements (unless you have obtained a floating license) and is prevented by software functionality.

See Also

Last modified: 27 May 2015