Release: v3.22.0

Bugfix: running sensor data total is distance is UINT_32.
New field for recording layout: clock.
2021-11-14 21:28:31 +01:00 · 2021-11-14 21:20:24 +01:00 · 2021-11-14 16:27:37 +01:00 · 2021-11-13 20:10:19 +01:00 · 2021-11-13 20:07:32 +01:00 · 2021-11-11 08:50:24 +01:00
580 changed files with 66409 additions and 21125 deletions
@@ -0,0 +1,34 @@
+#https://github.com/marketplace/actions/android-emulator-runner
+name: Build nightly
+on: [ push ]
+
+jobs:
+  nightly-build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2.4.0
+
+      - uses: actions/setup-java@v2
+        with:
+          distribution: 'adopt'
+          java-version: '11'
+
+      - name: Assemble nighlty APK
+        shell: bash
+        run: |
+          echo ${NIGHTLY_STORE_FILE} | base64 -d > KEY_NIGHTLY.jks
+          ./gradlew assembleNightly -Dnightly_store_file=KEY_NIGHTLY.jks -Dnightly_store_password="${NIGHTLY_STORE_PASSWORD}" -Dnightly_key_alias="${NIGHTLY_KEY_ALIAS}" -Dnightly_key_password="${NIGHTLY_STORE_PASSWORD}"
+        env:
+          NIGHTLY_STORE_FILE: ${{ secrets.NIGHTLY_STORE_FILE }}
+          NIGHTLY_STORE_PASSWORD: ${{ secrets.NIGHTLY_STORE_PASSWORD }}
+          NIGHTLY_KEY_ALIAS: ${{ secrets.NIGHTLY_KEY_ALIAS }}
+
+      - name: Archive
+        if: always()
+        uses: actions/upload-artifact@v2
+        with:
+          name: OpenTracks-nightly.apk
+          path: ./build/outputs/apk/nightly/*.apk
+          retention-days: 7
+
@@ -1,34 +0,0 @@
-name: "CodeQL"
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-  schedule:
-    - cron: '0 6 * * 1'
-
-jobs:
-  analyse:
-    name: Analyse
-    runs-on: ubuntu-latest
-
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v2
-      with:
-        fetch-depth: 2
-
-    - run: git checkout HEAD^2
-      if: ${{ github.event_name == 'pull_request' }}
-
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v1
-      with:
-        languages: java
-
-    - run: |
-       ./gradlew build
-
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v1
@@ -0,0 +1,19 @@
+name: Linting
+
+on: [ push ]
+
+jobs:
+  analyse:
+    name: Analyse
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2.4.0
+
+      - uses: actions/setup-java@v2
+        with:
+          distribution: 'zulu'
+          java-version: '11'
+
+      - run: ./gradlew lint
@@ -1,21 +1,37 @@
 #https://github.com/marketplace/actions/android-emulator-runner
 name: Test
-on: [push, pull_request]
+on: [ push ]
 jobs:
  test:
+    timeout-minutes: 45
    runs-on: macos-latest
    strategy:
      matrix:
-        api-level: [29]
-        target: [default]
+        api-level: [ 23, 26 ] #TODO Re-enable 29
+        target: [ default ]
    steps:
      - name: checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v2.4.0
+
+      - uses: actions/setup-java@v2
+        with:
+          distribution: 'zulu'
+          java-version: '11'

      - name: run tests
-        uses: reactivecircus/android-emulator-runner@v2
+        uses: reactivecircus/android-emulator-runner@v2.21.0
        with:
          api-level: ${{ matrix.api-level }}
          target: ${{ matrix.target }}
          arch: x86_64
+          profile: Nexus 6
          script: ./gradlew connectedCheck
+
+      - name: Archive
+        if: always()
+        uses: actions/upload-artifact@v2
+        with:
+          name: code-coverage-report
+          path: build/reports/androidTests/
+          retention-days: 7
+
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_1_8" default="true" project-jdk-name="1.8" project-jdk-type="JavaSDK">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_11" default="true" project-jdk-name="1.8" project-jdk-type="JavaSDK">
    <output url="file://$PROJECT_DIR$/build/classes" />
  </component>
  <component name="ProjectType">
    <option name="id" value="Android" />
  </component>
-</project>
+</project>
@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="RunConfigurationProducerService">
-    <option name="ignoredProducers">
-      <set>
-        <option value="org.jetbrains.plugins.gradle.execution.test.runner.AllInPackageGradleConfigurationProducer" />
-        <option value="org.jetbrains.plugins.gradle.execution.test.runner.TestClassGradleConfigurationProducer" />
-        <option value="org.jetbrains.plugins.gradle.execution.test.runner.TestMethodGradleConfigurationProducer" />
-      </set>
-    </option>
-  </component>
-</project>
@@ -47,63 +47,81 @@ _OpenTracks_ is a sport tracking application that completely respects your priva
        </td>
        <td></td>
    </tr>
+    <tr>
+        <td></td>
+        <td align="center">
+            <a href="https://www.amazon.de/dp/B09K2KNQ7X/">
+                <img alt="Get it on Amazon App Store" src="https://images-na.ssl-images-amazon.com/images/G/01/mobile-apps/devportal2/res/images/amazon-appstore-badge-english-white.png" height="40" align="middle">
+            </a>
+        </td>
+        <td></td>
+    </tr>
 </table>

-## Features:
+## Screenshots
+<div>
+    <img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot1.png">
+    <img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot2.png">
+    <img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot3.png">
+    <img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot4.png">
+</div>
+<div>
+	<img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot5.png">
+    <img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot6.png">
+	<img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot7.png">
+	<img width="23%" src="fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot8.png">
+</div>
+
+## Features
 * __Tracking:__ track your sport and outdoor activities
-* __Photos and Markers:__ mark interesting locations while tracking (also with photos)
+* __Voice announcements__
+* __Photos and Markers:__ mark interesting locations while tracking
+* __Export:__
+  * export tracks either as KMZ (incl. photos), KML, or GPX
+  * export automatically after each recording (e.g., to sync)
+  * avoid duplication: each exported file contain a random unique identifier (i.e., `opentracks:trackid`)
+* __Altitude:__
+  * gain/loss via barometric sensor (if present)
+  * shown in EGM2008 (above mean sea level); exported as WGS84
 * __Bluetooth LE sensors:__
  * heart rate
-  * cycling: speed and cadence
+  * cycling: speed and distance
+  * cycling: cadence
  * cycling: power meter
-* __Export data:__ export tracks either as KMZ (incl. photos), KML or GPX
-* __No Internet access:__ Internet is not used
-* __Voice announcements__
-* __No advertising__
-* __Privacy:__
-    * _does not contain any in-app analytics_
-    * _does not use Google Play Services_
-    * _has no cloud integration_
+  * running: speed and cadence
+  An overview of tested sensors: [README_TESTED_SENSORS.md](README_TESTED_SENSORS.md)

-__Only required permissions:__
+### Gadgetbridge integration
+
+OpenTracks can be used with [Gadgetbridge](https://www.gadgetbridge.org/):
+* shows statistics via notification on smart watches (requires Gadgetbridge 0.56.1 or later), and
+* Gadgetbridge's GPX exporter generates `opentracks:trackid` to avoid duplication (Gadgetbridge 0.53.0 or later).
+
+### Privacy
+* __No Internet access:__ Internet is not used
+* __No advertising__
+* __No in-app analytics__
+* __No use of Google Play Services__
+
+__Only required permission:__
 * _ACCESS_FINE_LOCATION_: required to use the GPS.

 An overview of Bluetooth LE sensors that are known to work with OpenTracks is in [README_TESTED_SENSORS.md](README_TESTED_SENSORS.md).

-_Please note:_
-_OpenTracks_ does not contain a _map_ (as this would require internet access).
-
-## Custom Dashboards (incl. Map)
-As of v3.3.1 OpenTracks enables to use custom dashboards.
+## Custom Dashboards (incl. map)
+As of v3.3.1, OpenTracks supports custom dashboards.
 The reference implementation is [OSMDashboard](https://github.com/OpenTracksApp/OSMDashboard), which presents an OpenStreetMap map (showing the current track, incl. updates).
 The developer documentation is in [README_API.md](README_API.md).

-Alternatively, recorded tracks can be shared as KMZ/GPX to installed applications (e.g., [OsmAnd](https://play.google.com/store/apps/details?id=net.osmand)).
+Alternatively, recorded tracks can be shared as KMZ/GPX with installed applications (e.g., [OsmAnd](https://play.google.com/store/apps/details?id=net.osmand)).
 However, this is rather slow and does not provide updates while recording.

-
-## Screenshots
-<div>
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_1.png">
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_2.png">
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_3.png">
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_4.png">
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_5.png">
-</div>
-<div>
-	<img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_6.png">
-    <img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_7.png">
-	<img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_8.png">
-	<img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_9.png">
-	<img width="18%" src="fastlane/metadata/android/en-US/phoneScreenshots/screenshot_10.png">
-</div>
-
 ## Project history

 _OpenTracks_ is based upon Google _My Tracks app_ ([code](https://code.google.com/archive/p/mytracks/)).
 Initially, _My Tracks_ was initially released by Google in 2010 as [open-source software](http://google-latlong.blogspot.fr/2010/05/code-for-my-tracks-is-now-yours.html).
 In 2016, [Google decided to discontinue](https://support.google.com/maps/answer/6333516) _My Tracks_ and stopped distributing it via the Google Play store in April 2016.
-The [Plonk42](https://github.com/plonk42) conducted some maintenance work until 2016, so _My Tracks_ could still be used (based upon version _Google's MyTracks_ version 2.0.6).
+Then [Plonk42](https://github.com/plonk42) conducted some maintenance work until 2016, so _My Tracks_ could still be used (based upon version _Google's MyTracks_ version 2.0.6).
 Plonk42's version is available [here](https://github.com/Plonk42/mytracks).
 In 2019, _OpenTracks_ was forked from Plonk42's _My Tracks_ and major rework was conducted.

@@ -116,7 +134,7 @@ Rework of _OpenTracks_ included:
 * removing calorie estimation and activity estimation,
 * removing support for ANT+ and Classic Bluetooth,
 * adding support for Bluetooth LE heart rate sensors,
-* removing Protobuf (store sensosensorr data in SQLite columns directly), and
+* removing Protobuf (store sensor data in SQLite columns directly), and
 * removing Android Service API for other apps.

 Artwork, logos and user interface remained more or less unchanged.
@@ -28,9 +28,10 @@ Requirement: `gem install fastlane`
   (requires keystore)
 2. Upload signed apk to [Google Play Console](https://play.google.com/apps/publish)
 3. Update store meta data (e.g., description and screenshots)
-   `fastlane supply --version_code VERSION_CODE --skip_upload_apk`
-   (use the version code from the manifest)
-   (requires API key)
+   `fastlane metadata`
+   (requires API key configured in `Appfile`)
+
+Supported languages: https://support.google.com/googleplay/android-developer/table/4419860

 ## Translations (localization)

@@ -1,6 +1,6 @@
 # Overview of tested Bluetooth LE sensors

-## HRS: Heartrate Service
+## 0x180D: Heartrate Service

 * Decathlon|Geonaute|Kalenji Dual HRM Belt
 * moofit heart rate monitor
@@ -9,8 +9,11 @@
 * Polar OH1
  Has updatable firmware that requires a user account at polar.com
 * Wahoo Tickr (Model: WFBTHR02)
+* Mi Band 3, Amazfit Band 5, Amazfit Bip. These devices are manufactured by Huami, and other Huami devices will very likely work. Theoretically, this sensor must be enabled, but testing reveals that it works even without enabling. For details on how to enable see [Gadgetbridge wiki](https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Huami-Heartrate-measurement#bluetooth-heart-rate-sensor)
+* Amazfit Neo. But first you have to enable "Discoverable" and "Activity heart rate sharing" in the official Zepp app. (after pairing with OpenTracks you can disable them again)
+* Garmin HRM-Dual (Reference: 010-12883-00)

-## CSCP: Cycling Cadence and Speed Service
+## 0x1816: Cycling Cadence and Speed Service

 Please note that the according to the specification these sensors _may_ provide speed as well as cadence.
 However, often only one value is provided.
@@ -18,8 +21,14 @@ However, often only one value is provided.
 ### Speed

 * Garmin Speed Sensor 2
+  * Has updatable firmware that requires an account for garmin.com
+  * This sensor reports speed data as cadence.
+    A workaround is in place.
+
 * Wahoo Speed (Model: WFRPMSPD)

+* CooSpo cadence and speed sensor (model: BK467)
+
 ### Cadence

 * Garmin Cadence Sensor 2
@@ -27,7 +36,7 @@ However, often only one value is provided.
  This sensor reports cadence data as speed.
  A workaround is in place.

-## Cycling Power Measurement
+## 0x1818: Power Measurement

 We only support _Instantaneous Power_.

@@ -35,8 +44,36 @@ _WARNING_: we only support physically movements with valid GPS coordinates.
 Using a device indoors (no GPS available) will only show the current power values, but won't store anything.
 Also the distance is not computed.

+For cycling:
 * Assioma Duo Powermeter
 * Elite drivo II
 * QUARQ Red DZero Powermeter
 * Tacx Satori Smart
-* Wahoo Kickr v4.0
+* Wahoo Kickr v4.0
+* Rotor 2INpower DM Road (only supports power measurement, cadence measurement is propietary @ firmware v1.061)
+
+For running:
+* Stryd
+
+## 0x1814: running cadence and speed
+
+We do not support type of movement (i.e., walking vs running).
+
+* Polar Stride
+* Stryd (incl. power)
+
+## Tested Barometric Sensor Smartphones
+
+There are smartphones that have a barometric sensor that OpenTracks uses to compute altitude gain and loss.
+
+In our tests there are smartphones whose barometric sensor works well and others don't. Here is a list of the smartphones tested:
+
+|Brand|Model|Android Version|Tests|
+|-----|-----|---------------|-----------|
+|Google|Pixel|LineageOS 17.1|Ok|
+|Google|Pixel 2 XL|LineageOS 17.1|Ok on the bike handlebars but it fails when I carry it in a pocket or backpack|
+|Google|Pixel 3|Android 11|Failure|
+|Google|Pixel 3a|Android 11|Ok|
+|Google|Pixel 3a|Lineage 18.1|Ok|
+|Google|Pixel 4a|Android 11|Ok|
+|Sony|Xperia XZ1 Compact|LineageOS 16.1|Failure|
@@ -27,7 +27,7 @@ cp "$CHANGELOG_DIR/next_release.txt" "$CHANGELOG_FILE"
 sed -i "s/(versionName)/$VERSIONNAME/" "$CHANGELOG_FILE"

 echo -e "\nGit commit since last release\n------------"
-git log $(git describe --tags --abbrev=0)..HEAD --no-merges --oneline
+git log "$(git describe --tags --abbrev=0)..HEAD" --no-merges --oneline

 echo -e "\nPlease edit the changelog for the new release"
 gedit -w "$CHANGELOG_FILE"
@@ -0,0 +1,38 @@
+#!/bin/bash
+
+set -e
+
+# Folder where svg screenshots are expected.
+SRC_DIR="screenshots-svg/"
+# Folder where png files will be saved.
+DST_DIR="fastlane/metadata/android/en-US/phoneScreenshots/"
+
+echo "Exporting svg files to png..."
+
+# Source and destination folder must exist.
+if [ ! -d "$SRC_DIR" ]
+then
+    echo "\nERROR: ${SRC_DIR} doesn't exist."
+    exit
+fi
+
+if [ ! -d "$DST_DIR" ]
+then
+    echo "\nERROR: ${DST_DIR} doesn't exist."
+    exit
+fi
+
+# It needs Inkscape that is the tool used to convert svg to png.
+if ! command -v inkscape > /dev/null
+then
+    echo "\nERROR: inkscape couldn't be found and it's needed to convert screenshots from svg to png."
+    exit
+fi
+
+# Convert all svg files from source directory.
+for path in ${SRC_DIR}/*.svg
+do
+    filename="${path##*/}"
+    basename="${filename%.svg}"
+    `inkscape ${path} --export-filename ${DST_DIR}/${basename}.png`
+done
@@ -3,17 +3,17 @@ apply plugin: 'com.android.application'
 buildscript {
    repositories {
        google()
-        jcenter()
+        mavenCentral()
    }
    dependencies {
-        classpath 'com.android.tools.build:gradle:4.1.1'
+        classpath 'com.android.tools.build:gradle:7.0.3'
    }
 }

 allprojects {
    repositories {
        google()
-        jcenter()
+        mavenCentral()
    }
 }

@@ -24,44 +24,59 @@ def getVersionName = { ->
            commandLine 'git', 'describe', '--tags'
            standardOutput = stdout
        }
-        exec {
-            commandLine 'git', 'log', '--format="%h"', '-n 1'
-            standardOutput = stdout
-        }
-        return stdout.toString().replace('\n', '-').replace('"', '').trim()
-    }
-    catch (ignored) {
+        return stdout.toString().trim()
+    } catch (ignored) {
        return null
    }
 }

+def versionCodeFromDate = { ->
+    def date = new Date()
+    def formattedDate = date.format('yyyyMMdd')
+    return Integer.valueOf(formattedDate)
+}
+
 android {
    compileOptions {
        coreLibraryDesugaringEnabled true

-        sourceCompatibility JavaVersion.VERSION_1_8
-        targetCompatibility JavaVersion.VERSION_1_8
+        sourceCompatibility JavaVersion.VERSION_11
+        targetCompatibility JavaVersion.VERSION_11
    }

-    compileSdkVersion 30
+    compileSdkVersion 31

    buildFeatures {
-        viewBinding = true
+        viewBinding true
+    }
+
+    aaptOptions {
+        cruncherEnabled = false
    }

    defaultConfig {
        applicationId "de.dennisguse.opentracks"
-        versionCode 3740
-        versionName "v3.13.2"
+        versionCode 4519
+        versionName "v3.22.0"

        buildConfigField "String", "VERSION_NAME_FULL", "\"${getVersionName()}\""


-
        minSdkVersion 21
-        targetSdkVersion 30
+        targetSdkVersion 31

-        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        testInstrumentationRunner "de.dennisguse.opentracks.TestRunner"
+        testInstrumentationRunnerArguments clearPackageData: 'true'
+    }
+    signingConfigs {
+        nightly {
+            if (System.getProperty("nightly_store_file") != null) {
+                storeFile file(System.getProperty("nightly_store_file"))
+                storePassword System.getProperty("nightly_store_password")
+                keyAlias System.getProperty("nightly_key_alias")
+                keyPassword System.getProperty("nightly_key_password")
+            }
+        }
    }

    buildTypes {
@@ -70,6 +85,11 @@ android {
            versionNameSuffix "-debug"
        }

+        nightly {
+            signingConfig signingConfigs.nightly
+            applicationIdSuffix ".nightly"
+        }
+
        release {
            minifyEnabled false
        }
@@ -82,21 +102,32 @@ android {

    applicationVariants.all { variant ->
        variant.resValue "string", "applicationId", variant.applicationId
+
+        if (variant.buildType.name == 'nightly') {
+            variant.outputs.all {
+                setVersionCodeOverride(versionCodeFromDate())
+                setVersionNameOverride(getVersionName())
+                outputFileName = "${applicationId}_${variant.versionCode}.apk"
+            }
+        }
    }
 }

 dependencies {
-    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.1'
+    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.5'

-    implementation 'androidx.appcompat:appcompat:1.2.0'
+    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'androidx.preference:preference:1.1.1'
    implementation 'androidx.documentfile:documentfile:1.0.1'
-    implementation 'com.google.android.material:material:1.2.1'
+    implementation 'com.google.android.material:material:1.4.0'
    implementation 'com.android.support.constraint:constraint-layout:2.0.4'

-    androidTestImplementation 'androidx.test:core:1.3.0'
-    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
-    androidTestImplementation 'androidx.test:rules:1.3.0'
-    androidTestImplementation 'androidx.test:runner:1.3.0'
-    androidTestImplementation 'org.mockito:mockito-android:3.6.0'
+    androidTestImplementation 'androidx.test:core:1.4.0'
+    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
+    androidTestImplementation 'androidx.test:rules:1.4.0'
+    androidTestImplementation 'androidx.test:runner:1.4.0'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
+    androidTestImplementation 'org.mockito:mockito-android:4.0.0'
+
+    androidTestUtil 'androidx.test:orchestrator:1.4.0'
 }
@@ -2,17 +2,7 @@
 interface TrackExporter {
 }
 class KmzTrackExporter implements TrackExporter
-KmzTrackExporter o-- FileTrackExporter
-class FileTrackExporter implements TrackExporter {
-/' One track only '/
-}
-FileTrackExporter o-- TrackWriter
-
-interface TrackWriter {
-}
-class GpxTrackWriter implements TrackWriter
-class KmlTrackWriter implements TrackWriter
-
+class KmlTrackExporter implements TrackExporter

 interface TrackImporter {
 }
@@ -1,5 +1,5 @@
@startuml
-SensorManager --> ElevationSumManager
+SensorManager --> AltitudeSumManager
 LocationManager --> TrackRecordingService
 ElevationSumManager --> TrackRecordingService

@@ -14,6 +14,6 @@ TrackDataHub --> StatisticsRecordingFragment : TrackPoints, TrackStatistics, Way
 TrackDataHub --> StatisticsRecordedFragment : TrackPoints, TrackStatistics, Waypoints (push)
 TrackDataHub --> ChartFragment --> ChartView

-TrackRecordingServiceConnection --> StatisticsRecordingFragment : Sensor data (heartrate, cadence, elevation gain; pull 1s)
+TrackRecordingServiceConnection --> StatisticsRecordingFragment : Sensor data (heartrate, cadence, altitude gain; pull 1s)
 TrackRecordingServiceConnection --> TrackController : Start time (pull, onStart)
@enduml
@@ -9,25 +9,27 @@ class Track {
 }
 Track o-- TrackPoint
 Track o-- Marker
-Track "1" - "1" TripStatistics
+Track "1" - "1" TrackStatistics

-class TripStatistics {
+class TrackStatistics {
    - startTime
    - stopTime
    - totalDistance
    - totalTime
    - movingTime
    - maxSpeed
-    - totalElevationGain
+    - totalGain
 }

-note left of TripStatistics
-The time is based upon device time.
-end note
+class TrackStatisticsUpdater {
+}

+TrackStatisticsUpdater ..> TrackStatistics : creates/updates
+TrackStatisticsUpdater ..> TrackPoint : uses

 class TrackPoint {
-    - id
+    - id (database id, order)
+    - type
    - trackId
    - longitude
    - latitude
@@ -41,31 +43,6 @@ class TrackPoint {
    - sensor_power
 }

-note right of TrackPoint
-TODO
-TrackPoints are mixing two concepts:
-1. a GPS measurement provided by the GPS hardware
-2. and also segment markers.
-   These are marked by PAUSE / RESUME TrackPoints.
-
-While exporting PAUSE/RESUME are not used to create these segments and these are partly recreated when imported.
-However, the timestamp of PAUSE/RESUME is not exported and can therefore not be restored.
-This prevents us from restoring the exact TripStatistics.
-It is also noteworthy that neither PAUSE/RESUME TrackPoints are used for computing the TrackStatistics.
-Only the timestamp to _create_ those is used.
-end note
-
-note left of TrackPoint
-TODO
-The time stored in TrackPoints is either:
-1. created via GPS: provided by the GPS hardware
-2. created by the user (pause/resume): device time.
-
-We know that the GPS time and device time are often not in sync.
-end note
-
-TrackPoint "1" - "1" android.location.Location
-
 class Marker {
    - id
    - trackId
@@ -75,8 +52,48 @@ class Marker {
    - icon
    - length
    - duration
-    - location
-    - tripStatistics
+    - longitude
+    - latitude
    - photoUrl
 }
-@enduml
+
+class DataField {
+    - key
+    - title
+    - isVisible
+    - isPrimary
+    - isWide
+}
+
+class StatisticData {
+    - value
+    - unit
+    - description
+}
+StatisticData o-- DataField
+
+class Layout {
+    - profile
+}
+Layout "1" o-- "many" DataField
+
+note left of TrackPoint
+As of OpenTracks version 3.15.0, all times are using device time.
+Before that TrackPoint.time contained GPS time (determined by GPS hardware).
+However, start/pause/stop events (also stored as TrackPoints) used device time.
+end note
+
+note right of Track
+A track is an ordered collection of one or more segments (i.e., continuous parts of distance covered).
+Segments may be started by a user (i.e., start a track recording, continue a paused track, or resume a track) as well as stopped by the user (i.e., pausing or stopping a recording).
+Also segments may started automatically while recording (i.e., distance to previous location was to large).
+Note that this finishes the previous segment.
+
+Segment data is stored as TrackPoints (Type.SEGMENT_START_MANUAL, Type.SEGMENT_START_AUTOMATIC, or Type.SEGMENT_END_MANUAL).
+Trackpoints with Type.SEGMENT_START_AUTOMATIC also mark the end of the previous segment.
+All TrackPoints of Type.TRACKPOINT belong to the segment started by the prior TrackPoint with Type.SEGMENT_START_(MANUAL|AUTOMATIC).
+Trackpoints of Type.SEGMENT_START_MANUAL or Type.SEGMENT_END_MANUAL do not contain location data or sensor data.
+
+Tracks recorded prior to OpenTracks version 3.15.0, do neither begin with a Type.SEGMENT_START_MANUAL nor end with a Type.SEGMENT_END_MANUAL.
+end note
+@enduml
@@ -1,8 +1,32 @@
 <?xml version="1.0"?>
-<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://opentracksapp.com/xmlschemas/v1">

-    <xs:element name="trackuuid"
-        type="xs:string" />
+    <xsd:element name="trackuuid"
+        type="xsd:string">
+        <xsd:annotation>
+            <xsd:documentation xml:lang="en">
+                A unique track identifier stored as UUID.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>

-</xs:schema>
+    <xsd:element name="loss"
+        type="xsd:float">
+        <xsd:annotation>
+            <xsd:documentation xml:lang="en">
+                The lost elevation in meters from the previous to the current TrackPoint.
+                Only used in GPX.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+    <xsd:element name="gain"
+        type="xsd:string">
+        <xsd:annotation>
+            <xsd:documentation xml:lang="en">
+                The gained elevation in meters from the previous to the current TrackPoint.
+                Only used in GPX.
+            </xsd:documentation>
+        </xsd:annotation>
+    </xsd:element>
+</xsd:schema>
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   height="22"
+   width="22"
+   fill="#000000"
+   version="1.0"
+   x="0px"
+   y="0px"
+   viewBox="0 0 21.84952 21.99934"
+   enable-background="new 0 0 99.316 99.997"
+   xml:space="preserve"
+   id="svg10"
+   sodipodi:docname="ic_activity_kayaking.svg"
+   inkscape:version="1.0.2 (e86c870879, 2021-01-15)"><metadata
+     id="metadata16"><rdf:RDF><cc:Work
+         rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title /></cc:Work></rdf:RDF></metadata><defs
+     id="defs14" /><sodipodi:namedview
+     pagecolor="#000000"
+     bordercolor="#666666"
+     borderopacity="1"
+     objecttolerance="10"
+     gridtolerance="10"
+     guidetolerance="10"
+     inkscape:pageopacity="1"
+     inkscape:pageshadow="2"
+     inkscape:window-width="1920"
+     inkscape:window-height="1024"
+     id="namedview12"
+     showgrid="false"
+     inkscape:pagecheckerboard="false"
+     inkscape:zoom="22.472123"
+     inkscape:cx="11.932326"
+     inkscape:cy="8.4821218"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg10"
+     inkscape:document-rotation="0" /><path
+     id="path2"
+     style="fill:#ffffff;stroke-width:0.20758"
+     d="m 18.296044,13.516712 c -1.017125,-0.01824 -1.903328,0.770666 -2.945647,0.500454 -0.952298,-0.271819 -1.950516,-0.765534 -2.949277,-0.338881 -0.938402,0.492101 -2.078868,0.493759 -3.017025,0 C 8.3845167,13.251481 7.3852162,13.744815 6.4321693,14.017166 5.229901,14.31201 4.2005498,13.256398 2.9984219,13.558671 2.2076549,13.806805 1.0222411,14.11299 1.0222411,14.11299 v 1.764949 c 1.0226762,0.01947 1.9128198,-0.776355 2.9601398,-0.498166 0.4416703,0.216761 1.6682446,0.3639 1.6529583,0.601941 l -1.3879215,1.383539 c -0.7385797,-0.502111 -1.5118619,0.0527 -1.9901253,0.625328 -0.5087615,0.568011 -1.1635382,1.025896 -1.5505475,1.687065 -0.44607206,0.952772 0.6576964,2.056499 1.6104671,1.610525 0.7016688,-0.428027 1.2006595,-1.122907 1.8093513,-1.672458 0.6218606,-0.429609 0.7776032,-1.247655 0.6297837,-1.861615 l 2.0038313,-1.999046 c 0.9553792,-0.44042 2.0942104,-0.606317 3.0559286,-0.07975 0.9566571,0.429062 1.9815791,0.09313 2.8934291,-0.263824 1.038124,-0.339466 1.95525,0.382078 2.955963,0.461915 1.087184,0.105691 2.019821,-0.784126 3.121615,-0.493622 0.55673,-0.01509 1.943197,1.034046 1.977683,0.148315 v -1.471252 c -0.878739,0.05089 -1.592095,-0.588897 -2.468753,-0.540124 z"
+     sodipodi:nodetypes="sccccccccccccccccccccccss" /><path
+     id="path4"
+     style="fill:#ffffff;stroke-width:0.20758"
+     d="M 19.135498,4.6094374 C 19.777729,3.9239548 20.518106,3.3189058 21.090567,2.5760423 21.630775,1.6723294 20.631775,0.46345938 19.642408,0.81572972 18.952145,1.1177762 18.525406,1.7968856 17.966518,2.2833866 17.44088,2.7777653 16.748383,3.4079168 17.123672,4.2079927 17.316456,4.5791871 16.670933,4.8230987 16.479267,5.1359209 L 15.065885,6.5509368 C 13.459538,5.9569743 11.849312,5.3583867 10.246781,4.7652258 9.2045735,4.5310231 8.2546176,5.3827898 8.1060604,6.3824119 7.7002321,7.7689937 7.2645314,9.1479847 6.8776693,10.539386 h -5.851069 v 2.366209 c 1.0341353,-0.06583 1.9719234,-0.790016 3.0482038,-0.491433 0.8514673,0.182595 1.7032854,0.742921 2.5975093,0.377297 1.0893234,-0.553582 2.4097276,-0.562618 3.4983496,-0.0022 0.895986,0.368665 1.751474,-0.190407 2.60469,-0.37517 1.078334,-0.302717 2.015803,0.427862 3.051521,0.490909 0.985146,-0.07753 1.867505,-0.470806 2.884112,-0.579104 0.847652,-0.0903 2.163908,-1.785603 2.163908,-1.785603 0,0 -1.819193,-0.01538 -2.935123,0.0029 -1.990467,-2.45e-4 -3.980934,-0.0021 -5.9714,-0.0044 l 2.483907,-2.4814163 c 0.762424,0.5726687 1.957001,-0.3877847 1.20272,-1.1977389 l 2.032212,-2.039685 c 0.462782,0.2519942 1.079225,0.1706574 1.448288,-0.2104864 z m -8.060346,5.9299486 c -0.486522,0.101516 -0.612149,-0.06543 -0.374498,-0.502616 l 0.909432,-3.029364 2.189559,0.8099787 z"
+     sodipodi:nodetypes="cccccccccccccccccsccccccccccccc" /><path
+     id="path851"
+     style="fill:#ffffff;stroke-width:1.16861"
+     d="m 12.520186,2.6733336 c 0.05505,1.1807821 -1.406378,2.0132887 -2.394197,1.3656163 -1.0445314,-0.553724 -1.0179219,-2.235304 0.04332,-2.7559413 1.018447,-0.59197226 2.378758,0.20782 2.350878,1.390325 z" /></svg>
@@ -0,0 +1,3 @@
+README.md
+Appfile
+report.xml
@@ -16,23 +16,11 @@
 default_platform(:android)

 platform :android do
-  desc "Runs all the tests"
-  lane :test do
-    gradle(task: "test")
-  end
-
-  desc "Submit a new Beta Build to Crashlytics Beta"
-  lane :beta do
-    gradle(task: "clean assembleRelease")
-    crashlytics
-  
-    # sh "your_script.sh"
-    # You can also use other beta testing services here
-  end
-
-  desc "Deploy a new version to the Google Play"
-  lane :deploy do
-    gradle(task: "clean assembleRelease")
-    upload_to_play_store
+  desc "Upload metadata"
+  lane :metadata do
+    upload_to_play_store(
+        skip_upload_apk: true,
+        skip_upload_changelogs: true
+    )
  end
 end
@@ -0,0 +1,12 @@
+v3. 18. 5: OpenTracks
+
+التغييرات:
+- سرعة الإعلان الصوتي شكلي
+- API <26: رمز المشغل يحذف الخلفية
+
+بوجفيكسيس:
+- تسجيل واجهة المستخدم: إظهار القيم الصحيحة 
+- تسجيل واجهة المستخدم: عرض (مرة أخرى) الارتفاع في EGM2008
+
+المطور:
+- أذونات Android12 (BLUETOOTH_CONNECT)
@@ -0,0 +1 @@
+تعقب الرياضة التي تحترم تماما خصوصيتك.
@@ -0,0 +1 @@
+OpenTracks
@@ -0,0 +1,12 @@
+v3.18.5: OpenTracks
+
+Промени:
+- Конфигуриране на скоростта на гласовите съобщения
+- API <26: Иконата за стартиране пропуска фона
+
+Поправки на грешки:
+- Потребителски интерфейс за запис: показва правилните стойности 
+- Потребителски интерфейс за запис: показва (отново) надморската височина в EGM2008
+
+Разработчик:
+- Разрешения за Android12 (BLUETOOTH_CONNECT)
@@ -0,0 +1,11 @@
+OpenTracks е приложение за проследяване на спортни събития, което напълно зачита неприкосновеността на личния ви живот.
+
+Характеристики:
+* Спортно проследяване: проследявайте своите спортни дейности и дейности на открито
+* Снимки и маркери: отбелязвайте интересни места, докато проследявате
+* Увеличаване и намаляване на надморската височина: чрез барометричен сензор
+* Надморска височина, показана в EGM2008 (над средното морско равнище); експортирана като WGS84
+* Гласови съобщения
+* Поддържа Bluetooth LE сензори: сърдечен ритъм, скорост и разстояние (колоездене), каданс (колоездене) и електромер (колоездене)
+* Експортиране на данни: експортирайте трасетата като KMZ (включително снимки), KML или GPX
+* Без достъп до интернет: Не се използва интернет
@@ -0,0 +1 @@
+Спортно проследяване, което напълно зачита поверителността на личните ви данни.
@@ -0,0 +1 @@
+OpenTracks
@@ -0,0 +1,12 @@
+v3.18.5: OpenTracks
+
+Změny:
+- Nastavitelná rychlost hlasového hlášení
+- API <26: Ikona spouštěče vynechává pozadí
+
+Opravy chyb:
+- Uživatelské rozhraní nahrávání: zobrazuje správné hodnoty 
+- Uživatelské rozhraní nahrávání: zobrazuje (znovu) nadmořskou výšku v EGM2008
+
+Vývojáři: Změny v nastaveních: - Zlepšena funkce pro nahrávání a nahrávání letů v letadle:
+- Oprávnění Android12 (BLUETOOTH_CONNECT)
@@ -0,0 +1,11 @@
+OpenTracks je aplikace pro sledování sportu, která zcela respektuje vaše soukromí.
+
+Funkce:
+* Sledování sportu: sledujte své sportovní a outdoorové aktivity.
+* Fotografie a značky: označte zajímavá místa při sledování
+* Zvyšování a snižování nadmořské výšky: pomocí barometrického senzoru.
+* Nadmořská výška se zobrazuje v EGM2008 (nad průměrnou hladinou moře); exportuje se jako WGS84
+* Hlasová hlášení
+* Podporuje snímače Bluetooth LE: srdeční tep, rychlost a vzdálenost (cyklistika), kadence (cyklistika) a měřič výkonu (cyklistika).
+* Export dat: export tras ve formátu KMZ (včetně fotografií), KML nebo GPX.
+* Bez přístupu k internetu: Internet se nepoužívá
@@ -0,0 +1 @@
+Sportovní tracker, který zcela respektuje vaše soukromí.
@@ -0,0 +1 @@
+OpenTracks
@@ -0,0 +1,12 @@
+v3.18.5: OpenTracks
+
+Ændringer:
+- Ændringer: Stemmemeddelelseshastighed kan konfigureres
+- API <26: Ikonet i startopsætningen udelader baggrund
+
+Fejlrettelser:
+- Optagelse UI: Vis korrekte værdier 
+- Optagelse UI: viser (igen) højde i EGM2008
+
+Udvikler:
+- Android12-tilladelser (BLUETOOTH_CONNECT)
@@ -0,0 +1,11 @@
+OpenTracks er et program til sporing af sport, der fuldt ud respekterer dit privatliv.
+
+Funktioner:
+* Sport tracking: Spor dine sports- og udendørsaktiviteter
+* Billeder og markører: Markér interessante steder under sporing
+* Højdeforøgelse og -tab: via barometrisk sensor
+* Højde vist i EGM2008 (over middelhavets overflade); eksporteret som WGS84
+* Stemmemeddelelser
+* Understøtter Bluetooth LE-sensorer: puls, hastighed og distance (cykling), kadence (cykling) og effektmåler (cykling)
+* Eksport af data: Eksportér spor enten som KMZ (inkl. fotos), KML eller GPX
+* Ingen internetadgang: Internet bruges ikke
@@ -0,0 +1 @@
+En sportstracker, der respekterer dit privatliv fuldt ud.
@@ -0,0 +1 @@
+OpenTracks
@@ -12,4 +12,4 @@ Changes:
 - Removed Bluetooth classic sensors
 - Removed Protobuf
 - Removed calorie estimation and activity estimation
- Removed MyTracks Service API (i.e., no integration with other apps)
+- Removed MyTracks Service API (i.e., no integration with other apps)
@@ -14,4 +14,4 @@ Bugfixes:

 Developer:
 - Test are executable (but many failing)
- Enabled continuous integration with TravisCI (no tests)
+- Enabled continuous integration with TravisCI (no tests)
@@ -11,4 +11,4 @@ Bugfix:

 Developer:
 - Upgrade to Gradle 5.6
- Do not minify release builds
+- Do not minify release builds
@@ -13,4 +13,4 @@ Developer:
 - Removed unused parcelable functionality
 - Major cleanup and reformatting
 - Do not use broadcast for app to widget communication
- stats_content.xml does not include other files
+- stats_content.xml does not include other files
@@ -4,4 +4,4 @@ Changes:
 - Settings are now on a single page

 Developer:
- Settings moved to Androidx compat (uses fragments)
+- Settings moved to Androidx compat (uses fragments)
@@ -10,4 +10,4 @@ Bugfix:

 Developer:
 - Replaced actionbar with toolbar
- Migrated to androidx appcompat (incl. Material Design)
+- Migrated to androidx appcompat (incl. Material Design)
@@ -11,4 +11,4 @@ Bugfix:
 - Heart rate wasn't always shown while recording

 Developer:
- Enabled TravisCI instrumentation tests
+- Enabled TravisCI instrumentation tests
@@ -2,4 +2,4 @@ v3.2.4: OpenTracks

 Bugfix:
 - Settings activity crashes
-  Removed possibility to change voice/split frequency from the context menu
+  Removed possibility to change voice/split frequency from the context menu
@@ -12,4 +12,4 @@ Developer:
  - if Settings cannot be loaded reset all preferences
  - moved access to preferences to PreferencesUtil
  - moved default of preferences from code to xml
-  - use SummaryProvider
+  - use SummaryProvider
@@ -5,4 +5,4 @@ Changes:
 - Remove shortcut to Bluetooth settings

 Developer:
- Preferences: moved default of preferences from code to xml
+- Preferences: moved default of preferences from code to xml
@@ -7,4 +7,4 @@ Changes:
 - Added help (in Settings)

 Bugfix:
- TrackDetailActivity: disabled non-working landscape mode (temporary)
+- TrackDetailActivity: disabled non-working landscape mode (temporary)
@@ -7,4 +7,4 @@ Bugfixes:
 - Export via KMZ did not export picture filenames correctly
 - Sharing multiple tracks did not include KMZ files
 - MarkerDetailActivity's UI was not shown
- Settings crashed if preference of heart rate was not initialized
+- Settings crashed if preference of heart rate was not initialized
@@ -7,4 +7,4 @@ Changes:

 Bugfixes:
 - Statistics: heart rate was not shown
- Statistics: time was briefly reset to 0s
+- Statistics: time was briefly reset to 0s
@@ -9,4 +9,4 @@ Bugfix:
 Developer:
 - Replaced TabHost by TabsLayout
 - Removed special first waypoint
- Removed duplicate translations
+- Removed duplicate translations
@@ -11,4 +11,4 @@ Bugfix:

 Developer:
 - Database: remove unused columns
- Database: add indices
+- Database: add indices
@@ -7,4 +7,4 @@ Bugfix:
 - Import of KMZ did not process the photo URL correctly

 Developer:
- Simplified data processing
+- Simplified data processing
@@ -1,4 +1,4 @@
 v3.6.1: OpenTracks

 Bugfix:
- KMZ import: store correct picture path
+- KMZ import: store correct picture path
@@ -1,4 +1,4 @@
 v3.6.2: OpenTracks

 Bugfix:
- Charts were not shown correctly (introduced in v3.6.0)
+- Charts were not shown correctly (introduced in v3.6.0)
@@ -10,4 +10,4 @@ Bugfix:
 - KMZ import: only import used images

 Developer:
- Refactored TrackRecordingService
+- Refactored TrackRecordingService
@@ -4,4 +4,4 @@ Workaround:
 - Hide start GPS button

 Bugfix:
- Fixed null pointer
+- Fixed null pointer
@@ -3,4 +3,4 @@ v3.7.2: OpenTracks
 Bugfix:
 - Re-added start GPS button
 - Track name is not overwritten at the end of a recording
- Markers: removing a photo also deletes the file
+- Markers: removing a photo also deletes the file
@@ -4,4 +4,4 @@ Bugfix:
 - Fixed computation of cadence and speed (via Bluetooth LE sensor)

 Developer:
- Removed unused translations
+- Removed unused translations
@@ -9,4 +9,4 @@ Bugfix:

 Developer:
 - Split TrackDetailActivity
- StatsFragement successor uses ConstraintLayout
+- StatsFragement successor uses ConstraintLayout
@@ -8,4 +8,4 @@ Changes:
 - Show track on map: file format can be selected and opening dashboard works on Android R (API 30+)

 Bugfix:
- App icon now correctly implemented
+- App icon now correctly implemented
@@ -8,4 +8,4 @@ Changes:

 Developer:
 - Replaced AsyncTasks with Threads
- Synchronization: UUID is generated per track (not yet exported)
+- Synchronization: UUID is generated per track (not yet exported)
@@ -13,4 +13,4 @@ Bugfixes:
 - Editing a marker failed on orientation change

 Developer:
- Refactored TrackRecordingService
+- Refactored TrackRecordingService
@@ -5,4 +5,4 @@ Changes:
 - Dashboard is started on the same task

 Bugfixes:
- Intent filters for importing files were far too optimistic
+- Intent filters for importing files were far too optimistic
@@ -11,4 +11,4 @@ Changes:
 Bugfixes:
 - Fixed some rare crashes (NPE)
 - Pace formatting corrected
- App icon in launcher repositioned
+- App icon in launcher repositioned
@@ -1,4 +1,4 @@
 v3.9.1: OpenTracks

 Bugfixes:
- GPS pre-start shows status of fix
+- GPS pre-start shows status of fix
@@ -2,4 +2,4 @@ v3.9.2: OpenTracks

 Bugfixes:
 - Fixed force close on API<25 (due to an animation)
- Reset recording state (on app startup) if crashed while recording
+- Reset recording state (on app startup) if crashed while recording
@@ -1,4 +1,4 @@
 v3.9.3: OpenTracks

 Bugfixes:
- Fixed export all tracks bug.
+- Fixed export all tracks bug.
@@ -7,4 +7,4 @@ Changes:

 Bugfix:
 - GPS was not turned off when stopping a recording
- Show on map via KML/KMZ/GPX was broken due to refactoring
+- Show on map via KML/KMZ/GPX was broken due to refactoring
@@ -2,4 +2,3 @@ v3.13.2: OpenTracks

 Bugfix:
 - Crash in landscape mode
-
@@ -0,0 +1,10 @@
+v3.14.0: OpenTracks
+
+Changes:
+- Properly support for right-to-left
+- Import: faster cleanup after import failure
+- Text in charts scales according to Android settings
+- Heart rate: support for Huami devices (requires Gadgetbridge)
+
+Developer:
+- Import is now handled in-memory
@@ -0,0 +1,14 @@
+v3.14.1: OpenTracks
+
+Changes:
+- Added elevation loss (via barometer)
+- Updated translations (cz, gl, it, nb, pl, pt, sp)
+- Markers can be shared from list
+- Actionbar icon (top left) to go back
+- 
+Bugfix:
+- Potential crash on import
+
+Developer:
+- Implemented basic EspressoUI test
+- Reference resourceIds via if rather than switch/case
@@ -0,0 +1,10 @@
+v3.14.2: OpenTracks
+
+Changes:
+- Downgrade database from upcoming release v3.15.0
+- Import/Export UI improved
+- Import offers to show imported track
+- Marker list performance improved 
+
+Developer:
+- Track.Id/Marker.Id: use null
@@ -0,0 +1,4 @@
+v3.14.3: OpenTracks
+
+Bugfix: 
+- Downgrading database from upcoming release v3.15.0
@@ -0,0 +1,22 @@
+v3.15.0: OpenTracks
+
+WARNING: 
+This release applies database changes that CANNOT BE REVERTED.
+As KMZ/KML export/import behaviour changes as well, it is recommended to (A) take a backup BEFORE upgrading and (B) afterwards.
+Recommended format: KMZ.
+
+BREAKING CHANGES:
+- Internal storage of track segments is changed
+  (user generated events are now considered trackpoints without a location but with timestamp)
+- Device time instead of GPS time is stored 
+  (existing data is not modified)
+- Dashboard API v2 
+  (please upgrade OSMDashboard 2.10.0)
+
+Changes:
+- KML/KMZ can used to backup and restore exactly (incl. statistics)
+
+Developer:
+- Reworked track segmentation and it's storage (formerly PAUSE/RESUME marker)
+- TrackStatistics are computed solely using TrackPoints
+- Replaced long with Instant/Duration
@@ -0,0 +1,7 @@
+v3.15.1: OpenTracks
+
+Changes:
+- After recording show sensor statistics (e.g., avg HR)
+
+Bugfix:
+- Crash on recording start with show latitude/longitude enabled
@@ -0,0 +1,7 @@
+v3.15.2: OpenTracks
+
+Changes:
+- Updated translations
+
+Bugfix:
+- Crash on GPX export
@@ -0,0 +1,8 @@
+v3.15.3: OpenTracks
+
+Changes:
+- Computation avg/max: heart rate, cadence, and power
+
+Bugfix:
+- KML/KMZ do not export #start/#end placemarks anymore
+- While recording: Speed/location was sometimes falsly shown as 0.
@@ -0,0 +1,4 @@
+v3.15.4: OpenTracks
+
+Bugfix:
+- Voice annoucements interval should be in minutes (introduced in v3.15.0)
@@ -0,0 +1,13 @@
+v3.16.0: OpenTracks
+
+Changes:
+- Cycling: get distance from BLE speed sensor
+- Reworked UI presented while recording
+- UI performance optimizations
+- Exported filenames: <First 32bits UUID>_<track's name>.<extension> 
+- Import multiple files via Intent (e.g., from Gadgetbridge)
+- GPX: export power data
+- Updated translations
+
+Bugfix:
+- Voice announcement use minutes correctly
@@ -0,0 +1,17 @@
+v3.17.0: OpenTracks
+
+Changes:
+- Add icon for kayaking
+- Charts draw missing sensor data properly
+- Default: show coordinates while recording 
+
+Bugfixes:
+- GPX schema corrected
+- GPX exported altitude loss as sensor distance
+- Statistics not computed correctly if using a speed/distance sensor
+
+Developer:
+- Distance/speed value objects
+- Replaced communication via SharedPreferences 
+- Use non-static service binder
+- Use altitude in the code base (instead of elevation)
@@ -0,0 +1,7 @@
+v3.17.1: OpenTracks
+
+
+Bugfix:
+- Interval length in meters instead of kilometers (introduced in v3.17.0)
+- Elevation gain/loss not recorded (introduced in v3.17.0)
+- Announcements not working on Android 11
@@ -0,0 +1,8 @@
+v3.17.2: OpenTracks
+
+WARNING: The v3.17.0+ releases contain a memory leak.
+This issues is NOT FIXED by this release.
+It is recommended to not upgrade if you still use a release before v3.17.0
+
+Bugfix:
+- Crash while using voice announcements
@@ -0,0 +1,10 @@
+v3.17.3: OpenTracks
+
+WARNING: The v3.17.0+ releases contain a memory leak.
+This issues is NOT FIXED by this release.
+It is recommended to not upgrade if you still use a release before v3.17.0
+
+Bugfix:
+- Crash if using pace for voice announcements (introduced in v3.17.0)
+- Statistics showed pace initially (introduced in v3.17.0)
+- Rare crash when deleting tracks
@@ -0,0 +1,15 @@
+v3.18.0: OpenTracks
+
+Changes:
+- Altitude is shown in EGM2008 (stored/exported as WGS84)
+
+Bugfix:
+- Fixed memory leak (introduced in v3.17.0)
+- Charts: altitude should be in M/FT (introduced in v3.17.1)
+- Charts: while recording was not correctly updated (introduced in v3.17.3)
+- TrackDataHub did not account for recordingDistanceInterval (introduced in v3.17.2)
+
+Developer:
+- Disable PNG crunching (reproducible build)
+- Refactored TrackImporter and optimized KMZ import
+- Use LiveData for TrackRecordingService to UI communication (removing memory leak)
@@ -0,0 +1,13 @@
+v3.18.1: OpenTracks
+
+Changes:
+- Deleting tracks is handled by a service
+- Uninstall deletes all data (i.e., hasFragileData=false)
+
+Bugfixes:
+- Race condition: crash while recording and switching OpenTracks into background
+- Search in track list was not working
+- Cycling speed sensor: distance computation was wrong (only affected statistics)
+
+Developer:
+- ControllerFragment replaces TrackController
@@ -0,0 +1,7 @@
+v3.18.2: OpenTracks
+
+Bugfix:
+- Crash while moving from charts to another activity/app #787
+
+Developer:
+- TrackRecordingService pushes data to UI while recording
@@ -0,0 +1,13 @@
+v3.18.3: OpenTracks
+
+Changes:
+- KML parsing does not require order of when/gx:coords
+- Track importer: reorders locations by timestamp
+- Removed rendered launcher icons for Android < 8.0.0 (API 26)
+  (might look slightly different, but avoid problems for reproducible builds)
+
+Bugfix:
+- Avoid crash in charts due to race condition
+
+Developer:
+- Split GPX and KML importer (removed common inheritance)
@@ -0,0 +1,10 @@
+v3.18.4: OpenTracks
+
+Changes:
+- Speed/distance are consistently formatted
+- Intervals tab is now faster
+
+Bugfix:
+- Cycling speed/distance sensor: 
+  - fixed parsing (UINT32)
+  - transmit data to UI properly
@@ -0,0 +1,12 @@
+v3.18.5: OpenTracks
+
+Changes:
+- Voice announcement speed configurable
+- API <26: Launcher icon omits background
+
+Bugfixes:
+- Recording UI: show correct values 
+- Recording UI: show (again) altitude in EGM2008
+
+Developer:
+- Android12 permissions (BLUETOOTH_CONNECT)
@@ -0,0 +1,16 @@
+v3.18.6: OpenTracks
+
+Changes:
+- "Show on map"-functionality via  KML instead of KMZ
+- Voice announcement do not include app name
+- While recording: elevation gain/loss is updated every second
+- Store descriptions translated
+
+Bufixes:
+- Fixed invalid voice announcement translations
+
+Developer:
+- Android12 permissions (BLUETOOTH_SCAN)
+- Android12 permissions (ACCESS_COARSE_LOCATION)
+- Asserting for TrackPoints (testing)
+- Removed unused translations
@@ -0,0 +1,16 @@
+v3.19.0: OpenTracks
+
+Changes:
+- Support for Running Speed and Cadence (RCS) sensors implemented
+- When sharing a track: a share picture is created
+- No vibration when starting a recording
+- While recording: UI shows most recently received altitude, speed, and bearing (even if not stored)
+
+Bugfix:
+- Computation of total duration should not include paused durations (requires re-import)
+- (again) Use custom summaries if present
+
+Developer:
+- Upgrade to SDK31 and AGP7.0.0 (requires JDK11)
+- TrackRecordingService: extacted sensor fusion (TrackPointCreator) and TrackPoint storage (TrackRecordingManager)
+- ExportImportTest is now deterministics/ constant
@@ -0,0 +1,8 @@
+v3.19.1: OpenTracks
+
+Changes:
+- Updated translations.
+
+Bugfix:
+- Export All Tracks bug fixed.
+- Resume Track bug fixed.
@@ -0,0 +1,9 @@
+v3.20.0: OpenTracks
+
+Changes:
+- While recording: statistics UI is now configurable
+
+Bugfix:
+- Changing track name/ category while recording was ignored (introduced in v3.19.0)
+
+
@@ -0,0 +1,7 @@
+v3.20.1: OpenTracks
+
+Changes:
+- Announcements can now be used by both distance and time
+- Announcements beep if no Text-to-speech software is installed
+- Removed adaptive GPS location frequency
+
@@ -0,0 +1,11 @@
+v3.20.2: OpenTracks
+
+Changes:
+- Elevation gain and loss are integers instead of floats
+- Ask for permission before using Bluetooth by a Toast message
+
+Bugfix:
+- Set FLAG_IMMUTABLE for PendingIntents to avoid crash on Android 12
+- Cadence sensor returns 0 instead of None when user is not pedaling
+- Speed sensor returns 0 instead of the last speed when it's stopped
+- With sensors, moving time stops when is not moving
@@ -0,0 +1,19 @@
+v3.21.0: OpenTracks
+
+Changes:
+- While recording: remove idle/non-idle creation of TrackPoints
+- Settings are now in separate folders
+- Opening OpenTracks from notification (while recording) and pressing back opens track list
+- GPX compatibilty: support <speed> for import
+
+Bugfixes:
+- Altitude and distance (from BlE sensor): only reset counters if data was actually stored
+- Import without speed, requires computing speed
+- BLE running sensor not connected, should not be reported as present
+- BLE running sensor: show data while recording
+- Activity type icon was not updated while changing activity
+
+Developer:
+- SharedPrefences via static reference
+- Tests are executed against in-memory database
+- TrackRecordingManager keeps last TrackPoint in memory
@@ -0,0 +1,11 @@
+v3.22.0: OpenTracks
+
+Changes:
+- Locations are only stored if traveled distance > recording distance interval
+  (removed left over functionality from idle/non-idle detection)
+- UI can be configured to show a clock
+- Idle speed is now configurable
+
+Bugfix:
+- Intervals: crash when gain but not loss was stored
+- While recording: prevent crash when disabling voice announcements
@@ -7,4 +7,4 @@ Bugfix:
 -

 Developer:
-
+-
@@ -3,9 +3,9 @@ OpenTracks is a sport tracking application that completely respects your privacy
 Features:
 * Sport tracking: track your sport and outdoor activities
 * Photos and markers: mark interesting locations while tracking
-* Supports Bluetooth LE sensors:
-  * heart rate
-  * cycling: speed and cadence
-  * cycling: power meter
-* Export data: export tracks either as KML or GPX
+* Altitude gain and loss: via barometric sensor
+* Altitude shown in EGM2008 (above mean sea level); exported as WGS84
+* Voice announcements
+* Supports Bluetooth LE sensors: heart rate, speed and distance (cycling), cadence (cycling), and power meter (cycling)
+* Export data: export tracks either as KMZ (incl. photos), KML, or GPX
 * No Internet access: Internet is not used
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`تعقب الرياضة التي تحترم تماما خصوصيتك.`
				`@@ -0,0 +1 @@`
				`Спортно проследяване, което напълно зачита поверителността на личните ви данни.`
				`@@ -0,0 +1 @@`
				`Sportovní tracker, který zcela respektuje vaše soukromí.`
				`@@ -0,0 +1 @@`
				`En sportstracker, der respekterer dit privatliv fuldt ud.`