TweetFollow Us on Twitter

Feb 99 Factory Floor

Volume Number: 15 (1999)
Issue Number: 2
Column Tag: From The Factory Floor

Universal Interfaces Today

by Nick Kledzik and Dave Mark, ©1999 by Metrowerks, Inc., all rights reserved.

This month, the Factory Floor visits with Nick Kledzik, Apple's Universal Interface-meister. With our upcoming move to Carbon and MacOS X, the time seems right for an update and Nick was kind enough to give us one.

Nick Kledzik <kledzik@apple.com> has been a software engineer at Apple for over 11 years working on various toolbox managers. In '93 he wrote an internal coding style document called "Building Code" which lead him to his current work of managing the Mac OS API's. Recently he has been working on MRJ (Apple's Java VM), developing JDirect 2.0 which enables java code direct access to the Mac OS toolbox. When not working he's probably pampering his new wife or their cats: Catbert and Hobbes.

Dave: How did the Universal Interfaces get started?

Nick: Back in '93 the PowerMac team was working on the software to enable Macintoshes to use the PowerPC processor instead of the 68k family. The team quickly realized that the existing 68k headers were riddled with 68k-isms and could not be compiled by xlc, the only PowerPC compiler at the time. The first approach was a one shot tool to munge the headers to be compatible with xlc. But, alas, the rest of Apple's software teams continued to use and modify the 68k based headers, and the PowerPC headers were so different that merging and synchronizing changes proved to be an immense time sink.

The solution that evolved was to have a central repository called MasterInterfaces in which all headers were stored. The headers were an augmented form of the 68k headers with their names changed to end in .i instead of .h to ease build rules. A tool called Interfacer was developed which could read the .i files and generate "universal" C headers. The name "universal" was coined because they could be read by both 68k compilers and the PowerPC compiler.

This model proved to be very powerful. The Interfacer was enhanced to generate MixedMode glue for all the System APIs. When we discovered that a #pragma needed to be added to all .h files, all it took was one change to the Interfacer tool and all generated .h files were updated.

In early '94 I headed up a group to fully implement this model. We merged all Apple's public and private headers into MasterInterfaces and updated the Interfacer tool to also emit assembly and Pascal interfaces. The result was the 2.0 Universal Interfaces. Then I started getting serious about being "universal". My goal for the 3.0 Interfaces was that they would "just work" with every compiler on the planet. To do so, every compiler dependent aspect of the headers had to be conditionalized and the core file ConditionalMacros.h had to be able to recognize and auto-configure itself.

Dave: What's the difference between Universal Interfaces and Universal Headers?

Nick: Apple uses the term "interfaces" in the generic sense of the interface between an application and the OS. That's the "I" in API. Metrowerks organized their CodeWarrior CD by naming files for Pascal as "Interfaces" and for C as "Headers". The result was that the term "Universal Headers" was born to describe Apple's Universal Interfaces for C.

Dave: What process do you go through to generate each new batch of Universal Interfaces?

Nick: The overriding question is when to release. For this, I look for either a milestone release from Apple (such as Mac OS 8.1 or 8.5) or a tempting release vehicle such as a CodeWarrior CD release. Once the ship date is locked down, I review the bugs that developers have reported and work with the various engineering teams at Apple to make sure that all changes have been checked into MasterInterfaces. The build part is easy. The Interfacer tool now runs in a batch mode, which means the Interfacer tool is only run once and it emits the C, Pascal, Asm, and Rez files in parallel. The entire build of 750+ files takes under 3 minutes!

Dave: With each new release of the Universal Interfaces, most everyone's code breaks. What is Apple doing to address this problem?

Nick: I review changes in MasterInterfaces and categorize them as to their effect on developers:

  1. Transparent.
  2. Source compatible because of grandfathering of old names or types.
  3. Source compatible if developer changes #includes.
  4. Binary but not source compatible.
  5. Source but not binary compatible.
  6. Neither source nor binary compatible.

Over 95% of the changes are type 1 and are never noticed by developers. For the rest, I work with the engineering teams to make them type 2 by using #defines or typedefs inside of OLDROUTINENAMES so that a developer can make the changes at his leisure. But a few, like moving SysBeep from OSUtils.h to Sound.h, could not be changed to type 1 or 2 because Sound.h already included OSUtils.h and you can't have circular includes.

But, the detection and flagging of these changes is still a manual process and some still slip by me. In the future, Interfacer will become smarter and automatically issue warnings or errors when a source incompatible change is made to a .i file.

Dave: What exactly is Carbon?

Nick: Carbon refers to the subset of Mac OS APIs (functions) in Universal Interfaces that will be supported on Mac OS 8.1 through Mac OS X. In addition, the only clients of Carbon APIs should be application-level code (apps, plugins, shared libraries, etc.) In Mac OS X, drivers will be built using different headers and APIs than applications.

Dave: How will Carbon affect the Universal Interfaces?

Nick: The plan is for a future release of Universal Interfaces to support Carbon development. That is, we will be adding #if statements to the Universal Interfaces so that a developer can assert that he is targeting Carbon (as opposed to System 7 or Mac OS 8.x) and get compile time errors if his code calls any Mac OS function that is not in Carbon. Note, even if he does not assert he is targeting Carbon, he will still get a link time error because you link against different stub libraries when building applications for Carbon.

Dave: Does this mean we are going to have even more Stub Libraries?

Nick: At this time, the plan for Mac OS X is to have one CarbonLib stub library. I'm considering making a similar MacOS8Lib stub library which contains fragments for InterfaceLib, DragLib, SoundLib, etc. This will make it much easier for developers to figure out which stub libraries to use. The problem is there are enough cases where developers want or need a finer level of control (e.g. BlockZero from InterfaceLib vs DriverServicesLib), that I will probably need to ship both the high level conglomerate stub libraries (e.g. MacOS8Lib) and the low level individual stub libraries (e.g. InterfaceLib).

Dave: What changes do you see coming down the pike for programmers who want to call the Mac Toolbox directly from their Java programs?

Nick: Java has and will continue to become faster and easier to use on Macs. But, there is a fundamental impedance mismatch between Java and the Mac OS toolbox. Java is an object oriented language with garbage collection and a theoretically uncrashable runtime. The Mac OS toolbox is none of those things.

Java programmers have a couple of options for easy access to the Mac OS toolbox:

  • Use the standard Java classes such as java.io.File - The implementation of those standard classes on MRJ will "do the right thing" on the Mac OS, such as setting file types and creators via Internet Config.
  • Use packages written specifically for java clients who want to access toolbox functionality such as QuickTime for Java or MRJToolkit.
  • MRJ 2.1 contains a feature called JDirect which allows Java code to easily call into Mac OS shared libraries and the MRJ 2.1 SDK contains java bindings generated by the Interfacer tool. The combination allows developers to call any Mac OS API directly from Java. But, the developer still has to write Java code to handle things like Pascal strings, memory allocation and deallocation, etc.

As time goes on, Apple and third parties will continue to write more Java packages which make it easier to use Mac OS specific functionality from Java. It is an open question whether anyone will write a Mac OS only framework in Java (a la MacApp).

Dave: In a similar vein, what changes do you see for C++ and Pascal programmers?

Nick: The Mac OS toolbox has standardized on procedural ABIs (application binary interfaces). This has enabled applications to be written in most any language. It is unlikely that any non-procedural features (e.g. C++ objects) will be added to the Mac OS APIs. These sorts of things should be layered onto the Universal Interfaces as is done with PowerPlant.

There are a few C++ things which do make sense in the Universal Interfaces such as inlined functions instead of parameterized macros and the use of name spaces. These are both on my to-do list.

Pascal Interfaces will continue to be generated from MasterInterfaces. But, because Pascal has not been standardized the way C has, developers using different Pascal compilers have needed to modify Apple's Universal Interfaces for Pascal to work with their compiler. Since Pascal does not have a preprocessor, there really is no way to make truly universal interfaces.

I think the long term solution for Pascal and other language support (e.g. Lisp, Fortran, Basic, etc.) is to open up the Interfacer tool. A current project of mine is researching how to deliver a "Universal Interfaces Kit" which contains the data and a framework for developers to generate their own interfaces.

 
AAPL
$98.15
Apple Inc.
-0.23
MSFT
$43.58
Microsoft Corpora
-0.31
GOOG
$587.42
Google Inc.
+1.81

MacTech Search:
Community Search:

Software Updates via MacUpdate

Knock 1.1.7 - Unlock your Mac by knockin...
Knock is a faster, safer way to sign in. You keep your iPhone with you all the time. Now you can use it as a password. You never have to open the app -- just knock on your phone twice, even when it's... Read more
Mellel 3.3.6 - Powerful word processor w...
Mellel is the leading word processor for OS X and has been widely considered the industry standard since its inception. Mellel focuses on writers and scholars for technical writing and multilingual... Read more
LibreOffice 4.3.0.4 - Free Open Source o...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
Freeway Pro 7.0 - Drag-and-drop Web desi...
Freeway Pro lets you build websites with speed and precision... without writing a line of code! With it's user-oriented drag-and-drop interface, Freeway Pro helps you piece together the website of... Read more
Drive Genius 3.2.4 - Powerful system uti...
Drive Genius is an OS X utility designed to provide unsurpassed storage management. Featuring an easy-to-use interface, Drive Genius is packed with powerful tools such as a drive optimizer, a... Read more
Vitamin-R 2.15 - Personal productivity t...
Vitamin-R creates the optimal conditions for your brain to work at its best by structuring your work into short bursts of distraction-free, highly focused activity alternating with opportunities for... Read more
Toast Titanium 12.0 - The ultimate media...
Toast Titanium goes way beyond the very basic burning in the Mac OS and iLife software, and sets the standard for burning CDs, DVDs, and now Blu-ray discs on the Mac. Create superior sounding audio... Read more
OS X Yosemite Wallpaper 1.0 - Desktop im...
OS X Yosemite Wallpaper is the gorgeous new background image for Apple's upcoming OS X 10.10 Yosemite. This wallpaper is available for all screen resolutions with a source file that measures 5,418... Read more
Acorn 4.4 - Bitmap image editor. (Demo)
Acorn is a new image editor built with one goal in mind - simplicity. Fast, easy, and fluid, Acorn provides the options you'll need without any overhead. Acorn feels right, and won't drain your bank... Read more
Bartender 1.2.20 - Organize your menu ba...
Bartender lets you organize your menu bar apps. Features: Lets you tidy your menu bar apps how you want. See your menu bar apps when you want. Hide the apps you need to run, but do not need to... Read more

Latest Forum Discussions

See All

Empire Manager (Games)
Empire Manager 1.0 Device: iOS iPhone Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: Become ruler of an empire. Manage your economy, develop technology, hire an army and conquer the world in this addictive turn-... | Read more »
Empire Manager HD (Games)
Empire Manager HD 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: Become ruler of an empire. Manage your economy, develop technology, hire an army and conquer the world in this addictive... | Read more »
Star Admiral Review
Star Admiral Review By Rob Thomas on July 30th, 2014 Our Rating: :: ADMIRABLE ADMIRALSUniversal App - Designed for iPhone and iPad While this new digital CCG may feel a bit familiar, Star Admiral offers a sci-fi twist and galaxy’s... | Read more »
Zap! Pow! Become a Badass Wizard in Phan...
Zap! Pow! | Read more »
Urban Trial Freestyle Review
Urban Trial Freestyle Review By Blake Grundman on July 30th, 2014 Our Rating: :: RIDIN' DIRTYUniversal App - Designed for iPhone and iPad A rough ride that has trouble keeping its wheels on the track.   | Read more »
Take Note! Noteshelf Has Recieved a Big...
Take Note! Noteshelf Has Recieved a Big Update. Posted by Jessica Fisher on July 30th, 2014 [ permalink ] iPad Only App - Designed for the iPad | Read more »
Cubama Review
Cubama Review By Nadia Oxford on July 30th, 2014 Our Rating: :: TETRIIIIIS IIIIIN SPAAAAACE!Universal App - Designed for iPhone and iPad With its addictive challenge and interesting premise, Cubama is frantic screen-tapping fun.   | Read more »
Become a Guardians of Galactic Peace Wit...
Become a Guardians of Galactic Peace With the New Spacefaring Sim, Kairobotica. Posted by Jessica Fisher on July 30th, 2014 [ permalink ] | Read more »
Soul Guardians: Age of Midgard Review
Soul Guardians: Age of Midgard Review By George Fagundes on July 30th, 2014 Our Rating: :: SO MUCH GRIND IT CRUNCHESUniversal App - Designed for iPhone and iPad Swords and trading cards are fun, right? So is Soul Guardians: Age of... | Read more »
NFL Fantasy Football App Redesigned Ahea...
NFL Fantasy Football App Redesigned Ahead of Upcoming 2014 Season Posted by Ellis Spice on July 30th, 2014 [ permalink ] | Read more »

Price Scanner via MacPrices.net

More iPad Upgrade Musings – The ‘Book Mystiqu...
Much discussed recently, what with Apple reporting iPad sales shrinkage over two consecutive quarters, is that it had apparently been widely assumed that tablet users would follow a two-year hardware... Read more
13-inch 2.5GHz MacBook Pro on sale for $999,...
Best Buy has the 13″ 2.5GHz MacBook Pro available for $999.99 on their online store. Choose free shipping or free instant local store pickup (if available). Their price is $100 off MSRP. Price is... Read more
Save up to $300 on an iMac with Apple refurbi...
The Apple Store has Apple Certified Refurbished iMacs available for up to $300 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. These are the best prices on... Read more
WaterField Unveils 15″ Outback Solo & 13″...
Hard on the heels of Apple’s refreshed MacBook Pro Retina laptops announcement, WaterField Designs has unveiled a 15-inch version of the waxed-canvas and leather Outback Solo and a 13-inch version of... Read more
New Roxio Toast 12 Delivers Digital Media Pow...
Roxio Toast 12 is a hub for sharing digital media to virtually any platform or device. has introduced two new additions to its Roxio Toast product family – Roxio Toast 12 Titanium and Roxio Toast 12... Read more
The lowest prices on leftover Retina MacBook...
Best Buy has dropped prices on leftover 13″ and 15″ Retina MacBook Pros by up to $300 off original MSRP on their online store for a limited time. Choose free local store pickup (if available) or free... Read more
Apple Updates MacBook Pro with Retina Display...
Apple today updated its MacBook Pro with Retina display with faster processors and double the amount of memory in both entry-level configurations. MacBook Pro with Retina display features a Retina... Read more
Up to $250 price drop on leftover 15-inch Mac...
B&H Photo has dropped prices on 2013 15″ Retina MacBook Pros by as much as $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.3GHz Retina MacBook Pro: $2349... Read more
Updated MacBook Pro Price Trackers
We’ve updated our MacBook Pro Price Trackers with the latest information on prices, bundles, and availability on the new 2014 models from Apple’s authorized internet/catalog resellers as well as... Read more
Apple updates MacBook Pros with slightly fast...
Apple updated 13″ and 15″ Retina MacBook Pros today with slightly faster Haswell processors. 13″ models now ship with 8GB of RAM standard, while 15″ MacBook Pros ship with 16GB across the board. Most... Read more

Jobs Board

Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Sr. Product Leader, *Apple* Store Apps - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.