Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for zhuyutong888's contribution.)变更摘要
本 PR 为 A2A C++ SDK 引入 macOS 平台支持(基于 libevent 事件循环),核心是新增 platform_compat.h 平台兼容层,将原先 Linux 专属的系统调用(syscall(SYS_gettid)、eventfd、TCP_KEEPIDLE、pthread_setname_np 单参形式等)统一封装并按平台分支实现。EventSystem 的 notifyChannel 从裸 eventfd 重构为跨平台的 Platform::NotifyChannel(Linux 用 eventfd,其它平台用非阻塞管道加软件计数器),A2ATimer 则彻底放弃自建 epoll 循环,改为复用 A2A::EventSystem 的定时器能力。构建与运行脚本同步适配 macOS 的依赖安装、动态库路径、超时命令与 ASAN 差异。
主要改动
-
新增平台兼容层
platform_compat.h: 提供GetThreadId、SetCurrentThreadName、SetKeepAliveIdle/Intvl/Cnt以及跨平台通知通道NotifyChannel(CreateNotifyChannel/NotifyChannelNotify/NotifyChannelRead/CloseNotifyChannel/ReadChannelFdRaw),在__linux__、__APPLE__等分支下分别使用eventfd/syscall与pipe+软件计数器实现。 -
EventSystem通知机制重构:CreateNotifyEventId改用Platform::CreateNotifyChannel,NotifyEventId/ReadEventFd/析构及RemoveEventInternal改为通过NotifyChannel读写与释放 fd,并在EventData中新增notifyChannel字段;mutex_改为mutable std::mutex以支持ReadEventFd中的加锁查找。 -
A2ATimer改用EventSystem驱动: 移除自建的epoll/eventfd循环(Init、RunLoop、GetNextTimeout、HandleExpired被删除),TimerTask以eventId替代过期时间点,AddTimer/RefreshTimer/CancelTimer通过EventSystem::AddTimer/RemoveEvent调度,并新增EnsureStarted、OnTimerFired、OnKeepAlive及keepAliveEventId_维持事件循环存活。 -
日志与线程工具接入兼容层:
a2a_log.h移除sys/syscall.h,改为通过新增的GetCurrentThreadId()调用Platform::GetThreadId();thread_utils.h的SetCurrentThreadName委托给Platform::SetCurrentThreadName,从而兼容 macOS 的pthread_setname_np单参签名。 -
脚本与测试适配 macOS:
install_deps.sh增加 Darwin 平台识别与 Homebrew 依赖检查/安装流程,run_example.sh/run_ut.sh区分DYLD_LIBRARY_PATH/LD_LIBRARY_PATH并用gtimeout兜底、跳过 macOS 上的 ASAN 预加载;UT 中eventfd相关用例加__linux__条件编译,改用fcntl设置非阻塞并调整SO_REUSEPORT与EventSystem线程模式断言。


Paired: GitHub #147 ↔ GitCode !351
What type of PR is this?
/kind feature
Self-checklist:(请自检,在[ ]内打上x,我们将检视你的完成情况,否则会导致pr无法合入)
Linked Closing Issues:
https://gitcode.com/openJiuwen/agent-protocol/issues/33
Linked Closing Issues: