TweetFollow Us on Twitter

SimpleAPP
Volume Number:10
Issue Number:4
Column Tag:Demonstration

Building The SimpleAPP Demonstration Application

By Richard Clark

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Even though a program written for a Power Macintosh can use the same source code as a 68K Macintosh, the build process is different. Power Macintosh development uses a new set of compilers and linkers, and introduces the first fundamentally new Macintosh development system in several years - Metrowerks’ “Code Warrior.”

Not only are the tools different, but “native” Power Macintosh executables use a different format than 68K executables. “Native” application code is stored in the data fork of a file, and requires a ‘cfrg’ resource to notify the system that PowerPC code is present. The ‘cfrg’ resource describes several major things about the fragment or fragments in the current file:

• Code type (only PowerPC is supported at present)

• Whether this is a stand-alone fragment, or an overpatch to another fragment

• Version information for this fragment

• Is this a library or an application? (There’s also a value for “is a drop-in”, but the system only looks for ‘cfrg’ resources in applications and shared libraries. The third value is supplied for applications which include cfrg resources in their extensions and parse these resources directly. The “ModApp” sample included with both the MetroWerks and Apple development environments includes a cfrg parser.)

• Is this on disk, or in memory? (An additional value, “on disk segmented” is reserved for future use.)

• If this is on disk, what is the offset to the start of the container? This allows applications to reserve the first part of the data fork for application-specific information (though Apple is discouraging developers from writing to the data fork of a running application.) Also, what is the length of the container.

These two fields serve another purpose besides allowing an application to store information in the data fork - the data fork may contain multiple containers, and the associated ‘cfrg’ resource may have an entry for each container.

• The name of this fragment. This is especially important for shared libraries as it allows the name of a shared library to be independent from the name of its file. If the user renames a shared library, nothing will break. This also supports packing multiple fragments into the same file as described above.

• If this is an application, the stack size (or 0 for the default.) Also, the “appSubFolderID” field can be used if an application maintains a folder full of shared libraries. The application can include an ‘alis’ folder alias resource in its resource fork, and place the ID number of that resource into the cfrg.

This resource has to be added as part of the build process.

Building with Code Warrior

SimpleApp is easy to build with code warrior, though you have to set the appropriate ‘cfrg’ and ‘SIZE’ resource values in the Preferences Dialog. Code Warrior accepts only a subset of the ‘cfrg’ information at present (whether this is an application or a Shared Library, the fragment’s name, and the default stack size), but these are adequate for our purposes.

Building the SimpleApp code resources is a bit more interesting. You have to specify that you are building a stand-alone module and set the file’s type and creator. (This type and creator indicates to SimpleApp that this is disk-based code.)

The other important setting specifies the code’s main entry point, initialization, and termination routines. In an application, these routines (typically called __start, __initialize, and __terminate) are supplied by the runtime library. Since our code resource has its own special routines, those names must be supplied to the “Linker” part of the Preferences Dialog.

If you’re building disk-based code, that’s all you have to do. If you want to create resource-based code, SimpleApp comes with an auxiliary application (DataToRes) which will take a SimpleApp ‘DPEF’ file (with code in the data fork) and turn it into a ‘RPEF’ file with code in a ‘RPEF’ resource.

Building with MPW

SimpleApp also comes with a MPW makefile. Building the application and the external code is a simple matter of compiling and linking, with one complication. The compiler and linker emit code in the XCOFF (Extended Common Object File Format) used by IBM, but the Power Macintosh prefers PEF. The Macintosh on RISC SDK supplies a “MakePEF” tool to convert XCOFF to PEF. When you run this tool, you must supply not only the file to be converted, but also a set of “library name mapping” rules that remove the “.xcoff” extension from the shared library names:


/* 1 */
SimpleApp ƒƒ SimpleApp.xcoff
 MakePEF SimpleApp.xcoff -o {targ} 
 -l InterfaceLib.xcoff=InterfaceLib

Another option to MakePEF lists the Main, Initialization, and Termination routines. (If the “main” routine was specified to the linker, it doesn’t have to be supplied to MakePEF.)


/* 2 */
'PICT Viewer' ƒƒ PICTViewer.xcoff
 MakePEF {deps} -o {targ} 
 -i OurInitRoutine -t OurTerminationRoutine 
 -l InterfaceLib.xcoff=InterfaceLib

The PowerPC linker performs dead code stripping, so you have to tell the linker to retain the Initialization and Termination routines. You can do this with the “-dead off” option, or by exporting the Initialization and Termination routines:


/* 3 */
PICTViewer.xcoff ƒ PICTViewer.c.o {XCOFFLibs}
 PPCLink {deps} -o {targ} -main OurMainRoutine -sym {SYM} 
 -export OurInitRoutine,OurTerminationRoutine

Finally, just as Code Warrior creates code in the data fork, so does MakePEF. This could create a problem if you wanted to create resource-based code, but MPW users can use a “Rez” script to read a PEF file into a resource:


/* 4 */
// File: Chaos.r
//
// This file includes the resources from a resource file
// (Unlike SimpleApp, an external don't need a 'cfrg' or
// 'SIZE' resource)

read 'RPEF' (128) "Chaos.PEF";







  
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

FoldersSynchronizer 4.2.1 - Synchronize...
FoldersSynchronizer is a popular and useful utility that synchronizes and backs-up files, folders, disks and boot disks. On each session you can apply special options like Timers, Multiple Folders,... Read more
Simon 4.0.2 - Monitor changes and crashe...
Simon monitors websites and alerts you of crashes and changes. Select pages to monitor, choose your alert options, and customize your settings. Simon does the rest. Keep a watchful eye on your... Read more
Cocktail 8.1.2 - General maintenance and...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Cyberduck 4.6.4 - FTP and SFTP browser....
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Herald 5.0.2 - Notification plugin for M...
Note: Versions 2.1.3 (for OS X 10.7), 3.0.6 (for OS X 10.8), and 4.0.8 (for OS X 10.9) are no longer supported by the developer. Herald is a notification plugin for Mail.app, Apple's Mac OS X email... Read more
DEVONthink Pro 2.8.3 - Knowledge base, i...
Save 10% with our exclusive coupon code: MACUPDATE10 DEVONthink Pro is your essential assistant for today's world, where almost everything is digital. From shopping receipts to important research... Read more
Boom 2 1.0.1 - System-wide pro audio app...
Boom 2 is a system-wide volume booster and equalizer app that is designed especially for OS X 10.10 Yosemite. It comes with a smart interface, self-calibrates itself according to your Mac, offers... Read more
Apple Security Update 2015-001 - For OS...
Apple Security Update 2015-001 is recommended for all users and improves the security of OS X. For detailed information about the security content of this update, please visit: http://support.apple.... Read more
Drive Genius 4.0.1 - Powerful system uti...
Drive Genius 4 gives you faster performance from your Mac while also protecting it. The award-winning and improved DrivePulse feature alerts you to hard drive issues before they become major problems... Read more
Yosemite Cache Cleaner 9.0.3 - Clear cac...
Yosemite Cache Cleaner is an award-winning general purpose tool for OS X. YCC makes system maintenance simple with an easy point-and-click interface to many OS X functions. Novice and expert users... Read more

Unlock Sunshine Girl in Ironkill with th...
Unlock Sunshine Girl in Ironkill with this special 148Apps code Posted by Rob Rich on January 29th, 2015 [ permalink ] Robo-fighter Ironkill has been out on iOS a | Read more »
Crossroad Zombies Review
Crossroad Zombies Review By Jordan Minor on January 29th, 2015 Our Rating: :: CROSSWALKING DEADiPad Only App - Designed for the iPad Crossroad Zombies is a rough draft of a cool genre mash-up.   | Read more »
Blood Brothers 2 – Tips, Cheats, and Str...
War is hell: Is it the kind of hell you want to check out? Read our Blood Brothers 2 review to find out! Blood Brothers 2, DeNA’s follow-up to the original Blood Brothers, is an intriguing card collecting / role-playing / strategy hybrid. There’s... | Read more »
Blood Brothers 2 Review
Blood Brothers 2 Review By Nadia Oxford on January 29th, 2015 Our Rating: :: AN AGGRAVATING RELATIVEUniversal App - Designed for iPhone and iPad Blood Brothers 2 is built on a simple, solid foundation, but its free-to-play system... | Read more »
I AM BREAD, the Toast of the Town, is Ro...
Have you ever dreamt of being deliciously gluten-y? Do you feel passionate about Rye and Wheat? The guys at Bossa Studios do and that is why they are bringing I AM BREAD to iOS soon. The loafy app will feature all the new content that is being... | Read more »
Fahrenheit: Indigo Prophecy Remastered R...
Fahrenheit: Indigo Prophecy Remastered Review By Jennifer Allen on January 29th, 2015 Our Rating: Universal App - Designed for iPhone and iPad 10 years after its initial release and Fahrenheit: Indigo Prophecy still feels like a... | Read more »
Evolve: Hunters Quest is a Match-3 That...
Evolve: Hunters Quest is a Match-3 That Has You Hunting Up Some Big Game. Posted by Jessica Fisher on January 29th, 2015 [ permalink ] | Read more »
Destructamundo Review
Destructamundo Review By Jordan Minor on January 29th, 2015 Our Rating: :: WRECKING CREWUniversal App - Designed for iPhone and iPad Destructamundo blows up real good.   | Read more »
The Sandbox Gets Exclusive Update, Adds...
The Sandbox Gets Exclusive Update, Adds Invincible Characters Campagin Posted by Tre Lawrence on January 29th, 2015 [ permalink ] | Read more »
Mean Girls: The Game Review
Mean Girls: The Game Review By Jordan Minor on January 29th, 2015 Our Rating: :: FETCHUniversal App - Designed for iPhone and iPad A Mean Girls tower defense game makes way more sense than you’d think.   | Read more »

Price Scanner via MacPrices.net

Back in stock: Refurbished iPod nanos for $99...
The Apple Store has Apple Certified Refurbished 16GB iPod nanos available for $99 including free shipping and Apple’s standard one-year warranty. That’s $50 off the cost of new nanos. Most colors are... Read more
New Good Management Suite Simplifies Enterpri...
Good Technology has announced the availability of the Good Management Suite, a comprehensive cross-platform solution for organizations getting started with mobile business initiatives. Built on the... Read more
15-inch 2.0GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished previous-generation 15″ 2.0GHz Retina MacBook Pros available for $1489 including free shipping plus Apple’s standard one-year warranty. Their price is... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
Amazon has the 15″ 2.5GHz Retina MacBook Pro on sale for $2319.99 including free shipping. Their price is $180 off MSRP, and it’s the lowest price available for this model from any reseller. Read more
iPad Turns Five – The ”Book Mystique
Five years ago this week, the late Steve Jobs took the stage at an Apple special press event to unveil the first Apple iPad — a slab-shaped, hand-holdable device that was to shake the personal... Read more
Sale! 15-inch Retina MacBook Pros for up to $...
B&H Photo has the new 2014 15″ Retina MacBook Pros on sale for $150 off MSRP for a limited time. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1889.99... Read more
Apple refurbished Mac minis for up to $150 of...
The Apple Store has restocked Apple Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz... Read more
Apple Releases New Tranche Of OS Updates For...
Apple has released incremental bugfix and security updates for its most recent Mac and iOS versions. OS X Yosemite 10.10.2 Update Apple says this update includes the following improvements: Resolves... Read more
Samsung To Be Main Supplier Of A9 Chips For i...
Korea’s Maeil Business Newspaper reports that Samsung has beat out its chipmaking rivals, Taiwan’s Qualcomm and TSMC, as supplier of chipsets for the next generations of both its own Galaxy S6 and... Read more
Save up to $340 on iMacs with Apple Certified...
The Apple Store has Apple Certified Refurbished iMacs available for up to $340 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

Jobs Board

*Apple* Retail - Multiple Positions(US) - Ap...
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
*Apple* Systems Engineer - Pre Sales, Educat...
…is responsible for proactively providing technical expertise to drive sales of Apple solutions into assigned accounts. The SE architects, validates, and assists in Read more
*Apple* Solutions Consultant - Retail Sales...
As an ambassador of the Apple brand, the ASC is accountable for driving sales performance by: Connecting with customers. Discovering customers' needs and values. Showing Read more
*Apple* Solutions Consultant - Retail Sales...
As an ambassador of the Apple brand, the ASC is accountable for driving sales performance by: Connecting with customers. Discovering customers' needs and values. Showing Read more
*Apple* Tree Children's Center is hirin...
Apple Tree Learning Center is Hiring Preschool Teachers! Phoenix Childrens Academy is a national leader in the early childhood education industry and we are currently Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.