Installing Sync Framework
Sync Framework enables you to install components for development by using the SDK installation package. The package name is SyncSDK-v2.1-x86-ENU.msi for the English version for x86 platforms; the names for other versions will differ. Download the installation package from the Microsoft Download Center, and follow the installation instructions from that site. Sync Framework 2.1 supports side-by-side install with Sync Framework 2.0 and Sync Framework 1.0. Redistributable components are provided in a set of separate packages. This lets you tailor the installation to application requirements. For more information about redistribution, see Redistributing Sync Framework.
On an x86 platform, the x86 installation package installs the following components into Program Files\Microsoft SDKs\Microsoft Sync Framework\2.1, and adds managed DLLs to the global assembly cache (GAC). On an x64 platform, both the x86 and the x64 installation package install into Program Files (x86)\Microsoft SDKs\Microsoft Sync Framework\2.1. Other combinations of platform and installation package may yield slight variations on the installation path.
Component |
Description |
Install Location |
|---|---|---|
Microsoft.Synchronization.Data.dll, Microsoft.Synchronization.Data.Server.dll, Microsoft.Synchronization.Data.SqlServer.dll, and Microsoft.Synchronization.Data.SqlServerCe.dll (see version note below this table) |
Managed API for database synchronization providers (also requires Microsoft.Synchronization.dll). For more information, see Synchronizing Databases. |
\Runtime\ADO.NET\V3.1\x86 \Runtime\ADO.NET\V3.1\x64 |
Microsoft.Synchronization.dll, Synchronization21.dll, and FeedSync21.dll |
Managed and native API for the synchronization runtime, core components, and Web synchronization components. For more information, see Synchronizing Data Stores by Using Custom Providers and Synchronizing Web Feeds. |
\Runtime\x86 \Runtime\x64 |
Microsoft.Synchronization.MetadataStorage.dll and MetaStore21.dll; and Msfdb.dll, Msfdbqp.dll, and Msfdbse.dll |
Managed and native API for the metadata storage service; and DLLs for the lightweight database that the service uses. For more information, see Sync Framework Metadata Storage Service. |
\Runtime\x86 \Runtime\x64 |
Microsoft.Synchronization.SimpleProviders.dll and SimpleProviders21.dll |
Managed and native API for simple custom providers. For more information, see Implementing a Simple Custom Provider. |
\Runtime\x86 \Runtime\x64 |
Microsoft.Synchronization.Files.dll and FileSyncProvider21.dll |
Managed and native API for the file synchronization provider. For more information, see Synchronizing Files. |
\Runtime\x86 \Runtime\x64 |
*.pdb files |
Symbols to use during debugging. |
\Symbols\x86 \Symbols\x64 |
*.h files |
Header files that contain declarations needed for writing unmanaged code. |
\include |
*.lib files |
Import libraries for compiling unmanaged code. |
\lib\x86 \lib\x64 |
SyncSDK_v21.chm |
Documentation for all Sync Framework components. |
\Documentation\<LCID> |
Sample files |
Samples that demonstrate Sync Framework functionality. |
\Samples |
SyncSDKEula.rtf |
License agreement for using Sync Framework. |
\License Agreements |
Note
The database provider classes in the Microsoft.Synchronization.Data.SqlServerCe namespace require SQL Server Compact 3.5 SP2.
Component Versions and Folder Locations
The database provider assemblies have a different version number than the version number of the Sync Framework release. This is because Microsoft.Synchronization.Data.SqlServerCe.dll was originally released before Sync Framework 1.0, as part of SQL Server Compact. In that release, Microsoft.Synchronization.Data.SqlServerCe.dll had a version number of 3.5 to match the SQL Server Compact version. When the database providers were first released as part of Sync Framework, they were given a version of 2.0 to show that they had been released previously. The following table lists the released versions of Sync Framework along with the version numbers of the major components and the processor architectures supported for each release.
Product name |
Core components version |
Provider services version |
Database providers version |
Supported architectures |
|---|---|---|---|---|
Sync Framework 1.0 |
1.0 |
1.0 |
2.0 |
x86, x64, ia64 |
Sync Framework 2.0 |
2.0 |
2.0 |
3.0 |
x86, x64, ia64 |
Sync Framework 2.1 |
2.1 |
2.1 |
3.1 |
x86, x64 |
All of the components listed in the previous table are installed when the Sync Framework SDK is installed. The default root location for SDK installs is: Program Files\Microsoft SDKs\Microsoft Sync Framework on x86 platforms and Program Files (x86)\Microsoft SDKs\Microsoft Sync Framework on x64 platforms.
Each of the major component groups can also be installed or redistributed separately. The default root location for redistributable installs is: Program Files\Microsoft Sync Framework on x86 platforms. For more information about redistributing Sync Framework assemblies, see Redistributing Sync Framework.
The following tables list the assemblies contained in each redistributable package, and the version and installation path (relative to the root installation path) for each package. The parameter <arch> is used in place of a particular processor architecture, such as x86. The parameter <lang> is used in place of a three-character language identifier, such as ENU for English.
Core components package
Redistributable package name |
Redistributable package filename |
Package version |
Assembly names |
Assembly version |
Installation path |
|---|---|---|---|---|---|
Microsoft Sync Framework Runtime v1.0 |
Synchronization.msi |
1.0 |
Microsoft.Synchronization.dll Synchronization.dll FeedSync.dll |
1.0.0.0 |
v1.0\Runtime\<arch> |
Microsoft Sync Framework 2.0 Core Components |
Synchronization-v2.0-<arch>-<lang>.msi |
2.0 |
Microsoft.Synchronization.dll Synchronization2.dll FeedSync2.dll |
2.0.0.0 |
2.0\Runtime\<arch> |
Microsoft Sync Framework 2.1 Core Components |
Synchronization-v2.1-<arch>-<lang>.msi |
2.1 |
Microsoft.Synchronization.dll Synchronization21.dll FeedSync21.dll |
2.1.0.0 |
2.1\Runtime\<arch> |
Provider services package
Redistributable package name |
Redistributable package filename |
Package version |
Assembly names |
Assembly version |
Installation path |
|---|---|---|---|---|---|
Microsoft Sync Framework Services v1.0 |
ProviderServices.msi |
1.0 |
Microsoft.Synchronization.MetadataStorage.dll Microsoft.Synchronization.Files.dll Metastore.dll Msfdb.dll Msfdbqp.dll Msfdbse.dll FileSyncProvider.dll |
1.0.0.0 |
v1.0 Runtime\<arch> |
Microsoft Sync Framework 2.0 Provider Services |
ProviderServices-v2.0-<arch>-<lang>.msi |
2.0 |
Microsoft.Synchronization.MetadataStorage.dll Microsoft.Synchronization.Files.dll Microsoft.Synchronization.SimpleProviders.dll Metastore2.dll Msfdb.dll Msfdbqp.dll Msfdbse.dll SimpleProviders2.dll FileSyncProvider2.dll |
2.0.0.0 |
2.0\Runtime\<arch> |
Microsoft Sync Framework 2.1 Provider Services |
ProviderServices-v2.1-<arch>-<lang>.msi |
2.1 |
Microsoft.Synchronization.MetadataStorage.dll Microsoft.Synchronization.Files.dll Microsoft.Synchronization.SimpleProviders.dll Metastore21.dll Msfdb.dll Msfdbqp.dll Msfdbse.dll SimpleProviders21.dll FileSyncProvider21.dll |
2.1.0.0 |
2.1\Runtime\<arch> |
Database providers package
Redistributable package name |
Redistributable package filename |
Package version |
Assembly names |
Assembly version |
Installation path |
|---|---|---|---|---|---|
Microsoft Sync Services for ADO.NET v2.0 |
SyncServicesADO.msi |
2.0 |
Microsoft.Synchronization.Data.dll Microsoft.Synchronization.Data.Server.dll Microsoft.Synchronization.Data.SqlServerCe.dll |
2.0.0.0 |
v1.0\Runtime\ADO.NET\V2.0\<arch> |
Microsoft Sync Framework 2.0 Database Providers |
DatabaseProviders-v3.0-<arch>-<lang>.msi |
3.0 |
Microsoft.Synchronization.Data.dll Microsoft.Synchronization.Data.Server.dll Microsoft.Synchronization.Data.SqlServer.dll Microsoft.Synchronization.Data.SqlServerCe.dll |
3.0.0.0 |
2.0\Runtime\ADO.NET\V3.0\<arch> |
Microsoft Sync Framework 2.1 Database Providers |
DatabaseProviders-v3.1-<arch>-<lang>.msi |
3.1 |
Microsoft.Synchronization.Data.dll Microsoft.Synchronization.Data.Server.dll Microsoft.Synchronization.Data.SqlServer.dll Microsoft.Synchronization.Data.SqlServerCe.dll |
3.1.0.0 |
2.1\Runtime\ADO.NET\V3.1\<arch> |