roc/getting_started/linux_x86.md

33 lines
1.4 KiB
Markdown

0. Download the latest nightly from the assets [here](https://github.com/rtfeldman/roc/releases).
0. Untar the archive:
```
tar -xf roc_nightly-linux_x86_64-<VERSION>.tar.gz
```
0. Some fresh installs require executing `sudo apt update`, it is not needed to execute `sudo apt upgrade` after this.
0. To be able to run examples:
- for the Rust example:
```
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
- for the zig example:
```
wget https://ziglang.org/download/0.8.1/zig-linux-x86_64-0.8.1.tar.xz
tar -xf zig-linux-x86_64-0.8.1.tar.xz
sudo ln -s $(pwd)/zig-linux-x86_64-0.8.1/zig /usr/local/bin/zig
```
- for the C example:
```
sudo apt install build-essential clang
```
0. Run examples with:
```
# Rust. If you installed rust in this terminal you'll need to open a new one first!
./roc examples/hello-world/rust-platform/helloRust.roc
# Zig
./roc examples/hello-world/zig-platform/helloZig.roc --linker=legacy
# C
./roc examples/hello-world/c-platform/helloC.roc --linker=legacy
```
0. See [here](../README.md#examples) for the other examples.
**Tip:** when programming in roc, we recommend to execute `./roc check myproject/Foo.roc` before `./roc myproject/Foo.roc` or `./roc build myproject/Foo.roc`. `./roc check` can produce clear error messages in cases where building/running may panic.