From f2c04eec1afd48d4424121318b67ab6aafd796bf Mon Sep 17 00:00:00 2001
From: Dennis Guse <dennis.guse@alumni.tu-berlin.de>
Date: Wed, 20 Nov 2019 07:27:56 +0100
Subject: [PATCH] Add help activity. Can be accessed from Settings.

---
 .idea/render.experimental.xml                 |   6 +
 src/main/AndroidManifest.xml                  |   8 +-
 .../dennisguse/opentracks/HelpActivity.java   |   9 +
 src/main/res/layout/help.xml                  | 188 ++++++++++++++++++
 src/main/res/values/strings.xml               |  89 +++++++++
 src/main/res/xml/settings.xml                 |   6 +
 6 files changed, 304 insertions(+), 2 deletions(-)
 create mode 100644 .idea/render.experimental.xml
 create mode 100644 src/main/java/de/dennisguse/opentracks/HelpActivity.java
 create mode 100644 src/main/res/layout/help.xml

diff --git a/.idea/render.experimental.xml b/.idea/render.experimental.xml
new file mode 100644
index 000000000..8ec256a5d
--- /dev/null
+++ b/.idea/render.experimental.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RenderSettings">
+    <option name="showDecorations" value="true" />
+  </component>
+</project>
\ No newline at end of file
diff --git a/src/main/AndroidManifest.xml b/src/main/AndroidManifest.xml
index 818de79db..4587783ef 100644
--- a/src/main/AndroidManifest.xml
+++ b/src/main/AndroidManifest.xml
@@ -32,6 +32,10 @@ limitations under the License.
 
         <activity android:name=".DeleteActivity" />
 
+        <activity
+            android:name=".HelpActivity"
+            android:label="@string/menu_help" />
+
         <activity
             android:name=".io.file.importer.ImportActivity"
             android:theme="@style/ThemeCustomTransparent">
@@ -50,10 +54,10 @@ limitations under the License.
             </intent-filter>
         </activity>
 
-        <activity android:name=".MarkerEditActivity" />
-
         <activity android:name=".MarkerDetailActivity" />
 
+        <activity android:name=".MarkerEditActivity" />
+
         <activity
             android:name=".MarkerListActivity"
             android:label="@string/menu_markers">
diff --git a/src/main/java/de/dennisguse/opentracks/HelpActivity.java b/src/main/java/de/dennisguse/opentracks/HelpActivity.java
new file mode 100644
index 000000000..034c101c0
--- /dev/null
+++ b/src/main/java/de/dennisguse/opentracks/HelpActivity.java
@@ -0,0 +1,9 @@
+package de.dennisguse.opentracks;
+
+public class HelpActivity extends AbstractActivity {
+
+    @Override
+    protected int getLayoutResId() {
+        return R.layout.help;
+    }
+}
diff --git a/src/main/res/layout/help.xml b/src/main/res/layout/help.xml
new file mode 100644
index 000000000..40ecfc9ee
--- /dev/null
+++ b/src/main/res/layout/help.xml
@@ -0,0 +1,188 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
+
+    <include layout="@layout/toolbar" />
+
+    <ScrollView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:padding="20dp">
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_feature_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_feature_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_track_map_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:linksClickable="true"
+                android:text="@string/help_track_map_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_data_statistics_customized_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_data_statistics_customized_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_recording_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_recording_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_gps_imprecise_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_gps_imprecise_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_heart_rate_sensors_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_heart_rate_sensors_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_storage_pictures_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_storage_pictures_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_track_export_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_track_export_content" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_data_upload_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/generic_no" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_data_google_play_services_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/generic_no" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_data_online_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/generic_no" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="20dp"
+                android:text="@string/help_data_storage_title"
+                android:textStyle="bold" />
+
+            <TextView
+                style="@style/TextMedium"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="@string/help_data_storage_content" />
+        </LinearLayout>
+    </ScrollView>
+
+</LinearLayout>
diff --git a/src/main/res/values/strings.xml b/src/main/res/values/strings.xml
index 2e26ef035..e28271e30 100644
--- a/src/main/res/values/strings.xml
+++ b/src/main/res/values/strings.xml
@@ -38,6 +38,95 @@ limitations under the License.
     Libraries
   </string>
 
+  <!-- Help -->
+  <string name="help_feature_title">
+    OpenTracks has the following features:
+  </string>
+  <string name="help_feature_content">
+* Create markers (incl. pictures)\n
+* Heart rate sensor (Bluetooth LE)\n
+* Voice announcements by time or distance\n
+* While recording, show on lock screen\n
+* Share tracks
+  </string>
+
+  <string name="help_data_statistics_customized_title">
+    Can the statistics view be customized?
+  </string>
+  <string name="help_data_statistics_customized_content">
+    Yes, it can be customized in the Settings.
+  </string>
+
+  <string name="help_recording_title">
+    How does OpenTracks record data?
+  </string>
+  <string name="help_recording_content">
+    OpenTracks uses the GPS sensor of the device to record the location continuously.
+  </string>
+
+  <string name="help_gps_imprecise_title">
+    Statistics (e.g., speed) reported by OpenTracks are imprecise?
+  </string>
+  <string name="help_gps_imprecise_content">
+    OpenTracks directly uses the data provided by the GPS of the mobile device.
+    If the GPS device reports inaccurate locations, OpenTracks cannot do anything about it.
+  </string>
+
+  <string name="help_heart_rate_sensors_title">
+    Which heart rate sensors does OpenTracks support?
+  </string>
+  <string name="help_heart_rate_sensors_content">
+    OpenTracks should work with any Bluetooth LE heart sensor that support streaming the data in real-time.
+    Smartwatches that store the heart rate data are not supported.
+  </string>
+
+  <string name="help_track_map_title">
+    How to show a track on a map?
+  </string>
+  <string name="help_track_map_content">
+    This requires a 3rd party application to be installed that can consume KMZ-encoded geo data.
+    This works well with <a href="http://osmand.net/">OsmAnd~</a> and <a href="https://maps.me/">Maps.ME</a>.
+    In fact, an App needs to support <i>ACTION_VIEW</i> with MIME <i>application/vnd.google-earth.kmz</i>.
+    At the moment, the recorded locations as well as the timestamps are send to an App while pictures and sensor data are not shared.
+  </string>
+
+  <string name="help_storage_pictures_title">
+    How does OpenTracks store pictures that were taken as markers?
+  </string>
+  <string name="help_storage_pictures_content">
+    These are stored directly on the file system.
+  </string>
+
+  <string name="help_track_export_title">
+    How can I export/share recorded tracks?
+  </string>
+  <string name="help_track_export_content">
+    Tracks can be exported from the Settings as KMZ, KML, or GPX.
+    KMZ contains all data incl. images, while KML contains only the sensor data, and GPX only the location.
+    Tracks shared via the <i>share icon</i> are shared as KMZ and any App can be used to send the data.
+  </string>
+
+  <string name="help_data_upload_title">
+    Can OpenTracks upload the data automatically?
+  </string>
+
+  <string name="help_data_google_play_services_title">
+    Does OpenTracks require/use Google Play Service?
+  </string>
+
+  <string name="help_data_online_title">
+    Does OpenTracks use online services?
+  </string>
+
+  <string name="help_data_storage_title">
+    How does OpenTracks store sensor data?
+  </string>
+  <string name="help_data_storage_content">
+    OpenTracks stores sensor data per recorded location.
+    In terms of a heart rate sensor this means that only <i>one</i> heart rate measurement is stored per location.
+    If you are standing still or are indoors, no sensor data will be recorded (but it will be shown).
+  </string>
+
   <!-- Activity Type -->
     <string name="activity_type_airplane" translation_description="When entering an 'Activity type', in the auto-complete text box, the
       completion suggestion for airplane.">
diff --git a/src/main/res/xml/settings.xml b/src/main/res/xml/settings.xml
index 332f9dd38..3d9d84c1a 100644
--- a/src/main/res/xml/settings.xml
+++ b/src/main/res/xml/settings.xml
@@ -17,6 +17,12 @@ limitations under the License.
     xmlns:app="http://schemas.android.com/apk/res-auto"
     android:title="@string/menu_settings">
 
+    <Preference android:title="@string/menu_help">
+        <intent
+            android:targetClass="de.dennisguse.opentracks.HelpActivity"
+            android:targetPackage="@string/applicationId" />
+    </Preference>
+
     <PreferenceCategory android:title="@string/track_detail_stats_tab">
         <ListPreference
             android:defaultValue="@string/stats_units_default"