---
url: /index.md
description: >-
  TinyPiXOS——国产自主轻量级移动嵌入式设备桌面操作系统。采用自研图形协议栈替代X11/Wayland，具备轻量灵活、自主可控、异构兼容等核心优势。提供从内核到应用的完整技术栈，免费商用并配套开发者社区，助力构建自主嵌入式生态。
---
# 
## 关注我们

### 项目地址

### 扫描二维码或者点击链接访问

::: tip 全网搜索“TinyPiXOS 开发者联盟”获取更多信息
:::

::: flex center



:::

---

---
url: /changelog/index.md
---
# 更新日志
## V 0.2.1 更新日志

### ✨ 功能新增

* 🔧 `TpWM` 新增屏幕抓图接口
* 🔧 `TpGUI` 新增与桌面通信实现；支持应用与桌面状态栏的交互
* 🔧 `TpGUI` 新增TpDialog的模态显示
* 🔧 `TpUtils` TpColors接口优化，新增单独设置/获取RGBA接口

### 🛠️ 行为变更

* ⚙️ `TpGUI` 调整TpMainWindow接口；移除无需使用的接口
* ⚙️ `TpGUI` 移除TpApp的bingVScrenn接口，应用目前无需手动绑定主窗口
* ⚙️ `TpGUI` 优化TpBattery显示效果
* ⚙️ `TpGUI` 调整TpWidget->setAlpha接口为setWindowOpacity，支持TpWidget设置窗体透明度接口

### 🛠️ 问题修复

* 🐛 `TpWM` 修复获取应用截图偶尔获取失败问题
* 🐛 `TpGUI` 修复TpMessageBox显示错误问题
* 🐛 `TpGUI` 修复组件设置border-color未响应问题
* 🐛 `TpUtils` 修复TpGateway偶尔出现接收主题解析错误问题
* 🐛 `TpUtils` 修复TpGateway偶发性收不到订阅数据问题
* 🐛 `TpUtils` 修复TpRadialGradient数据拷贝导致崩溃问题

## V 0.2.0 更新日志

### ✨ 功能新增

* 🔧 `TpGUI` 新增线性渐变、径向渐变、窗体背景模糊特效
* 🔧 `TpGUI` CSS新增线性渐变语法支持
* 🔧 `TpGUI` 新增温湿度显示、天气显示、环形统计图、音乐面板等UI组件
* 🔧 `TpGUI` 新增绘制多边形镂空形状
* 🔧 `TpGUI` 新增组件抓图功能
* 🔧 `TpGUI` 新增lottie动画加载支持
* 🔧 `TpUtils` 新增TpPen和TpBrush对于画笔、画刷属性修改支持
* 🔧 `TpUtils` 新增TpImage支持对图片处理相关功能
* 🔧 `TpUtils` 新增TpPainterPath支持绘制自定义形状

### 🛠️ 行为变更

* ⚙️ `TpGUI` 重构底层绘图引擎
* ⚙️ `TpGUI` 重构绘图相关接口；统一规范，使用TpPen和TpBrush控制绘制效果
* ⚙️ `TpGUI` TpSlider、TpButton等组件功能优化
* ⚙️ `TpUtils` TpUuid、TpMD5、TpConfig等工具类优化
* ⚙️ 生成库优化，TpWM提供TpWM可执行程序和libTpWMEngine.so；libTpGUI.so、libTpUtils.so、libTpExtUtils.so
* ⚙️ 使用 TpWM V0.2.0 新接口及移除废弃接口
* ⚙️ 移除boost库依赖
* ⚙️ 使用大驼峰命名类名和文件名
* ⚙️ 添加依赖库一键构建脚本支持

### 🛠️ 问题修复

* 🐛 `TpUtils` 修复信号槽接收对象释放导致异常崩溃问题
* 🐛 `TpUtils` 修复TpVariant异常崩溃问题
* 🐛 `TpUtils` 修复TpVariant无法加载TpString数据问题
* 🐛 `TpWM` 修复在shareone模式下多进程写入共享内存序列优化
* 🐛 `TpWM` 修复tinyPiX\_sys\_find\_win\_main\_id\_bypid、tinyPiX\_sys\_find\_win\_pid\_byid等sysApi接口无法正确捕获桌面id的bug
* 🐛 `TpWM` 修复在shareone禁止或启用时，无法获取应用全图的bug
* 🐛 `TpWM` 修正float叠加时坐标重定位的bug，解决float窗体叠加显示错位的问题

## V 0.1.1 更新日志

**兼容性说明**\
⛔ 不兼容 TpWM V0.1.0\
✅ 兼容 TpWM V0.1.1

### TinyPiXCore

**✨ 功能新增**\
🔧 新增信号槽支持连接模式配置（自动/直连/队列）\
🔧 新增线程池工具类（tpThreadPool）\
🔧 tpHash、tpMap添加values、keys方法获取所有键值或属性\
🔧 新增tpRadioButtonGroup单选按钮组，组内按钮只可选中一个\
🔧 新增交叉编译构建支持

**🛠️ 问题修复**\
🐛 修复 tpSlider 无法停止拖动的问题\
🐛 解决警告消息框偶发崩溃缺陷

**🛠️ 行为变更**\
⚙️ 优化tpRadioButton内部实现流程\
⚙️ 使用 TpWM V0.1.1 新接口及移除废弃接口

### TinyPiXApp

**✨ 功能新增**\
🔧 新增交叉编译构建支持

**🛠️ 行为变更**\
⚙️ 统一使用新版信号槽连接方式\
⚙️ 桌面启动应用后隐藏topBar组件\
⚙️ 使用 TpWM V0.1.1 新接口及移除废弃接口

## V 0.1.0 更新日志

### TinyPiXApp

* ✅ 具备桌面程序应用
* ✅ 具备文件管理器应用
* ✅ 具备媒体播放器
* ✅ 具备系统设置应用
* ✅ 具备部分组件演示应用（滑块条、标签、按钮、复选框等演示应用）

### TinyPiXCore

* ✅ 支持各类基础GUI组件；包括标签、按钮、输入框、复选框等
* ✅ 具备GUI框架库（包括事件分发、事件过滤器、对象生命周期管理等）
* ✅ 支持信号槽功能
* ✅ 支持基础数据结构封装接口；包括tpVector、tpHash、tpString等
* ✅ 支持Json数据解析
* ✅ 支持便捷的Json或二进制Buffer数据序列化与反序列化
* ✅ 支持定时器
* ✅ 支持部分常用CSS语法自定义UI样式
* ✅ 支持网络通信；包括UDP通信、TCP通信、便捷的发布-订阅式通信
* ✅ 支持快速压缩解压缩算法
* ✅ 支持系统信息访问；包括系统信息、主板信息、CPU信息、内存信息等
* ✅ 支持存储设备。包括磁盘读取。磁盘自动挂载/卸载等
* ✅ 支持蓝牙设备；包括蓝牙管理、蓝牙扫描、蓝牙配对连接、文件传输、音频播放等
* ✅ 支持多媒体设备；包括音视频解码、音视频播放、音量控制、倍速控制、进度控制。
* ✅ 支持电源设备；包括电源信息、关机/重启等
* ✅ 支持以太网设备；包括网卡配置、DNS配置、DHCP配置
* ✅ 支持无线网络设备：网络扫描、网络连接、网络监测

### TpWM

* ✅ 支持多窗口层叠、平铺、最小化
* ✅ 支持多任务管理
* ✅ 独立于传统的X11和Wayland协议，独创地采用了SPI（‌Streamlined Protocol Interface）思想提供精简的Api开发接口

---

---
url: /compatible/index.md
---
# 兼容适配清单
## 树莓派系列

![raspberrypi](https://file.tinypixos.com/tinypixos/raspberrypi-logo_repeat_1752025635655__248639.svg)

### 镜像列表

\<template #badge>


在树莓派4B进行验证

---

---
url: /components/overview/index.md
description: >-
  TinyPiXOS组件库总览：完整列出TpGUI框架提供的所有UI组件，包括各类按钮（TpButton、TpCheckBox等）、布局容器（TpFlexLayout）、进度指示器（TpProgressBar）、输入控件（TpLineEdit）及专用组件（TpBattery）。为嵌入式GUI开发提供丰富的现成组件参考。
---
# 总览
## Overview 组件总览

::: tip 以下是TinyPiXOS系统提供的默认组件。
:::

## 按钮组件

## 布局组件

## 交互窗口组件

## 进度条组件

## 容器组件

## 文本/显示组件

---

---
url: /components/TpBattery/index.md
---
# 电量显示 TpBattery
## 介绍

## 使用示例

```cpp
tpBattery *battertWidget = new TpBattery(vScreen);
battertWidget->setValue(50);
battertWidget->setWidth(600);
battertWidget->setHeight(400);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpBattery.png)

---

---
url: /components/TpButton/index.md
---
# 按钮 TpButton
## 介绍

## 使用示例

```cpp
tpButton * testButton = new TpButton("测试按钮", this);

// 调整按钮样式类型
testButton->setProperty("type", "FunctionButton");

testButton->setSize(300, 70);
testButton->move(500, 150);
connect(testButton, onClicked, [=](bool)
{  
    std::cout << "按钮被点击" << std::endl;
});
```

## 效果演示

* 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-默认态.png)

* 默认悬停态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-悬停态.png)

* ControlPanelPowerButton 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-ControlPanelPowerButton-默认态.png)

* ControlPanelPowerButton 悬停状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-ControlPanelPowerButton-悬停态.png)

* VirtualKeyboardButton 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-VirtualKeyboardButton-默认态.png)

* VirtualKeyboardButton 按下状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-VirtualKeyboardButton-按下态.png)

* VirtualKeyboardApplyButton 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-VirtualKeyboardApplyButton-默认态.png)

* VirtualKeyboardApplyButton 按下状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-VirtualKeyboardApplyButton-按下态.png)

* FunctionButton 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-FunctionButton-默认态.png)

* FunctionButton 悬停状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpButton-FunctionButton-悬停态.png)

---

---
url: /components/TpCarouselButton/index.md
---
# 轮播按钮 TpCarouselButton
## 介绍

## 使用示例

```cpp
tpCarouselButton* carouselButton = new TpCarouselButton(this);
carouselButton->setCount(3);
```

## 效果演示

* 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpCarouselButton-默认态.png)

---

---
url: /components/TpCheckBox/index.md
---
# 选项按钮 TpCheckBox
## 介绍

## 使用示例

```cpp
tpCheckBox *checkBox1 = new TpCheckBox(vScreen);
checkBox1->setText("123");
```

## 效果演示

* 未选中\
  ![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpCheckBox未选中演示.png)

* 选中\
  ![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpCheckBox选中演示_repeat_1751615580668_414676.png)

---

---
url: /components/TpCollapsibleFileWidget/index.md
---
# 可折叠文件展示窗口 TpCollapsibleFileWidget
## 介绍

## 使用示例

```cpp
```

## 效果演示

---

---
url: /components/TpComBox/index.md
---
# 下拉列表 TpComBox
## 介绍

## 使用示例

```cpp
tpComBox* listCombox = new TpComBox(vScreen);
listCombox->setTitle("视图模式");
listCombox->addItem("测试1");
listCombox->addItem("测试2");
listCombox->addItem("测试3");
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpComBox.png)

---

---
url: /components/TpFilePathWidget/index.md
---
# 路径选择器 TpFilePathWidget
## 介绍

## 使用示例

```cpp
tpFilePathWidget* filePathWidget_ = new TpFilePathWidget();
filePathWidget_->setPath("/System/Data");
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpFilePathWidget.png)

---

---
url: /components/TpFlexLayout/index.md
---
# 响应式布局 TpFlexLayout
## 介绍

响应式布局是一个参考==CSS Flexbox==模型实现的动态布局容器，支持：

* ​**​自动换行**​​：内容溢出时自动折行并保持对齐
* ​**​间距控制**​​：通过gap属性统一管理元素间隔
* ​**​对齐策略**​​：内置12种主轴/交叉轴对齐组合
* **​弹性分配**​：子元素按比例自动填充可用空间

适用于需要动态适应不同屏幕尺寸的界面布局场景，如移动端列表、仪表盘控件组等。

## 使用示例

```cpp
tpFlexLayout *flexLayout = new TpFlexLayout();

/// @brief 设置布局方向
flexLayout->setFlexDirection(TpFlexLayout::Row);
// flexLayout->setFlexDirection(TpFlexLayout::RowReverse);
// flexLayout->setFlexDirection(TpFlexLayout::Column);
// flexLayout->setFlexDirection(TpFlexLayout::ColumnReverse);

/// @brief 设置主轴对齐方式
// flexLayout->setJustifyContent(TpFlexLayout::MainFlexStart);   // 默认, 从主轴 开始位置 开始
// flexLayout->setJustifyContent(TpFlexLayout::MainFlexEnd);      // 从主轴 结束位置 开始
// flexLayout->setJustifyContent(TpFlexLayout::MainCenter);       // 居中对齐
flexLayout->setJustifyContent(TpFlexLayout::MainSpaceBetween); // 两端对齐,两边贴着
// flexLayout->setJustifyContent(TpFlexLayout::MainSpaceEvenly);  // 分散对齐,间距相同
// flexLayout->setJustifyContent(TpFlexLayout::MainSpaceAround);   // 分散对齐,两边是中间的一半

/// @brief 设置交叉轴对齐方式
// flexLayout->setAlignItems(TpFlexLayout::CrossFlexStart); // 顶部对齐
flexLayout->setAlignItems(TpFlexLayout::CrossFlexEnd);   // 底部对齐
// flexLayout->setAlignItems(TpFlexLayout::CrossCenter);     // 居中对齐

/// @brief 设置多行交叉轴对齐方式，注意设置后会覆盖交叉轴对齐样式
// flexLayout->setAlignContent(TpFlexLayout::Stretch);      // 默认,拉伸，与交叉轴对齐
// flexLayout->setAlignContent(TpFlexLayout::FlexStart);    // 顶部对齐
flexLayout->setAlignContent(TpFlexLayout::FlexEnd);      // 底部对齐
// flexLayout->setAlignContent(TpFlexLayout::Center);       // 居中对齐
// flexLayout->setAlignContent(TpFlexLayout::SpaceBetween); // 分散对齐,上下贴着
// flexLayout->setAlignContent(TpFlexLayout::SpaceEvenly);  //  分散对齐,上中下平均
// flexLayout->setAlignContent(TpFlexLayout::SpaceAround);   // 分散对齐,上下是中一半

for (int i = 0; i < 8; ++i)
{
    TpButton *testButton = new TpButton("测试按钮" + TpString::number(i));
    testButton->setSize(150, 60);
    flexLayout->addWidget(testButton);
}
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpFlexLayout演示效果.png)

---

---
url: /components/TpHBoxLayout/index.md
---
# 水平布局 TpHBoxLayout
## 介绍

## 使用示例

```cpp
tpDialog *floatScreenH = new TpDialog();
floatScreenH->setBackGroundColor(_RGBA(255, 255, 255, 200));
floatScreenH->setRect(0, 0, 900, 600);
floatScreenH->setAlpha(128);
floatScreenH->setBeMoved(true);

tpHBoxLayout *hLayout = new TpHBoxLayout();
hLayout->setDirection(TpBoxLayout::RightToLeft);

tpVBoxLayout *sonLayout = new TpVBoxLayout();
sonLayout->setContentsMargins(0, 0, 0, 0);

tpHBoxLayout *son2Layout = new TpHBoxLayout();
son2Layout->setContentsMargins(0, 0, 0, 0);

for (int i = 0; i < 4; ++i)
{
    TpButton *testButton = new TpButton("测试按钮" + TpString::number(i));
    TpButton *testButton3 = new TpButton("子按钮" + TpString::number(i));
    TpButton *testButton4 = new TpButton("二级子按钮" + TpString::number(i));

    testButton->setMinimumSize(100, 40);
    testButton3->setMinimumSize(100, 40);
    testButton4->setMinimumSize(100, 40);

    testButton->setBackGroundColor(_RGB(255, 15, 15));

    hLayout->addWidget(testButton, i + 1);

    sonLayout->addWidget(testButton3, i + 1);
    son2Layout->addWidget(testButton4, i + 1);
}
sonLayout->addLayout(son2Layout);
hLayout->addLayout(sonLayout, 3);

hLayout->addSpacer(new TpSpacerItem(100, 20, TpSpacerItem::Expanding, TpSpacerItem::Minimum));

floatScreenH->setLayout(hLayout);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpHBoxLayout演示效果.png)

---

---
url: /components/TpIconTopButton/index.md
---
# 图标按钮 TpIconTopButton
## 介绍

## 使用示例

```cpp
tpIconTopButton* powerOffBtn = new TpIconTopButton("/res/电源.png", "", this);
powerOffBtn->setIconSize(35, 35);
connect(powerOffBtn, onClicked, [=](bool)
{
    std::cout << "电源开关" << std::endl;
});
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpIconTopButton演示.png)

---

---
url: /components/TpImageWidget/index.md
---
# 图片 TpImageWidget
## 介绍

## 使用示例

```cpp
tpImageWidget *imagePreviewWidget_ = new TpImageWidget();
imagePreviewWidget_->setImageFilePath(filePath);
imagePreviewWidget_->showMaximum();
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/TinyPiXAPP应用开发实践-文件管理器-图片查看.png)

---

---
url: /components/TpLabel/index.md
---
# 标签控件 TpLabel
## 介绍

## 使用示例

```cpp
tpLabel *label1 = new TpLabel(vScreen);
label1->font()->setFontColor(_RGBA(255, 0, 0, 255), 0);
label1->font()->setAntialias(TpFont::TINY_FONT_ANTIALIAS_BEST);
label1->font()->setFontWeight(TpFont::TINY_FONT_WEIGHT_THIN);
label1->setText("TINY_FONT_WEIGHT_THIN");
label1->setRect(0, 0, 250, 30);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpTextLabel演示.png)

---

---
url: /components/TpLine/index.md
---
# 分割线 TpLine
## 介绍

## 使用示例

```cpp
tpLine* hLine = new TpLine(vScreen);
hLine->setLineType(tpLine::HLine);
hLine->setColor(_RGB(255, 255, 255));

tpLine* vLine = new TpLine(vScreen);
vLine->setLineType(tpLine::VLine);
vLine->setColor(_RGB(255, 255, 255));
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpLine.png)

---

---
url: /components/TpLineEdit/index.md
---
# 单行文本框 TpLineEdit
## 介绍

## 使用示例

```cpp
tpLineEdit *edit2 = new TpLineEdit(vScreen);
edit2->setProperty("type", "fileManageEdit");
edit2->setIcon("/搜索.png");
edit2->setPlaceholderText("请输入搜索内容");
edit2->setRect(20, 20, 500, 100);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpLineEdit演示.png)

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpLineEdit中文输入演示.png)

---

---
url: /components/TpListCheckBoxGroup/index.md
---
# 列表选择 TpListCheckBoxGroup
## 介绍

## 使用示例

```cpp
tpListCheckBoxGroup* checkBoxGroup = new TpListCheckBoxGroup(vScreen);
checkBoxGroup->addItem("测试1");
checkBoxGroup->addItem("测试2");
checkBoxGroup->addItem("测试3");
checkBoxGroup->addItem(new TpListCheckBoxGroupItem("测试4"));
checkBoxGroup->addItem(new TpListCheckBoxGroupItem("测试5"));
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpListCheckBoxGroup演示效果.png)

---

---
url: /components/TpMediaTileButton/index.md
---
# 多媒体磁贴按钮 TpMediaTileButton
## 介绍

## 使用示例

```cpp
tpMediaTileButton* pictureTileBtn = new TpMediaTileButton(vScreen);
pictureTileBtn->setText("图片");
pictureTileBtn->setIcon(applicationDirPath() + "/图片.png");
connect(pictureTileBtn, onClicked, [=](bool) {});
```

## 效果演示

* 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpMediaTileButton-默认态.png)

* 选中状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpMediaTileButton-x选中态.png)

---

---
url: /components/TpMenu/index.md
---
# 弹出菜单 TpMenu
## 介绍

## 使用示例

```cpp
tpMenu *menu = new TpMenu();
menu->addItem("Item1");
menu->addItem("Item2");
menu->addItem("Item3");

tpButton *showMenuBtn = new TpButton(vScreen);
showMenuBtn->setText("显示弹出菜单");
showMenuBtn->setProperty("type", "ControlPanelPowerButton");
showMenuBtn->setSize(300, 64);
showMenuBtn->move(20, 20);
connect(showMenuBtn, onClicked, [&](bool)
        { menu->exec(330, 20); });
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMenu演示效果_repeat_1751683140899_203377.png)

---

---
url: /components/TpMenuPanelWidget/index.md
---
# 操作菜单 TpMenuPanelWidget
## 介绍

## 使用示例

```cpp
tpMenuPanelWidget *menuPanelWidget = new TpMenuPanelWidget(vScreen);
connect(menuPanelWidget, onClicked, [=](tpMenuPanelItem *)
        { std::cout << "菜单面板被点击" << std::endl; });

tpMenuPanelItem *panelItem1 = new TpMenuPanelItem();
panelItem1->setIcon(applicationDirPath() + "/蓝牙.png");
panelItem1->setTitle("蓝牙");

tpOnOffButton *onOffBtn1 = new TpOnOffButton();
onOffBtn1->setFixedSize(45, 24);
panelItem1->setCustomizeWidget(onOffBtn1);
menuPanelWidget->addItem(panelItem1);

tpMenuPanelItem *panelItem2 = new TpMenuPanelItem();
panelItem2->setIcon(applicationDirPath() + "/热点.png");
panelItem2->setTitle("热点");

tpOnOffButton *onOffBtn2 = new TpOnOffButton();
onOffBtn2->setFixedSize(45, 24);
panelItem2->setCustomizeWidget(onOffBtn2);
menuPanelWidget->addItem(panelItem2);

tpMenuPanelItem *panelItem3 = new TpMenuPanelItem();
panelItem3->setIcon(applicationDirPath() + "/以太网.png");
panelItem3->setTitle("以太网");
menuPanelWidget->addItem(panelItem3);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMenuPanelWidget演示效果.png)

---

---
url: /components/TpMessageBox/index.md
---
# 提示框 TpMessageBox
## 介绍

## 使用示例

```cpp
tpButton *button1 = new TpButton("消息框", vScreen);
button1->setRect(20, 20, 100, 50);
connect(button1, onClicked, [=](bool)
        { TpMessageBox::information("消息弹出框"); });

tpButton *button2 = new TpButton("警告框", vScreen);
button2->setRect(20, 80, 100, 50);
connect(button2, onClicked, [=](bool)
        { TpMessageBox::warning("警告弹出框"); });

tpButton *button3 = new TpButton("询问框", vScreen);
button3->setRect(20, 140, 100, 50);
connect(button3, onClicked, [=](bool)
        { TpMessageBox::question("询问弹出框"); });

tpButton *button4 = new TpButton("错误框", vScreen);
button4->setRect(20, 200, 100, 50);
connect(button4, onClicked, [=](bool)
        { TpMessageBox::error("错误弹出框"); });
```

## 效果演示

* 信息（Information）

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMessageBox-信息演示效果.png)

* 询问（Question）

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMessageBox-询问演示效果.png)

* 警告（Warning）

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMessageBox-警告演示效果.png)

* 错误（Error）

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpMessageBox-错误演示效果.png)

---

---
url: /components/TpNotificationWidget/index.md
---
# 消息通知 TpNotificationWidget
## 介绍

## 使用示例

```cpp
```

## 效果演示

---

---
url: /components/TpOnOffButton/index.md
---
# 开关按钮 TpOnOffButton
## 介绍

## 使用示例

```cpp
tpOnOffButton *onOffBtn1 = new TpOnOffButton(this, TpOnOffButton::TP_HORIZONTAL);
onOffBtn1->setRect(120, 120, 150, 75);
connect(onOffBtn1, onClicked, [=](bool)
{
    std::cout << "开关1" << std::endl;
});

tpOnOffButton *onOffBtn2 = new TpOnOffButton(this, TpOnOffButton::TP_VERTICAL);
onOffBtn2->setRect(280, 120, 75, 150);
connect(onOffBtn2, onClicked, [=](bool)
{
    std::cout << "开关2" << std::endl;
});
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpOnOffButton演示.png)

---

---
url: /components/TpPanelSwitchButton/index.md
---
# 面板按钮 TpPanelSwitchButton
## 介绍

## 使用示例

```cpp
tpPanelSwitchButton* wifiBtn = new TpPanelSwitchButton(this);
wifiBtn->setCheckable(true);
wifiBtn->setText("WIFI");
wifiBtn->setIcon("/res/WIFI.png");
connect(wifiBtn_, onClicked, [=](bool)
{
    std::cout << "WIFI开关!" << std::endl;
});
```

## 效果演示

* 未选中
  ![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpPanelSwitchButton未选中演示.png)

* 选中
  ![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpPanelSwitchButton选中演示.png)

---

---
url: /components/TpPercentProgressBar/index.md
---
# 百分比进度条 TpPercentProgressBar
## 介绍

## 使用示例

```cpp
tpPercentProgressBar *percetProgress = new TpPercentProgressBar();
percetProgress->setTotalValue(256);
percetProgress->addItem("图片", 35);
percetProgress->addItem("音频", 15);
percetProgress->addItem("视频", 43);
percetProgress->addItem("文档", 3);
percetProgress->addItem("压缩包", 4);
percetProgress->addItem("其他", 20);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-百分比进度条示例.png)

---

---
url: /components/TpProgressBar/index.md
---
# 进度条 TpProgressBar
## 介绍

## 使用示例

```cpp
tpProgressBar *progress = new TpProgressBar(vScreen);
progress->setRangeFrom(0, 100);
progress->setPosition(0);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpProgressBar演示.png)

---

---
url: /components/TpRadioButton/index.md
---
# 单选按钮 TpRadioButton
## 介绍

## 使用示例

```cpp
tpRadioButton *RadioButton5 = new TpRadioButton(vScreen);
RadioButton5->setRect(240, 150, 0, 0);
RadioButton5->setAutoFit(true);
RadioButton5->setText("raidoGroup3");
RadioButton5->setVisible(true);
```

## 效果演示

* 默认状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpRadioButton-默认态.png)

* 选中状态

![](https://file.tinypixos.com/tinypixos/组件资源-默认样式-tpRadioButton-选中态.png)

---

---
url: /components/TpScrollPanel/index.md
---
# 滚动窗口 TpScrollPanel
## 介绍

## 使用示例

```cpp
tpScrollPanel *mainScrollPanel_ = new TpScrollPanel(this);
tpChildWidget* scrollWidget = new TpWidget();
mainScrollPanel_->setWidget(scrollWidget);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpScrollPanel演示效果.png)

---

---
url: /components/TpSlideProgressBar/index.md
---
# 拖动进度条 TpSlideProgressBar
## 介绍

## 使用示例

```cpp
tpSlideProgressBar* voiceProgessBar = new TpSlideProgressBar(this);
voiceProgessBar->setIcon("/path/音量.png");
voiceProgessBar->setRange(0, 100);
voiceProgessBar->setValue(50);
connect(voiceProgessBar, onValueChanged, [=]()
{
    std::cout << "音量修改！" << std::endl; 
});
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpSlideProgressBar演示效果.png)

---

---
url: /components/TpSlider/index.md
---
# 拖动滑块 TpSlider
## 介绍

## 使用示例

```cpp
tpSlider* progressSlider = new TpSlider(this);
progressSlider->setValue(0);
connect(progressSlider, valueChanged,  [=]()
{
    std::cout << "进度修改！" << std::endl; 
});
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpSlider演示效果.png)

---

---
url: /components/TpTabWidget/index.md
---
# Tab选项卡 TpTabWidget
## 介绍

## 使用示例

```cpp
tpTabWidget *tabWidget = new TpTabWidget(vScreen);
tabWidget->addTab(nullptr, "Tab1");
tabWidget->addTab(nullptr, "Tab2");

tpTabBar *tabBar = tabWidget->tabBar();
tabBar->setIcon(0, applicationDirPath() + "/最近-normal.png", applicationDirPath() + "/最近-focus.png");
tabBar->setIcon(1, applicationDirPath() + "/浏览-normal.png", applicationDirPath() + "/浏览-focus.png");
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpTabWidget演示效果.png)

---

---
url: /components/TpVBoxLayout/index.md
---
# 垂直布局 TpVBoxLayout
## 介绍

## 使用示例

```cpp
tpDialog *floatScreenV = new TpDialog();
floatScreenV->setBackGroundColor(_RGBA(255, 255, 255, 200));
floatScreenV->setRect(10, 100, 400, 650);
floatScreenV->setAlpha(128);
floatScreenV->setBeMoved(true);

tpVBoxLayout *vLayout = new TpVBoxLayout();
vLayout->setDirection(TpBoxLayout::BottomToTop);

for (int i = 0; i < 4; ++i)
{
    TpButton *testButton2 = new TpButton("测试按钮" + TpString::number(i));

    testButton2->setMinimumSize(100, 40);
    testButton2->setBackGroundColor(_RGB(255, 15, 15));
    vLayout->addWidget(testButton2, i + 1);
}

vLayout->addSpacer(new TpSpacerItem(100, 20, TpSpacerItem::Minimum, TpSpacerItem::Expanding));
floatScreenV->setLayout(vLayout);
```

## 效果演示

![](https://file.tinypixos.com/tinypixos/tinyPiXCore系统学习-tpVBoxLayout演示效果.png)

---

---
url: /components/TpVirtualKeyboard/index.md
---
# 虚拟键盘 TpVirtualKeyboard
## 介绍

## 使用示例

* 唤醒虚拟键盘

```cpp
tpApp::Inst()->wakeUpVirtualKeyboard(this);
```

* 关闭虚拟键盘

```cpp
tpApp::Inst()->dormantVirtualKeyboard();
```

* 接收虚拟键盘输入

```cpp
virtual void virtualKeyboardInput(const tinyPiX::VirtualKeyboardInputType& type, const TpString& text) override
{
    if (type == tinyPiX::Delete)
    {
    }
    else if (type == tinyPiX::Pinyin)
    {
    }
    else if (type == tinyPiX::Chinese || type == tinyPiX::Symbol)
    {
    }
    else
    {
    }
}

```

## 效果演示

* 默认状态

![](https://file.tinypixos.com/tinypixos/TinyPiXAPP应用开发实践-虚拟键盘-默认状态.png)

* 中文输入

![](https://file.tinypixos.com/tinypixos/TinyPiXAPP应用开发实践-虚拟键盘-中文输入.png)

* 符号输入

![](https://file.tinypixos.com/tinypixos/TinyPiXAPP应用开发实践-虚拟键盘-符号输入1.png)

![](https://file.tinypixos.com/tinypixos/TinyPiXAPP应用开发实践-虚拟键盘-符号输入2.png)

---

---
url: /custom/index.md
description: >-
  TinyPiXOS（派OS）提供免费商用授权与专业开发服务。个人和企业可基于Apache
  2.0协议免费使用此国产嵌入式操作系统，同时可获取硬件适配、系统定制、应用开发等专业服务。技术支持：dev@tinypixos.com，商务合作：bd@tinypixos.com。
---
# 定制服务
## 免费商用

允许==个人和企业免费商用==，遵循`Apache 2.0`许可，保留界面标识。

::: note 界面标识释义
免费社区版需保留运行界面版权标识，去除标识需购买授权服务
:::

## 授权服务

::: important
欢迎有需求的个人/企业加入。

:::

* 隐藏标识，不显示界面标识信息

## 开发服务

* 关于定价 \[+关于定价]
* 服务范围：硬件适配、系统定制、应用开发、硬件开发

服务流程：客户提供需求，技术团队评估研发可行性、开发周期和研发成本，双方达成合作意向。

\[+关于定价]:
\- 合作理念：`开源开放，共享共赢`\
\- 灵活合作模式：
1\. 联合研发：双方达成的合作意向，确定合作模式，评估研发成本，商议各自投入比例，确定收益方式。
2\. 外包服务：客户提供需求，技术团队按照客户需求在约定周期内完成服务内容。

## 联系我们

* 技术支持：**dev@tinypixos.com**
* 商务支持：**bd@tinypixos.com**

---

---
url: /guide/appdevelop/build/index.md
---
# 打包和安装
## 项目文件准备

APP打包接口负责应用的标准化封装。开发者可通过该模块直接调用接口配置应用基本信息（包括应用名称、开发者联系方式及公司/组织信息）与运行所需文件（含可执行文件、资源文件、库文件等），或通过预定义的JSON配置文件一次性设置全部参数后调用专用接口实现一键打包。

## 应用打包

### 使用Json配置打包

使用工具类tpAppDopack可以直接对应用进行打包，需要提前配置好应用信息。

```cpp
tpAppDopack package;
package.getAllConfig("dopack.json");
package.setPackageName("mytestapp");
package.creatPackage("./");
```

json文件为应用的配置信息，内容如下：

```json
{
    "appID": "f03c8f8c-dd9b-453f-b2d4-d049c073e252",
    "appName": "MyApp",
    "organization": "MyCompany",
    "version": "1.0.0",
    "appexecName": "/path/mytestapp",
    "architecture": "amd64",
    "section": "free",
    "priority": "optional",
    "essential": "no",
    "diskspace": "102400",
    "description": "this is tinyPiXOS test APP",
    "signature": "",
    "icon": "/path/icon.jpeg",
    "author": {
        "name": "Name",
        "email": "123456789@email.com"
    },
    "fileExtension": [
        ".jpeg",
        ".jpg",
        ".png",
    ],
    "startupParameters": [
        "--fullscreen",
        "--server"
    ],
    "libraries": [
        "/path/libmytest.so"
    ],
    "dependencies": [
        {
            "name": "libdependency1",
            "version": "1.2"
        },
        {
            "name": "libdependency2",
            "version": "3.1"
        }
    ],
    "assertFiles": [
        "/path/assert/mysrc",
        "/path/assert/picture"
    ],
    "binFiles": [
        "/path/bin_1",
        "/path/bin_2"
    ],
    "otherFiles": [
        "/path/otherfile"
    ]
}
```

可以根据该Json模板进行修改，配置个人应用信息，参数配置说明如下：

```bash
- appID: 应用UUID
- appName: 应用的名字,
- organization: 公司/组织,
- version: 应用版本号,
- appexecName: 应用可执行文件路径
- architecture: 支持的硬件架构,
- section: 应用所属分类，utils、graphics、games等,
- priority: 安装优先级，optional=非必需，standard=基础组件，required=系统关键组件,
- essential: 是否为系统核心组件,yes或no,
- diskspace: 应用占用空间,
- description: 应用描述,
- signature: 数字签名(暂不支持),
- icon: 应用图标路径,
- author: 作者,
- fileExtension:  应用支持的文件格式,
- startupParameters: 应用启动参数，可以不设置,
- libraries: 应用自己的库,
- dependencies: 依赖的开源库,
- assertFiles: 静态文件,
- binFiles: 其他应用可执行文件,
- otherFiles: 其他应用文件,
```

### 自定义接口打包

除了使用Json文件形式配置应用安装包信息外，也可以使用tpAppDopack的接口直接配置相关信息。

```cpp
tpAppDopack package;
printf("set package type\n");
package.setPackageType(tpAppDopack::TP_PACKAGE_TYPE_APP);
package.setAppID("f03c8f8c-dd9b-453f-b2d4-d049c073e252");
package.setAppName("apptest");
package.setVersion(1,0,0);
package.setAppPath("/home/pix/AppManage/mytestapp/mytestapp");
package.setArchitecture("amd64");
package.setAuthor("Chingan");
package.setContact("2111956539@qq.com");
package.setProvides("tinyPiX");
package.addDepend("libalsa",1,5,1);
package.addDepend("libssl",1,0,0);
package.addAssert("/home/pix/AppManage/mytestapp/assert/mysrc");
package.addAssert("/home/pix/AppManage/mytestapp/assert/picture");
package.addLib("/home/pix/AppManage/mytestapp/lib/libmysum.so");
package.setIcon("/home/pix/AppManage/mytestapp/icon.jpeg");
package.addExtension(".png");
package.addExtension(".jpg");
package.addExtension(".jpeg");
package.addExtension(".bmp");
package.addFile("/home/pix/AppManage/mytestapp/jiyc");

//设置应用的启动参数
package.addStartArg("--fullscreen");
package.addStartArg("--server");
package.setExecPath("mytestapp");

//设置安装包名字并打包
package.setPackageName("mytestappPackage");
package.creatPackage("/home/pix/AppManage/");
```

## 应用安装

应用安装接口内部会自动校验安装环境，以下是应用安装的示例

```cpp
tpString package_path(pack_path);
tpAppInstall appmanage(package_path);
appmanage.install();
while(1)
{
    if(appmanage.getInstallSchedule()==100)
        break;
    usleep(50000);
}
```

## 应用卸载

```cpp
tpString uuid="0756e187-6f59-4b24-82f6-d4020029c9b8";
tpAppInstall::remove(uuid);
```

## 运行

使用tpAppConfigIO工具类获取应用配置信息，然后使用tpProcess工具类启动应用。

```cpp
tpAppConfigIO configIO(uuid);

tpString runnerPath = configIO.runnerPath();
tpFileInfo runnerFileInfo(runnerPath);
if (!runnerFileInfo.exists())
{
    std::cout << "应用 " << configIO.appName() << " 可执行程序不存在!" << std::endl;
    return;
}

tpProcess exeProcess;
exeProcess.start(runnerPath, argList);
int32_t processPID = exeProcess.launchProcessID();
std::cout << "processPID " << processPID << std::endl;
```

---

---
url: /guide/appdevelop/demo/index.md
description: >-
  TinyPiXOS应用开发入门教程：手把手教你创建第一个嵌入式GUI应用。从项目创建、主窗体设计到按钮添加和事件处理，包含完整C++源码示例。详细说明编译步骤和运行方法，帮助开发者快速上手TinyPiXOS应用开发。
---
## 示例应用开发

::: note 实现一个显示交互按钮的简单应用。
:::

### 项目创建

1. 拉取应用模板项目[Example](https://gitee.com/tinypixos/TinyPiXOS/tree/master/examplesApp)
2. 使用扩展插件在指定位置创建应用(未来扩展)

### 创建应用主窗体

模板项目会默认创建 `mainWindowService`作为应用主窗体；可以直接使用或创建自定义窗体继承于`TpMainWindow`，并在主函数使用

### 创建一个按钮

#### 包含TpButton头文件

```cpp
#include "TpButton.h"
```

#### 声明测试按钮

```cpp
TpButton *testButton_;
```

#### 初始化按钮

```cpp
testButton_ = new TpButton("测试按钮", this);
testButton_->setSize(300, 70);
testButton_->move(150, 150);
```

## 完整源码

```cpp
#ifndef __MAIN_WINDOW_SERVICE_H
#define __MAIN_WINDOW_SERVICE_H

#include "TpMainWindow.h"
#include "examplesAppGlobal.h"
#include "TpButton.h"

class mainWindowService
    : public TpMainWindow
{
public:
    mainWindowService();
    virtual ~mainWindowService();

public:
    virtual bool appChange(int32_t id, int32_t pid, int32_t rotate, int32_t visible, int32_t active, int32_t color, uint8_t alpha, int32_t require) override;

protected:
    virtual bool onResizeEvent(TpObjectResizeEvent *event) override;

    virtual bool onRotateEvent(tpObjectRotateEvent *event) override;

    virtual bool onActiveEvent(tpObjectActiveEvent *event) override;

private:
    TpButton *testButton_;
};

#endif
```

***

```cpp
#include "mainWindowService.h"

mainWindowService::mainWindowService()
    : TpMainWindow()
{
    setStyleSheet(applicationDirPath() + "/../data/style.css");

    setBackGroundColor(_RGB(128, 128, 128));

    testButton_ = new TpButton("测试按钮1", this);
    testButton_->setSize(300, 70);
    testButton_->move(150, 150);
}

mainWindowService::~mainWindowService()
{
}

bool mainWindowService::appChange(int32_t id, int32_t pid, int32_t rotate, int32_t visible, int32_t active, int32_t color, uint8_t alpha, int32_t require)
{
    std::cout << "mainWindowService::appChange" << std::endl;

    return true;
}

bool mainWindowService::onResizeEvent(TpObjectResizeEvent *event)
{
    std::cout << "mainWindowService::onResizeEvent" << std::endl;

    return true;
}

bool mainWindowService::onRotateEvent(tpObjectRotateEvent *event)
{
    std::cout << "mainWindowService::onRotateEvent" << std::endl;

    return true;
}

bool mainWindowService::onActiveEvent(tpObjectActiveEvent *event)
{
    std::cout << "mainWindowService::onActiveEvent" << std::endl;

    return true;
}
```

## 编译和运行

### 代码编译

```bash
cmake
make
make install
```

### 启动模拟器

```bash
TpWM
```

### 运行应用

```bash
./examplesApp
```

### 运行结果

![](https://file.tinypixos.com/tinypixos/使用指南-应用开发-应用示例.png)

---

---
url: /guide/appdevelop/standard/index.md
---
# 开发规范
## 应用目录结构规范

::: file-tree

* AppWorkSpace
  * bin
    * appRunner
    * lib.so
  * conf
  * res
  * data
  * src
    * mainWindowService.h
    * mainWindowService.cpp
    * main.cpp
  * CMakeList.txt
  * CMakePresets.json
    :::

## 目录介绍

* bin/ 应用所有可执行程序及程序依赖动态库目录
* conf/ 配置文件目录
* res/ 资源文件目录
* data/ 数据文件目录
* src/ 源码文件目录

---

---
url: /guide/comdevelop/demo/index.md
description: >-
  TinyPiXOS自定义组件开发教程：通过创建可点击的电量指示灯组件，详细讲解如何继承TpWidget基类、重写onPaintEvent绘制界面和onMousePressEvent处理交互事件。包含完整的C++头文件和实现代码，掌握嵌入式GUI组件自定义开发技能。
---
## 组件开发

::: note 实现一个点击切换进度的电量指示灯。
:::

步骤如下所示：

* 创建自定义组件类

创建`TestLight.cpp`和`TestLight.h`文件

* 组件类需继承于TpWidget

```cpp
#ifndef __TEST_LIGHT_H
#define __TEST_LIGHT_H

#include "TpWidget.h"
#include "tpEvent.h"

class TestLight : public TpWidget
{
public:
    TestLight(TpWidget *parent);

    virtual ~TestLight();
};

#endif
```

* 定义电量最大格数和当前显示格数变量

```cpp
int maxCount_;
int count_;
```

* 重写onPaintEvent事件，根据电量格数绘制效果

  * 获取绘制画笔

  ```cpp
  TpPainter* painter = event->painter();
  ```

  * 绘制底色

  ```cpp
  painter->setPen(_RGB(255, 255, 255));
  painter->setBrush(TpBrush(_RGB(255, 255, 255)));
  painter->drawRect(0, 0, width(), height());
  ```

  * 根据最大格数计算每个格子的宽度

  ```cpp
  int spacing = 3;
  int singleWidth = (width() - (maxCount_ + 1) * spacing) / maxCount_;
  ```

  * 根据当前电量绘制电量格子

  ```cpp
  painter->setPen(_RGB(128, 255, 128));
  painter->setBrush(TpBrush(_RGB(128, 255, 128)));
  for (int i = 0; i < count_; ++i)
  {
      int drawX = spacing + i * (singleWidth + spacing);
      painter->drawRect(drawX, spacing, singleWidth, height() - spacing * 2);
  }
  ```

* 重写 onMousePressEvent 捕获鼠标按下事件，获取鼠标点击状态

```cpp
bool TestLight::onMousePressEvent(TpMouseEvent *event)
{
    TpWidget::onMousePressEvent(event);

    count_++;
    if (count_ > maxCount_)
        count_ = 0;

    return true;
}
```

## 组件测试

```cpp
TestLight* light = new TestLight(this);
testButton_->setSize(200, 50);
testButton_->move(150, 300);
```

## 演示效果

![](https://file.tinypixos.com/tinypixos/使用指南-组件开发-自定义组件演示-1.png)

![](https://file.tinypixos.com/tinypixos/使用指南-组件开发-自定义组件演示-2.png)

## 完整源码如下

```c++ title="TestLight.h"
#ifndef __TEST_LIGHT_H
#define __TEST_LIGHT_H

#include "TpWidget.h"
#include "tpEvent.h"

class TestLight : public TpWidget
{
public:
    TestLight(TpWidget *parent);

    virtual ~TestLight();

public:
    virtual bool onMousePressEvent(TpMouseEvent *event) override;

    virtual bool onPaintEvent(TpPaintEvent *event) override;

private:
    int maxCount_;
    int count_;
};

#endif

```

***

```c++ title="TestLight.cpp"
#include "TestLight.h"
#include "TpPainter.h"

TestLight::TestLight(TpWidget *parent)
    : TpWidget(parent), maxCount_(4), count_(0)
{
}

TestLight::~TestLight()
{
}

bool TestLight::onMousePressEvent(TpMouseEvent *event)
{
    TpWidget::onMousePressEvent(event);

    count_++;
    if (count_ > maxCount_)
        count_ = 0;

    return true;
}

bool TestLight::onPaintEvent(TpPaintEvent *event)
{
    TpWidget::onPaintEvent(event);

    TpPainter *painter = event->painter();

    painter->setPen(_RGB(255, 255, 255));
    painter->setBrush(TpBrush(_RGB(255, 255, 255)));

    painter->drawRect(0, 0, width(), height());

    int spacing = 3;
    int singleWidth = (width() - (maxCount_ + 1) * spacing) / maxCount_;

    painter->setPen(_RGB(128, 255, 128));
    painter->setBrush(TpBrush(_RGB(128, 255, 128)));
    for (int i = 0; i < count_; ++i)
    {
        int drawX = spacing + i * (singleWidth + spacing);
        painter->drawRect(drawX, spacing, singleWidth, height() - spacing * 2);
    }

    return true;
}

```

---

---
url: /guide/comdevelop/standard/index.md
---
## 命名规范

采用`Tp`开头命名组件类，名称具备易读性

## 目录规范

* 头文件放置 `include/TpGUI/Widgets/`
* 源文件放置 `src/TpGUI/Widgets/`

## 代码结构

使用`PIMPL（Pointer to Implementation）`设计规范，隐藏实现细节，降低编译依赖性和增强代码稳定性‌；\
使用`TP_DEF_VOID_TYPE_VAR`宏声明管理指针；所有成员变量或函数实现细节封装在cpp中。

`TpWidget`作为所有组件的基类，自定义组件必须继承于`TpWidget`类并包含其头文件。

```cpp
#include "TpWidget.h"
class TpXXXXX : public TpWidget
{

};
```

---

---
url: /guide/env/init/index.md
description: >-
  TinyPiXOS快速上手指南：详细说明开发环境搭建（Ubuntu 22.04）、VSCode配置及必备插件安装。包含完整的“Hello
  World”示例程序代码，从创建带按钮的窗口到编译运行，一步步引导开发者开始首个嵌入式GUI应用开发。
---
## 开发环境搭建

### 项目运行环境

开发调试环境建议使用[Ubuntu22.04 Desktop](https://mirror.tuna.tsinghua.edu.cn/ubuntu-releases/22.04.5/)

TinyPiXOS开发环境可以通过 **[源码编译安装](/guide/env/source/)** 或者 **[下载安装包](/guide/env/package/)** 进行开发环境配置。

### VSCode开发工具

建议使用[Visual Studio Code](https://vscode.js.cn/Download)进行项目开发，使用`CMake`进行工程管理。

VSCode可以直接安装在Ubuntu虚拟机当中使用，同时也可以将VSCode安装在Windows/Mac宿主机上，使用
`ms-vscode-remote.remote-ssh`、`ms-vscode-remote.remote-ssh-edit`、`ms-vscode.remote-explorer`插件通过`ssh`远程链接虚拟机进行开发。（具体配置方法可自行搜索）

#### 推荐安装插件清单

```txt title="extensions.txt"
cheshirekow.cmake-format
cschlosser.doxdocgen
josetr.cmake-language-support-vscode
mhutchie.git-graph
ms-ceintl.vscode-language-pack-zh-hans
ms-vscode-remote.remote-ssh
ms-vscode-remote.remote-ssh-edit
ms-vscode.cmake-tools
ms-vscode.cpptools
ms-vscode.cpptools-extension-pack
ms-vscode.cpptools-themes
ms-vscode.makefile-tools
ms-vscode.remote-explorer
shd101wyy.markdown-preview-enhanced
zchrissirhcz.cmake-highlight
```

#### 安装VSCode插件

::: steps

1. 将VSCode添加到系统路径(环境变量)

   * MacOS/Linux
     1. 打开 VSCode。
     2. 按下`Command + Shift + P`打开命令面板。
     3. 输入`Shell Command: Install ‘code’ command in PATH`并按下 Enter。
   * Windows
     1. 打开 VSCode。
     2. 按下`Ctrl + Shift + P`打开命令面板。
     3. 输入`Shell Command: Install ‘code’ command in PATH`并按下 Enter。
     4. 重启命令提示符或 PowerShell。

2. 安装插件

   可先把`extensions.txt`文件复制到该设备，接着在终端中运行以下脚本：

   * MacOS/Linux
     ```bash
     cat extensions.txt | xargs -L 1 code --install-extension
     ```
   * Windows
     ```bash
     Get-Content extensions.txt | ForEach-Object { code --install-extension $_ }
     ```

:::

上述脚本会逐行读取`extensions.txt`文件中的插件名称，并且使用`code --install-extension`命令来安装这些插件。

## 简单示例程序

直接使用`g++`构建一个实例程序，g++需要支持C++11，建议版本11.4。

1. 创建`main.cpp`，构建一个显示一个按钮的实例程序

```c++ title="main.cpp"
#include "TpApp.h"
#include "TpMainWindow.h"
#include "TpButton.h"

int32_t main(int32_t argc, char *argv[])
{
    // 构建主事件循环对象
    TpApp app(argc, argv);

    // 创建主窗体对象
    TpMainWindow *vScreen = new TpMainWindow();
    // 设置主窗体背景颜色
    vScreen->setBackGroundColor(_RGBA(128, 128, 128, 255));
    // 将主窗体绑定至app
    app.bindVScreen(vScreen);

    // 创建一个按钮对象，设置按钮文本为"北京市"，按钮放置在 vScreen 窗体上显示
    TpButton *button1 = new TpButton("北京市", vScreen);
    // 设置按钮的尺寸
    button1->setSize(300, 64);
    // 设置按钮显示在父窗体（vScreen）的坐标
    button1->move(150, 150);
    // 绑定按钮信号槽，按钮在被点击后触发该信号，进入该匿名函数
    connect(button1, onClicked, [=](bool checked)
            { std::cout << "按钮被点击" << std::endl; });

    // 手动更新主窗体
    vScreen->update();

    // 运行主事件循环
    return app.run();
}
```

2. 创建编译脚本`cross`与`main.cpp`在同级目录

```bash title="cross"
g++ main.cpp -o button -I. -I/usr/include/TinyPiX -I/usr/include/TinyPiX/TpWM -I/usr/include/TinyPiX/TpUtils -I/usr/include/TinyPiX/TpExtUtils -I/usr/include/TinyPiX/TpGUI -I/usr/include/TinyPiX/TpGUI/Core -I/usr/include/TinyPiX/TpGUI/Screen -I/usr/include/TinyPiX/TpGUI/Widgets -I/usr/include/TinyPiX/TpGUI/Core -L/usr/lib -L/usr/lib/TinyPiX -lTpUtils -lTpExtUtils -lTpGUI
```

3. 运行编译脚本

需要`cross`文件有可执行权限，若无可执行权限可使用`chmod`命令修改权限

```bash
chmod 777 cross
./cross
```

4. 运行程序

编译成功后会在当前目录下生成一个`button`可执行文件。执行button前需要启动`TpWM`

```bash
#TpWM
./button
```

## 详细教程

* **应用开发**详细教程参考[开发第一个APP](/guide/appdevelop/demo/)
* **组件开发**详细教程参考[自定义组件](/guide/comdevelop/demo/)
* **示例程序**[examples](https://gitee.com/tinypixos/TinyPiXOS/tree/master/examples)

---

---
url: /guide/env/package/index.md
---
# 安装包下载
## X86\_64安装包

\<template #badge>



包含TinyPiXOS、TinyPiXApp安装包。`TinyPiXApp可选安装`，提供桌面环境和示例应用。

## ARM64安装包

\<template #badge>



包含TinyPiXOS、TinyPiXApp安装包。`TinyPiXApp可选安装`，提供桌面环境和示例应用。

---

---
url: /guide/env/source/index.md
---
# 源码安装
::: important 查看代码仓库README进行源码安装
:::

## 安装步骤

:::: steps

1. 编译安装TinyPiXOS


   安装步骤见仓库`readme`\
   ::: tip 安装完成TinyPiXOS之后就可以进行应用开发了，可以根据需求安装TinyPiXApp。
   :::

2. 编辑安装TinyPiXApp


   安装步骤见仓库readme\
   TinyPiXApp提供演示应用，如果不需要查看演示应用可以仅安装TinyPiXOS即可。

::::

---

---
url: /guide/extend/css/index.md
description: >-
  TinyPiXOS
  CSS样式支持完整参考指南。详细列出TpGUI框架支持的CSS属性，包括尺寸单位(dp)、颜色格式(RGB/RGBA/渐变)、边框样式、内边距、圆角设置及悬停/激活等状态伪类。提供组件类型筛选和代码绑定实例，助力嵌入式界面美化。
---
# CSS样式支持
## CSS属性介绍

### width

设置默认宽度，单位缺省或dp

```css
  width: 15;
  width: 15dp;
```

### min-width

设置最小宽度，默认最小宽度为0，单位缺省或dp

```css
  min-width: 15;
  min-width: 15dp;
```

### max-width

设置最大宽度，默认最大宽度为 `WIDGET_MAX_WIDTH` ***（代码中的宏定义）***，单位缺省或dp

```css
  max-width: 15;
  max-width: 15dp;
```

### height

设置默认宽度，单位缺省或dp

```css
  height: 15;
  height: 15dp;
```

### min-height

设置最小高度，默认最小高度为0，单位缺省或dp

```css
  min-height: 15;
  min-height: 15dp;
```

### max-height

设置最大高度，默认最大高度为 `WIDGET_MAX_HEIGHT` ***（代码中的宏定义）***，单位缺省或dp

```css
  max-height: 15;
  max-height: 15dp;
```

### color

设置字体颜色，支持rgb和rgba格式

```css
    color: rgb(38, 38, 38);
    color: rgba(38, 38, 38, 1.0);
```

### sub-color

设置辅助色，部分有效，例如tpSlider、tpPercentProgressBar等，支持rgb和rgba格式

```css
    sub-color: rgb(140, 29, 235);
    sub-color: rgba(140, 29, 235, 1.0);
```

### background

设置背景颜色，支持rgb、rgba和渐变格式

```css
    background: rgb(255, 255, 255);
    background: rgba(255, 255, 255, 1.0);
    background: linear-gradient(90deg, rgb(107, 80, 246), rgb(204, 143, 237));
```

### background-color

设置背景颜色，支持rgb、rgba和渐变格式

```css
    background-color: rgb(255, 255, 255);
    background-color: rgba(255, 255, 255, 1.0);
    background-color: linear-gradient(90deg, rgb(107, 80, 246), rgb(204, 143, 237));
```

### border-color

设置边框颜色，支持rgb、rgba和渐变格式

```css
    border-color: rgb(255, 255, 255);
    border-color: rgba(255, 255, 255, 1.0);
    border-color: linear-gradient(90deg, rgb(107, 80, 246), rgb(204, 143, 237));
```

### border-width

设置边框线宽，默认线宽为1px，单位缺省或dp

```css
    border-width: 1;
    border-width: 1dp;
```

### font-size

设置字体大小，单位缺省或dp

```css
    font-size: 18;
    font-size: 18dp;
```

### gap

设置内部元素间隔，单位缺省或dp

```css
    gap: 3;
    gap: 3dp;
```

### padding

设置内部元素距四个边界距离，如果设置padding则padding-left、padding-right、padding-top、padding-bottom属性无效，单位缺省或dp

```css
    padding: 3;
    padding: 3dp;
```

### padding-left

设置内部元素距左边界距离，如果设置了padding属性则本属性无效，单位缺省或dp

```css
    padding-left: 3;
    padding-left: 3dp;
```

### padding-right

设置内部元素距右边界距离，如果设置了padding属性则本属性无效，单位缺省或dp

```css
    padding-right: 3;
    padding-right: 3dp;
```

### padding-top

设置内部元素距上边界距离，如果设置了padding属性则本属性无效，单位缺省或dp

```css
    padding-top: 3;
    padding-top: 3dp;
```

### padding-bottom

设置内部元素距下边界距离，如果设置了padding属性则本属性无效，单位缺省或dp

```css
    padding-bottom: 3;
    padding-bottom: 3dp;
```

### border-radius

设置圆角尺寸，单位缺省或dp

```css
    border-radius: 3;
    border-radius: 3dp;
```

### icon-size

设置图标尺寸，部分组件有效，例如TpIconTopButton、TpMediaTileButton、TpMenuPanelItem等，单位缺省或dp

```css
    icon-size: 3;
    icon-size: 3dp;
```

## CSS状态介绍

### hover

鼠标悬停状态，使用此状态可设置鼠标悬停组件时的样式

```css
TpButton:hover {
  background-color: rgb(239, 239, 239);
}
```

### active

鼠标按压状态，可设置鼠标按下组件时样式

```css
TpButton:active {
  background-color: rgb(208, 215, 221);
}
```

### checked

选中状态，可设置组件选中时样式，组件可设置开启选中态，开启后点击一次切换为选中态，再点击则切换为非选中态

```css
TpButton:checked {
  background-color: rgb(208, 215, 221);
}
```

### disabled

禁用状态，可设置组件被禁用时样式

```css
TpButton:disabled {
  background-color: rgb(208, 215, 221);
}
```

### enabled

启用状态，即默认状态，可设置组件在启用/默认状态的样式，可缺省表示

```css
TpButton:enabled {
  background-color: rgb(208, 215, 221);
}
TpButton {
  background-color: rgb(208, 215, 221);
}
```

### 自定义筛选类型

可以对CSS设置筛选类型，指定组件响应指定样式，使用`type`对CSS进行修饰，并在代码中为组件绑定特殊样式

```css
TpButton[type="ControlPanelPowerButton"] {
    height: 64dp;
    width: 305dp;
    font-size: 18dp;
    color: rgb(38, 38, 38);
    background-color: rgb(255, 255, 255);
    border-radius: 32;
}

TpButton[type="ControlPanelPowerButton"]:hover {
    background-color: rgb(239, 239, 239);
}

// C++代码中指定组件绑定样式
setProperty("type", "ControlPanelPowerButton");
```

## 使用实例

### 创建测试程序

参考应用开发创建一个默认应用程序，并创建一个TpButton对象

### 定义自定义CSS样式

```css
TpButton {
    gap: 5dp;
    font-size: 15dp;
    color: rgb(255, 128, 128);
    background-color: rgb(255, 255, 255);
}

TpButton:hover {
    background-color: rgb(128, 255, 128);
}

TpButton[type="TestCssType"] {
    height: 64dp;
    width: 305dp;
    font-size: 18dp;
    color: rgb(128, 128, 255);
    background-color: rgb(255, 255, 255);
    border-radius: 32;
}

TpButton[type="TestCssType"]:hover {
    background-color: rgb(55, 55, 55);
}
```

### 对按钮设置自定义CSS样式

```cpp
    TpString testCSSStr = "上一步的CSS";
    setStyleSheet(testCSSStr);

    TpButton* testButton1 = new TpButton("测试按钮1", this);
    testButton1->setSize(300, 70);
    testButton1->move(150, 150);

    TpButton* testButton2 = new TpButton("测试按钮2", this);
    testButton2->setProperty("type", "TestCssType");
    testButton2->setSize(300, 70);
    testButton2->move(500, 150);
```

### 显示效果

#### 正常态

![](https://file.tinypixos.com/tinypixos/使用指南-CSS示例-正常态.png)

#### 悬停态

![](https://file.tinypixos.com/tinypixos/使用指南-CSS示例-悬停态-1.png)

![](https://file.tinypixos.com/tinypixos/使用指南-CSS示例-悬停态-2.png)

---

---
url: /guide/FAQ/index.md
---
# 常见问题
## 常见问题

---

---
url: /guide/module/TpExtUtils/index.md
description: >-
  TpExtUtils是TinyPiXOS的系统级集成库，为应用程序与底层系统资源提供桥梁。提供媒体处理（音视频编解码）、网络通信（TCP/UDP）、蓝牙连接、设备管理、应用生命周期管理和系统资源监控等标准化接口，实现硬件与系统的无缝集成。
---
# TpExtUtils
## 模块介绍

::: note TpExtUtils 库为 TinyPiXOS 应用程序提供全面的系统级集成功能。该库充当高级应用程序逻辑和低级系统资源之间的桥梁，为媒体处理、网络通信、蓝牙连接、应用程序生命周期管理、硬件监控和设备管理提供标准化接口。
:::

***

* 统一媒体处理:提供 TpAudioInterface、TpVideoInterface 作为音视频处理的统一抽象层,集成 FFmpeg 编解码能力,支持多格式媒体文件的高效播放与录制。
* 设备管理:通过 TpDiskManage、TpUsbManager 实现热插拔设备的自动检测与挂载,提供设备状态变化的信号驱动通知机制,降低外设管理复杂度。
* 高效网络通信:内建完整的 TCP/UDP Socket 框架,提供 TpTcpSocket、TpUdpSocket、TpTcpServer 等标准化网络接口,支持异步事件驱动的连接管理与数据传输。
* 蓝牙协议栈:基于 BlueZ 实现完整的蓝牙设备配对、音频传输与文件交换能力,通过 TpBluetoothLocal、TpBluetoothAudioManager 提供声明式设备管理接口。
* 应用生命周期管理:提供 TpAppInstall、TpAppDopack 实现沙箱化应用安装,支持权限控制、依赖注入与加密签名验证,确保系统安全性。
* 系统资源监控:通过 TpCpuManage、TpMemory、TpDiskManage 实时采集CPU/内存/磁盘 I/O 等系统指标,为性能优化提供数据支撑。
* 显示系统集成:TpDisplay 提供 DPI 缩放计算与 TpWM 窗口管理器的分辨率适配,支持多显示器配置与运行时分辨率切换。

---

---
url: /guide/module/TpGUI/index.md
description: >-
  TpGUI是TinyPiXOS操作系统的核心GUI框架，提供完整的用户界面系统。具备CSS样式、事件处理、动画功能，采用统一对象管理、智能内存管理和高效渲染调度，支持声明式样式定制，是构建嵌入式图形应用的基础。
---
# TpGUI
## 模块介绍

::: note TpGUI 库为 TinyPiXOS 应用程序提供了核心 GUI 框架，实现了一个全面的基于小部件的用户界面系统，具有 CSS 样式、事件处理和动画功能。该库是在 TinyPiXOS 平台上构建图形应用程序的基础。
:::

![PiXSingleGUI架构图](https://file.tinypixos.com/tinypixos/PiXSingleGUI架构图_repeat_1752052889995__847174.jpg)

***

* ​统一对象管理：​提供TpObject作为框架中所有模块组件的​​公共基类​​，建立​​统一的对象生命周期管理体系​​，确保资源管理的严谨性。
* ​高效事件分发：​​统一处理和传播用户输入、系统事件。
* ​智能内存管理：​​自动或半自动处理控件内存，降低资源泄漏风险。
* ​渲染调度系统：​​优化绘制流程，协调组件间的渲染顺序与更新，保障界面流畅性。
* ​声明式样式定制：​​内建强大的​​样式表系统​​，允许开发者通过​​声明式配置​​快速、便捷地定制控件外观和整体界面风格，​​避免硬编码​​。

---

---
url: /guide/module/TpService/index.md
description: >-
  TpService是TinyPiXOS的后台服务模块，基于nanomsg实现高效通信。当前提供发布/订阅模式的消息广播和进程间通信(IPC)，支持多传输协议。未来计划扩展RPC远程调用和系统级服务接口，为嵌入式系统提供轻量可扩展的通信基础。
---
# TpService
## 模块介绍

::: note TpService 是 ​​TinyPiXOS​​ 框架的后台服务模块，基于 ​​nanomsg​​ 实现高效通信，目前主要提供 ​​进程间通信（IPC）​​ 和 ​​局域网设备间通信​​ 功能，并计划逐步扩展为更强大的系统服务节点。
:::

## ​当前功能​​

### ​发布/订阅（Pub-Sub）模式​​

支持多节点消息广播，适用于事件通知、状态同步等场景。实现低延迟、高吞吐的通信。

### ​进程间通信（IPC）

提供轻量级进程间数据交换，适用于模块化应用架构。
支持多种传输协议（如 inproc、ipc、tcp）。

## 计划​未来扩展​​

### ​RPC（远程过程调用）支持​​

提供请求/响应模式，便于跨进程或跨设备调用服务。
支持同步/异步调用，提高系统灵活性。

### ​系统级服务接口​​

​​进程管理​​：获取当前运行进程信息，监控应用状态。
​​远程应用控制​​：支持安全地远程启动、停止应用。

## ​技术特点​​

* ​轻量高效​：基于 ​​nanomsg​​，资源占用低，适合嵌入式及轻量级应用。
* ​可扩展​​：模块化设计，便于未来集成更多高级功能（如认证、负载均衡）。

**TpService 旨在为 ​​TinyPiXOS​​ 提供稳定、高效的通信基础，并逐步演进为更强大的系统服务框架。**

---

---
url: /guide/module/TpUtils/index.md
description: >-
  TpUtils是TinyPiXOS的基础工具库，提供核心数据结构、文件操作、JSON处理、CSS解析和系统API。具备统一数据抽象、高效序列化机制和事件驱动调度功能，为其他TinyPiXOS组件提供底层支持。
---
# TpUtils
## 模块介绍

::: note TpUtils​​ 是 TinyPiXOS 中的基础实用程序库，提供核心数据结构、文件作、CSS 解析、JSON 处理、系统集成 API 和通信机制。该库用作其他 TinyPiXOS 组件的基本功能所依赖的基础层。
:::

***

* 统一数据抽象：提供 TpString、TpList、TpHash、TpVector 等作为框架中所有数据操作的通用容器基类,建立统一的数据结构管理体系,确保类型安全与内存效率。
* 高效序列化机制：统一处理二进制与 JSON 格式的数据转换,支持结构体与内存缓冲区的快速互转,适用于高性能数据存储与传输。
* 事件驱动调度：内建信号槽系统,基于观察者模式实现松耦合的组件间通信,支持异步事件传播与回调处理。

---

---
url: /guide/module/TpWM/index.md
description: >-
  TpWM是TinyPiXOS的核心窗口管理引擎，采用纯C语言开发，摒弃X11/Wayland传统协议，独创SPI精简接口设计。支持窗口叠加渲染、多窗体共享/独享内存模式，代码体积小，具有高可移植性，适配各种嵌入式移动设备。
---
# TpWM
## 模块介绍

::: note TpWM 是 TinyPiXOS 的窗口管理引擎，是 TinyPiXOS 的核心支撑要件。整个引擎设计以精简接口为切入点，摒弃复杂冗余的接口设计理念，结合类似RISC精简指令集的设计思想，为窗口设计人员提供任意组装和拼接的高效途径，可以打造出千变万化的自定义产品。
:::

## 模块特点

1. 独立于传统的X11和Wayland协议，独创地采用了SPI（‌Streamlined Protocol Interface）思想提供精简的Api开发接口
2. 功能全面并支持窗口叠加渲染
3. 内存支持多窗体共享和多窗体独享模式，适配各种资源状态的移动设备
4. 纯C语言开发，具有强大的可以移植性和适配性
5. 提供多种显示接口，包括网络远程显示、模拟显示接口和物理屏幕独占显示
6. 底层采用插拔式驱动，可以根据平台的特点进行接入，以适应不同的硬件显示设备
7. 编译后代码体积小，一般不超过8M
8. 支持对同一个物理显示屏幕，逻辑出多个虚拟屏幕。虚拟屏幕彼此独立显示，并支持流畅切换

---

---
url: /intro/feedback/index.md
description: >-
  TinyPiXOS问题反馈与技术支持渠道。提交问题前请确认已使用最新版本验证，并建议先加入知识星球社区检索同类问题。如需官方技术支持，请通过开发者服务邮箱
  dev@tinypixos.com 与我们联系。
---
# 问题反馈
## 📝 提交前自查

::: tip
✅ 已在 [TinyPiXOS Issues](https://gitee.com/tinypixos/TinyPiXOS/issues)和[TinyPiXApp Issues](https://gitee.com/tinypixos/TinyPiXApp/issues)搜索过同类问题。\
✅ 使用最新版本进行验证后，问题仍然存在。\
✅ 在[知识星球](https://t.zsxq.com/4aezA)当中检索，但是未找到同类问题。\
:::

## 问题反馈渠道

### 知识星球反馈

::: important
如果您对项目很感兴趣，还未加入知识星球，我们建议您加入[知识星球](https://t.zsxq.com/4aezA)深度了解和学习TinyPiXOS开源项目，与星球众多伙伴共同交流进步。

🎁Star开源仓库&&关注微信公众号领取**优惠券**，加入[“TinyPiXOS开发者联盟”知识星球](https://t.zsxq.com/4aezA)。

:::

#### 通过星球查询历史问题回复和进行新问题反馈

![](https://file.tinypixos.com/tinypixos/20250707175310357_repeat_1751881992501__128722.png)

### 问卷表单反馈

#### 扫描二维码或者点击连接反馈问题

### GitHub/Gitee 反馈

#### TinyPiXOS 开源地址

#### TinyPiXApp 开源地址

### TinyPiXOS开发者服务邮箱

::ant-design:mail-outlined:: **技术支持：dev@tinypixos.com**

---

---
url: /intro/opensource/index.md
description: >-
  TinyPiXOS（派OS）核心框架现已开源！本项目基于Apache
  2.0协议，允许个人与企业免费商用（需保留界面标识），旨在汇聚开发者力量，共同打造自主可控的国产嵌入式操作系统生态基座。加入我们，参与从底层窗口管理到上层应用的全栈技术学习与共建。
---
# 开源说明
## 开源工程

TinyPiXOS 作为一款面向轻量化硬件平台的桌面操作系统，其架构设计复杂、功能模块众多。目前现有版本虽已实现基础能力，仍需要开发者社区的力量共同完善。我们选择将==核心框架开源，旨在汇聚开发者智慧，共同打造国产嵌入式操作系统生态基座。==

* 🛠️共建国产基座：以TpGUI等三大模块为基座，联合打造自主可控的嵌入式开发生态
* 🤝包容共创：现有版本难免存在不足，请以开发者视角包容反馈，共同优化
* 🚀创造无限可能：鼓励基于开源框架构建创新应用，优秀项目将获官方技术支持
* 🔄持续承诺：核心团队将长期维护系统桌面与应用生态，定期发布关键更新

## ✅ 开源地址

### TinyPiXOS 开源地址

### TinyPiXApp 开源地址

## 使用条款

### 免费商用

允许==个人和企业免费商用==，遵循 Apache 2.0 许可，保留界面标识。

::: note 界面标识释义
免费社区版需保留运行界面版权标识，去除标识需购买专业授权服务
:::

### 定制服务（可选）

### 严禁行为

* 技术手段破解/隐藏标识
* 用于违反国家安全领域

## 限时福利

::: tip star项目领取星球优惠券。
:::

:::: steps

1. star开源项目


   github 开源仓库



   gitee 开源仓库




2. 关注公众号


3. 获取优惠券
   1. 进入微信公众号
   2. 点击底部菜单“技术社区”
   3. 点击限时优惠

4. 领取优惠券加入知识星球，共同进步

   ::::

---

---
url: /intro/skill/index.md
description: >-
  加入TinyPiXOS开发者联盟，深度参与国产自主嵌入式操作系统的建设！这里提供从底层窗口管理器(TpWM)、GUI框架(TpGUI)到上层应用开发的完整技术栈学习与实践机会，助您实现从开发者到系统架构师的技能跃迁，共同打造嵌入式操作系统生态基座。
---
# 开发者社区
## TinyPiXOS开发者联盟

欢迎加入TinyPiXOS开发者联盟！这里是国内专注于自主可控嵌入式桌面操作系统开发的技术社区，涵盖完整的操作系统技术栈。

::: important star项目&&关注公众号领取星球优惠券！
:::

## ✅完整技术体系架构

* `窗口管理器`：TpWM纯C语言实现的轻量级窗口管理器，摒弃X11/Wayland传统方案
* `GUI框架开发`：TpGUI完整图形界面解决方案
* `系统集成能力`：TpExtUtils提供蓝牙、网络、多媒体、存储 等硬件抽象层
* `核心工具链`：TpUtils基础工具库，涵盖数据序列化、文件操作、通信机制
* `应用生态`：TinyPiXApp应用开发框架，提供完整的应用开发解决方案

## ✅多语言技术栈掌握

* `C语言系统编程`：深度掌握TpWM窗口管理器底层实现，理解系统调用和内存管理
* `C++面向对象开发`：精通TpGUI框架设计，掌握现代C++11标准和设计模式
* `跨平台构建`：支持x86\_64/ARM64多架构，掌握交叉编译技术

## ✅个人成长

* `系统架构师能力`：从窗口管理到应用框架的完整系统设计思维
* `嵌入式全栈开发`：从微型设备到高性能移动终端的全栈开发能力
* `图形界面编程`：事件驱动、渲染优化、样式系统等GUI开发核心技术
* `硬件抽象层开发`：显示管理、设备监控、蓝牙通信等底层驱动开发

## ✅能力提升

* `操作系统内核`：深入理解Linux内核机制，掌握轻量化改造技术
* `窗口系统开发`：学习现代窗口管理器设计原理和实现技巧
* `应用框架设计`：构建可扩展、高性能的应用开发框架
* `开源项目贡献`：参与多个相关开源项目，提升代码质量和协作能力

## ✅学习收获

通过体系化学习TinyPiXOS完整技术栈，==您将获得从底层窗口管理到上层应用开发的完整操作系统开发能力，实现从应用开发者到系统架构师的技能跃迁。== 我们提供阶梯式进阶路径，配备跨领域专家指导，助您构建多维度技术能力矩阵。

🤝加入我们，一起打造国产嵌入式操作系统生态基座！

## 🤩星球亮点

---

---
url: /intro/tinypixos/index.md
description: >-
  TinyPiXOS（派OS）是一款国产自主、轻量级的嵌入式移动设备桌面操作系统。它基于Linux内核，自主研发了TpWM窗口管理器与TpGUI框架，摒弃X11/Wayland，实现全链路技术可控。专为智能手机、工业平板、智能座舱等资源受限设备提供完整的图形桌面体验，免费商用并遵循Apache
  2.0协议。
---
# TinyPiXOS介绍
::: tip TinyPiXOS名称由来

**TinyPiXOS**（==又称：PiXOS，中文名：**派OS**，因其轻量化设计故在名称前增加了Tiny==）的命名，融合了我们的技术理念与产品愿景。

::: details 了解更多

* **​Tiny · 轻量化内核**​\
  “Tiny” 直指核心，表明这是一个专为资源受限的嵌入式环境打造的轻量级桌面操作系统。

* **​Pi · 永恒的基石**​\
  “Pi” 源自数学常数 ​π。它代表了系统所追求的永恒稳定性、运行可靠性以及如圆周率般普适的兼容性，立志成为嵌入式设备的坚实基石。

* ​**X · 无限的未来**​\
  “X” 象征着 ​未知与拓展​。这寓意着系统拥有无限的拓展性和未来可能性，鼓励开发者在此平台上自由探索与创造。

* **​PiX · 图形的世界**​\
  “PiX” 是Pi与X的自然结合，它巧妙地关联了英文单词“像素（Pixel）​”。系统具备现代图形桌面环境的能力。

* **​中文“派” · 开放与共创**​\
  中文名称“派”，既是“Pi”的音译，也蕴含着“开源分享”和“自成一派”的双重愿景。我们旨在构建一个开放、共享的开发者社区。

​总而言之，==TinyPiXOS（派OS） 旨在成为一个稳定、开放且具备友好图形界面的轻量化嵌入式操作系统，为开发者提供一个充满无限可能的创新平台==。​​

:::

## 系统介绍

TinyPiXOS以开源Linux为基础，通过创新的内核级轻量化改造与精简设计，==摒弃了X11/Wayland等传统图形方案=={.tip}，运用纯C/C++从底层重构出超轻量级的整体图形技术栈——包含高效窗口管理、精简GUI框架及深度优化的内核机制。

TinyPiXOS的诞生标志着我们从零起步，完成了基础技术栈的完整构建与自主掌控。其核心定位在于==提供一个独立可控、架构轻量且高度定制化的嵌入式桌面操作系统开发平台。==

核心目标：==在最小化硬件资源配置的前提下，确保流畅的多应用并行处理能力，提供完备的桌面级核心功能体验。=={.tip}

## 系统优势

* **自主可控**：自主研发窗口管理器==TpWM==与==GUI框架==，`不依赖X11/Wayland`。
* **轻量灵活**：模块化架构按需裁剪，内存与进程调度优化，资源极致利用，从微型嵌入式设备到高性能移动终端均可灵活部署。
* **异构兼容**：统一C/C++开发接口，ARM/x86/RISC-V多平台无缝迁移。
* **开箱即用**：预置UI组件库，方便用户快速上手开发应用。
* **长期维护**：技术团队长期维护，不用担心遇到问题导致项目无法推动。
* **中文支持**：==系统内文字中文支持友好==。
* **免费商用**：免费商用（需保留版权标识），企业可低成本构建定制化系统，支撑产品快速落地。

## 为什么要造“轮子”？

在 ==“信创”战略=={.default} 引领下，国产操作系统正加速构建从芯片到软件的全面==自主可控生态=={.default}。银河麒麟V10、HarmonyOS 等代表系统，依托开源协作与自主知识产权布局，逐步实现对 Windows、Android 等国外产品的替代。新一代数字办公白皮书指出，国产软硬件生态整合是实现数据安全的关键环节。目前除 HarmonyOS 已覆盖移动端外，其他国产操作系统主要聚焦于 PC 桌面领域，在==嵌入式移动设备的桌面操作系统=={.default}方面布局尚显不足。

为填补这一领域空白，“TinyPiXOS”技术团队希望发挥专业所长，==自主研发一款轻量级移动设备桌面操作系统=={.default}。此举旨在==抛砖引玉，助推国产操作系统生态多元化发展，期待未来呈现“百家争鸣”的繁荣局面。=={.default}

## 我们做了什么？

### 核心模块自主研发

为了能够实现全链路自主可控，自研TinyPiXOS核心模块：


自主研发窗口管理器，支持多应用并行运行，拥有对窗口管理机制的完全掌控权，可以根据用户的实际需求进行定制和优化。


对基础API进行了封装，可以提供一些比较成熟的特性，比如共享内存、定时器、多线程、绘制函数等功能。


对基础API进行了封装，提供网络、蓝牙、音频、视频等功能。


GUI框架，参考QT架构进行设计和实现，便于开发人员上手使用。提供常用组件，包括按钮、复选框、输入框等。



![TinyPiXOS整体架构图](https://file.tinypixos.com/tinypixos/TinyPIXOS架构图_repeat_1761558569633__596014.jpg)

### GUI桌面系统交互设计和开发

::: tip 为了验证各项基础模块的功能，我们基于自研模块设计并开发了桌面交互示例系统，该系统初步实现桌面交互能力、多应用管理能力、应用安装和卸载能力等，开发者在此基础上可以扩展和开发自己的桌面操作系统。
:::

我们参考主流桌面系统的应用打包规范，初步设计实现了TinyPiXOS的应用打包要求，已经初步开发完成的应用有【系统桌面】、【多应用管理】、【文件管理器】、【媒体播放器】、【系统输入法】、【设置】（完成了框架）。  `示例应用`

## 适用场景

TinyPiXOS是面向轻量级嵌入式移动终端设备（如智能手机、平板电脑、便携式工业终端等）设计的综合性操作系统。其核心特征在于通过‌嵌入式架构‌与‌轻量化设计‌的深度融合，实现对硬件资源的高效利用，同时提供完整的桌面级交互体验‌。适用于以下场景使用：

1. ​定制化移动设备操作系统​（智能终端/工业平板）
2. ​云桌面虚拟化终端显示系统​
3. ​工业控制平台人机交互界面​（HMI）
4. ​智能座舱车载信息娱乐系统​（IVI）
5. ​物联网中枢控制终端​（智能家居网关/边缘计算节点）

::: tip
其他场景持续扩展中...（我们开放架构文档供生态验证）\
(更多场景等待大家解锁......)
:::

## 开源工程

TinyPiXOS允许==个人和企业免费商用==，遵循 Apache 2.0 许可，保留界面标识。

## 关于TinyPiXOS开发者联盟

::: important 国内专注于自主可控嵌入式桌面操作系统开发的技术社区，涵盖完整的操作系统技术栈。

### ✅完整技术体系架构

* `窗口管理器`：TpWM纯C语言实现的轻量级窗口管理器，摒弃X11/Wayland传统方案
* `GUI框架开发`：TpGUI完整图形界面解决方案
* `系统集成能力`：TpExtUtils提供蓝牙、网络、多媒体、存储 等硬件抽象层
* `核心工具链`：TpUtils基础工具库，涵盖数据序列化、文件操作、通信机制
* `应用生态`：TinyPiXApp应用开发框架，提供完整的应用开发解决方案

### ✅多语言技术栈掌握

* `C语言系统编程`：深度掌握TpWM窗口管理器底层实现，理解系统调用和内存管理
* `C++面向对象开发`：精通TpGUI框架设计，掌握现代C++11标准和设计模式
* `跨平台构建`：支持x86\_64/ARM64多架构，掌握交叉编译技术

### ✅个人成长

* `系统架构师能力`：从窗口管理到应用框架的完整系统设计思维
* `嵌入式全栈开发`：从微型设备到高性能移动终端的全栈开发能力
* `图形界面编程`：事件驱动、渲染优化、样式系统等GUI开发核心技术
* `硬件抽象层开发`：显示管理、设备监控、蓝牙通信等底层驱动开发

### ✅能力提升

* `操作系统内核`：深入理解Linux内核机制，掌握轻量化改造技术
* `窗口系统开发`：学习现代窗口管理器设计原理和实现技巧
* `应用框架设计`：构建可扩展、高性能的应用开发框架
* `开源项目贡献`：参与多个相关开源项目，提升代码质量和协作能力

### ✅学习收获

通过体系化学习TinyPiXOS完整技术栈，==您将获得从底层窗口管理到上层应用开发的完整操作系统开发能力，实现从应用开发者到系统架构师的技能跃迁。== 我们提供阶梯式进阶路径，配备跨领域专家指导，助您构建多维度技术能力矩阵。

:::

## 请关注和star为项目助力

### 扫描二维码或者点击链接访问

::: flex center



:::

## 视频介绍

@[bilibili](BV1dzuPzyEqJ)

---

---
url: /pub/中文公告.md
---
# 
::: important V0.2.1 更新上线！

本次升级修复了已知问题，详情请查看更新日志。

:::

![TinyPiXOS开发者联盟](https://file.tinypixos.com/tinypixos/官网二维码.png)

欢迎加入[TinyPiXOS开发者联盟](https://t.zsxq.com/JzbkN)！这里是国内专注于自主可控嵌入式桌面操作系统开发的技术社区，涵盖完整的操作系统技术栈。

::: tip star项目&&关注公众号领取星球优惠券！
:::

#### ✅完整技术体系架构

* `窗口管理器`：TpWM纯C语言实现的轻量级窗口管理器，摒弃X11/Wayland传统方案
* `GUI框架开发`：TpGUI完整图形界面解决方案
* `系统集成能力`：TpExtUtils提供蓝牙、网络、多媒体、存储 等硬件抽象层
* `核心工具链`：TpUtils基础工具库，涵盖数据序列化、文件操作、通信机制
* `应用生态`：TinyPiXApp应用开发框架，提供完整的应用开发解决方案

#### ✅多语言技术栈掌握

* `C语言系统编程`：深度掌握TpWM窗口管理器底层实现，理解系统调用和内存管理
* `C++面向对象开发`：精通TpGUI框架设计，掌握现代C++11标准和设计模式
* `跨平台构建`：支持x86\_64/ARM64多架构，掌握交叉编译技术

#### ✅个人成长

* `系统架构师能力`：从窗口管理到应用框架的完整系统设计思维
* `嵌入式全栈开发`：从微型设备到高性能移动终端的全栈开发能力
* `图形界面编程`：事件驱动、渲染优化、样式系统等GUI开发核心技术
* `硬件抽象层开发`：显示管理、设备监控、蓝牙通信等底层驱动开发

#### ✅能力提升

* `操作系统内核`：深入理解Linux内核机制，掌握轻量化改造技术
* `窗口系统开发`：学习现代窗口管理器设计原理和实现技巧
* `应用框架设计`：构建可扩展、高性能的应用开发框架
* `开源项目贡献`：参与多个相关开源项目，提升代码质量和协作能力

#### ✅学习收获

通过体系化学习TinyPiXOS完整技术栈，==您将获得从底层窗口管理到上层应用开发的完整操作系统开发能力，实现从应用开发者到系统架构师的技能跃迁。== 我们提供阶梯式进阶路径，配备跨领域专家指导，助您构建多维度技术能力矩阵。

***

🤝加入我们，一起打造国产嵌入式操作系统生态基座！

---

---
url: /sponsor/index.md
---
# 支持作者
::: important 支持作者
TinyPiXOS是一款国产自主轻量级嵌入式设备桌面操作系统！

TinyPiXOS的诞生标志着我们从零起步，完成了基础技术栈的完整构建与自主掌控。其核心定位在于提供一个独立可控、架构轻量且高度定制化的嵌入式桌面操作系统开发平台。

如果觉得项目还不错，欢迎通过 [Star](https://gitee.com/tinypixos/TinyPiXOS) 支持。

我们将会持续迭代和维护它，但持续维护需要花费大量的精力、时间和费用投入，希望能得到您的支持！

:::

| ::bi:alipay:: AliPay                   | ::fa:wechat:: WeChat                      |
| :------------------------------------: | :---------------------------------------: |
| ![Alipay](https://file.tinypixos.com/tinypixos/alipay_repeat_1761559823489__581551.jpg){width="300" height="300"} | ![WeChat](https://file.tinypixos.com/tinypixos/wechat_repeat_1761559773374__399982.jpg){width="300" height="300"} |

## 打赏记录

感谢大家对项目的大力支持！

| 昵称 | 日期       |   金额 | 备注                                           |
| ---- | ---------- | -----: | ---------------------------------------------- |
| 王\*昌 | 2025-09-03 |   5.00 | 支持下作者，加油！                             |
| 匿名 | 2025-11-15 |   10.00 | 支持，加油！                             |