Skip to content

8ctopus/sciter-sandbox

Repository files navigation

sciter sandbox

This is a sciter.js development sandbox.

features

  • works on Windows, Mac and Linux
  • automatically install the sciter SDK
  • easily switch between SDK versions
  • start scapp with inspector
  • auto-detects changes to your code and refreshes
  • lint javascript code (check for issues and format code)

sciter sandbox gif

requirements

  • A recent version of Node.js node (tested with 16 LTS) and its package manager npm

start sandbox

  • git clone the repository and checkout the latest release tag git checkout 1.3.x
  • install packages npm install
  • install latest sciter SDK npm run install-sdk
  • start the sandbox npm run scapp

commands

install sciter SDK

npm run install-sdk [version]

# example
npm run install-sdk 5.0.1.8

start scapp / usciter

npm run [scapp|scapp32]

npm run [usciter|usciter32]

close scapp, usciter and inspector

npm run stop

check SDK version

npm run sdk-version

lint code

Javascript code linting uses xo which uses eslint internally.

npx xo (--fix) [file1 file2]

Note: without files, xo automatically finds the files to lint.

add sandbox to your project

You can also use the sandbox in your own projects:

  • inside your project root dir npm install --save-dev sciter-sandbox
  • add the following scripts inside package.json
  "scripts": {
    "install-sdk": "node ./node_modules/sciter-sandbox/scripts/install.mjs",
    "sdk-version": "node ./node_modules/sciter-sandbox/scripts/version.mjs",
    "scapp": "node ./node_modules/sciter-sandbox/scripts/start.mjs scapp",
    "usciter": "node ./node_modules/sciter-sandbox/scripts/start.mjs usciter",
    "stop": "node ./node_modules/sciter-sandbox/scripts/stop.mjs",
    "scapp32": "node ./node_modules/sciter-sandbox/scripts/start.mjs scapp32",
    "usciter32": "node ./node_modules/sciter-sandbox/scripts/start.mjs usciter32"
  },

define project to SDK version

You can set your project to use a specific SDK version by adding the object key sciterVersion: 5.0.1.2 inside package.json.

known issues

  • Linux and Mac require more testing
  • all OSes: usciter does not connect to the inspector
  • Linux: inspector has issues communicating (I don't know why)