How to use the Isolated Storage Explorer tool for Windows Phone 8

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Isolated Storage Explorer (ISETool.exe) is a command-line tool that is installed with the Windows Phone SDK. You can use Isolated Storage Explorer to list, copy, and replace files and directories in your app’s local folder. You can use these commands to verify that the correct files are being saved in the correct location, or to test your app with files that you provide.

The following table lists the command-line options for Isolated Storage Explorer.

Option

Description

cmd[:param]

cmd optionDescription

ts(Take snapshot) Copies the files and directories in the local folder from the device or emulator to your computer.The ts option copies the folders and files to an IsolatedStore folder that it creates on your computer under the target folder that you specify. The ts option also creates the following subdirectories in the IsolatedStore folder that it creates in the target directory.

Shared\ShellContent. The ShellContent directory contains Tile data. For more information about Tiles, see Tiles for Windows Phone 8.

Shared\Media.

rs

(Restore snapshot) Replaces the files and directories in the local folder on the device or emulator with files and directories from your computer.

Caution:

If you use the rs option to upload folders and files that you downloaded previously by using the ts option, make sure that you specify the IsolatedStorage folder created on your computer by the ts option as the source folder for the rs option.

dir[:device-path]Lists the files and directories in the specified directory of the local folder. If a directory is not specified, the files and directories in the root of the app’s local folder are listed. If no files or directories are found, an error is raised.Don’t include a leading or trailing slash in the directory entry.

EnumerateDevicesLists the valid device targets and the device index for each device.

target-device[:param]

target-device optionDescription

xdIndicates to target the emulator.

deIndicates to target a tethered device.

deviceindex:nIndicates to target the device listed at index n. To get the list of available devices, run the command ISETool EnumerateDevices.

product-id

Specifies the ProductID from the WMAppManifest.xml file for the app that you want to test.

desktop-path

Specifies the directory on your computer where the local folder files are written to or copied from.

If the specified directory already exists, then a ts command overwrites the contents of the directory with no warning.

When you use the ts option to copy files from the emulator or device to the computer, the tool copies them to an IsolatedStore folder under the directory that you specify.

Downloads the local folder content of the app from the default emulator to the C:\data\myfiles\IsolatedStore folder on the computer. The tool creates the IsolatedStore folder under the directory that you specify.

Uploads all of the files from the C:\data\myfiles folder on the computer to the app’s local folder on the attached device.

Caution:

If you use the rs option to upload folders and files that you downloaded previously by using the ts option, make sure that you specify the IsolatedStorage folder created on your computer by the ts option as the source folder for the rs option.

You can use Isolated Storage Explorer to copy the files and directories in an app’s local folder on the emulator or device to your computer. You can then view the files to make sure that the app is saving them in the correct location with the correct data.

To copy files from the local folder to the computer using the ts option

Deploy the app you want to test to the emulator or a device.

Run the app to create files or directories in the local folder.

Get the Product GUID for the app specified in the ProductID attribute of the App element of the WMAppManifest.xml file.

Open a Command prompt window and navigate to the location of ISETool.exe.

To copy all of the files from the app’s local folder to your computer, type the following command using the Product GUID obtained in the previous steps and specify a target directory on your computer.

ISETool.exe ts <xd|de> <product-id> <desktop-path>

The following example shows a command that copies the local folder files to the directory "C:\Data\My Files\IsolatedStore" on your computer.

This command creates the target directory on your computer, creates the IsolatedStore directory in the target directory, and then copies the files and directories from the app’s local folder into the IsolatedStore directory.

Caution:

If the target directory already exists and you copy the files again, the entire contents of the target directory are overwritten without any warning.

You can use Isolated Storage Explorer to replace the files and directories in an app’s local folder on an emulator or a device with files and directories from your computer. Replacing files can be useful for testing an app.

To replace files in the local folder using the rs option

Deploy the app that you want to test to the emulator or a device.

Get the Product GUID for the app specified in the ProductID attribute of the App element of the WMAppManifest.xml file.

Open a Command prompt window and navigate to the location of ISETool.exe.

To replace all the files in the app’s local folder with files from your computer, type the following command using the Product GUID obtained in the previous steps and specify the source directory on your computer.

ISETool.exe rs <xd|de> <product-id> <desktop-path>

The following example shows a command that replaces the files and directories in an app’s local folder with the files from the directory "C:\Data\My Files" on your computer.

If you use the rs option to upload folders and files that you downloaded previously by using the ts option, make sure that you specify the IsolatedStorage folder created on your computer by the ts option as the source folder for the rs option.