Skip to content

Latest commit

 

History

History
241 lines (169 loc) · 8.6 KB

README.md

File metadata and controls

241 lines (169 loc) · 8.6 KB

Volkszaehler Frontend for Android

App Language: english, deutsch
(English description below)

Download: https://github.com/volkszaehler/app-android/releases/latest

ScreenShot1 ScreenShot2 ScreenShot3 ScreenShot4

VolkszählerApp für Android, Version 0.9.7

Funktionen:

  • Abrufen der Channelinformationen und Anzeige der letzten Werte
  • Anzeigen von Details zu jedem Channel
  • Tabellarische Ansicht der Verbrauchswerte
  • Anzeigen von Charts zu einzelnen Channels, incl. Zoom, auch mit „Touch and Move“ im Diagramm
  • Anzeigen von Gruppen-Charts und Hinzufügen weiterer Graphen ist möglich ("Long Touch" im Chart)
  • Unterstützung von Basic Authentication und HTTPS, ABER das Zertifikat wird nicht wirklich geprüft , es werden auch ungültige oder Man-in-the-Middle-Zertifikate akzeptiert
  • Einstellungen können (z.B. vor einem Update) gesichert und (nach dem Update/Neuinstallation) wieder eingespielt werden

Benötigte Android Berechtigungen:

  • android.permission.INTERNET für den Zugriff auf die Volkszähler-Installation
  • android.permission.WRITE_EXTERNAL_STORAGE für das Schreiben (und Lesen) des Backups

Tipps zum Clonen von Github in AndroidStudio (nur für Entwickler):

Wenn das Clonen bzw. das Öffnen des Projektes wegen eines ausgegrauten "Use default gradle wrapper (not configured for the current project)" nicht möglich ist, dann

  • das Projekt nochmal normal als "Open an existing Android Studio project" öffnen und im "Gradle Sync" Dialog einfach OK klicken
  • Wenn nötig unter Settings => Version Control das "Unregistered Root" auswählen und auf das grüne "+" klicken, fertig

English:

VolkszaehlerApp for Android, Version 0.9.7

Features:

  • Download of Channel Information and Display of recent Values
  • Shows Details for all Channels
  • Shows Values in TableView
  • Shows Charts for every Channel, supports Zoom, (Touch and Move)
  • Shows Charts of Groups, it is possible to add further graphs (use "Long Touch" in chart screen)
  • Supports Basic Authentication und HTTPS, BUT the certificate is not really checked, the app accepts also invalid or Man-in-the-Middle certificates
  • Settings can be saved (e.g. before updating) and can be restored (after the Update/Re-installation)

Needed Android Permissions:

  • android.permission.INTERNET for accessing the Volkszaehler installation
  • android.permission.WRITE_EXTERNAL_STORAGE for writing (and reading) of settings backups

Tips for Cloning from Github in AndroidStudio (only for developers):

If the cloning resp. opening of the project fails due to a grayed "Use default gradle wrapper (not configured for the current project)", then

  • open the Project again as "Open an existing Android Studio project" and clock "OK" in the "Gradle Sync" Dialog
  • If necessary, choose the "Unregistered Root" in Settings => Version Control and click the green plus "+"

Version history:

Version 0.9.7

New

  • Asks for Permission to store/read backups (starting with Android 6)

Fixed

  • Backups work also with Android 6 and newer (#38)

Changed

  • Backup file is stored in download folder now
  • small optimizations

Version history:

Version 0.9.6

New

  • Custom time ranges can be selected now for table view. Please note, the larger the time range the imprecise the values are, especially the Min and Max values. 'Grouping' makes it faster, but increases the imprecision even more.

Fixed

  • Costs are not correctly displayed in table view when type 'water' is used (#36)

Changed

  • small optimizations

Version 0.9.5

Changed

  • When reading the channels the very first time all channels are checked by default (#32)

Version 0.9.4

New

  • now 3 Sorting modes: Off, Sorting of Channels in Groups, or Sorting all Channles independend of Groups (#29)
  • the backup of settings now also saves the "checked state" of the channels

Fixed

  • small bugs

Changed

  • Sorting of channels now also for Popup in chart view (#30)
  • small optimizations

Version 0.9.3

New

  • Channels can be sorted in Preferences, channels must be relaoded once after changing the preference

Fixed

  • error message in table view for groups (there is no table view for groups)

Changed

  • small optimizations, Colors in table view, naming

Version 0.9.2

New

  • new TabelView of Values

Fixed

  • fixed display issues with Channel of type "heat" and consumption

Changed

  • small optimizations

Version 0.9.1

Fixed

  • fixed style issues with Android 7 (#21)
  • fixed unhandled UnknownHostException (#22)

Changed

  • better styles for date dialog in chartview

Version 0.9.0

Fixed

  • fixed exception "Getting data is not supported for groups"

Changed

  • ChartEngine update

Version 0.8.9

New

  • Private channels can be manually added in preferences, if there are more than one, add them comma separated like uuid1,uuid2,uuid3

Fixed

  • better error handling, works with older Volkszaehler version now

Changed

Version 0.8.8

New

  • It is now possible to have several graphs in one chart, use "Long Press" in chart view, Limitation: there is only one y-Axis
  • ChannelDetails show now the total value if an initial value is set for the channel
  • Number of Tuples can be set now (default is 1000), a higher number makes the Charts more detailled (as long as there are enough values in the database), but slows down the charts

Fixed

  • fixed display issues with Channels of type "water" and costs

Changed

  • small optimizations

Version 0.8.7

Fixed

  • ChannelInfo popup can't be closed when clicking twice or more

Changed

  • changed image URLs in README.md to match the new Wiki image URL pattern

Version 0.8.6

Fixed

  • empty Channel Color causes crash
  • Umlauts in host name cause crash

Version 0.8.5

Changed

  • Extended Chart Details Dialog
  • Improved Chart, especially when using Groups
  • Buttons instead of Text in Details
  • Completed README.md, removed history.txt
  • small improvmenets

Fixed

  • Consumption and Cost values in ChartDetails Dialog visible again, also fixed for "Gas" channel
  • Unit correctly displayed now with Channels from Group
  • Chart-Range keeps the same after orientation change
  • Details now can be scrolled

Version 0.8.4

Changed

  • improved logging

Fixed

  • No Costs in Chart Details for type "gas"
  • Mixed decimal format in Chart Details
  • Now graph skipped when no data in time range, useful especially with empty channel in groups

Version 0.8.3

New

  • Backup/Restore of Settings

Changed

  • Details background not transparent anymore

Fixed

  • Calculation and display of costs in Details dialog

Version 0.8.2

Changed

  • Date/Time selection dialog

Fixed

  • Cost for power meters no correct in "Channel Details"
  • Some small fixes and optimizations

Version 0.8.1

New

  • Group support
  • Several lines in one chart (when using groups)
  • Start and end date/time can be set to define a range to display in chart
  • Automatic reload can be configured

Changed

  • Chart info now when clicking on the graph line

Fixed

  • Single touch in chart doesn't cause zoom anymore, 50px move is necessary to zoom
  • "About" is now translated in German version
  • From/to translated below chart
  • Some small fixes

Version 0.8.0

New

  • Initial BETA version