Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.1.15

webdev_proxy

Um proxy HTTP simples para o comando serve do webdev. Suporta aplicativos que usam roteamento HTML5 reescrevendo 404s para o índice raiz.

macOSWindowsLinux
Downloads em 30 dias
5,4 mil
Curtidas
5
Pontos Pub
140

Instalar pacote

flutter pub add webdev_proxy

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um proxy HTTP leve para o comando webdev serve, projetado para aplicações Flutter que usam roteamento HTML5. Ele intercepta erros 404 e os reescreve para servir o arquivo index.html raiz, permitindo roteamento do lado do cliente sem configuração de servidor. Ideal para aplicativos de página única que dependem da navegação por API de histórico. O proxy executa junto com o webdev e não exige alterações no código existente ou nos processos de build.

Casos de uso

  • Suporte a roteamento HTML5 em aplicativos web do Flutter
  • Gerenciando roteamento do lado do cliente com fallbacks 404
  • Simplificando o desenvolvimento para SPAs
  • Habilitar o link profundo em aplicativos da web
  • Evitando a configuração de rota do lado do servidor

Principais recursos

  • Reescreve 404s para index.html
  • Integra-se com o webdev serve
  • Configuração mínima necessária
  • Multiplataforma (macOS, Windows, Linux)
  • Nenhuma alteração de código necessária

Indicado para

  • Desenvolvedores Flutter usando roteamento HTML5
  • Desenvolvedores de SPA na web
  • Ambientes de desenvolvimento local
  • Aplicativos com necessidades de link profundo
  • Equipes evitando configurações complexas de servidor

Considerações

  • Não destinado ao uso em produção
  • Requer que o webdev esteja em execução
  • Limitado a servir ativos estáticos
  • Não lida com rotas dinâmicas
  • O proxy deve ser iniciado manualmente

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A simple HTTP proxy for webdev's serve command that adds support for rewriting certain requests, namely rewriting 404s to instead serve the root index (/).

Requirements

The latest release of webdev_proxy requires the following:

Installation

webdev_proxy is intended to be "activated" rather than installed as a package dependency.

$ dart pub global activate webdev_proxy

Learn more about activating and using packages here.

Usage

webdev_proxy supports one command: serve

webdev_proxy serve
Run `webdev serve` (a local web development server) behind a proxy that supports HTML5 routing by rewriting not-found requests to index.html.

Usage: webdev_proxy serve [-- [webdev serve arguments]]
-h, --help                 Print this usage information.
    --[no-]rewrite-404s    Rewrite every request that returns a 404 to /index.html
                           (defaults to on)

Run "webdev_proxy help" to see global options.

You may use any of the following options supported by `webdev serve` by passing them after the `--` separator.

webdev serve --help:
====================

Run a local web development server and a file system watcher that rebuilds on changes.

Usage: webdev serve [arguments] [<directory>[:<port>]]...
-h, --help                        Print this usage information.
-o, --output                      A directory to write the result of a build to. Or a mapping from a top-level directory in the package to the directory to write a filtered build output to. For example
                                  "web:deploy".
                                  A value of "NONE" indicates that no "--output" value should be passed to `build_runner`.
                                  (defaults to "NONE")

-r, --[no-]release                Build with release mode defaults for builders.
    --[no-]build-web-compilers    If a dependency on `build_web_compilers` is required to run.
                                  (defaults to on)

-v, --verbose                     Enables verbose logging.
    --auto                        Automatically performs an action after each build:

                                  restart: Reload modules and re-invoke main (loses current state)
                                  refresh: Performs a full page refresh.
                                  [restart, refresh]

    --chrome-debug-port           Specify which port the Chrome debugger is listening on. If used with launch-in-chrome Chrome will be started with the debugger listening on this port.
    --[no-]debug                  Enable the launching of DevTools (Alt + D). Must use with either --launch-in-chrome or --chrome-debug-port.
    --hostname                    Specify the hostname to serve on.
                                  (defaults to "localhost")

    --[no-]launch-in-chrome       Automatically launches your application in Chrome with the debug port open. Use chrome-debug-port to specify a specific port to attach to an already running chrome instance
                                  instead.

    --log-requests                Enables logging for each request to the server.

Run "webdev help" to see global options.

Note that you can configure the underlying webdev serve process by passing any of its supported command-line arguments after the -- separator.

Examples

To run the default server and proxy:

$ webdev_proxy serve

To pass arguments to webdev serve, e.g. to enable auto-refresh:

$ webdev_proxy serve -- --auto=refresh

Categorias

Dependências

Lista de dependências 10 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.