Skip to content

Commit

Permalink
all: update for release 0.32
Browse files Browse the repository at this point in the history
Signed-off-by: deadprogram <[email protected]>
  • Loading branch information
deadprogram committed Jun 18, 2024
1 parent 8ab17ab commit 3e84af2
Show file tree
Hide file tree
Showing 7 changed files with 27 additions and 27 deletions.
2 changes: 1 addition & 1 deletion content/docs/guides/build/bring-your-own-llvm.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Below is an example of running `tinygo version` and example output to check that
TinyGo was installed correctly (copy only what's in front of the `$` sign to your terminal!):
```shell
$ tinygo version
tinygo version 0.31.2-dev-d4189fec linux/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0-dev-d4189fec linux/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

If not see the [troubleshooting](#troubleshooting) section.
Expand Down
2 changes: 1 addition & 1 deletion content/docs/guides/build/manual-llvm.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ This results in a `tinygo` binary in the `build` directory:

```shell
$ ./build/tinygo version
tinygo version 0.31.2-dev-d4189fec linux/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0-dev-d4189fec linux/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

You have successfully built TinyGo from source. Congratulations! What's left now is to complete the [additional requirements](../additional-requirements)
Expand Down
4 changes: 2 additions & 2 deletions content/docs/guides/webassembly/wasm.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,13 +62,13 @@ Note the `--no-debug` flag, which reduces the size of the final binary by removi
debug symbols from the output. Also note that you must change the path to your Wasm file from `/go/src/github.com/myuser/myrepo/wasm-main.go` to whatever the actual path to your file is:

```
docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.31.2 tinygo build -o /go/src/github.com/myuser/myrepo/wasm.wasm -target wasm --no-debug /go/src/github.com/myuser/myrepo/wasm-main.go
docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.32.0 tinygo build -o /go/src/github.com/myuser/myrepo/wasm.wasm -target wasm --no-debug /go/src/github.com/myuser/myrepo/wasm-main.go
```

Make sure you copy `wasm_exec.js` to your runtime environment:

```
docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.31.2 /bin/bash -c "cp /usr/local/tinygo/targets/wasm_exec.js /go/src/github.com/myuser/myrepo/
docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.32.0 /bin/bash -c "cp /usr/local/tinygo/targets/wasm_exec.js /go/src/github.com/myuser/myrepo/
```

More complete examples are provided in the [wasm examples](https://github.com/tinygo-org/tinygo/tree/release/src/examples/wasm).
Expand Down
12 changes: 6 additions & 6 deletions content/getting-started/install/linux.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,20 +25,20 @@ You can also install the development build of TinyGo if you want to test the lat

### Ubuntu/Debian

You must have Go already installed on your machine in order to install TinyGo. We recommend Go v1.19 or above.
You must have Go already installed on your machine in order to install TinyGo. We recommend Go v1.20 or above.

If you are using Ubuntu or another Debian based Linux on an Intel processor, download the DEB file from Github and install it using the following commands:

```shell
wget https://github.com/tinygo-org/tinygo/releases/download/v0.31.2/tinygo_0.31.2_amd64.deb
sudo dpkg -i tinygo_0.31.2_amd64.deb
wget https://github.com/tinygo-org/tinygo/releases/download/v0.32.0/tinygo_0.32.0_amd64.deb
sudo dpkg -i tinygo_0.32.0_amd64.deb
```

If you are on a Raspberry Pi or other ARM-based Linux computer, you should use this command instead:

```shell
wget https://github.com/tinygo-org/tinygo/releases/download/v0.31.2/tinygo_0.31.2_armhf.deb
sudo dpkg -i tinygo_0.31.2_armhf.deb
wget https://github.com/tinygo-org/tinygo/releases/download/v0.32.0/tinygo_0.32.0_armhf.deb
sudo dpkg -i tinygo_0.32.0_armhf.deb
```

You will need to ensure that the path to the `tinygo` executable file is in your `PATH` variable.
Expand All @@ -51,7 +51,7 @@ You can test that the installation is working properly by running this code whic

```shell
$ tinygo version
tinygo version 0.31.2 linux/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0 linux/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

If you are on a 64 bit ARM OS, and running tinygo fails with "no such file or directory", you may need to install the 32 bit C++ runtime library, e.g.:
Expand Down
14 changes: 7 additions & 7 deletions content/getting-started/install/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ description: >

This page has information on how to install and use TinyGo on macOS. If you wish to build TinyGo from source, for example if you intend to contribute to the project, please take a look [here](../../../docs/guides/build).

You must have Go v1.19+ already installed on your machine in order to install TinyGo.
You must have Go v1.20+ already installed on your machine in order to install TinyGo.

You can use Homebrew to install TinyGo using the following commands:

Expand All @@ -22,18 +22,18 @@ brew install tinygo

#### Mac M1/M2

Download [this](https://github.com/tinygo-org/tinygo/releases/download/v0.31.2/tinygo0.31.2.darwin-arm64.tar.gz) file. Then, run the following commands:
Download [this](https://github.com/tinygo-org/tinygo/releases/download/v0.32.0/tinygo0.32.0.darwin-arm64.tar.gz) file. Then, run the following commands:

```shell
tar xvzf tinygo0.31.2.darwin-arm64.tar.gz
tar xvzf tinygo0.32.0.darwin-arm64.tar.gz
export PATH=<extract location>/tinygo/bin:$PATH
```

You can test that the installation is working properly by running this code which should display the version number:

```shell
$ tinygo version
tinygo version 0.31.2 darwin/arm64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0 darwin/arm64 (using go version go1.22 and LLVM version 18.1.2)
```

If you are only interested in compiling TinyGo code for WebAssembly then you are done with the installation.
Expand All @@ -42,18 +42,18 @@ Otherwise, please continue with the installation of the additional requirements

#### Mac Intel

Download [this](https://github.com/tinygo-org/tinygo/releases/download/v0.31.2/tinygo0.31.2.darwin-amd64.tar.gz) file. Then, run the following commands:
Download [this](https://github.com/tinygo-org/tinygo/releases/download/v0.32.0/tinygo0.32.0.darwin-amd64.tar.gz) file. Then, run the following commands:

```shell
tar xvzf tinygo0.31.2.darwin-amd64.tar.gz
tar xvzf tinygo0.32.0.darwin-amd64.tar.gz
export PATH=<extract location>/tinygo/bin:$PATH
```

You can test that the installation is working properly by running this code which should display the version number:

```shell
$ tinygo version
tinygo version 0.31.2 darwin/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0 darwin/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

If you are only interested in compiling TinyGo code for WebAssembly then you are done with the installation.
Expand Down
10 changes: 5 additions & 5 deletions content/getting-started/install/using-docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ You can use our Docker image to be able to run the TinyGo compiler on your compu

## Installing

docker pull tinygo/tinygo:0.31.2
docker pull tinygo/tinygo:0.32.0

## Using

Expand All @@ -18,24 +18,24 @@ For your own code, you will probably want to use absolute paths.

A docker container exists for easy access to the TinyGo CLI. For example, to compile `wasm.wasm` for the WebAssembly export example:

docker run --rm -v $(pwd):/src tinygo/tinygo:0.31.2 tinygo build -o wasm.wasm -target=wasm examples/wasm/export
docker run --rm -v $(pwd):/src tinygo/tinygo:0.32.0 tinygo build -o wasm.wasm -target=wasm examples/wasm/export

See the [WebAssembly page](../../../docs/guides/webassembly) for more information on executing the compiled
WebAssembly.

To compile `blinky1.hex` targeting an ARM microcontroller, such as the PCA10040:

docker run --rm -v $(pwd):/src tinygo/tinygo:0.31.2 tinygo build -o /src/blinky1.hex -size=short -target=pca10040 examples/blinky1
docker run --rm -v $(pwd):/src tinygo/tinygo:0.32.0 tinygo build -o /src/blinky1.hex -size=short -target=pca10040 examples/blinky1

To compile `blinky1.hex` targeting an AVR microcontroller such as the Arduino:

docker run --rm -v $(pwd):/src tinygo/tinygo:0.31.2 tinygo build -o /src/blinky1.hex -size=short -target=arduino examples/blinky1
docker run --rm -v $(pwd):/src tinygo/tinygo:0.32.0 tinygo build -o /src/blinky1.hex -size=short -target=arduino examples/blinky1

For projects that have remote dependencies outside of the standard library and
go code within your own project, you will need to map your entire `$GOPATH`
into the docker image for those dependencies to be found:

docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.31.2 tinygo build -o /go/src/github.com/myuser/myrepo/wasm.wasm -target wasm --no-debug /go/src/github.com/myuser/myrepo/wasm-main.go
docker run -v $GOPATH:/go -e "GOPATH=/go" tinygo/tinygo:0.32.0 tinygo build -o /go/src/github.com/myuser/myrepo/wasm.wasm -target wasm --no-debug /go/src/github.com/myuser/myrepo/wasm-main.go

**note: At this time, tinygo does not resolve dependencies from the /vendor/ folder within your project.**

Expand Down
10 changes: 5 additions & 5 deletions content/getting-started/install/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ description: >

This page has information on how to install and use TinyGo on Windows 10. If you wish to build TinyGo from source, for example if you intend to contribute to the project, please take a look [here](../../../docs/guides/build).

TinyGo requires Go v1.19+ to be already installed on your machine.
TinyGo requires Go v1.20+ to be already installed on your machine.

### Quick Install via Scoop

Expand All @@ -33,7 +33,7 @@ You can test that the installation was successful by running the `version` comma

```shell
> tinygo version
tinygo version 0.31.2 windows/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0 windows/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

Upgrading to the latest TinyGo version can be done via scoop with:
Expand Down Expand Up @@ -73,13 +73,13 @@ Upgrading to the latest versions can be as easy as:

### Manual Install

- You MUST use Go 1.19.x+ with the Windows 10 native install of TinyGo.
- You MUST use Go 1.20.x+ with the Windows 10 native install of TinyGo.

- If you have not installed it yet, you can get it from https://golang.org/dl/

- Choose the download link for Microsoft Windows, Windows 7 or later, Intel 64-bit processor.

- Download the TinyGo binary for Windows file from https://github.com/tinygo-org/tinygo/releases/download/v0.31.2/tinygo0.31.2.windows-amd64.zip
- Download the TinyGo binary for Windows file from https://github.com/tinygo-org/tinygo/releases/download/v0.32.0/tinygo0.32.0.windows-amd64.zip

- Decompress the file like this:

Expand All @@ -99,7 +99,7 @@ Upgrading to the latest versions can be as easy as:

```
> tinygo version
tinygo version 0.31.2 windows/amd64 (using go version go1.22 and LLVM version 17.0.1)
tinygo version 0.32.0 windows/amd64 (using go version go1.22 and LLVM version 18.1.2)
```

### Flashing boards
Expand Down

0 comments on commit 3e84af2

Please sign in to comment.