Aspirerelease/17.0

aspire tray command for managing local AppHosts

이 콘텐츠는 아직 번역되지 않았습니다.

aspire tray - Manage the desktop tray companion.

Aspire CLI
aspire tray [command] [options]

The aspire tray command manages the Aspire tray companion, a desktop panel icon for managing local AppHosts. The tray is available on Windows, macOS, and glibc Linux (x64 and ARM64). The command is hidden from help on unsupported operating systems and on musl-based Linux.

On Linux, the tray uses a StatusNotifierItem icon. GNOME renders its D-Bus menu through an AppIndicator extension; other desktops display an Aspire-owned panel. Headless sessions and musl-based distributions aren’t supported. The following host dependencies, which aren’t bundled with the CLI, must also be present:

  • A graphical desktop session
  • GTK 3
  • On GNOME, an AppIndicator library, such as Ayatana AppIndicator or a compatible libappindicator, and an enabled AppIndicator extension
  • On non-GNOME Wayland desktops, libgtk-layer-shell.so.0 and a compositor that supports the layer-shell protocol
  • On non-GNOME X11 desktops, a compositing manager to open the panel
  • A StatusNotifierItem tray host, such as Waybar with its tray module enabled

If no tray host is available when you run aspire tray start, the CLI reports it. The icon appears as soon as tray support becomes available.

The following options are available:

  • -?, -h, --help

    Prints help and usage documentation for the available commands and options.

  • -l, --log-level <Critical|Debug|Error|Information|None|Trace|Warning>

    Set the minimum log level for console output. Use this option to increase diagnostics while troubleshooting or reduce output in scripted runs.

  • --non-interactive

    Run the command in non-interactive mode, disabling all interactive prompts and spinners.

  • --nologo

    Suppress the startup banner and telemetry notice.

  • --banner

    Display the animated Aspire CLI welcome banner.

  • --wait-for-debugger

    Wait for a debugger to attach before running a command.

The following commands are available:

CommandStatusFunction
aspire tray startPreviewStart or restore the tray icon.
aspire tray stopPreviewStop the tray without stopping AppHosts.