| # dartanalyzer |
| |
| Use _dartanalyzer_ to statically analyze your code at the command line, |
| checking for errors and warnings that are specified in the |
| [Dart Language Specification](https://www.dartlang.org/docs/spec/). |
| DartPad, code editors, and IDEs such as WebStorm use the same |
| analysis engine that dartanalyzer uses. |
| |
| ## Basic usage |
| |
| Run the analyzer from the top directory of the package. |
| Here's an example of testing a Dart file. |
| |
| ``` |
| dartanalyzer bin/test.dart |
| ``` |
| |
| ## Options |
| |
| The following are the most commonly used options for dartanalyzer: |
| |
| * `--packages=`<br> |
| Specify the path to the package resolution configuration file. |
| For more information see |
| [Package Resolution Configuration File](https://github.com/lrhn/dep-pkgspec/blob/master/DEP-pkgspec.md). |
| This option cannot be used with `--package-root`. |
| |
| * `--package-warnings`<br> |
| Show warnings not only for code in the specified .dart file and |
| others in its library, but also for libraries imported with `package:`. |
| |
| * `--options=`<br> |
| Specify the path to an analysis options file. |
| |
| * `--lints`<br> |
| Show the results from the linter. |
| |
| * `--no-hints`<br> |
| Don't show hints for improving the code. |
| |
| * `--ignore-unrecognized-flags`<br> |
| Rather than printing the help message, |
| ignore any unrecognized command-line flags. |
| |
| * `--version`<br> |
| Show the analyzer version. |
| |
| * `-h` _or_ `--help`<br> |
| Show all the command-line options. |
| |
| The following are advanced options to use with dartanalyzer: |
| |
| * `-b` _or_ `--batch`<br> |
| Run in batch mode. |
| |
| * `--dart-sdk=`<br> |
| Specify the directory that contains the Dart SDK. |
| |
| * `--fatal-warnings`<br> |
| Except for type warnings, treat warnings as fatal. |
| |
| * `--format=machine`<br> |
| Produce output in a format suitable for parsing. |
| |
| * `--url-mapping=libraryUri,/path/to/library.dart`<br> |
| Tells the analyzer to use the specified library as the source for that |
| particular import. |
| |
| The following options are deprecated: |
| |
| * `--package-root=`<br> |
| **Deprecated.** Specify the directory to search for any libraries that are |
| imported using `package:`. _This option is replaced as of Dart 1.12 with |
| `--packages`._ |
