Common Steps

This chapter covers some common steps when testing iSync plug-ins. Before running any tests the device needs to connected to the computer. It is also recommended that you turn Sync Alert panels on so you can observe what records are being synced. You also need to be familiar with running Apple Applications such as iCal and Address Book. Some tests also use the Syncrospector developer tool.

Connecting to a Device

If the device uses USB only, then connect the USB cable to the device and computer before running any tests. There is no other setup required to use USB.

If the device uses Bluetooth only, then pair the device with the computer before running any tests. This step needs to be done only once per device. Use the Bluetooth pane in System Preferences to pair a Bluetooth device. Choose Help > System Preferences Help to learn more about setting up a Bluetooth connection.

If the device uses both Bluetooth and USB, then run some of the tests using Bluetooth and others using USB. Note that if you pair a Bluetooth device with the computer, you can no longer use the USB connection. Therefore, for devices that support both, delete the device from the Bluetooth pane in System Preferences before using the USB connection.

Setting the Data Change Alert

Before running any of the tests in this document, you should configure the iSync preferences so an alert appears each time the device changes the state of the truth—each time the device adds, modifies, or deletes records—as follows:

Using Apple Applications

Some of the steps described in this document involve running Apple applications and tools to set up the records on the computer. You are expected to be able to perform common tasks such as adding records to the computer and syncing the device. You should be familiar with these Apple applications before running these tests:

Note that most tests in this document assume that when you add a record, you populate all fields for that record.

Using Syncrospector

Some of the tests require you to use this developer tool, Syncrospector, located in /Developer/Applications/Utilities, to help debug your sync sessions. You can use Syncrospector during testing to force sync modes such as slow, fast, or reset. Read Sync Services Tutorial to learn more about Syncrospector.