Logodvm

dvm alias

Give a version a name you will remember, or list the names you have.

dvm alias <name> <version>
dvm alias list

An alias is a name you define for a version, stored in ~/.dvm/config.json. Anywhere dvm accepts a version, it accepts an alias. 

dvm alias work 3.13.2

"work" now means 3.13.2.

Then:

dvm use work
dvm global work
dvm install work

Repointing#

Changing an alias moves every project pinned to it, in one command:

dvm alias work 3.14.0

"work" now means 3.14.0.
  was: 3.13.2
  Dart 3.14.0 is not installed. Run: dvm install 3.14.0

An alias may point at an SDK you have not installed — writing the alias before the download is a reasonable thing to do — and dvm tells you right then, with the command that fills the gap.

Listing#

dvm alias list

Aliases in /Users/you/.dvm/config.json:

  legacy -> 3.4.0  (installed)
  work   -> stable -> 3.13.2  (installed)

Channels, as recorded by dvm install:
  stable -> 3.13.2

The chain is shown when there is one. Channels are listed alongside because they are the other way a name maps to a version, and the two are easy to confuse — see Aliases and Channels.

Plain dvm alias with no arguments does the same thing as dvm alias list.

Names dvm reserves#

ReservedWhat it already means
stable, beta, dev Channel names. Resolution checks channels before aliases, so such an alias would be silently unreachable.
Anything that looks like a versiondvm could not tell the alias from the version.
list dvm alias list has to keep meaning "show me the aliases".
A leading -It reads as an option.
Whitespace or / or \A name is a single word.

dvm says so at the moment you try, which is what keeps every name in your config a name that resolves.

Chains and loops#

An alias may point at another alias or at a channel, and dvm follows the chain up to eight hops. A loop — including an alias pointing at itself — is reported at the command that would create it, rather than at the cd that would have met it later.

See also#