Composables CLI 发布！一站式创建与管理 Compose Multiplatform 项目

Composables 在 7 月 7 日发布了 Composables CLI 和 MCP server。

这个工具面向 Compose Multiplatform 项目，负责创建新项目、给现有 Gradle 工程加模块、在终端查 Composables UI 文档，以及给 Android Studio、Codex、Cursor 这类客户端安装 MCP。

安装命令

安装方式比较普通：

bash 复制代码

npm install -g composables-cli

安装后主命令叫 composables。CLI 文档里列了四个入口：init、add、docs、mcp。这几个命令分别对应新建项目、添加模块、查询文档、配置 MCP。

bash 复制代码

composables init
composables add module
composables docs search <query>
composables mcp install --client <client>

创建项目

composables init 会启动一个交互式 wizard，询问项目目录、包名、应用名和目标平台。它生成的是 Compose Multiplatform 项目，并把 Composables UI、Spotless 和基础 Gradle 配置一起放进去。

bash 复制代码

composables init

如果是给 Agent 使用，CLI 文档建议把参数一次传全，避免 Agent 卡在交互输入里。下面这条命令会在 my-app 目录创建项目，包名是 com.example.app，应用名是 My App，目标平台是 Android、JVM、iOS 和 Wasm。

bash 复制代码

composables init my-app \
  --package com.example.app \
  --app-name "My App" \
  --targets android,jvm,ios,wasm

--targets 只接受逗号分隔的 android,jvm,ios,wasm。如果只想先跑 Android 和桌面，命令可以收窄到：

bash 复制代码

composables init compose-demo \
  --package com.example.composedemo \
  --app-name "Compose Demo" \
  --targets android,jvm

添加模块

add 入口用在已有 Gradle 项目里。命令要从 Gradle 根目录执行：

bash 复制代码

composables add module

交互式 wizard 会询问模块路径、模块类型、包名、应用名和目标平台。非交互写法如下：

bash 复制代码

composables add module chatApp \
  --type app \
  --package com.example.chat \
  --app-name "Chat" \
  --targets android,jvm,ios,wasm

如果只是加一个 UI library，把 --type 改成 library，也不需要 --app-name：

bash 复制代码

composables add module chatUi \
  --type library \
  --package com.example.chat.ui \
  --targets android,jvm,ios,wasm

MCP 接入

MCP 文档里列的客户端比较多：android-studio、antigravity、claude、codex、cursor、firebender、opencode、zed。

Android Studio 的安装命令是：

bash 复制代码

composables mcp install --client android-studio

之后打开 Android Studio，进入 Settings > Tools > AI > MCP Servers，在 JSON View 里打开 Enable MCP Servers。这个入口对应的是 Gemini in Android Studio 的 MCP 配置。

Codex 的命令是：

bash 复制代码

composables mcp install --client codex

Claude、Cursor、OpenCode、Zed 也是同样形式：

bash 复制代码

composables mcp install --client claude
composables mcp install --client cursor
composables mcp install --client opencode
composables mcp install --client zed

MCP server 有两种用法。支持 streamable HTTP transport 的客户端可以直接配置这个 endpoint：

bash 复制代码

https://composables.com/mcp

如果客户端需要执行本地项目动作，比如创建项目或添加模块，就走 stdio：

bash 复制代码

composables mcp start

正常情况下不用手动跑 mcp start。composables mcp install 写完配置后，MCP 客户端会在需要时启动它。

依赖方式

新项目由 CLI 生成时，Composables UI 会直接接好。已有项目里手动接入，安装文档给了两种方式。

第一种是直接加完整 UI 依赖：

bash 复制代码

implementation("com.composables:ui:0.2.0")

第二种是复制组件源码时，只加它们依赖的基础库：

bash 复制代码

implementation("com.composables:composeunstyled:2.7.0")
implementation("com.composables:compose-interaction-capabilities:1.1.0")

这两种方式对项目管理的影响不一样。直接依赖 com.composables:ui，升级时跟着库版本走；复制组件源码，代码会进自己的仓库，后续修改和冲突要自己处理。

Android 项目里我更倾向先用 Gradle dependency。等某个组件确实需要改内部行为，再考虑复制源码。比如只想调一个 Button 的视觉 token，用主题解决；如果要改焦点、键盘行为、语义树这类内部逻辑，复制源码才有意义。

最后

Composables CLI 主要解决四件事：init 建 Compose Multiplatform 项目，add module 给 Gradle 工程加模块，docs 在终端查 Composables UI 文档，mcp install 给 Agent 接入同一份文档。

#Android #JetpackCompose #ComposeMultiplatform #MCP