ART Eclipse

Installation

For instructions with screenshots click here.

• Click Help > Install new software
• Click Add and use the following settings
  • Name: ART Eclipse Source
  • Location: https://urop.jrtapsell.co.uk
• Untick Group items by catagory
• Tick ART Eclipse Feature
  • Dot Viewer plugin is optional, but you need to have the dot tool installed and in your environment path
• Click Next to calculate the required dependencies
• On the Review the items to be installed page click Next
• Accept the license and then press Finish
• You will get a Security Warning, press Ok
• When asked if you want to restart Eclipse, click Yes

Updating

• Click Help > Installation Details
• Select ART Eclipse and click Update

Getting started

Opening the ART Perspective

• Click Window > Perspective > Open Perspective > Other
• Choose ART Perspective

Making a new project

• Click File > New > ART Project
• Give it a name and click Finish

Making a new ART File

• Click File > New > ART File
• Give it a name and click Finish

Making a new String File

• Click File > New > String File
• Give it a name and click Finish
• Right click on the string file and select Set Parent
• Type the name of the file in the box, select it and press Ok

Reporting bugs

There are 3 catagories of bugs

Please check on https://jrtapsell.myjetbrains.com/youtrack/issues/AE to see if the issue is already reported before reporting.

ART bugs

• These cause a red message in the bottom left of your window, and an entry with text similar to ART Failure: ..., logged to [<FILE_PATH>] in the error log
• To report these, create an issue describing the bug with the zip file mentioned in the error attached
• The following information is sent in the zip file
  • The version of the plugin you are running
  • The stack trace of the exception that happened
  • The grammar / string that was being parsed at the time

Logged bugs

• These cause an entry in the error log, but are not Base bugs
• To report these:
  • First clear your Error Log
  • Then recreate the issue, so only the relevant errors show in the Error Log
  • Right click on any entry in the log and select Export Log..., saving the output to a file
  • Create a new issue describing the bug, how to reproduce the issue, and attaching the log file
  • The log file will contain
    • The stack traces and messages of any errors

Unlogged bugs

• These cover all bugs that do not show anything in the error log
• To report these please make a new issue describing the bug and describe how to reproduce it