I’m facing an issue with my Flutter app only on Android devices. Specifically, when I install and launch the app on my Oppo Reno 3 Pro, all I see is a black screen. However, if I tap randomly on the screen, the keypad pops up, which means the app is working in the background, but the UI is not rendering.
To troubleshoot, I created a new Flutter project and installed it on the same Oppo device, but I faced the same black screen issue. When I test the app on other Android devices, like Poco or Samsung, everything works perfectly, and the UI shows up without any issues.
What I’ve tried so far:
Testing with a new Flutter project (still getting the black screen).
Rebuilding the project (cleaning the build, invalidating caches).
Running the app in debug mode and checking the logs (no significant errors related to UI rendering).
Has anyone else faced this issue with only specific Android devices (like Oppo Reno 3 Pro)? Any suggestions on what might be causing this and how to fix it?
Thank you for your help!
3
Answers
After facing the black screen issue on specific Android devices (like Oppo Reno 3 Pro), I found that adding two meta-data tags to the AndroidManifest.xml file resolved the issue and allowed the UI to render properly.
Here’s what worked for me:
This change worked and now the UI displays correctly on the Oppo Reno 3 Pro and other Android devices.
Special Thanks:
I want to extend my special thanks to Duy Tran for commenting on my question with this helpful link, which provided great insight into Impeller and its effect on Android rendering:
Flutter Impeller Documentation
This documentation was really useful in understanding the issue and how to fix it.
I also have no idea. Could you try to turn on Developer Mode in you device?
Mostly, I face many issues with OPPO device.
Which flutter version you’re using?
Recently versions like 3.27.1 had rendering issues https://github.com/flutter/flutter/issues/161144 on some Android devices because it enabled Impeller (a render engine) by default.
You can disable it and recheck again https://docs.flutter.dev/perf/impeller#android
I reposted it as an answer so you can mark as solved for this topic, thanks