Gadgets for Windows Sidebar Packaging, Updating, and Refreshing

  • Article

This overview describes how to install or refresh a gadget when updates are made to gadget files during development, debugging, and distribution.

  • Packaging a Sidebar Gadget
  • Development and Debugging
    • The Manifest
    • The Primary HTML, Script, or CSS Files
    • The Settings and Flyout HTML, Script, or CSS Files
  • Distributing or Installing An Updated Gadget Package
  • Gadgets and Web Services

Packaging a Sidebar Gadget

Gadgets can be deployed using one of the following methods:

  • A ZIP file. In this package type, the gadget files are collected and compressed into a single file. Many tools, including Windows itself, can create, extract, and edit ZIP files.

    A simple way to create a ZIP file is to select the "show file extensions" option in Windows Explorer. Create a compressed folder. Copy all of your gadget files into the compressed folder. Change the extension from ".zip" to ".gadget".

  • A Windows cabinet (CAB) file. The CAB file can be code-signed to provide additional information to users.

  • A Windows Installer .msi file.

Both Gadget CAB files and ZIP files must have the .gadget extension. This enables Windows Sidebar to open the package when the user downloads or double-clicks the file.

Note   Some e-mail servers are configured to detect and remove DHTML code when found inside attached files. CAB, ZIP, and gadget files are no exception. For this reason, you may want your gadget to be downloaded from a Web site.

Development and Debugging

In most cases, it is not necessary to shut down and restart the Sidebar to see updates.

When revising gadget files directly in one of the gadget system folders (%USER_DATA%\Local\Microsoft\Windows Sidebar\Gadgets or %SYSTEM_ROOT%\Program Files\Windows Sidebar\Gadgets) or in a separate development environment, follow these steps:

The Manifest

  1. Close the Gadget Picker, if open.
  2. Copy the updated manifest to the gadget folder, if necessary.
  3. Reopen the Gadget Picker.

The Primary HTML, Script, or CSS Files

  1. Copy the updated files to the gadget folder, if necessary.
  2. Open the Gadget Picker, if necessary. The Gadget Picker does not need to be closed.
  3. Install the updated gadget.

Note  Any versions of the gadget added to the Sidebar prior to the update remain visible and continue to function as before.

The Settings and Flyout HTML, Script, or CSS Files

  1. Close the gadget Settings, if open.
  2. Copy the updated files to the gadget folder, if necessary.

Note  The gadget does not need to be re-added to the Sidebar, the updated functionality will be available when the gadget settings, or the flyout, are re-displayed.

Distributing or Installing An Updated Gadget Package

When installing an updated gadget package, it's advisable to uninstall any previous versions by right-clicking the gadget in the Gadget Picker and selecting "Uninstall" from the context menu. This deletes all pre-existing gadget files. Otherwise, installing an updated gadget by either a self-installing gadget package or copying selected files results in the same behavior described above.

Gadgets and Web Services

Web services provide an alternative method for gadget developers to update their gadgets. Hosting business logic on a server and the presentation logic on the client (the gadget) allows for discrete updates with little to no intervention by end users.

 

 

Send comments about this topic to Microsoft

Build date: 2/24/2010

Build type: SDK