优化类名命名及代码注释

getActivity · getActivity · commit 0541c554e84e · 2020-10-11T10:39:33.000+08:00
优化及抽取 Toast 创建的策略
优化匹配原生 Toast 的正则表达式
diff --git a/README.md b/README.md
@@ -6,69 +6,77 @@
 
 > 已投入公司项目多时，没有任何毛病，可胜任任何需求，[点击此处下载Demo](ToastUtils.apk)
 
-> 想了解实现原理的可以点击此链接查看：[ToastUtils](https://github.com/getActivity/ToastUtils/blob/master/library/src/main/java/com/hjq/toast/ToastUtils.java) 源码
+> 想了解实现原理的可以点击此链接查看：[ToastUtils](library/src/main/java/com/hjq/toast/ToastUtils.java) 源码
 
 ![](ToastUtils.gif)
 
 #### 本框架意在解决一些常见需求，如果是有一些极端的需求推荐使用 [XToast](https://github.com/getActivity/XToast)
 
 #### 集成步骤
 
-    dependencies {
-        implementation 'com.hjq:toast:8.6'
-    }
+```groovy
+dependencies {
+    implementation 'com.hjq:toast:8.8'
+}
+```
 
 #### 初始化 Toast
 
-    // 在 Application 中初始化
-    ToastUtils.init(this);
+```java
+// 在 Application 中初始化
+ToastUtils.init(this);
+```
 
 #### 显示 Toast
 
-    ToastUtils.show("我是吐司");
+```java
+ToastUtils.show("我是吐司");
+```
 
 #### 其他 API
 
-    // 设置Toast布局
-    ToastUtils.setView();
+```java
+// 设置Toast布局
+ToastUtils.setView();
 
-    // 设置吐司重心
-    ToastUtils.setGravity();
+// 设置吐司重心
+ToastUtils.setGravity();
 
-    // 获取Toast对象
-    ToastUtils.getToast();
+// 获取Toast对象
+ToastUtils.getToast();
+```
 
 #### 自定义Toast样式
 
-> 如果对Toast的默认样式不满意，可以在Application初始化样式，具体可参考[ToastBlackStyle](https://github.com/getActivity/ToastUtils/blob/master/library/src/main/java/com/hjq/toast/style/ToastBlackStyle.java)类的实现
+> 如果对Toast的默认样式不满意，可以在Application初始化样式，具体可参考[ToastBlackStyle](library/src/main/java/com/hjq/toast/style/ToastBlackStyle.java)类的实现
 
-    ToastUtils.initStyle(new IToastStyle());
-
-#### 混淆规则
-
-    -keep class com.hjq.toast.** {*;}
+```java
+ToastUtils.initStyle(new IToastStyle());
+```
 
 #### 框架亮点
 
 * 无需权限：不管有没有授予通知栏权限都不影响吐司的弹出
 
-* 功能强大：不分主次线程都可以弹出Toast，自动区分资源id和int类型
+* 兼容性强：处理原生 Toast 在 Android 7.1 产生崩溃的历史遗留问题
+
+* 功能强大：不分主次线程都可以弹出Toast，自动区分资源 id 和 int 类型
 
 * 使用简单：只需传入文本，会自动根据文本长度决定吐司显示的时长
 
-* 性能最佳：单例吐司，整个Toast只有一个TextView，并且通过代码创建
+* 性能最佳：单例吐司，整个 Toast 只有一个 TextView，并且通过代码创建
 
-* 体验最优：限制Toast短时间内弹出的次数，避免频繁弹出造成不良的用户体验
+* 体验最优：限制 Toast 短时间内弹出的次数，避免频繁弹出造成不良的用户体验
 
-* 支持多种样式：默认为黑色样式，夜间模式可使用白色样式，还有仿QQ吐司样式
+* 支持多种样式：默认为黑色样式，夜间模式可使用白色样式，还有仿 QQ 吐司样式
 
 * 支持自定义样式：吐司（背景、圆角、重心、偏移），文字（大小、颜色、边距）
 
-* 支持自定义扩展：支持获取ToastUtils中的Toast对象，支持重新自定义Toast布局
+* 支持自定义扩展：支持获取 ToastUtils 中的 Toast 对象，支持重新自定义 Toast 布局
 
-* 支持全局配置样式：可以在Application中初始化Toast样式，达到一劳永逸的效果
+* 支持全局配置样式：可以在 Application 中初始化 Toast 样式，达到一劳永逸的效果
 
-* 框架兼容性良好：本框架不依赖任何第三方库，支持 Eclipse 和 Studio 的集成使用
+* 已适配 Android R：Android 11 之后不能弹出自定义样式的 Toast，框架针对这种情况进行了适配
 
 #### 关于通知栏权限
 
@@ -90,23 +98,37 @@
 
 > 右击项目，Replace in path，勾选 Regex 选项
 
-	Toast\.makeText\([^,]+,\s(.+{1}),\s[^,]+\)\.show\(\);
+```java
+Toast\.makeText\([^,]+,\s*(.+{1}),\s*[^,]+\)\.show\(\)
+```
 
 > 替换使用
 
-	ToastUtils.show($1);
+```java
+ToastUtils.show($1)
+```
 
 > 包名替换
 
-	import android.widget.Toast;
+```java
+import android.widget.Toast
+```
 
 ---
 
-	import com.hjq.toast.ToastUtils;
+```java
+import com.hjq.toast.ToastUtils
+```
+
+>  再全局搜索，手动更换一些没有替换成功的
+
+```java
+Toast.makeText
+```
 
 #### 作者的其他开源项目
 
-* 架构工程：[AndroidProject](https://github.com/getActivity/AndroidProject)
+* 安卓架构：[AndroidProject](https://github.com/getActivity/AndroidProject)
 
 * 网络框架：[EasyHttp](https://github.com/getActivity/EasyHttp)
 
diff --git a/ToastUtils.apk b/ToastUtils.apk
diff --git a/app/build.gradle b/app/build.gradle
@@ -7,8 +7,8 @@ android {
         applicationId "com.hjq.toast.demo"
         minSdkVersion 14
         targetSdkVersion 30
-        versionCode 86
-        versionName "8.6"
+        versionCode 88
+        versionName "8.8"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
     buildTypes {
@@ -22,10 +22,10 @@ android {
 dependencies {
     implementation fileTree(include: ['*.jar'], dir: 'libs')
     implementation project(':library')
-    implementation 'androidx.appcompat:appcompat:1.3.0-alpha01'
-    implementation 'com.google.android.material:material:1.3.0-alpha01'
+    implementation 'androidx.appcompat:appcompat:1.3.0-alpha02'
+    implementation 'com.google.android.material:material:1.3.0-alpha02'
     // 标题栏：https://github.com/getActivity/TitleBar
-    implementation 'com.hjq:titlebar:6.5'
+    implementation 'com.hjq:titlebar:8.0'
     // 悬浮窗：https://github.com/getActivity/XToast
     implementation 'com.hjq:xtoast:5.5'
     // 内存泄漏捕捉：https://github.com/square/leakcanary
diff --git a/app/src/main/java/com/hjq/toast/demo/ToastActivity.java b/app/src/main/java/com/hjq/toast/demo/ToastActivity.java
@@ -7,7 +7,7 @@
 import androidx.appcompat.app.AppCompatActivity;
 import androidx.core.app.NotificationManagerCompat;
 
-import com.hjq.toast.SupportToast;
+import com.hjq.toast.CustomToast;
 import com.hjq.toast.ToastUtils;
 import com.hjq.toast.style.ToastAliPayStyle;
 import com.hjq.toast.style.ToastBlackStyle;
@@ -87,10 +87,10 @@ protected void onRestart() {
         // 请注意这段代码强烈建议不要放到实际开发中，因为用户屏蔽通知栏和开启应用状态下的概率极低，可以忽略不计
 
         // 如果通知栏的权限被手动关闭了
-        if (!SupportToast.class.equals(ToastUtils.getToast().getClass()) &&
+        if (!CustomToast.class.equals(ToastUtils.getToast().getClass()) &&
                         !NotificationManagerCompat.from(this).areNotificationsEnabled()) {
             // 因为吐司只有初始化的时候才会判断通知权限有没有开启，根据这个通知开关来显示原生的吐司还是兼容的吐司
-            ToastUtils.setToast(new SupportToast(getApplication()));
+            ToastUtils.setToast(new CustomToast(getApplication()));
             getWindow().getDecorView().postDelayed(new Runnable() {
                 @Override
                 public void run() {
diff --git a/library/build.gradle b/library/build.gradle
@@ -2,21 +2,20 @@ apply plugin: 'com.android.library'
 apply plugin: 'com.novoda.bintray-release'
 
 android {
-    compileSdkVersion 26
+    compileSdkVersion 30
 
     defaultConfig {
-        minSdkVersion 3
-        targetSdkVersion 26
-        versionCode 86
-        versionName "8.6"
+        minSdkVersion 4
+        versionCode 88
+        versionName "8.8"
     }
 }
 
 publish {
     userOrg = 'getactivity'
     groupId = 'com.hjq'
     artifactId = 'toast'
-    version = '8.6'
+    version = '8.8'
     description = 'This is a very functional Toast'
     website = "https://github.com/getActivity/ToastUtils"
 }
diff --git a/library/src/main/java/com/hjq/toast/CustomToast.java b/library/src/main/java/com/hjq/toast/CustomToast.java
@@ -7,9 +7,9 @@
  *    author : Android 轮子哥
  *    github : https://github.com/getActivity/ToastUtils
  *    time   : 2018/11/02
- *    desc   : Toast 无通知栏权限兼容
+ *    desc   : 自定义 Toast（用于解决关闭通知栏权限之后不能弹吐司的问题和 Android 11 不能自定义吐司样式的问题）
  */
-public final class SupportToast extends BaseToast {
+public final class CustomToast extends NormalToast {
 
     /** 吐司弹窗显示辅助类 */
     private final ToastHelper mToastHelper;
@@ -27,20 +27,20 @@ public final class SupportToast extends BaseToast {
     /** 垂直间距百分比 */
     private float mVerticalMargin;
 
-    public SupportToast(Application application) {
+    public CustomToast(Application application) {
         super(application);
         mToastHelper = new ToastHelper(this, application);
     }
 
     @Override
     public void show() {
-        // 显示吐司
+        // 替换成 WindowManager 来显示
         mToastHelper.show();
     }
 
     @Override
     public void cancel() {
-        // 取消显示
+        // 取消 WindowManager 的显示
         mToastHelper.cancel();
     }
 
diff --git a/library/src/main/java/com/hjq/toast/IToastStrategy.java b/library/src/main/java/com/hjq/toast/IToastStrategy.java
@@ -1,5 +1,6 @@
 package com.hjq.toast;
 
+import android.app.Application;
 import android.widget.Toast;
 
 /**
@@ -16,7 +17,12 @@ public interface IToastStrategy {
     int LONG_DURATION_TIMEOUT = 3500;
 
     /**
-     * 绑定 Toast 对象
+     * 创建 Toast
+     */
+    Toast create(Application application);
+
+    /**
+     * 绑定 Toast
      */
     void bind(Toast toast);
 
diff --git a/library/src/main/java/com/hjq/toast/NormalToast.java b/library/src/main/java/com/hjq/toast/NormalToast.java
@@ -10,14 +10,14 @@
  *    author : Android 轮子哥
  *    github : https://github.com/getActivity/ToastUtils
  *    time   : 2018/11/03
- *    desc   : Toast 基类
+ *    desc   : 普通的 Toast
  */
-public class BaseToast extends Toast {
+public class NormalToast extends Toast {
 
     /** 吐司消息 View */
     private TextView mMessageView;
 
-    public BaseToast(Application application) {
+    public NormalToast(Application application) {
         super(application);
     }
 
diff --git a/library/src/main/java/com/hjq/toast/SafeToast.java b/library/src/main/java/com/hjq/toast/SafeToast.java
@@ -12,10 +12,10 @@
  *    author : Android 轮子哥
  *    github : https://github.com/getActivity/ToastUtils
  *    time   : 2018/12/06
- *    desc   : Toast 显示安全处理
+ *    desc   : Toast 崩溃处理
  */
 @TargetApi(Build.VERSION_CODES.KITKAT)
-public final class SafeToast extends BaseToast {
+public final class SafeToast extends NormalToast {
 
     public SafeToast(Application application) {
         super(application);
diff --git a/library/src/main/java/com/hjq/toast/ToastStrategy.java b/library/src/main/java/com/hjq/toast/ToastStrategy.java
@@ -1,10 +1,18 @@
 package com.hjq.toast;
 
+import android.app.AppOpsManager;
+import android.app.Application;
+import android.app.NotificationManager;
+import android.content.Context;
+import android.os.Build;
 import android.os.Handler;
 import android.os.Looper;
 import android.os.Message;
 import android.widget.Toast;
 
+import java.lang.reflect.Field;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
 import java.util.Queue;
 import java.util.concurrent.ArrayBlockingQueue;
 
@@ -43,6 +51,36 @@ public ToastStrategy() {
         mQueue = getToastQueue();
     }
 
+    @Override
+    public Toast create(Application application) {
+        Toast toast;
+        // 初始化吐司
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            // 适配 Android 11 无法使用自定义 Toast 的问题
+            // 官方文档：https://developer.android.google.cn/preview/features/toasts
+            toast = new CustomToast(application);
+        } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.N_MR1) {
+            // 处理 Android 7.1 上 Toast 在主线程被阻塞后会导致报错的问题
+            toast = new SafeToast(application);
+        } else {
+            boolean check =
+                    // 对比不同版本的 NMS 的源码发现这个问题在 Android 9.0 已经被谷歌修复了
+                    Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q ||
+                            // 判断当前应用是否有通知栏权限，如果关闭会导致弹 Toast 无法显示
+                            areNotificationsEnabled(application) ||
+                            // 判断当前是否是小米手机，因为只有小米手机做了特殊处理，就算没有通知栏权限也能弹吐司
+                            "xiaomi".equals(Build.MANUFACTURER.toLowerCase());
+            if (check) {
+                // 检查通过，返回正常类型的 Toast 即可
+                toast = new NormalToast(application);
+            } else {
+                // 修复关闭通知栏权限后 Toast 不显示的问题
+                toast = new CustomToast(application);
+            }
+        }
+        return toast;
+    }
+
     @Override
     public void bind(Toast toast) {
         mToast = toast;
@@ -122,7 +160,30 @@ public Queue<CharSequence> getToastQueue() {
      * 根据文本来获取吐司的显示时长
      */
     public int getToastDuration (CharSequence text) {
-        // 如果显示的文字超过了10个就显示长吐司，否则显示短吐司
+        // 如果显示的文字超过了 20 个字符就显示长吐司，否则显示短吐司
         return text.length() > 20 ? LONG_DURATION_TIMEOUT : SHORT_DURATION_TIMEOUT;
     }
+
+    /**
+     * 检查通知栏权限有没有开启
+     *
+     * 参考 SupportCompat 包中的方法： NotificationManagerCompat.from(context).areNotificationsEnabled();
+     */
+    private static boolean areNotificationsEnabled(Context context) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+            return context.getSystemService(NotificationManager.class).areNotificationsEnabled();
+        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            AppOpsManager appOps = (AppOpsManager) context.getSystemService(Context.APP_OPS_SERVICE);
+            try {
+                Method method = appOps.getClass().getMethod("checkOpNoThrow", Integer.TYPE, Integer.TYPE, String.class);
+                Field field = appOps.getClass().getDeclaredField("OP_POST_NOTIFICATION");
+                int value = (Integer) field.get(Integer.class);
+                return ((int) method.invoke(appOps, value, context.getApplicationInfo().uid, context.getPackageName())) == AppOpsManager.MODE_ALLOWED;
+            } catch (NoSuchMethodException | NoSuchFieldException | InvocationTargetException | IllegalAccessException | RuntimeException ignored) {
+                return true;
+            }
+        } else {
+            return true;
+        }
+    }
 }
diff --git a/library/src/main/java/com/hjq/toast/ToastUtils.java b/library/src/main/java/com/hjq/toast/ToastUtils.java
