Skip to content

Troubleshooting ​

Where does console output go? ​

The development window shows your app's console output in the terminal that ran inca dev. See the Console reference for where each kind of app writes it.

The CLI can't unpack the host binary ​

The command stops with ERR_INCA_HOST_UNPACK_FAILED because no directory it tried could take the host binary. Set INCA_CACHE_DIR to a writable directory on a filesystem that allows running programs.

The app won't start on Linux ​

If the machine is missing a required library or a Vulkan driver, the app fails to start rather than falling back to a software renderer. See Linux runtime requirements for the libraries and driver package it needs, and how to check for them.

Where does a packaged app write its errors? ​

A packaged app writes its errors and crash reports to a log file, one file for each run. Run log says where the file is and what it holds.

Why does my script throw an out-of-memory or a stack error? ​

The host limits a script to 1 GiB of heap and 6 MiB of stack. An allocation past the heap limit throws InternalError: out of memory, and recursion past the stack limit throws RangeError: Maximum call stack size exceeded. The engine can throw null where it cannot allocate an error object, and the host reports that as null. the engine also throws null when it runs out of memory.

Why does a rule of my stylesheet have no effect? ​

The host reads a subset of CSS. It drops what it cannot read and prints a line that starts with <style>: in the terminal of inca dev, naming the rule or the declaration. See style for what has no effect.

Why doesn't my content scroll when it is taller than the window? ​

Content taller than the window is cut off at the window edge. Put the content in an element with a height and overflow: "scroll", and the wheel scrolls that element:

vue
<template>
  <div :style="{ overflow: 'scroll', height: 400 }">
    <!-- content taller than 400px -->
  </div>
</template>

overflow lists the other values.

Released under the MIT or Apache-2.0 license.