如何在状态栏显示通知文本？仅显示图标问题的代码修正咨询

嘿，我来帮你搞定这个状态栏通知只显示图标不显示文本的问题！结合Android开发里的常见坑，我整理了几个大概率的原因和对应的修正方法：

1. 通知渠道配置缺失或错误 #

Android 8.0（API 26）及以上版本，所有通知必须绑定通知渠道，如果渠道的配置没到位，系统可能会默认隐藏通知文本：

• 确保你创建通知渠道时，正确设置了渠道名称、描述，并且开启了必要的显示属性：

// Kotlin 代码示例
val channelId = "your_channel_id"
val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

val channel = NotificationChannel(channelId, "我的通知渠道", NotificationManager.IMPORTANCE_DEFAULT).apply {
    description = "用于展示通知文本的渠道"
    setShowBadge(true)
    // 优先级不能设得太低，低优先级通知可能被系统折叠文本
    importance = NotificationManager.IMPORTANCE_DEFAULT
}
notificationManager.createNotificationChannel(channel)

2. 通知构造器未正确设置文本参数 #

你可能漏加了通知的标题或内容文本，或者调用了错误的方法：

• 检查是否调用了setContentTitle()和setContentText()，并且传入了非空的有效文本：

// Java 代码示例
NotificationCompat.Builder builder = new NotificationCompat.Builder(context, channelId)
        .setSmallIcon(R.drawable.ic_notification) // 图标是必填项，不能省略
        .setContentTitle("这是通知标题") // 标题建议设置，否则可能只显示图标
        .setContentText("需要在状态栏显示的通知文本内容") // 关键：设置要展示的内容文本
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

3. 系统或Launcher的通知设置限制 #

部分定制化ROM（比如小米、华为、OPPO）的默认设置里，会隐藏通知文本只显示图标：

• 打开手机「设置」→「通知与状态栏」→「通知管理」，找到你的应用；
• 确保开启了「显示通知内容」「状态栏显示通知文本」这类选项；
• 部分Launcher也有单独的通知显示设置，需要检查并开启文本显示权限。

4. 自定义通知布局的文本控件问题 #

如果用了RemoteViews自定义通知布局，可能是布局里的文本控件未正确配置：

• 确保布局文件中包含TextView，且设置了正确的文本内容和可见性：

<!-- 自定义通知布局示例 -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:padding="12dp">
    <ImageView
        android:id="@+id/notify_icon"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:src="@drawable/ic_notification"/>
    <TextView
        android:id="@+id/notify_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="14sp"
        android:textColor="@color/black"
        android:visibility="visible"/> <!-- 必须设置为可见 -->
</LinearLayout>

• 在代码中给文本控件赋值：

val remoteViews = RemoteViews(packageName, R.layout.custom_notify_layout)
remoteViews.setTextViewText(R.id.notify_text, "要显示的状态栏通知文本")

val notification = NotificationCompat.Builder(this, channelId)
        .setSmallIcon(R.drawable.ic_notification)
        .setCustomContentView(remoteViews)
        .build()

内容的提问来源于stack exchange，提问作者egorik