Added missing documentation around self-signing for local testing of packaged apps on macos [skip ci]

1 files changed, 17 insertions, 2 deletions

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 947428c7b..7fcc868c2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -23,7 +23,8 @@
     - [Install dependencies](#install-dependencies)
     - [Fix native modules to match current electron node version](#fix-native-modules-to-match-current-electron-node-version)
     - [Package recipe repository](#package-recipe-repository)
-    - [Using Docker to build an rpm package](#using-docker-to-build-an-rpm-package)
+    - [Using Docker to build a linux-targetted packaged app](#using-docker-to-build-a-linux-targetted-packaged-app)
+    - [Code Signing on a mac](#code-signing-on-a-mac)
     - [Start development app](#start-development-app)
     - [Styleguide](#styleguide)
       - [Git Commit Messages format](#git-commit-messages-format)
@@ -133,7 +134,7 @@ Ferdi requires its recipes to be packaged before it can use it. When running Fer
 cd recipes && npm i && npm run package
 ```
 
-### Using Docker to build an rpm package
+### Using Docker to build a linux-targetted packaged app
 
 ```bash
 docker build -t ferdi-package .
@@ -157,6 +158,20 @@ mv /ferdi/ferdi /ferdi-out/Ferdi-$GIT_SHA
 mv /ferdi/latest-linux.yml /ferdi-out/latest-linux-$GIT_SHA.yml
 ```
 
+### Code Signing on a mac
+
+If you are building the packaged app (on a mac) for local testing, you can set this environment variable to bypass the code signing step during the packaging process (`npm run build`):
+
+```bash
+export CSC_IDENTITY_AUTO_DISCOVERY=false
+```
+
+Or else, if you want to self-sign on a mac with non-registered certificate (not for distribution of the resulting package), you can follow [this thread](https://github.com/electron/electron/issues/7476#issuecomment-356084754) and run this command:
+
+```bash
+codesign --deep --force --verbose --sign - node_modules/electron/dist/Electron.app
+```
+
 ### Start development app
 
 Run these two commands **simultaneously** in different terminals: