Update toolchain version, script, and README.md

Author: MaxDesiatov

.swift-version

@@ -1 +1 @@
-wasm-5.3-SNAPSHOT-2020-10-02-a
+wasm-5.3-SNAPSHOT-2020-10-16-a

README.md

@@ -4,18 +4,7 @@
 
 Swift framework to interact with JavaScript through WebAssembly.
 
-## Requirements
-
-This library only supports [`swiftwasm/swift`](https://github.com/swiftwasm/swift) distribution toolchain. The toolchains can be installed via [`swiftenv`](https://github.com/kylef/swiftenv) like official nightly toolchain. You can use the `install-toolchain.sh` helper script that does this for you:
-
-```sh
-$ ./scripts/install-toolchain.sh
-$ swift --version
-Swift version 5.3-dev (LLVM 09686f232a, Swift 5a196c7f13)
-Target: x86_64-apple-darwin19.6.0
-```
-
-## Usage
+## Getting started
 
 This JavaScript code
 
@@ -66,4 +55,79 @@ let swiftPet: Pet = try JSValueDecoder().decode(from: jsPet)
 alert("Swift is running on browser!")
 ```
 
-Please see [Example](https://github.com/swiftwasm/JavaScriptKit/tree/main/Example) directory for more information
+### Usage in a browser application
+
+The easiest way to get started with JavaScriptKit in your browser app is with [the `carton`
+bundler](https://carton.dev).
+
+As a part of these steps
+you'll install `carton` via [Homebrew](https://brew.sh/) on macOS (unfortunately you'll have to build
+it manually on Linux). Assuming you already have Homebrew installed, you can create a new app
+that uses JavaScriptKit by following these steps:
+
+1. Install `carton`:
+
+```
+brew install swiftwasm/tap/carton
+```
+
+If you had `carton` installed before this, make sure you have version 0.6.1 or greater:
+
+```
+carton --version
+```
+
+2. Create a directory for your project and make it current:
+
+```
+mkdir SwiftWasmApp && cd SwiftWasmApp
+```
+
+3. Initialize the project from a template with `carton`:
+
+```
+carton init --template basic
+```
+
+4. Build the project and start the development server, `carton dev` can be kept running
+   during development:
+
+```
+carton dev
+```
+
+5. Open [http://127.0.0.1:8080/](http://127.0.0.1:8080/) in your browser and a developer console
+   within it. You'll see `Hello, world!` output in the console. You can edit the app source code in
+   your favorite editor and save it, `carton` will immediately rebuild the app and reload all
+   browser tabs that have the app open.
+
+You can also build your project with webpack.js and a manually installed SwiftWasm toolchain. Please
+see the following sections and the [Example](https://github.com/swiftwasm/JavaScriptKit/tree/main/Example)
+directory for more information in this more advanced use case.
+
+### Manual toolchain installation
+
+This library only supports [`swiftwasm/swift`](https://github.com/swiftwasm/swift) distribution
+toolchain. The toolchain can be installed via [`swiftenv`](https://github.com/kylef/swiftenv), in
+the same way as the official Swift nightly toolchain.
+
+You have to install the toolchain manually when working on the source code JavaScriptKit itself,
+especially if you change anything in the JavaScript runtime parts. This is because the runtime is
+embedded in `carton` and currently can't be replaced dynamically with the JavaScript code you've
+updated locally.
+
+Just pass a toolchain archive URL for [the latest SwiftWasm 5.3
+snapshot](https://github.com/swiftwasm/swift/releases) appropriate for your platform:
+
+```sh
+$ swiftenv install https://github.com/swiftwasm/swift/releases/download/swift-wasm-5.3-SNAPSHOT-2020-10-16-a/swift-wasm-5.3-SNAPSHOT-2020-10-16-a-macos-x86_64.tar.gz
+```
+
+You can also use the `install-toolchain.sh` helper script that uses a hardcoded toolchain snapshot:
+
+```sh
+$ ./scripts/install-toolchain.sh
+$ swift --version
+Swift version 5.3-dev (LLVM 09686f232a, Swift 5a196c7f13)
+Target: x86_64-apple-darwin19.6.0
+```

scripts/install-toolchain.sh

@@ -18,13 +18,16 @@ fi
 
 case $(uname -s) in
   Darwin)
-    toolchain_download="$swift_tag-osx.tar.gz"
+    toolchain_download="$swift_tag-macos-x86_64.tar.gz"
+    echo '-macos' >> .swift-version
   ;;
   Linux)
     if [ $(grep RELEASE /etc/lsb-release) == "DISTRIB_RELEASE=18.04" ]; then
-      toolchain_download="$swift_tag-ubuntu18.04.tar.gz"
+      toolchain_download="$swift_tag-ubuntu18.04-x86_64.tar.gz"
+      echo '-ubuntu18.04' >> .swift-version
     elif [ $(grep RELEASE /etc/lsb-release) == "DISTRIB_RELEASE=20.04" ]; then
-      toolchain_download="$swift_tag-ubuntu20.04.tar.gz"
+      toolchain_download="$swift_tag-ubuntu20.04-x86_64.tar.gz"
+      echo '-ubuntu20.04' >> .swift-version
     else
       echo "Unknown Ubuntu version"
       exit 1