Solution目录结构

主目录组成

Solution 软件的主目录核心分为 SDK 和 Solution 两个子目录，二者分工明确，共同支撑开发流程，具体说明如下：

基于 SDK 2.X 稳定版本构建，仅在以下必要场景随 Solution 版本同步更新，避免频繁变更影响稳定性：

Solution 开发的核心目录，包含从框架到工具、从组件到例程的完整开发资源，支持客户按需选用组件，快速搭建产品并推进量产。目录结构如下图所示

Solution 子目录是开发核心目录，包含 framework（主框架）、components（组件库）、examples（示例工程）、tools（开发工具） 四大核心模块，各模块功能、目录组织及使用逻辑如下：

提供 Solution 运行的底层核心框架，涵盖 UI 调度、基础组件、系统服务及板级配置模板，是所有应用开发的“地基”，确保功能兼容性与稳定性。

子目录/文件	功能说明
`gui_fwk`	UI 调度主框架：负责应用间调度切换、应用内页面管理、动画效果（如过渡动画、滑动动效）调度，保障 UI 操作流畅度。
`gui_widget`	基础 UI 组件库：封装按钮、列表、图表、弹窗、进度条等常用控件，支持自定义样式（如颜色、字体）与交互逻辑（如点击、滑动事件），可直接调用。
`service`	系统服务层，向上提供统一调用接口。包括IPC通信机制、线程、多语言、flashdb、内存管理、动态应用机制、电池管理、button、低功耗等服务
`__template__`	板级配置模板目录：存放每个板级相关的配置文件，包括： - flash 分区表（`flash_map.xlsx`） - 链接脚本（`link_flash.sct`） - 外设初始化配置（`msp.c`）工程相关的模版

配置加载逻辑：ButterFli 开发工具选择板级配置时，会自动载入 __template__ 下的文件初始化工程，无需手动复制；
文件修改规则：若需调整 flash 分区、链接地址、外设参数，必须直接修改 __template__ 下的对应文件——若修改 HCPU/LCPU/Simulator 目录下的同名文件，编译时会被模板文件覆盖，导致修改失效。

提供解耦式功能组件，覆盖通信、硬件适配、系统服务等场景，组件间独立无强依赖，支持按需集成，灵活搭建产品功能，避免冗余代码，降低开发与维护成本。

包含产品例程，覆盖新手入门到量产参考的需求，代码注释清晰，可直接参考复用，降低学习与开发成本。

子目录名称	工程类型	功能说明
`_app_demo`	通用组件demo	展示单个组件的基础用法，目前持续补充完善，适合新手学习组件调用。
`_dynamic_app`	动态应用示例	动态应用/表盘开发示例，支持 3 种开发方式： - 编程语言：C、QJS、MicroPython； - 可视化工具：GUI_Builder 零编程开发； - 加载控制：通过目录下 `readme.ini` 配置生效宏与分辨率，控制 ButterFli 是否加载。
`_app_tool_simu`	GUI 仿真工程	仅用于 GUI_Builder 工具的 PC 仿真：根据用户设置分辨率、色深参数，生成匹配的仿真工程，确保 PC 端预览效果与板级实际显示一致。
`watch`	手表板级工程	手表类产品例程，包含蜂窝菜单、平铺界面、表盘框架三大核心能力，可直接作为智能手表开发的基础工程。
`gride_view`	宫格板级工程	极简宫格菜单工程，无平铺和表盘框架，适合简易智能终端。
`container`	单应用板级工程	无默认应用的“空框架”工程：烧录后开机黑屏（日志正常），需通过手机 APP 或串口推送应用，快速搭建定制化产品。注意，container没有内置setting的应用，因此设计时只支持一个单应用（推送时会删除前一个应用）
`hello_world`	基础入门工程	最简单的应用示例，演示如何基于 Solution 框架创建应用（如显示文本、绑定点击事件），适合新手入门框架逻辑。

每个不带下划线的板级工程（如 watch、gride_view、container），内部按“功能模块”标准化组织，方便定位代码，典型结构如下：
（包含 application（应用代码）、project（工程）、resource（资源）等子目录）

提供 Solution 开发全流程所需的开发辅助工具与产线工具，覆盖“开发-调试-量产”各环节，提升效率并保障量产稳定性。