# pony_kit

**Repository Path**: icanpool/pony_kit

## Basic Information

- **Project Name**: pony_kit
- **Description**: development kit of pony platforms
- **Primary Language**: C
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-16
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 前言

pony_kit 是一款针对嵌入式平台的开发套件，用于开发嵌入式后台应用（相对于前台 UI 应用）。

pony_kit 参考 systemd 的服务管理概念，开发了服务（svc）和服务管理组件。
- 后台应用在嵌入式中通常以服务（任务或线程）的形式存在

pony_kit 在消息队列（MQ）基础上开发了发布/订阅组件（SQ）。
- 服务之前可以通过发布和订阅的方式来实现通信

# 目录结构
|一级目录|二级目录|说明|
|:---|:---|:---|
|config||平台配置文件|
|samples||示例|
|src||源代码|
||drivers|设备/驱动抽象层|
||init|初始化模块|
||misc|发布/订阅、日志等杂项|
||os|操作系统适配层|
||stdlib|标准库|
||svc|服务和服务管理|
||utils|双链表、环形缓冲区等通用模块|
|template||文件模板|
|tests||测试|
||gtest|Linux 平台测试|
||qtest|Qt 平台测试|

# 快速开始

## 下载代码
```bash
git clone https://gitee.com/icanpool/pony_kit.git
```

## Linux 平台

pony_kit 支持 Linux 平台，主要是为了基于 gtest 测试框架快速测试和验证功能。

```shell
# 安装
sudo apt-get install -y libgtest-dev

# 编译
cd pony_kit
mkdir build && cd build
cmake ..
make -jN

# 全量测试
./bin/PonyKit_test

# 测试某个用例，使用参数 --gtest_filter 来指定测试用例
./bin/PonyKit_test --gtest_filter=TestLog.demo
```
![](./docs/images/linux_gtest.png)

## Qt 平台

pony_kit 支持 Qt 平台，主要是为了开发前后台项目时，在 Qt 平台上做 UI 模拟。


## RTOS 平台

pony_kit 已经支持如下嵌入式 RTOS 平台：
- sifli@rt-thread
    - 作为思澈平台的 [external](https://gitee.com/icanpool/pony_sf/blob/master/pony/west.yml)
- zephyr
    - 作为 zephyr 的 [module](./zephyr/module.yml)
- ……

# 案例

## [pony_watchx](https://gitee.com/icanpool/pony_watchx)

![](./docs/images/case_pony_watchx.png)

# 规范
- 代码 git 提交格式：[git 知：提交格式](https://blog.csdn.net/canpool/article/details/126005367)
- 代码 style 规范 [.clang-format](./.clang-format)

# 贡献
- 欢迎提交 issue 对关心的问题发起讨论
- 欢迎 Fork 仓库，pull request 贡献

# 后语
加油，我们！