Signal-Desktop/ts/types/Settings.ts

85 lines
2.8 KiB
TypeScript

// Copyright 2018 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
import semver from 'semver';
import type { OSType } from '../util/os/shared';
import { SystemTraySetting } from './SystemTraySetting';
import { isNotUpdatable, isProduction } from '../util/version';
const MIN_WINDOWS_VERSION = '8.0.0';
// Using `Notification::tag` has a bug on Windows 7:
// https://github.com/electron/electron/issues/11189
export const isNotificationGroupingSupported = (OS: OSType): boolean =>
!OS.isWindows() || OS.isWindows(MIN_WINDOWS_VERSION);
// Login item settings are only supported on macOS and Windows, according to [Electron's
// docs][0].
// [0]: https://www.electronjs.org/docs/api/app#appsetloginitemsettingssettings-macos-windows
export const isAutoLaunchSupported = (OS: OSType): boolean =>
OS.isWindows() || OS.isMacOS();
// the "hide menu bar" option is specific to Windows and Linux
export const isHideMenuBarSupported = (OS: OSType): boolean => !OS.isMacOS();
// the "draw attention on notification" option is specific to Windows and Linux
export const isDrawAttentionSupported = (OS: OSType): boolean => !OS.isMacOS();
/**
* Returns `true` if you can minimize the app to the system tray. Users can override this
* option with a command line flag, but that is not officially supported.
*/
export const isSystemTraySupported = (OS: OSType): boolean =>
OS.isWindows() || OS.isLinux();
export const isContentProtectionSupported = (OS: OSType): boolean =>
OS.isWindows();
export const isContentProtectionNeeded = (OS: OSType): boolean =>
OS.isWindows();
export const getDefaultSystemTraySetting = (
OS: OSType,
appVersion: string
): SystemTraySetting => {
if (!isSystemTraySupported(OS)) {
return SystemTraySetting.DoNotUseSystemTray;
}
// System tray on linux may not be well supported, so we default to it being off in
// production
if (OS.isLinux() && isProduction(appVersion)) {
return SystemTraySetting.DoNotUseSystemTray;
}
return SystemTraySetting.MinimizeToSystemTray;
};
// On Windows minimize and start in system tray is default when app is selected
// to launch at login, because we can provide `['--start-in-tray']` args.
export const isMinimizeToAndStartInSystemTraySupported = (
OS: OSType
): boolean => !OS.isWindows() && isSystemTraySupported(OS);
export const isAutoDownloadUpdatesSupported = (
OS: OSType,
appVersion: string
): boolean => {
if (isNotUpdatable(appVersion)) {
return false;
}
return OS.isWindows() || OS.isMacOS();
};
export const shouldHideExpiringMessageBody = (
OS: OSType,
release: string
): boolean => OS.isWindows() || (OS.isMacOS() && semver.lt(release, '21.1.0'));
// Windows 11 and forward
export const isContentProtectionEnabledByDefault = (
OS: OSType,
release: string
): boolean => OS.isWindows() && semver.gte(release, '10.0.22000');