Progress will discontinue Telerik Platform on May 10th, 2018. Learn more

Simulate File Storage

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

In the simulator, you can test the File and FileTransfer core Apache Cordova plugins. When you test these core plugins, you might need to have persistent and temporary file storage set for the LocalFileSystem object. You can choose folders from your local file system and set them for the LocalFileSystem constants.

Instead of the absolute persistent or temporary root paths, the device simulator returns the following corresponding constants: %simulator_persistent_root% or %simulator_temporary_root%.

In the device simulator, you can download and upload files with the Apache Cordova FileTransfer API only in the persistent file storage location on your disk.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app in AppBuilder.
  • Verify that the simulator is running.

Procedure

In-Browser

In this version of the in-browser client, you cannot simulate the File and FileTransfer core plugins and you cannot set the local file system in the device simulator.

Windows

File paths are case sensitive in iOS and case insensitive in Android.

  1. Click Show/Hide File Storage to open the File Storage pane.
  2. For the Persistent file path, click Browse to select a folder from your local file system and set it as persistent file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  3. For the Temporary file path, click Browse to select a folder from your local file system and set it as temporary file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  4. For the Application Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application is installed for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  5. For the Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the root for the writable storage for the app.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  6. For the Data Directory file path, click Browse to select a folder from your local file system and set it as the directory where application-specific data files are stored.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  7. For the Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application will cache its data and preserve it across app restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  8. For the External Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the device stores application files.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  9. For the External Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application stores its data.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  10. For the External Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application caches data that needs to be preserved across restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  11. For the External Root Directory file path, click Browse to select a folder from your local file system and set it as the root directory of the external memory of the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  12. For the Temp Directory file path, click Browse to select a folder from your local file system and set it as the directory which the simulated iOS can clear at will.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  13. For the Synced Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in which the app stored data that needs to be synchronized.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  14. For the Documents Directory file path, click Browse to select a folder from your local file system and set it as the directory where the app stores private files.
    Alternatively, type or paste the absolute file path to the location that you want to use.

Visual Studio

File paths are case sensitive in iOS and case insensitive in Android.

  1. Click Show/Hide File Storage to open the File Storage pane.
  2. For the Persistent file path, click Browse to select a folder from your local file system and set it as persistent file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  3. For the Temporary file path, click Browse to select a folder from your local file system and set it as temporary file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  4. For the Application Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application is installed for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  5. For the Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the root for the writable storage for the app.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  6. For the Data Directory file path, click Browse to select a folder from your local file system and set it as the directory where application-specific data files are stored.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  7. For the Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application will cache its data and preserve it across app restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  8. For the External Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the device stores application files.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  9. For the External Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application stores its data.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  10. For the External Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application caches data that needs to be preserved across restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  11. For the External Root Directory file path, click Browse to select a folder from your local file system and set it as the root directory of the external memory of the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  12. For the Temp Directory file path, click Browse to select a folder from your local file system and set it as the directory which the simulated iOS can clear at will.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  13. For the Synced Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in which the app stored data that needs to be synchronized.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  14. For the Documents Directory file path, click Browse to select a folder from your local file system and set it as the directory where the app stores private files.
    Alternatively, type or paste the absolute file path to the location that you want to use.

CLI

File paths are case sensitive in iOS and case insensitive in Android.

If you are running the command-line interface on a Windows system, perform the following steps.

  1. Click Show/Hide File Storage to open the File Storage pane.
  2. For the Persistent file path, click Browse to select a folder from your local file system and set it as persistent file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  3. For the Temporary file path, click Browse to select a folder from your local file system and set it as temporary file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  4. For the Application Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application is installed for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  5. For the Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the root for the writable storage for the app.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  6. For the Data Directory file path, click Browse to select a folder from your local file system and set it as the directory where application-specific data files are stored.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  7. For the Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application will cache its data and preserve it across app restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  8. For the External Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the device stores application files.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  9. For the External Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application stores its data.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  10. For the External Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application caches data that needs to be preserved across restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  11. For the External Root Directory file path, click Browse to select a folder from your local file system and set it as the root directory of the external memory of the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  12. For the Temp Directory file path, click Browse to select a folder from your local file system and set it as the directory which the simulated iOS can clear at will.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  13. For the Synced Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in which the app stored data that needs to be synchronized.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  14. For the Documents Directory file path, click Browse to select a folder from your local file system and set it as the directory where the app stores private files.
    Alternatively, type or paste the absolute file path to the location that you want to use.

If you are running the command-line interface on a macOS system, perform the following steps.

  1. In the title bar of the simulator, select ToolsLaunch Instruments.
  2. Click File Storage.
  3. For the Persistent file path, click Browse to select a folder from your local file system and set it as persistent file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  4. For the Temporary file path, click Browse to select a folder from your local file system and set it as temporary file storage for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  5. For the Application Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application is installed for the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  6. For the Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the root for the writable storage for the app.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  7. For the Data Directory file path, click Browse to select a folder from your local file system and set it as the directory where application-specific data files are stored.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  8. For the Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory where the application will cache its data and preserve it across app restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  9. For the External Application Storage Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the device stores application files.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  10. For the External Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application stores its data.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  11. For the External Cache Directory file path, click Browse to select a folder from your local file system and set it as the directory in the external memory of the simulated device where the application caches data that needs to be preserved across restarts.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  12. For the External Root Directory file path, click Browse to select a folder from your local file system and set it as the root directory of the external memory of the simulated device.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  13. For the Temp Directory file path, click Browse to select a folder from your local file system and set it as the directory which the simulated iOS can clear at will.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  14. For the Synced Data Directory file path, click Browse to select a folder from your local file system and set it as the directory in which the app stored data that needs to be synchronized.
    Alternatively, type or paste the absolute file path to the location that you want to use.
  15. For the Documents Directory file path, click Browse to select a folder from your local file system and set it as the directory where the app stores private files.
    Alternatively, type or paste the absolute file path to the location that you want to use.

Next Steps

Simulate changes in user location.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.