diff options
Diffstat (limited to 'troubleshooting.md')
| -rw-r--r-- | troubleshooting.md | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/troubleshooting.md b/troubleshooting.md new file mode 100644 index 0000000..d17723e --- /dev/null +++ b/troubleshooting.md @@ -0,0 +1,42 @@ +# Troubleshooting + +These are some common issues when starting. + +## “cargo-nextest” cannot be opened because the developer cannot be verified. + +On Macs, unsigned binaries cannot be run by default. To manually approve this +app, go to: [Apple menu > System Preferences, click Security & Privacy, under the General tab](x-apple.systempreferences:com.apple.preference.security). You'll see "“cargo-nextest” was blocked from use because it is +not from an identified developer". Click the "Allow Anyway" button, and +`cargo-nextest` can be run on the next invocation. + +See also: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac + +## Cannot `pnpm install` because of oniguruma + +Oniguruma does not provide a prebuilt binary for arm64 macOS. Further, macOS +does not provide a python2 environment by default anymore! You need to setup your +python environment, much like we would setup your node environment: + +```shell +brew install pyenv +eval "$(pyenv init --path)" +pyenv install 2.7.18 +pyenv local 2.7.18 +``` + +Now try `pnpm install` again. + +See also: https://stackoverflow.com/a/67274521 + +## Cannot `pnpm install` because of canvas + +Canvas does not provide a prebuilt binary for arm64. To manually compile, +you can use Homebrew to install the necessary packages: + +```shell +brew install python pkg-config pixman cairo pango +``` + +Now try `pnpm install` again. + +See also: https://github.com/Automattic/node-canvas/blob/master/Readme.md#compiling |