コンパイラのリファレンス
Motoko のコンパイラ(moc) は、Motoko プログラムを実行可能な WebAssembly(Wasm) モジュールにコンパイルするための主要なツールです。 コンパイラは DFINITY Canister SDK を使用してプロジェクトをビルドする際にバックグラウンドで実行されます。 コマンドラインでコンパイラを直接起動した場合は、CTRL-C を押して終了することができます。
この章では、コンパイラのコマンドラインのリファレンス情報を提供します。
moc
Motoko プログラムを実行可能な WebAssembly(Wasm) モジュールにコンパイルするには、Motoko コンパイラ(moc)を使用します。
基本的な使い方
moc [option] [file ...]
オプション
moc では以下のオプションが利用可能です。
| Option | Description |
|---|---|
--actor-idl <idl-path> | Specifies a path to actor IDL (Candid) files. |
--actor-alias <alias> <principal> | Specifies an actor import alias. |
--args <file> | Read additional newline separated command line arguments from <file>. |
--args0 <file> | Read additional NUL separated command line arguments from <file>. |
-c | Compile to WebAssembly. |
--check | Performs type checking only. |
--compacting-gc | Use compacting GC |
--copying-gc | Use copying GC (default) |
--debug | Respects debug expressions in the source (the default). |
--error-detail <n> | Set level of error message detail for syntax errors, n in [0..3] (default 2). |
-help,--help | Displays usage information. |
--hide-warnings | Hides compiler warnings. |
-Werror | Treat warnings as errors. |
--idl | Compile binary and emit Candid IDL specification to .did file. |
-i | Runs the compiler in an interactive read–eval–print loop (REPL) shell so you can evaluate program execution (implies -r). |
--map | Outputs a JavaScript source map. |
--max-stable-pages <n> | Set maximum number of pages available for library ExperimentStableMemory.mo (default 65536). |
-no-system-api | Disables system API imports. |
-o <file> | Specifies the output file. |
-p <n> | Sets the print depth. |
--package <package-name> <package-path> | Specifies a <package-name> <package-path> pair, separated by a space. |
--public-metadata <name> | Emit icp custom section <name> (candid:args or candid:service or motoko:stable-types or motoko:compiler) as public (default is private) |
--omit-metadata <name> | omit icp custom section <name> (candid:args or candid:service or motoko:stable-types or motoko:compiler) |
--print-deps | Prints the dependencies for a given source file. |
-r | Interprets programs. |
--release | Ignores debug expressions in the source. |
--stable-types | Compile binary and emit signature of stable types to .most file. |
--stable-compatible <pre> <post> | Test upgrade compatibility between stable-type signatures <pre> and <post>. |
-t | Activates tracing in interpreter. |
-v | Generates verbose output. |
--version | Displays version information. |
-wasi-system-api | Uses the WASI system API (wasmtime). |