Skip to content

Latest commit

 

History

History
166 lines (114 loc) · 9.11 KB

ide-usage.md

File metadata and controls

166 lines (114 loc) · 9.11 KB
Raw

Using an IDE

Eclipse IDE

  • Replace all references of Eclipse → Preferences → ... to Window → Preferences → ... if you are using Windows or Linux.
  • If you worry that these settings will interfere with your other projects, you can use a separate Eclipse instance for TEAMMATES.

Supported Eclipse versions: Eclipse IDE for Java EE Developers version Neon or Oxygen.

Prerequisites

  1. You need the following plugins:

    eclipsesetupguide-1.png

    eclipsesetupguide-2.png

  2. In Eclipse, do the following works before importing the project:

    • Google Cloud Tools: Go to Eclipse → Preferences → Google Cloud Tools and fill the SDK location box with the directory of your installed Google Cloud SDK.

      eclipsesetupguide-3.png

    • JRE: Go to Eclipse → Preferences → Java → Installed JRE and ensure a JDK 1.8 (not JRE) entry exists.

      eclipsesetupguide-4.png

      Note that the JDK to be used is not required to be the default.

Project Setup

  1. Run this command to get necessary configuration files for Eclipse:

    ./gradlew setupEclipse

    Verification: The folder .launches should be added to the project root directory.

  2. Import the project to your Eclipse instance.

    • Go to File → Import....
    • Select Existing Gradle Project under Gradle. Click Next >.
    • Set the Project root directory to the location where the repo is cloned. Click Next >.
    • If necessary, tick Override workspace settings and choose Gradle wrapper. Click Finish.

    After importing the project, you may see many errors/warnings on your marker tab. You need not be alarmed as these will be resolved in the next step.

  3. Configure the following project-specific settings (all can be found in Project → Properties → ..., except for the HTML, CSS and XML settings which can be found in Eclipse → Preferences → ...):

    • Text encoding: Resources → change the Text file encoding setting from Default to Other: UTF-8.

      eclipsesetupguide-5.png

    • JDK: Java Build Path → Libraries → ensure that the system library used is JDK 8.

      eclipsesetupguide-6.png

    • Compiler compliance: Java Compiler → tick Use compliance from execution environment 'JavaSE-1.8' on the 'Java Build Path'.

      eclipsesetupguide-7.png

    • Indentation: In TEAMMATES, we use 4 spaces in place of tabs for indentations. Configure for all the languages used in TEAMMATES:

      • Java: Java → Code Style → Formatter → Edit → Tab policy → Spaces only.
      • JavaScript: JavaScript → Code Style → Formatter → Edit → Tab policy → Spaces only.

      You can find the Web and XML options in Eclipse → Preferences → ....

      • HTML: Web → HTML Files → Editor → Indent using spaces.
      • CSS: Web → CSS Files → Editor → Indent using spaces.
      • XML: XML → XML Files → Editor → Indent using spaces.

    • Validation: Go to Validation → ...

      • Disable validation for HTML, JSP, and XML: Uncheck the Build option for HTML Syntax Validator, JSP Content Validator, JSP Syntax Validator, XML Schema Validator, and XML Validator.
      • Disable validation for JavaScript and JSON files in node_modules folder: Click the ... settings button for JavaScript Validation → if Exclude Group is not already in the list then click Add Exclude Group... → Exclude Group → Add Rule... → Folder or file name → Next → Browse Folder... → navigate to the node_modules folder and confirm → Finish. Similarly for JSON Validator.

  4. Clean the project for all changes to take effect. Ensure that there are no errors. Warnings are generally fine and can be ignored.

    eclipsesetupguide-8.png

    If you are using Eclipse Neon, you will find that all declarations of import and export in JavaScript files are marked as errors. This is fine and is not a cause of concern.

  5. To set up some static analysis tools, refer to this document.

  6. To move on to the development phase, refer to this document

Note: It is not encouraged to run Gradle tasks via Eclipse.

IntelliJ IDEA

  • Replace all references of IntelliJ IDEA → Preferences to File → Settings if you are using Windows or Linux.

Supported IntelliJ versions: IntelliJ IDEA Ultimate Edition (required to work with Google App Engine). You can sign up for the free JetBrains student license if you are a student registered in an educational institution.

Prerequisites

  1. You need a Java 8 SDK with the name 1.8 defined in IntelliJ IDEA as follows:

    • Click Configure → Project Defaults → Project Structure (or File → Project Structure if a project is currently open). Select SDKs in Platform Settings and check if there is an SDK named 1.8 with a JDK home path pointing to a JDK 8 path. Otherwise add a new SDK using JDK 8 with a name of 1.8. intellijsetupguide-1.png

  2. You need the Google Cloud Tools plugin installed and configured:

    intellijsetupguide-2.png

    • During installation, you may encounter two prompts: one to install the Google Account plugin dependency and another to disable the obsolete Google App Engine Integration plugin. Answer Yes to both prompts.
    • After installation, restart IntelliJ IDEA and configure the plugin. Click Configure → Settings/Preferences (or IntelliJ IDEA → Preferences if a project is currently open), go to Other Settings → Google → Cloud SDK, and select your Google Cloud SDK directory. intellijsetupguide-3.png

Project Setup

  1. Import the project as a Gradle project as follows:

    1. Click Import Project (or File → New → Project from Existing Sources... if a project is currently open).
    2. Select the local repository folder and click Open.
    3. Select Import project from external model and then Gradle.
    4. Click Next.
    5. Check Use auto-import and uncheck Create separate module per source set.
    6. Ensure Create directories for empty content root automatically is unchecked.
    7. Ensure Use default gradle wrapper is selected.
    8. Ensure for Gradle JVM: that a JDK 8 with a name of 1.8 is selected.
    9. Click Finish. Wait for the indexing process to complete.
    10. You should see a dialog box with the message:
      Framework detected: Google App Engine Standard framework is detected..
      OR
      Frameworks detected: Web, Google App Engine Standard frameworks are detected.
      Click Configure and ensure that only the Google App Engine Standard framework is shown, then click OK. If there are other frameworks shown, click Cancel and wait until indexing completes, then try again.

      If you closed or missed the dialog box, go to View → Tool Windows → Event Log. You should see the same message as the dialog box, click Configure and then OK.

  2. Configure the project settings as follows:

    Indentation

    In TEAMMATES, we have standards defined for indentation. See Coding standards in Supplementary documents.

    1. Open IntelliJ IDEA → Preferences.
    2. Go to Editor → Code Style and ensure that Use tab character is unchecked for Java, JavaScript, JSON, CSS and XML.
    3. Ensure that Tab size:, Indent: and Continuation indent: are 4, 4 and 8 respectively for the different languages.
    4. Ensure HTML has Use tab character unchecked and set Tab Size:, Indent: and Continuation indent: to 2, 2 and 4 respectively.
    5. Ensure JSP has Use tab character unchecked and set Tab Size:, Indent: and Continuation indent: to 2, 2 and 4 respectively.

    Text Encoding

    Go to Editor → File Encodings and ensure that Project Encoding and Default Encoding for properties files is set to UTF-8.

    Javascript

    Go to Languages & Frameworks → JavaScript and select ECMAScript 6 for the JavaScript language version.

  3. Click OK.

  4. Run this command to set up the run configurations for IntelliJ:

    ./gradlew setupIntellij

  5. To set up some static analysis tools, refer to this document.

  6. To move on to the development phase, refer to this document.