很多 Flutter 项目做完鸿蒙适配之后，依然停留在"能安装、能打开、能用几个系统 API"的阶段。但真正会被人记住的鸿蒙项目，往往不是因为它能跑，而是因为它真的长出了鸿蒙系统入口。食界探味当前已经补上了主图标启动、Intent 页面直达、桌面卡片、防窥保护、语音识别、TTS 等多种系统能力。本文做一个阶段性收束，讲清楚一个 Flutter 项目要想被 HarmonyOS 系统真正理解，至少应该

很多 Flutter 项目做完鸿蒙适配之后，依然停留在"能安装、能打开、能用几个系统 API"的阶段。但真正会被人记住的鸿蒙项目，往往不是因为它能跑，而是因为它真的长出了鸿蒙系统入口。食界探味当前已经补上了主图标启动、Intent 页面直达、桌面卡片、防窥保护、语音识别、TTS 等多种系统能力。本文做一个阶段性收束，讲清楚一个 Flutter 项目要想被 HarmonyOS 系统真正理解，至少应该

鸿蒙系统入口类能力最容易忽略的一个问题，是入口请求往往来得比 Flutter 引擎更早。也就是说，原生层已经拿到了 pageId，但 Flutter 路由系统还没初始化完成。食界探味当前通过 IntentNavigationPlugin 里的 pendingNavigation 解决了这个问题，同时在 EntryAbility 的 onCreate 和 onNewWant 中也做了缓存处理。本文聚

鸿蒙系统入口类能力最容易忽略的一个问题，是入口请求往往来得比 Flutter 引擎更早。也就是说，原生层已经拿到了 pageId，但 Flutter 路由系统还没初始化完成。食界探味当前通过 IntentNavigationPlugin 里的 pendingNavigation 解决了这个问题，同时在 EntryAbility 的 onCreate 和 onNewWant 中也做了缓存处理。本文聚

Intents Kit 真正有价值的地方，不在于"我也能跳页面"，而在于鸿蒙系统能不能真的理解你定义的入口。insight_intent.json 写得随意，最后就会变成系统看不懂、维护也困难的配置。食界探味当前的配置已经给出了一套很清楚的思路：定义稳定 intent 名称、明确输入参数、用 enum 限定可选页面，并补充展示名、关键词和描述。本文逐行拆解这份配置，讲清楚鸿蒙 insight_in

Intents Kit 真正有价值的地方，不在于"我也能跳页面"，而在于鸿蒙系统能不能真的理解你定义的入口。insight_intent.json 写得随意，最后就会变成系统看不懂、维护也困难的配置。食界探味当前的配置已经给出了一套很清楚的思路：定义稳定 intent 名称、明确输入参数、用 enum 限定可选页面，并补充展示名、关键词和描述。本文逐行拆解这份配置，讲清楚鸿蒙 insight_in

很多 Flutter 开发者第一次接鸿蒙桌面卡片时，最担心的是：一旦开始写卡片，会不会把整个项目结构搞乱。食界探味当前的做法提供了一个很清楚的参考：卡片相关逻辑全部收在 app/ohos 下的 formability、资源配置和 widget 页面里，Flutter 主业务工程几乎不需要为了卡片改动结构。本文从目录结构、职责划分、接入步骤三个层面，讲清楚这种"壳工程增量接入"的思路。

很多 Flutter 开发者第一次接鸿蒙桌面卡片时，最担心的是：一旦开始写卡片，会不会把整个项目结构搞乱。食界探味当前的做法提供了一个很清楚的参考：卡片相关逻辑全部收在 app/ohos 下的 formability、资源配置和 widget 页面里，Flutter 主业务工程几乎不需要为了卡片改动结构。本文从目录结构、职责划分、接入步骤三个层面，讲清楚这种"壳工程增量接入"的思路。

很多鸿蒙卡片教程都把重点放在 Ability 和 UI 上，但真正决定卡片能不能长期维护的，往往是数据层怎么组织。食界探味把每日推荐卡片的数据单独收进了 RecommendData.ets，由它负责推荐列表、兜底项、图片资源校验和"今日选择"逻辑。这个设计非常值得单独拆出来讲，因为它把鸿蒙卡片 Ability 从内容数据中解耦了。本文逐行拆解这个数据层的设计思路，以及它为什么值得在鸿蒙项目中复用。

很多鸿蒙卡片教程都把重点放在 Ability 和 UI 上，但真正决定卡片能不能长期维护的，往往是数据层怎么组织。食界探味把每日推荐卡片的数据单独收进了 RecommendData.ets，由它负责推荐列表、兜底项、图片资源校验和"今日选择"逻辑。这个设计非常值得单独拆出来讲，因为它把鸿蒙卡片 Ability 从内容数据中解耦了。本文逐行拆解这个数据层的设计思路，以及它为什么值得在鸿蒙项目中复用。