-
-
Notifications
You must be signed in to change notification settings - Fork 4
Troubleshooting
In this section, you will find answers to all the most common problems, you may encounter, while working with this application. If you don't find an answer, be sure to post about it in the Discussion or Issues section. Thank you for helping to improve this project!
- In this repository's Releases section, I can download binary files but my browser does not recommend downloading them.
- My operating system does not trust the downloaded binary from the Releases section!
The browser and OS checks that there are executable files inside the archive, which in theory could be dangerous. But there is no danger in my archives — just continue to download and check the file with any antivirus. Even better - build binaries by yourself! Instructions are in the Building section of this Wiki.
P.S. I am going to put the applications in app Stores, but this will require further financial investment and time, so please do not wait for it in the near future.
- How do I know if I changed all the icons or not?
At this moment, you should have more than 30 files overwritten during replacement (if all platforms are enabled via
flutter config). Specifically:
| Platform | Overwrites |
|---|---|
| Android (regular) | 5 |
| iOS | 15 |
| macOS | 7 |
| Web | 3+ |
| Windows | 1 |
- Icons have been created, but they have not changed!
Your project was probably created in Flutter version 1.21 or older. For example, on older versions of Flutter, the icons for Android were saved in the folder "hdpi" but now they are stored in the folder "mipmap"; also, the Flutter Team sometimes changing the icon folders and files, depending on the Flutter version. If possible, please update the project runners to the most current version via deleting old runner folders and recreating them with
flutter create .command from the root folder.
- The application should have a menu showing the issues in my PNG file, but I don't have one!
If the file has no issues, then the flashing icon with an exclamation mark will not be displayed because there is no reason. There are no problems in the file(s), and that's most likely your case, congrats!
- What is the name of a generated archive (with icons)?
icons.zip
- Cannot build a project on any platform, analyzer shows a lot of errors.
Your version of Dart SDK most likely enforces null-safety, not all dependencies support it yet. Try to downgrade the Dart SDK version and building it with the flag:
--no-sound-null-safety
- Device Preview doesn't show off any device (just icon).
Flutter SVG package doesn't work without SKIA on the web. Use this flag for proper SVGs showing:
--no-sound-null-safety --dart-define=FLUTTER_WEB_USE_SKIA=true
The web version of this project exists only for evaluation purposes. Flutter for the web is still not in perfect condition and the only benefit of the PWA version (at the moment) is the presence of drag and drop. Please try the native version for your OS — its performance is several times higher than the PWA.
- Browser hangs or does not respond when exporting icons.
Unfortunately, Flutter blocks the UI thread (when resizing images) in the web version, because no Isolates are available here. So yeah, this is normal behavior at the moment, anyway — exporting usually takes a few dozen seconds at max.
- Browser suspects the downloaded archive with icons.
There are no executables or dynamic libraries in the archive, only pictures and configuration files. Build a project from the source code and check for yourself.
- Drag and drop or language search in the settings menu does not work.
Your browser is not likely to be Chrome, Flutter's support for Firefox and other non-Chromium browsers is currently limited. Please try to open a web-page in Chrome v83 or newer.
- Issue info Тriangle's tooltip showing unexpected character.
Flutter Web with SKIA enabled, cannot show special symbols as ℹ️ yet.
- Page does not open or opens an empty page.
You are most likely to use Internet Explorer, Safari, etc. These browsers are not supported in Flutter Web. Please try to open a web-page in Chrome v83 or newer.
- My PWA has a strange name!
This application also generates
index.htmlandmanifest.jsonfiles, you need to either copy only lines with addresses and sizes of icons and paste them into existing files of your project, or completely replace existing files and then use the "Find and Replace" function of your IDE, by the keywordCHANGE_TO_YOUR_APP_NAMEand your real app name accordingly.
- Where can I find my generated archive with icons?
To find the default location of the “Downloads” folder, please use these official instructions.
- I've exported the icons again, but the old version of the archive is in the folder.
Most likely the archive with icons is used by the system or opened in another program, please close all programs that use the archive and try again.
- Where can I find my generated archive with icons?
To find the default location of the “Downloads” folder, please use these official instructions. For Windows 10, 8, 7 and Vista usually, it's:
\Users\<username>\Downloads
- Where can I find my generated archive with icons?
To find the default location of the “Downloads” folder, please use these official instructions. Usually, it's:
/Users/<username>/Downloads
- Where can I find my generated archive with icons?
To find the default location of the “Downloads” folder, please use these official Ubuntu instructions. Usually, it's: /
home/<username>/Downloads
- I pressed the "Browse" button to select the files, but nothing happens.
Most likely, the first time you started the app, you have restricted access to the device's storage. Either allow access in the application settings menu or remove the application and re-install it again this time, please allow access to the storage (in the popped-up requesting permission menu).
- My icons have completely different shapes/look on certain devices!
Each (Android) mobile device manufacturer, in most cases, installs its own custom homepage launcher, so you never know exactly what shape your icon will be displayed on the final user's device. It all depends on his settings or the settings of the launcher.