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";







  
 
AAPL
$101.66
Apple Inc.
+0.23
MSFT
$46.70
Microsoft Corpora
-0.31
GOOG
$575.62
Google Inc.
-5.73

MacTech Search:
Community Search:

Software Updates via MacUpdate

Screenshot Path 1.2.1 - Change the defau...
Screenshot Path lets you change the folder where OS X saves screenshots. Screenshots are saved by default to the user’s desktop. This is handy for the occasional screenshot but those looking to take... Read more
Fantastical 1.3.16 - Create calendar eve...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event details... Read more
GIMP 2.8.14 - Powerful, free image editi...
GIMP is a multi-platform photo manipulation tool. GIMP is an acronym for GNU Image Manipulation Program. The GIMP is suitable for a variety of image manipulation tasks, including photo retouching,... Read more
HoudahSpot 3.9.3 - Advanced front-end fo...
HoudahSpot is an advanced file search tool built upon MacOS X Spotlight. Spotlight unleashed Create detailed queries to locate the exact file you need Narrow down searches. Zero in on files Save... Read more
djay 4.2.3 - Transform your Mac into a f...
djay transforms your Mac into a full-fledged DJ system, allowing you to mix your iTunes music library on a hyper-realistic turntable interface. Perform live, record mixes on-the-go, or enable... Read more
iDefrag 2.2.8 - Disk defragmentation and...
iDefrag helps defragment and optimize your disk for improved performance. Features include: Supports HFS and HFS+ (Mac OS Extended). Supports case sensitive and journaled filesystems. Supports... Read more
Bookends 12.2.3 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Copy 1.47.0410 - Cloud storage and file...
Note: You must first sign up to use Copy (get a 5GB sign-up bonus through our 'Download' link above). Copy lets you sync, protect, and share. Everywhere. Want to bring some files home? No problem!... Read more
Stacks 2.6.3 - New way to create pages i...
Stacks is a new way to create pages in RapidWeaver: A plugin designed to combine drag-and-drop simplicity with the power of fluid layout. Features: Fluid Layout: Stacks lets you build pages that... Read more
RestoreMeNot 2.0 - Disable window restor...
RestoreMeNot provides a simple way to disable the window restoration for individual applications so that you can fine-tune this behavior to suit your needs. Please note that RestoreMeNot is designed... Read more

Latest Forum Discussions

See All

This Week at 148Apps: September 8-12, 20...
Expert App Reviewers   So little time and so very many apps. What’s a poor iOS devotee to do? Fortunately, 148Apps is here to give you the rundown on the latest and greatest releases. And we even have a tremendous back catalog of reviews; just check... | Read more »
Rejoice, Kittens! Kitty Powers’ Matchmak...
Rejoice, Kittens! | Read more »
Upcoming Digital Board Game SettleForge...
Upcoming Digital Board Game SettleForge is Headed to iOS Posted by Jessica Fisher on September 12th, 2014 [ permalink ] SettleForge is a single-player board game where players take on the role of the king as they try to | Read more »
Air Supply SOS Set to Bring Retro Sheep...
Air Supply SOS Set to Bring Retro Sheep Rescuing to iOS Soon Posted by Ellis Spice on September 12th, 2014 [ permalink ] Quantum Sheep has announced that the latest entry in the | Read more »
Star Wars: Commander Reveals Who is Winn...
Star Wars: Commander Reveals Who is Winning the Galactic Civil War Posted by Jessica Fisher on September 12th, 2014 [ permalink ] Disney Interactive has released a new infographic detailing the stat | Read more »
The New MOGA REBEL iOS Controller is Set...
The New MOGA REBEL iOS Controller is Set to Be Released on September 17 Posted by Jessica Fisher on September 12th, 2014 [ permalink ] MO | Read more »
Scuba Dupa Review
Scuba Dupa Review By Rob Thomas on September 12th, 2014 Our Rating: :: BUBBLE TROUBLEUniversal App - Designed for iPhone and iPad Scuba Dupa is cute and simple fun, but you’re going to have to part with a bit too much sunken... | Read more »
Get Ready for the iPhone 6 – Amazon Trad...
Get Ready for the iPhone 6 – Amazon Trade-in Program Locks in Used Gadget Prices Until October 10 Posted by Ellis Spice on September 12th, 2014 [ permalink ] | Read more »
Kings of the Realm Review
Kings of the Realm Review By Jennifer Allen on September 12th, 2014 Our Rating: :: STANDARD BASE BUILDINGUniversal App - Designed for iPhone and iPad Kings of the Realm offers some handy tweaks, but it’s still the familiar format... | Read more »
Five Nights at Freddy's (Games)
Five Nights at Freddy's 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: | Read more »

Price Scanner via MacPrices.net

Save $75 on the 16GB iPad mini with Retina Di...
Best Buy has the 16GB iPad mini with Retina Display on sale for $324.99 on their online store for a limited time. Their price is $75 off MSRP, and it’s the lowest price available for this mini.... Read more
21-inch 1.4GHz iMac on sale for $979, $120 of...
B&H Photo has the new 21″ 1.4GHz iMac on sale for $979.99 including free shipping plus NY sales tax only. Their price is $120 off MSRP. B&H will also include free copies of Parallels Desktop... Read more
Apple restocks refurbished 21-inch 1.4GHz iMa...
The Apple Store has restocked Apple Certified Refurbished 21″ 1.4GHz iMacs for $929 including free shipping plus Apple’s standard one-year warranty. Their price is $170 off the cost of new models,... Read more
13-inch 2.6GHz/256GB Retina MacBook Pro on sa...
Adorama has the 13″ 2.6GHz/256GB Retina MacBook Pro on sale for $1379 including free shipping plus NY & NJ sales tax only. Their price is $120 off MSRP, and it’s the lowest price available for... Read more
Macally iPhone 6 Cases
Macally has introduced a Line of Snap-On Shell Cases, Frame Bumper Cases and a Rugged Protective Case for iPhone 6 with 4.7inch Screen, such as the SNAP case in a variety of brilliant metallic... Read more
Belkin Launches New Accessories iPhone 6 and...
Belkin has unveiled a new collection of products for iPhone 6 and iPhone Plus. Belkin’s new iPhone 6 and iPhone 6 Plus accessories include athletic-inspired armbands, classic phone cases and advanced... Read more
Skinit Debuts Customizable Apple iPhone 6 Cas...
Skinit, pioneer creators of protective personalized solutions for consumer electronic devices, has introduced its new collection of customizable Skinit cases and skins for the new Apple iPhone 6.... Read more
Apple refurbished MacBook Pros available for...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available starting at $929. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros (4GB RAM/... Read more
Save $200 with Apple refurbished 27-inch Thun...
The Apple Store has Apple Certified Refurbished 27″ Thunderbolt Displays available for $799 including free shipping. That’s $200 off the cost of new models. Read more
Free $25 iTunes gift card with purchase of Ap...
The Apple Store is offering a free $25 iTunes Gift Card with the purchase of a $99 Apple TV for a limited time. Shipping is free. 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
*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
*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
*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
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.