First native program

Select and verify the tool

This path assumes you already use a terminal. It does not require the beginner course. Check the system requirements first. These instructions select ASPL 0.7.0 for Linux x86-64. Console is optional and separate.

Download the native archive and its SHA256SUMS into a new directory. Verify before extracting or executing. Stop on a checksum mismatch or an archive error. A checksum detects differing bytes; a checksum downloaded from the same site is not an independent publisher signature.

sha256sum --check SHA256SUMS &&
tar -tJf aspl-0.7.0-x86_64-linux-gnu.tar.xz &&
tar -xJf aspl-0.7.0-x86_64-linux-gnu.tar.xz

The archive contains one aspl-0.7.0-x86_64-linux-gnu/ directory with aspl, DEPENDENCIES.json, both licenses and THIRD-PARTY-NOTICES. There is no installer script. Keep those files together in a versioned user directory, then select the executable with a symlink. If ~/.local/bin/aspl already exists, inspect it before replacing it.

mkdir -p "$HOME/.local/opt" "$HOME/.local/bin"
mv aspl-0.7.0-x86_64-linux-gnu "$HOME/.local/opt/"
ln -s "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu/aspl" "$HOME/.local/bin/aspl"
export PATH="$HOME/.local/bin:$PATH"
hash -r

Run this once for the selected release. An existing version directory should be inspected, not overwritten. Add the export PATH line once to your shell's startup file if you want it in future terminals.

Check the selected installation

command -v aspl
aspl --version
aspl --diagnostic-language=en --help

The first command should name your selected user installation. The version must be aspl 0.7.0. If another installation wins, inspect PATH order and clear your shell's command cache. If the loader or a shared library is missing, check the host requirements instead of treating it as a source error. Arabic is the default diagnostic language; --diagnostic-language=en changes diagnostics, not source or output.

Save a complete first program

Download a supplied source variant below, save it as hello.aspl, and use the check, run and build workflow. The canonical Hello program returns status zero and prints nothing. Printing text and returning process status are separate operations.

fn start_main() -> i64 {
    return 0;
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "",
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": ""
  }
}

Upgrade, roll back and uninstall

For an upgrade, choose a published version from release history. Read that version's requirements, verify its own archive and checksums, and extract it into a separate versioned directory. Test its absolute executable path on your source with --version, check, run and build before selecting it. Keep the previous directory and your source backups.

To select the verified 0.7.0 directory again in Bash:

ln -sfn "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu/aspl" "$HOME/.local/bin/aspl"
hash -r
command -v aspl
aspl --version

Native release rollback changes this symlink to a retained earlier native executable. Substitute the earlier verified directory and check its version, then check your source for compatibility. It does not rewrite programs already built by another version. An ASPL website recovery artifact restores website delivery and retained assets; it does not roll back your installed native tool.

To uninstall this installation, first confirm the symlink's target with readlink "$HOME/.local/bin/aspl". Remove that symlink and the exact version directory only if they are the installation you intend to remove:

rm "$HOME/.local/bin/aspl"
rm -r "$HOME/.local/opt/aspl-0.7.0-x86_64-linux-gnu"
hash -r
command -v aspl

Remove your PATH startup line only if no other tools use that directory. Your source and built programs remain usable. Console has its own uninstall steps.