4. 大文本样式通知：BigTextStyle 实现、行数控制、响应式布局适配

4.1 原理概述

BigTextStyle 是 Android NotificationCompat 提供的一种展开式通知样式，允许在通知详情区域显示大段文本内容。与普通通知只能显示一行标题和一行正文不同，BigTextStyle 在用户展开通知后可以呈现数十字乃至数百字的完整信息，适用于消息预览、邮件摘要、日志详情等场景。

在 Material 3 设计语言下，BigTextStyle 通知继承了动态颜色（Dynamic Colors）、大圆角（24 dp 以上）、更大字号标题和 elevation 阴影等视觉特征。系统会根据用户的壁纸主题自动调整通知背景色和文字色，确保大文本区域在高对比度下依然可读。

4.2 核心 API 与参数

BigTextStyle 的核心 API 集中在 NotificationCompat.BigTextStyle 类中，配合 NotificationCompat.Builder 使用。下表中列出最常用的方法及其行为：

4.3 实现流程

整个 BigTextStyle 通知的实现包含 6 个关键阶段，从触发事件到最终渲染。下面流程图展示了各阶段的依赖关系和数据流向：

1. 触发通知事件：后台任务、用户操作或系统广播产生通知需求。
2. 构建 Builder：使用 NotificationCompat.Builder 设置渠道 ID、小图标、优先级等基础属性。
3. 应用 BigTextStyle：创建 BigTextStyle 实例并关联到 Builder。
4. 配置文本 & 行数策略：写入大文本内容，并根据目标设备选择行数控制方式。
5. 系统渲染通知：系统按 Material 3 主题渲染折叠/展开视图。
6. 折叠 / 展开交互：用户手势切换状态，系统自动适配各密度屏幕。

4.4 完整代码实现

以下 Kotlin 代码展示在 Android 13 (API 33) 上创建一个 BigTextStyle 通知，包含 Material 3 动态颜色适配：

// 1. 创建通知渠道（Android 8.0+ 必需）
val channel = NotificationChannel(
    "channel_big_text",
    "大文本通知",
    NotificationManager.IMPORTANCE_HIGH
).apply {
    description = "用于展示 BigTextStyle 长文本消息"
}
val notificationManager = getSystemService(NotificationManager::class.java)
notificationManager.createNotificationChannel(channel)

// 2. 构建 BigTextStyle
val bigTextStyle = NotificationCompat.BigTextStyle()
    .setBigContentTitle("📄 项目周报 · 第 12 期")
    .bigText("""本周主要完成了以下工作：\n\n
        1. 完成了用户模块的接口重构，响应时间降低了 35%；\n
        2. 修复了推送服务在低端机上的内存泄漏问题；\n
        3. 更新了 Material 3 主题配色，统一了通知圆角半径。\n\n
        下一步计划：集成 BigTextStyle 通知样式，优化长文本阅读体验。""")
    .setSummaryText("点击展开查看完整周报")

// 3. 构建通知
val notification = NotificationCompat.Builder(this, "channel_big_text")
    .setSmallIcon(R.drawable.ic_notification)
    .setContentTitle("项目周报 · 第 12 期")   // 折叠状态标题
    .setContentText("本周主要完成了接口重构...") // 折叠状态正文
    .setStyle(bigTextStyle)                   // 关键：关联 BigTextStyle
    .setColor(ContextCompat.getColor(this, R.color.m3_dynamic_primary))
    .setAutoCancel(true)
    .build()

// 4. 发送通知
notificationManager.notify(1001, notification)

4.5 行数控制策略

由于系统默认 BigTextStyle 模板中 TextView 的行数由可用高度自适应，直接调用 setMaxLines() 无效。实际项目中有三种可行策略：

推荐优先使用文本长度截断 + 换行符分段组合方案。示例：

fun truncateBigText(original: String, maxChars: Int = 800): String {
    return if (original.length > maxChars) {
        original.take(maxChars) + "…"
    } else {
        original
    }
}

val bigTextStyle = NotificationCompat.BigTextStyle()
    .setBigContentTitle("日志详情")
    .bigText(truncateBigText(logContent, 800))
    .setSummaryText("${logContent.length} 字符 · 点击展开")

4.6 响应式布局适配

BigTextStyle 通知在不同设备上呈现的视觉行数受三个因素影响：屏幕密度、系统字体缩放、通知栏可用宽度（折叠/展开状态）。适配策略如下：

• 密度无关缩放：使用 sp 单位，系统自动根据 density 缩放字号；避免在 bigText() 中传入带固定 px 的 Spannable。
• 字体缩放兼容：测试时在开发者选项中切换“最小宽度”和“字体大小”为最大/最小，确保文本不截断失效。
• 折叠状态摘要：setSummaryText() 内容控制在 60 字符以内，避免折叠时被系统截断为“⋯”。
• RLT / 国际化：从右向左语言（阿拉伯语、希伯来语）下，BigTextStyle 自动镜像布局，无需额外代码。

4.7 调试与验证

调试 BigTextStyle 通知时，使用以下工具和方法可以快速定位问题：

1. adb 命令强制展开通知：adb shell cmd notification allow_private_notifications 和 adb shell dumpsys notification 查看通知摘要。
2. Android Studio 通知预览器：在 tools:targetApi="33" 布局中预览 BigTextStyle 模板。
3. 单元测试 NotificationCompat：断言 notification.extras.getString(Notification.EXTRA_BIG_TEXT) 包含预期文本。
4. 日志关键节点：在 notify() 前后打印通知 ID 和 BigTextStyle 文本长度。

// 单元测试示例 (JUnit + Robolectric)
@Test
fun bigTextStyle_containsExpectedContent() {
    val notification = buildBigTextNotification()
    val bigText = notification.extras.getCharSequence(Notification.EXTRA_BIG_TEXT).toString()
    assertThat(bigText).contains("项目周报")
    assertThat(bigText.length).isLessThan(1000)
}

4.8 常见错误与解决方案

4.9 性能与稳定性优化

大文本通知如果使用不当，可能引起 UI 线程卡顿或内存抖动。以下优化措施已在生产环境中验证有效：

• 异步构建：在后台线程（如 Kotlin 协程 Dispatchers.IO）中拼接文本和构建 BigTextStyle，避免主线程阻塞。
• 文本复用：对于频繁更新的通知（如进度日志），使用 SpannableStringBuilder 复用已有文本对象，减少字符串拷贝。
• 缓存通知实例：相同内容的通知不要重复 build()，使用 NotificationCompat.Builder 的 build() 结果缓存。
• 控制最大文本长度：严格限制 bigText() 输入 ≤ 1500 字符，防止系统渲染超时 ANR。
• 避免 HTML 标记：BigTextStyle 原生不支持 Html.fromHtml() 渲染，复杂富文本应使用 SpannableString 并限制 spans 数量 ≤ 20。

// 协程 + 缓存优化示例
private val notificationCache = mutableMapOf<Int, Notification>()

fun showBigTextNotificationInBackground(context: Context, id: Int, text: String) {
    CoroutineScope(Dispatchers.IO).launch {
        val truncated = if (text.length > 1500) text.take(1500) + "…" else text
        val style = NotificationCompat.BigTextStyle()
            .setBigContentTitle("通知标题")
            .bigText(truncated)
        val notification = NotificationCompat.Builder(context, CHANNEL_ID)
            .setStyle(style)
            .build()
        notificationCache[id] = notification
        withContext(Dispatchers.Main) {
            NotificationManagerCompat.from(context).notify(id, notification)
        }
    }
}