1 | TIPPLE README
|
---|
2 | -------------
|
---|
3 |
|
---|
4 | 1. SVN checkout this URL to somewhere (from now on I will call this "somewhere" the "root" dir):
|
---|
5 | http://svn.code.sf.net/p/tipplesummer/code/trunk/
|
---|
6 |
|
---|
7 | The layout of the folder you checked out is as follows:
|
---|
8 | tipple-lib (main Tipple library)
|
---|
9 | OBSOLETE/tipple-networked (old, probably don't want to use this)
|
---|
10 | tipple-standalone (main implementation of Tipple that references tipple-lib)
|
---|
11 | osmosis (plugin to create your own 2D map files for Tipple, see PDF file "mapsforge-getting-started.pdf" inside this folder)
|
---|
12 | mixare-fixes (optional fixes for Mixare)
|
---|
13 | i-greenstone-server-files (things for i-greenstone-server)
|
---|
14 |
|
---|
15 | 2. Assuming you have at least Android 2.3.3 SDK installed, import into Eclipse the folders
|
---|
16 | tipple-lib, tipple-standalone
|
---|
17 |
|
---|
18 | 3. Edit setup.sh if necessary in order to put the Android SDK "platform-tools" folder
|
---|
19 | on the classpath, then type into cygwin terminal:
|
---|
20 |
|
---|
21 | source setup.sh
|
---|
22 |
|
---|
23 | 3. Unzip/untar "mixare-development" into the same directory as mixare-fixes.sh, and
|
---|
24 | rename it to "mixare".
|
---|
25 |
|
---|
26 | (Latest repo of Mixare is probably here, in case you do want to work with the latest version:
|
---|
27 | https://github.com/DevBinnooh/mixare)
|
---|
28 |
|
---|
29 | 4. In the root directory of trunk, execute this .sh script in your cygwin terminal by typing:
|
---|
30 |
|
---|
31 | ./mixare-fixes.sh
|
---|
32 |
|
---|
33 | 5. Launch Eclipse, and import:
|
---|
34 | mixare (this requires you to select "mixare/" in the import projects window)
|
---|
35 | mixare-lib (this requires you to select "mixare/plugins" in the import projects window)
|
---|
36 |
|
---|
37 | (If Eclipse complains about one of these projects not having a "res" folder, just create
|
---|
38 | a blank folder called "res" for the project in Eclipse)
|
---|
39 |
|
---|
40 | Within Eclipse, run as "Android Application" the mixare project (not mixare-lib).
|
---|
41 | This will install it onto your phone. Now with that done, the only thing left
|
---|
42 | to do is run as "Android Application" the project:
|
---|
43 |
|
---|
44 |
|
---|
45 | 6. Type into cygwin terminal (with Android device connected with USB):
|
---|
46 |
|
---|
47 | adb install i-greenstone-server-files/i-jetty-3.1-aligned.apk
|
---|
48 |
|
---|
49 | This will install i-greenstone-server on your phone. Then launch the
|
---|
50 | application at least once and wait for it to set itself up.
|
---|
51 |
|
---|
52 | Then do:
|
---|
53 |
|
---|
54 | adb push i-greenstone-server-files/greenstone/webapps/greenstone3/sites/localsite/collect/tipple-universe /sdcard/greenstone/webapps/greenstone3/sites/localsite/collect/tipple-universe
|
---|
55 |
|
---|
56 | (For the sake of being conservative, I have given you my own development files to push over. If you want to
|
---|
57 | start from scratch and compile your own i-greenstone-server and generate your own "latest and greatest" GS3
|
---|
58 | webapp on it, then I suggest you check out on the Greenstone SVN the extensions "i-greenstone-server" and
|
---|
59 | "android-war", found in the folder "gs3-extensions".)
|
---|
60 |
|
---|
61 | 7. Open i-greenstone-server, and click "Start Greenstone".
|
---|
62 |
|
---|
63 | 8. In Eclipse, run "Tipple" (not "Tipple Library") as an Android application, and hopefully everything works out!
|
---|
64 |
|
---|
65 | (You will see one marker on campus with the i-greenstone-server turned on, and you'll see six markers with the pre-built hamilton.loc XML file.
|
---|
66 | If you change your GPS location to Whangarei (i.e. with a fake GPS application) you should see more!)
|
---|
67 |
|
---|
68 | If not, immediately shoot me an email at [email protected]. Do not hesitate!
|
---|
69 |
|
---|
70 |
|
---|
71 | ADDITIONAL INFORMATION
|
---|
72 | ----------------------
|
---|
73 |
|
---|
74 | - I have included a folder with the Tipple SVN called "osmosis", if you are
|
---|
75 | interested in building your own .map file for Tipple. Because I had issues
|
---|
76 | with the latest version of Osmosis, I put on SVN the version of Osmosis
|
---|
77 | I used + a saved version of the "getting started" webpage as a PDF. You only
|
---|
78 | really need to use the "getting started" PDF in order to find out how to install
|
---|
79 | the Mapsforge plugin for Osmosis. Once you have the Mapsforge plugin installed, go to osmosis/bin
|
---|
80 | and look at the example compile.bat I have created in order to generate your
|
---|
81 | own .map file.
|
---|
82 |
|
---|
83 | - Even if the GPS is turned on and you turn on AR View (Mixare) in Tipple, it may
|
---|
84 | say something like "Connection error occured - please make sure you are connected
|
---|
85 | to internet" or something like that. You just have to keep hitting "Retry" until it
|
---|
86 | works (it will disappear when Mixare gets a GPS location fix).
|
---|
87 |
|
---|
88 | - When you query from i-greenstone-server, all "locations" have the same marker radius, which is
|
---|
89 | actually quite big. This is because originally my articles in the collection "tipple-universe"
|
---|
90 | did not have the "Radius" metadata in them. So if you put a "Radius" metadata in an article,
|
---|
91 | my GreenstoneXMLRetriever.java should map that to "radius", as long as you remove
|
---|
92 | the exact line I used to hardcode the radius.
|
---|
93 |
|
---|
94 | BUGS
|
---|
95 | ----
|
---|
96 |
|
---|
97 | - i-greenstone-server may randomly stop hosting sometimes. Logcat logs indicate
|
---|
98 | the OS is trying to get rid of it. Or maybe it's a problem I caused. Definitely look into this.
|
---|
99 |
|
---|
100 | - Whenever Tipple removes all the markers and displays new ones (i.e. when your location has
|
---|
101 | changed sufficiently), if you go into one of the new locations and the phone vibrates, you
|
---|
102 | won't see the yellow marker with the '+' symbol telling you you're currently in this location.
|
---|
103 |
|
---|
104 | -------
|
---|
105 | CONTACT
|
---|
106 | -------
|
---|
107 |
|
---|
108 | If you are confused about any of this or want more info, do not hesitate to email me at:
|
---|
109 | [email protected] |
---|