webdev

Esta página explica cómo usar webdev para compilar tu aplicación y build_runner para probar tu aplicación.

Sigue estas instrucciones para comenzar a utilizar webdev.

Antes de que puedas usar webdev, agrega las dependencias a los paquetes build_runner y build_web_compilers en tu aplicación. El paquete build_runner agrega capacidades de scripting a webdev.

$ dart pub add build_runner build_web_compilers --dev

Utiliza dart pub para instalar webdev para todos los usuarios.

$ dart pub global activate webdev

Utiliza el mismo comando para actualizar webdev. Actualiza webdev cuando actualices tu SDK de Dart o cuando los comandos de webdev fallen de una manera que no puedas explicar.

Para utilizar webdev, debes estar en el directorio raíz de un paquete que dependa de los paquetes build_runner y build_web_compilers. Si estás probando la aplicación, también debe depender de build_test.

Para depender de estos paquetes, agrega las siguientes dev_dependencies al archivo pubspec.yaml de tu aplicación:

  dev_dependencies:
    # ···
    build_runner: ^2.15.0
    build_test: ^3.5.15
    build_web_compilers: ^4.5.1

Como es habitual después de los cambios en el pubspec.yaml, ejecuta dart pub get o dart pub upgrade:

$ dart pub get

Esta herramienta puede compilar de dos formas: una que facilita la depuración (serve) y otra que genera código pequeño y rápido (build).

El compilador de desarrollo admite actualizaciones incrementales y produce módulos de definición de módulos asincrónicos (Asynchronous Module Definition, AMD). Con webdev serve, puedes editar tus archivos de Dart, actualizar Chrome y ver tus cambios en poco tiempo. Esta velocidad proviene de compilar los módulos actualizados, no todos los paquetes que requiere tu aplicación.

La primera compilación es la que tarda más, ya que compila toda la aplicación. Mientras se ejecuta el comando serve, las compilaciones sucesivas deberían ser más rápidas.

El compilador de producción genera un archivo JavaScript único y minimizado.

Esta sección describe cómo utilizar los siguientes comandos:

webdev serve

Ejecuta un servidor de desarrollo que compila continuamente una aplicación de JavaScript.

webdev build

Compila una versión desplegable de una aplicación de JavaScript.

build_runner test

Ejecuta pruebas.

Puedes personalizar tu compilación utilizando archivos de configuración de compilación. Para obtener más información sobre los archivos de configuración de compilación, consulta el paquete build_web_compilers.

Para servir una versión de desarrollo de tu aplicación web, ejecuta el siguiente comando.

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

Este comando inicia un servidor de desarrollo que sirve tu aplicación y vigila los cambios en el código fuente. Por defecto, este comando sirve la aplicación en localhost:8080:

$ webdev serve

El primer webdev serve compila de forma lenta. Después de la primera compilación, almacena en caché los activos en el disco. Esto hace que las compilaciones posteriores sean más rápidas.

Para habilitar Dart DevTools, agrega el indicador --debug:

$ webdev serve --debug  # enables Dart DevTools

Para usar el compilador de producción en lugar del compilador de desarrollo, agrega el indicador --release:

$ webdev serve --release  # uses production compiler

Puedes especificar diferentes configuraciones de directorio-puerto.

Por ejemplo, el siguiente comando cambia el puerto de prueba del valor predeterminado (8081) a 8083:

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

Utiliza el siguiente comando para compilar tu aplicación:

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

De forma predeterminada, el comando build utiliza el compilador de JavaScript de producción para crear una versión de producción de tu aplicación. Agrega --no-release para compilar con el compilador de JavaScript de desarrollo. Utiliza la opción --output para controlar dónde compila Dart las carpetas del proyecto de nivel superior y escribe su salida.

El siguiente comando muestra cómo compilar la carpeta web de nivel superior del proyecto en el directorio build. Este comando utiliza el compilador de JavaScript de producción de forma predeterminada.

$ webdev build --output web:build

Utiliza el comando build_runner test para ejecutar las pruebas de componentes de tu aplicación:

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

Por ejemplo, aquí se muestra cómo ejecutar todas las pruebas de la plataforma Chrome:

$ dart run build_runner test -- -p chrome

Para ver todas las opciones disponibles de build_runner, utiliza la opción --help o -h:

$ dart run build_runner test -h

Dart pasa los argumentos después del argumento vacío -- directamente al ejecutor del paquete test. Para ver todas las opciones de línea de comandos para el ejecutor del paquete test, utiliza este comando:

$ dart test -h

Para obtener una lista completa de las opciones de webdev, ejecuta webdev --help o consulta el paquete webdev.

Consulta también las siguientes páginas:

• build_runner: Introduce build_runner y sus comandos integrados, y remite a más información.
• build_web_compilers: Contiene información sobre la configuración de las compilaciones, con un ejemplo del uso de dart2js_args para especificar opciones del compilador.