Changeset 26521
- Timestamp:
- 2012-11-27T04:13:25+13:00 (11 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
gs3-extensions/i-jetty/trunk/src/README.txt
r25768 r26521 26 26 Having sourced the setup file the two main steps are: 27 27 28 1) Install i-jetty 28 1) Install i-jetty on the Android device 29 29 30 2) Install Greenstone3 as a web-app 31 (converting any jar and class files to DEX format) 30 2) Install Greenstone3 as a web-app application on Andoird device 32 31 33 The first step typically only needs to be done once. The second step is 34 composed of three sub-steps, and may require the last two sub-steps to 35 be repeated if the Java code has been modified. 32 The first step typically only needs to be done once. 33 34 35 The key task for the second step is to transfer greenstone3's "web" 36 directory to /sdcard/jetty/webapps/ on the Android device. In 37 principle that would be: 38 39 <GSDL3SRCHOME>/web -> <ANDROID-DEVICE>:/sdcard/jetty/webapps/greenstone3 40 41 However we need to convert all the Java code (which lurks in Jar 42 files) in the "web" folder into DEX-byte-code equivalents first. We 43 therefore break this step of the installation down into sub-steps (see 44 below). In overview, we create a "webapps" folder in the *extension* 45 folder, where we copy the static file content of "web" to (i.e., the 46 non-Java stuff). We then top that up with Dexified versions of the 47 Java code. Finally the whole "webapps/greenstone3" folder in the 48 extensions area is copied over to the Android device. 49 36 50 37 51 Step 1 … … 70 84 -------- 71 85 72 Transfer the bulk of the <GSDL3SRCHOME>/web structure to the 73 <SDCARD>/ijetty/webapps/greenstone3 with: 86 Transfer the bulk of the <GSDL3SRCHOME>/web structure to the preparation 87 area "webapps" with the extension foler (i.e., where you are running these 88 scripts from) with: 74 89 75 76 WEBAPP-ROOT-TO-SDCARD.sh 90 ./PREPARE-WEBAPPS-GREENSTONE-ROOT-FOR-IJETTY.sh 77 91 78 92 This script skips any .svn files if present. It also skips installing 79 'localsite' as this is rather large -- both in size and in terms of 80 the number of files invovled -- so copying is rather slow, and it is 81 probably not what you want anyway. 82 93 the majority of 'localsite' as this can be rather large -- both in 94 size and in terms of the number of files invovled -- so copying is 95 rather slow, and it is probably not what you want anyway. Only the 96 'lucene-jdbm-demo' collection is copied to the preparation area. 97 Any other collections you wish to add should be manually added to 98 the "webapps/greenstone3/sites/localsite/collect/" area. 83 99 84 100 Step 2.2 … … 88 104 classs.dex with: 89 105 90 JAVA-TO-DEX.sh106 ./JAVA-TO-DEX.sh 91 107 92 The finished file, which is also by this point zipped up, is left in 93 the 'lib' folder. 108 The finished file, which is also by this point zipped up, is stored in 109 the 'lib' folder (should you wish to inspect it). It is also 110 automatically copied to "webapps/greenstone3/WEB-INF/lib" which is 111 where it needs to be to work when installed on the Android device. 94 112 95 113 … … 97 115 -------- 98 116 99 Copy classes.zip onto the Android's sd-card117 Copy Greenstone3's webapps folder onto the Android device's sd-card: 100 118 101 DEX-TO-SDCARD.sh119 ./IJETTY-PUSH.sh webapps/greenstone3 102 120 103 121 This is the final step in getting Greenstone3 setup on an Andoird. 104 122 Switch off the USB disk mode on the Android device. Note: it can take 105 a device minute or two "preparing" the sd-card. This can be seen 106 onthe notification view. Alternativey, if you try to start i-jetty123 a device minute or two "preparing" the sd-card. This can be seen on 124 the notification view. Alternativey, if you try to start i-jetty 107 125 before the card is ready, then i-jetty points this out, and offers you 108 126 a 'retry' button. … … 116 134 web-browser application. We've tested the built-in web browser, and 117 135 Mobile Firefox 4. 136 ==== 118 137 119 120 If the Java code to Greenstone3 is changed, then you need to repeat sub-steps 121 2.2 and 2.3 122 138 If the compiled Java code to Greenstone3 has changed, then you need to 139 repeat sub-steps 2.2 and 2.3. Transfering just the newly 140 dexified code can be achieved more quickly by entering: 141 142 ./IJETTY-PUSH.sh webapps/greenstone3/WEB-INF/lib 123 143 124 144 … … 131 151 support. 132 152 133 134 153 2. Due to a runtime (reflection) error, we had to modify xalan.jar. 135 The modified version of this file is also in the ' jars' folder136 used in this extension.154 The modified version of this file is also in the 'modified-jars' 155 folder used in this extension. 137 156 138 157
Note:
See TracChangeset
for help on using the changeset viewer.