Skip to content

Latest commit

 

History

History
120 lines (86 loc) · 5.8 KB

UPGRADING.md

File metadata and controls

120 lines (86 loc) · 5.8 KB
Raw

Table of Contents

Upgrading

v10.0.0

Module and Library dependencies will automatically be updated when directories under deps or apps change, but if you do not want to wait, you can re-import the project and the Module interdependencies and Libraries will be setup.

If you want dependencies to appear in External Libraries in a pre-existing project, as will happen with an new projects imported into IntelliJ Elixir 10.0.0, you will need to manually mark the directory as excluded:

  1. Right-click deps
  2. Select Mark Directory as > Excluded

v9.0.0

If you depended on the ability of go to either the source or decompiled module or function from Go To Symbol or Go To Declaration, you now need to use Go To Related Symbol (Ctrl+Cmd+Up) to get to the decompiled version when the cursor is on the source module or call name.

v6.0.0

IntelliJ IDEA v14.1.X is no longer supported because it lacked the necessary APIs to support concurrent test tracking in the Test Results pane. You will need to update to a newer version (15+) of IntelliJ IDEA or equivalent JetBrains IDE generation.

v5.0.0

Module attribute folding to their value is off by default now. If you want to re-enable the old behavior, Check Preferences > Editor > General > Code Folding > Elixir Module Attributes.

v4.0.0

Preferences/Settings

The Preferences > Editor > Colors & Fonts > Elixir has been reorganized and all the Text Attribute Keys have default Text Attributes for the Darcula and Default schemes, so if you have a custom scheme, you may want to try using the Darcula or Default schemes, or at least save a new custom scheme from those defaults. If you want to use the same font as used in the new screenshots, with the ligatures that make the pipe arrow one grapheme, that is Fira Code. There are installation instructions in that repository.

v2.0.0

Preferences/Settings

The fallback key attribute is DefaultLanguageHighlighterColors.FUNCTION_CALL, which is uncolored in most themes, so users need to customize their themes to see the highlighting for "Kernel Functions", "Kernel Macros", and "Kernel.SpecialForms Macros".

Quick Fix

The "Add Newline" and "Add Semicolon" Quick Fixes have been removed as the parsing elements they depend on have been removed in favor of JetBrains' OpenAPI error handling. If your workflow depended on these quick fixes you will have to manually add newlines or semicolons now.

v1.0.0

New Elixir File has moved to the last item in the New File menu to preserve CTRL+N ENTER keyboard shortcut for New > File, so if you got used to using CTRL+N ENTER for New Elixir File you'll have to learn the new position at the bottom of the menu.

v0.3.1

**NOTE: The Project Structure Detector is just bookkeeping and visual now. No other features currently take advantage of the SDK setting or the marked directories. Theses Project Settings will be used for later features. **

To take advantage of the new Project Structure Detector in IntelliJ, you will want to recreate any project you previously opened as an Empty Project.

(Copied from Elixir Plugin > Features > Project > From Existing Directory in README.md)

  1. File > New > Project From Existing Sources...
  2. Select the root directory of your project.
  3. Leave the default selection, "Create project from existing sources"
  4. Click Next
  5. Project name will be filled with the basename of the root directory. Customize it if you like.
  6. Project location will be the root directory.
  7. Click Next.
  8. If you previously opened the directory in IntelliJ or another JetBrains IDE, you'll be prompted to overwrite the .idea directory. Click Yes.
  9. You'll be prompted with a list of detected Elixir project roots to add to the project. Each root contains a mix.exs. Uncheck any project roots that you don't want added.
  10. Click Next.
  11. Select a Project SDK directory by clicking Configure.
  12. The plugin will automatically find the newest version of Elixir installed. (NOTE: SDK detection only works for homebrew installs on OSX. Open an issue with information about Elixir install locations on your operating system and package manager to have SDK detection added for it.)
  13. If the automatic detection doesn't find your Elixir SDK or you want to use an older version, manually select select the directory above the bin directory containing elixir, elixirc, iex, and mix.
  14. Click Next after you select SDK name from the Project SDK list.
  15. Click Finish on the framework page. (No framework detection is implemented yet for Elixir.)
  16. Choose whether to open in a New Window or in This Window.

Alternatively, you can manually mark the directories and setup the Elixir SDK.

v0.3.0

The prior version of New > Elixir File validated that the input name was a valid path and would only allow lowercase names, so you'd be forced to set the name to foo, which would produce a foo.ex file, but foo would also be used in the file contents:

defmodule foo do

end

In v0.3.0, the validator was corrected so that it only allows Alias (with and without .), so instead of entering the name as foo, enter it as Foo. The file will still be named foo.ex, but the module name will correctly be Foo in the file contents:

defmodule Foo do
end