处理在 Android 16 上 startActivity 时显示自定义的 Toast 会出现残影的问题

getActivity · getActivity · commit 06ecaee0f095 · 2025-08-31T22:16:08.000+08:00
diff --git a/app/src/main/java/com/hjq/toast/demo/MainActivity.java b/app/src/main/java/com/hjq/toast/demo/MainActivity.java
@@ -98,6 +98,12 @@ public void run() {
         }).start();
     }
 
+    public void startActivityShowToast(View v) {
+        Toaster.show(R.string.demo_show_toast_result);
+        startActivity(new Intent(this, MainActivity.class));
+        finish();
+    }
+
     public void switchToastStyleToWhite(View v) {
         ToastParams params = new ToastParams();
         params.text = getString(R.string.demo_switch_to_white_style_result);
diff --git a/app/src/main/res/layout/activity_main.xml b/app/src/main/res/layout/activity_main.xml
@@ -78,6 +78,14 @@
                     android:onClick="threadShowToast"
                     android:text="@string/demo_show_toast_in_the_subthread" />
 
+                <Button
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_gravity="center_horizontal"
+                    android:layout_marginTop="10dp"
+                    android:onClick="startActivityShowToast"
+                    android:text="@string/demo_show_toast_in_the_start_activity" />
+
                 <Button
                     android:layout_width="wrap_content"
                     android:layout_height="wrap_content"
diff --git a/app/src/main/res/values-zh/strings.xml b/app/src/main/res/values-zh/strings.xml
@@ -7,6 +7,7 @@
     <string name="demo_show_cross_page_toast">显示一个跨页面的 Toast</string>
     <string name="demo_show_toast_with_two_second_delay">延迟 2 秒显示 Toast</string>
     <string name="demo_show_toast_in_the_subthread">在子线程中显示吐司</string>
+    <string name="demo_show_toast_in_the_start_activity">在跳转 Activity 时显示吐司</string>
     <string name="demo_switch_to_white_style">切换为白色样式（局部生效）</string>
     <string name="demo_switch_to_black_style">切换为黑色样式（局部生效）</string>
     <string name="demo_switch_to_hint_style">切换为提示样式（局部生效）</string>
@@ -25,6 +26,7 @@
     <string name="demo_show_cross_page_toast_result">我是跨页面显示的 Toast</string>
     <string name="demo_show_toast_with_two_second_delay_result">我是延迟 2 秒显示的 Toast</string>
     <string name="demo_show_toast_in_the_subthread_result">我是子线程中弹出的吐司</string>
+    <string name="demo_show_toast_in_the_start_activity_result">我是在 startActivity 时弹出的吐司</string>
     <string name="demo_switch_to_white_style_result">我是白色样式的 Toast</string>
     <string name="demo_switch_to_black_style_result">我是黑色样式的 Toast</string>
     <string name="demo_switch_to_info_style_result">我是提示样式的 Toast</string>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
@@ -8,6 +8,7 @@
     <string name="demo_show_cross_page_toast">Show a cross page toast</string>
     <string name="demo_show_toast_with_two_second_delay">Show toast with 2 second delay</string>
     <string name="demo_show_toast_in_the_subthread">Show toast in the subthread</string>
+    <string name="demo_show_toast_in_the_start_activity">Show toast in the startActivity</string>
     <string name="demo_switch_to_white_style">Switch to white style (local effect)</string>
     <string name="demo_switch_to_black_style">Switch to black style (local effect)</string>
     <string name="demo_switch_to_hint_style">Switch to hint style (local effect)</string>
@@ -26,6 +27,7 @@
     <string name="demo_show_cross_page_toast_result">I am a cross page toast</string>
     <string name="demo_show_toast_with_two_second_delay_result">I am a toast displayed with a delay of 2 seconds</string>
     <string name="demo_show_toast_in_the_subthread_result">I am the toast that pops up in the subthread</string>
+    <string name="demo_show_toast_in_the_start_activity_result">I am the toast that pops up when startActivity</string>
     <string name="demo_switch_to_white_style_result">I am toast in white style</string>
     <string name="demo_switch_to_black_style_result">I am toast in black style</string>
     <string name="demo_switch_to_info_style_result">I am a toast of hint style</string>
diff --git a/library/src/main/java/com/hjq/toast/ActivityStack.java b/library/src/main/java/com/hjq/toast/ActivityStack.java
@@ -40,34 +40,57 @@ public void register(Application application) {
         application.registerActivityLifecycleCallbacks(this);
     }
 
-    /** 前台 Activity 对象 */
-    private Activity mForegroundActivity;
+    /** 当前焦点的 Activity 对象 */
+    private Activity mFocusActivity;
 
-    public Activity getForegroundActivity() {
-        return mForegroundActivity;
+    /** 当前可见的 Activity 对象 */
+    private Activity mVisibleActivity;
+
+    /** Activity 可见时候的时间戳 */
+    private long mActivityResumedTime;
+
+    public Activity getFocusActivity() {
+        return mFocusActivity;
+    }
+
+    public Activity getVisibleActivity() {
+        return mVisibleActivity;
+    }
+
+    public long getActivityResumedTime() {
+        return mActivityResumedTime;
     }
 
     @Override
     public void onActivityCreated(Activity activity, Bundle savedInstanceState) {}
 
     @Override
-    public void onActivityStarted(Activity activity) {}
+    public void onActivityStarted(Activity activity) {
+        mFocusActivity = activity;
+    }
 
     @Override
     public void onActivityResumed(Activity activity) {
-        mForegroundActivity = activity;
+        mVisibleActivity = activity;
+        mActivityResumedTime = System.currentTimeMillis();
     }
 
     @Override
     public void onActivityPaused(Activity activity) {
-        if (mForegroundActivity != activity) {
+        if (mFocusActivity != activity) {
             return;
         }
-        mForegroundActivity = null;
+        mFocusActivity = null;
     }
 
     @Override
-    public void onActivityStopped(Activity activity) {}
+    public void onActivityStopped(Activity activity) {
+        if (mVisibleActivity != activity) {
+            return;
+        }
+        mVisibleActivity = null;
+        mActivityResumedTime = 0;
+    }
 
     @Override
     public void onActivitySaveInstanceState(Activity activity, Bundle outState) {}
diff --git a/library/src/main/java/com/hjq/toast/ToastStrategy.java b/library/src/main/java/com/hjq/toast/ToastStrategy.java
@@ -7,8 +7,6 @@
 import android.app.NotificationManager;
 import android.content.Context;
 import android.os.Build;
-import android.os.Build.VERSION;
-import android.os.Build.VERSION_CODES;
 import android.os.Handler;
 import android.os.Looper;
 import android.os.SystemClock;
@@ -95,19 +93,19 @@ public int computeShowDuration(CharSequence text) {
 
     @Override
     public IToast createToast(ToastParams params) {
-        Activity foregroundActivity = getForegroundActivity();
+        Activity availableActivity = getAvailableActivity();
         IToast toast;
         if ((params.priorityType == ToastParams.PRIORITY_TYPE_DEFAULT ||
              params.priorityType == ToastParams.PRIORITY_TYPE_GLOBAL) &&
                 Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&
                 Settings.canDrawOverlays(mApplication)) {
             // 如果有悬浮窗权限，就开启全局的 Toast
             toast = new GlobalToast(mApplication);
-        } else if ((params.priorityType == ToastParams.PRIORITY_TYPE_DEFAULT ||
-                    params.priorityType == ToastParams.PRIORITY_TYPE_LOCAL) &&
-                    isActivityAvailable(foregroundActivity)) {
+        } else if (availableActivity != null &&
+                  (params.priorityType == ToastParams.PRIORITY_TYPE_DEFAULT ||
+                  params.priorityType == ToastParams.PRIORITY_TYPE_LOCAL)) {
             // 如果没有悬浮窗权限，就开启一个依附于 Activity 的 Toast
-            toast = new ActivityToast(foregroundActivity);
+            toast = new ActivityToast(availableActivity);
         } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.N_MR1) {
             // 处理 Android 7.1 上 Toast 在主线程被阻塞后会导致报错的问题
             toast = new SafeToast(mApplication);
@@ -175,14 +173,7 @@ protected static Handler getHandler() {
      * 生成默认延迟时间
      */
     protected int generateShowDelayTime(ToastParams params) {
-        // 延迟一段时间之后再执行，因为在没有通知栏权限的情况下，Toast 只能显示在当前 Activity 上面（即使用 ActivityToast）
-        // 如果当前 Activity 在 showToast 之后立马进行 finish 了，那么这个时候 Toast 可能会显示不出来
-        // 因为 Toast 会显示在销毁 Activity 界面上，而不会显示在新跳转的 Activity 上面，所以会导致显示不出来的问题
-        // 另外有悬浮窗权限的情况下，使用全局的 Toast（即使用 GlobalToast），这种立刻显示也会有一些问题
-        // 我在小米 12 Android 12 的手机上面测试，从权限设置页返回的时候，发现 Toast 有几率会从左上的位置显示，然后会变回正常的位置
-        // 如果是系统的 Toast（即使用 SystemToast、SafeToast、NotificationToast 任意一个）则不会有这个问题
-        // 300 只是一个经验值，经过很多次验证得出来的值，当然你觉得这个值不是自己想要的，也可以重写此方法改成自己想要的
-        return 300;
+        return 100;
     }
 
     /**
@@ -327,27 +318,40 @@ protected boolean areNotificationsEnabled(Context context) {
     }
 
     /**
-     * 获取前台的 Activity
+     * 获取可用的 Activity
      */
-    protected Activity getForegroundActivity() {
-        return ActivityStack.getInstance().getForegroundActivity();
-    }
+    protected Activity getAvailableActivity() {
+        Activity visibleActivity = ActivityStack.getInstance().getVisibleActivity();
+        Activity focusActivity = ActivityStack.getInstance().getFocusActivity();
+        if (focusActivity == null || visibleActivity == null) {
+            return null;
+        }
 
-    /**
-     * Activity 是否可用
-     */
-    protected boolean isActivityAvailable(Activity activity) {
-        if (activity == null) {
-            return false;
+        if (focusActivity != visibleActivity) {
+            return null;
         }
 
-        if (activity.isFinishing()) {
-            return false;
+        if (visibleActivity.isFinishing()) {
+            return null;
         }
 
-        if (VERSION.SDK_INT >= VERSION_CODES.JELLY_BEAN_MR1) {
-            return !activity.isDestroyed();
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && visibleActivity.isDestroyed()) {
+            return null;
         }
-        return true;
+
+        long resumedActivityTime = ActivityStack.getInstance().getActivityResumedTime();
+        // 如果这个 Activity 可见时长没有超过 200 毫秒，则证明 Activity 是刚跳转的，
+        // 在这种情况下，如果直接拿来显示 WindowManager 是会有问题的，在 Android 16 上面会出现残影的情况
+        // Github issue 地址：https://github.com/getActivity/Toaster/issues/150
+        // 目前能想到比较好的解决方案是：必须 Activity 可见时长超过 200 毫秒才可以，
+        // 否则就不能用 Activity 来显示 Toast，只能用系统的 Toast 来显示了，
+        // 如果你想要在 startActivity 的时候，又能显示自定义 Toast 的效果，
+        // 建议在显示 show 的时候加一下延迟显示，建议设置在 500 毫秒及以上，
+        // 以确保 Toast 在显示的时候不受 Android 16 残影问题的影响。
+        if (System.currentTimeMillis() - resumedActivityTime < 200) {
+            return null;
+        }
+
+        return visibleActivity;
     }
 }
