jvm-manager-cli 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to npm Registry
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+    paths:
+      - 'bin/**'
+      - 'test/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'README.md'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org/'
+          
+      - name: Install dependencies
+        run: npm install
+        
+      - name: Build package
+        run: npm run build
+        
+      - name: Publish to npm (on tag)
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [year] [fullname]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,224 @@
+# jvm-manager
+
+jvm-manager 是一个用于在 Linux 系统上管理 Java 开发工具包 (JDK) 的命令行工具。它提供了简单的接口来安装、链接、切换和管理不同版本的 Java。
+
+## 功能特性
+
+- **安装 JDK**：从系统依赖库安装（支持 Ubuntu/Debian、Fedora/CentOS/RHEL、Arch Linux）或从 Oracle 官方下载
+- **链接系统 JDK**：链接系统已安装的 JDK 到 jvm-manager 管理的目录
+- **切换 JDK 版本**：在全局和项目级别切换不同版本的 Java
+- **列出已安装 JDK**：显示所有已安装的 JDK 版本，包括系统 JDK
+- **管理环境变量**：生成可用于设置 Java 环境变量的命令
+- **系统兼容性检查**：检查系统是否满足运行 Java 的要求
+
+## 快速开始
+
+### 安装 jvm-manager
+
+```bash
+npm install -g jvm-manager-cli
+```
+
+### 使用
+
+#### 1. 查看帮助
+
+```bash
+jvm help
+```
+
+#### 2. 安装 JDK
+
+```bash
+jvm install 17
+```
+
+#### 3. 列出所有已安装的 JDK 版本
+
+```bash
+jvm list
+```
+
+#### 4. 切换全局默认 JDK
+
+```bash
+jvm use 17 --global
+```
+
+#### 5. 在项目中使用特定版本的 JDK
+
+```bash
+jvm use 11 --project
+```
+
+#### 6. 设置 Java 环境变量
+
+```bash
+eval "$(jvm env --global)"
+java -version
+```
+
+#### 7. 检查系统兼容性
+
+```bash
+jvm doctor
+```
+
+## 命令说明
+
+### install
+
+安装指定版本的 JDK。支持系统依赖库安装（apt、yum、pacman）和 Oracle 官方下载。
+
+```bash
+jvm install <version>
+```
+
+**参数：**
+- `<version>`：Java 版本号（如 8、11、17、21 等）
+
+### list
+
+列出所有已安装的 JDK 版本，包括系统 JDK。
+
+```bash
+jvm list
+```
+
+### use
+
+切换到指定版本的 JDK。支持全局和项目级别。
+
+```bash
+jvm use <version> [--global|--project]
+```
+
+**参数：**
+- `<version>`：Java 版本号（如 8、11、17、21 等）
+- `--global`（可选）：将指定版本设置为全局默认（默认）
+- `--project`（可选）：将指定版本设置为项目默认，创建或更新 `.jvmrc` 文件
+
+### env
+
+生成可用于设置 Java 环境变量的命令。支持全局和项目级别。
+
+```bash
+jvm env [--global|--project]
+```
+
+**参数：**
+- `--global`（可选）：生成全局 Java 环境变量设置命令（默认）
+- `--project`（可选）：生成项目 Java 环境变量设置命令
+
+### current
+
+显示当前全局和项目级别的 Java 版本。
+
+```bash
+jvm current
+```
+
+### remove
+
+移除指定版本的 JDK。
+
+```bash
+jvm remove <version>
+```
+
+**参数：**
+- `<version>`：Java 版本号（如 8、11、17、21 等）
+
+### link
+
+链接系统已安装的 JDK 到 jvm-manager 管理的目录。
+
+```bash
+jvm link <system-path> <version>
+```
+
+**参数：**
+- `<system-path>`：系统上已安装的 Java 路径（如 `/usr/lib/jvm/java-17-openjdk-amd64`）
+- `<version>`：Java 版本号（如 17）
+
+### doctor
+
+检查系统是否满足运行 Java 的要求，包括 Node.js 版本、架构、操作系统平台和所需的工具。
+
+```bash
+jvm doctor
+```
+
+## 项目级配置
+
+在项目根目录创建一个名为 `.jvmrc` 的文件，其中包含所需的 Java 版本号，即可实现项目级别的 Java 版本管理。
+
+```bash
+# 在项目根目录创建 .jvmrc 文件
+jvm use 11 --project
+```
+
+## 系统兼容性
+
+jvm-manager 支持以下操作系统：
+- Ubuntu/Debian
+- Fedora/CentOS/RHEL
+- Arch Linux
+- 其他 Linux 发行版（会尝试使用 Oracle 官方下载）
+
+## 环境要求
+
+- Node.js 14 或更高版本
+- 具有执行 `sudo` 命令的权限（用于系统依赖库安装）
+
+## 常见问题
+
+### 1. 安装失败
+
+如果在使用系统依赖库安装时遇到问题，请尝试手动运行以下命令更新包管理器：
+
+```bash
+# Ubuntu/Debian
+sudo apt update
+```
+
+### 2. 权限问题
+
+如果遇到权限问题，请确保您有执行 `sudo` 命令的权限，并在需要时输入密码。
+
+### 3. 无法找到 JDK
+
+如果系统上已安装 Java，但 jvm-manager 无法找到，请尝试使用 `jvm link` 命令手动链接：
+
+```bash
+jvm link /usr/lib/jvm/java-17-openjdk-amd64 17
+```
+
+## 故障排除
+
+如果您遇到任何问题，请尝试使用 `jvm doctor` 命令检查系统兼容性，或使用 `--help` 查看特定命令的帮助信息。
+
+## 开发
+
+### 本地开发
+
+```bash
+git clone https://github.com/your-username/jvm-manager.git
+cd jvm-manager
+npm install
+npm link
+```
+
+### 运行测试
+
+```bash
+npm test
+```
+
+## 贡献
+
+欢迎提交问题和拉取请求。对于重大更改，请先创建一个问题来讨论您想要更改的内容。
+
+## 许可证
+
+MIT License