In this example we will launch an executable called 'pdftohtml.exe', a command-line tool which, as its name suggest, coverts a pdf to html. It requires you pass it at least two arguments - a pdf file to convert and an output path for the converted files. PDFtoHTML is used purely as an exemplar, is an OpenSource tool which may be found here http://pdftohtml.sourceforge.net/, the principals apply to any executable.
The 'pdftohtml.exe' file is stored in a .zip file in the 'assets' directory. All assets must be zipped for distribution - they will be unzipped on installation of the OpenFin app. The app will be installed at C:\Users[USE RNAME]\AppData\Local\OpenFin\apps[ID NUMBER], the unzipped assets directory will be stored at this location. Assets may be accessed by the OpenFin app, their path accessed via the 'src' and 'target' properties of the 'appAssets' section of the 'app.json'.
'assets/dist.zip' contains the zipped contents of 'assets-source' directory - but not the 'assets-source' directory itself. It may contain multiple files.
The 'alias' called in JavaScript is set in the 'app.json'. the JavaScript has been annotated, please refer to it for more detail.
-- This is a vanilla JavaScript app, free from frameworks and build systems.
It has a simple Node/Express server for local development.
Clone the repo and run
$ npm install
NB: on a Mac you may need to type 'sudo npm install'
Navigate to the root folder where 'server.js' resides with your command line tool and run:
$ node server
This should start a simple Node server at http://localhost:9966, then, click the link below to install as an openFin app.
If you wish to change to localhost port you will need to change the references in "server.js", "app.json" and in the installer link below.