webdev

Esta página explica como usar o webdev para compilar seu aplicativo e o build_runner para testar seu aplicativo.

Siga estas instruções para começar a usar o webdev.

Antes de usar o webdev, adicione dependências aos pacotes build_runner e build_web_compilers ao seu aplicativo. O pacote build_runner adiciona recursos de script ao webdev.

$ dart pub add build_runner build_web_compilers --dev

Use dart install para instalar o webdev globalmente.

$ dart install webdev

Use o mesmo comando para atualizar o webdev. Atualize o webdev quando atualizar seu Dart SDK, ou quando os comandos do webdev falharem de um jeito que você não consiga explicar.

Para usar o webdev, você precisa estar no diretório raiz de um pacote que depende dos pacotes build_runner e build_web_compilers. Se você estiver testando o aplicativo, ele também precisa depender do build_test.

Para depender desses pacotes, adicione as seguintes dev_dependencies ao arquivo pubspec.yaml do seu aplicativo:

  dev_dependencies:
    # ···
    build_runner: ^2.15.1
    build_test: ^3.5.16
    build_web_compilers: ^4.8.5

Como de costume, após alterações no pubspec.yaml, execute dart pub get ou dart pub upgrade:

$ dart pub get

Esta ferramenta pode compilar de duas maneiras: uma que facilita a depuração (serve) e outra que gera código pequeno e rápido (build).

O compilador de desenvolvimento oferece suporte a atualizações incrementais e produz módulos Asynchronous Module Definition (AMD). Com o webdev serve, você pode editar seus arquivos Dart, atualizar no Chrome e ver suas edições em pouco tempo. Essa velocidade vem da compilação dos módulos atualizados, e não de todos os pacotes que seu aplicativo requer.

A primeira compilação é a mais demorada, pois compila o aplicativo inteiro. Enquanto o comando serve estiver em execução, as compilações seguintes devem ser mais rápidas.

O compilador de produção gera um único arquivo JavaScript minificado.

Esta seção descreve como usar os seguintes comandos:

webdev serve

Executa um servidor de desenvolvimento que compila continuamente um aplicativo JavaScript.

webdev build

Compila uma versão implantável de um aplicativo JavaScript.

build_runner test

Executa os testes.

Você pode personalizar sua compilação usando arquivos de configuração de build. Para saber mais sobre esses arquivos, veja o pacote build_web_compilers.

Para servir uma versão de desenvolvimento do seu aplicativo web, execute o seguinte comando.

$ webdev serve [--debug | --release] [ [<directory>[:<port>]] ... ]

Este comando inicia um servidor de desenvolvimento que serve seu aplicativo e monitora as alterações no código-fonte. Por padrão, o comando serve o aplicativo em localhost:8080:

$ webdev serve

O primeiro webdev serve compila devagar. Após a primeira compilação, ele armazena em cache os assets no disco. Isso torna as compilações seguintes mais rápidas.

Para habilitar o Dart DevTools, adicione a flag --debug:

$ webdev serve --debug  # enables Dart DevTools

Para usar o compilador de produção em vez do de desenvolvimento, adicione a flag --release:

$ webdev serve --release  # uses production compiler

Você pode especificar diferentes configurações de diretório e porta.

Por exemplo, o comando a seguir altera a porta de teste do padrão (8081) para 8083:

$ webdev serve web test:8083 # App: 8080; tests: 8083

Use o seguinte comando para compilar seu aplicativo:

$ webdev build [--no-release] --output [<dirname>:]<dirname>

Por padrão, o comando build usa o compilador JavaScript de produção para criar uma versão de produção do seu aplicativo. Adicione --no-release para compilar com o compilador JavaScript de desenvolvimento. Use a opção --output para controlar onde o Dart compila as pastas de nível superior do projeto e grava a saída.

O comando a seguir mostra como compilar a pasta web, de nível superior no projeto, no diretório build. Este comando usa o compilador JavaScript de produção por padrão.

$ webdev build --output web:build

Use o comando build_runner test para executar os testes de componente do seu aplicativo:

$ dart run build_runner test [build_runner options] -- -p <platform> [test options]

Por exemplo, veja como executar todos os testes da plataforma Chrome:

$ dart run build_runner test -- -p chrome

Para ver todas as opções disponíveis do build_runner, use a opção --help ou -h:

$ dart run build_runner test -h

O Dart passa os argumentos após o argumento -- vazio diretamente para o runner do pacote test. Para ver todas as opções de linha de comando do runner do pacote test, use este comando:

$ dart test -h

Para uma lista completa das opções do webdev, execute webdev --help ou consulte o pacote webdev.

Veja também as páginas a seguir:

• build_runner: Apresenta o build_runner e seus comandos integrados, e aponta para mais informações.
• build_web_compilers: Traz informações sobre como configurar builds, com um exemplo de uso de dart2js_args para especificar opções do compilador.