Flutter 实现 iOS 小组件与主 App 的通信

前言

在 Flutter 项目中实现 iOS 小组件与主 App 的通信,主要依赖于 App Groups 技术,以下是具体实现步骤和注意事项。

配置 App Groups

在 Xcode中为 Flutter 主应用(Runner)和 Widget Extension 配置相同的App Group 标识符(如 group.com .company.myApp)。

  1. 操作路径:项目的 Signing & Capabilities→ 添加App Groups → 输入唯一标识符
  2. 需确保主应用和小组件扩展的 Bundle Identifier 均属于同一开发者账号,否则无法启用 App Groups

UserDefaults 数据共享

Flutter 端

通过 home_widget 插件设置 App Group ID 并保存数据:

  1. 安装 home_widget 插件

    flutter pub add home_widget

  2. 使用
    home_widget插件官方使用文档

    HomeWidget.setAppGroupId('group.com.company.myApp'); // 初始化
    HomeWidget.saveWidgetData('key', 'value'); // 保存数据

iOS 原生端 (小组件)

通过 UserDefaults(suiteName:) 读取数据:

复制代码
 let sharedDefaults = UserDefaults(suiteName: "group.com.company.myApp")
 let value = sharedDefaults?.string(forKey: "key") ?? ""

主动刷新小组件

主动刷新 iOS 小组件

复制代码
  HomeWidget.updateWidget(
      iOSName: 'TikuWidget',
    );

结语

通过 App Group 和 home_widget 插件 我们就轻松实现了 Flutter 项目中的 iOS 小组件与主 App 的通信。


感谢您的阅读和参与,HH思无邪愿与您一起在技术的道路上不断探索。如果您喜欢这篇文章,不妨留下您宝贵的赞!如果您对文章有任何疑问或建议,欢迎在评论区留言,我会第一时间处理,您的支持是我前行的动力,愿我们都能成为更好的自己!

相关推荐
大龄秃头程序员3 小时前
一次 Flutter 动画 Demo 的整理与复盘
flutter
2501_916007474 小时前
Bundle ID 注册与管理 App ID 创建指南 命名规则 权限开关与删除注意事项
android·ios·小程序·https·uni-app·iphone·webview
AlexMaybeBot6 小时前
躺在沙发上开发 Openclaw 的移动端APP
前端·flutter
天空之城--7 小时前
Android Flutter行业动态与学习参考(2026年8月)
android·flutter
FungLeo8 小时前
Flutter Web token 存储陷阱:crypto.subtle 在非安全上下文失效排查实录
前端·安全·flutter
FungLeo8 小时前
Flutter Web 中文字体困境与渲染器选择:CanvasKit vs HTML renderer 实战
前端·flutter·html
杉氧9 小时前
原生交互:如何在 Flutter 中嵌入 Android/iOS 原生组件并解决手势冲突
android·flutter·dart
恋猫de小郭10 小时前
Flutter iOS Deep Link 为什么会突然失效:一系列难以言喻的问题
android·前端·flutter
2501_9159090611 小时前
iOS 证书创建与管理 类型限制 p12 密码与云备份实操
android·ios·小程序·https·uni-app·iphone·webview
00后程序员张12 小时前
有没有更轻量的 iOS 开发环境?快蝎kxapp轻量化路径与构成
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程