重构 ToastUtils 框架

Author: getActivity

.gitignore

@@ -1,13 +1,11 @@
-*.iml
 .gradle
-/local.properties
-/.idea/workspace.xml
-/.idea/libraries
-.DS_Store
-/build
-/captures
-/.idea
-
-/app/*.pro
+.idea
+.cxx
+.externalNativeBuild
+build
+captures
 
-/library/*.pro
+._*
+*.iml
+.DS_Store
+local.properties

README.md

@@ -1,29 +1,35 @@
-# 吐司工具类
+# 吐司框架
 
-> 码云地址：[Gitee](https://gitee.com/getActivity/ToastUtils)
+* 码云地址：[Gitee](https://gitee.com/getActivity/ToastUtils)
 
-> 博客地址：[只需体验三分钟，你就会跟我一样，爱上这款Toast](https://www.jianshu.com/p/9b174ee2c571)
+* 博客地址：[只需体验三分钟，你就会跟我一样，爱上这款 Toast](https://www.jianshu.com/p/9b174ee2c571)
 
-> 已投入公司项目多时，没有任何毛病，可胜任任何需求，[点击此处下载Demo](ToastUtils.apk)
-
-> 想了解实现原理的可以点击此链接查看：[ToastUtils](library/src/main/java/com/hjq/toast/ToastUtils.java) 源码
+* 已投入公司项目多时，没有任何毛病，可胜任任何需求，[点击此处下载Demo](ToastUtils.apk)
 
 ![](ToastUtils.gif)
 
-#### 本框架意在解决一些常见需求，如果是有一些极端的需求推荐使用 [XToast](https://github.com/getActivity/XToast)
+#### 本框架意在解决一些常见需求，如果是有一些特殊的需求推荐配搭 [XToast](https://github.com/getActivity/XToast) 悬浮窗使用
 
 #### 集成步骤
 
 ```groovy
+android {
+    // 支持 JDK 1.8
+    compileOptions {
+        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
 dependencies {
-    implementation 'com.hjq:toast:8.8'
+    // 吐司框架：https://github.com/getActivity/ToastUtils
+    implementation 'com.hjq:toast:9.0'
 }
 ```
 
-#### 初始化 Toast
+#### 初始化
 
 ```java
-// 在 Application 中初始化
 ToastUtils.init(this);
 ```
 
@@ -33,82 +39,75 @@ ToastUtils.init(this);
 ToastUtils.show("我是吐司");
 ```
 
-#### 其他 API
+#### 取消 Toast
 
 ```java
-// 设置Toast布局
-ToastUtils.setView();
+// 取消 Toast 显示
+ToastUtils.cancel();
+```
 
-// 设置吐司重心
-ToastUtils.setGravity();
+#### 其他 API
 
-// 获取Toast对象
-ToastUtils.getToast();
-```
+```java
+// 设置 Toast 布局及样式
+ToastUtils.setStyle(IToastStyle<?> style);
 
-#### 自定义Toast样式
+// 设置 Toast 重心和偏移
+ToastUtils.setGravity(int gravity, int xOffset, int yOffset);
 
-> 如果对Toast的默认样式不满意，可以在Application初始化样式，具体可参考[ToastBlackStyle](library/src/main/java/com/hjq/toast/style/ToastBlackStyle.java)类的实现
+// 设置 Toast 拦截器
+ToastUtils.setInterceptor(IToastInterceptor interceptor);
 
-```java
-ToastUtils.initStyle(new IToastStyle());
+// 设置 Toast 策略
+ToastUtils.setStrategy(IToastStrategy strategy);
+
+// 设置 Toast 布局
+ToastUtils.setView(int id);
 ```
 
 #### 框架亮点
 
-* 无需权限：不管有没有授予通知栏权限都不影响吐司的弹出
+* 一马当先：首款适配 Android 11 的吐司框架，使用者无需关心适配过程
 
-* 兼容性强：处理原生 Toast 在 Android 7.1 产生崩溃的历史遗留问题
+* 无需权限：[不管有没有授予通知栏权限都不影响吐司的弹出](https://www.jianshu.com/p/1d64a5ccbc7c)
+
+* 兼容性强：[处理原生 Toast 在 Android 7.1 产生崩溃的历史遗留问题](https://www.jianshu.com/p/437f473017d6)
 
 * 功能强大：不分主次线程都可以弹出Toast，自动区分资源 id 和 int 类型
 
 * 使用简单：只需传入文本，会自动根据文本长度决定吐司显示的时长
 
-* 性能最佳：单例吐司，整个 Toast 只有一个 TextView，并且通过代码创建
-
-* 体验最优：限制 Toast 短时间内弹出的次数，避免频繁弹出造成不良的用户体验
-
-* 支持多种样式：默认为黑色样式，夜间模式可使用白色样式，还有仿 QQ 吐司样式
-
-* 支持自定义样式：吐司（背景、圆角、重心、偏移），文字（大小、颜色、边距）
-
-* 支持自定义扩展：支持获取 ToastUtils 中的 Toast 对象，支持重新自定义 Toast 布局
+* 性能最佳：使用懒加载模式，只在显示时创建 Toast，不占用 Application 启动时间
 
-* 支持全局配置样式：可以在 Application 中初始化 Toast 样式，达到一劳永逸的效果
+* 体验最佳：显示下一个 Toast 会取消上一个 Toast 的显示，真正做到即显即示
 
-* 已适配 Android R：Android 11 之后不能弹出自定义样式的 Toast，框架针对这种情况进行了适配
+* 全局统一：可以在 Application 中初始化 Toast 样式，达到一劳永逸的效果
 
 #### 关于通知栏权限
 
-> 本框架已经完美解决这个问题（禁用通知栏权限后需要重启应用、重启应用、重启应用才能后生效，请以[Demo](https://raw.githubusercontent.com/getActivity/ToastUtils/master/ToastUtils.apk)测试为主）
+* 本框架已经完美解决这个问题，即使没有通知栏权限的情况下也能在前台显示 Toast
 
-> 在开启 APP 的同时关闭通知栏权限的情况极少（测试人员才会这么做），所以仅在 Application 初始化的时候才对没有通知栏权限的情况进行判断和兼容
-
-> 具体解决方案可见：[Toast通知栏权限填坑指南](https://www.jianshu.com/p/1d64a5ccbc7c)
+* 具体解决方案参见：[Toast通知栏权限填坑指南](https://www.jianshu.com/p/1d64a5ccbc7c)
 
 ![](issue_taobao.gif)
 
 ![](issue_utils.gif)
 
-#### ToastUtils 架构图
-
-![](ToastUtils.jpg)
+#### 如何替换项目中已有的原生 Toast
 
-#### 如何替换项目中已有的 Toast ？
-
-> 右击项目，Replace in path，勾选 Regex 选项
+* 在项目中右击弹出菜单，Replace in path，勾选 Regex 选项，点击替换
 
 ```java
 Toast\.makeText\([^,]+,\s*(.+{1}),\s*[^,]+\)\.show\(\)
 ```
 
-> 替换使用
+---
 
 ```java
 ToastUtils.show($1)
 ```
 
-> 包名替换
+* 对导包进行替换
 
 ```java
 import android.widget.Toast
@@ -120,20 +119,24 @@ import android.widget.Toast
 import com.hjq.toast.ToastUtils
 ```
 
->  再全局搜索，手动更换一些没有替换成功的
+*  再全局搜索，手动更换一些没有替换成功的
 
 ```java
 Toast.makeText
 ```
 
+---
+
+```java
+new Toast
+```
+
 #### 作者的其他开源项目
 
-* 安卓架构：[AndroidProject](https://github.com/getActivity/AndroidProject)
+* 安卓技术中台：[AndroidProject](https://github.com/getActivity/AndroidProject)
 
 * 网络框架：[EasyHttp](https://github.com/getActivity/EasyHttp)
 
-* 日志框架：[Logcat](https://github.com/getActivity/Logcat)
-
 * 权限框架：[XXPermissions](https://github.com/getActivity/XXPermissions)
 
 * 标题栏框架：[TitleBar](https://github.com/getActivity/TitleBar)
@@ -142,7 +145,15 @@ Toast.makeText
 
 * 悬浮窗框架：[XToast](https://github.com/getActivity/XToast)
 
-#### Android技术讨论Q群：78797078
+* Gson 解析容错：[GsonFactory](https://github.com/getActivity/GsonFactory)
+
+* 日志查看框架：[Logcat](https://github.com/getActivity/Logcat)
+
+#### 微信公众号：Android轮子哥
+
+![](https://raw.githubusercontent.com/getActivity/Donate/master/picture/official_ccount.png)
+
+#### Android 技术分享 QQ 群：78797078
 
 #### 如果您觉得我的开源库帮你节省了大量的开发时间，请扫描下方的二维码随意打赏，要是能打赏个 10.24 :monkey_face:就太:thumbsup:了。您的支持将鼓励我继续创作:octocat:
 

ToastUtils.apk

@@ -5,10 +5,10 @@ android {
 
     defaultConfig {
         applicationId "com.hjq.toast.demo"
-        minSdkVersion 14
+        minSdkVersion 16
         targetSdkVersion 30
-        versionCode 88
-        versionName "8.8"
+        versionCode 90
+        versionName "9.0"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {
@@ -17,17 +17,24 @@ android {
             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
         }
     }
+
+    // 使用 JDK 1.8
+    compileOptions {
+        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_1_8
+    }
 }
 
 dependencies {
     implementation fileTree(include: ['*.jar'], dir: 'libs')
     implementation project(':library')
-    implementation 'androidx.appcompat:appcompat:1.3.0-alpha02'
-    implementation 'com.google.android.material:material:1.3.0-alpha02'
+    implementation 'androidx.appcompat:appcompat:1.2.0'
     // 标题栏：https://github.com/getActivity/TitleBar
-    implementation 'com.hjq:titlebar:8.0'
+    implementation 'com.hjq:titlebar:8.5'
     // 悬浮窗：https://github.com/getActivity/XToast
-    implementation 'com.hjq:xtoast:5.5'
+    implementation 'com.hjq:xtoast:6.9'
     // 内存泄漏捕捉：https://github.com/square/leakcanary
-    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.4'
+    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.7'
+    // 权限请求框架：https://github.com/getActivity/XXPermissions
+    implementation 'com.hjq:xxpermissions:10.6'
 }

ToastUtils.jpg

@@ -0,0 +1 @@
+-keep class com.hjq.toast.** {*;}