TweetFollow Us on Twitter

Using Virtual User
Volume Number:12
Issue Number:9
Column Tag:Quality Assurance

Software Testing With Virtual User

A cost-effective proving ground for software

By Jeremy Vineyard

Introduction

It is continually frustrating to have new applications crash soon after being installed. Such products give the impression that insufficient work was done before shipping to ensure their quality.

In software companies today, it is standard procedure to test a product to ensure its quality and reliablity before shipping. Quality Assurance (QA) is a common name for such testing. QA is becoming increasingly important as applications take on ever-increasing size and complexity. There can be many thousands of variations in the ways a user might interact with a software product, and a QA tester must check these to verify that everything works correctly. So QA testers need the tools to get their job done effectively.

There are numerous ways to improve the software testing process, but one of the most effective has been the automated testing tool, whereby QA testers can set up specific tests and suites of tests to be run by the computer. This frees them from many hours of drudgery, thus saving both time and money by allowing them to refocus their energies on tasks that need more human interaction, spreading the range of the testing eventually completed. This also leads to more reliability in the software.

You don’t have to have a dedicated QA department to be able to test your products. Even if you are a small developer, it is a good idea always to verify the quality of your products before they are shipped, and automated tools can help. One of the most popular automated testing tools for the Mac is Virtual User.

What is Virtual User?

Virtual User (VU) is an automated testing tool that allows a computer to emulate a human user, performing actions such as clicking the mouse and typing keys. This computer acts as a host, and controls other computers just as a person would. One or more target computers act as agents receiving instructions from the host.

Figure 1. Virtual User

The VU environment consists of an application that compiles and run scripts. VU scripts must be edited separately in a text editor, such as MPW or BBEdit.

VU links computers together over an AppleTalk network. The minimum setup for a VU testing system is the VU software package and two computers (one host and one target).

VU is developed by Apple Computer, Inc., and is available for under $100 through most Macintosh developer catalogs. [It comes for free if you’re already subscribing to the ETO CD. Apple lists the price as $150 on their Web site, at http://dev.info.apple.com/TPC/VU.Datasheet.html, but says $79 in the printed APDA catalogue. Go figure. - man]

Limitations Of Virtual User

There are many things that an automated tool cannot do, and it is important to realize these limitations before planning your automated test suites. An automated tool cannot tell when something “looks right” on the screen. VU can’t tell you when an icon or window is pretty or ugly or misaligned.

VU is fairly unintelligent. You can tell it to “Move window ‘My Window’ to (x,y)”, but you can’t tell it to “Open icon for hard drive in Finder.” Also, if the target machine crashes, VU doesn’t know about it and will keep trying to run the script. The script can be paused and the machine restarted to allow the script to resume. Proper debugging techniques are essential for determining the events that led up to the crash. Some of these techniques will be explained later in the article.

Advantages of Virtual User

VU is most effective at highly repetitive tests that may have many variations. One example might be to select every control in every dialog in the application, making sure that each click produces the appropriate dialog, action, etc. This would be a very tedious task for a human to accomplish, but the computer doesn’t care about tediousness, making it the ideal tester for the project.

Another use of VU is to write a test that can be run after every internal build of a product (development, alpha, beta, final candidate) to verify that nothing was broken by the code changes made to the previous version. VU can also be used to set up automatic bug verification, by acting out the steps necessary to reproduce a bug. With this capability, the automatic bug verification can be run on every new release of a product to ensure that the bug is fixed and that it doesn’t sneak back into the code.

Understanding Virtual User Scripts

Each automated script has an entry point specified by the script statement in VU:

script TestControlsAndWindows()
begin
    # Do automated tests here.
end;

From then on, the VU script is much like the actions of a person. You tell it to click on windows or buttons, move the mouse, type keys, and more. Here is an example of a script that will test some menu items:

script TestMenuItems()
begin
    # Select the menu item “Show Script Window” from the “Windows” menu.
 select [menuItem title:"Show Script Window" 
 menu:[menu title:"Windows"]];

    # Wait 10 seconds for the window to appear.
 wait(10);

    # Verify that the “Script Window” window appears.
 if match [window ordinality:1 title:"Script Window"]
 println("The window 'Script Window' 
 opened correctly.");
 else
 println("ERROR! The window 'Script Window'
  did not open.");
end;

In addition to scripts, VU supports functions that act as extensions to the script. These are called tasks. A task is a procedure with a list of parameters and an optional return value.

task DoTheRightThing(var1 := "default value", var2)
begin
    # Do the right thing here.
 
    # Return a value (optional).
 return "result";
end;

VU collects information about the target computer’s environment using (as we have already seen) the match statement. The match statement looks for a specific environment element, using descriptor traits such as the element’s title or ordinality.

VU can “see” any menu or window and any control that is implemented with the Control Manager and stored in the window’s list of controls. However, because the List Manager doesn’t provide a standard API for accessing the contents of a list, VU cannot see a list or the items inside it. VU can also see dialog items such as user items, static text, edit text, icons, and pictures.

# Find the menu called “Testing”.
theMenu := match [menu title:"Testing"];

# Find the frontmost window.
theWindow := match [window ordinality:1];

The collect statement is similar to match in that it collects all the elements of a certain type into a list.

# Keep a list of all the open windows.
windowList := collect [window];

VU then interacts with the environment, using such keywords as select, drag, close, type, and click. VU accesses common Macintosh objects such as windows, buttons, scroll bars, and menus.

# Select the menu item.
select [menuItem title:"Show Clipboard" 
 menu:[menu title:"Edit"]];

# Move the window.
drag [window title:"Clipboard"] relative:{30, 30};

# Type characters into the window.
type keystrokes:{"This is some text"};

# Select a button.
select [button title:"OK"];

# Close the window.
close [window ordinality:1 title:"Clipboard"]!;

Tip: If possible, implement your application windows as modeless dialogs. VU recognizes the user item element in a dialog, allowing user items to indicate to VU where non-standard user interface elements are located.

Debugging Virtual User Scripts

VU provides a log file feature, by which information from within the script can be written out, providing the scripter with information about the current run-time state of the script. One of the most effective ways to debug an automated script is to log with the println statement anywhere anything important happens or changes. (The {} syntax substitutes the actual values of the variables for the variable names in the string.)

task MyTask(var1, var2, var3)
begin
 println("MyTask({var1}, {var2}, {var3})");

 println("Starting batch processing.");
 StartBatchProcessing();
end;

Tip: Because there is no type checking in VU, it is a good idea to log the parameters that are input into every task to make sure that the correct values were passed.

Extending Virtual User with Libraries

One of the most useful features of VU is the ability to split commonly used tasks into reusable files called libraries. To use all of the tasks in a library, the Libraries statement is used as shown:

# This statement makes all the tasks in the file called “Special Tools.vulib” 
# accessible to this script.
Libraries "Special Tools.vulib";

Libraries are commonly used to group tasks with common actions into smaller and more manageable files, such as Finder Tools.vulib, My App Tools.vulib, etc.

Tip: Because large projects may have dozens of library files, it is a good idea to establish a naming convention for both the names of the library files and the names of the tasks within the files. One might, for instance, append “Tools.vulib” to the name of every library file, and use a unique two-letter prefix for every task in the library.

# This task is in the library “Finder Tools.vulib”.
task FT_EjectDisk()
begin
    # Eject the disk with a command-key combination.
 pressKey keystrokes:{commandKey};
 type keystrokes:{'E'};
 releaseKey keystrokes:{commandKey};
end;

Extending Virtual User with Globals

Another useful feature of VU is support for global variables. To declare a global variable, simply place the global keyword before the variable name when you define it.

# Once this variable is defined, it can be accessed from anywhere.
global gMyGlobal := 1000;

To access a previously defined global variable, again attach the global keyword before using the variable.

Here is an example of how using global variables can save considerable time and effort. This script:

task MA_DoThis(appVersion := '1.0', var1, var2, var3)
begin
end;

task MA_DoThat(appVersion := '1.0', var1, var2)
begin
end;

script MyScript()
begin
 MA_DoThis('1.0', 10, 20, 30);
 MA_DoThat('1.0', "test", "do");
end;

can be simplified to this:

task MA_DoThis(var1, var2, var3)
begin
    # Now the variable ‘gAppVersion’ is using the global value.
 global gAppVersion;
end;

task MA_DoThat(var1, var2)
begin
    # Now the variable ‘gAppVersion’ is using the global value.
 global gAppVersion;
end;

script MyScript()
begin
 global gAppVersion := '1.0';

 MA_DoThis(10, 20, 30);
 MA_DoThat("test", "do");
end;

The advantages may seem small in this simple example, but once you start writing scripts with hundreds or even thousands of separate tasks being called, it can be difficult to pass variables several levels deep through the chain. Using globals allows variables to be accessed from anywhere within the script.

Tip: For applications whose user interface is changing rapidly, insteading of searching all of your scripts and libraries every time the text for a menu item, window, or button is changed, use a global variable that is declared at the beginning of every script, to hold the current state of the interface item.

# This task must be called before the globals can be used.
task MA_DeclareGlobals()
begin
 global toolsMenu := [menu title:"Tools"];

    # If the name of the paint tool menu item ever changes, we have only to
    # change it in one place, and all other scripts will be using the correct
    # value. This keeps us from having to replace the string everywhere it
    # occurs in all of the scripts.
 global paintToolMenuItem := 
 [menuItem title:"Painter" menu:toolsMenu];
end;

task MA_SwitchToPaintTool()
begin
 select global paintToolMenuItem;
end;

Extending Virtual User with External Tools

If you find that you have reached the limitations of the VU language, it is possible to write an external tool for VU. An external tool is an application that communicates with VU by sending and receiving Apple events. Because the external tool can be written in a more powerful language such as C/C++ or Pascal, the VU language can be extended. Templates and examples for creating external tools come with VU, eliminating much of the work.

Additional Features of Virtual User

VU has many of the features of a modern programming language, including if-else statements, for/while loops, list- and string-processing operators, and more.

VU has a built-in regular expression matching system that allows you to write scripts that match environment elements based on regular expressions, rather than simple strings. This is useful for multiple interface elements that may have similar names, but are not exactly the same. “Untitled-1”, “Untitled-2”, etc., can be represented by the regular expression “/Untitled- /”.

When running against multiple target machines, agents can communicate with each other by sending and receiving messages. This allows synchronization of events for software that can be run on multiple systems at the same time. This is useful for network software products that must be installed on more than one machine to communicate with one another.

The best place to learn about the features of VU is to look in the VU Language Reference manual. It is well written, and thoroughly describes the capabilities of the VU language.

Summary

Automated testing tools will never be able to entirely replace human testers in QA, nor should they. Most of what QA does is about discerning how a user might interact with a product, and a computer cannot always predict these actions or define a good way to test them. However, used properly, automated tools can greatly increase the productivity of QA, saving labor costs, increasing consistency, and shortening time to market. In today’s highly competitive environment, automated tools can provide you with the edge you need to succeed.

[There is a great deal of VU-related material on the Tool Chest editions of Apple’s Developer CD. For instance, in the May CD, which was the current Tool Chest CD as this issue went to press, the Testing & Debugging folder inside the Subject Index folder held aliases to various folders containing VU material, including a tutorial and a host of tools that extend VU’s abilities in valuable ways (note, in particular, Ivy, which allows VU to “capture and compare screen images”). - man]

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Civilization VI 1.2.4 - 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
Skype 8.52.0.138 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
Bookends 13.2.6 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
BusyContacts 1.4.0 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Chromium 77.0.3865.75 - 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 77.0.3865.75: A list of changes is available... Read more
DiskCatalogMaker 7.5.5 - Catalog your di...
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 for... Read more
Alfred 4.0.4 - Quick launcher for apps a...
Alfred is an award-winning productivity application for OS X. Alfred saves you time when you search for files online or on your Mac. Be more productive with hotkeys, keywords, and file actions at... Read more
A Better Finder Rename 10.45 - File, pho...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
iFinance 4.5.11 - Comprehensively manage...
iFinance allows you to keep track of your income and spending -- from your lunchbreak coffee to your new car -- in the most convenient and fastest way. Clearly arranged transaction lists of all your... Read more
OmniGraffle Pro 7.11.3 - Create diagrams...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more

Latest Forum Discussions

See All

Five Nights at Freddy's AR: Special...
Five Nights at Freddy's AR: Special Delivery is a terrifying new nightmare from developer Illumix. Last week, FNAF fans were sent into a frenzy by a short teaser for what we now know to be Special Delivery. Those in the comments were quick to... | Read more »
Rush Rally 3's new live events are...
Last week, Rush Rally 3 got updated with live events, and it’s one of the best things to happen to racing games on mobile. Prior to this update, the game already had multiplayer, but live events are more convenient in the sense that it’s somewhat... | Read more »
Why your free-to-play racer sucks
It’s been this way for a while now, but playing Hot Wheels Infinite Loop really highlights a big issue with free-to-play mobile racing games: They suck. It doesn’t matter if you’re trying going for realism, cart racing, or arcade nonsense, they’re... | Read more »
Steam Link Spotlight - The Banner Saga 3
Steam Link Spotlight is a new feature where we take a look at PC games that play exceptionally well using the Steam Link app. Our last entry talked about Terry Cavanaugh’s incredible Dicey Dungeons. Read about how it’s a great mobile experience... | Read more »
PSA: GRIS has some issues
You may or may not have seen that Devolver Digital just released GRIS on the App Store, but we wanted to do a quick public service announcement to say that you might not want to hop on buying it just yet. The puzzle platformer has come to small... | Read more »
Explore the world around you in new matc...
Got a hankering for a fresh-feeling Match-3 puzzle game that offers a unique twist? You might find exactly what you’re looking for with What a Wonderful World, a new spin on the classic mobile genre which merges entertaining puzzles with global... | Read more »
Combo Quest (Games)
Combo Quest 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: Combo Quest is an epic, time tap role-playing adventure. In this unique masterpiece, you are a knight on a heroic quest to retrieve... | Read more »
Hero Emblems (Games)
Hero Emblems 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: ** 25% OFF for a limited time to celebrate the release ** ** Note for iPhone 6 user: If it doesn't run fullscreen on your device... | Read more »
Puzzle Blitz (Games)
Puzzle Blitz 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Puzzle Blitz is a frantic puzzle solving race against the clock! Solve as many puzzles as you can, before time runs out! You have... | Read more »
Sky Patrol (Games)
Sky Patrol 1.0.1 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.1 (iTunes) Description: 'Strategic Twist On The Classic Shooter Genre' - Indie Game Mag... | Read more »

Price Scanner via MacPrices.net

Save $150-$250 on 10.2″ WiFi + Cellular iPads...
Verizon is offering $150-$250 discounts on Apple’s new 10.2″ WiFi + Cellular iPad with service. Buy the iPad itself and save $150. Save $250 on the purchase of an iPad along with an iPhone. The fine... Read more
Apple continues to offer 13″ 2.3GHz Dual-Core...
Apple has Certified Refurbished 2017 13″ 2.3GHz Dual-Core non-Touch Bar MacBook Pros available starting at $1019. An standard Apple one-year warranty is included with each model, outer cases are new... Read more
Apple restocks 2018 MacBook Airs, Certified R...
Apple has restocked Certified Refurbished 2018 13″ MacBook Airs starting at only $849. Each MacBook features a new outer case, comes with a standard Apple one-year warranty, and is shipped free. The... Read more
Sunday Sale! 2019 27″ 5K 6-Core iMacs for $20...
B&H Photo has the new 2019 27″ 5K 6-Core iMacs on stock today and on sale for up to $250 off Apple’s MSRP. Overnight shipping is free to many locations in the US. These are the same iMacs sold by... Read more
Weekend Sale! 2019 13″ MacBook Airs for $200...
Amazon has new 2019 13″ MacBook Airs on sale for $200 off Apple’s MSRP, with prices starting at $899, each including free shipping. Be sure to select Amazon as the seller during checkout, rather than... Read more
2019 15″ MacBook Pros now on sale for $350-$4...
B&H Photo has Apple’s 2019 15″ 6-Core and 8-Core MacBook Pros on sale today for $350-$400 off MSRP, starting at $2049, with free overnight shipping available to many addresses in the US: – 2019... Read more
Buy one Apple Watch Series 5 at Verizon, get...
Buy one Apple Watch Series 5 at Verizon, and get a second Watch for 50% off. Plus save $10 on your first month of service. The fine print: “Buy Apple Watch, get another up to 50% off on us. Plus $10... Read more
Sprint offers 64GB iPhone 11 for free to new...
Sprint will include the 64GB iPhone 11 for free for new customers with an eligible trade-in in of the iPhone 7 or newer through September 19, 2019. The fine print: “iPhone 11 64GB $0/mo. iPhone 11... Read more
Verizon offers new iPhone 11 models for up to...
Verizon is offering Apple’s new iPhone 11 models for $500 off MSRP to new customers with an eligible trade-in (see list below). Discount is applied via monthly bill credits over 24 months. Verizon is... Read more
AT&T offers free $300 reward card + free...
AT&T Wireless will include a second free 64GB iPhone 11 with the purchase of one eligible iPhone at full price. They will also include a free $300 rewards card. The fine print: “Buy an elig.... Read more

Jobs Board

Student Employment (Blue *Apple* Cafe) Spri...
Student Employment (Blue Apple Cafe) Spring 2019 Penn State University Campus/Location: Penn State Brandywine Campus City: Media, PA Date Announced: 12/20/2018 Date Read more
Best Buy *Apple* Computing Master - Best Bu...
**732359BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000171-Winchester Road-Store **Job Description:** Read more
*Apple* Mobile Master - Best Buy (United Sta...
**732324BR** **Job Title:** Apple Mobile Master **Job Category:** Store Associates **Location Number:** 000013-Fargo-Store **Job Description:** **What does a Best Read more
Best Buy *Apple* Computing Master - Best Bu...
**732455BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000449-Auburn Hills-Store **Job Description:** **What does a Read more
*Apple* Mobility Pro - Best Buy (United Stat...
**732490BR** **Job Title:** Apple Mobility Pro **Job Category:** Store Associates **Location Number:** 000449-Auburn Hills-Store **Job Description:** At Best Buy, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.