Перейти к основному содержанию

app

Контролируйте жизненный цикл Вашего приложения.

Процесс: Главный

Этот пример показывает, как закрыть приложение, когда последнее окно будет закрыто:

const { app } = require('electron')
app.on('window-all-closed', () => {
app.quit()
})

События

Объект app имеет следующие события:

Событие: 'will-finish-launching'

Происходит, когда приложение заканчивает основной запуск. На Windows и Linux событие will-finish-launching подобно событию ready; на macOS это событие представляет собой уведомление applicationWillFinishLaunching объекта NSApplication. Обычно настраивают слушателей для open-file и open-url событий, и запускают репортер сбоев и автоматическое обновление.

В большинстве случаев, Вы должны выполнять всё в обработчике события ready.

Событие: 'ready'

Возвращает:

Происходит единожды при завершении инициализации Electron. On macOS, launchInfo holds the userInfo of the NSUserNotification or information from UNNotificationResponse that was used to open the application, if it was launched from Notification Center. Вы также можете вызвать app.isReady() для проверки того, что событие уже произошло и app.whenReady() чтобы получить Promise, который выполнится, когда Electron будет инициализирован.

Событие: 'window-all-closed'

Происходит при закрытии всех окон.

Если Вы не подпишитесь на это событие, и все окна будут закрыты, поведением по умолчанию является выход из приложения; Однако, если Вы подпишитесь, то Вы определяете, будет ли приложение закрыто или нет. Если пользователь нажал Cmd + Q или разработчик вызвал app.quit(), Electron сначала попытается закрыть все окна, а затем происходит событие will-quit, и в этом случае событие window-all-closed не будет происходить.

Событие: 'before-quit'

Возвращает:

  • Событие типа event

Происходит до того, как приложение начнет закрывать свои окна. Вызов event.preventDefault() предотвратит поведение по умолчанию, которое приводит к прекращению работы приложения.

Примечание: Если выход приложения был инициирован autoUpdater.quitAndInstall(), тогда before-quit происходит после того, как происходит событие close на всех окнах и закрывает их.

Примечание: На Windows это событие не произойдет, если приложение закрылось из-за выключения/перезагрузки системы или выхода пользователя из системы.

Событие: 'will-quit'

Возвращает:

  • Событие типа event

Возникает, когда все окна будут закрыты и приложение завершит работу. Вызов event.preventDefault() предотвратит поведение по умолчанию, которое приводит к прекращению работы приложения.

Смотрите описание события window-all-closed для различий между событиями will-quit и window-all-closed.

Примечание: На Windows это событие не произойдет, если приложение закрылось из-за выключения/перезагрузки системы или выхода пользователя из системы.

Событие: 'quit'

Возвращает:

  • Событие типа event
  • exitCode Integer

Происходит при выходе из приложения.

Примечание: На Windows это событие не произойдет, если приложение закрылось из-за выключения/перезагрузки системы или выхода пользователя из системы.

Событие: 'open-file' macOS

Возвращает:

  • Событие типа event
  • path String

Происходит, когда пользователь хочет открыть файл. Событие open-file обычно происходит, когда приложение уже открыто и ОС хочет переиспользовать приложение, чтобы открыть файл. open-file также происходит, когда файл уже находится на Dock панели, но приложение еще не запущено. Убедитесь, что обработчик события open-file в самом начале запуска Вашего приложения обрабатывает этот случай (даже прежде, чем происходит событие ready).

Вы должны вызвать event.preventDefault(), если хотите обработать это событие.

На Windows Вам необходимо распарсить process.argv (в основном процессе), чтобы получить путь к файлу.

Событие: 'open-url' macOS

Возвращает:

  • Событие типа event
  • url String

Происходит, когда пользователь хочет открыть URL-адрес из приложения. Файл Вашего приложения Info.plist должнен определять схему URL в ключе CFBundleURLTypes и установить NSPrincipalClass в AtomApplication.

Вы должны вызвать event.preventDefault(), если хотите обработать это событие.

Событие: 'activate' macOS

Возвращает:

  • Событие типа event
  • hasVisibleWindows Boolean

Происходит при активации приложения. Различные действия могут запускать это событие, например, запуск приложения в первый раз, попытка перезапустить приложение, когда оно уже запущено, или клик на иконку приложения на панели dock или панели задач.

Событие: 'did-become-active' macOS

Возвращает:

  • Событие типа event

Происходит при активации приложения. Отличие от события activate в том, что did-become-active происходит после каждой активации приложения, а не только при нажатии на иконку на панели задач или перезапуске приложения.

Событие: 'continue-activity' macOS

Возвращает:

  • Событие типа event
  • type String - строка идентифицирует активность. Карты для NSUserActivity.activityType.
  • userInfo unknown - содержит специфическое для приложения состояние, сохраненное на другом устройстве.
  • Объект details
    • webpageURL String (optional) - A string identifying the URL of the webpage accessed by the activity on another device, if available.

Происходит во время Handoff, когда активность с другого устройства хочет возобновиться. Если вы хотите обработать это событие следует вызвать event.preventDefault().

Активность пользователя может быть продолжена только в приложении, которое имеет тот же ID команды разработчика, что и исходное приложение, и поддерживает тип активности. Поддерживаемые типы активности, указаны в Info.plist приложения под ключом NSUserActivityTypes.

Событие: 'will-continue-activity' macOS

Возвращает:

  • Событие типа event
  • type String - строка идентифицирует активность. Карты для NSUserActivity.activityType.

Происходит во время Handoff до того, как активность с другого устройства хочет возобновиться. Если вы хотите обработать это событие следует вызвать event.preventDefault().

Событие: 'continue-activity' macOS

Возвращает:

  • Событие типа event
  • type String - строка идентифицирует активность. Карты для NSUserActivity.activityType.
  • error String - cтрока с локализованным описанием ошибки.

Происходит во время Handoff, при ошибочном возобновлении активности на различных устройствах.

Событие: 'activity-was-continued' macOS

Возвращает:

  • Событие типа event
  • type String - строка идентифицирует активность. Карты для NSUserActivity.activityType.
  • userInfo unknown - содержит специфичное, для приложения, состояние, сохраненное в хранилище по активности.

Происходит во время Handoff, после удачного возобновления на другом устройстве.

Событие: 'update-activity-state' macOS

Возвращает:

  • Событие типа event
  • type String - строка идентифицирует активность. Карты для NSUserActivity.activityType.
  • userInfo unknown - содержит специфичное, для приложения, состояние, сохраненное в хранилище по активности.

Происходит во время Handoff, когда вот-вот возобновится на другом устройстве. Если Вы хотите обновить состояние, которое будет передано, Вам необходимо вызвать event.preventDefault() немедленно, собрать новый словарь userInfo и вызвать app.updateCurrentActivity() своевременно. Иначе, операция завершится ошибкой и будет вызвано continue-activity-error.

Событие: 'new-window-for-tab' macOS

Возвращает:

  • Событие типа event

Возникает при нажатии пользователем кнопки новой вкладки macOS. Кнопка новой вкладки отобразится только если текущий BrowserWindow имеет tabbingIdentifier

Событие: 'browser-window-blur'

Возвращает:

Возникает, когда browserWindow получает размытие.

Событие: 'browser-window-focus'

Возвращает:

Возникает, когда browserWindow получает фокус.

Событие: 'browser-window-created'

Возвращает:

Происходит, когда создался новый browserWindow.

Событие: 'web-contents-created'

Возвращает:

Происходит, когда создался новый webContents.

Событие: 'certificate-error'

Возвращает:

  • Событие типа event
  • webContents WebContents
  • url String
  • error String - код ошибки
  • certificate Certificate
  • callback Function
    • isTrusted Boolean - учитывать ли сертификат как надёжный
  • isMainFrame Boolean

Возникает, когда не удалось проверить certificate для url, чтобы доверять сертификату, вы должны предотвратить поведение по умолчанию с event.preventDefault() и вызвать callback(true).

const { app } = require('electron')

app.on('certificate-error', (event, webContents, url, error, certificate, callback) => {
if (url === 'https://github.com') {
// Сверка логики.
event.preventDefault()
callback(true)
} else {
callback(false)
}
})

Событие: 'select-client-certificate'

Возвращает:

Возникает при запросе сертификата клиента.

url соответствует записи навигации, запрашивающей сертификат клиента и callback можно вызвать с записью, отфильтрованной из списка. event.preventDefault() предотвращает приложению использование первого сертификата из хранилища.

const { app } = require('electron')

app.on('select-client-certificate', (event, webContents, url, list, callback) => {
event.preventDefault()
callback(list[0])
})

Событие: 'login'

Возвращает:

  • Событие типа event
  • webContents WebContents
  • authenticationResponseDetails Object
    • url URL
  • authInfo Object
    • isProxy Boolean
    • scheme String
    • host String
    • port Integer
    • realm String
  • callback Function
    • username String (опционально)
    • password String (опционально)

Возникает webContents, когда делается базовый auth.

Поведение по умолчанию - отмена всех аутентификаций. Чтобы переопределить это, Вы должны предотвратить поведение по умолчанию с помощью event.preventDefault() и вызвать callback(username, password) с учетными данными.

const { app } = require('electron')

app.on('login', (event, webContents, details, authInfo, callback) => {
event.preventDefault()
callback('username', 'secret')
})

Если calllback вызывается без имени пользователя или пароля, запрос аутентификации будет отменен и ошибка аутентификации будет возвращена на страницу.

Событие: 'gpu-info-update'

Выдается при каждом обновлении информации о GPU.

Event: 'gpu-process-crashed' Deprecated

Возвращает:

  • Событие типа event
  • killed Boolean

Возникает, когда процесс GPU аварийно завершает работу или завершается принудительно.

Устарело: Это событие заменяется событием child-process-gone, которое содержит больше информации о том, почему дочерний процесс исчез. It isn't always because it crashed. The killed boolean can be replaced by checking reason === 'killed' when you switch to that event.

Event: 'renderer-process-crashed' Deprecated

Возвращает:

  • Событие типа event
  • webContents WebContents
  • killed Boolean

Происходит, когда графический процесс webContents аварийно завершает работу или является убитым.

Deprecated: This event is superceded by the render-process-gone event which contains more information about why the render process disappeared. It isn't always because it crashed. The killed boolean can be replaced by checking reason === 'killed' when you switch to that event.

Event: 'render-process-gone'

Возвращает:

  • Событие типа event
  • webContents WebContents
  • Объект details
    • reason String - The reason the render process is gone. Возможные значения:
      • clean-exit - Process exited with an exit code of zero
      • abnormal-exit - Process exited with a non-zero exit code
      • killed - Process was sent a SIGTERM or otherwise killed externally
      • crashed - Process crashed
      • oom - Process ran out of memory
      • launch-failed - Process never successfully launched
      • integrity-failure - Windows code integrity checks failed
    • exitCode Integer - The exit code of the process, unless reason is launch-failed, in which case exitCode will be a platform-specific launch failure error code.

Emitted when the renderer process unexpectedly disappears. This is normally because it was crashed or killed.

Событие 'child-process-gone'

Возвращает:

  • Событие типа event
  • Объект details
    • type String - Тип процесса. Одно из следующих значений:
      • Utility
      • Zygote
      • Sandbox helper
      • GPU
      • Pepper Plugin
      • Pepper Plugin Broker
      • Unknown
    • reason String - Причина исчезновения дочернего процесса. Возможные значения:
      • clean-exit - Process exited with an exit code of zero
      • abnormal-exit - Process exited with a non-zero exit code
      • killed - Process was sent a SIGTERM or otherwise killed externally
      • crashed - Process crashed
      • oom - Process ran out of memory
      • launch-failed - Process never successfully launched
      • integrity-failure - Windows code integrity checks failed
    • exitCode Number - The exit code for the process (e.g. status from waitpid if on posix, from GetExitCodeProcess on Windows).
    • serviceName String (optional) - The non-localized name of the process.
    • name String (опционально) - Название процесса. Например: Audio Service, Content Decryption Module Service, Network Service, Video Capture и т.д.

Emitted when the child process unexpectedly disappears. This is normally because it was crashed or killed. It does not include renderer processes.

Событие: 'accessibility-support-changed' macOS Windows

Возвращает:

  • Событие типа event
  • accessibilitySupportEnabled Boolean - true когда доступность поддержки Chrome включена, false в противном случае.

Возникает при изменении Chrome поддержки специальных возможностей. Это событие срабатывает, когда вспомогательные технологии, такие как устройства чтения с экрана, включены или отключены. Смотрите https://www.chromium.org/developers/design-documents/accessibility для подробностей.

Событие: 'session-created'

Возвращает:

Происходит, когда Electron создал новый объект session.

const { app } = require('electron')

app.on('session-created', (session) => {
console.log(session)
})

Событие: 'second-instance'

Возвращает:

  • Событие типа event
  • argv String [] - массив аргументов командной строки вторичных экземпляров
  • workingDirectory String - рабочий каталог вторичных экземпляров
  • additionalData unknown - A JSON object of additional data passed from the second instance

Это событие произойдет внутри главного экземпляра Вашего приложения, когда второй экземпляр был запущен и вызывает app.requestSingleInstanceLock().

argv это массив аргументов командной строки второго экземпляра, а workingDirectory это текущая рабочая директория. Обычно приложения реагируют на это, делая их основное окно сфокусированным и не свернутым.

Примечание: Если второй экземпляр запускается другим пользователем, массив argv не будет содержать аргументы.

Это событие гарантировано происходит после события ready в app.

Примечание: Дополнительные аргументы командной строки могут быть добавлены Chromium, такие как --original-process-start-time.

Событие: 'desktop-capturer-get-sources'

Возвращает:

Возникает, когда desktopCapturer.getSources() вызывается в процессе рендерера webContents. Вызов event.preventDefault() вернет пустые источники.

Методы

Объект app имеет следующие методы:

Примечание: Некоторые методы доступны только в определенных операционных системах и помечены как таковые.

app.quit()

Попробуйте закрыть все окна. Сначала возникнет событие before-quit. Если все окна успешно закрыты, событие will-quit возникнет и по умолчанию приложение будет завершено.

Этот метод гарантирует, что все обработчики событий beforeunload и unload выполнятся корректно. Вполне возможно, что окно отменит выход, возвращая false в обработчике событий beforeunload.

app.exit([exitCode])

  • exitCode Integer (опционально)

Немедленный выход с помощью exitCode. exitCode по умолчанию 0.

Все окна будут закрыты немедленно, без разрешения пользователя, а также события before-quit и will-quit не будут происходить.

app.relaunch([options])

  • options Object (опционально)
    • args String[] (опционально)
    • execPath String (опционально)

Перезапускает приложение, когда существует текущий экземпляр.

По умолчанию, новый экземпляр будет использовать ту же самую рабочую директорию и аргументы командной строки, что и текущий экземпляр. Когда args указаны, args передадутся как аргументы командной строки. Когда execPath задан, вместо текущего приложения будет выполнен execPath для перезапуска.

Обратите внимание, что этот метод не завершает приложение при выполнении, Вам нужно вызвать app.quit или app.exit после вызова app.relaunch, чтобы перезапустить приложение.

Когда app.relaunch вызывается несколько раз, несколько экземпляров будет запущено после выхода из текущего экземпляра.

Пример немедленного перезапуска текущего экземпляра и добавления нового аргумента в командную строку нового экземпляра:

const { app } = require('electron')

app.relaunch({ args: process.argv.slice(1).concat(['--relaunch']) })
app.exit(0)

app.isReady()

Возвращает Boolean - true, если Electron завершил инициализацию, иначе false. См. также app.whenReady().

app.whenReady()

Возвращает Promise<void> - выполняется при инициализации Electron. Может быть использован в качестве удобной альтернативы проверки app.isReady() и подписывания на событие ready, если приложение еще не готово.

app.focus([options])

  • options Object (опционально)
    • steal Boolean macOS - Make the receiver the active app even if another app is currently active.

On Linux, focuses on the first visible window. On macOS, makes the application the active app. On Windows, focuses on the application's first window.

You should seek to use the steal option as sparingly as possible.

app.hide() macOS

Скрывает все окна приложения, не минимизируя их.

app.show() macOS

Показывает окна приложения после того, как они были скрыты. Автоматической фокусировки на них не происходит.

app.setAppLogsPath([path])

  • path String (опционально) - пользовательский путь для Ваших логов. Должен быть абсолютным.

Устанавливает или создает каталог логов Вашего приложения, которые затем могут быть обработаны с помощью app.getPath() или app.setPath(pathName, newPath).

Вызов app.setAppLogsPath() без параметра path приведет к тому, что этот каталог будет установлен на ~/Library/Logs/YourAppName на macOS, и внутри директории userData на Linux и Windows.

app.getAppPath()

Возвращает String - текущая директория приложения.

app.getPath(name)

  • name String - You can request the following paths by the name:
    • home домашняя директория пользователя.
    • appData Per-user application data directory, which by default points to:
      • %APPDATA% на Windows
      • $XDG_CONFIG_HOME или ~/.config на Linux
      • ~/Library/Application Support на macOS
    • userData директория для хранения файлов конфигурации Вашего приложения, которая по умолчанию является директорией appData с названием Вашего приложения в конце.
    • кэш
    • temp временный каталог.
    • exe текущий исполняемый файл.
    • module библиотека libchromiumcontent.
    • desktop директория рабочего стола, для текущего пользователя.
    • documents директория пользователя "Мои Документы".
    • downloads директория пользователя для загрузок.
    • music директория пользователя для музыки.
    • pictures директория пользователя для фотографий.
    • videos директория пользователя для видео.
    • recent Directory for the user's recent files (Windows only).
    • logs директория для логов Вашего приложения.
    • crashDumps Directory where crash dumps are stored.

Returns String - A path to a special directory or file associated with name. On failure, an Error is thrown.

Если app.getPath('logs') вызывается без имени app.setAppLogsPath(), то сначала создается каталог журнала по умолчанию, эквивалентный вызову app.setAppLogsPath() без параметра path.

app.getFileIcon(path[, options])

  • path String
  • options Object (опционально)
    • Строка size
      • small - 16x16
      • normal - 32x32
      • large - 48x48 на Linux, 32x32 на Windows, не поддерживается на macOS.

Возвращает Promise<NativeImage> - содержащий иконку приложения, которая является NativeImage.

Извлекает иконку, связанную с путем.

На Windows есть 2 вида иконок:

  • Значки, связанные с определенными расширениями, такими как .mp3, .png, и т.д.
  • Значки внутри файла, таких как .exe, .dll, .ico.

На Linux и macOS иконки зависят от приложения, ассоциируемого с mime-типом файла.

app.setPath(name, path)

  • name String
  • path String

Переопределяет path в специальную директорию или файл, связанный с name. Если путь задает каталог, который не существует, то при вызове выбросится Error. В этом случае каталог должен быть создан с помощью fs.mkdirSync или аналогичным способом.

Можно переопределять только пути name, определенные в app.getPath.

По умолчанию cookies и кэш веб-страницы будут храниться в директории userData. Если Вы хотите изменить это расположение, Вам необходимо переопределить путь userData прежде, чем событие ready модуля app произойдет.

app.getVersion()

Возвращает String - версию загруженного приложения. Если версия не найдена в файле приложения package.json, возвращается версия текущего пакета или исполняемого файла.

app.getName()

Возвращает String - имя текущего приложения, которое является именем в файле приложения package.json.

Обычно поле name в package.json является коротким именем, написанном в нижнем регистре, согласно спецификации модулей npm. Обычно Вы должны также указать поле productName, которое пишется заглавными буквами - имя Вашего приложения, и которое будет предпочтительнее name для Electron.

app.setName(name)

  • name String

Переопределяет имя текущего приложения.

Примечание: Эта функция перекрывает имя, используемое внутри Electron; это не влияет на имя, которое использует ОС.

app.getLocale()

Returns String - The current application locale, fetched using Chromium's l10n_util library. Possible return values are documented here.

Для установки языка вам потребуется использовать переключатель командной строки во время запуска приложения, который можно найти здесь.

Примечание: При распространении упакованного приложения, нужно также добавить папку locales.

Примечание На Windows Вы должны вызывать этот метод после того, как событие ready произойдет.

app.getLocaleCountryCode()

Returns String - User operating system's locale two-letter ISO 3166 country code. The value is taken from native OS APIs.

Примечание: Когда невозможно определить код страны языка, возвращает пустую строку.

app.addRecentDocument(path) macOS Windows

  • path String

Добавляет path к списку последних документов.

This list is managed by the OS. On Windows, you can visit the list from the task bar, and on macOS, you can visit it from dock menu.

app.clearRecentDocuments() macOS Windows

Очищает список последних документов.

app.setAsDefaultProtocolClient(protocol[, path, args])

  • protocol String - имя вашего протокола, без ://. For example, if you want your app to handle electron:// links, call this method with electron as the parameter.
  • path String (optional) Windows - The path to the Electron executable. Defaults to process.execPath
  • args String[] (optional) Windows - Arguments passed to the executable. По умолчанию пустой массив

Возвращает Boolean - был ли вызов успешным.

Sets the current executable as the default handler for a protocol (aka URI scheme). It allows you to integrate your app deeper into the operating system. Once registered, all links with your-protocol:// will be opened with the current executable. The whole link, including protocol, will be passed to your application as a parameter.

Note: On macOS, you can only register protocols that have been added to your app's info.plist, which cannot be modified at runtime. However, you can change the file during build time via Electron Forge, Electron Packager, or by editing info.plist with a text editor. За подробными сведениями обращайтесь к документации компании Apple.

Примечание: В окружении Windows Store (когда упаковано как appx) этот метод вернет true для всех вызовов, но ключ реестра, который он устанавливает, не будет доступен другим приложениям. Чтобы зарегистрировать Ваше приложения в Windows Store как обработчик протокола по умолчанию, Вы должны объявить протокол в Вашем манифесте.

The API uses the Windows Registry and LSSetDefaultHandlerForURLScheme internally.

app.removeAsDefaultProtocolClient(protocol[, path, args]) macOS Windows

  • protocol String - имя вашего протокола, без ://.
  • path String (optional) Windows - по умолчанию process.execPath
  • args String[] (optional) Windows - по умолчанию пустой массив

Возвращает Boolean - был ли вызов успешным.

This method checks if the current executable as the default handler for a protocol (aka URI scheme). If so, it will remove the app as the default handler.

app.isDefaultProtocolClient(protocol[, path, args])

  • protocol String - имя вашего протокола, без ://.
  • path String (optional) Windows - по умолчанию process.execPath
  • args String[] (optional) Windows - по умолчанию пустой массив

Returns Boolean - Whether the current executable is the default handler for a protocol (aka URI scheme).

Примечание: На macOS можно использовать этот метод для проверки, если приложение было зарегистрировано в качестве обработчика протокола по умолчанию для протокола. Вы также можете проверить это, проверив ~/Library/Preferences/com.apple.LaunchServices.plist на машине macOS. За подробными сведениями обращайтесь к документации компании Apple.

The API uses the Windows Registry and LSCopyDefaultHandlerForURLScheme internally.

app.getApplicationNameForProtocol(url)

  • url String - a URL with the protocol name to check. Unlike the other methods in this family, this accepts an entire URL, including :// at a minimum (e.g. https://).

Returns String - Name of the application handling the protocol, or an empty string if there is no handler. For instance, if Electron is the default handler of the URL, this could be Electron on Windows and Mac. However, don't rely on the precise format which is not guaranteed to remain unchanged. Expect a different format on Linux, possibly with a .desktop suffix.

This method returns the application name of the default handler for the protocol (aka URI scheme) of a URL.

app.getApplicationInfoForProtocol(url) macOS Windows

  • url String - a URL with the protocol name to check. Unlike the other methods in this family, this accepts an entire URL, including :// at a minimum (e.g. https://).

Возвращает Promise<Object> - Разрешить с объектом, содержащим следующее:

  • icon NativeImage - the display icon of the app handling the protocol.
  • path String - installation path of the app handling the protocol.
  • name String - display name of the app handling the protocol.

This method returns a promise that contains the application name, icon and path of the default handler for the protocol (aka URI scheme) of a URL.

app.setUserTasks(tasks) Windows

  • tasks Task[] - массив объектов Task

Добавляет tasks к категории Tasks в JumpList на Windows.

tasks массив объектов Task.

Возвращает Boolean - был ли вызов успешным.

Примечание: Если Вы хотите настроить список переходов еще больше - используйте app.setJumpList(categories).

app.getJumpListSettings() Windows

Возвращает Object:

  • minItems Integer - минимальное количество элементов, которые будут показаны в Jump List (для более подробного описания этого значение см. документация MSDN).
  • removedItems JumpListItem [] - массив объектов JumpListItem, которые соответствуют элементам, которые пользователь явно удалил из настраиваемых категорий в Jump List. Эти элементы не должны быть снова добавлены в список переходов, при следующем вызове app.setJumpList(), Windows не будет отображать любую пользовательскую категорию, содержащую любой из удаленных элементов.

app.setJumpList(categories) Windows

  • categories JumpListCategory[] | null - массив типа JumpListCategory, состоящий из объектов.

Задает или удаляет пользовательский список переходов для приложения и возвращает одну из следующих строк:

  • ok - ничего не случилось.
  • error - произошла одна или несколько ошибок, включите ведение журнала выполнения, чтобы выяснить возможную ошибку.
  • invalidSeparatorError - An attempt was made to add a separator to a custom category in the Jump List. Separators are only allowed in the standard Tasks category.
  • fileTypeRegistrationError - была сделана попытка добавить ссылку на файл в список переходов для типа файла, который в приложении не зарегистрирован для обработки.
  • customCategoryAccessDeniedError - пользовательские категории не могут быть добавлены в список переходов из-за ограничений конфиденциальности пользователей или групповой политики.

Если categories - null, то ранее установленный пользовательский список переходов (если таковой имеется) будет заменён стандартным списком переходов для приложения (управляется Windows).

Примечание: Если объект JumpListCategory не имеет ни type, ни name свойства, тогда type считается как tasks. Если свойство name установлено, но свойство type опущено, тогда type считается custom.

Примечание: Пользователи могут удалять элементы из пользовательских категорий, но Windows не будет позволять возвращать удаленный элемент в пользовательскую категорию до следующего удачного вызова app.setJumpList(categories). Любая попытка вновь добавить удаленный элемент в пользовательскую категорию перед тем, как метод выполнится, приведёт к исключению всей категории из списка переходов. Список удаленных элементов можно получить с помощью app.getJumpListSetting().

Note: The maximum length of a Jump List item's description property is 260 characters. Beyond this limit, the item will not be added to the Jump List, nor will it be displayed.

Вот очень простой способ, как создать пользовательский список переходов:

const { app } = require('electron')

app.setJumpList([
{
type: 'custom',
name: 'Recent Projects',
items: [
{ type: 'file', path: 'C:\\Projects\\project1.proj' },
{ type: 'file', path: 'C:\\Projects\\project2.proj' }
]
},
{ // has a name so `type` is assumed to be "custom"
name: 'Tools',
items: [
{
type: 'task',
title: 'Tool A',
program: process.execPath,
args: '--run-tool-a',
icon: process.execPath,
iconIndex: 0,
description: 'Runs Tool A'
},
{
type: 'task',
title: 'Tool B',
program: process.execPath,
args: '--run-tool-b',
icon: process.execPath,
iconIndex: 0,
description: 'Runs Tool B'
}
]
},
{ type: 'frequent' },
{ // has no name and no type so `type` is assumed to be "tasks"
items: [
{
type: 'task',
title: 'New Project',
program: process.execPath,
args: '--new-project',
description: 'Create a new project.'
},
{ type: 'separator' },
{
type: 'task',
title: 'Recover Project',
program: process.execPath,
args: '--recover-project',
description: 'Recover Project'
}
]
}
])

app.requestSingleInstanceLock()

  • additionalData unknown (optional) - A JSON object containing additional data to send to the first instance.

Возвращает Boolean

Значение, которое возвращает этот метод, указывает, успешно или нет экземпляр Вашего приложения получило блокировку. Если не удалось получить блокировку, можно предположить, что другой экземпляр Вашего приложения уже запущен с блокировкой и немедленно выходит.

I.e. This method returns true if your process is the primary instance of your application and your app should continue loading. Возвращает false, если Ваш процесс должен немедленно завершиться, так как он отправил свои параметры другому экземпляру, которые уже приобрел блокировку.

На macOS система автоматически обеспечивает единственный экземпляр, когда пользователи пытаются открыть второй экземпляра Вашего приложения в Finder, для этого будут происходить open-file и open-url события. Так или иначе, когда пользователи запустят Ваше приложение через командную строку, системный механизм единственного экземпляра будет обойден, и Вы должны использовать этот метод, чтобы обеспечить единственный экземпляр.

Пример активации окна первичного экземпляра, при запуске второго экземпляра:

const { app } = require('electron')
let myWindow = null

const additionalData = { myKey: 'myValue' }
const gotTheLock = app.requestSingleInstanceLock(additionalData)

if (!gotTheLock) {
app.quit()
} else {
app.on('second-instance', (event, commandLine, workingDirectory, additionalData) => {
// Print out data received from the second instance.
console.log(additionalData)

// Someone tried to run a second instance, we should focus our window.
if (myWindow) {
if (myWindow.isMinimized()) myWindow.restore()
myWindow.focus()
}
})

// Создать myWindow, загрузить остальную часть приложения, и т.д.
app.whenReady().then(() => {
myWindow = createWindow()
})
}

app.hasSingleInstanceLock()

Возвращает Boolean

Этот метод возвращает состояние, является или нет экземпляр Вашего приложения в данный момент, удерживающим блокировку единственного экземпляра. Вы можете запросить блокировку с помощью app.requestSingleInstanceLock() и освободить с помощью app.releaseSingleInstanceLock()

app.releaseSingleInstanceLock()

Releases all locks that were created by requestSingleInstanceLock. This will allow multiple instances of the application to once again run side by side.

app.setUserActivity(type, userInfo[, webpageURL]) macOS

  • type String - уникально идентифицирует действие. Карты для NSUserActivity.activityType.
  • userInfo any- специфичное, для приложения, состояние для использования другими устройствами.
  • webpageURL String (optional) - The webpage to load in a browser if no suitable app is installed on the resuming device. The scheme must be http or https.

Создает NSUserActivity и задает её в качестве текущей активности. Активность позже имеет право для Handoff на другом устройстве.

app.getCurrentActivityType() macOS

Возвращает String - тип текущей выполняемой активности.

app.invalidateCurrentActivity() macOS

Аннулирует текущую Handoff активность пользователя.

app.resignCurrentActivity() macOS

Помечает текущую Handoff активность пользователя как неактивную без ее отмены.

app.updateCurrentActivity(type, userInfo) macOS

  • type String - уникально идентифицирует действие. Карты для NSUserActivity.activityType.
  • userInfo any- специфичное, для приложения, состояние для использования другими устройствами.

Обновляет текущую активность, если его тип совпадает с type, объединяет записи из userInfo в его текущем словаре userInfo.

app.setAppUserModelId(id) Windows

  • id String

Изменяет Application User Model ID на id.

app.setActivationPolicy(policy) macOS

  • policy String - Can be 'regular', 'accessory', or 'prohibited'.

Sets the activation policy for a given app.

Activation policy types:

  • 'regular' - The application is an ordinary app that appears in the Dock and may have a user interface.
  • 'accessory' - The application doesn’t appear in the Dock and doesn’t have a menu bar, but it may be activated programmatically or by clicking on one of its windows.
  • 'prohibited' - The application doesn’t appear in the Dock and may not create windows or be activated.

app.importCertificate(options, callback) Linux

  • options Object
    • certificate String - путь к pkcs12 файлу.
    • password String - парольная фраза для сертификата.
  • callback Function
    • result Integer - результат импорта.

Импорт сертификата в формате pkcs12 из платформы хранилища сертификатов. callback вызывается с result - результат операции импорта, значение 0 указывает на успех, все другие значения указывают на ошибку в соответствии со списком net_error_list в Chromium.

app.configureHostResolver(options)

  • options Object
    • enableBuiltInResolver Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux.
    • secureDnsMode String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. При «автоматическом» поиск DoH будет выполняться первым, если DoH доступен, а небезопасный поиск DNS будет выполняться в качестве запасного. When "secure", only DoH lookups will be performed. Defaults to "automatic".
    • secureDnsServers String[] (optional) - A list of DNS-over-HTTP server templates. See RFC8484 § 3 for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for some DNS providers, the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list.
    • enableAdditionalDnsQueryTypes Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. Defaults to true.

Configures host resolution (DNS and DNS-over-HTTPS). By default, the following resolvers will be used, in order:

  1. DNS-over-HTTPS, if the DNS provider supports it, then
  2. the built-in resolver (enabled on macOS only by default), then
  3. the system's resolver (e.g. getaddrinfo).

This can be configured to either restrict usage of non-encrypted DNS (secureDnsMode: "secure"), or disable DNS-over-HTTPS (secureDnsMode: "off"). It is also possible to enable or disable the built-in resolver.

To disable insecure DNS, you can specify a secureDnsMode of "secure". If you do so, you should make sure to provide a list of DNS-over-HTTPS servers to use, in case the user's DNS configuration does not include a provider that supports DoH.

app.configureHostResolver({
secureDnsMode: 'secure',
secureDnsServers: [
'https://cloudflare-dns.com/dns-query'
]
})

Этот API должен вызываться после того, как произошло событие ready.

app.disableHardwareAcceleration()

Отключает аппаратное ускорение для текущего приложения.

Этот метод может быть вызван только до того, как приложение будет готово.

app.disableDomainBlockingFor3DAPIs()

By default, Chromium disables 3D APIs (e.g. WebGL) until restart on a per domain basis if the GPU processes crashes too frequently. This function disables that behavior.

Этот метод может быть вызван только до того, как приложение будет готово.

app.getAppMetrics()

Возвращает ProcessMetric[]: массив объектов ProcessMetric, которые соответствует статистике использования памяти и CPU всех процессов, связанных с приложением.

app.getGPUFeatureStatus()

Возвращает GPUFeatureStatus - статус функции графики из chrome://gpu/.

Примечание: Эта информация может использоваться только после возникновения события gpu-info-update.

app.getGPUInfo(infoType)

  • infoType String - Может быть basic или complete.

Возвращает Promise<unknown>

Для infoType равным complete: Промис выполняется с объектом, содержащий всю GPU информацию как в объекте GPUInfo в chromium. Это включает информацию о версии и драйвере, показанную на странице chrome://gpu.

Для infoType равным basic: Промис выполняется с объектом, содержащий меньшее количество атрибутов, чем когда запрашивается с complete. Вот пример базового ответа:

{
auxAttributes:
{
amdSwitchable: true,
canSupportThreadedTextureMailbox: false,
directComposition: false,
directRendering: true,
glResetNotificationStrategy: 0,
inProcessGpu: true,
initializationTime: 0,
jpegDecodeAcceleratorSupported: false,
optimus: false,
passthroughCmdDecoder: false,
sandboxed: false,
softwareRendering: false,
supportsOverlays: false,
videoDecodeAcceleratorFlags: 0
},
gpuDevice:
[{ active: true, deviceId: 26657, vendorId: 4098 },
{ active: false, deviceId: 3366, vendorId: 32902 }],
machineModelName: 'MacBookPro',
machineModelVersion: '11.5'
}

Использование basics должно быть предпочтительным, если требуется только основная информация, такая как vendorId или driverId.

app.setBadgeCount([count]) Linux macOS

  • count Integer (optional) - If a value is provided, set the badge to the provided value otherwise, on macOS, display a plain white dot (e.g. unknown number of notifications). On Linux, if a value is not provided the badge will not display.

Возвращает Boolean - был ли вызов успешным.

Sets the counter badge for current app. Setting the count to 0 will hide the badge.

На macOS отображается на иконке в Dock. На Linux работает только для лаунчера Unity.

Примечание: для работы Unity лаунчера требуется файл .desktop. Дополнительную информациюможно прочесть в Документации по интеграции Юнити.

app.getBadgeCount() Linux macOS

Возвращает Integer - текущее значение, отображаемое в значке счётчика.

app.isUnityRunning() Linux

Возвращает Boolean - является ли текущее окружение рабочего стола Unity.

app.getLoginItemSettings([options]) macOS Windows

  • options Object (опционально)
    • path String (optional) Windows - The executable path to compare against. Defaults to process.execPath.
    • args String[] (optional) Windows - The command-line arguments to compare against. Defaults to an empty array.

Если Вы предоставили параметры path и args в app.setLoginItemSettings, тогда Вам необходимо передать те же аргументы сюда, чтобы openAtLogin установилось корректно.

Возвращает Object:

  • openAtLogin Boolean - true если приложение планируется открыть при входе в систему.
  • openAsHidden Boolean macOS - true if the app is set to open as hidden at login. This setting is not available on MAS builds.
  • wasOpenedAtLogin Boolean macOS - true if the app was opened at login automatically. This setting is not available on MAS builds.
  • wasOpenedAsHidden Boolean macOS - true if the app was opened as a hidden login item. Это означает, что приложению не следует открывать любое окно при запуске. This setting is not available on MAS builds.
  • restoreState Boolean macOS - true if the app was opened as a login item that should restore the state from the previous session. Это означает, что приложение должно восстановить окна, которые были открыты в последний раз, когда приложение было закрыто. This setting is not available on MAS builds.
  • executableWillLaunchAtLogin Boolean Windows - true if app is set to open at login and its run key is not deactivated. This differs from openAtLogin as it ignores the args option, this property will be true if the given executable would be launched at login with any arguments.
  • launchItems Object[] Windows
    • name String Windows - name value of a registry entry.
    • path String Windows - The executable to an app that corresponds to a registry entry.
    • args String[] Windows - the command-line arguments to pass to the executable.
    • scope String Windows - one of user or machine. Indicates whether the registry entry is under HKEY_CURRENT USER or HKEY_LOCAL_MACHINE.
    • enabled Boolean Windows - true if the app registry key is startup approved and therefore shows as enabled in Task Manager and Windows settings.

app.setLoginItemSettings(settings) macOS Windows

  • settings Object
    • openAtLogin Boolean (optional) - true to open the app at login, false to remove the app as a login item. Defaults to false.
    • openAsHidden Boolean (optional) macOS - true to open the app as hidden. Значение по умолчанию: false. Пользователь может редактировать этот параметр в системных настройках, так что app.getLoginItemSettings().wasOpenedAsHidden должно быть проверено, когда приложение открыто, чтобы узнать текущее значение. This setting is not available on MAS builds.
    • path String (optional) Windows - The executable to launch at login. Defaults to process.execPath.
    • args String[] (optional) Windows - The command-line arguments to pass to the executable. Defaults to an empty array. Take care to wrap paths in quotes.
    • enabled Boolean (optional) Windows - true will change the startup approved registry key and enable / disable the App in Task Manager and Windows Settings. Defaults to true.
    • name String (optional) Windows - value name to write into registry. Defaults to the app's AppUserModelId(). Установите приложению параметры при входе в систему.

Для работы с Electron autoUpdater на Windows, который использует Squirrel, вы можете задать путь запуска Update.exe и передавать аргументы, которые указывают на имя приложения. Например:

const appFolder = path.dirname(process.execPath)
const updateExe = path.resolve(appFolder, '..', 'Update.exe')
const exeName = path.basename(process.execPath)

app.setLoginItemSettings({
openAtLogin: true,
path: updateExe,
args: [
'--processStart', `"${exeName}"`,
'--process-start-args', `"--hidden"`
]
})

app.isAccessibilitySupportEnabled() macOS Windows

Возвращает Boolean - true если включена поддержка специальных возможностей Chrome, и false в противном случае. Этот API будет возвращать true, если обнаружено использование вспомогательных технологий, таких как средства чтения с экрана. Смотрите https://www.chromium.org/developers/design-documents/accessibility для подробностей.

app.setAccessibilitySupportEnabled(enabled) macOS Windows

Вручную включает поддержку специальных возможностей от Chrome, позволяя пользователям открывать специальные возможности в настройках приложения. Смотрите документацию специальных возможностей Chromium для подробной информации. Отключено по умолчанию.

Этот API должен вызываться после того, как произошло событие ready.

Note: Rendering accessibility tree can significantly affect the performance of your app. It should not be enabled by default.

app.showAboutPanel()

Show the app's about panel options. These options can be overridden with app.setAboutPanelOptions(options).

app.setAboutPanelOptions(options)

  • options Object
    • applicationName String (опиционально) - имя приложения.
    • applicationVersion String (опиционально) - версия приложения.
    • copyright String (опиционально) - copyright информация.
    • version String (optional) macOS - The app's build version number.
    • credits String (optional) macOS Windows - Credit information.
    • authors String[] (optional) Linux - List of app authors.
    • website String (optional) Linux - The app's website.
    • iconPath String (optional) Linux Windows - Path to the app's icon in a JPEG or PNG file format. On Linux, will be shown as 64x64 pixels while retaining aspect ratio.

Установите описание панели опций. This will override the values defined in the app's .plist file on macOS. Смотрите Apple docs для получения более подробной информации. На Linux необходимо устанавливать все значения; по умолчанию значений нет.

If you do not set credits but still wish to surface them in your app, AppKit will look for a file named "Credits.html", "Credits.rtf", and "Credits.rtfd", in that order, in the bundle returned by the NSBundle class method main. The first file found is used, and if none is found, the info area is left blank. See Apple documentation for more information.

app.isEmojiPanelSupported()

Возвращает Boolean - позволяет или нет текущая версия ОС выбирать нативные эмодзи.

app.showEmojiPanel() macOS Windows

Показывает нативный выбор эмодзи.

app.startAccessingSecurityScopedResource(bookmarkData) mas

  • bookmarkData String - Закодированные base64 данные закладки области безопасности, возвращаемые dialog.showOpenDialog или dialog.showSaveDialog.

Returns Function - This function must be called once you have finished accessing the security scoped file. Если Вы забыли, запретить доступ к закладке, возможно утечка ресурсов ядра и ваше приложение потеряет свою способность выйти за пределы песочницы, пока не будет перезапущено.

// Получение доступа к файлу.
const stopAccessingSecurityScopedResource = app.startAccessingSecurityScopedResource(data)
// Теперь вы можете получить доступ к файлу за пределами песочницы🎉

// Не забудьте прекратить доступ к файлу после того, как закончите с ним.
stopAccessingSecurityScopedResource()

Начать доступ в области безопасности ресурса. С помощью этого метода Electron приложения, которые упакованы для Mac App Store, могут выходить на пределы их песочницы, чтобы получить файлы, выбранные пользователем. Подробное описание как работает эта система, смотри Apple's documentation.

app.enableSandbox()

Включает полноценный режим песочницы в приложении. Это означает, что все рендереры будут запускаться изолированно, независимо от значения параметра sandbox флаг в WebPreferences.

Этот метод может быть вызван только до того, как приложение будет готово.

app.isInApplicationsFolder() macOS

Возвращает Boolean - выполняется ли приложение в данный момент из системной папки Приложения. Используйте в сочетании с app.moveToApplicationsFolder()

app.moveToApplicationsFolder([options]) macOS

  • options Object (опционально)
    • conflictHandler Function\<Boolean> (optional) - A handler for potential conflict in move failure.
      • conflictType String - Тип конфликта перемещения, с которым столкнулся обработчик; может быть exists или existsAndRunning, где exists означает, что приложение с тем же именем присутствует в каталоге приложений, а existsAndRunning означает, что он существует и работает в данный момент.

Возвращает Boolean - если перемещение было успешным. Обратите внимание, что если перемещение выполнено успешно, ваше приложение закроется и перезапустится.

По умолчанию диалоговое окно подтверждения не отображается. Если нужно подтверждение операции пользователем, используйте dialog API.

ПРИМЕЧАНИЕ: Этот метод выдает ошибки, если что-то, кроме пользователя, вызывает переход к неудачи. Например, если пользователь отменяет диалоговое окно авторизации, этот метод возвращает false. Если нам не удастся выполнить копирование, этот метод вызовет ошибку. Сообщение об ошибке должно быть информативным и сообщать вам именно то, что пошло не так.

По умолчанию, если приложение с тем же именем, что и перемещаемое, существует в каталоге Applications и not запущено, существующее приложение будет удалено, а активное приложение перемещено на свое место. Если оно работает, на уже существующее запущенное приложение переместится фокус, а ранее активное приложение само завершит работу. Это поведение можно изменить, предоставив необязательный обработчик конфликтов, где логическое значение, возвращаемое обработчиком, определяет, будет ли конфликт перемещения разрешен с поведением по умолчанию. то есть возврат false гарантирует, что дальнейшие действия не будут приняты, возврат true приведет к поведению по умолчанию и продолжению метода.

Например:

app.moveToApplicationsFolder({
conflictHandler: (conflictType) => {
if (conflictType === 'exists') {
return dialog.showMessageBoxSync({
type: 'question',
buttons: ['Halt Move', 'Continue Move'],
defaultId: 0,
message: 'An app of this name already exists'
}) === 1
}
}
})

Будет означать, что если приложение уже существует в каталоге пользователя, если пользователь выберет 'Continue Move', то эта функция будет продолжена с поведением по умолчанию, и существующее приложение будет удалено и активное приложение будет перемещено на место.

app.isSecureKeyboardEntryEnabled() macOS

Возвращает Boolean - если включен Secure Keyboard Entry.

По умолчанию этот API вернет false.

app.setSecureKeyboardEntryEnabled(enabled) macOS

  • enabled Boolean - Включить или отключить Secure Keyboard Entry

Установка Secure Keyboard Entry включена в вашем приложении.

Используя этот API, можно предотвратить перехват важной информации, такой как пароль и другую конфиденциальную информацию, другими процессами.

См. Apple's documentation для получения дополнительной информации подробности.

Примечание: Включайте Secure Keyboard Entry только тогда, когда он нужен, и отключайте, когда он больше не нужен.

Свойства

app.accessibilitySupportEnabled macOS Windows

Boolean свойство, которое true, если поддержка специальных возможностей Chrome включена, иначе false. Это свойство будет true, если использование вспомогательных технологий, таких как средства чтения с экрана, были обнаружены. Устанавливая это свойство на true, вручную включает поддержку специальных возможностей Chrome, позволяя разработчикам показать пользователю переключатели специальных возможностей в настройках приложения.

См. Chromium's accessibility docs для получения более подробной информации. Отключено по умолчанию.

Этот API должен вызываться после того, как произошло событие ready.

Note: Rendering accessibility tree can significantly affect the performance of your app. It should not be enabled by default.

app.applicationMenu

A Menu | nullсвойство, которое возвращает Menu если оно было установлено, в противном случае возвращает null. Пользователи могут передать Меню, чтобы установить это свойство.

app.badgeCount Linux macOS

Свойство Integer, которое возвращает количество значков для текущего приложения. Установка счетчика на 0 скроет значок.

В macOS установка любого ненулевого целого числа отображается на значке док-станции. В Linux это свойство работает только для модуля запуска Unity.

Примечание: для работы Unity лаунчера требуется файл .desktop. Дополнительную информациюможно прочесть в Документации по интеграции Юнити.

Примечание: На macOS, вы должны убедиться, что ваше приложение имеет разрешение на отображение уведомлений.

app.commandLine Readonly

Объект CommandLine, который позволяет читать и манипулировать аргументами командной строки, используемыми Chromium.

app.dock macOS Readonly

Это Dock | undefined объект, который позволяет вам выполнять действия со значком вашего приложения в пользовательском док на macOS.

app.isPackaged Readonly

Boolean свойство, которое возвращает true, если приложение упаковано, false иначе. Для многих приложений это свойство может использоваться для отличия среды разработки и производства.

app.name

Свойство String, указывающее имя текущего приложения, которое является именем в файле package.json.

Обычно поле name в package.json является коротким именем, написанном в нижнем регистре, согласно спецификации модулей npm. Обычно Вы должны также указать поле productName, которое пишется заглавными буквами - имя Вашего приложения, и которое будет предпочтительнее name для Electron.

app.userAgentFallback

Строка, которая является строкой агента пользователя, которую Electron будет использовать в качестве глобального запаса.

Это агент пользователя, который будет использоваться, если ни один агент пользователя не установлен на уровнях webContents или session. Это полезно для того, чтобы все ваше приложение имело один и тот же пользовательский агент. Установите пользовательское значение как можно раньше в инициализации Ваших приложений, чтобы убедиться, что используется переопределенное значение.

app.runningUnderRosettaTranslation macOS Readonly Deprecated

A Boolean which when true indicates that the app is currently running under the Rosetta Translator Environment.

Вы можете использовать это свойство, чтобы предложить пользователям загрузить версию для arm64 вашего приложения, когда они запускают версию x64 под Rosetta неправильно.

Deprecated: This property is superceded by the runningUnderARM64Translation property which detects when the app is being translated to ARM64 in both macOS and Windows.

app.runningUnderARM64Translation Readonly macOS Windows

A Boolean which when true indicates that the app is currently running under an ARM64 translator (like the macOS Rosetta Translator Environment or Windows WOW).

Вы можете использовать это свойство, чтобы предложить пользователям загрузить версию для arm64 вашего приложения, когда они запускают версию x64 под Rosetta неправильно.