Instance Method

launchApplication(at:options:configuration:)

Launches the app at the specified URL.

Declaration

func launchApplication(at url: URL, options: NSWorkspace.LaunchOptions = [], configuration: [NSWorkspace.LaunchConfigurationKey : Any]) throws -> NSRunningApplication

Parameters

url

The application URL.

options

Options to use when launching the application. See NSWorkspace.LaunchOptions for possible values.

configuration

A dictionary containing the configuration options. This dictionary can be used to pass additional options to the app. The configuration dictionary may be empty, in which case default behavior applies.

error

Returns, by-reference, the error if the application was unable to be launched. You may specify nil for this parameter if you do not want the error information.

Return Value

If the app is already running, and newInstance is not specified in the options dictionary, then a reference to the existing app is returned; otherwise a new application reference is returned. If the application could not be launched, nil is returned and the error is specified in error.

Discussion

It is safe to call this method from any thread in your app in macOS 10.6 and later.

See Also

Methods

func openFile(String) -> Bool

Opens the specified file specified using the default app associated with its type.

Deprecated
func openFile(String, withApplication: String?) -> Bool

Opens a file using the specified app.

Deprecated
func openFile(String, withApplication: String?, andDeactivate: Bool) -> Bool

Opens the specified file and optionally deactivates the sending app.

Deprecated
func openFile(String, from: NSImage?, at: NSPoint, in: NSView?) -> Bool

Opens a file using the default app for its type and animates the action using a custom icon.

Deprecated
func launchApplication(String) -> Bool

Launches the specified app.

Deprecated
func launchApplication(String, showIcon: Bool, autolaunch: Bool) -> Bool

Launches the specified app using additional options.

Deprecated
func fullPath(forApplication: String) -> String?

Returns the full path for the specified app.

Deprecated
func absolutePathForApplication(withBundleIdentifier: String) -> String?

Returns the absolute file system path of an app bundle.

Deprecated
func mountedRemovableMedia() -> [Any]?

Returns the full pathnames of all currently mounted removable disks.

Deprecated
func mountedLocalVolumePaths() -> [Any]?

Returns the mount points of all local volumes, not just the removable ones returned by mountedRemovableMedia().

Deprecated
func activeApplication() -> [AnyHashable : Any]?

Returns a dictionary with information about the current active app.

Deprecated