Troubleshooting problems when working with MPS

This chapter summarizes known problems and possible remedies for users working with MPS. If your issue is not listed here, please open a new issue on GitHub.

Symptom: exception “Wrong dependency type: class com.intellij.openapi.util.Key” while editing a document

This seems to be a known problem with MPS: MPS-30801.

Please vote on the issue above for MPS to provide a remedy.

No workaround is available as of today. See asciidoctor-intellij-plugin#502 for more details and a discussion.

If you found a workaround for this problem, please open a new issue or edit this document.

Symptom: PluginException at IDE startup mentioning “RefactoringMenu”

This problem doesn’t appear in MPS 2020.2.2 anymore. It is no longer necessary to install the “AsciiDoc MPS add-on”.

This problem was first observed on MPS 2019.3.4. The assumed cause for this is MPS removing menu items compared to IntelliJ core. This leads to the exception at startup time. The rest of the plugin’s functionality is unaffected.

To work around the exception install an AsciiDoc MPS add-on in addition to the regular AsciiDoc plugin.

Follow these steps:

  1. Vote for MPS to remedy the situation: MPS-31202

  2. Download the “AsciiDoc MPS add-on”: asciidoctor-intellij-plugin-mps.jar

  3. Go to File  Settings…​  Plugins  Gear Icon ()

  4. Choose Install plugin from disk…​

  5. Choose the downloaded file in the file selection dialogue

  6. Restart the IDE

You can read more about this in the related GitHub issue asciidoctor-intellij-plugin#502.