【免费下载链接】openframe-oss-libShared libraries between all services项目地址https://gitcode.com/gh_mirrors/op/openframe-oss-lib点击查看免费下载想动手开发OpenFrame OSS Lib却被 JDK 21、Maven 多模块、Docker 集成测试和 Node.js 前端劝退别急这份开发环境搭建指南带你从零配置好全部工具链5 分钟完成首次构建一次通过不再折腾。OpenFrame OSS Lib 是一个多语言 monorepo包含 Java/Spring Boot 后端模块、Rust Agent 客户端以及 TypeScript/React 前端组件库。下面按步骤走一遍你就能把整个开发环境一步到位。官方权威文档docs/getting-started/prerequisites.md 列出了完整的软硬件版本要求本文内容与其保持一致。 技术栈速览你需要装什么在动手前先看清楚各工具的职责避免装错版本工具最低版本用途JDK21Java 后端模块Spring BootMaven3.9构建与依赖管理Node.js18前端 openframe-frontend-corenpm9前端包管理Rust (cargo)Stable 最新Rust Agent 客户端Docker24测试基础设施MongoDB、NATSDocker Compose2.x测试环境编排Git2.x源码管理硬件建议内存 8GB推荐 16GB、4 核 CPU推荐 8 核、10GB 可用磁盘。Windows 用户强烈推荐WSL2Rust Agent 在 WSL2 下体验最佳。 第一步安装 JDK 21 与 MavenJava 后端必备Java 模块是仓库的主体JDK 21 是硬门槛。安装后运行验证命令java -version # 期望输出openjdk version 21.x.x mvn -version # 期望输出Apache Maven 3.9.x⚠️版本要点父 POM 通过java.version统一强制 Java 版本务必安装 JDK 21或更高过低版本会导致编译失败。 第二步配置 Node.js 与 npm前端组件库前端库 openframe-frontend-core 是一个 React/TypeScript 组件库需要 Node.js 18node --version # 期望输出v18.x.x 或 v20.x.x npm --version # 期望输出9.x.x 或更高 第三步安装 Rust 工具链Agent 客户端clients/openframe-client 是 Rust 编写的设备 Agent。使用rustup安装curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh rustc --version # 期望输出rustc 1.7x.x (stable) cargo --version # 期望输出cargo 1.7x.x (stable) 第四步启动 Docker 与 Docker Compose集成测试多个测试套件依赖Testcontainers自动拉起 MongoDB、NATS、Redis 实例所以Docker 必须处于运行状态docker --version # 期望输出Docker version 24.x.x docker compose version # 期望输出Docker Compose version v2.x.xMongoDB 集成测试的编排文件位于 openframe-data-mongo-sync/src/test/docker/docker-compose.yml其中将容器端口映射到27027并内置健康检查。 克隆仓库并完成首次构建环境就绪后克隆代码并执行最快的首次构建跳过测试git clone https://gitcode.com/gh_mirrors/op/openframe-oss-lib cd openframe-oss-lib # 构建全部模块跳过测试速度最快 mvn clean install -DskipTests构建成功后所有模块的.jar会被安装到本地 Maven 仓库~/.m2并附带-sources.jar。想跑完整测试需要 Docker直接去掉-DskipTests即可。单模块构建技巧日常开发无需重建整个仓库。用-pl指定模块、-am联编依赖mvn clean install -pl openframe-data-mongo-common -am -DskipTests 推荐 IDE 配置IntelliJ 与 VS Code场景推荐 IDE关键配置Java / Maven 模块IntelliJ IDEA安装Lombok插件 开启注解处理前端 RustVS Code安装rust-analyzer、ESLint、Prettier扩展IntelliJ 用户注意打开根 pom.xml 作为 Maven 项目并务必在Settings → Build → Annotation Processors中开启注解处理Lombok 依赖它工作。 环境变量与 Maven 私有仓库鉴权若需拉取已发布的构件需为 Maven 配置鉴权信息编辑~/.m2/settings.xml并设置环境变量变量说明GITHUB_TOKENMaven 包仓库的访问 TokenGITHUB_USERNAME对应账户用户名SPRING_PROFILES_ACTIVE激活的 Spring Profile如local⚠️安全提醒切勿把密钥、API Key 提交到版本库。✅ 一键验证清单确认环境就绪把下面这段跑一遍全部返回正常版本即大功告成java -version mvn -version node --version rustc --version docker info git --version❓ 常见问题速查构建报 Java 版本错误→ 确认java -version是 21检查 IDE 的 Project SDK 是否选对。Lombok 代码无法解析→ IntelliJ 未安装 Lombok 插件或未开启注解处理。集成测试起不来→ Docker 没开。先启动 Docker Desktop /systemctl start docker再跑mvn verify。想只改一个模块→ 用mvn ... -pl 模块名 -am联编别全量重建。配置完成你已具备开发 OpenFrame OSS Lib 的完整环境。接着可以阅读 docs/getting-started/quick-start.md 深入模块结构或参考 CONTRIBUTING.md 了解代码规范与贡献流程。赞分享【免费下载链接】openframe-oss-libShared libraries between all services项目地址https://gitcode.com/gh_mirrors/op/openframe-oss-lib点击查看免费下载相关推荐RuoYi环境搭建JDKMaven配置RuoYi环境搭建JDKMaven配置 前言 还在为Java项目环境配置而烦恼面对复杂的依赖管理和版本兼容问题束手无策本文将为你详细解析RuoYi权限管后端企业应用认证鉴权代码生成Open-Source-Prompt-Libraryv0.dev视觉生成提示的完整教程Open Source Prompt Libraryv0.dev视觉生成提示的完整教程 想要快速将你的产品想法转化为精美的前端界面吗Open SourceOpslane部署指南从开发到生产的完整流程Opslane部署指南从开发到生产的完整流程 Opslane是一款革命性的桌面应用程序专为开发人员设计用于并行管理多个Claude Code会话。这个强大创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考