Changelog
io.Connect Desktop 9.5
Release date: 03.09.2024
Components | Version |
---|---|
Electron | 31.2.0 |
Chromium | 126.0.6478.127 |
Node.js | 20.15.0 |
New Features
Executing JavaScript Code in a Window
Executing JavaScript code within the context of the current or another io.Connect Window is disabled by default. To enable it, set the
"allowScriptExecution"
top-level key in the app definition totrue
:
{ "allowScriptExecution": true }
To execute code in the context of an io.Connect Window, use the
executeCode()
method of anIOConnectWindow
instance. It accepts as a required argument the code to execute provided as a string. The method resolves with the result returned from the executed code, or rejects if the result of the code is a rejectedPromise
:
// Find the io.Connect Window in which you want to execute the code. const ID = "2506_04"; const ioConnectWindow = io.windows.findById(ID); // Provide the code to execute as a string. const myCode = "(() => { return 42; })()"; const result = await ioConnectWindow.executeCode(myCode); console.log(result);
Splash Screen
The io.Connect Desktop splash screen by default is shown always on top of any other windows. To disable this behavior, set the
"alwaysOnTop"
property of the"splash"
top-level key in thesystem.json
system configuration file tofalse
:
{ "splash": { "alwaysOnTop": false } }
Telemetry Data
You can now instruct io.Connect Desktop what type of telemetry data to gather. To specify the desired telemetry data sets, use the
"features"
property of the"telemetry"
top-level key in thesystem.json
system configuration file:The following example demonstrates how to instruct io.Connect Desktop to gather only system telemetry data:
{ "telemetry": { "enabled": true, "features": { "apps": false, "stores": false, "system": true } } }
The
"features"
object has the following properties:
Property Type Description "apps"
boolean
If true
, will enable publishing telemetry data related to web app performance."stores"
boolean
If true
, will enable publishing telemetry data related to app stores."system"
boolean
If true
, will enable publishing telemetry data related to system performance.
Boot Sequence Start & Completion Signals
To receive signals from io.Connect Desktop when a batch of apps with the same run priority starts and completes loading, register an Interop method and name it
"T42.AppManager.AutoStart.Stage"
. If such method is registered, it will be invoked at the completion of the current priority batch, and then at the start and at the completion of all remaining run priority batches within the current and within all following boot sequence stages:
const methodName = "T42.AppManager.AutoStart.Stage"; const handler = ({ stage, phase, runPriority, apps }) => { console.log(`Run priority batch "${runPriority}" in stage "${stage}" is ${phase === "stageStarting" ? "starting" : "completed"}.`); console.log(`Apps: ${apps}`); }; await io.interop.register(methodName, handler);
Each invocation of the method will return data in the shape of an object with the following properties:
Property Type Description apps
string[]
List of names of the apps participating in the current run priority batch. phase
"stageStarting" | "stageCompleted"
Indicates whether the current run priority batch of apps > is starting to load or has completed loading. runPriority
number
The run priority value of the current app batch. stage
"core" | "pre-sso" | "post-sso" | "user"
The name of the current boot sequence stage.
Log Appenders per App
By default, io.Connect Desktop uses a
multiFile
appender named"applications"
for logging events related to io.Connect client apps. To define separate log appenders per app, execute the following steps:
- Define a log appender to be used for your app:
{ "appenders": { "my-app-appender": { "type": "file", "filename": "%GLUE-USER-DATA%/logs/my-app.log", "maxLogSize": 10485760, "backups": 5, "minLevel": "info", "keepFileExt": true, "compress": true } } }
- Create a category with the name of your app as defined in its app definition and assign the log appender to it. This will instruct io.Connect Desktop to use the specified log appender for your app:
{ "categories": { "my-app": { "appenders": [ "my-app-appender" ], "level": "trace" } } }
Controlling Dropping Windows in Workspaces
To specify programmatically whether an io.Connect Window can be dropped in a Workspace, use the
setAllowWorkspaceDrop()
method of anIOConnectWindow
instance. It accepts a Boolean value as an argument determining whether the user will be able to drop the current window in a Workspace:
// Preventing the user from dropping the window in a Workspace. await myWindow.setAllowWorkspaceDrop(false);
To check whether the current window can be dropped in a Workspace, use the
allowWorkspaceDrop
property of the io.Connect Window object:
const canBeDropped = myWindow.allowWorkspaceDrop; console.log(`The current window ${canBeDropped ? "can" : "can't"} be dropped in a Workspace.`);
Pinning & Unpinning Tabs for Web Groups
The tabs of io.Connect Windows in web groups can now be pinned. Pinned tabs are placed before the regular tab windows and they contain only the window title. Pinned tab windows don't have a "Close" button, effectively preventing the user from closing them:
⚠️ Note that pinning and unpinning window tabs is available only for tab windows in web groups.
To make your tab window pinned via configuration, use the
"isPinned"
property of the"details"
top-level key in the app definition:
{ "details": { "isPinned": true } }
To pin and unpin tab windows programmatically, use the
pin()
andunpin()
methods of anIOConnectWindow
instance:
// Pins the tab of the current window. await myWindow.pin(); // Unpins the tab of the current window, reverting it to a normal tab with a "Close" button. await myWindow.unpin();
To check whether a tab window is pinned, use the
isPinned
property of the io.Connect Window object:
const isPinned = myWindow.isPinned; console.log(`The tab window is ${isPinned ? "pinned": "not pinned."}.`);
Drag Mode for Windows in Workspaces
By default, when the user starts to drag a window participating in a Workspace, the window is ejected from the Workspace. The user can drop it outside the Workspace or back inside the Workspace. To change this behavior, use the
"windowDragMode"
property of the"details"
top-level key in the Workspaces App configuration. It accepts"autoEject"
(default) or"keepInside"
as values.The following example demonstrates how to prevent the Workspaces App from ejecting the windows in a Workspace when the user drags them:
{ "details": { "windowDragMode": "keepInside" } }
To set the window drag mode for an existing Workspace programmatically, use the
setWindowDragMode()
method of aWorkspace
instance:
// Windows won't be ejected from the Workspace when the user drags them. await myWorkspace.setWindowDragMode("keepInside");
To check the current window drag mode setting of an existing Workspace, use the
windowDragMode
property of the Workspace object:
const dragMode = myWorkspace.windowDragMode;
To specify the window drag mode when creating a Workspace, use the
windowDragMode
property of theconfig
object in theWorkspaceDefinition
:
const definition = { config: { title: "My Workspace", windowDragMode: "keepInside" } }; const myWorkspace = await io.workspaces.createWorkspace(definition);
Channel Restrictions
Subscribing for Channel Restriction Changes
To get notified when the Channel restrictions for any window have changed, use the
onChannelRestrictionsChanged()
method and provide a handler for the event. The handler will receive as arguments the current set of Channel restrictions and the ID of the window for which the Channel restrictions have changed:
const handler = (restrictions, windowID) => { console.log(`Channel restrictions changed for window with ID: "${windowID}"`); console.log(restrictions.channels); }; const unsubscribe = io.channels.onChannelRestrictionsChanged(handler);
Preventing Apps from Modifying Channel Restrictions
To prevent an app from modifying Channel restrictions, use the
"preventModifyingRestrictionsFor"
property of the"channelSelector"
object under the"details"
top-level key in the app definition. Provide the names of the Channels whose restrictions the app won't be able to modify:
{ "details": { "channelSelector": { "preventModifyingRestrictionsFor": ["Red", "Green"] } } }
⚠️ Note that the
"preventModifyingRestrictionsFor"
property is valid only for apps of type"window"
,"exe"
,"clickonce"
,"childWindow"
and"citrix"
.
Electron Cache
The
"copy"
property of the"cache"
object under the"folders"
top-level key in thesystem.json
system configuration file of io.Connect Desktop can now accept either an object or a Boolean value.To specify a location from where to copy the Electron cache from the closest previously installed io.Connect Desktop version and add it to the cache files for the upgraded version of io.Connect Desktop, use the
"path"
property of the"copy"
object. Provide an absolute path pointing to the location of the Electron cache you want to migrate:
{ "folders": { "cache": { "copy": { "path": "%LocalAppData%/MyElectronCache/" } } } }
Improvements & Bug Fixes
Improved support for adding additional apps during a boot sequence stage.
Improved handling theme changes for the web page search triggered with
CTRL + F
.Added an error message displayed in the io.Connect launcher UI when a Layout fails to save.
Improved handling of opening windows with invalid values for width and height when using the browser native
window.open()
method.Improved handling invocations of Interop methods when an Interop server has been removed.
Improved tab drag and move behavior in web groups.