Differences

This shows you the differences between two versions of the page.

--- einfachvorlesen [2023/10/16 13:52] – [Download] kalaschnikow
+++ einfachvorlesen [2024/11/04 11:19] (current) – [Ideas for the next release] kalaschnikow
@@ Line 1: / Line 1: @@
+====== Einfachvorlesen ======
+===== Contact =====
+Sascha Frietsch\\
+[[mailto:sf@buttonclick.de]]\\
+Tel: 07250-3311158\\
+Mobil: 0151-59212900
+Albert-Schmidt-Str. 2\\
+Kraichtal
+===== Termine =====
+Plan 1: ca. 15.09.2018 ausliefern -> in vollem Umfang hat es leider nicht geklappt wg. Verzögerungen seitens Stiftung Lesen\\
+Plan 2: ca. 22.09.2018 ausliefern\\
+Wichtig:\\
+.10.2018 - Veranstaltung von der Stiftung Lesen, bei der die App vorgestellt werden soll\\
+.10.2018 - Tag des Vorlesens (bis zu diesem Tag soll die App veröffentlicht werden)
+===== Description =====
+See email from sf@buttonclick.de from 21.06.2018
+Die Website einfachvorlesen.de soll in eine Webview-App für iOS und Android „verpackt“ werden, die in den AppStores heruntergeladen werden kann. Zielgeräte: Handy und Tablet.
+==== Feature Bildergalerie ====
+  * Auf den Seiten der einzelnen Geschichten, z.B. https://www.einfachvorlesen.de/geschichten/sommer-auf-dem-sonnenhof soll ein „Floating Button“ (Design wird geliefert) in der App erscheinen. (My version: If URL contains "einfachvorlesen.de/story/xyz" the app should fetch document "einfachvorlesen.de/story/xyz/images" and parse it. If the document is a valid JSON and contains image URLs the app should display the menu button. )
+  * Beim Klick auf dem Button öffnet sich eine native Bildergalerie (Popup oder anderer Screen…).
+  * In der Galerie sieht man eine Übersicht/ Vorschau aller Bilder der Geschichte
+  * Beim Klick auf dem Bild ist dieses in Vollbildansicht zu sehen
+  * Man kann in Vollbildansicht durch die Bilder wischen
+  * Es gibt keine genauen Vorgaben zum Layout/ Design der Galerie, Popup/ Overlay oder anderes. Es sollte eine einfache Lösung mit einem guten „nativen Bediengefühl“ sein. Vielleicht können Sie hier für iOS und Android ein oder zwei Komponenten empfehlen, wir legen uns für eine Variante fest und liefern bei Bedarf die nötigen Assets.
+  * Auf den Seiten, auf denen keine Geschichte sind (z.B. https://www.einfachvorlesen.de/faq), soll der Button mangels Bilder auch nicht eingeblendet werden.
+  * Die App lädt die Liste der Geschichtenbilder über eine definierte Url, z.B. https://www.einfachvorlesen.de/geschichten/sommer-auf-dem-sonnenhof/app-images
+  * Als Antwort wird ein JSON Array mit Bild-Urls geliefert
+==== Feature Pushbenachrichtigungen ====
+  * Die Apps sollen Google Firebase basierte Notification messages unterstützen. Momentan ist geplant, 1x wöchentlich eine kurze Textnachricht darüber zu versenden.
+  * Nachrichten, die eintreffen, wenn die App nicht aktiv ist, werden vom System angezeigt. Da es sich aktuell nur um Textnachrichten handelt, ist diese Funktionalität wohl durch eine einfache Konfiguration möglich.
+  * Wenn die App aktiv ist, sollen eintreffende Textnachrichten in der App als Popup anzeigt werden.
+==== Testerliste für Google Play ====
+  * Melanie.wuertz@stiftunglesen.de (15.09.2018 - ungültig->kein Google Account verknüpft)
+  * Tina.seibert@stiftunglesen.de (15.09.2018 - ungültig->kein Google Account verknüpft)
+  * Daniel.schnock@stiftunglesen.de
+  * Sandra.kinzinger@deutschebahn.com (15.09.2018 - ungültig->kein Google Account verknüpft)
+  * info@brandschmie.de
+===== Passwörter etc =====
+==== PlayStore Zugang(?) ====
+stiftunglesen2013@gmail.com
+Lesen2012%
+Ich glaube nicht, dass es Zugangsdaten zu PlayStore sind, hab aber auch keine Lust es jetzt auszuprobieren :)
+==== Notizen zu den Zertifikaten ====
+Passwort zum Zertifikat: Lesen2018%
+=== Android keystore ===
+This was used for version ''einfachvorlesen-prod-release__1.0.13-20230421.aab''
+Passwort for Android keystore: Lesen2012%\\
+Key Alias: key0\\
+Key password: Lesen2012%\\
+== Old(?) info ==
+Passwort for Android keystore: Lesen2018%\\
+Key Alias: Key0 (oder 'key0'?)\\
+Key password: Lesen2018%\\
+===== Описание по-русски =====
+https://docs.google.com/document/d/10iGsoPcQT7zERJeMV66-sPYIvxNx2CpYUaioYjKeX9E/edit#heading=h.gc6rmckvaltv
+===== Galerie =====
+Library implementing image gallery: [[https://github.com/mzelzoghbi/ZGallery|ZGallery]]
+===== Download =====
+http://technoranch.blogspot.com/2014/09/downloading-file-from-android-webview.html
+https://developer.android.com/training/permissions/requesting
+[[https://www.rockandnull.com/downloading-files-in-android-with-downloadmanager/|Downloading Files in Android with DownloadManager]] - very useful info for Android 10+
+===== Firebase Cloud Messaging =====
+[[https://console.firebase.google.com/project/einfachvorlesen/notification|Test project "Einfachvorlesen"]]
+[[https://github.com/firebase/quickstart-android/tree/master/messaging|FCM example app by Google]]
+[[https://android-developers.googleblog.com/2018/09/notifying-your-users-with-fcm.html|Notifying your users with FCM]] - an article on Android Developers (which I didn't used, but it is listed here, because maybe I will use it in future)
+===== Problems =====
+==== Problem with vector drawable having shadow ====
+https://medium.com/@javan.z.wang/best-practices-for-creating-and-exporting-vector-assets-in-sketch-a84df7f7c11f
+==== Restore WebView scroll position ====
+https://stackoverflow.com/questions/40020820/restore-webview-scroll-position
+https://stackoverflow.com/questions/6855715/maintain-webview-content-scroll-position-on-orientation-change/7011229
+==== Save webview's session after destroying the activity on Android ====
+https://stackoverflow.com/questions/43578948/save-webviews-session-after-destroying-the-activity-on-android
+==== Android webview and device orientation changing ====
+https://coderwall.com/p/kd8ing/android-webview-and-device-orientation-changing
+https://stackoverflow.com/questions/1002085/android-webview-handling-orientation-changes
+===== Misc =====
+Einladungslink für Google PlayStore: https://play.google.com/apps/internaltest/4698765410565868358
+==== Notizen zu iOS ====
+Hier meine Notizen dazu wie man eine neue Version aus dem XCode erstellt. Sie sind aber überhaupt nicht vollständig. Ich hab nur das aufgeschrieben, was ich konnte. D.h. manche Schritte sind rausgelassen und diese Notizen sind nur als Stichpunkte zu sehen.
+Generic iOS device
+Product/Archive
+Prod Certificate
+Invite
+TestFlight -> Redeem
+itunesconnect.apple.com
+SKU 094415
+===== TODO =====
+===== 03.09.2018 =====
+==== Beide ====
+  * **-** App Icon
+  * **-** Text für DSGVO-Dialog
+==== Android ====
+  * **+** Download Permission Check
+  * **+** Account für Play Store
+  * **+** create new Firebase project bound to Play Store account
+  * **+** use new Firebase project
+  * **-** new notification icon for Firebase notifications
+==== iOS ====
+  * URL-Parameter src=app
+  * Navigationsmenü
+    * Icons
+    * Use font "Roboto"
+  * Account für AppStore
+  * Nachweis darüber, dass die Übergabe des Downloads an eine spezielle App auf iOS nicht funktioniert
+  * встроить иконки в меню (иконки к каждому пункту и иконка заголовка)
+  * встроить иконку приложения
+  * переставить шрифт в меню на Roboto (скачать можно отсюда https://fonts.google.com/specimen/Roboto?selection.family=Roboto:700)
+  * встроить диалоговое окно с текстом пользовательского соглашения (текст пришлю позже, пока используй любой, нужно только, чтоб это был HTML)
+  * скачать сертификаты с AppStore
+  * закачать их в проект Firebase
+  * опубликовать бету приложения в AppStore
+  * на время тестов использовать сайт http://dev.einfachvorlesen.de Это касается всех пунктов меню.
+  * передавать с каждым HTTP-запросом параметр src со значением app. Т.е. типа того: http://dev.einfachvorlesen.de?src=app Это ему нужно чтоб убирать меню с сайта, если сайт загружается через мобильное приложение.
+  * Кроме того, нужно подтверждение того, что обработка PDF нельзя переложить на внешнее приложение (типа iBooks).
+===== 21.09.2018 =====
+==== Android ====
+  * **+** Implementieren "Gallery On / Gallery Off"
+  * **+** Datenschutzerklärung
+  * **+** Menüpunkte
+    * Startseite
+    * Geschichten
+    * Vorlesetipps
+    * Noch Fragen?
+    * Newsletteranmeldung
+    * Impressum
+    * Datenschutz
+  * **+** Im Headerbereich der App soll „einfach vorlesen!“ immer klein geschrieben werden
+  * **+** "Bessere" Trennung der Bilder in der Galerie
+  * **+** Datenschutzerklärung kommt mehrfach, wenn man auf Home-Taste drückt und wieder zurückkehrt
+  * **-** Fix history (one entry too much)
+  * **-** Scrollposition beim Drehen des Bildschirms speichern (wenn das geht)
+==== iOS ====
+  * **+** Implementieren "Gallery On / Gallery Off"
+  * **+** Datenschutzerklärung
+  * **+** Menüpunkte
+    * Startseite
+    * Geschichten
+    * Vorlesetipps
+    * Noch Fragen?
+    * Newsletteranmeldung
+    * Impressum
+    * Datenschutz
+  * **+** Im Headerbereich der App soll „einfach vorlesen!“ immer klein geschrieben werden
+  * **x** Galerie "Android-mäßig" aufbauen (geht nicht)
+===== 03.10.2018 =====
+==== Android ====
+  * **-** Text der Datenschutzerklärung muss noch geändert werden
+  * **-** Die Web-Adresse von "dev" auf "www" umbiegen
+==== iOS ====
+  * **-** Text der Datenschutzerklärung muss noch geändert werden
+  * **-** Die Web-Adresse von "dev" auf "www" umbiegen
+===== 31.03.2023 =====
+==== Android ====
+  * **+** Die App für Android SDK 33 kompilieren
+    * **+** move from support libraries to AndroidX
+    * **+** update libraries
+      * at the moment the oldest possible libraries are used, because the newest do not work with SDK 16 (our minSDK)
+  * **-** Send the APK to Sven
+===== 1.0.14 =====
+==== Android ====
+  * **-** Add a new menu item to the drawer menu
+    * at the moment added as "Test"
+  * **-** Downgrade the Android SDK to 32
+    * the downgrade is the simplest way to handle of ''android.permission.WRITE_EXTERNAL_STORAGE'' permission problems
+      * this permission is necessary to download PDF files from WebView (sometimes the children books have a "Download" link where the user can download the story as PDF file). Until SDK 32 simply setting this permission was enough, but since SDK 33 it is not more possible. New mechanisms should be used.
+  * **-** Send the APK to Sven
+===== Next release =====
+==== Ideas for the next release ====
+  * Check all changes, which are suggested by PlayStore users
+  * Bug fixes:
+    * change the color of selected item in the menu (see our WhatsApp chat with Sven on 23.10.2023)
+    * [[PendingIntent Mutability]]
+      * I think it should be fixed in the next version
+        * -> ask Sven (ca. 0,5 days(?))