I need to fix my deeplink issue

Sathish Gnanavel — Fri, 18 Sep 2026 05:47:57 +0000

Hi everyone,

I have an existing Flutter project where deep linking was working perfectly before. Recently, I upgraded my Flutter SDK, Android Studio, Android SDK, Gradle/AGP, etc. The project code and deep-link implementation were not intentionally changed.

After the upgrade, I’m facing two issues:

Debug build:
When the app is running in the background and I open a deep link from WhatsApp/Google Chat, the app sometimes crashes or gets stuck on a black screen. I’m seeing logs related to SurfaceView, performTraversals, predraw, and WIN DEATH.

Release build:
The app opens from the deep link, but it appears to take over the Android task/intent stack. After opening the link from WhatsApp or Google Chat, I cannot reopen the originating app normally until I close my Flutter application.

I have already verified that Digital Asset Links / assetlinks.json is not the issue. The same deep-link implementation worked correctly before the environment upgrades.

I suspect this may be related to Android activity/task configuration, such as launchMode, taskAffinity, intent flags, MainActivity, startup theme/window configuration, or changes in Flutter/AGP/Android behavior.

Has anyone experienced this after upgrading Flutter/Android tooling? What configuration should I check or change to fix both the debug black-screen/crash and the release task-stack behavior?

DEV Community: Sathish Gnanavel

I need to fix my deeplink issue