TweetFollow Us on Twitter

Aug 01 ADC Direct

Volume Number: 17 (2001)
Issue Number: 08
Column Tag: ADC DIrect

Making It Aqua: Adopting the Mac OS X User Experience

Aqua and User Expectations for Mac OS X

by John Geleynse

The graphical user interface of the Macintosh which charmed so many people back in 1984 has come a very long way. Indeed, with the recent introduction of Mac OS X, Apple unveiled Aqua. Aqua is the new interface that builds on the ease-of-use tradition of Mac OS 9. Aqua makes use of color, transparency, and animation to enhance usability. It also delivers new behaviors that make using a Mac even more fun and satisfying for users from computer novices to professionals.

With Aqua's revolutionary new features and attributes, users will expect your application to adopt and build upon its design. Why? Because people who use Mac OS X want all their applications—from spreadsheets and word processors to email clients and design tools—to have the consistency, appearance, intuitive design, and ease-of-use characteristic of Mac OS X. Users know when a product doesn't quite feel right (and so will product reviewers.)

This article will help you understand what it will take for your application to meet these user expectations.

Decide Where to Spend Your Resources

The level to which you adopt Aqua will depend on many things, including your development schedule, market demands, competitive pressures, and resource constraints. The chart included here (see Fig. 1a) can help you prioritize your efforts.

Look closely at Fig. 1a. The most important thing about this chart is focusing on compliance with Aqua basics before moving on to more advanced Aqua feature development. Spend your time becoming completely compliant with all the items under the "Good" Aqua Adoption Scenario (such as System Appearance, adopting the Layout Guidelines, respecting the Dock, etc.) before spending any effort on the advanced features (supporting Sheets, Dock animation, etc.).

What follows is a discussion of the individual building blocks of a "Good" Aqua adoption scenario.


Fig. 1a - Aqua Adoption Scenarios

Create Quality Icons

Your application's icon is one of the most visible attributes of your application on Mac OS X. A quality icon should clearly communicate what your application does, what type of media it works with, and whether it's meant for every day use. Just as you wouldn't want a visual designer writing your code, developers should avoid designing icons unless they have a background in visual design. The latest "Mac OS X Human Interface Guidelines" document (see next page) goes in depth on this and can provide you with a much better understanding about the incredible attention to detail icons have under Mac OS X.

Respect the Dock: Location

Your application should respect the Dock's location on the screen. When your application opens new windows, resizes windows, or zooms windows, it should avoid sizing them behind the Dock (or where the Dock is when it is visible). Sizing a window behind the Dock is extremely annoying because users are then forced to shrink the Dock or somehow move the window to get at its resize box.

Respect the Dock: A Click on the Dock Should Always Open a Window

Your application should always present a window when your Dock icon is clicked. This is to eliminate the all-too-familiar case where a user closes a document window and thinks they've quit the application. The rules are straight forward:

For document-based applications:

If no document windows are open
          Open and create an untitled document
If all open windows are minimized
        Activate the last window minimized
For non-document-based applications (e.g. System Preferences)
Show your main application window

Comply with the Mac OS X System Appearance

Aqua has a very unique, rich visual appearance which uses anti-aliased text, shadows, transparency, and color. On-screen interface elements have unique visual characteristics that go beyond what people are used to on the Mac or anywhere. All of these characteristics are unique to Mac OS X and your application needs to adhere to the look of Aqua if it's going to feel as if it belongs on Mac OS X.

Some common oversights in this area include white window backgrounds (rather than pinstriped backgrounds), mis-aligned pinstripes, incorrectly sized controls, clipped buttons and static text, and the use of non-standard fonts and font sizes (rather than system and application font specifications).

These types of oversights can dramatically affect the user's perception of the overall quality of your product. Do everything you can to ensure the visual presentation of your interface matches the appearance of Mac OS X.

Adopt the Layout Guidelines

Along similar lines, the appearance of Mac OS X also has a lot to do with the spacing and organization of interface elements. The "Mac OS X Human Interface Guidelines" document goes into great detail about layout guidelines. However, for the most part you don't need to worry about memorizing all those numbers because Apple provides a high-powered interface design tool: Interface Builder, which lets you design compliant dialogs and windows with ease.

The Mac OS X layout guidelines were developed for readability, localizability, and future functionality. Compliance with them dramatically affects the readability and usability of your Mac OS X application.

Apple Help

As part of a "Good" Aqua adoption scenario, remember to provide user assistance in your application with Apple Help (and not your own help delivery mechanism.)

"Better" and "Best" Scenarios: Sheets

Sheets are a new feature of Aqua and one of the things frequently noticed by users. A sheet is simply a modal dialog attached to a particular document or window, ensuring the user never loses track of which window the dialog applies to (and allowing the user to continue working on other documents in the same application.)

You should use sheets for dialogs specific to a document when the user must interact with the dialog and dismiss it before proceeding with work. Some examples include: a modal dialog specific to a particular document (such as saving or printing), a modal dialog specific to a single-window application that does not create documents, or window-specific dialogs typically dismissed by the user before proceeding.

Don't use sheets for dialogs that apply to several windows. Sheets are intended to be used in situations when a particular dialog is associated with only the window to which it is attached. Sheets are not appropriate for modeless operations where the dialog should be left open to allow the user to observe the effects of changes applied. Such tasks are better suited to modeless dialogs, utility windows (palettes), or drawers.

Also, please don't use a sheet on a window that doesn't have a title bar since sheets should emerge from a definite visual edge.

Native Code Is Nice, But Not Enough

Remember that finishing your port to Mac OS X doesn't mean you've finished your Mac OS X product. Delivering a good Mac OS X product obviously involves native code but, most importantly, includes paying attention to the details outlined in Fig. 1a. Native code is just the first step in bringing your application to Mac OS X.

Other Aqua Topics

More on the topics discussed here (and others) can be found in both the "Mac OS X Human Interface Guidelines" document and the main User Experience web page located at http://developer.apple.com/ue. Look online for the latest version of the "Mac OS X Human Interface Guidelines," and for links to Carbon- or Cocoa-specific documentation and sample code for all of the topics covered in this article.

Final Note: Looks Are Everything—Almost

Remember, users often judge the quality of a product by its appearance (or user interface.) So, if the visual presentation of your product is not Aqua compliant, they'll assume the overall functionality of the product is the same. Don't leave your UI work until the last minute. Build products that feel complete and have the Aqua look-and-feel. Pay attention to the details and you'll reap the rewards. Good luck.


New Mac OS X Related Releases

The following software is available from the Download Software area of the ADC Member Site at:
http://connect.apple.com/

  • WebObjects 5 Trial

    Trial version of WebObjects 5, expires 9/30/2001. NOTE: WebObjects 5 Trial is the same as what is available under Mac OS X Developer Tools link. Please See WebObjects 5 Key document for licensing information.

  • Mac OS X Java 3.1 Developer Preview 2 and Java 3.1 Documentation

    Mac OS X Java is an implementation of Java 2 Standard Edition 1.3.1, including the client version of HotSpot 1.3.1 Virtual Machine, which DP2 uses exclusively. For improved applet behavior with this release of Java, use Software Update to install Microsoft Internet Explorer 5.1.1 Preview.

  • CarbonLib 1.4a6 SDK

    The latest pre-release version of CarbonLib 1.4 SDK for Mac OS is now available to all ADC Members. This SDK provides all the files needed to begin Carbon development. CarbonLib 1.4 supports Mac OS 8.6 and greater.

  • Apple System Profiler 2.6.1a6

    Contains AppleScript fixes, launch speed improvements, OS X report sync, search option window fixes.

  • Mac OS X Developer Tools 10.0.1

    Downloadable version of the May 2001 Developer Tools CD distributed at WWDC to attendees. Contains the Mac OS X Developer Tools 10.0.1, and a trial version of WebObjects 5 which expires 9/30/2001. NOTE: The Carbon SDK is not included.

    Developer Documentation

    The following new and updated documentation is available to help with successful Mac OS X application and peripheral development at:
    http://developer.apple.com/techpubs/

    Carbon Specification
    Aqua Human Interface Guidelines


    Technical Notes
    TN1044 - Fundamentals of Open Firmware, Park III: Understanding PCI Expansion ROM Choices for Mac OS
    TN2016 - iTunes Visual Plug-ins
    TN2022 - The Death of typeFSSpec: moving along to typeFileURL


    Technical Q&As
    QA1053 - Using Pascal strings in Project Builder
    QA1043 - Using SetMovieGWorld to draw to the window back buffer
    QA1044 - Exporting TIFF files in little endian format
    QA1040 - 128Mb SDRAM Ics limitation on original "Bronze Keyboard" Powerbook G3
    JAVA28 - Creating JNI Libraries with Project Builder
    QA1039 - Fixing NSDocumentController to understand HFS file types
    QA1038 - HID Manager Event Data Underruns


    Sample Code
    SC - Graphics 3D: OpenGL Image
    SC - Cocoa: SimpleCocoaMovie
    SC - Graphics 2D: CTMDemo
    SC - Graphics 2D: CTMClip
    SC - Sound: CASoundLab2
    SC - Graphics 3D: Carbon SetupGL
    SC - Graphics 2D: BlitVBL
    SC - Graphics 2D: BlitNoVBL
    SC - Sound: AIFF writer sdev
    SC - Graphics 3D: aglString
    SC - Graphics 2D: CGGamma
    SC - Human Interface Toolbox: Tiler
    SC - Human Interface Toolbox: PackageTool
    SC - Java: JNISample
    SC - Cocoa: bMoviePalette
    SC - Devices and Hardware: HID Manager: HID Utilities Source
    SC - Devices and Hardware: HID Manager: HID Config Save
    SC - Devices and Hardware: HID Manager: HID Explorer
    SC - Devices and Hardware: HID Manager: HID Manager Basics
    SC - Graphics 3D: NSGL Teapot
    SC - Networking: NSLMiniBrowser
    SC - Java: JavaSpellingFramework
    SC - Java: JavaSpeechFramework


Did You Know?

Blueprints For Aqua Human Interfaces

A major goal for graphical human interfaces, aside from being intuitively usable and aesthetically pleasing, is consistency. Applications and system software should play by the same interface rules, whether those rules determine the placement of buttons on a dialog or the behavior of windows. If one or more applications were to do things differently, the resulting disharmony and confusion would degrade the user's experience.

To help developers design their applications' human interfaces to the same, well-considered standards, Apple Technical Publications provides Inside Mac OS X: Aqua Human Interface Guidelines. As a collection of blueprints for designing Aqua interfaces, this book is an indispensable resource. These guidelines will help you design modern, elegant applications that meet users' expectations of Macintosh software: intuitive, attractive, easy to learn, and enjoyable to use.

Inside Mac OS X: Aqua Human Interface Guidelines starts by explaining the principles that influence the design of Aqua human interfaces, including user control, direct manipulation, and forgiveness. Then, using specific examples and annotated figures, the book describes in detail how each part of the Aqua interface should look and behave. Individual chapters cover menus, windows, dialogs, controls and general layout, user input, fonts, icons, drag and drop, help, and terminology.

You can obtain a bound, print-on-demand copy of Inside Mac OS X: Aqua Human Interface Guidelines from Fatbrain.com at http://www1.fatbrain.com/documentation/apple.

You can also get PDF versions of the book from the Developer Essentials page of the installed and on-line
(http://developer.apple.com/techpubs/macosx/SystemOverview/devessentials.html) developer documentation.


Upcoming Seminars and Events

For more information on Apple developer events please visit the developer Events page at: http://developer.apple.com/events/

Training and Seminars

R/com Offers Mac OS X Developer Training Online
R/com, also known as MediaSchool http://www.mediaschool.com, has partnered with Apple Developer Connection to create online training for Mac OS X developers. The first courses to be released in July include "Application Development for Mac OS X," "Carbon Development for Mac OS X," and "Cocoa: The Object-Oriented Application Solution." All classes have been reviewed by Apple engineers for technical accuracy. Check out their site to take a free virtual seminar, to learn more about current and upcoming courses, and to find out about the significant discounts offered to Premier, Select, and Student members of the Apple Developer Connection.
http://www.mediaschool.com/adc/

Apple iServices 5-day Cocoa Training
For application developers who want to learn how to develop Mac OS X applications using Cocoa, Apple iServices offers a five-day comprehensive, hands-on Cocoa training course. This course uses real-world examples and is perfect for developers who have a general understanding of Object-oriented concepts and practical experience with the C programming language or a C-derived language (Object-C, Java, or C++). The course costs US $2,495.
http://www.apple.com/iServices/technicaltraining/cocoadev.html

Developer-Related Conferences

FileMaker Developer Conference 2001
August 12-August 15, Orlando, FL
More than 50 sessions and a product showcase. Various FileMaker training classes offered concurrently.
http://www.filemaker.com/devcon/
http://www.DevconTraining.com/

Apple Expo 2001
September 26-30
Porte de Versaille, Hall 4
Paris, France
http://www.apple-expo.com/


John Geleynse works in Apple's Worldwide Developer Relations Technology Management group and has experience in software development, product management, and product marketing. He promotes good user experience-related technologies within the Macintosh developer community. He can be reached at geleynse@apple.com.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Kodi 15.0.beta1 - Powerful media center...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
DiskCatalogMaker 6.4.12 - Catalog your d...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast. Finder-like intuitive look and feel. Super-fast search algorithm. Can compress catalog data... Read more
Macs Fan Control 1.3.0.0 - Monitor and c...
Macs Fan Control allows you to monitor and control almost any aspect of your computer's fans, with support for controlling fan speed, temperature sensors pane, menu-bar icon, and autostart with... Read more
Lyn 1.5.11 - Lightweight image browser a...
Lyn is a lightweight and fast image browser and viewer designed for photographers, graphic artists and Web designers. Featuring an extremely versatile and aesthetically pleasing interface, it... Read more
NeoOffice 2014.11 - Mac-tailored, OpenOf...
NeoOffice is a complete office suite for OS X. With NeoOffice, users can view, edit, and save OpenOffice documents, PDF files, and most Microsoft Word, Excel, and PowerPoint documents. NeoOffice 3.x... Read more
LaunchBar 6.4 - Powerful file/URL/email...
LaunchBar is an award-winning productivity utility that offers an amazingly intuitive and efficient way to search and access any kind of information stored on your computer or on the Web. It provides... Read more
Remotix 3.1.4 - Access all your computer...
Remotix is a fast and powerful application to easily access multiple Macs (and PCs) from your own Mac. Features Complete Apple Screen Sharing support - including Mac OS X login, clipboard... Read more
DesktopLyrics 2.6.6 - Displays current i...
DesktopLyrics is an application that displays the lyrics of the song currently playing in "iTunes" right on your desktop. The lyrics for the song have to be set in iTunes; DesktopLyrics does nothing... Read more
VOX 2.5.1 - Music player that supports m...
VOX is a beautiful music player that supports many filetypes. The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all... Read more
NetNewsWire 4.0.0 - RSS and Atom news re...
NetNewsWire is the best way to keep up with the sites and authors you read most regularly. Let NetNewsWire pull down the latest articles, and read them in a distraction-free and Mac-like way. Native... Read more

Biz Builder Delux (Games)
Biz Builder Delux 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: Ah, there's nothing like the rhythmic bustle of a burgeoning business burg... especially when you're the one building it... | Read more »
Auroch Digital is Bringing Back Games Wo...
| Read more »
Carbo - Handwriting in the Digital Age...
Carbo - Handwriting in the Digital Age 1.0 Device: iOS Universal Category: Productivity Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Draggy Dead (Games)
Draggy Dead 1.1 Device: iOS Universal Category: Games Price: $.99, Version: 1.1 (iTunes) Description: Ditch your dead end job and take up a rewarding career in Grave Robbing today!Guide the recently deceased to a fun filled life of... | Read more »
Bad Dinos (Games)
Bad Dinos 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: | Read more »
The Apple Watch isn't Great as a Fi...
| Read more »
Show the World What You See With Stre.am...
Live broadcasting is getting popular on mobile devices, which is why you can now get Stre.am, by Infinite Takes. [Read more] | Read more »
PhotoTime's 2.1 Update Adds Apple W...
The latest PhotoTime update is adding even more functionality to the handy photo organizing app. Yep, including Apple Watch support. [Read more] | Read more »
Oh My Glob! Adventure Time Puzzle Quest...
Finn and Jake are taking over D3 Go!'s popular puzzle game series in the upcoming Adventure Time Puzzle Quest. [Read more] | Read more »
Earthcore: Shattered Elements - Tips, Tr...
At first glance, Earthcore: Shattered Elements seems like a rather simple card-battling game. Once you’re introduced to skills that will change quite a bit. Even more so once you start to acquire hero cards. But it’s not so complicated that we... | Read more »

Price Scanner via MacPrices.net

Memorial Day Weekend Sale: New 27-inch 3.3GHz...
Best Buy has the new 27″ 3.3GHz 5K iMac on sale for $1899.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary... Read more
OtterBox Maximizes Portability, Productivity...
From the kitchen recipe book to the boarsroom presentation, the OtterBox Agility Tablet System turns tablets into one of the most versatile pieces of handheld technology available. Available now, the... Read more
Launch of New Car App Gallery and Open Develo...
Automatic, a company on a mission to bring the power of the Internet into every car, has announced the launch of the Automatic App Gallery, an app store for nearly every car or truck on the road... Read more
Memorial Day Weekend Sale: 13-inch 1.6GHz Mac...
Best Buy has the new 13″ 1.6GHz/128GB MacBook Air on sale for $849 on their online store this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders... Read more
Memorial Day Weekend Sale: 27-inch 3.5GHz 5K...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2099.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary.... Read more
Sale! 16GB iPad mini 3 for $349, save $50
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $349 including free shipping plus NY sales tax only. Their price is $50 off MSRP, and it’s the lowest price available for this model. Read more
Price drop on 2014 15-inch Retina MacBook Pro...
B&H Photo has dropped prices on 2014 15″ Retina MacBook Pros by $200. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799.99 save $200 - 15″ 2.5GHz... Read more
With a Mission to Make Mobile Free, Scratch W...
Scratch Wireless, claiming to be the world’s first truly free mobile service, has announced the availability of a new Scratch-enabled Android smartphone, the Coolpad Arise. The smartphone is equipped... Read more
First-Ever Titanium Alloy Curved iPhone 6 Scr...
One of the most common problems with mobile phones is damage to the screens. The slightest drop can cause a dreaded spider web of gashes and cracks in the glass panel surface that can cost $hundreds... Read more
Preorder new 12-inch MacBook, $10 off, save o...
Adorama has new 12″ Retina MacBooks available for preorder for $10 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Architect / Senior Software Engineer, *Apple...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
*Apple* Pay Support Readiness Project Manage...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.