TweetFollow Us on Twitter

January 93 - Jasik's Incremental Build System and ObjectMaster

Jasik's Incremental Build System and ObjectMaster

Vinko Tsui

Why Incremental build? The first and foremost reason is to save time. Incremental build systems provide you with the ability to avoid recompiling the entire source file and link all object codes each time a procedure changes. It allows you, the programmer, to compile and link in just the procedure containing the change, hence the name "Incremental Build". The Incremental Build System (IBS) discussed in this article comes as an integrated feature of Jasik Design's The Debugger (TD), and the version I'm using is Universal version 2.5.4 (11/18/92). The compiler discussed is the Apple's Macintosh Programmers Workshop (MPW), and the version I'm using is 3.3a14. Unfortunately, MPW's compiler does not support partial compilations, so the only time saver is the linking of your application.

Using IBS

The most common environment for Jasik's Incremental Build System (IBS) is MPW. The main reason for MPW's popularity is that nothing else supported Jasik's IBS, at least not until the appearance of ObjectMaster. Using IBS with MPW requires learning some new habits while editing your source; otherwise, more time may be wasted than gained. I will explain in greater detail later.

Before I go into depth about how to use these two tools together, the reader should understand how to set up an IBS project in the MPW environment. Setting up an IBS project is required whether you're using IBS in the MPW or the OM environment. Since OM is primarily an object-oriented environment and FrameWorks is an object-oriented development publication, I will narrow my discussion to MacApp applications. For MacApp applications to take advantage of the IBS feature, MABuild must create .map and .sym files. This can be done by adding the -Sym and -LinkMap options to your MABuildDefaults symbol.

Creating IBS Projects

In MPW the features of IBS are available through an additional menu in the Menu Bar. This menu is appended to the Menu Bar by the UserStarpup•IBS supplied by Jasik Designs as part of the TD package.

Before editing anything in the source, the programmer will have to create an IBS project. This can be accomplished by selecting the "Create Project…" menu item in the IBS menu. When this menu item is chosen, a dialog will appear explaining that an IBS project is defined by an application or tool you are concerned with, and that the .map and .sym files must also reside in the same folder. Click on the "OK" button to acknowledge this dialog, then a Standard GetFile dialog is displayed for you to locate the application. Now navigate to one of the "." folders (ie. .Debug Sym) which contains the application and then click on the "Create" button to select it. IBS will then respond with another information dialog indicating that a "ProjInfo" folder will be created within your "." folder to hold miscellaneous IBS project files. When you acknowledge this, an other dialog comes up asking you to choose the FIRST option that applies to the IBS project that you're creating. In our case it will always be option #1 that reads "is a MacApp based". Select option #1 and then click the "OK" button. At this point a new xxx_IBS.proj file is created in the "." folder where xxx is the name of your application. There you have it. You have created an IBS project for your MacApp application and are now ready to use IBS with your incremental changes.

To verify that you have done it right, select the IBS menu, and you should see your application with the appropriate path listed as one of the menu items at the bottom of the menu. Each time you create a new IBS project, the new project and its path will be appended to the bottom of the IBS menu. The current active IBS project will have a bullet (•) on the left side of its name. Having the correct IBS project active is very important, because if you have the wrong application active, you will not be able to jump to the shell from within TD while you're debugging you rapplication.

IBS & MPW

This is the environment that Jasik's IBS was initially intended for. To begin using IBS you must be already running the application. After you have started your application, break into TD at a GetNextEvent (idle) stage of your application. While in TD select the "Side Door to Shell" menu item from the leftmost menu where TD shows the available memory. This will bring you back into the MPW shell with the application still running, but you will not be able to select it or any other applications with Finder. Choose a procedure that you would like to edit, and open the file that contains it.

Now comes the point I mentioned at the beginning of the article, about having to learn new habits in editing your source. My normal habit when I'm editing my source is to make some small change and than hit Command-S to save my changes; this will be disastrous when using IBS if you have not done an "Add Hint". Before you save any part of your code, highlight the name of the procedure or procedures (including the class name ie. TMyClass::MyProcedure). Wth the name selected go to the IBS menu and select the "Add Hint" menu item. When you select the "Add Hint" menu item, it tells IBS that the procedure highlighted is the one to be edited. It will make a copy of your source file containing the procedure and name it "xxx.cp_old" where xxx is the name of your source file. Now you can perform the change you wanted.

If you forgot to do the "Add Hint" step and if your editing habits are similar to mine, you will have to do a regular MABuild, by going back to TD, killing the application and then doing an MABuild from MPW. This is why I say that your normal routine will have to change, unless your normal routine does not include saving your work every now and then. With unexpected crashes hovering around corners, especially in a development environment, I don't even notice hitting the Command-S combination anymore.

After you are satisfied that all required changes are done, go to the IBS menu and select the "PatchBuild" menu item. This will tell IBS to go ahead and recompile your changes, and then apply the appropriate patches to your object code and send you right back to TD. In TD's "Notes" window you will see a line with your application name and the statement "PLI sym patches installed". This statement indicates that all your changes are in effect and you can continue your debugging.

You may find this all too cumbersome to be useful, but think about the 5 to 10 minutes that a large MacApp application takes to Link. All this time spent just to correct a simple spelling mistake in a variable name. Fortunately, this cumbersome procedure does not have to be endured, because ACI came to our assistance with the creation of ObjectMaster.

IBS & ObjectMaster

The version of ObjectMaster described here is version 1.0.2. Life is much simpler using IBS under the OM environment. You still have to create the IBS project from within MPW (by the way the MPW shell must be version 3.3 or greater for it to work with OM; otherwise, you must use ToolServer. This is because version 3.3x of MPW is AppleEvent aware.) as described above. If you're using the ToolServer rather than MPW, then you will have to execute the same script as the IBS menu "Create Project" menu item does. Either from ToolServer's Execute Script facility execute the IBS_Create_Proj script, or from OM's Worksheet execute the OMIBS_CreateProject script. After the IBS project is created, you will have to let OM know about it. From the Build menu in OM find the "Incr. Build Sys." sub menu and select the "Set Project…" menu item. This will bring up a Standard GetFile dialog for you to locate the IBS Project that was created. Navigate to the "." folder that you have specified in MPW and choose the newly created xxx_IBS.proj file.

To activate the IBS feature, all you have to do is to select the "Incremental Build" menu item from the IBS sub menu in OM. After you "Exited" TD using the "Side Door to Shell", each time a procedure is changed from the Browser window the appropriate IBS "Add Hint" command will be done automatically. Note that only changes from within the Browser window will be tracked automatically by OM for IBS, any changes from within the File window will have no similar effect.

When you're ready to implement your changes, all you have to do is to select the "Patch Build" menu item from the IBS sub menu in OM. Unfortunately, there are no indications within OM that a Patch Build is in progress, so you will not know that something is happening. You will have to either keep the MPW Worksheet visible or switch to MPW to monitor the Patch Build process. As in the MPW environment, when the Patch Build process is completed it will bring you back to TD for debugging. One more additional time saver as compared to MPW is that you can "Kill" your executed application from OM rather than jumping back to TD and terminating the application. This is done by the appropriately called menu item "Kill Problem Program" in the IBS sub menu.

Last Words

To say the least I am for the use of IBS with ObjectMaster. This is not to say that IBS is not usable in the MPW environment, just that OM makes it much easier. To find out more about The Debugger you can contact Jasik Design at (415) 322-1386 or ALink: D1037. For ObjectMaster you can contact ACIUS in North America at (408) 252-4444 ALink: D4444, in France try ACI at 33-1-42.27.38.54.
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Adobe Pepper Flash Player 32.0.0.142 - P...
Adobe Pepper Flash Player is a cross-platform, browser-based application runtime that provides uncompromised viewing of expressive applications, content, and videos across browsers and operating... Read more
Duet 2.0.5.0 - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a $9.99 iOS companion app. Version 2.0.5.0:... Read more
Thunderbird 60.5.1 - Email client from M...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more
OnyX 3.5.7 - Maintenance and optimizatio...
OnyX is a multifunction utility that you can use to verify the startup disk and the structure of its system files, to run miscellaneous maintenance and cleaning tasks, to configure parameters in the... Read more
Sketch 53.1 - Design app for UX/UI for i...
Sketch is an innovative and fresh look at vector drawing. Its intentionally minimalist design is based upon a drawing space of unlimited size and layers, free of palettes, panels, menus, windows, and... Read more
Vivaldi 2.3.1440.48 - An advanced browse...
Vivaldi is a browser for our friends. We live in our browsers. Choose one that has the features you need, a style that fits and values you can stand by. From the look and feel, to how you interact... Read more
Hopper Disassembler 4.5.6- - Binary disa...
Hopper Disassembler is a binary disassembler, decompiler, and debugger for 32- and 64-bit executables. It will let you disassemble any binary you want, and provide you all the information about its... Read more
Civilization VI 1.2.0 - Next iteration o...
Sid Meier’s Civilization VI is the next entry in the popular Civilization franchise. Originally created by legendary game designer Sid Meier, Civilization is a strategy game in which you attempt to... Read more
Parallels Desktop 14.1.2 - Run Windows a...
Parallels allows you to run Windows and Mac applications side by side. Choose your view to make Windows invisible while still using its applications, or keep the familiar Windows background and... Read more
Chromium 72.0.3626.109 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 72.0.3626.109: A list of changes is... Read more

Latest Forum Discussions

See All

Everything you need to know to win in Kn...
Knights of the Card Table is a really clever, solitaire dungeon crawler that's not just crammed to the gills with monsters to fight and loot to find, it's also got one of the biggest hearts of any game we've seen on the App Store. We definitely... | Read more »
A quick beginner’s guide to Final Blade
Final Blade was developed by newcomer SkyPeople studio, with help from localisation guru Glohow. After two years exclusively in the hands of South Korean and Chinese players, the game is now celebrating its global launch. Hurrah! But if you’re a... | Read more »
The best games for iPhone and iPad that...
How is it already Thursday again? My oh my, doesn't time fly when you're playing the very best mobile games out there? We certainly hope it does, because we've gone ahead and written a list of what we think are the top 5 best games for iPhone and... | Read more »
Three games for iPad and iPhone to keep...
On Monday we told you that Apex Legends is, all being well, eventually going to end up on the App Store. That means you'll be able to play one of the best new battle royale shooters in months in the palm of your hand. However, it hasn't happened... | Read more »
Why you should be excited about Apex Leg...
You've no doubt heard of Apex Legends by now. It's a new take on the battle royale genre developed by Respawn, and published by EA. It went live on EA Origin, PS4, and Xbox One last week, and it's already been generating a lot of buzz around the... | Read more »
Epic fantasy RPG Final Blade celebrates...
Now is a great time for RPG fans the world over as Final Blade has, well, finally got its global release for iOS and Android. The grand-scale RPG developed by Skypeople Inc in association with Glowhow, the has been quite the hit over in Taiwan and... | Read more »
Airheart launches on Nintendo Switch, de...
You’d be forgiven for thinking a game about harpooning fish and fighting pirates would be set on the high seas. But the action in Airheart is entirely airborne. Following up on its PC and Playstation release last year, this award-winning game has... | Read more »
Innovative match-3 puzzler Ingot Rush ha...
Match-3 games are pretty darn popular on mobile, and with so many innovative takes on the core concept, it’s easy to see why. Today we present you Ingot Rush for iOS, a colourful, globetrotting adventure that brings plenty of its own fresh ideas to... | Read more »
The top 5 best games for iPhone and iPad...
It's that time again - Thursday has rolled around which means the latest batch of new mobile games has landed on the App Store. There's loads of them, like there always is, so we've taken steps to make sure you know which are the best games that... | Read more »
The top 5 best word games for iPhone and...
Word games can be a tricky genre to pin down. There are so many variations out there that sometimes it's hard to decide whether or not a game fits into the little pocket you're trying to push it into. That doesn't bother us though, because it's our... | Read more »

Price Scanner via MacPrices.net

B&H offers 2018 13″ 2.3GHz 4-Core Apple M...
B&H Photo has new 2018 13″ 2.3GHz Quad-Core Touch Bar MacBook Pros on sale for $150 off MSRP. These are the same MacBooks sold by Apple in their retail and online stores. Shipping is free: – 2018... Read more
President’s Day Weekend Sale: B&H offers...
B&H Photo has dropped prices on new 2018 15″ 6-Core Touch Bar MacBook Pros with models now on sale for $300-$400 off MSRP, starting at $2099. These are the same models sold by Apple in their... Read more
President’s Day Weekend Sale: New 2018 13″ Ap...
B&H Photo has new 2018 13″ MacBook Airs on sale for $100-$200 off MSRP this weekend, starting at only $1049. Shipping is free: – 13″ 1.6GHz/128GB MacBook Air Space Gray: $1099.99. $100 off MSRP... Read more
New Sprint promotion: Get iPhone 7 preowned f...
Sprint is offering the 32GB iPhone 7, preowned, for $3 per month when combined with a Sprint 18 month Flex lease. Offer is valid from 2/15/19 to 2/21/19. The iPhone cost is applied as a $9 bill... Read more
New Emoji Update Version 12.0 Another Example...
COMMENTARY: 02.15.19- A slew of 15 new emojis reflecting people with disabilities is forthcoming in the version 12.0 update for smartphone devices including the iPhone but whose idea was it in the... Read more
13″ 2.3GHz MacBook Pros available at Apple st...
In the market for a 13″ MacBook Pro and looking for the lowest prices you can find? Apple’s refurbished prices are the lowest available for each model from any reseller. An standard Apple one-year... Read more
People Profiles: This Apple Fan Owns A Collec...
FEATURE: 02.14.19- We Apple fans love almost everything that the Cupertino, California-based tech company doles out to the masses and one particular fellow who has amassed a complete personal... Read more
Update: Amazon now selling Apple Watch Series...
Get an Apple Series 3 Watch today for up to a massive $100 off MSRP at Amazon. That’s up from $50 off previously. Choose Amazon as the seller rather than a third-party, and note that Amazon stock... Read more
Adorama offers new 2018 15″ 6-Core MacBook Pr...
Adorama has new 2018 15″ 6-Core Touch Bar MacBook Pros on sale today for $164-$224 off MSRP. Shipping is free, and Adorama charges sales tax for NY & NJ residents only: – 2018 15″ 2.2GHz Space... Read more
Deal Alert! Get a 256GB 11″ WiFi Apple iPad P...
Amazon has the new 2018 Apple 11″ 256GB WiFi iPad Pro in stock today and on sale for $150 off MSRP. Shipping is free: – 11″ 256GB WiFi iPad Pro: $799.99 $150 off Their price is the lowest available... Read more

Jobs Board

*Apple* Mobile Master - Best Buy (United Sta...
**673204BR** **Job Title:** Apple Mobile Master **Job Category:** Store Associates **Location Number:** 001514-Hutchinson-Store **Job Description:** **What does a Read more
Geek Squad *Apple* Master Consultation Agen...
**673307BR** **Job Title:** Geek Squad Apple Master Consultation Agent **Job Category:** Services/Installation/Repair **Location Number:** 001011-Spulvda Read more
*Apple* / Mac Support Technician - CompuCom...
Previous Apple / Mac Support Technician Next **Ref No.:** 19-00493 **Location:** Richfield, Minnesota As part of a leading IT managed services specialist with more Read more
Operations Associate - *Apple* Blossom Mall...
Operations Associate - Apple Blossom Mall Location:Winchester, VA, United States- Apple Blossom Mall 1850 Apple Blossom Dr Job ID:1044618 Date:February 11, Read more
Cashier - *Apple* Blossom Mall - JCPenney (...
Cashier - Apple Blossom Mall Location:Winchester, VA, United States- Apple Blossom Mall 1850 Apple Blossom Dr Job ID:1042611 Date:February 11, 2019 Job Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.