CG/JS Releases

Introduction
Documentation
Pre-Installation on macOS
Pre-Installation on Windows
Downloads
FAQ

Introduction

CG/JS is a release of the next version of Common Graphics and the IDE on Allegro Common Lisp 10.1. It allows running Common Graphics applications, including our IDE, in a web browser. It is called CG/JS to distinguish it from CG/GTK and CG/WIN, the versions of Common Graphics that use the GTK or Windows backends. CG/JS is targeted at all major, modern web browsers, including Chrome, Firefox and Safari, as well as any Chromium-based browser such as Edge.

We have been developing this version for a couple of years, and Gruff, the visualization tool for AllegroGraph, has been using CG/JS for more than a year. Also, the IDE is entirely written in Common Graphics and the initial release below fully supports the IDE.

When installed, the releases below will live alongside the original version of CG and the IDE. You can easily roll back (rebuild images to use the original version of CG and the IDE) if you find your application does not function properly with CG/JS. We are committed to making the new release of CG compatible with the existing release.

Documentation

Our preliminary documentation will be updated frequently, and eventually become part of our regular documentation.

Pre-Installation on macOS

There are two things you must do on macOS to ensure CG/JS works:

Update your Lisp (see below).

Ensure that Homebrew's OpenSSL is installed. To check, open Terminal.app:

$ brew list openssl
/usr/local/Cellar/openssl@1.1/1.1.1k/.bottle/etc/ (7 files)
/usr/local/Cellar/openssl@1.1/1.1.1k/bin/c_rehash
/usr/local/Cellar/openssl@1.1/1.1.1k/bin/openssl
/usr/local/Cellar/openssl@1.1/1.1.1k/include/openssl/ (104 files)
/usr/local/Cellar/openssl@1.1/1.1.1k/lib/libcrypto.1.1.dylib
/usr/local/Cellar/openssl@1.1/1.1.1k/lib/libssl.1.1.dylib
/usr/local/Cellar/openssl@1.1/1.1.1k/lib/engines-1.1/ (2 files)
/usr/local/Cellar/openssl@1.1/1.1.1k/lib/pkgconfig/ (3 files)
/usr/local/Cellar/openssl@1.1/1.1.1k/lib/ (4 other files)
/usr/local/Cellar/openssl@1.1/1.1.1k/share/doc/ (3970 files)
/usr/local/Cellar/openssl@1.1/1.1.1k/share/man/ (3970 files)
$

If the brew command does not exist, then install Homebrew.
If the command exists but the output looks different, then run this command (logged in as an administrative user):

$ brew install openssl

There is no harm in running the previous command, if Homebrew's openssl is already installed.

For more details see installing OpenSSL in our documentation.

Pre-Installation on Windows

CG/JS requires OpenSSL because lisp communicates with the web browser via the WebSocket protocol, which requires SSL. It is also needed during this installation. We provide a build of OpenSSL, if you do not have one. See readme.txt and our installation guide for more information.

Pre-Installation on all platforms

It is very important to update your Allegro CL with the latest patches, before you install and use CG/JS.

Downloads

The installation instructions are included in the downloads below in a file called readme-cgjs.txt.

See the Release notes for details on what has changed between releases.

FAQ

macOS: I get an 'SSL' error, how do I fix it? I get this error when running in browser mode:
```
Warning: The SSL foreign library was not successfully loaded.  The
         error message was this:

Failed to parse output of 'openssl version' "LibreSSL 2.8.3"
```
If this happens, see the Pre-Installation on macOS section above.

For more details see installing OpenSSL in our documentation.