Instance Method

launchApplicationAtURL:options:configuration:error:

Launches the app at the specified URL.

Declaration

- (NSRunningApplication *)launchApplicationAtURL:(NSURL *)url options:(NSWorkspaceLaunchOptions)options configuration:(NSDictionary<NSWorkspaceLaunchConfigurationKey, id> *)configuration error:(NSError * _Nullable *)error;

Parameters

url

The application URL.

options

Options to use when launching the application. See NSWorkspaceLaunchOptions 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 NSWorkspaceLaunchNewInstance 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

- openFile:

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

Deprecated
- openFile:withApplication:

Opens a file using the specified app.

Deprecated
- openFile:withApplication:andDeactivate:

Opens the specified file and optionally deactivates the sending app.

Deprecated
- openFile:fromImage:at:inView:

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

Deprecated
- launchApplication:

Launches the specified app.

Deprecated
- launchApplication:showIcon:autolaunch:

Launches the specified app using additional options.

Deprecated
- performFileOperation:source:destination:files:tag:

Performs a file operation on a set of files in a particular directory.

Deprecated
- fullPathForApplication:

Returns the full path for the specified app.

Deprecated
- absolutePathForAppBundleWithIdentifier:

Returns the absolute file system path of an app bundle.

Deprecated
- launchAppWithBundleIdentifier:options:additionalEventParamDescriptor:launchIdentifier:

Launches the app corresponding to the specified bundleIdentifier.

Deprecated
- openTempFile:

Opens the specified temporary file using the default app for its type.

Deprecated
- findApplications

Examines all apps and updates the records of registered services and file types.

Deprecated
- noteUserDefaultsChanged

Informs the NSWorkspace object that the defaults database has changed.

Deprecated
- slideImage:from:to:

Animates a sliding image from one point to another.

Deprecated
- checkForRemovableMedia

Polls the system’s drives for any disks that have been inserted but not yet mounted.

Deprecated
- noteFileSystemChanged

Informs the NSWorkspace object that the file system has changed.

Deprecated
- fileSystemChanged

Returns a Boolean value indicating whether a change to the file system has been registered with a noteFileSystemChanged message since the last fileSystemChanged message.

Deprecated
- userDefaultsChanged

Returns a Boolean value indicating whether a change to the defaults database has been registered with a noteUserDefaultsChanged message since the last userDefaultsChanged message.

Deprecated
- mountNewRemovableMedia

Returns the full pathnames of any newly mounted disks.

Deprecated
- mountedRemovableMedia

Returns the full pathnames of all currently mounted removable disks.

Deprecated
- mountedLocalVolumePaths

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

Deprecated
- activeApplication

Returns a dictionary with information about the current active app.

Deprecated
- launchedApplications

Returns an array of dictionaries, one entry for each running app.

Deprecated