cbsan/flutter repository overview

⁠Ambiente Flutter

Configurando ambiente inicial para desenvolvimento Flutter+Android, assim facilitando o início de algum projeto. Esse dockerfile irá fazer o download e instalação da versão mais recente do Flutter juntamente com a SDK do Android.

Sugestões e criticas são muito bem vindas :blush:

⚠️ Necessário ter o Docker⁠ instalado em seu ambiente local. ⚠️

⁠Utilização/Compilação

$ docker build -t flutter .

💡Você pode utilizar a imagem já compilada que está no registry, para isso basta utilizar a imagem cbsan/flutter.

⁠Executando

Para subir o container é necessário executar o comando abaixo:

$ docker run -ti --privileged -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v /dev:/dev cbsan/flutter bash

ℹ️ No exemplo estou utilizando a imagem que esta compilada no registry cbsan/flutter, caso tenha compilado ela localmente deve substituir pela nomenclatura utilizada.

⁠Emulador

⚠️ Importante: Esse comando ira utilizar o X do SO pois ele abre uma janela do sistema, no caso do linux é necessário fazer o mapeamento, isso pode ser feito executando o comando xhost local:root no terminal local.:warning:

Essa imagem contem um emulador ja configurado rodando na versão 28. Para executar utilize o comando abaixo:

$ runEmulator

💡O comando deve ser executado dentro do container.

⁠Exemplo de utilização (dir sample)

Para facilitar o trabalho estou utilizando docker-compose para gerenciar o ambiente, fiz o mapeamento dos avd e gradle para um volume do docker, assim toda configuração que for feita sera mantida em cada inicialização do ambiente, alem de tornar o inicio do emulador mais rápido devido manter o cache.

• Subindo o ambiente:

$ docker-compose up -d --force-recreate --remove-orphans

• Mapeando display X (Necessário para que o emulador consiga abrir a janela):

$ xhost local:root

• Acessando o ambiente:

$ docker-compose exec app bash

Os comandos abaixo serão executados dentro do container, importante ter no minimo duas janelas do terminal aberta, uma para rodar o emulador e outra para rodar o flutter. ⚠️ Primeira execução ira demorar um pouco devido a criação dos arquivos no gradle e avd ⚠️

• Executando o emulador:

$ runEmulator

• Executando o app de teste: ⚠️ Importante: Necessário que o emulador esteja rodando, Ok! ⚠️

flutter run

⚠️ As configurações são armazenadas no "sample_storage_avd" e "storage_gradle", para resetar o ambiente basta remover os volume Ex.: "$ docker volume rm -f sample_storage_avd" ⚠️

ℹ️ Para facilitar o desenvolvimento existe a possibilidade de criação de scripts para seu app, por padrão espera-se que seja criado o arquivo "commands_app" dentro de /usr/src. Exemplo commands_app:

function run-app() {
  flutter run
}

Essa função fica disponível no bash do container com o nome da função criada, no caso "run-app"

⁠Autor

Cristian B. Santos [email protected]⁠

Give a ⭐️ if this project helped you!