When you build PhoneGap or TransForm applications, you may want to store data (SQLite databases, images, movies, audio files, PDF files, etc.) on the mobile device so that the files can be accessed when there is no internet connection. The On-Device-Data Builder can be used to generate the manifest that defines the data to download to the device.
The On-Device-Data Builder makes it easy to define the manifest and to upload the manifest files to an Amazon S3 bucket from where they can be downloaded to a mobile device.
To open the On-Device-Data Builder select the Tools/More.../On-device-data builder for TransForm/PhoneGap applications... menu item.
This will then open the builder, as shown in the image below.
The builder allows you to specify the data (i.e. files) you want to store on the mobile device. The builder allows you to define multiple item types of data. The available types are:
You can specify multiple files (you can use wildcard file specifications) that should be downloaded to a folder on your mobile device. The files are zipped into a single file to optimize download to the mobile device and then are unzipped on the mobile device.
Similar to the Folder option, but allows you to select a single file that will be downloaded and stored in the target folder on your mobile device.
- SQLite database
A SQLite database. You can either specify the filename for a SQLite database file that already exists on your machine, or you can create the SQLite database by specifying one or more queries that extract data from SQL databases, web services, static data, etc.
The URL of some existing remote file that you want to download and store on the mobile device.
After you have defined all of the items in your manifest, you can save your definition by clicking the Save button. The settings are saved in a file in the Web Projects folder. You can then click the Generate manifest files button. This button will create the SQLite database files (if you specified that the SQLite database file should be created by executing queries) and it will create the necessary zip files (for example, for the Folder item type, all of the specified files are zipped into a single zip file).
After the manifest files are uploaded you can click the Show manifest URL/JSON to see the manifest URL and the actual JSON data in the manifest.
Before you can upload manifest files to S3 you must first click the Define S3 Properties hyperlink to define properties of the S3 bucket where your manifest files will be uploaded. You must specify the storage connection string that points to your S3 bucket (go to Tools, Storage connection strings when the Web Control Panel has focus) and the folder within this bucker where the manifest files should be uploaded.