setColorFilter 在 API29 上已弃用

Question

我使用下面这行来改变 VectorDrawable 的颜色：

mydrawable.getBackground().setColorFilter(color, PorterDuff.Mode.SRC_ATOP)

这很好用，尽管它现在已被弃用。文档建议我使用：

mydrawable.getBackground().setColorFilter(new BlendModeColorFilter(color, PorterDuff.Mode.SRC_ATOP))

不过，BlendModeColorFilter 仅在 API29 上可用。在检查了不推荐使用的方法的来源之后，我意识到它调用了：

new PorterDuffColorFilter()

所以，我继续使用：

mydrawable.getBackground().setColorFilter(new PorterDuffColorFilter(color, PorterDuff.Mode.SRC_ATOP))

着色成功了。这是已弃用方法的正确替代方法，还是我必须在 API29 上使用 BlendModeColorFilter？

谢谢。

Answer 1

试试这个：

public class MyDrawableCompat {
    public static void setColorFilter(@NonNull Drawable drawable, @ColorInt int color) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            drawable.setColorFilter(new BlendModeColorFilter(color, BlendMode.SRC_ATOP));
        } else {
            drawable.setColorFilter(color, PorterDuff.Mode.SRC_ATOP);
        }
    }
}

还有这个：

MyDrawableCompat.setColorFilter(mydrawable.getBackground(), color);

更新： 只需使用最新版本的core androidx library 和此代码：

mydrawable.colorFilter = BlendModeColorFilterCompat.createBlendModeColorFilterCompat(color, BlendModeCompat.SRC_ATOP)

Answer 2

感谢@shmakova，我为 Kotlin 添加了一个解决方案。

import android.graphics.BlendMode
import android.graphics.BlendModeColorFilter
import android.graphics.PorterDuff
import android.graphics.drawable.Drawable
import android.os.Build
import androidx.annotation.RequiresApi

fun Drawable.setColorFilter(color: Int, mode: Mode = Mode.SRC_ATOP) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        colorFilter = BlendModeColorFilter(color, mode.getBlendMode())
    } else {
        @Suppress("DEPRECATION")
        setColorFilter(color, mode.getPorterDuffMode())
    }
}

// This class is needed to call the setColorFilter 
// with different BlendMode on older API (before 29).
enum class Mode {
    CLEAR,
    SRC,
    DST,
    SRC_OVER,
    DST_OVER,
    SRC_IN,
    DST_IN,
    SRC_OUT,
    DST_OUT,
    SRC_ATOP,
    DST_ATOP,
    XOR,
    DARKEN,
    LIGHTEN,
    MULTIPLY,
    SCREEN,
    ADD,
    OVERLAY;

    @RequiresApi(Build.VERSION_CODES.Q)
    fun getBlendMode(): BlendMode =
        when (this) {
            CLEAR -> BlendMode.CLEAR
            SRC -> BlendMode.SRC
            DST -> BlendMode.DST
            SRC_OVER -> BlendMode.SRC_OVER
            DST_OVER -> BlendMode.DST_OVER
            SRC_IN -> BlendMode.SRC_IN
            DST_IN -> BlendMode.DST_IN
            SRC_OUT -> BlendMode.SRC_OUT
            DST_OUT -> BlendMode.DST_OUT
            SRC_ATOP -> BlendMode.SRC_ATOP
            DST_ATOP -> BlendMode.DST_ATOP
            XOR -> BlendMode.XOR
            DARKEN -> BlendMode.DARKEN
            LIGHTEN -> BlendMode.LIGHTEN
            MULTIPLY -> BlendMode.MULTIPLY
            SCREEN -> BlendMode.SCREEN
            ADD -> BlendMode.PLUS
            OVERLAY -> BlendMode.OVERLAY
        }

    fun getPorterDuffMode(): PorterDuff.Mode =
        when (this) {
            CLEAR -> PorterDuff.Mode.CLEAR
            SRC -> PorterDuff.Mode.SRC
            DST -> PorterDuff.Mode.DST
            SRC_OVER -> PorterDuff.Mode.SRC_OVER
            DST_OVER -> PorterDuff.Mode.DST_OVER
            SRC_IN -> PorterDuff.Mode.SRC_IN
            DST_IN -> PorterDuff.Mode.DST_IN
            SRC_OUT -> PorterDuff.Mode.SRC_OUT
            DST_OUT -> PorterDuff.Mode.DST_OUT
            SRC_ATOP -> PorterDuff.Mode.SRC_ATOP
            DST_ATOP -> PorterDuff.Mode.DST_ATOP
            XOR -> PorterDuff.Mode.XOR
            DARKEN -> PorterDuff.Mode.DARKEN
            LIGHTEN -> PorterDuff.Mode.LIGHTEN
            MULTIPLY -> PorterDuff.Mode.MULTIPLY
            SCREEN -> PorterDuff.Mode.SCREEN
            ADD -> PorterDuff.Mode.ADD
            OVERLAY -> PorterDuff.Mode.OVERLAY
        }
}

照常使用：

toolbar?.navigationIcon?.setColorFilter(ContextCompat.getColor(this, color)) /* 1 */
progressBar.indeterminateDrawable.setColorFilter(color, Mode.SRC_IN) /* 2 */

我尝试使用BlendMode 和PorterDuff.Mode 参数（如drawable.setColorFilter(color, BlendMode.SRC_ATOP, PorterDuff.Mode.SRC_ATOP)）调用setColorFilter，但这导致了运行时异常：

java.lang.NoClassDefFoundError：解析失败： Landroid/graphics/BlendMode;

所以，我们可以使用BlendMode 调用任何方法，仅从 SDK 版本 29 开始（它已添加到那里）。我必须使用Mode 参数创建setColorFilter。

Answer 3

使用androidx.core:core:1.2.0 或androidx.core:core-ktx:1.2.0。

// Java
implementation 'androidx.core:core:1.2.0'
// Kotlin
implementation 'androidx.core:core-ktx:1.2.0'

还有这个：

drawable.setColorFilter(BlendModeColorFilterCompat.createBlendModeColorFilterCompat(color, BlendModeCompat.SRC_ATOP))

Answer 4

PorterDuffColorFilter 是在 API 级别 1 中添加的，并且未被弃用，此外，PorterDuffColorFilter 是 ColorFilter 的子类。您可以毫无问题地使用它，因为setColorFilter 参数的类型为ColorFilter，并且它不需要您传递BlendModeColorFilter。文档可能建议BlendModeColorFilter 的原因有很多。也许他们计划在未来弃用 PorterDuffColorFilter（到 2021 年它仍然没有被弃用）或者它可能只是表现更好，谁知道......关键是你正确地使用了它。如果您想防止您的代码因为PorterDuffColorFilter 突然被弃用和删除而崩溃，那么您应该按照许多其他人的建议进行操作并添加版本检查。如果您对此不担心，则不必这样做，但您必须留意未来的任何变化。

但总的来说，到 2021 年，您的代码将适用于所有版本。

问候

注意：setColorFilter(int color, PorterDuff.Mode mode) 已弃用此答案仅与 setColorFilter(ColorFilter colorFilter) 相关

Answer 5

BlendMode 过滤器可能需要更高的 API 才能工作。

查看此link 了解更多信息