Launch Services Framework Release Notes for OS X v10.5
This document summarizes changes in Launch Services for OS X v10.5 (Leopard) that are of particular interest to software developers. Note that you may be able to find more information on these changes in Apple's developer documentation.
Launch Services in OS X v10.5 (Leopard) is available as a component of the Core Services umbrella framework. This is a binary-compatible change from Mac OS 10.4, where Launch Services was part of the Application Services umbrella framework. Clients of the Launch Services API may link with the Core Services framework or a higher-level umbrella framework (Application Services, Cocoa, or Carbon).
Contents:
64-Bit Application Support
OS X Leopard contains 64-bit versions of many system frameworks, including Launch Services, enabling building and running Cocoa applications in a 64-bit address space. The 64-bit version of the Launch Services API differs from the 32-bit API in just one minor detail: two fields in the LSItemInfoRecord structure (iconFileName and kindID) have been eliminated. They are unused and undocumented in the 32-bit API, and so have not been carried forward to the 64-bit API.
File Quarantine
File Quarantine is a new feature in Leopard designed to protect users from trojan horse attacks. It allows applications which download file content from the Internet to place files in “quarantine” to indicate that the file could be from an untrustworthy source. An application quarantines a file simply by assigning values to one or more quarantine properties which preserve information about when and where the file come from.
When the Launch Services API is used to open a quarantined file and the file appears to be an application, script, or other executable file type, Launch Services will display an alert to confirm the user understands the file is some kind of application. If the file is opened, the quarantine properties are automatically cleared by Launch Services if the user has write access to the file.
The quarantine properties dictionary is a new named attribute accessible with the LSCopyItemAttribute
or LSCopyItemAttributes
functions. A new string constant defines the name of the quarantine properties attribute:
const CFStringRef kLSItemQuarantineProperties; |
The quarantine properties dictionary is modified using a new function for setting named attributes. In Leopard, the quarantine properties dictionary is the only settable named attribute.
OSStatus LSSetItemAttribute( |
const FSRef * inItem, |
LSRolesMask inRoles, |
CFStringRef inAttributeName, |
CFTypeRef inValue); |
The value of the quarantine properties attribute is a CFDictionaryRef
. The dictionary may contain values for the following quarantine properties:
const CFStringRef kLSQuarantineAgentNameKey; |
const CFStringRef kLSQuarantineAgentBundleIdentifierKey; |
const CFStringRef kLSQuarantineTimeStampKey; |
const CFStringRef kLSQuarantineTypeKey; |
const CFStringRef kLSQuarantineOriginURLKey; |
const CFStringRef kLSQuarantineDataURLKey; |
For more information about accessing named attributes, see interface LSInfo.h. For specific information about quarantine properties, see the new interface file LSQuarantine.h. Automatic file quarantining may also be enabled as a process-wide setting using an application Info.plist key (see New Info.plist Keys).
Shared File Lists
The Shared File List API is new to Launch Services in OS X Leopard. This API provides access to several kinds of system-global and per-user persistent lists of file system objects, such as recent documents and applications, favorites, and login items. For details, see the new interface file LSSharedFileList.h.
Opening Applications with Arguments
The LSApplicationParameters
structure introduced in OS X v10.4 contains an argv
field designed for passing arguments to an application's main
function. This API feature was disabled in the 10.4 release but is implemented in Leopard. If a new application process is created as a result of calling to LSOpenApplication
, LSOpenItemsWithRole
or LSOpenURLsWithRole
, the elements of the argv field are passed to the application's main function.
New Info.plist Keys
Launch Services in Leopard supports several new Info.plist keys for configuring various application settings, including automatic file quarantine mode, CPU architecture configuration for universal applications, and document type handler ranking. The table below summarizes the meaning and usage of each new key:
Key: |
|
Value type: |
Array of strings |
Valid values: |
ppc, ppc64, i386, x86_64 |
Notes: |
This key specifies the valid set and preferred selection order of the available executable architectures in a universal application bundle. For example, if i386 appears before x86_64 in the array, then on 64-bit Intel CPUs, the 32-bit architecture will be selected unless the user changes the setting in the application Info window in the Finder. If ppc appears in the array before i386, then on Intel CPUs Rosetta execution will be preferred over native execution. Use the |
Key: |
|
Value type: |
Dictionary |
Valid keys: |
ppc, ppc64, i386, x86_64 |
Valid values: |
An OS X release version string, such as "10.5" or "10.4.2" |
Notes: |
This key controls the minimum system version number that is permitted to execute each architecture in a universal application bundle. For example, if the value of the ppc64 key is "10.5.2," then releases prior to 10.5.2 will not allow the application to launch in 64-bit mode on PowerPC CPUs. |
Key: |
|
Value type: |
Boolean |
Notes: |
When the value of this key is |
Key: |
|
Value type: |
String |
Valid values: |
Owner, Default, Alternate, None |
Notes: |
Handler ranking is a mechanism for fine-tuning the document binding selection rules in Launch Services. The |
Copyright © 2018 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2007-10-31