mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-05-12 17:04:57 +00:00
[ACS-3908] Add node version manager support (#7960)
* [ACS-3908] Add node version manager support * [ACS-3908] Correct node version
This commit is contained in:
parent
558d16006a
commit
d571943274
@ -11,7 +11,7 @@ The first thing to do is to check the prerequisites and the requirements to run
|
||||
|
||||
More in particular check that you have:
|
||||
- Alfresco Content Services (alias ACS) Enterprise edition up and running (identify the URL that will be required as configuration).
|
||||
- The latest lts version of [NodeJs](https://nodejs.org/en/ "https://nodejs.org/en/").
|
||||
- The latest lts version of [NodeJs](https://nodejs.org/en/ "https://nodejs.org/en/"). For more convenient Node.js version management please check out [Node Version Management](./docs/tutorials/nvm.md).
|
||||
- A recent (and supported) version of a browser (see [here](https://github.com/Alfresco/alfresco-ng2-components#browser-support "https://github.com/Alfresco/alfresco-ng2-components#browser-support") for further details).
|
||||
|
||||
All the Angular development is done using the [Typescript](https://www.typescriptlang.org/ "https://www.typescriptlang.org/") language. With this in mind, it is highly suggested to adopt a good text editor to help you in this task. We recommend [Visual Studio Code](http://code.visualstudio.com/ "http://code.visualstudio.com/") a free, lightweight, and _very_ powerful tool from Microsoft that works well with Angular development and has a [big ecosystem of plugins](https://marketplace.visualstudio.com/VSCode "https://marketplace.visualstudio.com/VSCode") to make the developer experience even better.
|
||||
|
116
docs/tutorials/nvm.md
Normal file
116
docs/tutorials/nvm.md
Normal file
@ -0,0 +1,116 @@
|
||||
---
|
||||
Title: Node Version Manager
|
||||
---
|
||||
|
||||
# Node Version Manager
|
||||
|
||||
Nvm is a version manager for Node.js. You can use it to install and switch to correct Node.js version.
|
||||
|
||||
## Installation
|
||||
|
||||
To install nvm you can run following:
|
||||
|
||||
```sh
|
||||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash
|
||||
```
|
||||
for other installation options and troubleshooting instructions please follow [nvm installation docs](https://github.com/nvm-sh/nvm#install--update-script).
|
||||
|
||||
## Usage
|
||||
|
||||
To use nvm run following command:
|
||||
|
||||
```sh
|
||||
nvm use
|
||||
```
|
||||
|
||||
which automatically use Node.js version specified in .nvmrc file. If given Node.js version is not installed you need to run:
|
||||
|
||||
```sh
|
||||
nvm install
|
||||
```
|
||||
|
||||
with version provided in .nvmrc file. Additionally if you want to install a new version of Node.js and migrate npm packages from a previous version run:
|
||||
|
||||
```sh
|
||||
nvm install node --reinstall-packages-from=node
|
||||
```
|
||||
|
||||
where 'node' is an alias for the latest version. For more details please refer to: [nvm usage](https://github.com/nvm-sh/nvm#usage).
|
||||
|
||||
## Automatically call nvm use
|
||||
|
||||
To automatically call nvm use put the following at the end of `$HOME/.bashrc`:
|
||||
|
||||
```sh
|
||||
cdnvm() {
|
||||
command cd "$@" || return $?
|
||||
nvm_path=$(nvm_find_up .nvmrc | tr -d '\n')
|
||||
|
||||
# If there are no .nvmrc file, use the default nvm version
|
||||
if [[ ! $nvm_path = *[^[:space:]]* ]]; then
|
||||
|
||||
declare default_version;
|
||||
default_version=$(nvm version default);
|
||||
|
||||
# If there is no default version, set it to `node`
|
||||
# This will use the latest version on your machine
|
||||
if [[ $default_version == "N/A" ]]; then
|
||||
nvm alias default node;
|
||||
default_version=$(nvm version default);
|
||||
fi
|
||||
|
||||
# If the current version is not the default version, set it to use the default version
|
||||
if [[ $(nvm current) != "$default_version" ]]; then
|
||||
nvm use default;
|
||||
fi
|
||||
|
||||
elif [[ -s $nvm_path/.nvmrc && -r $nvm_path/.nvmrc ]]; then
|
||||
declare nvm_version
|
||||
nvm_version=$(<"$nvm_path"/.nvmrc)
|
||||
|
||||
declare locally_resolved_nvm_version
|
||||
# `nvm ls` will check all locally-available versions
|
||||
# If there are multiple matching versions, take the latest one
|
||||
# Remove the `->` and `*` characters and spaces
|
||||
# `locally_resolved_nvm_version` will be `N/A` if no local versions are found
|
||||
locally_resolved_nvm_version=$(nvm ls --no-colors "$nvm_version" | tail -1 | tr -d '\->*' | tr -d '[:space:]')
|
||||
|
||||
# If it is not already installed, install it
|
||||
# `nvm install` will implicitly use the newly-installed version
|
||||
if [[ "$locally_resolved_nvm_version" == "N/A" ]]; then
|
||||
nvm install "$nvm_version";
|
||||
elif [[ $(nvm current) != "$locally_resolved_nvm_version" ]]; then
|
||||
nvm use "$nvm_version";
|
||||
fi
|
||||
fi
|
||||
}
|
||||
alias cd='cdnvm'
|
||||
cd "$PWD"
|
||||
```
|
||||
|
||||
or if you're using zsh put this into your `$HOME/.zshrc`:
|
||||
|
||||
```sh
|
||||
# place this after nvm initialization!
|
||||
autoload -U add-zsh-hook
|
||||
load-nvmrc() {
|
||||
local nvmrc_path="$(nvm_find_nvmrc)"
|
||||
|
||||
if [ -n "$nvmrc_path" ]; then
|
||||
local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")
|
||||
|
||||
if [ "$nvmrc_node_version" = "N/A" ]; then
|
||||
nvm install
|
||||
elif [ "$nvmrc_node_version" != "$(nvm version)" ]; then
|
||||
nvm use
|
||||
fi
|
||||
elif [ -n "$(PWD=$OLDPWD nvm_find_nvmrc)" ] && [ "$(nvm version)" != "$(nvm version default)" ]; then
|
||||
echo "Reverting to nvm default version"
|
||||
nvm use default
|
||||
fi
|
||||
}
|
||||
add-zsh-hook chpwd load-nvmrc
|
||||
load-nvmrc
|
||||
```
|
||||
|
||||
For more details visit [nvm shell integration](https://github.com/nvm-sh/nvm#deeper-shell-integration).
|
Loading…
x
Reference in New Issue
Block a user