FairEmail Pro 桌面小部件（Widget）配置与使用
什么是 FairEmail 小部件
FairEmail Pro 提供了一个 Android 桌面小部件——你不需要打开 FairEmail App，直接在手机桌面上就能看到最新邮件的发件人和主题。
小部件是 Pro 专属功能，免费版没有。
小部件能做什么
FairEmail 小部件的功能设计很直接：
- 显示你选定的某个账户 / 文件夹中最新的 N 封邮件（数量可以配置）
- 每封邮件显示：发件人名称、邮件主题、是否未读（小红点或粗体）、账户颜色标识
- 点击小部件上的某封邮件 → 直接打开 FairEmail 跳到该邮件
- 点击小部件空白区域 → 打开 FairEmail 的主界面
小部件不会显示：邮件正文内容、附件缩略图、远程图片预览。它的定位是邮件摘要列表，让你快速扫一眼有哪些新邮件，而不是完整阅读。
如何添加小部件到桌面
添加 Android 桌面小部件的通用方法：
原生 Android（Pixel 等）
- 在手机桌面长按空白区域
- 弹出菜单选择「小部件」（Widgets）
- 在小部件列表中找到「FairEmail」
- 长按 FairEmail 小部件图标，拖到桌面的目标位置
- FairEmail 会弹出配置界面：选择哪个账户、哪个文件夹、显示多少封邮件
- 配置完成后保存
三星 / 小米 / OPPO 等定制 ROM
这些厂商的小部件添加路径类似但措辞可能不同，通常是：桌面长按空白 → 小部件 / 小组件 → 找到 FairEmail → 拖到桌面。
FairEmail 小部件在小部件列表中的名称通常是「FairEmail」或「FairEmail - 消息列表」。
小部件配置选项
添加小部件到桌面后（或长按已有小部件选择「编辑」），FairEmail 会提供以下配置：
选择账户
- 选择你要显示哪个邮箱账户的邮件
- 「所有账户（统一收件箱）」也可以选
选择文件夹
- 收件箱、归档文件夹、已加星标等任意服务器文件夹
- 或 FairEmail 本地文件夹
显示邮件数量
- 最多可以显示 10 封邮件
- 根据小部件在桌面上占用的空间，FairEmail 会自动显示尽可能多的邮件
背景颜色
FairEmail 小部件的背景可以独立设置：
- 跟随系统：使用 Android Material You 动态颜色
- 透明：背景透明，完全透出桌面壁纸
- 不透明：使用 FairEmail 当前主题的背景色
- 自定义颜色：从 FairEmail 调色板中选一个颜色
账户颜色显示
小部件中每封邮件左侧的颜色竖条是否显示账户颜色标识（和消息列表中的一致）。
小部件尺寸和布局
FairEmail 小部件会根据你在桌面上拖放的大小自动调整：
- 小尺寸：显示 2~3 封邮件，发件人 + 主题各一行
- 中尺寸：显示 4~6 封邮件，发件人 + 主题各一行
- 大尺寸：显示 7~10 封邮件，可能增加预览文本（可选）
你可以随时长按桌面小部件 → 拖动边框调整大小 → FairEmail 自动重新布局。
小部件数据刷新机制
小部件的数据不是实时推送的——Android 系统限制小部件的刷新频率。FairEmail 小部件的刷新机制：
- 当 FairEmail App 在前台运行时 → 小部件数据实时同步
- 当 FairEmail App 在后台时 → 小部件每 30 分钟 左右自动刷新一次
- 当 FairEmail App 被系统杀掉后 → 小部件可能停止刷新，直到 FairEmail 被重新打开
这是 Android 小部件框架的限制，不是 FairEmail 特有问题。Gmail、Outlook 等 App 的小部件也遵循同样的规则。
Material You 动态颜色（Android 12+）
在 Android 12 及以上版本，FairEmail 小部件可以跟随系统 Material You 动态颜色——你换手机壁纸时，小部件的颜色会自动适配新壁纸的主色调。这个效果只有在「背景颜色」设置为「跟随系统」时才生效。
常见问题
小部件不显示
首先确认：
- 你用的是 FairEmail Pro 解锁版（免费版没有小部件）
- Android 系统设置 → 应用 → FairEmail → 「显示在其他应用上方」权限已授予（部分 ROM 需要）
- FairEmail 没有被 Android 电池优化器设置为「深度睡眠」
小部件显示空白
小部件需要 FairEmail 至少运行一次才能获取数据。如果是刚安装完 FairEmail 还没打开过就添加小部件，可能显示空白。先打开 FairEmail App 让它同步一次，小部件就有数据了。
换手机后小部件不迁移
Android 桌面小部件不会通过系统的「换机」功能自动迁移——你需要在新手机上手动重新添加 FairEmail 小部件并配置。FairEmail 的账户配置可以通过「导出设置 → 导入设置」迁移，但小部件本身是桌面层的东西，需要手动重建。
和通知的配合
FairEmail 的消息通知和桌面小部件是两套互补机制：
- 通知：新邮件到达时立即弹出，适合需要即时提醒的场景
- 小部件：持续显示在桌面上的邮件摘要列表，适合想随时浏览但不想被弹窗打扰的场景
建议同时使用两者——通知开着、小部件放在桌面，效果最好。