The following assumes that a recent version of Node.js and its package manager npm (comes with Node.js) are installed, with the commands below executed in a command prompt. Basic knowledge about writing and working with TypeScript modules, which is very similar, is a plus.
To get started with AssemblyScript, switch to a new directory and initialize a new node module:
npm install --save @assemblyscript/loadernpm install --save-dev assemblyscript
Once installed, the compiler provides a handy scaffolding utility to quickly set up a new AssemblyScript project, for example in the directory of the just initialized node module:
npx asinit .
It automatically creates the recommended directory structure and configuration files, including:
assembly/ directory containing the sources being compiled to WebAssembly, with a
tsconfig.json telling your editor about AssemblyScript's standard library and an
index.ts to get you started.
build/ directory where compiled WebAssembly binaries, source maps, definition files etc. become placed.
package.json with the necessary dependencies and build tasks to compile both an untouched (as emitted by the AssemblyScript compiler) and an optimized (using Binaryen) version of your program in both binary and text format.
Once initialized, edit the sources in
assembly/, maybe tweak the build steps in
package.json to fit your needs, and run the build command to compile your module to WebAssembly:
npm run asbuild
index.js in the root directory of your package to instantiate and export the WebAssembly module you'll then be able to
requireit just like any other node module, with the notable difference that the only values your module's exports understand being integers and floats. Read on to learn more!