https://github.com/vudsen/symbolic-link-manager
一个软连接管理工具。支持间接管理 NodeJS、Maven 和 Java 等几乎所有工具的版本，基于系统软连接实现，可高度自定义。A tool for managing system symbolic links. It supports version management for Java, Node.js, Maven, and more, and is based on system symbolic link.
https://github.com/vudsen/symbolic-link-manager
sdk-switch sdk-version-manage version-switch version-switcher
Last synced: 2 months ago
JSON representation
一个软连接管理工具。支持间接管理 NodeJS、Maven 和 Java 等几乎所有工具的版本，基于系统软连接实现，可高度自定义。A tool for managing system symbolic links. It supports version management for Java, Node.js, Maven, and more, and is based on system symbolic link.
- Host: GitHub
- URL: https://github.com/vudsen/symbolic-link-manager
- Owner: vudsen
- Created: 2024-11-06T10:12:43.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2024-11-17T12:39:31.000Z (7 months ago)
- Last Synced: 2025-03-06T08:38:59.920Z (3 months ago)
- Topics: sdk-switch, sdk-version-manage, version-switch, version-switcher
- Language: Go
- Homepage:
- Size: 7.45 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# symbolic-link-manager
[中文文档](/README_zh.md)
A tool to manage system symbolic link, usually used to switch SDK version.
## Install
Download from [Release](https://github.com/IceOfSummer/symbolic-link-manager/releases), and put the executable file to any empty folder.
You can add the environment variable below for better use():
- `SLINK_MANAGER_HOME`: The folder to save data and executable file. **The default value is the folder where the executable exist.**
- Add the executable file to `Path`
These environment variables are **optional**, you can also continue to use if you don't provide.
## Example
### Switch Java version
We have two `Java` here:
- `C:\Program Files\Java\jdk-17`
- `C:\Program Files\Java\jdk8u432-b06`
Manage these version by the command below:
```shell
# Declare a (symbolic) link，which name is `java`
slm add link java
# Add a tag for the link
slm add tag java 17 "C:\Program Files\Java\jdk-17"
slm add tag java 8 "C:\Program Files\Java\jdk8u432-b06"
# Switch the tag
slm use java 17
```
After all, a symbolic link named `java` will be created, it will locate at `$SLINK_MANAGER_HOME/app/`. Now you should set your
`JAVA_HOME` to this directory:
- windows: `%SLINK_MANAGER_HOME%\app\java`
- linux: `$SLINK_MANAGER_HOME/app/java`
Replace the `SLINK_MANAGER_HOME` if you don't set it in environment variable.
> [!NOTE]
> Make sure you also add `%JAVA_HOME%/bin`(windows) / `$JAVA_HOME/bin`(linux) to your `Path`。
**Then reopen the terminal. You only need to reopen the terminal the first time you set up the configuration for it to take effect.**。
After all, check you java version:
#### Switch the Maven version when switch the version of Java
When we switched to Java 17, automatically switch the Maven version to `3.8.8`. And when using Java 8，switch Maven to `3.6.3`。
Maven directories:
- `D:\DevelopmentTool\apache-maven-3.6.3`
- `D:\DevelopmentTool\apache-maven-3.8.8`
Manage these two versions:
```shell
# Declare a (symbolic) link，which name is `maven`
slm add link maven
# Add a tag for the link
slm add tag maven 3.6 "D:\DevelopmentTool\apache-maven-3.6.3"
slm add tag maven 3.8 "D:\DevelopmentTool\apache-maven-3.8.8"
# Bind to Java (You should create it before you use.)
slm add bind java:17 maven:3.8
slm add bind java:8 maven:3.6
# Switch to maven 3.6
slm use maven 3.6
```
After this, set the environment variable `MAVEN_HOME` to `%SLINK_MANAGER_HOME%\app\maven` (windows).
Now, when you switch the Java version will switch bound Maven version too:
### Switch Node.js version
NodeJS directories:
- `D:\DevelopmentTool\symbolic-link-manager\sdk\nodejs\node-v22.11.0-win-x64`
- `D:\DevelopmentTool\symbolic-link-manager\sdk\nodejs\node-v20.18.0-win-x64`
Manage these two versions:
```shell
slm add link node
slm add tag node 20 "D:\DevelopmentTool\symbolic-link-manager\sdk\nodejs\node-v20.18.0-win-x64"
slm add tag node 22 "D:\DevelopmentTool\symbolic-link-manager\sdk\nodejs\node-v22.11.0-win-x64"
slm use node 20
```
Add the `Path` variable: `D:\DevelopmentTool\symbolic-link-manager\app\node`. If you have set the `SLINK_MANAGER_HOME`,
you can use `%SLINK_MANAGER_HOME%\app\node` instead.