fune/docs/setup/common_build_errors.md
Tim Giles 4ed433c70c Bug 1843629 - Explain some non-fatal errors in the OS build docs. r=sylvestre DONTBUILD
These are some of the errors that some Outreachy applicants were
experiencing. Figured having some additional documentation explaining
that not all errors and warnings are fatal might help unblock new
contributors in the future.

Differential Revision: https://phabricator.services.mozilla.com/D208804
2024-05-03 11:28:15 +00:00

34 lines
1.3 KiB
Markdown

# Common Build Errors
When setting up Firefox, you may encounter some other build errors or
warnings that are not fatal. This document is to help you determine
if the error you're running into is a fatal one or not.
## Watchman unavailable
This is a warning and can be ignored.
[Watchman is a file watching service](https://facebook.github.io/watchman/)
that can speed up some interactions with Git and Mercurial.
## VSCode Java extension
If you happen to have the Java extension installed in VSCode, there's
a chance that the "Problems" tab in the integrated terminal will
display an error about `Cannot run program [...]/mozilla-unified/mach`.
This is because the extension does not know how to parse the mozilla-central
repository and specifically the `mach` command runner.
This will not prevent you from building and running Firefox.
## ERROR glean_core
This is a non-fatal error and will not prevent you from building and
running Firefox. You might see this text in the console after running
`./mach run`. The specific text might appear as:
`Error setting metrics feature config: [...]`.
## Region.sys.mjs
This is a non-fatal error, this will not prevent you from building and
running Firefox. You might see this text in the console after running
`./mach run` and the specific text might look like:
`console.error: Region.sys.mjs: Error fetching region`.