Runs an executable or batch file.
Examples
Basic Example
fin.desktop.System.launchExternalProcess({
path: "notepad",
arguments: "",
listener: function(code) {
console.log('the exit code', code);
}
},
function() {
console.log('all good');
},
function(){
console.log('an error');
});
Listener callback
//This response has the following shape:
{
uuid: "FB3E6E36-0976-4C2B-9A09-FB2E54D2F1BB" //The mapped UUID which identifies the launched process
}
Example using an alias from app.json appAssets property
"appAssets": [
{
"src": "exe.zip",
"alias": "myApp",
"version": "4.12.8",
"target": "myApp.exe",
"args": "a b c d"
},
]
/*
When called, if no arguments are passed then the arguments (if any)
are taken from the 'app.json' file, from the 'args' parameter
of the 'appAssets' Object with the relevant 'alias'.
*/
fin.desktop.System.launchExternalProcess({
//Additionally note that the executable found in the zip file specified in appAssets
//will default to the one mentioned by appAssets.target
//If the the path below refers to a specific path it will override this default
path: "myApp",
listener: function(code) {
console.log('the exit code', code);
}
},
function() {
console.log('all good');
},
function(){
console.log('an error');
});
Example using an alias but overridding the arguments
"appAssets": [
{
"src": "exe.zip",
"alias": "myApp",
"version": "4.12.8",
"target": "myApp.exe",
"args": "a b c d"
},
]
/*
If 'arguments' is passed as a parameter it takes precedence
over any 'args' set in the 'app.json'.
*/
fin.desktop.System.launchExternalProcess({
path: "myApp",
arguments: "e f g",
listener: function(code) {
console.log('the exit code', code);
}
},
function() {
console.log('all good');
},
function(){
console.log('an error');
});