ApiHug REPL

ApiHug REPL 是面向终端的统一入口，用来发现模块、安装工作流和执行命令式操作。

它是什么

REPL 提供：

• ApiHug 工具的命令交互壳
• 感知多模块项目的导航能力
• BMAD 的安装与更新命令
• 适合终端与脚本场景的统一操作面

为什么重要

并不是每个团队都希望只在 IDE 内工作。REPL 让 ApiHug 工具链拥有一套稳定、可脚本化的终端界面。

它如何融入整体流程

1. 启用插件

在 gradle/libs.versions.toml 中加入 REPL 插件：

[versions]
apihugVersion = "2.0.2-RELEASE"

[plugins]
hope-repl = { id = "com.apihug.repl", version.ref = "apihugVersion" }

然后在 build.gradle 中启用：

plugins {
  alias(libs.plugins.hope.repl)
}

2. 初始化 REPL

./gradlew :hope

执行后会生成 apihug 和 apihug.bat 启动脚本。

3. 开始使用

最常见的入门命令：

help
ls
cd --module-name demo-app-proto
pwd

故障排查

执行 :hope 时出现 “Cannot resolve external dependency”

老项目往往缺少根 build.gradle 的仓库声明。补上之后再重试：

repositories {
  mavenLocal()
  mavenCentral()
  maven { url "https://repo.spring.io/libs-release" }
  maven { url "https://repo.spring.io/milestone" }
}

下一步

1. 用 REPL 安装 ApiHug BMAD
2. 回到 工具链 查看其他生成命令