修复 Toast 在显示后进行屏幕旋转出现窗口泄漏的问题

新增在有悬浮窗权限的情况下优先展示全局自定义的 Toast 新增 ToastUtils.delayedShow 延迟显示的方法
getActivity · Jan 8, 2022 · 39b7c24 · 39b7c24
1 parent 65784f0
commit 39b7c24
Show file tree

Hide file tree

Showing 19 changed files with 528 additions and 331 deletions.
diff --git a/README.md b/README.md
@@ -4,30 +4,37 @@
 
 * 博客地址：[只需体验三分钟，你就会跟我一样，爱上这款 Toast](https://www.jianshu.com/p/9b174ee2c571)
 
-* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处可直接下载](https://github.com/getActivity/ToastUtils/releases/download/10.0/ToastUtils.apk)
+* 可以扫码下载 Demo 进行演示或者测试，如果扫码下载不了的，[点击此处可直接下载](https://github.com/getActivity/ToastUtils/releases/download/10.2/ToastUtils.apk)
 
 ![](picture/demo_code.png)
 
 ![](picture/demo_page.jpg)
 
 #### 集成步骤
 
-* 在项目根目录下的 `build.gradle` 文件中加入
+* 如果你的项目 Gradle 配置是在 `7.0 以下`，需要在 `build.gradle` 文件中加入
 
 ```groovy
-buildscript {
+allprojects {
     repositories {
+        // JitPack 远程仓库：https://jitpack.io
         maven { url 'https://jitpack.io' }
     }
 }
-allprojects {
+```
+
+* 如果你的 Gradle 配置是 `7.0 及以上`，则需要在 `settings.gradle` 文件中加入
+
+```groovy
+dependencyResolutionManagement {
     repositories {
+        // JitPack 远程仓库：https://jitpack.io
         maven { url 'https://jitpack.io' }
     }
 }
 ```
 
-* 在项目 app 模块下的 `build.gradle` 文件中加入
+* 配置完远程仓库后，在项目 app 模块下的 `build.gradle` 文件中加入远程依赖
 
 ```groovy
 android {
@@ -40,7 +47,7 @@ android {
 
 dependencies {
     // 吐司框架：https://github.com/getActivity/ToastUtils
-    implementation 'com.github.getActivity:ToastUtils:10.0'
+    implementation 'com.github.getActivity:ToastUtils:10.2'
 }
 ```
 
@@ -67,8 +74,12 @@ ToastUtils.show(CharSequence text);
 ToastUtils.show(int id);
 
 // debug 模式下显示 Toast
-ToastUtils.debugShow(CharSequence text);
 ToastUtils.debugShow(int id);
+ToastUtils.debugShow(CharSequence text);
+
+// 延迟显示 Toast
+ToastUtils.delayedShow(int id, long delayMillis);
+ToastUtils.delayedShow(CharSequence text, long delayMillis);
 
 // 取消 Toast
 ToastUtils.cancel();
@@ -99,22 +110,22 @@ ToastUtils.setInterceptor(IToastInterceptor interceptor);
 ToastUtils.getInterceptor();
 ```
 
-* 如果你需要对 Toast 的进行定制化，可以使用以下方式
+* 如果你需要对 Toast 的进行深度定制化，可以使用以下方式
 
 ```java
 ToastUtils.init(this, new ToastStrategy() {
 
     @Override
     public IToast createToast(Application application) {
         IToast toast = super.createToast(application);
-        if (toast instanceof ActivityToast) {
-            ActivityToast activityToast = ((ActivityToast) toast);
+        if (toast instanceof CustomToast) {
+            CustomToast customToast = ((CustomToast) toast);
             // 设置 Toast 动画效果
-            activityToast.setAnimationsId(R.anim.xxx);
+            customToast.setAnimationsId(R.anim.xxx);
             // 设置短 Toast 的显示时长（默认是 2000 毫秒）
-            activityToast.setShortDuration(1000);
+            customToast.setShortDuration(1000);
             // 设置长 Toast 的显示时长（默认是 3500 毫秒）
-            activityToast.setLongDuration(5000);
+            customToast.setLongDuration(5000);
         }
         return toast;
     }
@@ -129,15 +140,15 @@ ToastUtils.init(this, new ToastStrategy() {
 
 |  功能或细节  | [ToastUtils](https://github.com/getActivity/ToastUtils) | [AndroidUtilCode](https://github.com/Blankj/AndroidUtilCode)  | [Toasty](https://github.com/GrenderG/Toasty) |
 | :----: | :------: |  :-----: |  :-----: |
-|    对应版本  |  10.0 |  1.30.6  |  1.5.0  |
+|    对应版本  |  10.2 |  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 包大小**                 | 26 KB | 500 KB | 50 KB |
+|                  **aar 包大小**                 | 28 KB | 500 KB | 50 KB |
 |                  **调用代码定位**                |  ✅  |  ❌  |  ❌  |
 |                支持在子线程中调用显示              |  ✅  |  ✅  |  ❌  |
 |           支持全局设置统一 Toast 样式              |  ✅  |  ❌  |  ❌  |
 |        处理 Toast 在 Android 7.1 崩溃的问题       |  ✅  |  ✅  |  ❌  |
-|      兼容通知栏权限关闭后 Toast 显示不出来的问题      |  ✅  |  ❌  |  ❌  |
-|     适配 Android 11 不能在后台显示 Toast 的问题        |  ✅  |  ❌  |  ❌  |
+|      兼容通知栏权限关闭后 Toast 显示不出来的问题      |  ✅  |  ✅  |  ❌  |
+|     适配 Android 11 不能在后台显示 Toast 的问题     |  ✅  |  ❌  |  ❌  |
 
 #### 调用代码定位功能介绍
 
@@ -157,7 +168,7 @@ ToastUtils.init(this, new ToastStrategy() {
 
 * 这个问题的出现是因为原生 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 工程师一起确认过这个事情。
 
-* 框架处理这个问题的方式有两种，先判断当前应用是否处于前台状态，如果是则使用自定义的 WindowManager 代替 Toast 来显示，如果当前应用处于后台状态，则会通过 Hook Toast 中的 INotificationManager 接口，将 enqueueToast 方法传递的包名参数修改成 `android` 来欺骗 NotificationManagerService，因为 NotificationManagerService 已经将 `android` 包名的应用纳入白名单，会自动放行，需要注意的是，这种方式在 Android 10 上面已经失效了，已经被系统纳入反射黑名单，但是好消息是，通过查看和对比 NotificationManagerService 源码发现，这个问题已经在 Android 10.0 的版本上面被修复了，所以框架只在 Android 9.0 及以下版本并且在关闭了通知栏权限的情况下才去 Hook INotificationManager，这样就能比较完美地解决这一问题，另外我还找到了官方关于这块的代码提交记录：[Always allow toasts from foreground apps](https://cs.android.com/android/_/android/platform/frameworks/base/+/58b2453ed69197d765c7254241d9966ee49a3efb)，大家可以感兴趣可以看看。
+* 框架处理这个问题的方式有两种，先判断当前应用是否处于前台状态，如果是则使用自定义的 WindowManager 代替 Toast 来显示，如果当前应用处于后台状态，则会通过 Hook Toast 中的 INotificationManager 接口，将 enqueueToast 方法传递的包名参数修改成 `android` 来欺骗 NotificationManagerService，因为 NotificationManagerService 已经将 `android` 包名的应用纳入白名单，会自动放行，需要注意的是，这种方式在 Android 10 上面已经失效了，已经被系统纳入反射黑名单，但是好消息是，通过查看和对比 NotificationManagerService 源码发现，这个问题（关闭通知栏权限后无法在前台弹 Toast 的问题）已经在 Android 10.0 的版本上面被修复了，所以框架只在 Android 9.0 及以下版本并且在关闭了通知栏权限的情况下才去 Hook INotificationManager，另外我还找到了官方关于这块的代码提交记录：[Always allow toasts from foreground apps](https://cs.android.com/android/_/android/platform/frameworks/base/+/58b2453ed69197d765c7254241d9966ee49a3efb)，大家可以感兴趣可以看看，还有一个问题，如果你想在 Android 10 之后仍然能在后台显示 Toast，请保证应用的通知栏权限处于开启的状态。
 
 #### Android 11 不能在后台显示 Toast 的问题介绍
 
@@ -216,23 +227,35 @@ new Toast
 
 #### 作者的其他开源项目
 
-* 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject)
+* 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject) ![](https://img.shields.io/github/stars/getActivity/AndroidProject.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidProject.svg)
+
+* 安卓技术中台 Kt 版：[AndroidProject-Kotlin](https://github.com/getActivity/AndroidProject-Kotlin) ![](https://img.shields.io/github/stars/getActivity/AndroidProject-Kotlin.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidProject-Kotlin.svg)
+
+* 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions) ![](https://img.shields.io/github/stars/getActivity/XXPermissions.svg) ![](https://img.shields.io/github/forks/getActivity/XXPermissions.svg)
+
+* 网络框架：[EasyHttp](https://github.com/getActivity/EasyHttp) ![](https://img.shields.io/github/stars/getActivity/EasyHttp.svg) ![](https://img.shields.io/github/forks/getActivity/EasyHttp.svg)
+
+* 标题栏框架：[TitleBar](https://github.com/getActivity/TitleBar) ![](https://img.shields.io/github/stars/getActivity/TitleBar.svg) ![](https://img.shields.io/github/forks/getActivity/TitleBar.svg)
+
+* 悬浮窗框架：[XToast](https://github.com/getActivity/XToast) ![](https://img.shields.io/github/stars/getActivity/XToast.svg) ![](https://img.shields.io/github/forks/getActivity/XToast.svg)
+
+* Shape 框架：[ShapeView](https://github.com/getActivity/ShapeView) ![](https://img.shields.io/github/stars/getActivity/ShapeView.svg) ![](https://img.shields.io/github/forks/getActivity/ShapeView.svg)
 
-* 网络框架：[EasyHttp](https://github.com/getActivity/EasyHttp)
+* 语种切换框架：[MultiLanguages](https://github.com/getActivity/MultiLanguages) ![](https://img.shields.io/github/stars/getActivity/MultiLanguages.svg) ![](https://img.shields.io/github/forks/getActivity/MultiLanguages.svg)
 
-* 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions)
+* Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory) ![](https://img.shields.io/github/stars/getActivity/GsonFactory.svg) ![](https://img.shields.io/github/forks/getActivity/GsonFactory.svg)
 
-* 标题栏框架：[TitleBar](https://github.com/getActivity/TitleBar)
+* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat) ![](https://img.shields.io/github/stars/getActivity/Logcat.svg) ![](https://img.shields.io/github/forks/getActivity/Logcat.svg)
 
-* 国际化框架：[MultiLanguages](https://github.com/getActivity/MultiLanguages)
+* Android 版本适配：[AndroidVersionAdapter](https://github.com/getActivity/AndroidVersionAdapter) ![](https://img.shields.io/github/stars/getActivity/AndroidVersionAdapter.svg) ![](https://img.shields.io/github/forks/getActivity/AndroidVersionAdapter.svg)
 
-* 悬浮窗框架：[XToast](https://github.com/getActivity/XToast)
+* 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)
 
-* Shape 框架：[ShapeView](https://github.com/getActivity/ShapeView)
+* 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)
 
-* Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory)
+* 表情包大集合：[EmojiPackage](https://github.com/getActivity/EmojiPackage) ![](https://img.shields.io/github/stars/getActivity/EmojiPackage.svg) ![](https://img.shields.io/github/forks/getActivity/EmojiPackage.svg)
 
-* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat)
+* 省市区 Json 数据：[ProvinceJson](https://github.com/getActivity/ProvinceJson) ![](https://img.shields.io/github/stars/getActivity/ProvinceJson.svg) ![](https://img.shields.io/github/forks/getActivity/ProvinceJson.svg)
 
 #### 微信公众号：Android轮子哥
 

diff --git a/app/build.gradle b/app/build.gradle
@@ -7,8 +7,8 @@ android {
         applicationId "com.hjq.toast.demo"
         minSdkVersion 16
         targetSdkVersion 31
-        versionCode 1000
-        versionName "10.0"
+        versionCode 1020
+        versionName "10.2"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
 
@@ -55,16 +55,19 @@ dependencies {
     implementation project(':library')
 
     // AndroidX 库：https://github.com/androidx/androidx
-    implementation 'androidx.appcompat:appcompat:1.3.1'
+    implementation 'androidx.appcompat:appcompat:1.4.0'
     // Material 库：https://github.com/material-components/material-components-android
     implementation 'com.google.android.material:material:1.4.0'
 
     // 标题栏框架：https://github.com/getActivity/TitleBar
-    implementation 'com.github.getActivity:TitleBar:9.2'
+    implementation 'com.github.getActivity:TitleBar:9.3'
+
+    // 权限请求框架：https://github.com/getActivity/XXPermissions
+    implementation 'com.github.getActivity:XXPermissions:13.2'
 
     // 悬浮窗框架：https://github.com/getActivity/XToast
-    implementation 'com.github.getActivity:XToast:8.3'
+    implementation 'com.github.getActivity:XToast:8.5'
 
     // 内存泄漏捕捉：https://github.com/square/leakcanary
-    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.7'
+    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.8.1'
 }
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
@@ -12,7 +12,7 @@
         android:theme="@style/AppTheme">
 
         <activity
-            android:name=".ToastActivity"
+            android:name=".MainActivity"
             android:exported="true">
 
             <intent-filter>
@@ -25,4 +25,14 @@
 
     </application>
 
+    <!-- Android 11 软件包可见性适配 -->
+    <queries>
+
+        <!-- 调起其他页面意图：Intent.ACTION_VIEW -->
+        <intent>
+            <action android:name="android.intent.action.VIEW" />
+        </intent>
+
+    </queries>
+
 </manifest>
diff --git a/...ava/com/hjq/toast/demo/ToastActivity.java → ...java/com/hjq/toast/demo/MainActivity.java b/...ava/com/hjq/toast/demo/ToastActivity.java → ...java/com/hjq/toast/demo/MainActivity.java
@@ -1,6 +1,7 @@
 package com.hjq.toast.demo;
 
 import android.content.Intent;
+import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.util.TypedValue;
@@ -10,6 +11,10 @@
 import androidx.appcompat.app.AppCompatActivity;
 
 import com.google.android.material.snackbar.Snackbar;
+import com.hjq.bar.OnTitleBarListener;
+import com.hjq.bar.TitleBar;
+import com.hjq.permissions.Permission;
+import com.hjq.permissions.XXPermissions;
 import com.hjq.toast.ToastUtils;
 import com.hjq.toast.style.BlackToastStyle;
 import com.hjq.toast.style.WhiteToastStyle;
@@ -21,20 +26,34 @@
  *    time   : 2018/09/01
  *    desc   : ToastUtils 使用案例
  */
-public final class ToastActivity extends AppCompatActivity {
+public final class MainActivity extends AppCompatActivity {
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        setContentView(R.layout.activity_toast);
+        setContentView(R.layout.activity_main);
+
+        TitleBar titleBar = findViewById(R.id.tb_main_bar);
+        titleBar.setOnTitleBarListener(new OnTitleBarListener() {
+            @Override
+            public void onTitleClick(TitleBar titleBar) {
+                Intent intent = new Intent(Intent.ACTION_VIEW);
+                intent.setData(Uri.parse(titleBar.getTitle().toString()));
+                startActivity(intent);
+            }
+        });
     }
 
     public void show1(View v) {
         ToastUtils.show("我是普通的 Toast");
     }
 
-    @SuppressWarnings("AlibabaAvoidManuallyCreateThread")
     public void show2(View v) {
+        ToastUtils.delayedShow("我是延迟 2 秒显示的 Toast", 2000);
+    }
+
+    @SuppressWarnings("AlibabaAvoidManuallyCreateThread")
+    public void show3(View v) {
         new Thread(new Runnable() {
 
             @Override
@@ -44,23 +63,23 @@ public void run() {
         }).start();
     }
 
-    public void show3(View v) {
+    public void show4(View v) {
         ToastUtils.setStyle(new WhiteToastStyle());
         ToastUtils.show("动态切换白色吐司样式成功");
     }
 
-    public void show4(View v) {
+    public void show5(View v) {
         ToastUtils.setStyle(new BlackToastStyle());
         ToastUtils.show("动态切换黑色吐司样式成功");
     }
 
-    public void show5(View v) {
+    public void show6(View v) {
         ToastUtils.setView(R.layout.toast_custom_view);
         ToastUtils.setGravity(Gravity.CENTER);
         ToastUtils.show("自定义 Toast 布局");
     }
 
-    public void show6(View v) {
+    public void show7(View v) {
         Snackbar.make(getWindow().getDecorView(), "正在准备跳转到手机桌面，请系好安全带", Snackbar.LENGTH_SHORT).show();
 
         v.postDelayed(new Runnable() {
@@ -76,15 +95,19 @@ public void run() {
             @Override
             public void run() {
                 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-                    ToastUtils.show("我是在后台显示的 Toast（Android 11 及以上在后台显示 Toast 只能使用系统样式）");
+                    if (XXPermissions.isGranted(MainActivity.this, Permission.SYSTEM_ALERT_WINDOW)) {
+                        ToastUtils.show("我是在后台显示的 Toast（有悬浮窗权限真的可以为所欲为）");
+                    } else {
+                        ToastUtils.show("我是在后台显示的 Toast（Android 11 及以上在后台显示 Toast 只能使用系统样式）");
+                    }
                 } else {
                     ToastUtils.show("我是在后台显示的 Toast");
                 }
             }
         }, 3000);
     }
 
-    public void show7(View v) {
+    public void show8(View v) {
         new XToast<>(this)
                 .setDuration(1000)
                 // 将 ToastUtils 中的 View 转移给 XToast 来显示