enhance toaster, prepare for release

Author: FredHappyface

CHANGELOG.md

@@ -7,6 +7,16 @@ patch-level version changes can be found in [commit messages](../../commits/mast
 ## Next_Ver
 -->
 
+## 20250209
+
+- Update dependency versions
+- Add a shortcut to google keyboard (fixes #76)
+- Add SVG image support
+- Code quality improvements
+- Use xLog (https://github.com/elvishew/xLog) to capture today's logs (to assist with debugging)
+- Make PNG sticker fallback configurable and improve share sheet (fixes #80)
+- Improve toast logging experience
+
 ## 20240825
 
 - Add case insensitive sort

app/src/main/java/com/fredhappyface/ewesticker/MainActivity.kt

@@ -32,9 +32,9 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import java.io.File
 import java.text.SimpleDateFormat
-import java.util.Locale
 import java.util.Calendar
 import java.util.Date
+import java.util.Locale
 
 /** MainActivity class inherits from the AppCompatActivity class - provides the settings view */
 class MainActivity : AppCompatActivity() {
@@ -61,7 +61,6 @@ class MainActivity : AppCompatActivity() {
 			File(filesDir, "logs").path
 		).fileNameGenerator(DateFileNameGenerator()).build()
 
-
 		XLog.init(logConfig, androidPrinter, filePrinter)
 
 		XLog.i("=".repeat(80))
@@ -111,7 +110,6 @@ class MainActivity : AppCompatActivity() {
 
 	}
 
-
 	/**
 	 * Handles ACTION_OPEN_DOCUMENT_TREE result and adds stickerDirPath, lastUpdateDate to
 	 * this.sharedPreferences and resets recentCache, compatCache
@@ -142,22 +140,22 @@ class MainActivity : AppCompatActivity() {
 
 	private val saveFileLauncher =
 		registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
-		if (result.resultCode == RESULT_OK) {
-			result.data?.data?.also { uri ->
-				val dateFormatter = SimpleDateFormat("yyyy-MM-dd", Locale.US)
-				val currentDate = Date()
-				val logFileName = dateFormatter.format(currentDate)
-				val file = File(filesDir, "logs/$logFileName")
-				if (file.exists()) {
-					contentResolver.openOutputStream(uri)?.use { outputStream ->
-						file.inputStream().use { inputStream ->
-							inputStream.copyTo(outputStream)
+			if (result.resultCode == RESULT_OK) {
+				result.data?.data?.also { uri ->
+					val dateFormatter = SimpleDateFormat("yyyy-MM-dd", Locale.US)
+					val currentDate = Date()
+					val logFileName = dateFormatter.format(currentDate)
+					val file = File(filesDir, "logs/$logFileName")
+					if (file.exists()) {
+						contentResolver.openOutputStream(uri)?.use { outputStream ->
+							file.inputStream().use { inputStream ->
+								inputStream.copyTo(outputStream)
+							}
 						}
 					}
 				}
 			}
 		}
-	}
 
 	/**
 	 * Called on button press to launch settings
@@ -230,14 +228,12 @@ class MainActivity : AppCompatActivity() {
 				StickerImporter(baseContext, toaster, progressBar).importStickers(stickerDirPath)
 
 			withContext(Dispatchers.Main) {
-				toaster.toastOnState(
-					arrayOf(
-						getString(R.string.imported_020, totalStickers),
-						getString(R.string.imported_031, totalStickers),
-						getString(R.string.imported_032, totalStickers),
-						getString(R.string.imported_033, totalStickers),
-					),
-				)
+				if (toaster.messages.size > 0) {
+					toaster.toastOnMessages()
+				} else {
+					toaster.toast(getString(R.string.imported_020, totalStickers))
+				}
+
 				val editor = sharedPreferences.edit()
 				editor.putInt("numStickersImported", totalStickers)
 				editor.apply()

app/src/main/java/com/fredhappyface/ewesticker/utilities/StickerImporter.kt

@@ -7,6 +7,7 @@ import android.os.Looper
 import android.view.View
 import androidx.documentfile.provider.DocumentFile
 import com.elvishew.xlog.XLog
+import com.fredhappyface.ewesticker.R
 
 import com.google.android.material.progressindicator.LinearProgressIndicator
 import kotlinx.coroutines.Dispatchers
@@ -66,7 +67,7 @@ class StickerImporter(
 		val leafNodes = fileWalk(DocumentFile.fromTreeUri(context, Uri.parse(stickerDirPath)))
 		if (leafNodes.size > MAX_FILES) {
 			XLog.w("Found more than $MAX_FILES stickers, notify user")
-			toaster.setState(1)
+			toaster.setMessage(context.getString(R.string.imported_031, MAX_FILES))
 		}
 
 		withContext(Dispatchers.Main) {
@@ -107,12 +108,19 @@ class StickerImporter(
 		val packSize = packSizes[parentDir] ?: 0
 		if (packSize > MAX_PACK_SIZE) {
 			XLog.w("Found more than $MAX_PACK_SIZE stickers in '$parentDir', notify user")
-			toaster.setState(2)
+			toaster.setMessage(context.getString(R.string.imported_032, MAX_PACK_SIZE, parentDir))
 			return
 		}
 		if (sticker.type !in supportedMimes) {
 			XLog.w("'$parentDir/${sticker.name}' is not a supported mimetype (${sticker.type}), notify user")
-			toaster.setState(3)
+			toaster.setMessage(
+				context.getString(
+					R.string.imported_033,
+					sticker.type,
+					parentDir,
+					sticker.name
+				)
+			)
 			return
 		}
 		packSizes[parentDir] = packSize + 1

app/src/main/java/com/fredhappyface/ewesticker/utilities/Toaster.kt

@@ -2,6 +2,7 @@ package com.fredhappyface.ewesticker.utilities
 
 import android.content.Context
 import android.widget.Toast
+import com.elvishew.xlog.XLog
 
 /**
  * The Toaster class provides a simplified interface to android.widget.Toast. Pass in the
@@ -11,7 +12,7 @@ import android.widget.Toast
  * @property context: android.content.Context. e.g. baseContext
  */
 class Toaster(private val context: Context) {
-	private var state = 0
+	var messages: MutableList<String> = mutableListOf()
 
 	/**
 	 * Call toaster.toast with some string to always create a toast notification. Context is set when
@@ -33,31 +34,21 @@ class Toaster(private val context: Context) {
 	}
 
 	/**
-	 * Call toaster.toastOnState with an array of messages to create a toast notification.
-	 * Context is set when Toaster is instantiated. Duration is determined based on
-	 * text length. The message is selected based on the state (which can be set in a callback
-	 * function or elsewhere
 	 *
-	 * @param strings: Array<String>. Array of potential messages to output.
-	 */
-	fun toastOnState(strings: Array<String>) {
-		if (this.state < strings.size) {
-			this.toast(strings[this.state])
-		} else {
-			this.toast("toaster.state=${this.state} out of range strings.size=${strings.size}")
+	 **/
+	fun toastOnMessages() {
+		XLog.i("Messages: [${this.messages.joinToString(", ")}]")
+		for (idx in this.messages.take(3).indices) {
+			this.toast(messages[idx])
 		}
+		this.messages = mutableListOf()
 	}
 
 	/**
-	 * Set the state to some integer value
-	 *
-	 * @param state: Int
-	 */
-	fun setState(state: Int) {
-		if (state < 0) {
-			this.state = 0
-		} else {
-			this.state = state
-		}
+	 * Set a message
+	 **/
+	fun setMessage(message: String) {
+		XLog.i("Adding message: '$message' to toaster")
+		this.messages.add(message)
 	}
 }

app/src/main/res/values-ar/strings.xml

@@ -71,9 +71,6 @@
     <string name="pref_000">تم تغيير التفضيلات. أعد تحميل لوحة المفاتيح لتطبيق الإعدادات</string>
 	<string name="imported_010">بدء عملية الاستيراد. قد يستغرق ذلك بعض الوقت!</string>
 	<string name="imported_020">تم استيراد %1$d ملصق. أعد تحميل لوحة المفاتيح لعرض الملصقات الجديدة</string>
-	<string name="imported_031">E031: فشل بعض الملصقات في الاستيراد (%1$d تم استيرادها). تم الوصول إلى الحد الأقصى للملصقات</string>
-	<string name="imported_032">E032: فشل بعض الملصقات في الاستيراد (%1$d تم استيرادها). تم الوصول إلى الحد الأقصى لحجم الحزمة</string>
-	<string name="imported_033">E033: فشل بعض الملصقات في الاستيراد (%1$d تم استيرادها). تم العثور على تنسيقات غير مدعومة</string>
 	<string name="imported_034">E034: فشلت عملية إعادة تحميل الملصقات، حاول اختيار مجلد مصدر الملصقات</string>
 	<string name="fallback_041">E041: حدث استثناء غير متوقع أثناء تحويل الملصق</string>
 	<!-- Keyboard -->

app/src/main/res/values-bn/strings.xml

@@ -71,9 +71,6 @@ EweSticker কাস্টমাইজেশন বিকল্প, বিভি
     <string name="pref_000">পছন্দস্থান পরিবর্তন হয়েছে। সেটিংস প্রয়োগ করার জন্য কীবোর্ড পুনরায় লোড করুন</string>
 	<string name="imported_010">আমদানি শুরু হয়েছে। এটি কিছু সময় নিতে পারে!</string>
 	<string name="imported_020">%1$d টি স্টিকার আমদানি করা হয়েছে। নতুন স্টিকার দেখানোর জন্য কীবোর্ড পুনরায় লোড করুন</string>
-	<string name="imported_031">E031: কিছু স্টিকার আমদানি করা হয়নি (%1$d টি আমদানি করা হয়েছে)। সর্বাধিক স্টিকার পৌঁছানো হয়েছে</string>
-	<string name="imported_032">E032: কিছু স্টিকার আমদানি করা হয়নি (%1$d টি আমদানি করা হয়েছে)। সর্বমোট প্যাক সাইজ পৌঁছানো হয়েছে</string>
-	<string name="imported_033">E033: কিছু স্টিকার আমদানি করা হয়নি (%1$d টি আমদানি করা হয়েছে)। সমর্থিত ফর্ম্যাট পাওয়া হয়নি</string>
 	<string name="imported_034">E034: স্টিকার পুনরায় লোড করা যায়নি, স্টিকার শোর্স ডিরেক্টরি চয়ন করার চেষ্টা করুন</string>
 	<string name="fallback_041">E041: অপ্রত্যাশিত IOException যখন স্টিকার রুপান্তর করা হয়</string>
 	<!-- Keyboard -->

app/src/main/res/values-de/strings.xml

@@ -71,9 +71,6 @@ EweSticker bietet eine breite Palette an Anpassungsoptionen, vielfältige Format
     <string name="pref_000">Einstellungen geändert. Lade die Tastatur neu, damit die Einstellungen wirksam werden</string>
 	<string name="imported_010">Import wird gestartet. Dies könnte einige Zeit dauern!</string>
 	<string name="imported_020">%1$d Sticker importiert. Lade die Tastatur neu, um neue Sticker anzuzeigen</string>
-	<string name="imported_031">E031: Einige Sticker konnten nicht importiert werden (%1$d importiert). Max. Sticker erreicht</string>
-	<string name="imported_032">E032: Einige Sticker konnten nicht importiert werden (%1$d importiert). Max. Packungsgröße erreicht</string>
-	<string name="imported_033">E033: Einige Sticker konnten nicht importiert werden (%1$d importiert). Nicht unterstützte Formate gefunden</string>
 	<string name="imported_034">E034: Neuladen der Sticker fehlgeschlagen, versuche ein Sticker-Quellverzeichnis auszuwählen</string>
 	<string name="fallback_041">E041: Unerwarteter IOException beim Konvertieren des Stickers</string>
 	<!-- Keyboard -->

app/src/main/res/values-es/strings.xml

@@ -71,9 +71,6 @@ EweSticker ofrece una amplia variedad de opciones de personalización, soporte p
     <string name="pref_000">Preferencias modificadas. Vuelva a cargar el teclado para que se apliquen los ajustes</string>
     <string name="imported_010">Comenzando la importación. ¡Esto puede llevar algún tiempo!</string>
     <string name="imported_020">Importado %1$d stickers. Recargar el teclado para que se muestren los nuevos stickers</string>
-    <string name="imported_031">E031: Algunos stickers han fallado al importar (%1$d importado). Máx. stickers importados</string>
-    <string name="imported_032">E032: No se han podido importar algunos stickers (%1$d importadas). Se ha alcanzado el tamaño máximo del paquete</string>
-    <string name="imported_033">E033: Ha fallado la importación de algunos stickers (%1$d importadas). Se han encontrado formatos no compatibles</string>
     <string name="imported_034">E034: Falló la recarga de stickers, intente elegir un directorio de origen de los stickers</string>
     <string name="fallback_041">E041: IOException inesperado al convertir el sticker</string>
     <!-- Keyboard -->

app/src/main/res/values-fr/strings.xml

@@ -9,7 +9,6 @@
 	<string name="update_sticker_pack_button">Choisissez le répertoire source d’autocollants</string>
 	<string name="reload_sticker_pack_button">Recharger les autocollants</string>
 	<string name="update_sticker_pack_info_path_lbl">- Chemin:</string>
-	<string name="imported_033">E033: Certains autocollants n’ont pas été importés (%1$d importés). Formats non pris en charge trouvés</string>
 	<string name="imported_034">E034: Impossible de recharger les autocollants, essayez de choisir un répertoire source d’autocollants</string>
 	<string name="fallback_041">E041: IOException inattendue lors de la conversion de l’autocollant</string>
 	<string name="update_sticker_pack_info">Informations actuelles sur les autocollants chargés:</string>
@@ -65,8 +64,6 @@ EweSticker offre une large gamme d'options de personnalisation, prend en charge
     <string name="pref_000">Les préférences ont changé. Recharger le clavier pour les appliquer</string>
 	<string name="imported_010">Démarrage de l’importation. Ceci va prendre du temps!</string>
 	<string name="imported_020">Autocollants importés %1$d. Recharger le clavier pour afficher les nouveaux autocollants</string>
-	<string name="imported_031">E031: Certains autocollants n’ont pas été importés (%1$d importés). Nombre maximal atteint</string>
-	<string name="imported_032">E032: Certains autocollants n’ont pas été importés (%1$d importés). Taille maximale du paquet atteint</string>
 	<!-- Keyboard -->
 	<string name="sticker_pack_info">%1$s (Pack : %2$s)</string>
 	<string name="options_insensitive_sort">Activer le tri des paquets sans tenir compte de la casse</string>

app/src/main/res/values-hi/strings.xml

@@ -70,9 +70,6 @@ EweSticker विभिन्न संविदान विकल्पों,
     <string name="pref_000">प्राथमिकताएँ बदल गईं। सेटिंग्स को लागू करने के लिए कीबोर्ड को पुनः लोड करें</string>
 	<string name="imported_010">आयात शुरू हुआ। इसमें कुछ समय लग सकता है!</string>
 	<string name="imported_020">%1$d स्टिकर्स का आयात हुआ। नए स्टिकर्स दिखाने के लिए कीबोर्ड को पुनः लोड करें</string>
-	<string name="imported_031">E031: कुछ स्टिकर्स का आयात असफल रहा (%1$d आयात किए गए)। मैक्सिमम स्टिकर्स तक पहुँच गई है</string>
-	<string name="imported_032">E032: कुछ स्टिकर्स का आयात असफल रहा (%1$d आयात किए गए)। मैक्स पैक आकार तक पहुँच गई है</string>
-	<string name="imported_033">E033: कुछ स्टिकर्स का आयात असफल रहा (%1$d आयात किए गए)। असमर्थित प्रारूप मिला</string>
 	<string name="imported_034">E034: स्टिकर्स को पुनः लोड करने में विफलता हुई, कृपया स्टिकर स्रोत निर्दिष्ट करने का प्रयास करें</string>
 	<string name="fallback_041">E041: स्टिकर कन्वर्ट करते समय अप्रत्याशित IOException</string>
 	<!-- Keyboard -->