| Storage Example |
| |
| The StorageExample is designed to show you have to read and write simple, but permanent files using |
| the Royale Storage framework. |
| |
| Permanent storage is available when the target platform is either Adobe AIR (desktop or mobile device) |
| or Apache Cordova (mobile devices). |
| |
| Build the Example |
| |
| 1. Run the build (ant) |
| |
| This will build both the AIR and Cordova-compatible versions. The AIR version will be in the |
| bin-debug directory. The Cordova-compatible versions will be in the js-debug and js-release |
| directories. |
| |
| Running on Adobe AIR |
| |
| 1. Run the example (ant run). |
| |
| This will launch the SWF as an AIR application. |
| |
| Running on an Android Device using Cordova |
| |
| This is a somewhat complex process. The JavaScript and HTML files that were built (bin/js-debug) |
| need to be moved into a Cordova project. Once there, the application can be deployed to a device |
| or run in an emulator. |
| |
| 1. In a clean directory, outside of the royale-asjs directories, use the cordova command line |
| interface to build an empty application: |
| |
| cordova create filetest org.apache.flex "FileTest" |
| cd filetest |
| |
| 2. Add in the Android platform and the Cordova File plugin: |
| |
| cordova platform add android |
| cordova plugin add cordova-plugin-file |
| |
| 3. Go to the StorageExample/bin/js-debug directory and copy all of the files and directories |
| into the filetest/www directory: |
| |
| index.html (replaces the index.html from the generated cordova app) |
| MyInitialView.js |
| StorageExample.css |
| StorageExample.js |
| externs/ |
| library/ |
| models/ |
| org/ |
| |
| |
| 4. Open filetest/www/index.html and replace the <body> element with this: |
| |
| <body onload="startup()"> |
| <script type="text/javascript" src="cordova.js"></script> |
| <script type="text/javascript"> |
| function startup() { |
| document.addEventListener('deviceready', this.onDeviceReady, false); |
| } |
| function onDeviceReady() { |
| new StorageExample().start(); |
| } |
| </script> |
| </body> |
| |
| |
| 5. Build the Cordova app from the top filetest directory: |
| |
| cordova build |
| |
| 6. You can run it either in an emulator on a connected device: |
| |
| (emulator): cordova emulate android |
| (device): cordova run android |
| |
| The filetest/platforms/android directory can be opened from Android Studio if you want to |
| use an Android IDE. If you need to make changes, do that in the filetest/www directory, |
| then run "cordova build" again. Android Studio will detect the change, ask you to re-sync, |
| and after that, you can re-redeploy the changed app to the device. |
| |
