From 83a20f3f0b35024855e64fb36cef01788027fc30 Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Tue, 16 Apr 2013 23:37:53 +0200 Subject: [PATCH 1/6] updated mobile hacking.md --- mobile/HACKING.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/mobile/HACKING.md b/mobile/HACKING.md index 3a7c2976..fdaa464f 100644 --- a/mobile/HACKING.md +++ b/mobile/HACKING.md @@ -1,7 +1,11 @@ How does this basically work? ----------------------------- -At the moment, the Android App is nothing more then a WebView which renders the normal web page. The IITC script is injected on page load and after this, it works the same way as on desktop browser. More functionality will be added soon... +At the moment, the Android App is a WebView which renders the normal web page. The IITC script is injected before page load and after this, it works the same way as on desktop browser. + +Communication from app to script is handled by loading Javascript function calls. For example: ```iitc_view.loadUrl("javascript: window.goBack();");``` + +Communication from script to app is handled by the JavascriptInterface (see /mobile/src/com/cradle/iitc\_mobile/IITC_JSInterface.java). If a method ```foo(String)``` is defined in JSInterface, it can be with by ```android.foo("Hello World")``` in the IITC script. Debugging --------- @@ -16,13 +20,8 @@ Debugging IITC(M) **before** it has booted requires the Android Developer Tools. Building the APK ---------------- -- **Eclipse:** Just import this project and klick the build button. - **ant:** Set the ANDROID_HOME environment variable: ```export ANDROID_HOME=/path/to/android_sdk``` - and build the project with ant: - `ant debug` -- You can use `build_mobile.js`, too, which builds IITC, compresses - it and uses ant to build a release APK of IITCM. It requires that - you have Python and uglifyjs installed. You need to set the - `ANDROID_HOME`, like explained above. + Then build the app via the build.py script ```./build.py mobile``` +- **Eclipse:** Just import this project and klick the build button. Ensure that you have iitc.js in your assets folder. This is automatically created, when executing ```./build.py mobile```. Otherwise, just copy the IITC script to the assets folder and rename it to iitc.js From 4ebade124527798cac06d3bee78221b2d0b30266 Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Tue, 16 Apr 2013 23:40:05 +0200 Subject: [PATCH 2/6] updated mobile readme --- mobile/README.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/mobile/README.md b/mobile/README.md index a12f1568..c57da39f 100644 --- a/mobile/README.md +++ b/mobile/README.md @@ -1,6 +1,4 @@ -ingress intel total conversion (IITC) +ingress intel total conversion mobile (IITCM) ===================================== -# [User documentation moved to the wiki. Please see there!](https://github.com/breunigs/ingress-intel-total-conversion/wiki/IITC-Mobile) - -### [For developer docs, please see HACKING.md](https://github.com/breunigs/ingress-intel-total-conversion/blob/gh-pages/mobile/HACKING.md) +### [For developer docs, please see HACKING.md](https://github.com/jonatkins/ingress-intel-total-conversion/blob/master/mobile/HACKING.md) From 88ee267c66933daff3a4adb1a8ab38fa6bb4fa9f Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Tue, 16 Apr 2013 23:48:12 +0200 Subject: [PATCH 3/6] updated HACKING.md --- mobile/HACKING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mobile/HACKING.md b/mobile/HACKING.md index fdaa464f..71a9449e 100644 --- a/mobile/HACKING.md +++ b/mobile/HACKING.md @@ -5,7 +5,7 @@ At the moment, the Android App is a WebView which renders the normal web page. T Communication from app to script is handled by loading Javascript function calls. For example: ```iitc_view.loadUrl("javascript: window.goBack();");``` -Communication from script to app is handled by the JavascriptInterface (see /mobile/src/com/cradle/iitc\_mobile/IITC_JSInterface.java). If a method ```foo(String)``` is defined in JSInterface, it can be with by ```android.foo("Hello World")``` in the IITC script. +Communication from script to app is handled by the JavascriptInterface (see /mobile/src/com/cradle/iitc\_mobile/IITC_JSInterface.java). If a method ```foo(String)``` is defined in JSInterface, it can be called by ```android.foo("Hello World")``` in the IITC script. Debugging --------- From b7329a611c67308fb86d5f64d031ef387136afdd Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Wed, 17 Apr 2013 00:00:56 +0200 Subject: [PATCH 4/6] updated mobile README.md --- mobile/README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/mobile/README.md b/mobile/README.md index c57da39f..24bed1fc 100644 --- a/mobile/README.md +++ b/mobile/README.md @@ -1,4 +1,22 @@ ingress intel total conversion mobile (IITCM) ===================================== +The Android App behaves like the desktop version, but uses the mobile view, which is optimized for mobile devices, as default. Furthermore, there are some nice additions: + +- it should be much faster than the standard mobile ingress intel map + +- a gmaps intent is sent, when a portals Map link is clicked (lets you navigate to portals) + +- a geolocate button (you have to enable GPS satellites + location access to use this feature) + +- toggle between desktop and mobile view (nice for tablets) + +- possibility to use a custom IITC script source + +- a click on Portal link copies it to clipboard + +- more features will be added soon... + +**The App only works with Android 4.0+** + ### [For developer docs, please see HACKING.md](https://github.com/jonatkins/ingress-intel-total-conversion/blob/master/mobile/HACKING.md) From acc0db1ce87528fb705047c195d3608efc4d8678 Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Wed, 17 Apr 2013 00:12:44 +0200 Subject: [PATCH 5/6] one more update for HACKING.md --- mobile/HACKING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mobile/HACKING.md b/mobile/HACKING.md index 71a9449e..cfa2a9ae 100644 --- a/mobile/HACKING.md +++ b/mobile/HACKING.md @@ -1,7 +1,7 @@ How does this basically work? ----------------------------- -At the moment, the Android App is a WebView which renders the normal web page. The IITC script is injected before page load and after this, it works the same way as on desktop browser. +At the moment, the Android App is a WebView which renders the normal web page. The IITC script is injected by calling the ```iitc_view.loadIITC_JS(Context)```. The app uses a local version of the script, which is located in the assets folder, if no external source is given (see "pref\_iitc\_source"). Communication from app to script is handled by loading Javascript function calls. For example: ```iitc_view.loadUrl("javascript: window.goBack();");``` From 901d30287ac2082dc40d66f94b83799756479c65 Mon Sep 17 00:00:00 2001 From: Philipp Schaefer Date: Wed, 17 Apr 2013 00:13:39 +0200 Subject: [PATCH 6/6] fixed typo --- mobile/HACKING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mobile/HACKING.md b/mobile/HACKING.md index cfa2a9ae..76d8d54e 100644 --- a/mobile/HACKING.md +++ b/mobile/HACKING.md @@ -1,7 +1,7 @@ How does this basically work? ----------------------------- -At the moment, the Android App is a WebView which renders the normal web page. The IITC script is injected by calling the ```iitc_view.loadIITC_JS(Context)```. The app uses a local version of the script, which is located in the assets folder, if no external source is given (see "pref\_iitc\_source"). +At the moment, the Android App is a WebView which renders the normal web page. The IITC script is injected by calling ```iitc_view.loadIITC_JS(Context)```. The app uses a local version of the script, which is located in the assets folder, if no external source is given (see "pref\_iitc\_source"). Communication from app to script is handled by loading Javascript function calls. For example: ```iitc_view.loadUrl("javascript: window.goBack();");```