feat: update docs/sdkman.md (#588)
This commit is contained in:
zhangym
@@ -192,6 +192,7 @@ Quick Reference
|
|||||||
[Mitmproxy](./docs/mitmproxy.md)<!--rehype:style=background: rgb(4 92 135);-->
|
[Mitmproxy](./docs/mitmproxy.md)<!--rehype:style=background: rgb(4 92 135);-->
|
||||||
[Pacman](./docs/pacman.md)<!--rehype:style=background: rgb(24 147 209);&class=tag&data-lang=archlinux&class=contributing-->
|
[Pacman](./docs/pacman.md)<!--rehype:style=background: rgb(24 147 209);&class=tag&data-lang=archlinux&class=contributing-->
|
||||||
[YUM](./docs/yum.md)<!--rehype:style=background: rgb(86 86 123);-->
|
[YUM](./docs/yum.md)<!--rehype:style=background: rgb(86 86 123);-->
|
||||||
|
[SDKMAN](./docs/sdkman.md)<!--rehype:style=background: rgb(0 118 198);-->
|
||||||
<!--rehype:class=home-card-->
|
<!--rehype:class=home-card-->
|
||||||
|
|
||||||
## 数据库
|
## 数据库
|
||||||
|
|||||||
364
docs/sdkman.md
Normal file
364
docs/sdkman.md
Normal file
@@ -0,0 +1,364 @@
|
|||||||
|
SDKMAN 备忘清单
|
||||||
|
====
|
||||||
|
|
||||||
|
SDKMAN是一款管理 java 体系中的各类 SDK 版本的工具，可以用于大多数基于Uinx的系统。它提供了命令行以及API，功能有：安装、移除、列举候选版本。这个快速参考备忘单显示了它的常用命令使用清单
|
||||||
|
|
||||||
|
- [SDKMAN 官网](http://sdkman.io)
|
||||||
|
|
||||||
|
入门
|
||||||
|
---
|
||||||
|
|
||||||
|
### 安装
|
||||||
|
|
||||||
|
| 安装命令 | 环境 |
|
||||||
|
| :---------------------------------------- | ---------------------------------------------------- |
|
||||||
|
| `curl -s "https://get.sdkman.io" \| bash` | macos/linux |
|
||||||
|
| `curl -s "https://get.sdkman.io" \| bash` | windows 需要 (WSL Approach) 或者 (Git Bash Approach) |
|
||||||
|
|
||||||
|
- 查看 sdkman 是否安装成功
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ sdk version
|
||||||
|
```
|
||||||
|
|
||||||
|
### 获取帮助
|
||||||
|
|
||||||
|
您可以通过运行以下命令获得基本帮助：
|
||||||
|
|
||||||
|
`$ sdk help`
|
||||||
|
|
||||||
|
这将提供一个有用的顶级帮助页面。您可以向该命令添加限定符以获得有关特定子命令的帮助。
|
||||||
|
|
||||||
|
`$ sdk help install`
|
||||||
|
|
||||||
|
### 安装一个SDK
|
||||||
|
|
||||||
|
最新稳定版通过运行以下命令安装您选择的SDK的最新稳定版本（例如Java JDK）：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk install java
|
||||||
|
You will see something like the following output:
|
||||||
|
|
||||||
|
Downloading: java 21.0.2-tem
|
||||||
|
|
||||||
|
In progress...
|
||||||
|
|
||||||
|
######################################################################## 100.0%
|
||||||
|
|
||||||
|
Installing: java 21.0.2-tem
|
||||||
|
Done installing!
|
||||||
|
Now you will be prompted if you want this version to be set asdefault.
|
||||||
|
|
||||||
|
Do you want java 21.0.2-tem to be set as default? (Y/n):
|
||||||
|
Answering yes (or hitting enter) will ensure that all subsequent shells opened will have this version of the SDK in use by default.
|
||||||
|
|
||||||
|
Setting java 21.0.2-tem as default.
|
||||||
|
```
|
||||||
|
|
||||||
|
### 安装特定版本
|
||||||
|
|
||||||
|
`$ sdk install scala 3.4.1`
|
||||||
|
|
||||||
|
### 安装本地版本
|
||||||
|
|
||||||
|
使用快照版本？已经在本地安装了吗？通过指定本地安装的路径来安装本地版本：
|
||||||
|
|
||||||
|
`$ sdk install groovy 3.0.0-SNAPSHOT /path/to/groovy-3.0.0-SNAPSHOT`
|
||||||
|
|
||||||
|
`$ sdk install java 17-zulu /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home`
|
||||||
|
|
||||||
|
### 删除一个指定版本
|
||||||
|
|
||||||
|
`$ sdk uninstall scala 3.4.1`
|
||||||
|
|
||||||
|
### 所有可以安装的软件列表
|
||||||
|
|
||||||
|
要获得可用 sdk 的列表：
|
||||||
|
|
||||||
|
`$ sdk list`
|
||||||
|
|
||||||
|
```shell
|
||||||
|
================================================================================
|
||||||
|
Available Candidates
|
||||||
|
================================================================================
|
||||||
|
q-quit /-search down
|
||||||
|
j-down ?-search up
|
||||||
|
k-up h-help
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
...
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
Java (21.0.2-tem) https://projects.eclipse.org/projects/adoptium.temurin/
|
||||||
|
|
||||||
|
Java Platform, Standard Edition (or Java SE) is a widely used platform for
|
||||||
|
development and deployment of portable code for desktop and server environments.
|
||||||
|
Java SE uses the object-oriented Java programming language. It is part of the
|
||||||
|
Java software-platform family. Java SE defines a wide range of general-purpose
|
||||||
|
APIs – such as Java APIs for the Java Class Library – and also includes the Java
|
||||||
|
Language Specification and the Java Virtual Machine Specification.
|
||||||
|
|
||||||
|
$ sdk install java
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
### 获取某个 sdk 的版本列表
|
||||||
|
|
||||||
|
`$ sdk list groovy`
|
||||||
|
|
||||||
|
```shell
|
||||||
|
This will result in a list view showing the available, local, installed and current versions of the SDK.
|
||||||
|
|
||||||
|
================================================================================
|
||||||
|
Available Groovy Versions
|
||||||
|
================================================================================
|
||||||
|
> * 2.4.4 2.3.1 2.0.8 1.8.3
|
||||||
|
2.4.3 2.3.0 2.0.7 1.8.2
|
||||||
|
2.4.2 2.2.2 2.0.6 1.8.1
|
||||||
|
2.4.1 2.2.1 2.0.5 1.8.0
|
||||||
|
2.4.0 2.2.0 2.0.4 1.7.9
|
||||||
|
2.3.9 2.1.9 2.0.3 1.7.8
|
||||||
|
2.3.8 2.1.8 2.0.2 1.7.7
|
||||||
|
2.3.7 2.1.7 2.0.1 1.7.6
|
||||||
|
2.3.6 2.1.6 2.0.0 1.7.5
|
||||||
|
2.3.5 2.1.5 1.8.9 1.7.4
|
||||||
|
2.3.4 2.1.4 1.8.8 1.7.3
|
||||||
|
2.3.3 2.1.3 1.8.7 1.7.2
|
||||||
|
2.3.2 2.1.2 1.8.6 1.7.11
|
||||||
|
2.3.11 2.1.1 1.8.5 1.7.10
|
||||||
|
2.3.10 2.1.0 1.8.4 1.7.1
|
||||||
|
|
||||||
|
================================================================================
|
||||||
|
+ - local version
|
||||||
|
* - installed
|
||||||
|
> - currently in use
|
||||||
|
================================================================================
|
||||||
|
```
|
||||||
|
|
||||||
|
### 使用指定版本
|
||||||
|
|
||||||
|
选择在当前终端中使用给定版本：
|
||||||
|
|
||||||
|
`$ sdk use scala 3.4.1`
|
||||||
|
|
||||||
|
**重要的是要意识到，这将仅切换当前 shell 的 SDK 版本。若要使此更改永久化，请改用默认命令。**
|
||||||
|
|
||||||
|
### 设置默认版本
|
||||||
|
|
||||||
|
选择将给定版本设为默认版本：
|
||||||
|
|
||||||
|
`$ sdk default scala 3.4.1`
|
||||||
|
|
||||||
|
这将确保所有后续 shell 将从使用中的版本 3.4.1。
|
||||||
|
|
||||||
|
### 查看当前使用的版本
|
||||||
|
|
||||||
|
要查 sdk 当前使用的版本：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk current java
|
||||||
|
Using java version 21.0.2-tem
|
||||||
|
```
|
||||||
|
|
||||||
|
要查看所有 sdk 当前使用的版本：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk current
|
||||||
|
Using:
|
||||||
|
groovy: 4.0.20
|
||||||
|
java: 21.0.2-tem
|
||||||
|
scala: 3.4.1
|
||||||
|
```
|
||||||
|
|
||||||
|
### 配置 ENV
|
||||||
|
|
||||||
|
想在每次访问项目时切换到特定的 JDK 或 SDK 吗？这可以通过项目基本目录中的 `.sdkmanrc` 文件来实现。可以通过发出以下命令自动生成此文件：
|
||||||
|
|
||||||
|
`$ sdk env init`
|
||||||
|
|
||||||
|
现在已经在当前目录中创建了一个包含以下内容的配置文件：
|
||||||
|
|
||||||
|
```conf
|
||||||
|
# Enable auto-env through the sdkman_auto_env config
|
||||||
|
|
||||||
|
# Add key=value pairs of SDKs to use below
|
||||||
|
|
||||||
|
java=21.0.2-tem
|
||||||
|
```
|
||||||
|
|
||||||
|
该文件预先填充了当前使用的JDK版本，但可以根据需要包含任意多个支持的SDK的键值对。要切换到 `.sdkmanrc`文件中的配置，只需发出以下命令：
|
||||||
|
|
||||||
|
`sdk env`
|
||||||
|
|
||||||
|
您应该看到如下输出：
|
||||||
|
|
||||||
|
`Using java version 21.0.2-tem in this shell.`
|
||||||
|
|
||||||
|
您的路径现在也已更新为在当前 shell 中使用这些 SDK 中的任何一个。离开项目时，您可能需要将SDK重置为默认版本。这可以通过输入：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk env clear
|
||||||
|
```
|
||||||
|
|
||||||
|
将java版本恢复到21.0.2-tem（默认）签出新项目后，您可能缺少在项目的 `.sdkmanrc` 文件中指定的一些SDK。要安装这些丢失的SDK，只需键入：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk env install
|
||||||
|
|
||||||
|
Downloading: java 21.0.2-tem
|
||||||
|
|
||||||
|
In progress...
|
||||||
|
|
||||||
|
######################################################################## 100,0%
|
||||||
|
|
||||||
|
Repackaging Java 21.0.2-tem...
|
||||||
|
|
||||||
|
Done repackaging...
|
||||||
|
|
||||||
|
Installing: java 21.0.2-tem
|
||||||
|
Done installing!
|
||||||
|
```
|
||||||
|
|
||||||
|
您想在 cd 到目录中时自动切换 SDK 版本吗？这可以通过在 sdkman 配置中设置 `sdkman_auto_env=true` 来实现。请注意，这也会在离开目录时将任何特定于项目的SDK重置为默认版本。
|
||||||
|
|
||||||
|
### 升级版本
|
||||||
|
|
||||||
|
要查看您系统中 SDK 当前过期的内容：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk upgrade springboot
|
||||||
|
Upgrade:
|
||||||
|
springboot (1.2.4.RELEASE, 1.2.3.RELEASE < 3.2.4)
|
||||||
|
```
|
||||||
|
|
||||||
|
要查看所有 SDK 的过时内容：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk upgrade
|
||||||
|
Upgrade:
|
||||||
|
gradle (2.3, 1.11, 2.4, 2.5 < 8.7)
|
||||||
|
grails (2.5.1 < 6.1.1)
|
||||||
|
springboot (1.2.4.RELEASE, 1.2.3.RELEASE < 3.2.4
|
||||||
|
```
|
||||||
|
|
||||||
|
### SDKMAN 版本
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk version
|
||||||
|
|
||||||
|
SDKMAN!
|
||||||
|
script: 5.7.0
|
||||||
|
native: 0.1.3
|
||||||
|
```
|
||||||
|
|
||||||
|
### 离线模式
|
||||||
|
|
||||||
|
最初被称为飞行模式，这允许SDKMAN！以在脱机工作时发挥作用。它有一个参数，可以传递给启用或禁用脱机模式。
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk offline enable
|
||||||
|
Forced offline mode enabled.
|
||||||
|
|
||||||
|
$ sdk offline disable
|
||||||
|
|
||||||
|
Online mode re-enabled
|
||||||
|
```
|
||||||
|
|
||||||
|
在离线模式下操作时，大多数命令仍然可以工作，即使它们将以缩小的容量操作。例如list命令，它将只显示当前安装的和活动的版本：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk list groovy
|
||||||
|
------------------------------------------------------------
|
||||||
|
|
||||||
|
Offline Mode: only showing installed groovy versions
|
||||||
|
------------------------------------------------------------
|
||||||
|
>
|
||||||
|
> 2.4.4
|
||||||
|
|
||||||
|
- 2.4.3
|
||||||
|
|
||||||
|
------------------------------------------------------------
|
||||||
|
|
||||||
|
- - installed
|
||||||
|
>
|
||||||
|
> - currently in use
|
||||||
|
>
|
||||||
|
------------------------------------------------------------
|
||||||
|
```
|
||||||
|
|
||||||
|
当互联网可用/不可用时，离线模式也将自动禁用/启用。当然，需要互联网连接的命令不会起作用，但会发出警告。
|
||||||
|
|
||||||
|
### 自动更新
|
||||||
|
|
||||||
|
安装新版本的SDKMAN！如果可用。
|
||||||
|
|
||||||
|
`$ sdk selfupdate`
|
||||||
|
|
||||||
|
如果没有可用的新版本，将显示相应的消息。可以通过将force参数传递给命令来强制重新安装：
|
||||||
|
|
||||||
|
`$ sdk selfupdate force`
|
||||||
|
|
||||||
|
自动每日检查新版本的SDKMAN！也将代表用户执行。
|
||||||
|
|
||||||
|
### 更新
|
||||||
|
|
||||||
|
定期更新 SDKMAN！需要更新以了解新的（或已删除的）SDK。当 SDK 元数据可能变得过时时，会显示一条警告，并说明如何更新。只需运行以下命令，就可以刷新 SDK 缓存，并且可以安装新的 SDK 缓存：
|
||||||
|
|
||||||
|
```shell
|
||||||
|
WARNING: SDKMAN is out-of-date and requires an update.
|
||||||
|
|
||||||
|
$ sdk update
|
||||||
|
Adding new candidates(s): kotlin
|
||||||
|
```
|
||||||
|
|
||||||
|
### Flush
|
||||||
|
|
||||||
|
应该很少需要刷新 SDKMAN！。flush命令有助于实现这一点，因此您不需要删除任何目录。
|
||||||
|
手动删除像 .sdkman/tmp 目录这样的目录会破坏 sdkman！请始终使用 flush 命令！
|
||||||
|
|
||||||
|
`$ sdk flush`
|
||||||
|
|
||||||
|
### Home
|
||||||
|
|
||||||
|
在脚本中使用 SDKMAN 时，获取SDK所在位置的绝对路径通常很有用（类似于 java_home 命令在 macOS 上的工作方式）。为此，我们拥有设置权限。
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ sdk home java 21.0.2-tem
|
||||||
|
/home/myuser/.sdkman/candidates/java/21.0.2-tem
|
||||||
|
```
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
|
||||||
|
可以在 ~/.sdkman/etc/config 文件中找到配置。要编辑配置，可以发出 sdk-config 命令在系统编辑器中编辑此文件。以下配置可用：
|
||||||
|
|
||||||
|
```conf
|
||||||
|
# make sdkman non-interactive, preferred for CI environments
|
||||||
|
sdkman_auto_answer=true|false
|
||||||
|
|
||||||
|
# check for newer versions and prompt for update
|
||||||
|
sdkman_selfupdate_feature=true|false
|
||||||
|
|
||||||
|
# disables SSL certificate verification
|
||||||
|
# https://github.com/sdkman/sdkman-cli/issues/327
|
||||||
|
# HERE BE DRAGONS....
|
||||||
|
sdkman_insecure_ssl=true|false
|
||||||
|
|
||||||
|
# configure curl timeouts
|
||||||
|
sdkman_curl_connect_timeout=5
|
||||||
|
sdkman_curl_continue=true
|
||||||
|
sdkman_curl_max_time=10
|
||||||
|
|
||||||
|
# subscribe to the beta channel
|
||||||
|
sdkman_beta_channel=true|false
|
||||||
|
|
||||||
|
# enable verbose debugging
|
||||||
|
sdkman_debug_mode=true|false
|
||||||
|
|
||||||
|
# enable colour mode
|
||||||
|
sdkman_colour_enable=true|false
|
||||||
|
|
||||||
|
# enable automatic env
|
||||||
|
sdkman_auto_env=true|false
|
||||||
|
|
||||||
|
# enable bash or zsh auto-completion
|
||||||
|
sdkman_auto_complete=true|false
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user