source: gs3-extensions/i-greenstone-server/trunk/src/README.txt@ 26683

Last change on this file since 26683 was 26683, checked in by davidb, 11 years ago

Introduced COMPILE.sh to tidy up on how the i-jetty source code is compiled and the final apk file moved to the top-level directory. Changes made to README.txt to reflect this

File size: 2.1 KB
Line 
1
2This extension was developed under Cygwin on Windows. It has not be tested
3on any other OS.
4
5Start by sourcing the developer setup file:
6
7 source ./devel.bash
8
9 Note: For now the easiest thing to do is to first of all edit
10 JAVA_HOME, ANDROID_SDK_HOME in this file and change to valid values
11 for your environment
12
13Then run in order:
14
15
16 ./RESET.sh
17
18 ./CUSTOMIZATION.sh
19
20 ./REBRAND.sh
21
22 ./COMPILE.sh
23
24This should compile i-greenstone-server and create an APK file in the top-level folder.
25Then, assuming you have an Android phone connected through USB, you would run the command:
26
27 adb install i-jetty-3.1-aligned.apk
28
29Notes:
30
31 When multiple devices are connected use 'adb devices' to view their serial IDs
32 and 'adb -s ID install ...' to select the device to install on.
33 ====
34
35 This extension comes with a "pre-bundled" Greenstone3 web-apps (war file) located at:
36 <GSDL3SRCHOME>/ext/i-greenstone-server/CUSTOMIZATION/assets/
37 suitable configured for Android -- but it may not be the latest and greatest version
38 of Greenstone3. If you want to create your own (i.e. suppose you want to pre-bundle
39 your own collections, etc.) then you should SVN checkout the "android-war" extension
40 (one-level up from where this README file is) and follow the README.txt in the
41 newly checked out extension.
42 ====
43
44 ./RESET.sh when run the first time will untar the i-jetty-src tarball
45 Subsequently running this will first delete the i-jetty-src folder,
46 followed by untarring the provided tarball.
47 ====
48
49 If you are behind a proxy, change the conf/settings.xml in maven folder:
50
51 <proxies>
52 <!-- proxy
53 | Specification for one proxy, to be used in connecting to the network.
54 |
55 <proxy>
56 <id>optional</id>
57 <active>true</active>
58 <protocol>http</protocol>
59 <username>proxyuser</username>
60 <password>proxypass</password>
61 <host>proxy.host.net</host>
62 <port>80</port>
63 <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
64 </proxy>
65 -->
66 </proxies>
67
68 For CMS:
69 proxy.cms.waikato.ac.nz
70 port 3128
71 ====
72
73
74
Note: See TracBrowser for help on using the repository browser.