| # 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: | |
| * `-p` _or_ `--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`._ | |
| * `--machine`<br> | |
| **Deprecated.** Replaced by `--format`. | |
| * `--show-package-warnings`<br> | |
| **Deprecated.** Replaced by `--package-warnings`. | |
| * `--show-sdk-warnings`<br> | |
| **Deprecated.** Replaced by `--warnings`. |