如何使用 PicoPixel 模板、UI 套件和完整应用

什么是模板？

PicoPixel 模板就是一个普通的 .picopixel 文件，与从自己工作区导出的文件格式相同。

模板可以包含屏幕、LVGL 控件、可复用组件、颜色、字体、图片、动画图片、精灵及其他资源。打开或导入后，你可以自由修改：精简内容、复制部分设计到其他文件、发布为团队资源库，或导出 LVGL C 代码。

在哪里找到模板？

在 PicoPixel 模板库中，可以按项目类型筛选、打开详情页并查看预览，然后选择合适的方式导入 PicoPixel。

同一批文件也可以在 GitHub 上找到：

• PicoPixelio/picopixel-files

如果你习惯直接下载文件、查看修改记录，或将 .picopixel 文件与其他项目资源一起管理，可以使用 GitHub。

选择适合的项目类型

模板库提供多种类型，可根据需要选择：

• Full App（完整应用）：完整的应用项目。未来可能有更多项目附带固件文件，便于直接烧录。目前请先打开界面文件，按需修改，再导出 UI 代码并集成到自己的固件中。
• Example（示例）：围绕某种操作流程、控件、布局或交互方式展开的参考项目。
• UI Kit（UI 套件）：一组可复用的组件、样式、屏幕和资源，可以调整后用于不同产品。
• Template（模板）：已经设计好的屏幕或项目布局，修改后即可用于自己的界面。
• Sprite（精灵）：包含多种动画状态的可复用 LVGL 控件。详见什么是精灵？。
• Animated Image（动画图片）：展示 LVGL 图片帧动画的文件或示例。详见使用 LVGL 动画图片控件。
• Widget（控件）：可加入其他界面的自定义 LVGL 控件或组件。

想学习某种交互，用示例；想复用一组组件，用 UI 套件；想找一个接近目标的现成界面，用模板。

打开或导入文件

在模板库中点击项目，即可进入详情页，查看预览、项目信息、展示图片和操作按钮。

常用的导入方式有三种：

1. 点击 Open in PicoPixel，直接在编辑器中打开，最方便快捷。
2. 点击 Download .picopixel，下载到本地，方便稍后导入、备份，或与固件项目一起分享。
3. 从 GitHub 下载 .picopixel 文件，然后拖入 PicoPixel，或通过编辑器的导入功能打开。

导入后，它与普通 PicoPixel 项目一样，可以重命名、复制、编辑屏幕、替换资源、修改字体和颜色，并在完成后导出代码。

复用模板中的内容

你可以把整个模板作为项目起点，也可以只取用其中需要的部分。

很多文件包含图片、颜色、字体、动画帧组和组件等可复用资源。在 Assets 标签中可以查看这些内容。

如果模板包含可复用控件或组件，可以将它发布为团队资源库，再从其他文件中关联使用。这尤其适合 UI 套件和控件合集：保留一份源文件，其他产品界面都从这份库中取用组件。

完整操作请参阅PicoPixel 资源库与可复用组件指南，其中介绍了本地库、团队共享库、关联资源库，以及如何在文件之间同步组件更新。

导出到设备

界面完成后，从 PicoPixel 导出 LVGL C 代码，并集成到开发板固件中。只要固件和 LVGL 已为所用控件及资源配置好，导出的界面就能用于几乎任何支持 LVGL 的设备。

请注意设备容量。大图片、多帧动画、精灵、大字体和复杂的全屏布局，可能超出小型开发板默认配置的 RAM 或 Flash 容量。如果编辑器预览正常，烧录后却无法显示，请检查 LVGL 配置、图片尺寸、色深、堆内存和显示缓冲区设置。

分享与使用权限

社区模板来自 PicoPixel 团队和用户。如果想分享自己的文件，请按照模板提交指南操作，提供文件位置、作者署名、描述和授权信息，供团队审核。

提交或导入内容前，请查看服务条款和隐私政策。只提交自己拥有或已获准分享的内容，包括图片、图标、字体、截图和品牌素材。

如果发现公开模板或其他社区内容存在问题，请参阅如何举报内容。

下一步

• 模板库：浏览可用的 .picopixel 项目。
• 如何提交模板：与社区分享自己的作品。
• 资源库与可复用组件指南：跨文件复用导入的组件。
• 什么是精灵？：了解多状态动画控件。
• 使用 LVGL 动画图片控件：了解逐帧动画。