Retired Document
Important:
The information in this document is deprecated in Mac OS X v10.7; don't use it for new development. Instead use the iCloud extensions to the NSFileManager class to share file-based data and use the NSUbiquitousKeyValueStore class to share preferences. Use the Address Book framework to access shared contact data and use the Calendar Store framework to access shared calendar data.
Introduction
Syncrospector is a developer tool you can use to help debug your Sync Services applications. Sync Services is a framework containing all the components you need to sync your applications and devices. By using Sync Services, user data can be synced with other applications and devices on the same computer, or other computers over the network via MobileMe. The process of syncing client records is complex. Syncrospector helps you verify that your client is syncing correctly every step of the way.
For many reasons, designing, implementing, and debugging your syncing application can be challenging—for example, multiple applications may join a sync session, your application may crash, your local data file may be missing when your application launches, and you might want to trickle sync. This user guide focuses on the responsibilities of the application and how to use Syncrospector to debug your application.
This book uses two sample applications, SimpleStickies and StickiesWithCoreData, to show you how to debug your sync client. Before reading further, download these sample code projects or follow along using your own sync client.
Who Should Read This Document?
You should read this document if you are developing an application or tool that uses Sync Services. This document contains information on debugging your Sync Services client using Syncrospector.
Organization of This Document
The following articles cover several aspects of developing a Sync Services application:
Debugging Sync Clients describes the overall process of syncing and what phases you should test.
Registering and Viewing Schemas describes how to check whether your schema is registered correctly.
Viewing Sync Client State explains how to set up the Syncrospector tool and view status about clients and sync sessions.
Viewing Records in the Truth Database shows how to examine the contents of the truth database after syncing.
Viewing the Call History describes how to view the call history of a sync session.
Testing Sync Modes describes how to emulate different sync modes.
Debugging Multiple Clients describes how to view the call history of two clients that join the same sync session.
See Also
For a complete description of the Sync Services classes and methods, read:
Sync Services Programming Guide, which discusses Sync Services concepts such as the architecture, components, creating a schema, and managing a sync session.
Sync Services Framework Reference, which contains a description of each class, method, and type.
If you are using or extending an Apple Applications schema, such as contacts, bookmarks, or calendars, read:
Apple Applications Schema Reference, which describes the different Apple Applications schemas that you can use in your applications.
Copyright © 2011 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2011-07-06