Install UI Extension

Install a UI extension NPM package (.tgz or .tar, as produced by npm pack) into the local extension directory. The package name and version are read from its package.json, and the file is saved as <name>-<version>.tgz. A package with the same name and version is replaced; other versions of the same package are kept, so a project can still pin an older one.

A running Charon server picks up the new package without a restart.

Command

# local file (windows)
dnx dotnet-charon -- EXTENSION INSTALL --input "c:\my extension\my-extension-1.0.0.tgz"

# remote file
dnx dotnet-charon -- EXTENSION INSTALL --input "https://example.com/my-extension-1.0.0.tgz"

# standard input
dnx dotnet-charon -- EXTENSION INSTALL --input in < my-extension-1.0.0.tgz

Parameters

--input

Path to the package file. Alternatively, you can read from Standard Input or a URL.

# standard input (default)
--input in
--input con

# absolute path (windows)
--input "c:\my extension\my-extension-1.0.0.tgz"

# absolute path (unix)
--input /user/extensions/my-extension-1.0.0.tgz

# relative path (universal)
--input "./my-extension-1.0.0.tgz"

# remote location (HTTP)
--input "http://example.com/my-extension-1.0.0.tgz"

# remote location with authentication (FTP)
--input "ftp://user:password@example.com/my-extension-1.0.0.tgz"

The command exits with code 1 when the input is not an NPM package.

This command supports universal parameters.

See also