Modifying the Default PhoneGap Location For Persistent Files

Description

The Persistent File Location property is set to "Internal" for Android and "Library" for iOS.

This is the recommended setting on Android to guarantee the files are contained within the app folder and that the files are deleted when the app is deleted. Under iOS, the files are always in the app folder, however, files in the Library folder are not available to iTunes nor are they synchronized to iCloud.

When "Compatibility" mode is set as the persistent file location for an Android PhoneGap app:

  • The files are written to the devices root directory

  • The app has full access to the devices files

  • The media files are indexed by the Gallery app

  • The files are NOT deleted when the app is uninstalled from the device

When "Compatibility" mode is set as the persistent file location for an iOS PhoneGap app:

  • The files are written to the apps sand-boxed Documents directory

  • The files may be accessed via iTunes

  • The files may be synchronized to iCloud

In general "Compatibility" mode is NOT the recommended setting.

If you have used the PhoneGap file plugin, the default setting will make your app files inaccessible. The setting will not change for existing PhoneGap apps because the "Compatibility" setting will remain within the configuration file. Your app will only be affected if you delete the previous PhoneGap project and create a new one. You can change this setting by enabling Show Advanced Options in the Configuration Options settings of the PhoneGap App Builder Genie. Once the Show Advanced Options is enabled, you can change the persistent file location as required.