fuchsia_web/shell/README.md

   1 *WebEngine Shell*
   2
   3 The WebEngine Shell is a simple command-line executable which will create a
   4 fullscreen browsing session and navigate it to a specified URL. It can be used
   5 for validating web platform features, or it can serve as example code for
   6 embedding WebEngine in C++ applications.
   7
   8 **Usage**
   9 To build and run WebEngine Shell, execute the following commands:
  10
  11 ```
  12 $ autoninja -C $OUTDIR web_engine_shell
  13 $ $OUTDIR/bin/deploy_web_engine_shell --fuchsia-out-dir $FUCHSIA_OUTDIR
  14 $ cd $FUCHSIA
  15 $ ffx test run fuchsia-pkg://fuchsia.com/web_engine_shell#meta/web_engine_shell.cm -- --remote-debugging-port=1234 http://www.example.com
  16 ```
  17
  18 Local files can be deployed with the WebEngine Shell and accessed via the
  19 URL `fuchsia-dir://data/PATH/TO/FILE`. Files may be added to the directory
  20 by placing them under the path `//fuchsia_web/shell/data`.
  21
  22 Here is an example command line which loads a local file:
  23 ```
  24 $ ffx test run fuchsia-pkg://fuchsia.com/web_engine_shell#meta/web_engine_shell.cm -- fuchsia-dir://data/index.html
  25 ```