这是篇过程复盘类的文章，一是想将问题的排查、解决过程梳理出来；二是要将排查过程中涉及到的一些琐碎的知识点记录下来。在开始复盘前，简单交代一下问题背景：我维护的项目基于【网易云信】实现了 IM 功能，与微信类似，用户收到消息后，手机会收到消息推送，状态栏和桌面 LOGO 的角标都会有消息提醒，最近有华为手机用户反馈没有消息提醒了，于是开始了下面的排查过程。

1. 问题描述

本次排查的问题为，华为手机用户在收到 IM 消息后，桌面 LOGO 的角标不发生动态更新，只有进入应用的消息列表页面，再重新切到桌面后角标数量才会更新。

2. 排查过程

2.1 角标权限

桌面图标的角标数量不更新，我们第一时间想到的是用户的「桌面图标角标」权限是否开启？结果是开启的，那就证明问题不在角标权限这里。

1. 什么是 Chains 链

Chains 是一种特定类型的约束，它允许我们在链内的视图之间共享空间，并控制可用空间在它们之间的划分方式。与传统 Android 布局最相似的应该是 LinearLayout 中的权重比 weight 属性，但 Chains 能做到的要远远比 weight 多。

2. Chain 链模式

前面已经提到了 Chain 链是由多个 View 组成的，所以要创建一个 Chain 链就需要先选择多个想要链接到一起的 Views，然后再通过水平链或垂直链将其链到一起。Chain 链模式一共有三种，分别为：spread ，spread_inside 和 packed ，若想这些模式生效，在链头设置属性即可。

2.1 Spread 模式

模式	说明
spread	Chain 链的默认模式就是 spread 模式，它将平分间隙让多个 Views 布局到剩余空间。
图例

1. 什么是参照线

熟悉图形设计工具的人对参照线（Guideline）的概念并不陌生，因为它们很常用。参照线用来在程序设计阶段锚定其他控件的位置，并给开发人员提供直观的视觉感受。参照线只会显示在 IDE 的编辑窗口，不会显示在设备上，并且只在约束布局中生效。

2. 创建参照线

参照线的创建与引入其他控件类似，直接在约束布局下增加 Guideline 控件即可。当然，也可以通过 UI 的设计界面右键单击视图从上下文菜单中进行选择。为保证通用性，本文采用代码形式引入，案例如下：

1
2
3
4
5
6
7
8
9
10

<androidx.constraintlayout.widget.ConstraintLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.constraintlayout.widget.Guideline
        android:id="@+id/anchor"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

</androidx.constraintlayout.widget.ConstraintLayout>

在上篇《ActiveMQ MQTT Server 搭建》中我们已经搭建好了 MQTT Server，本篇我们将在 Android 上建立 MQTT Client 与 MQTT Server 进行通讯。

1. 执行流程

1.1 引入依赖

在 build.gradle 中引入依赖项。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

 android {
     ...
 }
 
 repositories {
    maven {
        url "https://repo.eclipse.org/content/repositories/paho-snapshots/"
    }
}

dependencies {
    ...
    implementation 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.1.0'
    implementation 'org.eclipse.paho:org.eclipse.paho.android.service:1.1.1'
}
 

Android 开发中需要和 MQTT Server 进行交互，在此之前需要先搭建 MQTT Server 来协助开发。本文演示了在 Windows 11 中使用 Apache ActiveMQ 来搭建服务的全过程。

1. 下载 ActiveMQ

2. 启动 ActiveMQ

本例中使用 ActiveMQ Classic 5.18.3 进行搭建，解压下载的 ActiveMQ 包，切换至 ActiveMQ 的 bin 目录，输入 activemq start 命令启动服务。

内部类也叫做嵌套类，在 Java 中是一个被大家经常使用到的东西。内部类除了匿名内部类外还分为三种：一种是可以被独立构造实例且和外部类完全剥离的静态内部类，一种是可以自由访问外部类成员变量和方法的成员内部类，一种是作用域和生命周期都只处在一个方法中的方法内部类，但这种内部类我们不讨论。

在 Kotlin 中，内部类默认是静态内部类，只有用 inner 修饰符声明静态内部类，才能让 Kotlin 中默认的静态内部类变为非静态的成员内部类。

1 静态内部类

Kotlin 中，类可以嵌套。一个类可以嵌套在其他类中，而且可以嵌套多层。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

class NestedClass {

    class Outer {
        private val zero: Int = 0
        val one: Int = 1

        class Inner {
            fun getTwo() = 2
            
            class Deep {
                val three = 3
                fun getFour() = 4
            }
        }
    }

}

在使用 Java 的时候，我们经常使用诸如 StringUtil、DateUtil 等工具类，代码写起来比较冗长。举个例子，获取一个字符串的第一个字符值、最后一个字符值。如果我们用 Java 代码来写通常要先声明一个 StingUtil 类，然后在里面写相应的方法。那么，我们能不能直接在 String 类上增加获取第一个字符值、最后一个字符值的方法呢？非常遗憾的是，在 Java 中我们无法给 String 类增加一个自定义方法。因为 String 类是 JDK 中内置的基础类，而且为 final，不能修改。所以，在 Java 中通常需要引入一个工具类来封装对应的方法，而不是修改或继承 String 类。

而在 Kotlin 中，情况就完全不一样了，我们完全可以自由扩展任何类的方法和属性。在不修改原类的情况下，Kotlin 能给一个类扩展新功能而无须继承该类。

1. 扩展函数

Kotlin 中提供了非常实用的扩展函数功能。它允许你在不修改原始类的情况下，为该类添加新的函数。通过扩展函数，你可以为任何类添加新的行为，包括标准库中的类、第三方库中的类，甚至是你自己定义的类。

Kotlin 提供了丰富的数据处理功能，包括数据的映射、过滤、查找、排序、求和、字符连接、转换、循环等。这些功能可以帮助开发者更加方便地处理数据，而不用关心具体的实现过程，开发者可以将更多的关注放在业务逻辑本身。此外，这些功能还能极大简化代码，提升代码的可读性。下面是一些数据操作的常用模版代码：

1. 映射操作

1
2
3
4
5
6
7
8
9
10
11
12

// 将集合转换为 MAP

class Member(var id: Int, var name: String)

val data = mutableListOf(
    Member(1, "Tom"),
    Member(2, "Tim"),
    Member(3, "Tom")
)

val map: Map<Long, Member> = data.associateBy { it.id }
val map: Map<Long, String> = data.associate { it.id to it.name }

1
2
3
4
5
6
7
8
9
10
11
12
13
14

// 将集合中的元素按照某个条件分组，返回 MAP

class Member(var id: Int, var name: String)

val data = mutableListOf(
    Member(1, "Tom"),
    Member(2, "Tim"),
    Member(3, "Tom")
)

val map = data.groupBy { it.id }
map.forEach {
    print("${it.key} - ${it.value.count()}")
}

这篇文章得从一个 BUG 说起，UI 是由 Viewpager2 嵌套两个 Fragment 构成的。然而，就是这再平常不过的功能以及接近模版化的代码，竟然因为偷懒产生了异常。为了省去繁琐的 Arguments 传值，在 Fragment 的实例化过程中增加了有参构造函数。正是这一操作为后续的应用崩溃埋下了坑，Fragment 源码正在等待合适的时机将异常抛出。

1. 崩溃信息

采用有参构造函数实例化 Fragment 后，进行了功能测试。由于在测试过程中应用一直在前台，所以也就没有发现这一BUG，但当应用上线后，陆续收到了应用崩溃的反馈，查看 BUG 统计得到了如下的崩溃信息：

看到标题就应该知道，这又是一篇 BUG 修复的复盘文章。这个 BUG 起源于 Google 程序员多年前埋的坑【FLAG_TEST_ONLY】，这是一个 API 级别 4 时候就存在的属性。这是一个没有存在感的属性，以至于十几年的时间内都没有引起多少人注意。直到 Android Studio 3.0 的发布，这个版本的 IDE 会在测试版 APK 的清单文件中自动注入 android:testOnly="true" 属性配置。如果清单文件中有这样的配置，那就意味着 APK 只能通过 adb 的方式安装。为了更加精准的了解这个属性的作用，我们还是看下官方文档是怎么描述的。

✦ 官方文档 | android:testOnly 指示此应用是否仅用于测试目的。例如，它可能会在自身之外公开功能或数据，这样会导致安全漏洞，但对测试很有用。此类 APK 只能通过 adb 安装，您不能将其发布到 Google Play。当您点击 Run 图标时，Android Studio 会自动添加此属性。

文档的描述简洁干练，提供的信息也乏善可陈。那么，应该怎么解决这个问题呢？通过考古，网上普遍流行两种方法：

如果通过这两种方式就能解决应用安装失败的话，就不会有这篇文章了。下面，我们正式开始复盘问题的定位和解决过程。