0. ensure the latest compatible version of IntelliJ IDEA Community Edition is installed (2020.2. or later).
1. update plugin to the latest version (you can check the latest version on Plugin's official page), but at least 1.5.
2. create a new project: File -> New -> Project... and then Empty Project.
3. Link project to an A+ Course: A+ -> Link Project to an A+ Course (and choose the rest of the settings asked for in the pop-up dialog).
4. check the IDE for not having errors (you should not see the blinking red icon in the bottom-right corner as shown). If there are errors, please share the "stacktrace" text with the course staff.
Image 1. IntelliJ IDEA default error indicator
5. review the project structure for correctness: File -> Project Structure -> ...
Project
Image 2. Project Structure, Project Settings, Project View
Modules
Image 3. Project Structure, Project Settings, Modules View, Sources
Image 4. Project Structure, Project Settings, Modules View, Paths
Image 5. Project Structure, Project Settings, Modules View, Dependencies
Libraries (Scala SDK)
Image 6. Project Structure, Project Settings, Libraries View
6. download the GoodStuff module and run it by right-clicking and choosing Run
Image 7. Run GoodStuff from module context menu
7. start REPL on a GoodStuff module by right-clicking Scala REPL...
Image 8. Run REPL from GoodStuff module context menu
| # | status | description |
|---|---|---|
| 1. | problem | scalac: Scala compiler JARs not found (module: '') aka "IDE complaining about not able to see the SDK (whitespaces and special characters in path)" |
| status | solved | |
| solution | update to at least 1.3 version of the Plugin | |
| 2. | problem | assignments are not visible on Aalto Linux (VDI) |
| status | solved | |
| solution | it's an environment configuration issue and was solved by Aalto IT | |
| 3. | problem | continuously being asked to re-enter the A+ token |
| status | not possible to solve due to the configuration of Aalto Linux on VDI | |
| affected | 😠 users who can't remember their very first Aalto password | |
| solution | some, but partial | |
| 4. | problem | keymap imported by the plugin interferes with macOS's normal keyboard shortcuts |
| status | solved | |
| affected | all the 😠 Mac users | |
| solution | is described here | |
| 5. | problem | yet another NPE in REPL |
| status | solved | |
| affected | 😠 < 10 | |
| solution | since Plugin version 1.5 | |
| 6. | problem | network error about A+ token containing whitespaces |
| status | under investigation | |
| affected | 😠 < 10 | |
| solution | temporary solution: submit from the A+ Web interface | |
| 7. | problem | can't run program because of the missing Run in right-click menu |
| status | under investigation | |
| affected | 😠 < 10 | |
| solution | temporary solution: re-installation of the SDK (remove existing, follow the guide) | |
| 8. | problem | local course file missing "language" |
| status | under investigation | |
| affected | 😠 < 10 | |
| solution | temporary solution: try re-creating the project | |
| 9. | problem | local course file missing "downloadAt" |
| status | under investigation | |
| affected | 😠 < 10 | |
| solution | temporary solution: try re-creating the project |