修复 Toast 显示会被全局的悬浮窗遮挡的问题

新增支持 Toast 显示后发送无障碍事件（用于盲人辅助）
移除 Toast 中会默认设置 TextView 最大显示行数的逻辑

.github/ISSUE_TEMPLATE/issue_template_bug.md

@@ -8,33 +8,35 @@ assignees: getActivity
 
 ## 问题描述
 
-* 框架版本：XXX
+* 框架版本【必填】：XXX
 
-* 问题描述：XXX
+* 问题描述【必填】：XXX
 
-* 复现步骤：XXX
+* 复现步骤【必填】：XXX
 
-* 是否必现：填是/否
+* 是否必现【必填】：填是/否
 
-* 手机信息：例如某米 9 / Android 10
+* 出现问题的手机信息【必填】：请填写出现问题的品牌和机型
+
+* 出现问题的安卓版本【必填】：请填写出现问题的 Android 版本
 
 ## 请回答
 
-* 是部分机型还是所有机型都会出现：部分/全部（例如：某为，某 Android 版本会出现）
+* 是部分机型还是所有机型都会出现【必答】：部分/全部（例如：某为，某 Android 版本会出现）
 
-* 框架最新的版本是否存在这个问题：是/否（如果用的是旧版本的话，建议升级看问题是否还存在）
+* 框架最新的版本是否存在这个问题【必答】：是/否（如果用的是旧版本的话，建议升级看问题是否还存在）
 
-* 是否已经查阅框架文档还未能解决的：是/否（文档会提供最常见的问题解答，可以看看是否有自己想要的）
+* 是否已经查阅框架文档还未能解决的【必答】：是/否（文档会提供最常见的问题解答，可以看看是否有自己想要的）
 
-* issue 是否有人曾提过类似的问题：是/否（看看曾经有人提过类似的问题，先参考一下别人是怎么解决的）
+* issue 是否有人曾提过类似的问题【必答】：是/否（看看曾经有人提过类似的问题，先参考一下别人是怎么解决的）
 
-* 是否可以通过 Demo 来复现该问题：是/否（排查一下是不是自己的项目代码写得有问题导致的）
+* 是否可以通过 Demo 来复现该问题【必答】：是/否（排查一下是不是自己的项目代码写得有问题导致的）
 
-* 使用原生的 Toast 是否也会出现该问题：是/否（排查一下是不是框架的代码存在问题导致的）
+* 使用原生的 Toast 是否也会出现该问题【必答】：是/否（排查一下是不是框架的代码存在问题导致的）
 
 ## 其他
 
-* 提供报错堆栈（如果有报错的话必填）
+* 提供报错堆栈（如果有报错的话必填，注意不要拿被混淆过的代码堆栈上来）
 
 * 提供截图或视频（根据需要提供，此项不强制）
 

.github/ISSUE_TEMPLATE/issue_template_suggest.md

@@ -8,8 +8,8 @@ assignees: getActivity
 
 ## 建议收集
 
-* issue 是否有人曾提过类似的问题？（必答项，一旦出现重复提问我将不会再次解答）
+* issue 是否有人曾提过类似的问题？【必答】（一旦出现重复提问我将不会再次解答）
 
-* 你觉得框架有什么不足之处？（必答项，你可以描述框架有什么令你不满意的地方）
+* 你觉得框架有什么不足之处？【必答】（你可以描述框架有什么令你不满意的地方）
 
-* 你觉得该怎么去完善会比较好？（非必答项，你可以提供一下自己的想法或者做法供作者参考）
+* 你觉得该怎么去完善会比较好？【非必答】（你可以提供一下自己的想法或者做法供作者参考）

README.md

@@ -4,7 +4,7 @@
 
 * 博客地址：[只需体验三分钟，你就会跟我一样，爱上这款 Toast](https://www.jianshu.com/p/9b174ee2c571)
 
-* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处可直接下载](https://github.com/getActivity/ToastUtils/releases/download/10.3/ToastUtils.apk)
+* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处可直接下载](https://github.com/getActivity/ToastUtils/releases/download/10.5/ToastUtils.apk)
 
 ![](picture/demo_code.png)
 
@@ -47,7 +47,7 @@ android {
 
 dependencies {
  // 吐司框架：https://github.com/getActivity/ToastUtils
- implementation 'com.github.getActivity:ToastUtils:10.3'
+ implementation 'com.github.getActivity:ToastUtils:10.5'
 }
 ```
 
@@ -140,9 +140,9 @@ ToastUtils.init(this, new ToastStrategy() {
 
 | 功能或细节 | [ToastUtils](https://github.com/getActivity/ToastUtils) | [AndroidUtilCode](https://github.com/Blankj/AndroidUtilCode) | [Toasty](https://github.com/GrenderG/Toasty) |
 | :----: | :------: | :-----: | :-----: |
-| 对应版本 | 10.3 | 1.30.6 | 1.5.0 |
+| 对应版本 | 10.5 | 1.30.6 | 1.5.0 |
 | issues 数 | [![](https://img.shields.io/github/issues/getActivity/ToastUtils.svg)](https://github.com/getActivity/ToastUtils/issues) | [![](https://img.shields.io/github/issues/Blankj/AndroidUtilCode.svg)](https://github.com/Blankj/AndroidUtilCode/issues) | [![](https://img.shields.io/github/issues/GrenderG/Toasty.svg)](https://github.com/GrenderG/Toasty/issues) |
-| **aar 包大小** | 28 KB | 500 KB | 50 KB |
+| **aar 包大小** | 29 KB | 500 KB | 50 KB |
 | **调用代码定位** | ✅ | ❌ | ❌ |
 | 支持在子线程中调用显示 | ✅ | ✅ | ❌ |
 | 支持全局设置统一 Toast 样式 | ✅ | ❌ | ❌ |
@@ -158,13 +158,15 @@ ToastUtils.init(this, new ToastStrategy() {
 
 #### Toast 在 Android 7.1 崩溃的问题介绍
 
+> [Toast 在 Android 7.1 崩溃排查及修复](https://www.jianshu.com/p/437f473017d6)
+
 * 这个问题是由于 Android 7.1 加入 WindowToken 校验机制导致的，而这个 WindowToken 是 NotificationManagerService 生成的，这个 WindowToken 是存在一定时效性的，而当应用的主线程被阻塞时，WindowManager 在 addView 时会对 WindowToken 进行校验，但是 WindowToken 已经过期了，这个时候 addView 就会抛出异常。
 
-* 谷歌在 Android 8.0 就修复了这个问题，修复方式十分简单粗暴，就是直接捕获这个异常，而框架的修复思路跟谷歌类似，只不过修复方式不太一样，因为框架无法直接修改系统源码，所以是直接通过 Hook 的方式对异常进行捕获，大家如果对修复过程感兴趣可以看一下我写的这篇文章[Toast 在 Android 7.1 崩溃排查及修复](https://www.jianshu.com/p/437f473017d6)。
+* 谷歌在 Android 8.0 就修复了这个问题，修复方式十分简单粗暴，就是直接捕获这个异常，而框架的修复思路跟谷歌类似，只不过修复方式不太一样，因为框架无法直接修改系统源码，所以是直接通过 Hook 的方式对异常进行捕获。
 
 #### 通知栏权限关闭后 Toast 显示不出来的问题介绍
 
-* [Toast通知栏权限填坑指南](https://www.jianshu.com/p/1d64a5ccbc7c)
+> [Toast通知栏权限填坑指南](https://www.jianshu.com/p/1d64a5ccbc7c)
 
 * 这个问题的出现是因为原生 Toast 的显示要通过 NMS（NotificationManagerService） 才会 addView 到 Window 上面，而在 NMS 中有一个 `static final boolean ENABLE_BLOCKED_TOASTS = true` 的字段，当这个常量值为 true 时，会触发 NMS 对应用通知栏权限的检查，如果没有通知栏权限，那么这个 Toast 将会被 NMS 所拦截，并输出 `Suppressing toast from package` 日志信息，而小米手机没有这个问题是因为它是将 `ENABLE_BLOCKED_TOASTS` 字段值修改成 `false`，所以就不会触发对通知栏权限的检查，另外我为什么会知道有这个事情？因为我曾经和一名 MIUI 工程师一起确认过这个事情。
 
@@ -186,7 +188,7 @@ ToastUtils.init(this, new ToastStrategy() {
 
 * 兼容性强：[处理原生 Toast 在 Android 7.1 产生崩溃的历史遗留问题](https://www.jianshu.com/p/437f473017d6)
 
-* 功能强大：不分主次线程都可以弹出Toast，自动区分资源 id 和 int 类型
+* 功能强大：不分主次线程都可以弹出Toast，自动识别资源 id 和 int 类型
 
 * 使用简单：只需传入文本，会自动根据文本长度决定吐司显示的时长
 
@@ -201,7 +203,7 @@ ToastUtils.init(this, new ToastStrategy() {
 * 在项目中右击弹出菜单，Replace in path，勾选 Regex 选项，点击替换
 
 ```text
-Toast\.makeText\([^,]+,\s*(.+{1}),\s*[^,]+\)\.show\(\)
+Toast\.makeText\([^,]+,\s*(.+),\s*[^,]+\)\.show\(\)
 ```
 
 ```text
@@ -251,6 +253,8 @@ new Toast
 
 * Android 代码规范：[AndroidCodeStandard](https://github.com/getActivity/AndroidCodeStandard) ![](https://img.shields.io/github/stars/getActivity/AndroidCodeStandard.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidCodeStandard.svg)
 
+* Android 开源排行榜：[AndroidGithubBoss](https://github.com/getActivity/AndroidGithubBoss) ![](https://img.shields.io/github/stars/getActivity/AndroidGithubBoss.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidGithubBoss.svg)
+
 * Studio 精品插件：[StudioPlugins](https://github.com/getActivity/StudioPlugins) ![](https://img.shields.io/github/stars/getActivity/StudioPlugins.svg) ![](https://img.shields.io/github/forks/getActivity/StudioPlugins.svg)
 
 * 表情包大集合：[EmojiPackage](https://github.com/getActivity/EmojiPackage) ![](https://img.shields.io/github/stars/getActivity/EmojiPackage.svg) ![](https://img.shields.io/github/forks/getActivity/EmojiPackage.svg)
@@ -261,7 +265,7 @@ new Toast
 
 ![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/official_ccount.png)
 
-#### Android 技术分享 QQ 群：78797078
+#### Android 技术 Q 群：10047167
 
 #### 如果您觉得我的开源库帮你节省了大量的开发时间，请扫描下方的二维码随意打赏，要是能打赏个 10.24 :monkey_face:就太:thumbsup:了。您的支持将鼓励我继续创作:octocat:
 

app/build.gradle

@@ -7,8 +7,8 @@ android {
  applicationId "com.hjq.toast.demo"
  minSdkVersion 16
  targetSdkVersion 31
- versionCode 1030
- versionName "10.3"
+ versionCode 1050
+ versionName "10.5"
  testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
  }
 
@@ -65,7 +65,7 @@ dependencies {
  implementation 'com.github.getActivity:TitleBar:9.3'
 
  // 权限请求框架：https://github.com/getActivity/XXPermissions
- implementation 'com.github.getActivity:XXPermissions:13.2'
+ implementation 'com.github.getActivity:XXPermissions:13.6'
 
  // 悬浮窗框架：https://github.com/getActivity/XToast
  implementation 'com.github.getActivity:XToast:8.5'

app/src/main/java/com/hjq/toast/demo/MainActivity.java

@@ -80,7 +80,7 @@ public void show6(View v) {
  }
 
  public void show7(View v) {
- Snackbar.make(getWindow().getDecorView(), "正在准备跳转到手机桌面，请系好安全带", Snackbar.LENGTH_SHORT).show();
+ Snackbar.make(getWindow().getDecorView(), "温馨提示：安卓 10 在后台显示 Toast 需要有通知栏权限或者悬浮窗权限的情况下才可以显示", Snackbar.LENGTH_SHORT).show();
 
  v.postDelayed(new Runnable() {
  @Override
@@ -98,7 +98,7 @@ public void run() {
  if (XXPermissions.isGranted(MainActivity.this, Permission.SYSTEM_ALERT_WINDOW)) {
  ToastUtils.show("我是在后台显示的 Toast（有悬浮窗权限真的可以为所欲为）");
  } else {
- ToastUtils.show("我是在后台显示的 Toast（Android 11 及以上在后台显示 Toast 只能使用系统样式）");
+ ToastUtils.show("我是在后台显示的 Toast（安卓 11 及以上在后台显示只能使用系统样式）");
  }
  } else {
  ToastUtils.show("我是在后台显示的 Toast");

library/build.gradle

@@ -5,8 +5,8 @@ android {
 
  defaultConfig {
  minSdkVersion 14
- versionCode 1030
- versionName "10.3"
+ versionCode 1050
+ versionName "10.5"
  }
 
  // 使用 JDK 1.8

library/src/main/java/com/hjq/toast/ToastImpl.java

@@ -1,13 +1,17 @@
 package com.hjq.toast;
 
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.app.Application;
 import android.content.Context;
 import android.graphics.PixelFormat;
 import android.os.Build;
 import android.os.Handler;
 import android.os.Looper;
+import android.view.View;
 import android.view.WindowManager;
+import android.view.accessibility.AccessibilityEvent;
+import android.view.accessibility.AccessibilityManager;
 import android.widget.Toast;
 
 /**
@@ -98,8 +102,28 @@ private boolean isMainThread() {
  return Looper.myLooper() == Looper.getMainLooper();
  }
 
+ /**
+ * 发送无障碍事件
+ */
+ private void trySendAccessibilityEvent(View view) {
+ final Context context = view.getContext();
+ AccessibilityManager accessibilityManager =
+ (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE);
+ if (!accessibilityManager.isEnabled()) {
+ return;
+ }
+ // 将 Toast 视为通知，因为它们用于向用户宣布短暂的信息
+ AccessibilityEvent event = AccessibilityEvent.obtain(
+ AccessibilityEvent.TYPE_NOTIFICATION_STATE_CHANGED);
+ event.setClassName(Toast.class.getName());
+ event.setPackageName(context.getPackageName());
+ view.dispatchPopulateAccessibilityEvent(event);
+ accessibilityManager.sendAccessibilityEvent(event);
+ }
+
  private final Runnable mShowRunnable = new Runnable() {
 
+ @SuppressLint("WrongConstant")
  @Override
  public void run() {
 
@@ -142,7 +166,8 @@ public void run() {
  mWindowLifecycle.register(ToastImpl.this);
  // 当前已经显示
  setShow(true);
-
+ // 发送无障碍事件
+ trySendAccessibilityEvent(mToast.getView());
  } catch (IllegalStateException | WindowManager.BadTokenException e) {
  // 如果这个 View 对象被重复添加到 WindowManager 则会抛出异常
  // java.lang.IllegalStateException: View android.widget.TextView has already been added to the window manager.

library/src/main/java/com/hjq/toast/ToastStrategy.java

@@ -1,5 +1,6 @@
 package com.hjq.toast;
 
+import android.annotation.SuppressLint;
 import android.app.Activity;
 import android.app.AppOpsManager;
 import android.app.Application;
@@ -65,12 +66,13 @@ public void bindStyle(IToastStyle<?> style) {
  public IToast createToast(Application application) {
  Activity foregroundActivity = mActivityStack.getForegroundActivity();
  IToast toast;
- if (foregroundActivity != null) {
- toast = new ActivityToast(foregroundActivity);
- } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&
+ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&
  Settings.canDrawOverlays(application)) {
  // 如果有悬浮窗权限，就开启全局的 Toast
  toast = new WindowToast(application);
+ } else if (foregroundActivity != null) {
+ // 如果没有悬浮窗权限，就开启一个依附于 Activity 的 Toast
+ toast = new ActivityToast(foregroundActivity);
  } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.N_MR1) {
  // 处理 Android 7.1 上 Toast 在主线程被阻塞后会导致报错的问题
  toast = new SafeToast(application);
@@ -105,7 +107,7 @@ public void showToast(CharSequence text, long delayMillis) {
  mLatestText = text;
  HANDLER.removeCallbacks(mShowRunnable);
  // 延迟一段时间之后再执行，因为在没有通知栏权限的情况下，Toast 只能显示当前 Activity
- // 如果当前 Activity 在 ToastUtils.show 之后进行 finish 了，那么这个时候 Toast 可能会显示不出来
+ // 如果当前 Activity 在 showToast 之后立马进行 finish 了，那么这个时候 Toast 可能会显示不出来
  // 因为 Toast 会显示在销毁 Activity 界面上，而不会显示在新跳转的 Activity 上面
  HANDLER.postDelayed(mShowRunnable, delayMillis + DELAY_TIMEOUT);
  }
@@ -173,6 +175,7 @@ protected int getToastDuration(CharSequence text) {
  * 是否有通知栏权限
  */
  @SuppressWarnings("ConstantConditions")
+ @SuppressLint("PrivateApi")
  protected boolean areNotificationsEnabled(Context context) {
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
  return context.getSystemService(NotificationManager.class).areNotificationsEnabled();

library/src/main/java/com/hjq/toast/style/BlackToastStyle.java

@@ -40,21 +40,19 @@ public TextView createView(Context context) {
 
  textView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT));
 
- Drawable background = getBackgroundDrawable(context);
+ Drawable backgroundDrawable = getBackgroundDrawable(context);
  // 设置背景
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
- textView.setBackground(background);
+ textView.setBackground(backgroundDrawable);
  } else {
- textView.setBackgroundDrawable(background);
+ textView.setBackgroundDrawable(backgroundDrawable);
  }
 
  // 设置 Z 轴阴影
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
  textView.setZ(getTranslationZ(context));
  }
 
- // 设置最大显示行数
- textView.setMaxLines(getMaxLines(context));
  return textView;
  }
 
@@ -90,8 +88,4 @@ protected Drawable getBackgroundDrawable(Context context) {
  protected float getTranslationZ(Context context) {
  return TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 3, context.getResources().getDisplayMetrics());
  }
-
- protected int getMaxLines(Context context) {
- return 5;
- }
 }