https://github.com/alttch/evahi
Universal, customizable android app template for web-based interfaces
https://github.com/alttch/evahi
android app mobile mobile-app mobile-development template web-view web-viewer
Last synced: 3 months ago
JSON representation
Universal, customizable android app template for web-based interfaces
- Host: GitHub
- URL: https://github.com/alttch/evahi
- Owner: alttch
- License: apache-2.0
- Created: 2019-02-12T18:23:14.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-09-05T15:08:03.000Z (almost 3 years ago)
- Last Synced: 2025-07-03T02:04:07.306Z (about 1 year ago)
- Topics: android, app, mobile, mobile-app, mobile-development, template, web-view, web-viewer
- Language: Java
- Homepage:
- Size: 13.4 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
What is evaHI?
--------------
evaHI is Android application template which allow you to quickly build custom
Android app viewer for your mobile web application.
Why do I need this?
-------------------
Of course, users can just open your web application via mobile web browser.
But evaHI provides additional features:
* Your web-app will look as cool as any native Android app and your custom
viewer app can be added to Google Play Store
* You can hard-code connection parameters of your web-app or users can quickly
configure it with QR codes
* The app can automatically pass basic authentication forms
* The app provides native navigation menu with custom icons and menu labels
* Icons, menu labels and target URLs can be changed dynamically on your web-app
server so users don't need to download application updates again and again
* The app can switch URLs depending is current device mode portrait or
landscape
Looks cool. How can I build my own app?
---------------------------------------
Customize app source:
* Download evaHI source (git clone https://github.com/alttch/evaHI)
* Edit prepare.ini file
* Run ./prepare -D
* Build your app with Android Studio or other Android build tool
How can I customize launcher icons?
-----------------------------------
You may either place own icons to /app/src/main/res or use
*--icon* and *--icon-round* (both must be specified) options for *prepare*
script.
Create configuration file on your web server
--------------------------------------------
* Create .evahi directory in your web server http root
* Put there the following configuration file. The file should be named
config.yml, config.yaml or config.json (if JSON format is used)
```yaml
serial: 1
index: /index.html
index_landscape: /landscape.html
home_icon: h.jpg
menu:
- {icon: pages/page1.png, name: Page 1, url: /page1.html}
- {icon: pages/contacts.png, name: Contacts, url: /contacts.html}
```
All icons should be placed in /.evahi/icons/ dir and have relative paths in
app configuration.
The app caches configuration settings and icons, but reloads them if **serial**
field is increased.
Configuration QR codes
----------------------
User can scan QR codes with settings to quickly configure the app. QR code
format is:
scheme:https|address:yourserver.com|port:443|user:test|password:123
Fields _user_ and _password_ are optional.
Authentication
--------------
evaHI sends username/password only if basic authentication is set up. However,
your web application may detect evaHI client (checking HTTP *User-Agent* =
'evaHI ...' header) and ask it to provide authentication credentials returning:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic realm="?"
The client will repeat HTTP request with authentication headers included.
Any examples?
-------------
Our [EVA ICS](https://www.eva-ics.com/) Control Center Android app is fully
evaHI-based.
source: https://github.com/alttch/evacc/
app: https://play.google.com/store/apps/details?id=com.altertech.evacc