当 Android 的 Compat 库不能拯救你的时候(1)

2401_84121627

于 2024-04-06 21:13:02 发布

阅读量663

点赞数 11

分类专栏：程序员文章标签： android windows

本文链接：https://blog.csdn.net/2401_84121627/article/details/137438505

版权

程序员专栏收录该内容

196 篇文章 3 订阅

订阅专栏

编译器并不在意我们使用 NotificationManagerCompat 来达到目的。

我们有多种方法来解决这个问题。

将 RequiresApi 注解添加到我们的方法中并没有什么意义，因为我们会简单地将警告移到调用函数中。用检查包围似乎已经过时了，因为这个检查已经由 NotificationManagerCompat 完成，如上图所示。

看来最好的选择是选择抑制这个警告。

@SuppressLint(“NewApi”)
private fun checkChannels() {
val groups = notificationManagerCompat.notificationChannelGroups
val channels = groups.flatMap {
it.channels.filter { it.shouldShowLights() }
}
…
}

新的需求即将到来

假设我们得到了额外的要求，我们需要过滤掉被屏蔽的组。我们可以为此添加一个简单的检查：

@SuppressLint(“NewApi”)
private fun checkChannels() {
val groups = notificationManager.notificationChannelGroups
val channels = groups.filterNot { it.isBlocked }.flatMap {
it.channels.filter { it.shouldShowLights()}
}
…
}

一切看起来都很好，对吗？

你完了！

但我们刚刚引入了一个崩溃!

原因是：isBlocked 是在 API 28 才引入的，而我们没有进行检查! 尽管我们使用了 NotificationManagerCompat，但我们还是遇到了 API 级别上的问题!

而且因为我们抑制了 NewApi 的警告，所以我们在这个问题上没有收到任何警告!

所以当涉及到抑制警告的时候，我们就应该更加审慎!

解决方案？

由于只有在方法级别上才能解决这个问题（不适用单个语句），最好的方法是编写能满足我们需求的单行的方法。

多亏了扩展函数，这可以非常容易地实现：

@SuppressLint(“NewApi”) // SDK 26
fun NotificationChannelGroup.lightingChannels() =
channels.filterLightingOnes()

@SuppressLint(“NewApi”) // SDK 26
private fun List.filterLightingOnes() =
filter { it.shouldShowLights() }

如果我们在上面的例子中使用这种方法，我们在添加 isBlocked 的时候就会得到警告：

当然，这对于我们开发者来说多了很多工作，但是我们的用户会很喜欢一个无崩溃的应用。

The Linter

上述例子不是 Compat 库的 Bug，而是被抑制隐藏了。这种情况也可能发生在许多其他 API 上。

不要掉进这个陷阱!
使用 Compat 库可能会给我们带来虚假的安全感，并欺骗我们相信我们不必考虑这些问题。

而且再次强调，尽量避免抑制 NewApi 警告！

相反，我们应该使用直接的版本检查，比如：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P)

不幸的是，lint 在这里不是很智能。它不会理解一些变型的版本检查，比如说：

.filter { Build.VERSION.SDK_INT >= Build.VERSION_CODES.P }

求助？

也许你们中的一些人想更多地研究这个，用一些自定义的 lint 规则。基本上，我们需要这样的东西：

@CheckedUpTo(Build.VERSION_CODES.P)
这将在内部完成类似于 SuppressLint("NewApi") 的工作，但只会针对不需要高于 P 版本的 API 调用。
目前，你可以让现有的 lint 功能为你工作。例如也可以在你自己的代码中添加 @RequiresApi(Build.VERSION_CODES.P)，强制让你处理这些问题。
记住，这些注释也被认为是你的代码读者的文档。
PS: 最新的 NotificationCompat alpha 版本将为我们带来 NotificationChannel 和 NotificationChannelGroup 的兼容版本。🥳