Closed
[Feature] 增加 macOS 平台构建支持与 CI 覆盖,补齐跨平台能力短板 #33
changyucongAdd on  Jun 16Closed at  20 days ago
changyucong
changyucong
Jun 16 Create

Paired: GitHub #123 ↔ GitCode #33

背景

MCP C++ SDK 和 A2A C++ SDK 的构建文档均声明以 Linux 为主要验证平台。A2A SDK 文档虽然补充了 macOS 下 Homebrew 的依赖安装命令(brew install cmake pkg-config openssl libcurl libevent nlohmann-json),但实际从 CI 和源码层面缺乏 macOS 平台验证。

当前存在的问题:

  1. 仓库根目录和 SDK 子目录均未发现 .github/workflows/ 等 CI 配置
  2. 无 macOS 构建矩阵(macos-latest 或 macos-13)
  3. 部分依赖在 macOS 上的路径和链接方式与 Linux 不同(如 OpenSSL 需要通过 -DOPENSSL_ROOT_DIR 指定路径)
  4. 动态库的命名和后缀不同(.so vs .dylib),可能导致示例运行脚本在 macOS 上失效

建议方案

  1. CMake 层面兼容:
    • 在根 CMakeLists.txt 中增加 macOS 平台检测,自动设置 OpenSSL 查找路径
    • 确保 liba2a.so / libmcp.so 在 macOS 上正确输出为 .dylib 格式
  2. CI 增加 macOS 构建矩阵:
    • 在 GitHub Actions 或对应 CI 中添加 macos-latest 构建 Job
    • 验证编译、链接和示例运行
  3. 文档更新:
    • 在 README 中明确列出已验证的 macOS 版本(如 macOS 14 Sonoma)
    • 补充 macOS 特有问题的 Troubleshooting 章节

预期收益

  • 覆盖广大的 macOS 开发者群体(特别是在 AI/ML 领域 macOS 用户占比很高)
  • 补齐跨平台能力,使 SDK 在 Linux/macOS 双平台均可信赖
  • 降低 Mac 用户在集成 agent-protocol SDK 时遇到的编译障碍
  • 提升项目专业度和用户信心
likedislike
OopenJiuwen-botCollaborators
Jun 16 Added label: sig/sig-agent-protocol
openJiuwen-botCollaborators
Jun 16 Comments:

欢迎来到 openJiuwen 社区

Hey @cycong_1 , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .

likedislike
maoqimingmaoqimingCollaborators
Oct 9 Assign gcw_3GcDk5mt as responsible person
Oopenjiuwen-syncCollaborators
Oct 9 Modify description of issue
Zzhuyutong888Collaborators
28 days ago Associated pull request
Zzhuyutong888Collaborators
28 days ago Associated pull request
OopenJiuwen-botCollaborators
20 days ago Close issue