<!--
{
  "availability" : [
    "macOS: 10.6.0 - 11.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSWorkspace/LaunchConfigurationKey",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@T@NSWorkspaceLaunchConfigurationKey"
  },
  "title" : "NSWorkspace.LaunchConfigurationKey"
}
-->

# NSWorkspace.LaunchConfigurationKey

The following keys can be used in the configuration dictionary of the [`launchApplication(at:options:configuration:)`](/documentation/AppKit/NSWorkspace/launchApplication(at:options:configuration:)) method.  Each key is optional, and if omitted, default behavior is applied.

```
struct LaunchConfigurationKey
```

## Topics

### Type Properties

[`static let appleEvent: NSWorkspace.LaunchConfigurationKey`](/documentation/AppKit/NSWorkspace/LaunchConfigurationKey/appleEvent)

The value is the first NSAppleEventDescriptor to send to the new app.  If an instance of the app is already running, this is sent to that app.

[`static let architecture: NSWorkspace.LaunchConfigurationKey`](/documentation/AppKit/NSWorkspace/LaunchConfigurationKey/architecture)

The value is an NSNumber containing an Mach-O Architecture constant.  Ignored if a new instance of the app is not launched.

[`static let arguments: NSWorkspace.LaunchConfigurationKey`](/documentation/AppKit/NSWorkspace/LaunchConfigurationKey/arguments)

The value is an `NSArray` of `NSStrings`, passed to the new app in the `argv` parameter.  Ignored if a new instance of the app is not launched. This constant is not available to sandboxed apps.

[`static let environment: NSWorkspace.LaunchConfigurationKey`](/documentation/AppKit/NSWorkspace/LaunchConfigurationKey/environment)

The value is an `NSDictionary`, mapping `NSStrings` to `NSStrings`, containing environment variables to set for the new app.  Ignored if a new instance of the app is not launched. This constant is not available to sandboxed apps.

### Initializers

[`init(rawValue: String)`](/documentation/AppKit/NSWorkspace/LaunchConfigurationKey/init(rawValue:))

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`Hashable`](/documentation/Swift/Hashable)

[`RawRepresentable`](/documentation/Swift/RawRepresentable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)