在Ubuntu上安裝Swagger(現在通常指的是OpenAPI Generator或Swagger UI)可以通過幾個步驟來完成。以下是使用OpenAPI Generator來安裝Swagger的步驟:
更新系統包列表: 打開終端,運行以下命令來更新你的包列表:
sudo apt update
安裝必要的依賴: 安裝Java和Maven,因為OpenAPI Generator需要它們來生成代碼。
sudo apt install openjdk-11-jdk maven
下載OpenAPI Generator:
你可以從OpenAPI Generator的GitHub頁面下載最新版本的jar文件。使用wget
或curl
命令來下載:
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.2.1/openapi-generator-cli-5.2.1.jar
請注意,上面的URL是示例,你應該訪問OpenAPI Generator Releases頁面來獲取最新版本的下載鏈接。
使jar文件可執行:
使用chmod
命令來使下載的jar文件可執行:
chmod +x openapi-generator-cli-5.2.1.jar
使用OpenAPI Generator生成代碼:
現在你可以使用OpenAPI Generator來生成你的API客戶端代碼。你需要一個OpenAPI規范文件(通常是.yaml
或.json
格式)。例如:
java -jar openapi-generator-cli-5.2.1.jar generate -i /path/to/your/api-spec.yaml -g java -o /path/to/output/directory
這將生成Java客戶端代碼到你指定的輸出目錄。
集成Swagger UI: 如果你想在你的應用程序中集成Swagger UI,你可以使用OpenAPI Generator來生成Swagger UI的靜態文件。例如:
java -jar openapi-generator-cli-5.2.1.jar generate -i /path/to/your/api-spec.yaml -g swagger-ui -o /path/to/output/directory
這將在指定的輸出目錄中生成Swagger UI的靜態文件,你可以將這些文件部署到任何靜態文件服務器上。
請確保替換上述命令中的路徑和版本號為你實際使用的值。如果你想要安裝特定版本的OpenAPI Generator,你應該訪問GitHub頁面并下載相應版本的jar文件。