Add troubleshooting notice for macOS

When developing on macOS (Darwin) DBus may have to be installed.

Change-type: patch
Signed-off-by: fisehara <harald@balena.io>
This commit is contained in:
fisehara 2021-12-30 15:39:59 +00:00
parent b677972576
commit 6ab314f8c0

View File

@ -274,9 +274,13 @@ node -v # >= 12.16.2
npm -v # >= 6.14.4
git --version # >= 2.13.0
```
Also, ensure you're installing dependencies with `npm ci` as this will perform a clean install and guarantee the module versions specified are downloaded rather then installed which might attempt to upgrade!
### DBus
When developing on macOS you may need to install DBus on the development host.
1. `brew install dbus`
2. `npm ci`
#### Downgrading versions
The Supervisor will always be forwards compatible so you can just simply run newer versions. If there is data that must be normalized to a new schema such as the naming of engine resources, values in the sqlite database, etc then the new version will automatically take care of that either via [migrations](/src/migrations) or at runtime when the value is queried.