ToastCompat 教程：优雅地解决Android Toast异常

ToastCompat 教程：优雅地解决Android Toast异常

ToastCompat项目地址:https://gitcode.com/gh_mirrors/to/ToastCompat

1. 项目介绍

ToastCompat 是一个由 Drakeet 维护的轻量级 Android 开源库，专为解决 API 25 及以上版本中可能出现的 BadTokenException 问题。它允许你在不修改现有 Toast 代码的情况下，安全地显示 Toast，保证应用的健壮性，同时提供了一些简单的定制选项。

2. 项目快速启动

添加依赖

在你的 build.gradle 文件（app模块）中添加以下依赖：

dependencies {
    implementation 'me.drakeet.support:toastcompat:1.1.0'
}

然后同步 Gradle 项目。

使用示例

基本用法

ToastCompat.makeText(this, "Hello World", Toast.LENGTH_SHORT).show()

配合监听器处理异常

ToastCompat.makeText(this, "Hello", Toast.LENGTH_SHORT)
    .setBadTokenListener { toast ->
        // 处理 BadTokenException 的逻辑
    }
    .show()

3. 应用案例和最佳实践

在需要显示 Toast 的地方，尽量使用 ToastCompat 替代传统的 Toast。特别是在非主线程或者服务中显示 Toast 时，可以有效避免 BadTokenException。

如果你需要自定义 Toast 的外观，可以通过 ToastCompat.Builder 来构建：

val builder = ToastCompat.Builder(this)
    .backgroundType(ToastCompat.SOLID)
    .backgroundColor(Color.BLACK)
    .text("这是 ToastCompat")
    .textColor(Color.WHITE)
    .textSize(14f)
    .stroke(1, Color.GREEN)
    .iconEnd(R.drawable.ic_example_icon)
    .gravity(ToastCompat.GRAVITY_CENTER)
    .padding(25f, 30f, 30f)

builder.show()

4. 典型生态项目

• UniversalToast: 一个简洁优雅的 Toast 控件，支持点击和 GIF 功能，无 BadTokenException 风险。
  • 地址：https://github.com/bboylin/UniversalToast

通过集成类似 ToastCompat 和 UniversalToast 这样的库，你可以使你的应用更加稳定，同时提升用户体验。

---

请注意，尽管 ToastCompat 提供了异常处理功能，但在处理敏感数据或关键操作时，仍建议在主线程中进行 Toast 显示以保证最佳效果。

ToastCompat项目地址:https://gitcode.com/gh_mirrors/to/ToastCompat