77 lines
2.8 KiB
Text
77 lines
2.8 KiB
Text
|
-------------------------------------------------------------------------------
|
||
|
|
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
|