Skip to content

Workarounds for common issues

Jump to bottom
Günter Zöchbauer edited this page Jan 24, 2019 · 13 revisions

Common issues Flutter developers might run into and recipes how to fix or work around.

Flutter Recipes

Flutter installation

Flutter installation corrupted

The Flutter install directory is in an inconsistent state and that causes all kinds of troubles.

Symptoms

Causes

Unclear

Ways to fix

  • Run the following commands in the Flutter install directory:

git clean -xfd
git stash save --keep-index
git stash drop
git pull
flutter doctor
🔥

The git stash drop command drops customizations you might have made to the Flutter installation.

Flutter project files

Generated project files outdated

Symptoms

Causes

When a project is created with flutter create foo several files in the ios/ and android/ sub-directories are created.

Newer Flutter versions might generate these files a bit differently and projects created with older Flutter versions might cause issues.

Ways to fix

  • Delete the ios/ and android/ directories and run flutter create . to re-generate these directories.

🔥

Custom changes will be lost and need to be re-applied. This is easiest if the project is committed to a version control system like Git.

Pub dependencies

Corrupted cache

Especially with plugin packages it was seen several times that the package in the pub cache was corrupted.

Symptoms

Usually syntax errors at build time about code in dependencies.

Causes

Unknown. IDEs or editors used by developers might not prevent editing plugin files and when they navigate into plugin code they might accidentally modify the code.

Ways to fix

  • Run pub cache repair This might take quite some time and re-downloads every package in the cache, even outdated versions that might not be used anymore by any project on disk.

  • Delete ~/.pub-cache/hosted and/or ~/.pub-cache/git (for Git dependencies). This requires to run flutter packages get in all active projects on your machine afterwards.

  • Delete a specific package or package version. Look up the exact path in cache for a specific package in the .packages file of your project. For example for firebase_auth 

    firebase_auth:file:///Users/someuser/.pub-cache/hosted/pub.dartlang.org/firebase_auth-0.6.6/lib/
    To fix this package delete ///Users/someuser/.pub-cache/hosted/pub.dartlang.org/firebase_auth-0.6.6/ (lib/ removed) and run flutter packages get.

Proxy

Flutter commands can not access the Internet

In a network where the Internet can only be reached through a proxy and Flutter commands fail.

Symtoms

Causes

Proxy setting incomplete or invalid.

Related information

(none yet)

Hot-reload not working

When a proxy is configured hot-reload does often not work.

Symptoms

Causes

Proxy setting incomplete or invalid. Localhost is redirected to the proxy.

Ways to fix

  • Set environment variable NO_PROXY=127.0.0.1

Empty Template for new recipes

Copy from the following line down

Topic name

Issue title

Issue description

Symptoms

Explain seen symptoms

Causes

Explain what causes this issue

Ways to fix

  • Do this, do that as well

AsciiDoc Recipes

GitHub Flavored AsciiDoc

Some workarounds for common issues with AsciiDoc on GitHub

Flutter • Write test, find bug • Embrace the yak shave • Black Lives Matter • https://flutter.dev/

Flutter Wiki

Process

Framework repo

The Flutter CLI Tool

Engine repo

Packages repo

Engineering Productivity

User documentation

Clone this wiki locally