-------------------------------------------------------------------------------
Dojo Storage
-------------------------------------------------------------------------------
Version X.XXX (does not have separate versioning -- versioned by release date)
Last Release date: March 2008
-------------------------------------------------------------------------------
Project state:
experimental
-------------------------------------------------------------------------------
Credits
Brad Neuberg
Alex Russell
-------------------------------------------------------------------------------
Project description
dojox.storage provides a JavaScript abstraction for persistent storage
as well as pluggable implementations which typically use native browser extensions
(e.g. Flash player, Gears)
-------------------------------------------------------------------------------
Dependencies:
FlashStorageProvider requires the Flash player
GearsStorageProvider requires the Gears extension
The various Air*StorageProviders require Adobe's AIR software
The open source mtasc compiler (www.mtasc.org) is needed to build the
ActionScript into SWF format. The SWF object is maintained within svn, so
this step is only necessary if Storage.as is modified. A sample build script
is provided (buildFlashStorage.sh)
-------------------------------------------------------------------------------
Documentation
See http://manual.dojotoolkit.org/WikiHome/DojoDotBook/Book50 for the
authoritative Dojo Storage docs.
See dojox/storage/demos/helloworld.html for a simple Hello World example
you can base your code off of.
-------------------------------------------------------------------------------
Installation instructions
If you want to use Dojo Storage in a web browser:
These installation instructions are to use Dojo Storage in a web browser; at
runtime, Dojo Storage will autodetect and use the best available storage
option. This includes:
* Google Gears
* HTML 5 Web Browsers (Firefox 2+)
* Hidden Flash
If you are using a release build (if you downloaded Dojo from the Dojo
website then this is a release build -- if you checked it out from
Subversion yourself then you will have to build things yourself), if you
only want to grab just the files from Dojo to use Dojo Storage
in the browser, take the following (but make sure to keep the directory
layout the same, or else things won't work correctly!):
* dojo/dojo.js
* dojox/storage/storage-browser.js
* dojox/storage/Storage.swf
To help with testing and development and to make sure you have everything
right, its also useful to grab the following files:
* dojox/storage/README
* dojox/storage/demos/helloworld.html
If you want to use Dojo Storage with Adobe AIR:
[TBD! Why don't you write this and contribute!]
-------------------------------------------------------------------------------
Additional Notes
8398c9048d