Add build scripts for the Snap package

Author: philippgille

.github/CONTRIBUTING.md

@@ -34,3 +34,22 @@ Know how to fix something? We love pull requests! Here's a quick guide:
 3. Push the change (we recommend using a separate branch for your feature).
 4. Open a pull request.
 5. We try to merge and deploy changes as soon as possible, or at least leave some feedback, but if you haven't heard back from us after a couple of days, feel free to leave a comment on the pull request.
+
+## Tips
+
+- When working on Windows, but moving or adding a Linux Bash script, you must make sure the script is executable on Linux:
+    ```bash
+    # Check file permissions:
+    $ git ls-files --stage
+    ...
+    100644 7f4552c7ac8f30e8b5cb5047f03a5969ee61344b 0       build/build.sh
+    ...
+    # The "100644" must be "100755"
+    # Make file executable:
+    $ git update-index --chmod=+x 'build-snap-with-docker.sh'
+    # Check again:
+    $ git ls-files --stage
+    ...
+    100755 7f4552c7ac8f30e8b5cb5047f03a5969ee61344b 0       build/build.sh
+    ...
+    ```

.gitignore

@@ -24,4 +24,11 @@ serve.exe
 /build/artifacts
 
 # Visual Studio Code debug files
-debug
+debug
+
+# Snap build
+/parts
+/prime
+/stage
+/snap/.snapcraft
+/*.snap

README.md

@@ -154,15 +154,16 @@ To build with a Docker container:
 
 For Scoop and Homebrew no packages need to be built. They use "manifests"/"formulae" and the binaries from GitHub Releases.
 
-For Snap a Git hook is set up in the Snapcraft dashboard to automatically build a new Snap on every commit, but the package can also be built manually with:
+For releasing a new version, they need to be updated here:
 
-`snapcraft`
+- Scoop: https://github.com/lukesampson/scoop-extras/blob/master/serve.json
+- Homebrew: https://github.com/philippgille/homebrew-tap/blob/master/serve.rb
 
-Or when Snapcraft isn't installed, but Docker is:
+For Snap a Git hook is set up in the Snapcraft dashboard to automatically build a new Snap on every commit, so for releasing a new version the file in *this* repository needs to be updated:
 
-`docker run --rm -v ${pwd}:/build/serve -w /build/serve snapcraft/xenial-amd64 snapcraft`
+- Snap: https://github.com/philippgille/serve/blob/master/snap/snapcraft.yaml
 
-To release the snap into the public Snap channels:
+The Snap package can also be built manually, for example with this Bash script which utilizes Docker:
 
-`snapcraft login`  
-`snapcraft push serve_0.2.0_amd64.snap --release`
+- Windows: `build\build-snap-with-docker.ps1`
+- Linux: `build/build-snap-with-docker.sh`

build/build-snap-with-docker.ps1

@@ -0,0 +1,3 @@
+$ErrorActionPreference = "Stop"
+
+docker run --rm -v ${PSScriptRoot}\..\:/build/serve -w /build/serve snapcraft/xenial-amd64 snapcraft

build/build-snap-with-docker.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+set -euxo pipefail
+
+SCRIPTDIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+docker run --rm -v ${SCRIPTDIR}/../:/build/serve -w /build/serve snapcraft/xenial-amd64 snapcraft