From 6d200d14acce00a877c0cfa24b1bf4ae9c42a2ab Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 27 Feb 2024 19:50:29 -0500
Subject: [PATCH 001/458] nuke asn1c in Android.bp and Android.mk

---
 libs/lpac-jni/src/main/jni/Android.bp | 12 ------------
 libs/lpac-jni/src/main/jni/Android.mk | 12 +-----------
 2 files changed, 1 insertion(+), 23 deletions(-)

diff --git a/libs/lpac-jni/src/main/jni/Android.bp b/libs/lpac-jni/src/main/jni/Android.bp
index c710a1690..ce622de5c 100644
--- a/libs/lpac-jni/src/main/jni/Android.bp
+++ b/libs/lpac-jni/src/main/jni/Android.bp
@@ -13,16 +13,6 @@ cc_library_static {
     ],
 }
 
-cc_library_static {
-    name: "liblpac-asn1c",
-    defaults: ["lpac-jni-defaults"],
-    local_include_dirs: ["lpac/euicc/asn1c"],
-    cflags: ["-DHAVE_CONFIG_H"],
-    srcs: [
-        "lpac/euicc/asn1c/asn1/*.c",
-    ],
-}
-
 cc_library_static {
     name: "liblpac-euicc",
     defaults: ["lpac-jni-defaults"],
@@ -30,7 +20,6 @@ cc_library_static {
         "lpac/euicc/*.c",
     ],
     static_libs: [
-        "liblpac-asn1c",
         "liblpac-cjson",
     ],
 }
@@ -44,7 +33,6 @@ cc_library_shared {
     ],
     static_libs: [
         "liblpac-euicc",
-        "liblpac-asn1c",
         "liblpac-cjson",
     ],
     shared_libs: ["liblog"],
diff --git a/libs/lpac-jni/src/main/jni/Android.mk b/libs/lpac-jni/src/main/jni/Android.mk
index 0a216b326..c0bcee725 100644
--- a/libs/lpac-jni/src/main/jni/Android.mk
+++ b/libs/lpac-jni/src/main/jni/Android.mk
@@ -14,20 +14,10 @@ LOCAL_SRC_FILES := \
 	$(call all-c-files-under, lpac/cjson)
 include $(BUILD_STATIC_LIBRARY)
 
-include $(CLEAR_VARS)
-# libasn1c, the ASN parser component from lpac
-LOCAL_MODULE := lpac-asn1c
-LOCAL_C_INCLUDES := \
-	$(LOCAL_PATH)/lpac/euicc/asn1c
-LOCAL_SRC_FILES := \
-	$(call all-c-files-under, lpac/euicc/asn1c/asn1)
-LOCAL_CFLAGS := -DHAVE_CONFIG_H
-include $(BUILD_STATIC_LIBRARY)
-
 include $(CLEAR_VARS)
 # libeuicc component from lpac, which contains the actual implementation
 LOCAL_MODULE := lpac-euicc
-LOCAL_STATIC_LIBRARIES := lpac-asn1c lpac-cjson
+LOCAL_STATIC_LIBRARIES := lpac-cjson
 LOCAL_C_INCLUDES := \
 	$(LOCAL_PATH)/lpac
 LOCAL_SRC_FILES := \

From a1b264362509d0d8bc358101719f8251cca43b5e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 27 Feb 2024 20:06:08 -0500
Subject: [PATCH 002/458] lpac-jni: Always add GSMA ROOT CI1

---
 .../main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index 84fa227b9..f3e5e9019 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -24,8 +24,9 @@ internal fun keyIdToKeystore(keyIds: Array<String>): KeyStore {
         }
     }
 
-    // If no known certs have been added, add at least the default GSMA CI
-    if (ret.size() == 0) {
+    // At the very least, we should always have GSMA ROOT CI1 trusted
+    // many servers supporting custom roots are served with GSMA ROOT CI1 for TLS
+    if (!ret.isCertificateEntry(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1)) {
         getCertificate(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1)?.let { cert ->
             ret.setCertificateEntry(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1, cert)
         }

From 62e3e41c52ee224f41e63865c22f257e314520c2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 28 Feb 2024 19:57:47 -0500
Subject: [PATCH 003/458] lpac-jni: Mark network-related LPA methods as
 synchronized

These methods rely on non-thread-safe internal states within lpac's
context.
---
 .../net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 072fcaa1b..b81a41ad9 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -115,6 +115,7 @@ class LocalProfileAssistantImpl(
         return LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
     }
 
+    @Synchronized
     override fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
                                  confirmationCode: String?, callback: ProfileDownloadCallback): Boolean {
         return LpacJni.downloadProfile(contextHandle, smdp, matchingId, imei, confirmationCode, callback) == 0
@@ -123,6 +124,7 @@ class LocalProfileAssistantImpl(
     override fun deleteNotification(seqNumber: Long): Boolean =
         LpacJni.es10bDeleteNotification(contextHandle, seqNumber) == 0
 
+    @Synchronized
     override fun handleNotification(seqNumber: Long): Boolean =
         LpacJni.handleNotification(contextHandle, seqNumber).also {
             Log.d(TAG, "handleNotification $seqNumber = $it")

From c0d1c29b7fcd21803e8174fdf522fbda215fd249 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 3 Mar 2024 10:55:35 -0500
Subject: [PATCH 004/458] feat: Show error logs on crash when unprivileged

...however, don't do this in privileged mode because OpenEuiccService is
supposed to be background, and we don't want to just randomly show up
when things go wrong.
---
 .../im/angry/openeuicc/ui/LogsActivity.kt     | 12 ++--------
 .../java/im/angry/openeuicc/util/Utils.kt     | 11 +++++++++
 app-unpriv/src/main/AndroidManifest.xml       |  2 +-
 .../UnprivilegedOpenEuiccApplication.kt       | 23 +++++++++++++++++++
 4 files changed, 37 insertions(+), 11 deletions(-)
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 9a2a8559b..ba15e3731 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -8,6 +8,7 @@ import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -44,16 +45,7 @@ class LogsActivity : AppCompatActivity() {
     private suspend fun reload() = withContext(Dispatchers.Main) {
         swipeRefresh.isRefreshing = true
 
-        val logStr = withContext(Dispatchers.IO) {
-            try {
-                Runtime.getRuntime().exec("logcat -t 1024").inputStream.readBytes()
-                    .decodeToString()
-            } catch (_: Exception) {
-                ""
-            }
-        }
-
-        logText.text = logStr
+        logText.text = intent.extras?.getString("log") ?: readSelfLog()
 
         swipeRefresh.isRefreshing = false
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index b2690b0f4..dc90ab1ff 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -8,9 +8,11 @@ import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
+import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
+import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileInfo
 import java.lang.RuntimeException
 import kotlin.coroutines.resume
@@ -26,6 +28,15 @@ val Context.selfAppVersion: String
             throw RuntimeException(e)
         }
 
+suspend fun readSelfLog(lines: Int = 2048): String = withContext(Dispatchers.IO) {
+    try {
+        Runtime.getRuntime().exec("logcat -t $lines").inputStream.readBytes()
+            .decodeToString()
+    } catch (_: Exception) {
+        ""
+    }
+}
+
 interface OpenEuiccContextMarker {
     val openEuiccMarkerContext: Context
         get() = when (this) {
diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index bce68312e..e72b11245 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -2,7 +2,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
     <application
-        android:name="im.angry.openeuicc.OpenEuiccApplication"
+        android:name="im.angry.openeuicc.UnprivilegedOpenEuiccApplication"
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
new file mode 100644
index 000000000..23e7be9d0
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
@@ -0,0 +1,23 @@
+package im.angry.openeuicc
+
+import android.content.Intent
+import im.angry.openeuicc.ui.LogsActivity
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.runBlocking
+import kotlin.system.exitProcess
+
+class UnprivilegedOpenEuiccApplication : OpenEuiccApplication() {
+    override fun onCreate() {
+        super.onCreate()
+
+        Thread.setDefaultUncaughtExceptionHandler { _, _ ->
+            Intent(this, LogsActivity::class.java).apply {
+                addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK)
+                addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+                putExtra("log", runBlocking { readSelfLog() })
+                startActivity(this)
+                exitProcess(-1)
+            }
+        }
+    }
+}
\ No newline at end of file

From e48a919335583f1f86d6955a1fc41ce42bb219ee Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 3 Mar 2024 13:22:46 -0500
Subject: [PATCH 005/458] feat: Allow exporting logs as txt

---
 .../im/angry/openeuicc/ui/LogsActivity.kt     | 31 +++++++++++++++++++
 .../main/res/drawable/ic_save_as_black.xml    |  5 +++
 .../src/main/res/menu/activity_logs.xml       |  9 ++++++
 app-common/src/main/res/values/strings.xml    |  3 ++
 4 files changed, 48 insertions(+)
 create mode 100644 app-common/src/main/res/drawable/ic_save_as_black.xml
 create mode 100644 app-common/src/main/res/menu/activity_logs.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index ba15e3731..1a7e50f8f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -1,9 +1,13 @@
 package im.angry.openeuicc.ui
 
+import android.icu.text.SimpleDateFormat
 import android.os.Bundle
+import android.view.Menu
+import android.view.MenuItem
 import android.view.View
 import android.widget.ScrollView
 import android.widget.TextView
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
@@ -12,12 +16,24 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
+import java.io.FileOutputStream
+import java.util.Date
 
 class LogsActivity : AppCompatActivity() {
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var scrollView: ScrollView
     private lateinit var logText: TextView
 
+    private val saveLogs =
+        registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
+            if (uri == null) return@registerForActivityResult
+            contentResolver.openFileDescriptor(uri, "w")?.use {
+                FileOutputStream(it.fileDescriptor).use { os ->
+                    os.write(logText.text.toString().encodeToByteArray())
+                }
+            }
+        }
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_logs)
@@ -42,6 +58,21 @@ class LogsActivity : AppCompatActivity() {
         }
     }
 
+    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
+        menuInflater.inflate(R.menu.activity_logs, menu)
+        return true
+    }
+
+    override fun onOptionsItemSelected(item: MenuItem): Boolean = when (item.itemId) {
+        R.id.save -> {
+            saveLogs.launch(getString(R.string.logs_filename_template,
+                SimpleDateFormat.getDateTimeInstance().format(Date())
+            ))
+            true
+        }
+        else -> super.onOptionsItemSelected(item)
+    }
+
     private suspend fun reload() = withContext(Dispatchers.Main) {
         swipeRefresh.isRefreshing = true
 
diff --git a/app-common/src/main/res/drawable/ic_save_as_black.xml b/app-common/src/main/res/drawable/ic_save_as_black.xml
new file mode 100644
index 000000000..aaee67852
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_save_as_black.xml
@@ -0,0 +1,5 @@
+<vector android:height="24dp" android:tint="?attr/colorControlNormal"
+    android:viewportHeight="24" android:viewportWidth="24"
+    android:width="24dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@android:color/white" android:pathData="M21,12.4V7l-4,-4H5C3.89,3 3,3.9 3,5v14c0,1.1 0.89,2 2,2h7.4L21,12.4zM15,15c0,1.66 -1.34,3 -3,3s-3,-1.34 -3,-3s1.34,-3 3,-3S15,13.34 15,15zM6,6h9v4H6V6zM19.99,16.25l1.77,1.77L16.77,23H15v-1.77L19.99,16.25zM23.25,16.51l-0.85,0.85l-1.77,-1.77l0.85,-0.85c0.2,-0.2 0.51,-0.2 0.71,0l1.06,1.06C23.45,16 23.45,16.32 23.25,16.51z"/>
+</vector>
diff --git a/app-common/src/main/res/menu/activity_logs.xml b/app-common/src/main/res/menu/activity_logs.xml
new file mode 100644
index 000000000..4fa3aeb0b
--- /dev/null
+++ b/app-common/src/main/res/menu/activity_logs.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/save"
+        android:icon="@drawable/ic_save_as_black"
+        android:title="@string/logs_save"
+        app:showAsAction="always" />
+</menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 9d8932a6c..040c910fc 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -48,6 +48,9 @@
     <string name="profile_notification_process">Process</string>
     <string name="profile_notification_delete">Delete</string>
 
+    <string name="logs_save">Save</string>
+    <string name="logs_filename_template">Logs at %s</string>
+
     <string name="pref_settings">Settings</string>
     <string name="pref_notifications">Notifications</string>
     <string name="pref_notifications_desc">eSIM profile operations send notifications to the carrier. Fine-tune this behavior as needed here.</string>

From 770083523db3cec28184edf8a169a5eafd09e1d8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 3 Mar 2024 20:29:18 -0500
Subject: [PATCH 006/458] refactor: Extract an interface from
 EuiccChannelManager

Eventually, we would like EuiccChannelManager to become a Service
instead of just any random class.
---
 .../angry/openeuicc/OpenEuiccApplication.kt   |  3 +-
 .../openeuicc/core/EuiccChannelManager.kt     | 84 ++++++++++---------
 .../openeuicc/core/IEuiccChannelManager.kt    | 47 +++++++++++
 .../im/angry/openeuicc/ui/MainActivity.kt     | 13 +--
 .../java/im/angry/openeuicc/util/Utils.kt     |  4 +-
 .../PrivilegedOpenEuiccApplication.kt         |  4 +-
 .../util/PrivilegedTelephonyUtils.kt          |  6 +-
 7 files changed, 105 insertions(+), 56 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt b/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
index e917aec23..0b2ccecd0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
@@ -5,6 +5,7 @@ import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
 import com.google.android.material.color.DynamicColors
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.IEuiccChannelManager
 import im.angry.openeuicc.util.PreferenceRepository
 
 open class OpenEuiccApplication : Application() {
@@ -19,7 +20,7 @@ open class OpenEuiccApplication : Application() {
         getSystemService(TelephonyManager::class.java)!!
     }
 
-    open val euiccChannelManager: EuiccChannelManager by lazy {
+    open val euiccChannelManager: IEuiccChannelManager by lazy {
         EuiccChannelManager(this)
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 23c21b90b..e0317942f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -13,7 +13,7 @@ import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
 import java.lang.IllegalArgumentException
 
-open class EuiccChannelManager(protected val context: Context) {
+open class EuiccChannelManager(protected val context: Context) : IEuiccChannelManager {
     companion object {
         const val TAG = "EuiccChannelManager"
     }
@@ -32,9 +32,9 @@ open class EuiccChannelManager(protected val context: Context) {
         get() = (0..<tm.activeModemCountCompat).map { FakeUiccCardInfoCompat(it) }
 
     private suspend fun ensureSEService() {
-         if (seService == null) {
-             seService = connectSEService(context)
-         }
+        if (seService == null) {
+            seService = connectSEService(context)
+        }
     }
 
     protected open fun tryOpenEuiccChannelPrivileged(port: UiccPortInfoCompat): EuiccChannel? {
@@ -52,7 +52,10 @@ open class EuiccChannelManager(protected val context: Context) {
             return OmapiChannel(seService!!, port)
         } catch (e: IllegalArgumentException) {
             // Failed
-            Log.w(TAG, "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}.")
+            Log.w(
+                TAG,
+                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
+            )
         }
 
         return null
@@ -61,7 +64,8 @@ open class EuiccChannelManager(protected val context: Context) {
     private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
         lock.withLock {
             ensureSEService()
-            val existing = channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
+            val existing =
+                channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
             if (existing != null) {
                 if (existing.valid && port.logicalSlotIndex == existing.logicalSlotId) {
                     return existing
@@ -90,7 +94,7 @@ open class EuiccChannelManager(protected val context: Context) {
         }
     }
 
-    fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
+    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
         runBlocking {
             withContext(Dispatchers.IO) {
                 for (card in uiccCards) {
@@ -105,54 +109,60 @@ open class EuiccChannelManager(protected val context: Context) {
             }
         }
 
-    fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? = runBlocking {
-        withContext(Dispatchers.IO) {
+    override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
+        runBlocking {
+            withContext(Dispatchers.IO) {
+                for (card in uiccCards) {
+                    if (card.physicalSlotIndex != physicalSlotId) continue
+                    for (port in card.ports) {
+                        tryOpenEuiccChannel(port)?.let { return@withContext it }
+                    }
+                }
+
+                null
+            }
+        }
+
+    override fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? =
+        runBlocking {
             for (card in uiccCards) {
                 if (card.physicalSlotIndex != physicalSlotId) continue
-                for (port in card.ports) {
-                    tryOpenEuiccChannel(port)?.let { return@withContext it }
+                return@runBlocking card.ports.mapNotNull { tryOpenEuiccChannel(it) }
+                    .ifEmpty { null }
+            }
+            return@runBlocking null
+        }
+
+    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
+        runBlocking {
+            withContext(Dispatchers.IO) {
+                uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
+                    card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
                 }
             }
-
-            null
         }
-    }
 
-    fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? = runBlocking {
-        for (card in uiccCards) {
-            if (card.physicalSlotIndex != physicalSlotId) continue
-            return@runBlocking card.ports.mapNotNull { tryOpenEuiccChannel(it) }
-                .ifEmpty { null }
-        }
-        return@runBlocking null
-    }
-
-    fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? = runBlocking {
-        withContext(Dispatchers.IO) {
-            uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
-                card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
-            }
-        }
-    }
-
-    suspend fun enumerateEuiccChannels() {
+    override suspend fun enumerateEuiccChannels() {
         withContext(Dispatchers.IO) {
             ensureSEService()
 
             for (uiccInfo in uiccCards) {
                 for (port in uiccInfo.ports) {
                     if (tryOpenEuiccChannel(port) != null) {
-                        Log.d(TAG, "Found eUICC on slot ${uiccInfo.physicalSlotIndex} port ${port.portIndex}")
+                        Log.d(
+                            TAG,
+                            "Found eUICC on slot ${uiccInfo.physicalSlotIndex} port ${port.portIndex}"
+                        )
                     }
                 }
             }
         }
     }
 
-    val knownChannels: List<EuiccChannel>
+    override val knownChannels: List<EuiccChannel>
         get() = channels.toList()
 
-    fun invalidate() {
+    override fun invalidate() {
         for (channel in channels) {
             channel.close()
         }
@@ -161,8 +171,4 @@ open class EuiccChannelManager(protected val context: Context) {
         seService?.shutdown()
         seService = null
     }
-
-    open fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
-        // No-op for unprivileged
-    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt
new file mode 100644
index 000000000..8a6ab5456
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt
@@ -0,0 +1,47 @@
+package im.angry.openeuicc.core
+
+interface IEuiccChannelManager {
+    val knownChannels: List<EuiccChannel>
+
+    /**
+     * Scan all possible sources for EuiccChannels and have them cached for future use
+     */
+    suspend fun enumerateEuiccChannels()
+
+    /**
+     * Returns the EuiccChannel corresponding to a **logical** slot
+     */
+    fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
+
+    /**
+     * Returns the first EuiccChannel corresponding to a **physical** slot
+     * If the physical slot supports MEP and has multiple ports, it is undefined
+     * which of the two channels will be returned.
+     */
+    fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel?
+
+    /**
+     * Returns all EuiccChannels corresponding to a **physical** slot
+     * Multiple channels are possible in the case of MEP
+     */
+    fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>?
+
+    /**
+     * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
+     */
+    fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
+
+    /**
+     * Invalidate all EuiccChannels previously known by this Manager
+     */
+    fun invalidate()
+
+    /**
+     * If possible, trigger the system to update the cached list of profiles
+     * This is only expected to be implemented when the application is privileged
+     * TODO: Remove this from the common interface
+     */
+    fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
+        // no-op by default
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 452ed7641..af6cbf455 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -14,7 +14,6 @@ import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
@@ -25,8 +24,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
         const val TAG = "MainActivity"
     }
 
-    protected lateinit var manager: EuiccChannelManager
-
     private lateinit var spinnerAdapter: ArrayAdapter<String>
     private lateinit var spinner: Spinner
 
@@ -45,8 +42,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
 
         tm = telephonyManager
 
-        manager = euiccChannelManager
-
         spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
 
         lifecycleScope.launch {
@@ -99,19 +94,19 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
 
     private suspend fun init() {
         withContext(Dispatchers.IO) {
-            manager.enumerateEuiccChannels()
-            manager.knownChannels.forEach {
+            euiccChannelManager.enumerateEuiccChannels()
+            euiccChannelManager.knownChannels.forEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
                 Log.d(TAG, it.lpa.eID)
                 // Request the system to refresh the list of profiles every time we start
                 // Note that this is currently supposed to be no-op when unprivileged,
                 // but it could change in the future
-                manager.notifyEuiccProfilesChanged(it.logicalSlotId)
+                euiccChannelManager.notifyEuiccProfilesChanged(it.logicalSlotId)
             }
         }
 
         withContext(Dispatchers.Main) {
-            manager.knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
+            euiccChannelManager.knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
                 fragments.add(createEuiccManagementFragment(channel))
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index dc90ab1ff..3c218982f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -7,7 +7,7 @@ import android.telephony.TelephonyManager
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.IEuiccChannelManager
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
@@ -48,7 +48,7 @@ interface OpenEuiccContextMarker {
     val openEuiccApplication: OpenEuiccApplication
         get() = openEuiccMarkerContext.applicationContext as OpenEuiccApplication
 
-    val euiccChannelManager: EuiccChannelManager
+    val euiccChannelManager: IEuiccChannelManager
         get() = openEuiccApplication.euiccChannelManager
 
     val telephonyManager: TelephonyManager
diff --git a/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt b/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
index 8b3ef996d..28ea49d2e 100644
--- a/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
+++ b/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
@@ -1,10 +1,10 @@
 package im.angry.openeuicc
 
-import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.IEuiccChannelManager
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
 
 class PrivilegedOpenEuiccApplication: OpenEuiccApplication() {
-    override val euiccChannelManager: EuiccChannelManager by lazy {
+    override val euiccChannelManager: IEuiccChannelManager by lazy {
         PrivilegedEuiccChannelManager(this)
     }
 
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 4675ab9c9..4cb493217 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -4,7 +4,7 @@ import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
 import android.telephony.UiccSlotMapping
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.IEuiccChannelManager
 import kotlinx.coroutines.runBlocking
 import java.lang.Exception
 
@@ -14,7 +14,7 @@ val TelephonyManager.supportsDSDS: Boolean
 val TelephonyManager.dsdsEnabled: Boolean
     get() = activeModemCount >= 2
 
-fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled: Boolean) {
+fun TelephonyManager.setDsdsEnabled(euiccManager: IEuiccChannelManager, enabled: Boolean) {
     runBlocking {
         euiccManager.enumerateEuiccChannels()
     }
@@ -32,7 +32,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled:
 // Disable eSIM profiles before switching the slot mapping
 // This ensures that unmapped eSIM ports never have "ghost" profiles enabled
 fun TelephonyManager.updateSimSlotMapping(
-    euiccManager: EuiccChannelManager, newMapping: Collection<UiccSlotMapping>,
+    euiccManager: IEuiccChannelManager, newMapping: Collection<UiccSlotMapping>,
     currentMapping: Collection<UiccSlotMapping> = simSlotMapping
 ) {
     val unmapped = currentMapping.filterNot { mapping ->

From 2d1c96023a8669036dc2652e13414bcb4f05a893 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 17:17:20 -0500
Subject: [PATCH 007/458] refactor: Condense dependency management to a
 rudimentary dependency injection subpackage

---
 .../angry/openeuicc/OpenEuiccApplication.kt   | 27 +++++--------------
 .../openeuicc/core/EuiccChannelManager.kt     |  2 +-
 .../im/angry/openeuicc/di/AppContainer.kt     | 13 +++++++++
 .../angry/openeuicc/di/DefaultAppContainer.kt | 26 ++++++++++++++++++
 .../openeuicc/ui/ProfileDownloadFragment.kt   |  2 +-
 .../java/im/angry/openeuicc/util/Utils.kt     |  8 ++++--
 .../PrivilegedOpenEuiccApplication.kt         |  9 ++++---
 .../core/PrivilegedEuiccChannelManager.kt     |  2 +-
 .../openeuicc/di/PrivilegedAppContainer.kt    | 11 ++++++++
 .../openeuicc/service/OpenEuiccService.kt     |  2 +-
 .../openeuicc/ui/PrivilegedMainActivity.kt    |  2 +-
 .../angry/openeuicc/ui/SlotMappingFragment.kt | 16 +++++------
 12 files changed, 78 insertions(+), 42 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
 create mode 100644 app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt b/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
index 0b2ccecd0..6cd22ce04 100644
--- a/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/OpenEuiccApplication.kt
@@ -1,34 +1,19 @@
 package im.angry.openeuicc
 
 import android.app.Application
-import android.telephony.SubscriptionManager
-import android.telephony.TelephonyManager
 import com.google.android.material.color.DynamicColors
-import im.angry.openeuicc.core.EuiccChannelManager
-import im.angry.openeuicc.core.IEuiccChannelManager
-import im.angry.openeuicc.util.PreferenceRepository
+import im.angry.openeuicc.di.AppContainer
+import im.angry.openeuicc.di.DefaultAppContainer
 
 open class OpenEuiccApplication : Application() {
+    open val appContainer: AppContainer by lazy {
+        DefaultAppContainer(this)
+    }
+
     override fun onCreate() {
         super.onCreate()
 
         // Observe dynamic colors changes
         DynamicColors.applyToActivitiesIfAvailable(this)
     }
-
-    val telephonyManager by lazy {
-        getSystemService(TelephonyManager::class.java)!!
-    }
-
-    open val euiccChannelManager: IEuiccChannelManager by lazy {
-        EuiccChannelManager(this)
-    }
-
-    val subscriptionManager by lazy {
-        getSystemService(SubscriptionManager::class.java)!!
-    }
-
-    val preferenceRepository by lazy {
-        PreferenceRepository(this)
-    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index e0317942f..9033d3469 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -25,7 +25,7 @@ open class EuiccChannelManager(protected val context: Context) : IEuiccChannelMa
     private val lock = Mutex()
 
     protected val tm by lazy {
-        (context.applicationContext as OpenEuiccApplication).telephonyManager
+        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
     }
 
     protected open val uiccCards: Collection<UiccCardInfoCompat>
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
new file mode 100644
index 000000000..65c2aa91d
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -0,0 +1,13 @@
+package im.angry.openeuicc.di
+
+import android.telephony.SubscriptionManager
+import android.telephony.TelephonyManager
+import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.util.*
+
+interface AppContainer {
+    val telephonyManager: TelephonyManager
+    val euiccChannelManager: IEuiccChannelManager
+    val subscriptionManager: SubscriptionManager
+    val preferenceRepository: PreferenceRepository
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
new file mode 100644
index 000000000..dd7826c2c
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -0,0 +1,26 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+import android.telephony.SubscriptionManager
+import android.telephony.TelephonyManager
+import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.util.*
+
+open class DefaultAppContainer(context: Context) : AppContainer {
+    override val telephonyManager by lazy {
+        context.getSystemService(TelephonyManager::class.java)!!
+    }
+
+    override val euiccChannelManager: IEuiccChannelManager by lazy {
+        EuiccChannelManager(context)
+    }
+
+    override val subscriptionManager by lazy {
+        context.getSystemService(SubscriptionManager::class.java)!!
+    }
+
+    override val preferenceRepository by lazy {
+        PreferenceRepository(context)
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 360da4ffc..43fc1ee96 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -121,7 +121,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         super.onStart()
         profileDownloadIMEI.editText!!.text = Editable.Factory.getInstance().newEditable(
             try {
-                openEuiccApplication.telephonyManager.getImei(channel.logicalSlotId)
+                telephonyManager.getImei(channel.logicalSlotId)
             } catch (e: Exception) {
                 ""
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 3c218982f..57626e2b4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -8,6 +8,7 @@ import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.di.AppContainer
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
@@ -48,11 +49,14 @@ interface OpenEuiccContextMarker {
     val openEuiccApplication: OpenEuiccApplication
         get() = openEuiccMarkerContext.applicationContext as OpenEuiccApplication
 
+    val appContainer: AppContainer
+        get() = openEuiccApplication.appContainer
+
     val euiccChannelManager: IEuiccChannelManager
-        get() = openEuiccApplication.euiccChannelManager
+        get() = appContainer.euiccChannelManager
 
     val telephonyManager: TelephonyManager
-        get() = openEuiccApplication.telephonyManager
+        get() = appContainer.telephonyManager
 }
 
 val LocalProfileInfo.isEnabled: Boolean
diff --git a/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt b/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
index 28ea49d2e..2d8e5eebf 100644
--- a/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
+++ b/app/src/main/java/im/angry/openeuicc/PrivilegedOpenEuiccApplication.kt
@@ -1,16 +1,17 @@
 package im.angry.openeuicc
 
-import im.angry.openeuicc.core.IEuiccChannelManager
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
+import im.angry.openeuicc.di.AppContainer
+import im.angry.openeuicc.di.PrivilegedAppContainer
 
 class PrivilegedOpenEuiccApplication: OpenEuiccApplication() {
-    override val euiccChannelManager: IEuiccChannelManager by lazy {
-        PrivilegedEuiccChannelManager(this)
+    override val appContainer: AppContainer by lazy {
+        PrivilegedAppContainer(this)
     }
 
     override fun onCreate() {
         super.onCreate()
 
-        (euiccChannelManager as PrivilegedEuiccChannelManager).closeAllStaleChannels()
+        (appContainer.euiccChannelManager as PrivilegedEuiccChannelManager).closeAllStaleChannels()
     }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index 288cebd6b..75b2b2240 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -48,7 +48,7 @@ class PrivilegedEuiccChannelManager(context: Context): EuiccChannelManager(conte
     }
 
     override fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
-        (context.applicationContext as OpenEuiccApplication).subscriptionManager.apply {
+        (context.applicationContext as OpenEuiccApplication).appContainer.subscriptionManager.apply {
             findEuiccChannelBySlotBlocking(logicalSlotId)?.let {
                 tryRefreshCachedEuiccInfo(it.cardId)
             }
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
new file mode 100644
index 000000000..a849a27a4
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -0,0 +1,11 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
+
+class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
+    override val euiccChannelManager: IEuiccChannelManager by lazy {
+        PrivilegedEuiccChannelManager(context)
+    }
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 6a08da5c4..23f144422 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -238,7 +238,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         }
         val success = channel.lpa
             .setNickname(iccid, nickname!!)
-        openEuiccApplication.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
+        appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
         return if (success) {
             RESULT_OK
         } else {
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
index 64e8ca9ab..1261932ac 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
@@ -26,7 +26,7 @@ class PrivilegedMainActivity : MainActivity() {
 
     override fun onOptionsItemSelected(item: MenuItem): Boolean = when (item.itemId) {
         R.id.dsds -> {
-            tm.setDsdsEnabled(openEuiccApplication.euiccChannelManager, !item.isChecked)
+            tm.setDsdsEnabled(euiccChannelManager, !item.isChecked)
             Toast.makeText(this, R.string.toast_dsds_switched, Toast.LENGTH_LONG).show()
             finish()
             true
diff --git a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
index ba60fd786..4c77bac0d 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
@@ -32,12 +32,8 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
         const val TAG = "SlotMappingFragment"
     }
 
-    private val tm: TelephonyManager by lazy {
-        (requireContext().applicationContext as OpenEuiccApplication).telephonyManager
-    }
-
     private val ports: List<UiccPortInfoCompat> by lazy {
-        tm.uiccCardsInfoCompat.flatMap { it.ports }
+        telephonyManager.uiccCardsInfoCompat.flatMap { it.ports }
     }
 
     private val portsDesc: List<String> by lazy {
@@ -81,7 +77,7 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
     private fun init() {
         lifecycleScope.launch(Dispatchers.Main) {
             val mapping = withContext(Dispatchers.IO) {
-                tm.simSlotMapping
+                telephonyManager.simSlotMapping
             }
 
             adapter = SlotMappingAdapter(mapping.toMutableList().apply {
@@ -100,14 +96,14 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
                 withContext(Dispatchers.IO) {
                     // Use the utility method from PrivilegedTelephonyUtils to ensure
                     // unmapped ports have all profiles disabled
-                    tm.updateSimSlotMapping(openEuiccApplication.euiccChannelManager, adapter.mappings)
+                    telephonyManager.updateSimSlotMapping(euiccChannelManager, adapter.mappings)
                 }
             } catch (e: Exception) {
                 Toast.makeText(requireContext(), R.string.slot_mapping_failure, Toast.LENGTH_LONG).show()
                 return@launch
             }
             Toast.makeText(requireContext(), R.string.slot_mapping_completed, Toast.LENGTH_LONG).show()
-            openEuiccApplication.euiccChannelManager.invalidate()
+            euiccChannelManager.invalidate()
             requireActivity().finish()
         }
     }
@@ -115,7 +111,7 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
     private suspend fun buildHelpText() = withContext(Dispatchers.IO) {
         val nLogicalSlots = adapter.mappings.size
 
-        val cards = openEuiccApplication.telephonyManager.uiccCardsInfoCompat
+        val cards = telephonyManager.uiccCardsInfoCompat
 
         val nPhysicalSlots = cards.size
         var idxMepCard = -1
@@ -129,7 +125,7 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
         }
 
         val mayEnableDSDS =
-            openEuiccApplication.telephonyManager.supportsDSDS && !openEuiccApplication.telephonyManager.dsdsEnabled
+            telephonyManager.supportsDSDS && !telephonyManager.dsdsEnabled
         val extraText =
             if (nLogicalSlots == 1 && mayEnableDSDS) {
                 getString(R.string.slot_mapping_help_dsds)

From 49af0ffee9719497fa439fcde6fa81738a1bbebc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 18:23:53 -0500
Subject: [PATCH 008/458] CompatibilityCheck: Return FAILURE_UNKNOWN when no
 SIM readers are found

---
 .../java/im/angry/openeuicc/util/CompatibilityCheck.kt    | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 3d9c47b5c..843c4874b 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -132,7 +132,13 @@ internal class IsdrChannelAccessCheck(private val context: Context): Compatibili
 
     override suspend fun doCheck(): State {
         val seService = connectSEService(context)
-        val (validSlotIds, result) = seService.readers.filter { it.isSIM }.map {
+        val readers = seService.readers.filter { it.isSIM }
+        if (readers.isEmpty()) {
+            failureDescription = context.getString(R.string.compatibility_check_isdr_channel_desc_unknown)
+            return State.FAILURE_UNKNOWN
+        }
+
+        val (validSlotIds, result) = readers.map {
             try {
                 it.openSession().openLogicalChannel(ISDR_AID)?.close()
                 Pair(it.slotIndex, State.SUCCESS)

From a101ae6805340053c9d783b2a886965070bf34fb Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 18:38:01 -0500
Subject: [PATCH 009/458] CompatibilityCheck: Improve OMAPI connectivity check

Stop failing the test if only some slots can be seen. Display a text
warning users of that, but don't appear as a failure.
---
 .../main/java/im/angry/openeuicc/util/CompatibilityCheck.kt | 6 ++++--
 app-unpriv/src/main/res/values/strings.xml                  | 4 ++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 843c4874b..93d49be40 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -47,11 +47,13 @@ abstract class CompatibilityCheck(context: Context) {
 
     abstract val title: String
     protected abstract val defaultDescription: String
+    protected lateinit var successDescription: String
     protected lateinit var failureDescription: String
 
     val description: String
         get() = when {
             (state == State.FAILURE || state == State.FAILURE_UNKNOWN) && this::failureDescription.isInitialized -> failureDescription
+            state == State.SUCCESS && this::successDescription.isInitialized -> successDescription
             else -> defaultDescription
         }
 
@@ -111,9 +113,9 @@ internal class OmapiConnCheck(private val context: Context): CompatibilityCheck(
             failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail)
             return State.FAILURE
         } else if (simReaders.size < tm.activeModemCountCompat) {
-            failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail_sim_number,
+            successDescription = context.getString(R.string.compatibility_check_omapi_connectivity_partial_success_sim_number,
                 simReaders.map { it.slotIndex }.joinToString(", "))
-            return State.FAILURE
+            return State.SUCCESS
         }
 
         return State.SUCCESS
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 3a20af1a8..8845a588e 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -9,8 +9,8 @@
     <string name="compatibility_check_system_features_no_omapi">Your device has no support for accessing SIM cards via OMAPI.</string>
     <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
     <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
-    <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI.</string>
-    <string name="compatibility_check_omapi_connectivity_fail_sim_number">Only the following SIM slots are accessible via OMAPI: %s.</string>
+    <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: %s.</string>
     <string name="compatibility_check_isdr_channel">ISD-R Channel Access</string>
     <string name="compatibility_check_isdr_channel_desc">Does your device support opening an ISD-R (management) channel to eSIMs via OMAPI?</string>
     <string name="compatibility_check_isdr_channel_desc_unknown">Cannot determine whether ISD-R access through OMAPI is supported. You might want to retry with SIM cards inserted (any SIM card will do) if not already.</string>

From aef399dad013b53aaaa943cf01a9ab7038e11568 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 18:39:40 -0500
Subject: [PATCH 010/458] CompatibilityCheck: Explain that the user might want
 to contact the ROM developer

---
 app-unpriv/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 8845a588e..588c0735f 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -6,7 +6,7 @@
     <string name="compatibility_check_system_features">System Features</string>
     <string name="compatibility_check_system_features_desc">Whether your device has all the required features for managing removable eUICC cards. For example, basic telephony and OMAPI support.</string>
     <string name="compatibility_check_system_features_no_telephony">Your device has no telephony features.</string>
-    <string name="compatibility_check_system_features_no_omapi">Your device has no support for accessing SIM cards via OMAPI.</string>
+    <string name="compatibility_check_system_features_no_omapi">Your device has no support for accessing SIM cards via OMAPI. If you are using a custom ROM, consider contacting the developer to determine whether it is due to hardware or a missing feature declaration in the OS.</string>
     <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
     <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
     <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>

From 6356601467f768a5957ecc0c9480b875efb753d4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 18:43:37 -0500
Subject: [PATCH 011/458] CompatibilityCheck: Make connectivity fail a
 "Unknown" failure

---
 .../src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 93d49be40..ae5a4da8d 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -111,7 +111,7 @@ internal class OmapiConnCheck(private val context: Context): CompatibilityCheck(
         val simReaders = seService.readers.filter { it.isSIM }
         if (simReaders.isEmpty()) {
             failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail)
-            return State.FAILURE
+            return State.FAILURE_UNKNOWN
         } else if (simReaders.size < tm.activeModemCountCompat) {
             successDescription = context.getString(R.string.compatibility_check_omapi_connectivity_partial_success_sim_number,
                 simReaders.map { it.slotIndex }.joinToString(", "))

From 4dd14d23f24d6dd7694571970c56cb98499bd85a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 18:51:10 -0500
Subject: [PATCH 012/458] refactor: Add UiComponentFactory to manual DI

---
 .../main/java/im/angry/openeuicc/di/AppContainer.kt    |  1 +
 .../java/im/angry/openeuicc/di/DefaultAppContainer.kt  |  4 ++++
 .../im/angry/openeuicc/di/DefaultUiComponentFactory.kt |  9 +++++++++
 .../java/im/angry/openeuicc/di/UiComponentFactory.kt   |  8 ++++++++
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt    |  6 +-----
 .../im/angry/openeuicc/di/PrivilegedAppContainer.kt    |  4 ++++
 .../angry/openeuicc/di/PrivilegedUiComponentFactory.kt | 10 ++++++++++
 .../im/angry/openeuicc/ui/PrivilegedMainActivity.kt    |  4 ----
 8 files changed, 37 insertions(+), 9 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
 create mode 100644 app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
index 65c2aa91d..a29fcf8ee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -10,4 +10,5 @@ interface AppContainer {
     val euiccChannelManager: IEuiccChannelManager
     val subscriptionManager: SubscriptionManager
     val preferenceRepository: PreferenceRepository
+    val uiComponentFactory: UiComponentFactory
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
index dd7826c2c..6a0383595 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -23,4 +23,8 @@ open class DefaultAppContainer(context: Context) : AppContainer {
     override val preferenceRepository by lazy {
         PreferenceRepository(context)
     }
+
+    override val uiComponentFactory by lazy {
+        DefaultUiComponentFactory()
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
new file mode 100644
index 000000000..86af0076e
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
@@ -0,0 +1,9 @@
+package im.angry.openeuicc.di
+
+import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.ui.EuiccManagementFragment
+
+open class DefaultUiComponentFactory : UiComponentFactory {
+    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
+        EuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
new file mode 100644
index 000000000..d311876e5
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
@@ -0,0 +1,8 @@
+package im.angry.openeuicc.di
+
+import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.ui.EuiccManagementFragment
+
+interface UiComponentFactory {
+    fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index af6cbf455..ca6715d95 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -88,10 +88,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
             else -> super.onOptionsItemSelected(item)
         }
 
-
-    protected open fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
-        EuiccManagementFragment.newInstance(channel.slotId, channel.portId)
-
     private suspend fun init() {
         withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels()
@@ -108,7 +104,7 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
         withContext(Dispatchers.Main) {
             euiccChannelManager.knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
-                fragments.add(createEuiccManagementFragment(channel))
+                fragments.add(appContainer.uiComponentFactory.createEuiccManagementFragment(channel))
             }
 
             if (fragments.isNotEmpty()) {
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index a849a27a4..64e45eb6a 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -8,4 +8,8 @@ class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val euiccChannelManager: IEuiccChannelManager by lazy {
         PrivilegedEuiccChannelManager(context)
     }
+
+    override val uiComponentFactory by lazy {
+        PrivilegedUiComponentFactory()
+    }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
new file mode 100644
index 000000000..d3c5cdbde
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
@@ -0,0 +1,10 @@
+package im.angry.openeuicc.di
+
+import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.ui.EuiccManagementFragment
+import im.angry.openeuicc.ui.PrivilegedEuiccManagementFragment
+
+class PrivilegedUiComponentFactory : DefaultUiComponentFactory() {
+    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
+        PrivilegedEuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
index 1261932ac..f3c2b3c8a 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
@@ -4,7 +4,6 @@ import android.view.Menu
 import android.view.MenuItem
 import android.widget.Toast
 import im.angry.openeuicc.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.util.*
 
 class PrivilegedMainActivity : MainActivity() {
@@ -37,7 +36,4 @@ class PrivilegedMainActivity : MainActivity() {
         }
         else -> super.onOptionsItemSelected(item)
     }
-
-    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
-        PrivilegedEuiccManagementFragment.newInstance(channel.slotId, channel.portId)
 }
\ No newline at end of file

From 7c6b4ebee5cb9dc4690b2336bb8931f63e7820ca Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 19:06:05 -0500
Subject: [PATCH 013/458] refactor: IEuiccChannelManager -> EuiccChannelManager

---
 .../core/DefaultEuiccChannelManager.kt        | 174 +++++++++++++++
 .../openeuicc/core/EuiccChannelManager.kt     | 199 ++++--------------
 .../openeuicc/core/IEuiccChannelManager.kt    |  47 -----
 .../im/angry/openeuicc/di/AppContainer.kt     |   4 +-
 .../angry/openeuicc/di/DefaultAppContainer.kt |   6 +-
 .../java/im/angry/openeuicc/util/Utils.kt     |   4 +-
 .../core/PrivilegedEuiccChannelManager.kt     |   2 +-
 .../openeuicc/di/PrivilegedAppContainer.kt    |   4 +-
 .../util/PrivilegedTelephonyUtils.kt          |   6 +-
 9 files changed, 223 insertions(+), 223 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
new file mode 100644
index 000000000..1883a11b1
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -0,0 +1,174 @@
+package im.angry.openeuicc.core
+
+import android.content.Context
+import android.se.omapi.SEService
+import android.telephony.SubscriptionManager
+import android.util.Log
+import im.angry.openeuicc.OpenEuiccApplication
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.sync.Mutex
+import kotlinx.coroutines.sync.withLock
+import kotlinx.coroutines.withContext
+import java.lang.IllegalArgumentException
+
+open class DefaultEuiccChannelManager(protected val context: Context) : EuiccChannelManager {
+    companion object {
+        const val TAG = "EuiccChannelManager"
+    }
+
+    private val channels = mutableListOf<EuiccChannel>()
+
+    private var seService: SEService? = null
+
+    private val lock = Mutex()
+
+    protected val tm by lazy {
+        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
+    }
+
+    protected open val uiccCards: Collection<UiccCardInfoCompat>
+        get() = (0..<tm.activeModemCountCompat).map { FakeUiccCardInfoCompat(it) }
+
+    private suspend fun ensureSEService() {
+        if (seService == null) {
+            seService = connectSEService(context)
+        }
+    }
+
+    protected open fun tryOpenEuiccChannelPrivileged(port: UiccPortInfoCompat): EuiccChannel? {
+        // No-op when unprivileged
+        return null
+    }
+
+    protected fun tryOpenEuiccChannelUnprivileged(port: UiccPortInfoCompat): EuiccChannel? {
+        if (port.portIndex != 0) {
+            Log.w(TAG, "OMAPI channel attempted on non-zero portId, this may or may not work.")
+        }
+
+        Log.i(TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
+        try {
+            return OmapiChannel(seService!!, port)
+        } catch (e: IllegalArgumentException) {
+            // Failed
+            Log.w(
+                TAG,
+                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
+            )
+        }
+
+        return null
+    }
+
+    private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
+        lock.withLock {
+            ensureSEService()
+            val existing =
+                channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
+            if (existing != null) {
+                if (existing.valid && port.logicalSlotIndex == existing.logicalSlotId) {
+                    return existing
+                } else {
+                    existing.close()
+                    channels.remove(existing)
+                }
+            }
+
+            if (port.logicalSlotIndex == SubscriptionManager.INVALID_SIM_SLOT_INDEX) {
+                // We can only open channels on ports that are actually enabled
+                return null
+            }
+
+            var euiccChannel: EuiccChannel? = tryOpenEuiccChannelPrivileged(port)
+
+            if (euiccChannel == null) {
+                euiccChannel = tryOpenEuiccChannelUnprivileged(port)
+            }
+
+            if (euiccChannel != null) {
+                channels.add(euiccChannel)
+            }
+
+            return euiccChannel
+        }
+    }
+
+    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
+        runBlocking {
+            withContext(Dispatchers.IO) {
+                for (card in uiccCards) {
+                    for (port in card.ports) {
+                        if (port.logicalSlotIndex == logicalSlotId) {
+                            return@withContext tryOpenEuiccChannel(port)
+                        }
+                    }
+                }
+
+                null
+            }
+        }
+
+    override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
+        runBlocking {
+            withContext(Dispatchers.IO) {
+                for (card in uiccCards) {
+                    if (card.physicalSlotIndex != physicalSlotId) continue
+                    for (port in card.ports) {
+                        tryOpenEuiccChannel(port)?.let { return@withContext it }
+                    }
+                }
+
+                null
+            }
+        }
+
+    override fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? =
+        runBlocking {
+            for (card in uiccCards) {
+                if (card.physicalSlotIndex != physicalSlotId) continue
+                return@runBlocking card.ports.mapNotNull { tryOpenEuiccChannel(it) }
+                    .ifEmpty { null }
+            }
+            return@runBlocking null
+        }
+
+    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
+        runBlocking {
+            withContext(Dispatchers.IO) {
+                uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
+                    card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
+                }
+            }
+        }
+
+    override suspend fun enumerateEuiccChannels() {
+        withContext(Dispatchers.IO) {
+            ensureSEService()
+
+            for (uiccInfo in uiccCards) {
+                for (port in uiccInfo.ports) {
+                    if (tryOpenEuiccChannel(port) != null) {
+                        Log.d(
+                            TAG,
+                            "Found eUICC on slot ${uiccInfo.physicalSlotIndex} port ${port.portIndex}"
+                        )
+                    }
+                }
+            }
+        }
+    }
+
+    override val knownChannels: List<EuiccChannel>
+        get() = channels.toList()
+
+    override fun invalidate() {
+        for (channel in channels) {
+            channel.close()
+        }
+
+        channels.clear()
+        seService?.shutdown()
+        seService = null
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 9033d3469..b0bce1daf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -1,174 +1,47 @@
 package im.angry.openeuicc.core
 
-import android.content.Context
-import android.se.omapi.SEService
-import android.telephony.SubscriptionManager
-import android.util.Log
-import im.angry.openeuicc.OpenEuiccApplication
-import im.angry.openeuicc.util.*
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.runBlocking
-import kotlinx.coroutines.sync.Mutex
-import kotlinx.coroutines.sync.withLock
-import kotlinx.coroutines.withContext
-import java.lang.IllegalArgumentException
+interface EuiccChannelManager {
+    val knownChannels: List<EuiccChannel>
 
-open class EuiccChannelManager(protected val context: Context) : IEuiccChannelManager {
-    companion object {
-        const val TAG = "EuiccChannelManager"
-    }
+    /**
+     * Scan all possible sources for EuiccChannels and have them cached for future use
+     */
+    suspend fun enumerateEuiccChannels()
 
-    private val channels = mutableListOf<EuiccChannel>()
+    /**
+     * Returns the EuiccChannel corresponding to a **logical** slot
+     */
+    fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
 
-    private var seService: SEService? = null
+    /**
+     * Returns the first EuiccChannel corresponding to a **physical** slot
+     * If the physical slot supports MEP and has multiple ports, it is undefined
+     * which of the two channels will be returned.
+     */
+    fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel?
 
-    private val lock = Mutex()
+    /**
+     * Returns all EuiccChannels corresponding to a **physical** slot
+     * Multiple channels are possible in the case of MEP
+     */
+    fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>?
 
-    protected val tm by lazy {
-        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
-    }
+    /**
+     * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
+     */
+    fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
 
-    protected open val uiccCards: Collection<UiccCardInfoCompat>
-        get() = (0..<tm.activeModemCountCompat).map { FakeUiccCardInfoCompat(it) }
+    /**
+     * Invalidate all EuiccChannels previously known by this Manager
+     */
+    fun invalidate()
 
-    private suspend fun ensureSEService() {
-        if (seService == null) {
-            seService = connectSEService(context)
-        }
-    }
-
-    protected open fun tryOpenEuiccChannelPrivileged(port: UiccPortInfoCompat): EuiccChannel? {
-        // No-op when unprivileged
-        return null
-    }
-
-    protected fun tryOpenEuiccChannelUnprivileged(port: UiccPortInfoCompat): EuiccChannel? {
-        if (port.portIndex != 0) {
-            Log.w(TAG, "OMAPI channel attempted on non-zero portId, this may or may not work.")
-        }
-
-        Log.i(TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
-        try {
-            return OmapiChannel(seService!!, port)
-        } catch (e: IllegalArgumentException) {
-            // Failed
-            Log.w(
-                TAG,
-                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
-            )
-        }
-
-        return null
-    }
-
-    private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
-        lock.withLock {
-            ensureSEService()
-            val existing =
-                channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
-            if (existing != null) {
-                if (existing.valid && port.logicalSlotIndex == existing.logicalSlotId) {
-                    return existing
-                } else {
-                    existing.close()
-                    channels.remove(existing)
-                }
-            }
-
-            if (port.logicalSlotIndex == SubscriptionManager.INVALID_SIM_SLOT_INDEX) {
-                // We can only open channels on ports that are actually enabled
-                return null
-            }
-
-            var euiccChannel: EuiccChannel? = tryOpenEuiccChannelPrivileged(port)
-
-            if (euiccChannel == null) {
-                euiccChannel = tryOpenEuiccChannelUnprivileged(port)
-            }
-
-            if (euiccChannel != null) {
-                channels.add(euiccChannel)
-            }
-
-            return euiccChannel
-        }
-    }
-
-    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                for (card in uiccCards) {
-                    for (port in card.ports) {
-                        if (port.logicalSlotIndex == logicalSlotId) {
-                            return@withContext tryOpenEuiccChannel(port)
-                        }
-                    }
-                }
-
-                null
-            }
-        }
-
-    override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                for (card in uiccCards) {
-                    if (card.physicalSlotIndex != physicalSlotId) continue
-                    for (port in card.ports) {
-                        tryOpenEuiccChannel(port)?.let { return@withContext it }
-                    }
-                }
-
-                null
-            }
-        }
-
-    override fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? =
-        runBlocking {
-            for (card in uiccCards) {
-                if (card.physicalSlotIndex != physicalSlotId) continue
-                return@runBlocking card.ports.mapNotNull { tryOpenEuiccChannel(it) }
-                    .ifEmpty { null }
-            }
-            return@runBlocking null
-        }
-
-    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
-                    card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
-                }
-            }
-        }
-
-    override suspend fun enumerateEuiccChannels() {
-        withContext(Dispatchers.IO) {
-            ensureSEService()
-
-            for (uiccInfo in uiccCards) {
-                for (port in uiccInfo.ports) {
-                    if (tryOpenEuiccChannel(port) != null) {
-                        Log.d(
-                            TAG,
-                            "Found eUICC on slot ${uiccInfo.physicalSlotIndex} port ${port.portIndex}"
-                        )
-                    }
-                }
-            }
-        }
-    }
-
-    override val knownChannels: List<EuiccChannel>
-        get() = channels.toList()
-
-    override fun invalidate() {
-        for (channel in channels) {
-            channel.close()
-        }
-
-        channels.clear()
-        seService?.shutdown()
-        seService = null
+    /**
+     * If possible, trigger the system to update the cached list of profiles
+     * This is only expected to be implemented when the application is privileged
+     * TODO: Remove this from the common interface
+     */
+    fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
+        // no-op by default
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt
deleted file mode 100644
index 8a6ab5456..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/core/IEuiccChannelManager.kt
+++ /dev/null
@@ -1,47 +0,0 @@
-package im.angry.openeuicc.core
-
-interface IEuiccChannelManager {
-    val knownChannels: List<EuiccChannel>
-
-    /**
-     * Scan all possible sources for EuiccChannels and have them cached for future use
-     */
-    suspend fun enumerateEuiccChannels()
-
-    /**
-     * Returns the EuiccChannel corresponding to a **logical** slot
-     */
-    fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
-
-    /**
-     * Returns the first EuiccChannel corresponding to a **physical** slot
-     * If the physical slot supports MEP and has multiple ports, it is undefined
-     * which of the two channels will be returned.
-     */
-    fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel?
-
-    /**
-     * Returns all EuiccChannels corresponding to a **physical** slot
-     * Multiple channels are possible in the case of MEP
-     */
-    fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>?
-
-    /**
-     * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
-     */
-    fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
-
-    /**
-     * Invalidate all EuiccChannels previously known by this Manager
-     */
-    fun invalidate()
-
-    /**
-     * If possible, trigger the system to update the cached list of profiles
-     * This is only expected to be implemented when the application is privileged
-     * TODO: Remove this from the common interface
-     */
-    fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
-        // no-op by default
-    }
-}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
index a29fcf8ee..a62eff4db 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -2,12 +2,12 @@ package im.angry.openeuicc.di
 
 import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
-import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 
 interface AppContainer {
     val telephonyManager: TelephonyManager
-    val euiccChannelManager: IEuiccChannelManager
+    val euiccChannelManager: EuiccChannelManager
     val subscriptionManager: SubscriptionManager
     val preferenceRepository: PreferenceRepository
     val uiComponentFactory: UiComponentFactory
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
index 6a0383595..9f051e88e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -3,8 +3,8 @@ package im.angry.openeuicc.di
 import android.content.Context
 import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
+import im.angry.openeuicc.core.DefaultEuiccChannelManager
 import im.angry.openeuicc.core.EuiccChannelManager
-import im.angry.openeuicc.core.IEuiccChannelManager
 import im.angry.openeuicc.util.*
 
 open class DefaultAppContainer(context: Context) : AppContainer {
@@ -12,8 +12,8 @@ open class DefaultAppContainer(context: Context) : AppContainer {
         context.getSystemService(TelephonyManager::class.java)!!
     }
 
-    override val euiccChannelManager: IEuiccChannelManager by lazy {
-        EuiccChannelManager(context)
+    override val euiccChannelManager: EuiccChannelManager by lazy {
+        DefaultEuiccChannelManager(context)
     }
 
     override val subscriptionManager by lazy {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 57626e2b4..33699d7eb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -7,7 +7,7 @@ import android.telephony.TelephonyManager
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.di.AppContainer
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
@@ -52,7 +52,7 @@ interface OpenEuiccContextMarker {
     val appContainer: AppContainer
         get() = openEuiccApplication.appContainer
 
-    val euiccChannelManager: IEuiccChannelManager
+    val euiccChannelManager: EuiccChannelManager
         get() = appContainer.euiccChannelManager
 
     val telephonyManager: TelephonyManager
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index 75b2b2240..0ebaa813f 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -7,7 +7,7 @@ import im.angry.openeuicc.util.*
 import java.lang.Exception
 import java.lang.IllegalArgumentException
 
-class PrivilegedEuiccChannelManager(context: Context): EuiccChannelManager(context) {
+class PrivilegedEuiccChannelManager(context: Context): DefaultEuiccChannelManager(context) {
     override val uiccCards: Collection<UiccCardInfoCompat>
         get() = tm.uiccCardsInfoCompat
 
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index 64e45eb6a..dc3921ed0 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -1,11 +1,11 @@
 package im.angry.openeuicc.di
 
 import android.content.Context
-import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
 
 class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
-    override val euiccChannelManager: IEuiccChannelManager by lazy {
+    override val euiccChannelManager: EuiccChannelManager by lazy {
         PrivilegedEuiccChannelManager(context)
     }
 
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 4cb493217..4675ab9c9 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -4,7 +4,7 @@ import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
 import android.telephony.UiccSlotMapping
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.IEuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManager
 import kotlinx.coroutines.runBlocking
 import java.lang.Exception
 
@@ -14,7 +14,7 @@ val TelephonyManager.supportsDSDS: Boolean
 val TelephonyManager.dsdsEnabled: Boolean
     get() = activeModemCount >= 2
 
-fun TelephonyManager.setDsdsEnabled(euiccManager: IEuiccChannelManager, enabled: Boolean) {
+fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled: Boolean) {
     runBlocking {
         euiccManager.enumerateEuiccChannels()
     }
@@ -32,7 +32,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: IEuiccChannelManager, enabled:
 // Disable eSIM profiles before switching the slot mapping
 // This ensures that unmapped eSIM ports never have "ghost" profiles enabled
 fun TelephonyManager.updateSimSlotMapping(
-    euiccManager: IEuiccChannelManager, newMapping: Collection<UiccSlotMapping>,
+    euiccManager: EuiccChannelManager, newMapping: Collection<UiccSlotMapping>,
     currentMapping: Collection<UiccSlotMapping> = simSlotMapping
 ) {
     val unmapped = currentMapping.filterNot { mapping ->

From 1a69c5294b56912ce71516f3b6c8be4c490d747b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 19:30:04 -0500
Subject: [PATCH 014/458] refactor: Use DI techniques for EuiccChannel's as
 well

---
 .../core/DefaultEuiccChannelFactory.kt        | 43 ++++++++++++
 .../core/DefaultEuiccChannelManager.kt        | 65 ++++---------------
 .../openeuicc/core/EuiccChannelFactory.kt     | 16 +++++
 .../im/angry/openeuicc/di/AppContainer.kt     |  2 +
 .../angry/openeuicc/di/DefaultAppContainer.kt |  7 +-
 .../core/PrivilegedEuiccChannelFactory.kt     | 43 ++++++++++++
 .../core/PrivilegedEuiccChannelManager.kt     | 30 ++-------
 .../openeuicc/di/PrivilegedAppContainer.kt    |  7 +-
 8 files changed, 133 insertions(+), 80 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
 create mode 100644 app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
new file mode 100644
index 000000000..15e019127
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -0,0 +1,43 @@
+package im.angry.openeuicc.core
+
+import android.content.Context
+import android.se.omapi.SEService
+import android.util.Log
+import im.angry.openeuicc.util.*
+import java.lang.IllegalArgumentException
+
+open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccChannelFactory {
+    private var seService: SEService? = null
+
+    private suspend fun ensureSEService() {
+        if (seService == null) {
+            seService = connectSEService(context)
+        }
+    }
+
+    override suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
+        if (port.portIndex != 0) {
+            Log.w(DefaultEuiccChannelManager.TAG, "OMAPI channel attempted on non-zero portId, this may or may not work.")
+        }
+
+        ensureSEService()
+
+        Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
+        try {
+            return OmapiChannel(seService!!, port)
+        } catch (e: IllegalArgumentException) {
+            // Failed
+            Log.w(
+                DefaultEuiccChannelManager.TAG,
+                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
+            )
+        }
+
+        return null
+    }
+
+    override fun cleanup() {
+        seService?.shutdown()
+        seService = null
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 1883a11b1..a97867759 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -1,69 +1,41 @@
 package im.angry.openeuicc.core
 
 import android.content.Context
-import android.se.omapi.SEService
 import android.telephony.SubscriptionManager
 import android.util.Log
-import im.angry.openeuicc.OpenEuiccApplication
+import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
-import java.lang.IllegalArgumentException
 
-open class DefaultEuiccChannelManager(protected val context: Context) : EuiccChannelManager {
+open class DefaultEuiccChannelManager(
+    protected val appContainer: AppContainer,
+    protected val context: Context
+) : EuiccChannelManager {
     companion object {
         const val TAG = "EuiccChannelManager"
     }
 
     private val channels = mutableListOf<EuiccChannel>()
 
-    private var seService: SEService? = null
-
     private val lock = Mutex()
 
     protected val tm by lazy {
-        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
+        appContainer.telephonyManager
+    }
+
+    private val euiccChannelFactory by lazy {
+        appContainer.euiccChannelFactory
     }
 
     protected open val uiccCards: Collection<UiccCardInfoCompat>
         get() = (0..<tm.activeModemCountCompat).map { FakeUiccCardInfoCompat(it) }
 
-    private suspend fun ensureSEService() {
-        if (seService == null) {
-            seService = connectSEService(context)
-        }
-    }
-
-    protected open fun tryOpenEuiccChannelPrivileged(port: UiccPortInfoCompat): EuiccChannel? {
-        // No-op when unprivileged
-        return null
-    }
-
-    protected fun tryOpenEuiccChannelUnprivileged(port: UiccPortInfoCompat): EuiccChannel? {
-        if (port.portIndex != 0) {
-            Log.w(TAG, "OMAPI channel attempted on non-zero portId, this may or may not work.")
-        }
-
-        Log.i(TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
-        try {
-            return OmapiChannel(seService!!, port)
-        } catch (e: IllegalArgumentException) {
-            // Failed
-            Log.w(
-                TAG,
-                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
-            )
-        }
-
-        return null
-    }
-
     private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
         lock.withLock {
-            ensureSEService()
             val existing =
                 channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
             if (existing != null) {
@@ -80,17 +52,9 @@ open class DefaultEuiccChannelManager(protected val context: Context) : EuiccCha
                 return null
             }
 
-            var euiccChannel: EuiccChannel? = tryOpenEuiccChannelPrivileged(port)
-
-            if (euiccChannel == null) {
-                euiccChannel = tryOpenEuiccChannelUnprivileged(port)
+            return euiccChannelFactory.tryOpenEuiccChannel(port)?.also {
+                channels.add(it)
             }
-
-            if (euiccChannel != null) {
-                channels.add(euiccChannel)
-            }
-
-            return euiccChannel
         }
     }
 
@@ -144,8 +108,6 @@ open class DefaultEuiccChannelManager(protected val context: Context) : EuiccCha
 
     override suspend fun enumerateEuiccChannels() {
         withContext(Dispatchers.IO) {
-            ensureSEService()
-
             for (uiccInfo in uiccCards) {
                 for (port in uiccInfo.ports) {
                     if (tryOpenEuiccChannel(port) != null) {
@@ -168,7 +130,6 @@ open class DefaultEuiccChannelManager(protected val context: Context) : EuiccCha
         }
 
         channels.clear()
-        seService?.shutdown()
-        seService = null
+        euiccChannelFactory.cleanup()
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
new file mode 100644
index 000000000..c8435dcad
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
@@ -0,0 +1,16 @@
+package im.angry.openeuicc.core
+
+import im.angry.openeuicc.util.*
+
+// This class is here instead of inside DI because it contains a bit more logic than just
+// "dumb" dependency injection.
+interface EuiccChannelFactory {
+    suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel?
+
+    /**
+     * Release all resources used by this EuiccChannelFactory
+     * Note that the same instance may be reused; any resources allocated must be automatically
+     * re-acquired when this happens
+     */
+    fun cleanup()
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
index a62eff4db..6ad6e0dee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -2,6 +2,7 @@ package im.angry.openeuicc.di
 
 import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
+import im.angry.openeuicc.core.EuiccChannelFactory
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 
@@ -11,4 +12,5 @@ interface AppContainer {
     val subscriptionManager: SubscriptionManager
     val preferenceRepository: PreferenceRepository
     val uiComponentFactory: UiComponentFactory
+    val euiccChannelFactory: EuiccChannelFactory
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
index 9f051e88e..7a1a3fe90 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.di
 import android.content.Context
 import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
+import im.angry.openeuicc.core.DefaultEuiccChannelFactory
 import im.angry.openeuicc.core.DefaultEuiccChannelManager
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
@@ -13,7 +14,7 @@ open class DefaultAppContainer(context: Context) : AppContainer {
     }
 
     override val euiccChannelManager: EuiccChannelManager by lazy {
-        DefaultEuiccChannelManager(context)
+        DefaultEuiccChannelManager(this, context)
     }
 
     override val subscriptionManager by lazy {
@@ -27,4 +28,8 @@ open class DefaultAppContainer(context: Context) : AppContainer {
     override val uiComponentFactory by lazy {
         DefaultUiComponentFactory()
     }
+
+    override val euiccChannelFactory by lazy {
+        DefaultEuiccChannelFactory(context)
+    }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
new file mode 100644
index 000000000..78acefe1f
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -0,0 +1,43 @@
+package im.angry.openeuicc.core
+
+import android.content.Context
+import android.util.Log
+import im.angry.openeuicc.OpenEuiccApplication
+import im.angry.openeuicc.util.*
+import java.lang.IllegalArgumentException
+
+class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFactory(context) {
+    private val tm by lazy {
+        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
+    }
+
+    @Suppress("NAME_SHADOWING")
+    override suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
+        val port = port as RealUiccPortInfoCompat
+        if (port.card.isRemovable) {
+            // Attempt unprivileged (OMAPI) before TelephonyManager
+            // but still try TelephonyManager in case OMAPI is broken
+            super.tryOpenEuiccChannel(port)?.let { return it }
+        }
+
+        if (port.card.isEuicc) {
+            Log.i(
+                DefaultEuiccChannelManager.TAG,
+                "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
+            )
+            try {
+                return TelephonyManagerChannel(
+                    port, tm
+                )
+            } catch (e: IllegalArgumentException) {
+                // Failed
+                Log.w(
+                    DefaultEuiccChannelManager.TAG,
+                    "TelephonyManager APDU interface unavailable for slot ${port.card.physicalSlotIndex} port ${port.portIndex}, falling back"
+                )
+            }
+        }
+
+        return super.tryOpenEuiccChannel(port)
+    }
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index 0ebaa813f..1c5d13240 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -1,37 +1,15 @@
 package im.angry.openeuicc.core
 
 import android.content.Context
-import android.util.Log
-import im.angry.openeuicc.OpenEuiccApplication
+import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import java.lang.Exception
-import java.lang.IllegalArgumentException
 
-class PrivilegedEuiccChannelManager(context: Context): DefaultEuiccChannelManager(context) {
+class PrivilegedEuiccChannelManager(appContainer: AppContainer, context: Context) :
+    DefaultEuiccChannelManager(appContainer, context) {
     override val uiccCards: Collection<UiccCardInfoCompat>
         get() = tm.uiccCardsInfoCompat
 
-    @Suppress("NAME_SHADOWING")
-    override fun tryOpenEuiccChannelPrivileged(port: UiccPortInfoCompat): EuiccChannel? {
-        val port = port as RealUiccPortInfoCompat
-        if (port.card.isRemovable) {
-            // Attempt unprivileged (OMAPI) before TelephonyManager
-            // but still try TelephonyManager in case OMAPI is broken
-            super.tryOpenEuiccChannelUnprivileged(port)?.let { return it }
-        }
-
-        if (port.card.isEuicc) {
-            Log.i(TAG, "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}")
-            try {
-                return TelephonyManagerChannel(port, tm)
-            } catch (e: IllegalArgumentException) {
-                // Failed
-                Log.w(TAG, "TelephonyManager APDU interface unavailable for slot ${port.card.physicalSlotIndex} port ${port.portIndex}, falling back")
-            }
-        }
-        return null
-    }
-
     // Clean up channels left open in TelephonyManager
     // due to a (potentially) forced restart
     // This should be called every time the application is restarted
@@ -48,7 +26,7 @@ class PrivilegedEuiccChannelManager(context: Context): DefaultEuiccChannelManage
     }
 
     override fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
-        (context.applicationContext as OpenEuiccApplication).appContainer.subscriptionManager.apply {
+        appContainer.subscriptionManager.apply {
             findEuiccChannelBySlotBlocking(logicalSlotId)?.let {
                 tryRefreshCachedEuiccInfo(it.cardId)
             }
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index dc3921ed0..515835278 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -2,14 +2,19 @@ package im.angry.openeuicc.di
 
 import android.content.Context
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.PrivilegedEuiccChannelFactory
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
 
 class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val euiccChannelManager: EuiccChannelManager by lazy {
-        PrivilegedEuiccChannelManager(context)
+        PrivilegedEuiccChannelManager(this, context)
     }
 
     override val uiComponentFactory by lazy {
         PrivilegedUiComponentFactory()
     }
+
+    override val euiccChannelFactory by lazy {
+        PrivilegedEuiccChannelFactory(context)
+    }
 }
\ No newline at end of file

From 6c2b1675bd5f4ae3562d067d3a5d44cc9d507b44 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 19:35:17 -0500
Subject: [PATCH 015/458] fixup: Infinite loop in PreferenceUtils after
 adopting DI

---
 .../src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index accbbb52c..b9a854e32 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -14,7 +14,7 @@ import kotlinx.coroutines.flow.map
 private val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "prefs")
 
 val Context.preferenceRepository: PreferenceRepository
-    get() = (applicationContext as OpenEuiccApplication).preferenceRepository
+    get() = (applicationContext as OpenEuiccApplication).appContainer.preferenceRepository
 
 val Fragment.preferenceRepository: PreferenceRepository
     get() = requireContext().preferenceRepository

From 09e19412e31330261dc1c112e1a6dac34ac9aaf6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 19:59:10 -0500
Subject: [PATCH 016/458] fix: Show less logs in UI than what we will save

...to avoid the UI getting stuck due to the sheer amount of lines.
---
 .../main/java/im/angry/openeuicc/ui/LogsActivity.kt   | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 1a7e50f8f..70f6992b6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -23,13 +23,15 @@ class LogsActivity : AppCompatActivity() {
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var scrollView: ScrollView
     private lateinit var logText: TextView
+    private lateinit var logStr: String
 
     private val saveLogs =
         registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
             if (uri == null) return@registerForActivityResult
+            if (!this::logStr.isInitialized) return@registerForActivityResult
             contentResolver.openFileDescriptor(uri, "w")?.use {
                 FileOutputStream(it.fileDescriptor).use { os ->
-                    os.write(logText.text.toString().encodeToByteArray())
+                    os.write(logStr.encodeToByteArray())
                 }
             }
         }
@@ -76,7 +78,12 @@ class LogsActivity : AppCompatActivity() {
     private suspend fun reload() = withContext(Dispatchers.Main) {
         swipeRefresh.isRefreshing = true
 
-        logText.text = intent.extras?.getString("log") ?: readSelfLog()
+        logStr = intent.extras?.getString("log") ?: readSelfLog()
+
+        logText.text = withContext(Dispatchers.IO) {
+            // Limit the UI to display only 256 lines
+            logStr.lines().takeLast(256).joinToString("\n")
+        }
 
         swipeRefresh.isRefreshing = false
 

From ca0085e14733906ad20474b8246633b91df272b3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 4 Mar 2024 20:07:26 -0500
Subject: [PATCH 017/458] fix: Do not crash if a certificate key ID is not
 known

Fixes #17.
---
 .../main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index f3e5e9019..13848b637 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -8,7 +8,7 @@ import java.security.cert.CertificateFactory
 const val DEFAULT_PKID_GSMA_RSP2_ROOT_CI1 = "81370f5125d0b1d408d4c3b232e6d25e795bebfb"
 
 private fun getCertificate(keyId: String): Certificate? =
-    KNOWN_CI_CERTS[keyId]?.toByteArray().let { cert ->
+    KNOWN_CI_CERTS[keyId]?.toByteArray()?.let { cert ->
         ByteArrayInputStream(cert).use { stream ->
             val cf = CertificateFactory.getInstance("X.509")
             cf.generateCertificate(stream)

From 8ee3c53492a75bf3606198c7e579babf59b3acdc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 5 Mar 2024 20:07:49 -0500
Subject: [PATCH 018/458] buildSrc: Use HEAD rev count as version code

In Actions, we do not always have a checkout of the master branch.

This only applies to release builds anyway. For debug builds, we always
use the timestamp.
---
 buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
index 2c77fd3f0..24f02358b 100644
--- a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
+++ b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
@@ -12,7 +12,7 @@ val Project.gitVersionCode: Int
         try {
             val stdout = ByteArrayOutputStream()
             exec {
-                commandLine("git", "rev-list", "--first-parent", "--count", "master")
+                commandLine("git", "rev-list", "--first-parent", "--count", "HEAD")
                 standardOutput = stdout
             }
             stdout.toString("utf-8").trim('\n').toInt()

From 124d1690abacfcf728bf7c160798f2721313c2e6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 5 Mar 2024 20:12:19 -0500
Subject: [PATCH 019/458] fix: Clear status icon when compat check items are
 recycled

---
 .../im/angry/openeuicc/ui/CompatibilityCheckActivity.kt     | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index 0eb433a8e..b7c8cf803 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -7,6 +7,7 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
 import androidx.appcompat.app.AppCompatActivity
+import androidx.core.view.children
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -52,11 +53,16 @@ class CompatibilityCheckActivity: AppCompatActivity() {
     inner class ViewHolder(private val root: View): RecyclerView.ViewHolder(root) {
         private val titleView: TextView = root.findViewById(R.id.compatibility_check_title)
         private val descView: TextView = root.findViewById(R.id.compatibility_check_desc)
+        private val statusContainer: ViewGroup = root.findViewById(R.id.compatibility_check_status_container)
 
         fun bindItem(item: CompatibilityCheck) {
             titleView.text = item.title
             descView.text = item.description
 
+            statusContainer.children.forEach {
+                it.visibility = View.GONE
+            }
+
             when (item.state) {
                 CompatibilityCheck.State.SUCCESS -> {
                     root.findViewById<View>(R.id.compatibility_check_checkmark).visibility = View.VISIBLE

From 348395c48da26aae77f4cd87aff3b96dc57fa866 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 5 Mar 2024 20:14:21 -0500
Subject: [PATCH 020/458] chore: Bump lpac

---
 libs/lpac-jni/src/main/jni/lpac                | 2 +-
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index 47f44f911..dc09c3e66 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit 47f44f911099bffdbdb4854500578ba18ab19d06
+Subproject commit dc09c3e668fc191694e73fede255a7a0a26f4988
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 6cdda0086..503f81633 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -236,7 +236,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cGetProfilesInfo(JNIEnv *env, jobject th
         (*env)->DeleteLocalRef(env, jinfo);
     });
 
-    es10c_profile_info_free_all(info);
+    es10c_profile_info_list_free_all(info);
     return ret;
 }
 

From 3a0d805eb268c42dc53d2014f0b62ec7937b45c8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 11 Mar 2024 18:55:32 -0400
Subject: [PATCH 021/458] treewide: Nullability fixes for AOSP 14 r29

Mainly a treewide `findViewById` -> `requireViewById`, with
miscellaneous fixes.
---
 .../openeuicc/ui/EuiccManagementFragment.kt    | 16 ++++++++--------
 .../java/im/angry/openeuicc/ui/LogsActivity.kt |  8 ++++----
 .../java/im/angry/openeuicc/ui/MainActivity.kt |  4 ++--
 .../openeuicc/ui/NotificationsActivity.kt      | 10 +++++-----
 .../openeuicc/ui/ProfileDownloadFragment.kt    | 14 +++++++-------
 .../openeuicc/ui/ProfileRenameFragment.kt      |  6 +++---
 .../im/angry/openeuicc/ui/SettingsActivity.kt  |  2 +-
 .../angry/openeuicc/ui/SlotSelectFragment.kt   |  4 ++--
 .../LongSummaryPreferenceCategory.kt           |  2 +-
 .../main/java/im/angry/openeuicc/util/Utils.kt |  4 ++--
 .../openeuicc/ui/CompatibilityCheckActivity.kt | 18 +++++++++---------
 .../openeuicc/service/OpenEuiccService.kt      |  6 +++---
 .../java/im/angry/openeuicc/ui/LuiActivity.kt  |  4 ++--
 .../ui/PrivilegedEuiccManagementFragment.kt    |  2 +-
 .../angry/openeuicc/ui/SlotMappingFragment.kt  | 10 +++++-----
 .../util/PrivilegedTelephonyCompat.kt          |  6 +++---
 16 files changed, 58 insertions(+), 58 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index d2e7caa22..7564cc88e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -58,9 +58,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     ): View {
         val view = inflater.inflate(R.layout.fragment_euicc, container, false)
 
-        swipeRefresh = view.findViewById(R.id.swipe_refresh)
-        fab = view.findViewById(R.id.fab)
-        profileList = view.findViewById(R.id.profile_list)
+        swipeRefresh = view.requireViewById(R.id.swipe_refresh)
+        fab = view.requireViewById(R.id.fab)
+        profileList = view.requireViewById(R.id.profile_list)
 
         return view
     }
@@ -191,11 +191,11 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     }
 
     inner class ProfileViewHolder(private val root: View) : ViewHolder(root) {
-        private val iccid: TextView = root.findViewById(R.id.iccid)
-        private val name: TextView = root.findViewById(R.id.name)
-        private val state: TextView = root.findViewById(R.id.state)
-        private val provider: TextView = root.findViewById(R.id.provider)
-        private val profileMenu: ImageButton = root.findViewById(R.id.profile_menu)
+        private val iccid: TextView = root.requireViewById(R.id.iccid)
+        private val name: TextView = root.requireViewById(R.id.name)
+        private val state: TextView = root.requireViewById(R.id.state)
+        private val provider: TextView = root.requireViewById(R.id.provider)
+        private val profileMenu: ImageButton = root.requireViewById(R.id.profile_menu)
 
         init {
             iccid.setOnClickListener {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 70f6992b6..2b3646838 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -39,12 +39,12 @@ class LogsActivity : AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_logs)
-        setSupportActionBar(findViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(R.id.toolbar))
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
-        swipeRefresh = findViewById(R.id.swipe_refresh)
-        scrollView = findViewById(R.id.scroll_view)
-        logText = findViewById(R.id.log_text)
+        swipeRefresh = requireViewById(R.id.swipe_refresh)
+        scrollView = requireViewById(R.id.scroll_view)
+        logText = requireViewById(R.id.log_text)
 
         swipeRefresh.setOnRefreshListener {
             lifecycleScope.launch {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index ca6715d95..c7699e0f2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -36,9 +36,9 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
-        setSupportActionBar(findViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(R.id.toolbar))
 
-        noEuiccPlaceholder = findViewById(R.id.no_euicc_placeholder)
+        noEuiccPlaceholder = requireViewById(R.id.no_euicc_placeholder)
 
         tm = telephonyManager
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 87c5ba342..925ed84b5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -37,14 +37,14 @@ class NotificationsActivity: AppCompatActivity(), OpenEuiccContextMarker {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_notifications)
-        setSupportActionBar(findViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(R.id.toolbar))
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
         euiccChannel = euiccChannelManager
             .findEuiccChannelBySlotBlocking(intent.getIntExtra("logicalSlotId", 0))!!
 
-        swipeRefresh = findViewById(R.id.swipe_refresh)
-        notificationList = findViewById(R.id.recycler_view)
+        swipeRefresh = requireViewById(R.id.swipe_refresh)
+        notificationList = requireViewById(R.id.recycler_view)
 
         notificationList.layoutManager =
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
@@ -118,8 +118,8 @@ class NotificationsActivity: AppCompatActivity(), OpenEuiccContextMarker {
     @SuppressLint("ClickableViewAccessibility")
     inner class NotificationViewHolder(private val root: View):
         RecyclerView.ViewHolder(root), View.OnCreateContextMenuListener, OnMenuItemClickListener {
-        private val address: TextView = root.findViewById(R.id.notification_address)
-        private val profileName: TextView = root.findViewById(R.id.notification_profile_name)
+        private val address: TextView = root.requireViewById(R.id.notification_address)
+        private val profileName: TextView = root.requireViewById(R.id.notification_profile_name)
 
         private lateinit var notification: LocalProfileNotificationWrapper
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 43fc1ee96..8ab09d914 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -69,13 +69,13 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
     ): View {
         val view = inflater.inflate(R.layout.fragment_profile_download, container, false)
 
-        toolbar = view.findViewById(R.id.toolbar)
-        profileDownloadServer = view.findViewById(R.id.profile_download_server)
-        profileDownloadCode = view.findViewById(R.id.profile_download_code)
-        profileDownloadConfirmationCode = view.findViewById(R.id.profile_download_confirmation_code)
-        profileDownloadIMEI = view.findViewById(R.id.profile_download_imei)
-        profileDownloadFreeSpace = view.findViewById(R.id.profile_download_free_space)
-        progress = view.findViewById(R.id.progress)
+        toolbar = view.requireViewById(R.id.toolbar)
+        profileDownloadServer = view.requireViewById(R.id.profile_download_server)
+        profileDownloadCode = view.requireViewById(R.id.profile_download_code)
+        profileDownloadConfirmationCode = view.requireViewById(R.id.profile_download_confirmation_code)
+        profileDownloadIMEI = view.requireViewById(R.id.profile_download_imei)
+        profileDownloadFreeSpace = view.requireViewById(R.id.profile_download_free_space)
+        progress = view.requireViewById(R.id.progress)
 
         toolbar.inflateMenu(R.menu.fragment_profile_download)
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 7ebac3997..798711735 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -46,9 +46,9 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
     ): View {
         val view = inflater.inflate(R.layout.fragment_profile_rename, container, false)
 
-        toolbar = view.findViewById(R.id.toolbar)
-        profileRenameNewName = view.findViewById(R.id.profile_rename_new_name)
-        progress = view.findViewById(R.id.progress)
+        toolbar = view.requireViewById(R.id.toolbar)
+        profileRenameNewName = view.requireViewById(R.id.profile_rename_new_name)
+        progress = view.requireViewById(R.id.progress)
 
         toolbar.inflateMenu(R.menu.fragment_profile_rename)
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
index f5bb4d48a..426c54677 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
@@ -9,7 +9,7 @@ class SettingsActivity: AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_settings)
-        setSupportActionBar(findViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(R.id.toolbar))
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
         supportFragmentManager.beginTransaction()
             .replace(R.id.settings_container, SettingsFragment())
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
index 9bdcbc104..6288b0dfb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
@@ -39,13 +39,13 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
     ): View? {
         val view = inflater.inflate(R.layout.fragment_slot_select, container, false)
 
-        toolbar = view.findViewById(R.id.toolbar)
+        toolbar = view.requireViewById(R.id.toolbar)
         toolbar.setTitle(R.string.slot_select)
         toolbar.inflateMenu(R.menu.fragment_slot_select)
 
         val adapter = ArrayAdapter<String>(inflater.context, R.layout.spinner_item)
 
-        spinner = view.findViewById(R.id.spinner)
+        spinner = view.requireViewById(R.id.spinner)
         spinner.adapter = adapter
 
         channels.forEach { channel ->
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/preference/LongSummaryPreferenceCategory.kt b/app-common/src/main/java/im/angry/openeuicc/ui/preference/LongSummaryPreferenceCategory.kt
index a35e897b1..dc16e15fb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/preference/LongSummaryPreferenceCategory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/preference/LongSummaryPreferenceCategory.kt
@@ -18,4 +18,4 @@ class LongSummaryPreferenceCategory: PreferenceCategory {
         summaryText.isSingleLine = false
         summaryText.maxLines = 10
     }
-}
\ No newline at end of file
+}
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 33699d7eb..175e85fad 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -24,7 +24,7 @@ val Context.selfAppVersion: String
     get() =
         try {
             val pInfo = packageManager.getPackageInfo(packageName, 0)
-            pInfo.versionName
+            pInfo.versionName!!
         } catch (e: PackageManager.NameNotFoundException) {
             throw RuntimeException(e)
         }
@@ -91,4 +91,4 @@ suspend fun connectSEService(context: Context): SEService = suspendCoroutine { c
             }
         }
     }
-}
\ No newline at end of file
+}
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index b7c8cf803..b747befe3 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -24,10 +24,10 @@ class CompatibilityCheckActivity: AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_compatibility_check)
-        setSupportActionBar(findViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(R.id.toolbar))
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
-        compatibilityCheckList = findViewById(R.id.recycler_view)
+        compatibilityCheckList = requireViewById(R.id.recycler_view)
         compatibilityCheckList.layoutManager =
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
         compatibilityCheckList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
@@ -51,9 +51,9 @@ class CompatibilityCheckActivity: AppCompatActivity() {
         }
 
     inner class ViewHolder(private val root: View): RecyclerView.ViewHolder(root) {
-        private val titleView: TextView = root.findViewById(R.id.compatibility_check_title)
-        private val descView: TextView = root.findViewById(R.id.compatibility_check_desc)
-        private val statusContainer: ViewGroup = root.findViewById(R.id.compatibility_check_status_container)
+        private val titleView: TextView = root.requireViewById(R.id.compatibility_check_title)
+        private val descView: TextView = root.requireViewById(R.id.compatibility_check_desc)
+        private val statusContainer: ViewGroup = root.requireViewById(R.id.compatibility_check_status_container)
 
         fun bindItem(item: CompatibilityCheck) {
             titleView.text = item.title
@@ -65,16 +65,16 @@ class CompatibilityCheckActivity: AppCompatActivity() {
 
             when (item.state) {
                 CompatibilityCheck.State.SUCCESS -> {
-                    root.findViewById<View>(R.id.compatibility_check_checkmark).visibility = View.VISIBLE
+                    root.requireViewById<View>(R.id.compatibility_check_checkmark).visibility = View.VISIBLE
                 }
                 CompatibilityCheck.State.FAILURE -> {
-                    root.findViewById<View>(R.id.compatibility_check_error).visibility = View.VISIBLE
+                    root.requireViewById<View>(R.id.compatibility_check_error).visibility = View.VISIBLE
                 }
                 CompatibilityCheck.State.FAILURE_UNKNOWN -> {
-                    root.findViewById<View>(R.id.compatibility_check_unknown).visibility = View.VISIBLE
+                    root.requireViewById<View>(R.id.compatibility_check_unknown).visibility = View.VISIBLE
                 }
                 else -> {
-                    root.findViewById<View>(R.id.compatibility_check_progress_bar).visibility = View.VISIBLE
+                    root.requireViewById<View>(R.id.compatibility_check_progress_bar).visibility = View.VISIBLE
                 }
             }
         }
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 23f144422..3c9eaf26e 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -104,9 +104,9 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         return GetDefaultDownloadableSubscriptionListResult(RESULT_OK, arrayOf())
     }
 
-    override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult? {
+    override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult {
         Log.i(TAG, "onGetEuiccProfileInfoList slotId=$slotId")
-        val channel = findChannel(slotId) ?: return null
+        val channel = findChannel(slotId)!!
         val profiles = channel.lpa.profiles.operational.map {
             EuiccProfileInfo.Builder(it.iccid).apply {
                 setProfileName(it.name)
@@ -256,4 +256,4 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         // No-op -- we do not care
         return RESULT_FIRST_USER
     }
-}
\ No newline at end of file
+}
diff --git a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
index e60dfa720..f12c9b4eb 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
@@ -10,10 +10,10 @@ class LuiActivity : AppCompatActivity() {
         super.onStart()
         setContentView(R.layout.activity_lui)
 
-        findViewById<View>(R.id.lui_skip).setOnClickListener { finish() }
+        requireViewById<View>(R.id.lui_skip).setOnClickListener { finish() }
         // TODO: Deactivate LuiActivity if there is no eSIM found.
         // TODO: Support pre-filled download info (from carrier apps); UX
-        findViewById<View>(R.id.lui_download).setOnClickListener {
+        requireViewById<View>(R.id.lui_download).setOnClickListener {
             startActivity(Intent(this, DirectProfileDownloadActivity::class.java))
         }
     }
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index 78fcd4f53..744acb8bf 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -17,7 +17,7 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
     override suspend fun onCreateFooterViews(parent: ViewGroup): List<View> =
         if (channel.isMEP) {
             val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
-            view.findViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
+            view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
                 (requireActivity() as PrivilegedMainActivity).showSlotMappingFragment()
             }
             listOf(view)
diff --git a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
index 4c77bac0d..1514fe94f 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
@@ -51,12 +51,12 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
         savedInstanceState: Bundle?
     ): View? {
         val view = inflater.inflate(R.layout.fragment_slot_mapping, container, false)
-        toolbar = view.findViewById(R.id.toolbar)
+        toolbar = view.requireViewById(R.id.toolbar)
         toolbar.inflateMenu(R.menu.fragment_slot_mapping)
-        recyclerView = view.findViewById(R.id.mapping_list)
+        recyclerView = view.requireViewById(R.id.mapping_list)
         recyclerView.layoutManager =
             LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
-        helpTextView = view.findViewById(R.id.mapping_help)
+        helpTextView = view.requireViewById(R.id.mapping_help)
         return view
     }
 
@@ -148,8 +148,8 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
         }
 
     inner class ViewHolder(root: View): RecyclerView.ViewHolder(root), OnItemSelectedListener {
-        private val textViewLogicalSlot: TextView = root.findViewById(R.id.slot_mapping_logical_slot)
-        private val spinnerPorts: Spinner = root.findViewById(R.id.slot_mapping_ports)
+        private val textViewLogicalSlot: TextView = root.requireViewById(R.id.slot_mapping_logical_slot)
+        private val spinnerPorts: Spinner = root.requireViewById(R.id.slot_mapping_ports)
 
         init {
             spinnerPorts.adapter = ArrayAdapter(requireContext(), im.angry.openeuicc.common.R.layout.spinner_item, portsDesc)
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
index 029396344..b947afff2 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
@@ -95,9 +95,9 @@ fun TelephonyManager.iccOpenLogicalChannelByPortCompat(
     slotIndex: Int, portIndex: Int, aid: String?, p2: Int
 ): IccOpenLogicalChannelResponse =
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-        iccOpenLogicalChannelByPort(slotIndex, portIndex, aid, p2)
+        iccOpenLogicalChannelByPort(slotIndex, portIndex, aid, p2)!!
     } else {
-        iccOpenLogicalChannelBySlot(slotIndex, aid, p2)
+        iccOpenLogicalChannelBySlot(slotIndex, aid, p2)!!
     }
 
 fun TelephonyManager.iccCloseLogicalChannelByPortCompat(
@@ -121,4 +121,4 @@ fun TelephonyManager.iccTransmitApduLogicalChannelByPortCompat(
         iccTransmitApduLogicalChannelBySlot(
             slotIndex, channel, cla, inst, p1, p2, p3, data
         )
-    }
\ No newline at end of file
+    }

From 6977a32e808075409601def6a67fd9509031ada2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Mar 2024 11:19:07 -0400
Subject: [PATCH 022/458] refactor: EuiccChannel is not abstract

---
 .../openeuicc/core/DefaultEuiccChannelFactory.kt   |  2 +-
 .../java/im/angry/openeuicc/core/EuiccChannel.kt   | 11 ++++++++---
 .../im/angry/openeuicc/core/OmapiApduInterface.kt  | 14 +-------------
 .../core/PrivilegedEuiccChannelFactory.kt          |  4 +---
 .../core/TelephonyManagerApduInterface.kt          | 13 -------------
 5 files changed, 11 insertions(+), 33 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 15e019127..c741f4971 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -24,7 +24,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
 
         Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
         try {
-            return OmapiChannel(seService!!, port)
+            return EuiccChannel(port, OmapiApduInterface(seService!!, port))
         } catch (e: IllegalArgumentException) {
             // Failed
             Log.w(
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 003c0ccf8..35cf0ad00 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -1,16 +1,21 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.*
+import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
+import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
+import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 
-abstract class EuiccChannel(
-    val port: UiccPortInfoCompat
+class EuiccChannel(
+    val port: UiccPortInfoCompat,
+    apduInterface: ApduInterface,
 ) {
     val slotId = port.card.physicalSlotIndex // PHYSICAL slot
     val logicalSlotId = port.logicalSlotIndex
     val portId = port.portIndex
 
-    abstract val lpa: LocalProfileAssistant
+    val lpa: LocalProfileAssistant = LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl())
+
     val valid: Boolean
         get() = lpa.valid
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index 1349f3c8a..3d3bfe11a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -5,9 +5,6 @@ import android.se.omapi.SEService
 import android.se.omapi.Session
 import im.angry.openeuicc.util.*
 import net.typeblog.lpac_jni.ApduInterface
-import net.typeblog.lpac_jni.LocalProfileAssistant
-import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
-import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 
 class OmapiApduInterface(
     private val service: SEService,
@@ -47,13 +44,4 @@ class OmapiApduInterface(
         return lastChannel.transmit(tx)
     }
 
-}
-
-class OmapiChannel(
-    service: SEService,
-    port: UiccPortInfoCompat,
-) : EuiccChannel(port) {
-    override val lpa: LocalProfileAssistant = LocalProfileAssistantImpl(
-        OmapiApduInterface(service, port),
-        HttpInterfaceImpl())
-}
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 78acefe1f..317248b8d 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -26,9 +26,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                 "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
             )
             try {
-                return TelephonyManagerChannel(
-                    port, tm
-                )
+                return EuiccChannel(port, TelephonyManagerApduInterface(port, tm))
             } catch (e: IllegalArgumentException) {
                 // Failed
                 Log.w(
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index c0936a469..d6770c3c5 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -3,10 +3,7 @@ package im.angry.openeuicc.core
 import android.telephony.IccOpenLogicalChannelResponse
 import android.telephony.TelephonyManager
 import im.angry.openeuicc.util.*
-import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.ApduInterface
-import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
-import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 
 class TelephonyManagerApduInterface(
     private val port: UiccPortInfoCompat,
@@ -54,14 +51,4 @@ class TelephonyManagerApduInterface(
             cla, instruction, p1, p2, p3, p4)?.decodeHex() ?: byteArrayOf()
     }
 
-}
-
-class TelephonyManagerChannel(
-    port: UiccPortInfoCompat,
-    private val tm: TelephonyManager
-) : EuiccChannel(port) {
-    override val lpa: LocalProfileAssistant = LocalProfileAssistantImpl(
-        TelephonyManagerApduInterface(port, tm),
-        HttpInterfaceImpl()
-    )
 }
\ No newline at end of file

From 2061e6fea371c3f17533d0e7cc7e66334cd3a3fa Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Mar 2024 14:02:38 -0400
Subject: [PATCH 023/458] ui: Better placeholder for the no-eSIM case

---
 .../openeuicc/di/DefaultUiComponentFactory.kt |  4 +++
 .../angry/openeuicc/di/UiComponentFactory.kt  |  2 ++
 .../im/angry/openeuicc/ui/MainActivity.kt     |  8 ++---
 .../ui/NoEuiccPlaceholderFragment.kt          | 18 ++++++++++++
 .../src/main/res/layout/activity_main.xml     | 11 +------
 .../layout/fragment_no_euicc_placeholder.xml  | 13 +++++++++
 app-common/src/main/res/values/strings.xml    |  2 +-
 .../UnprivilegedOpenEuiccApplication.kt       |  5 ++++
 .../openeuicc/di/UnprivilegedAppContainer.kt  |  9 ++++++
 .../di/UnprivilegedUiComponentFactory.kt      |  9 ++++++
 .../UnprivilegedNoEuiccPlaceholderFragment.kt | 29 +++++++++++++++++++
 ...ment_no_euicc_placeholder_unprivileged.xml | 28 ++++++++++++++++++
 12 files changed, 123 insertions(+), 15 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
 create mode 100644 app-common/src/main/res/layout/fragment_no_euicc_placeholder.xml
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
 create mode 100644 app-unpriv/src/main/res/layout/fragment_no_euicc_placeholder_unprivileged.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
index 86af0076e..32550d63f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
@@ -1,9 +1,13 @@
 package im.angry.openeuicc.di
 
+import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
+import im.angry.openeuicc.ui.NoEuiccPlaceholderFragment
 
 open class DefaultUiComponentFactory : UiComponentFactory {
     override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
         EuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+
+    override fun createNoEuiccPlaceholderFragment(): Fragment = NoEuiccPlaceholderFragment()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
index d311876e5..4e09a7093 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
@@ -1,8 +1,10 @@
 package im.angry.openeuicc.di
 
+import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
 
 interface UiComponentFactory {
     fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment
+    fun createNoEuiccPlaceholderFragment(): Fragment
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index c7699e0f2..ddfea1321 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -29,8 +29,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
 
     private val fragments = arrayListOf<EuiccManagementFragment>()
 
-    private lateinit var noEuiccPlaceholder: View
-
     protected lateinit var tm: TelephonyManager
 
     override fun onCreate(savedInstanceState: Bundle?) {
@@ -38,7 +36,10 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
         setContentView(R.layout.activity_main)
         setSupportActionBar(requireViewById(R.id.toolbar))
 
-        noEuiccPlaceholder = requireViewById(R.id.no_euicc_placeholder)
+        supportFragmentManager.beginTransaction().replace(
+            R.id.fragment_root,
+            appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
+        ).commit()
 
         tm = telephonyManager
 
@@ -108,7 +109,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
             }
 
             if (fragments.isNotEmpty()) {
-                noEuiccPlaceholder.visibility = View.GONE
                 supportFragmentManager.beginTransaction().replace(R.id.fragment_root, fragments.first()).commit()
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
new file mode 100644
index 000000000..e9e44b118
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
@@ -0,0 +1,18 @@
+package im.angry.openeuicc.ui
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import im.angry.openeuicc.common.R
+
+class NoEuiccPlaceholderFragment : Fragment() {
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        return inflater.inflate(R.layout.fragment_no_euicc_placeholder, container, false)
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index 74b77993d..4f1020d74 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -21,15 +21,6 @@
         app:layout_constraintBottom_toBottomOf="parent"
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintTop_toBottomOf="@id/toolbar">
-        <TextView
-            android:id="@+id/no_euicc_placeholder"
-            android:layout_width="match_parent"
-            android:layout_height="match_parent"
-            android:layout_marginStart="40dp"
-            android:layout_marginEnd="40dp"
-            android:gravity="center"
-            android:text="@string/no_euicc" />
-    </FrameLayout>
+        app:layout_constraintTop_toBottomOf="@id/toolbar"/>
 
 </androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/fragment_no_euicc_placeholder.xml b/app-common/src/main/res/layout/fragment_no_euicc_placeholder.xml
new file mode 100644
index 000000000..b040fda6b
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_no_euicc_placeholder.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+    <TextView
+        android:id="@+id/no_euicc_placeholder"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:layout_marginStart="40dp"
+        android:layout_marginEnd="40dp"
+        android:gravity="center"
+        android:text="@string/no_euicc" />
+</FrameLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 040c910fc..52187850c 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="no_euicc">No eUICC card on this device is accessible by this app.\nInsert a supported eUICC card, or try out the privileged OpenEUICC app instead.</string>
+    <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device.</string>
     <string name="unknown">Unknown</string>
     <string name="help">Help</string>
 
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
index 23e7be9d0..55415012b 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
@@ -1,12 +1,17 @@
 package im.angry.openeuicc
 
 import android.content.Intent
+import im.angry.openeuicc.di.UnprivilegedAppContainer
 import im.angry.openeuicc.ui.LogsActivity
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.runBlocking
 import kotlin.system.exitProcess
 
 class UnprivilegedOpenEuiccApplication : OpenEuiccApplication() {
+    override val appContainer by lazy {
+        UnprivilegedAppContainer(this)
+    }
+
     override fun onCreate() {
         super.onCreate()
 
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
new file mode 100644
index 000000000..22d5a62dd
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
@@ -0,0 +1,9 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+
+class UnprivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
+    override val uiComponentFactory by lazy {
+        UnprivilegedUiComponentFactory()
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
new file mode 100644
index 000000000..f1170382a
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -0,0 +1,9 @@
+package im.angry.openeuicc.di
+
+import androidx.fragment.app.Fragment
+import im.angry.openeuicc.ui.UnprivilegedNoEuiccPlaceholderFragment
+
+class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
+    override fun createNoEuiccPlaceholderFragment(): Fragment =
+        UnprivilegedNoEuiccPlaceholderFragment()
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
new file mode 100644
index 000000000..92cda23bf
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
@@ -0,0 +1,29 @@
+package im.angry.openeuicc.ui
+
+import android.content.Intent
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.fragment.app.Fragment
+import im.angry.easyeuicc.R
+
+class UnprivilegedNoEuiccPlaceholderFragment : Fragment() {
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(
+            R.layout.fragment_no_euicc_placeholder_unprivileged,
+            container,
+            false
+        )
+
+        view.findViewById<View>(R.id.compatibility_check).setOnClickListener {
+            startActivity(Intent(requireContext(), CompatibilityCheckActivity::class.java))
+        }
+
+        return view
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/fragment_no_euicc_placeholder_unprivileged.xml b/app-unpriv/src/main/res/layout/fragment_no_euicc_placeholder_unprivileged.xml
new file mode 100644
index 000000000..7f9e65c0c
--- /dev/null
+++ b/app-unpriv/src/main/res/layout/fragment_no_euicc_placeholder_unprivileged.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/no_euicc_placeholder"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="40dp"
+        android:layout_marginEnd="40dp"
+        android:gravity="center"
+        android:text="@string/no_euicc"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent" />
+
+    <com.google.android.material.button.MaterialButton
+        android:id="@+id/compatibility_check"
+        android:text="@string/compatibility_check"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="10dp"
+        app:layout_constraintTop_toBottomOf="@id/no_euicc_placeholder"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file

From 999462c294896ff301037c54cc4ea821bb37351b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Mar 2024 14:19:07 -0400
Subject: [PATCH 024/458] ui: Hide spinner when no eSIM is found

---
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt    | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index ddfea1321..2d80e3316 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -25,6 +25,7 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
     }
 
     private lateinit var spinnerAdapter: ArrayAdapter<String>
+    private lateinit var spinnerItem: MenuItem
     private lateinit var spinner: Spinner
 
     private val fragments = arrayListOf<EuiccManagementFragment>()
@@ -54,7 +55,11 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
         menuInflater.inflate(R.menu.activity_main, menu)
 
         if (!this::spinner.isInitialized) {
-            spinner = menu.findItem(R.id.spinner).actionView as Spinner
+            spinnerItem = menu.findItem(R.id.spinner)
+            spinner = spinnerItem.actionView as Spinner
+            if (spinnerAdapter.isEmpty) {
+                spinnerItem.isVisible = false
+            }
             spinner.adapter = spinnerAdapter
             spinner.onItemSelectedListener = object : AdapterView.OnItemSelectedListener {
                 override fun onItemSelected(
@@ -109,6 +114,9 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
             }
 
             if (fragments.isNotEmpty()) {
+                if (this@MainActivity::spinner.isInitialized) {
+                    spinnerItem.isVisible = true
+                }
                 supportFragmentManager.beginTransaction().replace(R.id.fragment_root, fragments.first()).commit()
             }
         }

From d9d0cf2e7535b1e840e074d7127fb2421cf51781 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 20 Mar 2024 20:03:45 -0400
Subject: [PATCH 025/458] CompatibilityCheck: Show unknown status if OMAPI
 feature flag is not found

---
 .../src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt | 2 +-
 app-unpriv/src/main/res/values/strings.xml                      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index ae5a4da8d..83c1c5d9e 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -87,7 +87,7 @@ internal class HasSystemFeaturesCheck(private val context: Context): Compatibili
             PackageManager.FEATURE_SE_OMAPI_UICC
         )) {
             failureDescription = context.getString(R.string.compatibility_check_system_features_no_omapi)
-            return State.FAILURE
+            return State.FAILURE_UNKNOWN
         }
 
         return State.SUCCESS
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 588c0735f..e6641b3af 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -6,7 +6,7 @@
     <string name="compatibility_check_system_features">System Features</string>
     <string name="compatibility_check_system_features_desc">Whether your device has all the required features for managing removable eUICC cards. For example, basic telephony and OMAPI support.</string>
     <string name="compatibility_check_system_features_no_telephony">Your device has no telephony features.</string>
-    <string name="compatibility_check_system_features_no_omapi">Your device has no support for accessing SIM cards via OMAPI. If you are using a custom ROM, consider contacting the developer to determine whether it is due to hardware or a missing feature declaration in the OS.</string>
+    <string name="compatibility_check_system_features_no_omapi">Your device / system does not declare support for OMAPI. This could be due to missing support from hardware, or it could be simply due to a missing flag. See the following two checks to determine whether OMAPI is actually supported or not.</string>
     <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
     <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
     <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>

From 92d8f9079f00a342cd3c8a80ba375f059c82c86d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 21 Mar 2024 21:16:14 -0400
Subject: [PATCH 026/458] EuiccManagementFragment: Show alert dialog if timed
 out waiting for SIM

---
 .../angry/openeuicc/ui/EuiccManagementFragment.kt | 15 +++++++++++++++
 app-common/src/main/res/values/strings.xml        |  2 ++
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt    | 12 ++----------
 3 files changed, 19 insertions(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 7564cc88e..2e162b569 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -16,6 +16,7 @@ import android.widget.ImageButton
 import android.widget.PopupMenu
 import android.widget.TextView
 import android.widget.Toast
+import androidx.appcompat.app.AlertDialog
 import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -26,6 +27,7 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -138,6 +140,19 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
                 refresh()
                 fab.isEnabled = true
+            } catch (e: TimeoutCancellationException) {
+                // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
+                AlertDialog.Builder(requireContext()).apply {
+                    setMessage(R.string.enable_disable_timeout)
+                    setPositiveButton(android.R.string.ok) { dialog, _ ->
+                        dialog.dismiss()
+                        requireActivity().finish()
+                    }
+                    setOnDismissListener { _ ->
+                        requireActivity().finish()
+                    }
+                    show()
+                }
             } catch (e: Exception) {
                 Log.d(TAG, "Failed to enable / disable profile $iccid")
                 Log.d(TAG, Log.getStackTraceString(e))
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 52187850c..ac6b9d4e7 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -16,6 +16,8 @@
     <string name="delete">Delete</string>
     <string name="rename">Rename</string>
 
+    <string name="enable_disable_timeout">Timed out waiting for the eSIM chip to switch profiles. You might want to restart the application or even the phone.</string>
+
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>
 
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index b81a41ad9..246ead210 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -90,11 +90,7 @@ class LocalProfileAssistantImpl(
     override fun enableProfile(iccid: String, reconnectTimeout: Long): Boolean {
         val res = LpacJni.es10cEnableProfile(contextHandle, iccid) == 0
         if (reconnectTimeout > 0) {
-            try {
-                tryReconnect(reconnectTimeout)
-            } catch (e: Exception) {
-                return false
-            }
+            tryReconnect(reconnectTimeout)
         }
         return res
     }
@@ -102,11 +98,7 @@ class LocalProfileAssistantImpl(
     override fun disableProfile(iccid: String, reconnectTimeout: Long): Boolean {
         val res = LpacJni.es10cDisableProfile(contextHandle, iccid) == 0
         if (reconnectTimeout > 0) {
-            try {
-                tryReconnect(reconnectTimeout)
-            } catch (e: Exception) {
-                return false
-            }
+            tryReconnect(reconnectTimeout)
         }
         return res
     }

From 7834e0348a3dcc7ae94ac3dd6ecc61bceafbf841 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 21 Mar 2024 21:28:26 -0400
Subject: [PATCH 027/458] refactor: Move notification tracking logic to
 EuiccChannelFragmentUtils

---
 .../openeuicc/ui/EuiccManagementFragment.kt   |  4 +--
 .../openeuicc/ui/ProfileDeleteFragment.kt     |  2 +-
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 26 ++++++++++++------
 .../util/EuiccChannelFragmentUtils.kt         | 27 +++++++++++++++++++
 .../lpac_jni/LocalProfileAssistant.kt         | 26 ------------------
 5 files changed, 48 insertions(+), 37 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 2e162b569..98b3d3aca 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -163,13 +163,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     }
 
     private suspend fun doEnableProfile(iccid: String) =
-        channel.lpa.beginOperation {
+        beginTrackedOperation {
             channel.lpa.enableProfile(iccid, reconnectTimeout = 15 * 1000) &&
                 preferenceRepository.notificationEnableFlow.first()
         }
 
     private suspend fun doDisableProfile(iccid: String) =
-        channel.lpa.beginOperation {
+        beginTrackedOperation {
             channel.lpa.disableProfile(iccid, reconnectTimeout = 15 * 1000) &&
                 preferenceRepository.notificationDisableFlow.first()
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index ede48ea32..75863541f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -82,7 +82,7 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         }
     }
 
-    private suspend fun doDelete() = channel.lpa.beginOperation {
+    private suspend fun doDelete() = beginTrackedOperation {
         channel.lpa.deleteProfile(requireArguments().getString("iccid")!!)
         preferenceRepository.notificationDeleteFlow.first()
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 8ab09d914..78a54f216 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -189,15 +189,25 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         }
     }
 
-    private suspend fun doDownloadProfile(server: String, code: String?, confirmationCode: String?, imei: String?) = channel.lpa.beginOperation {
-        downloadProfile(server, code, imei, confirmationCode, object : ProfileDownloadCallback {
-            override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
-                lifecycleScope.launch(Dispatchers.Main) {
-                    progress.isIndeterminate = false
-                    progress.progress = state.progress
+    private suspend fun doDownloadProfile(
+        server: String,
+        code: String?,
+        confirmationCode: String?,
+        imei: String?
+    ) = beginTrackedOperation {
+        channel.lpa.downloadProfile(
+            server,
+            code,
+            imei,
+            confirmationCode,
+            object : ProfileDownloadCallback {
+                override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
+                    lifecycleScope.launch(Dispatchers.Main) {
+                        progress.isIndeterminate = false
+                        progress.progress = state.progress
+                    }
                 }
-            }
-        })
+            })
 
         // If we get here, we are successful
         // Only send notifications if the user allowed us to
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 7c984c7c7..feee0cddf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -1,8 +1,14 @@
 package im.angry.openeuicc.util
 
 import android.os.Bundle
+import android.util.Log
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import net.typeblog.lpac_jni.LocalProfileAssistant
+
+private const val TAG = "EuiccChannelFragmentUtils"
 
 interface EuiccChannelFragmentMarker: OpenEuiccContextMarker
 
@@ -28,6 +34,27 @@ val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
 
+/*
+ * Begin a "tracked" operation where notifications may be generated by the eSIM
+ * Automatically handle any newly generated notification during the operation
+ * if the function "op" returns true.
+ */
+suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T : Fragment, T : EuiccChannelFragmentMarker =
+    withContext(Dispatchers.IO) {
+        val latestSeq = channel.lpa.notifications.firstOrNull()?.seqNumber ?: 0
+        Log.d(TAG, "Latest notification is $latestSeq before operation")
+        if (op()) {
+            Log.d(TAG, "Operation has requested notification handling")
+            // Note that the exact instance of "channel" might have changed here if reconnected;
+            // so we MUST use the automatic getter for "channel"
+            channel.lpa.notifications.filter { it.seqNumber > latestSeq }.forEach {
+                Log.d(TAG, "Handling notification $it")
+                channel.lpa.handleNotification(it.seqNumber)
+            }
+        }
+        Log.d(TAG, "Operation complete")
+    }
+
 interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index b40ba10a9..fbc853d4d 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -1,14 +1,6 @@
 package net.typeblog.lpac_jni
 
-import android.util.Log
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.withContext
-
 interface LocalProfileAssistant {
-    companion object {
-        private const val TAG = "LocalProfileAssistant"
-    }
-
     val valid: Boolean
         get() = try {
             // If we can read both eID and profiles properly, we are likely looking at
@@ -37,24 +29,6 @@ interface LocalProfileAssistant {
     fun deleteNotification(seqNumber: Long): Boolean
     fun handleNotification(seqNumber: Long): Boolean
 
-    // Wraps an operation on the eSIM chip (any of the other blocking functions)
-    // Handles notifications automatically after the operation, unless the lambda executing
-    // the operation returns false, which inhibits automatic notification processing.
-    // All code executed within are also wrapped automatically in the IO context.
-    suspend fun beginOperation(op: suspend LocalProfileAssistant.() -> Boolean) =
-        withContext(Dispatchers.IO) {
-            val latestSeq = notifications.firstOrNull()?.seqNumber ?: 0
-            Log.d(TAG, "Latest notification is $latestSeq before operation")
-            if (op(this@LocalProfileAssistant)) {
-                Log.d(TAG, "Operation has requested notification handling")
-                notifications.filter { it.seqNumber > latestSeq }.forEach {
-                    Log.d(TAG, "Handling notification $it")
-                    handleNotification(it.seqNumber)
-                }
-            }
-            Log.d(TAG, "Operation complete")
-        }
-
     fun setNickname(
         iccid: String, nickname: String
     ): Boolean

From 1ac683f9aba9182f63d379f33b4ae40bf8f0bc9d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 21 Mar 2024 22:21:24 -0400
Subject: [PATCH 028/458] refactor: Reconnecting channels is a
 EuiccChannelManager responsibility

Reconnecting did not work properly for OMAPI, because in that case we
have to reconnect SEService as well.
---
 .../core/DefaultEuiccChannelFactory.kt        |  2 +-
 .../core/DefaultEuiccChannelManager.kt        | 45 +++++++++--
 .../openeuicc/core/EuiccChannelManager.kt     | 10 +++
 .../openeuicc/ui/EuiccManagementFragment.kt   | 74 ++++++++++---------
 .../UnprivilegedOpenEuiccApplication.kt       |  3 +-
 .../lpac_jni/LocalProfileAssistant.kt         |  4 +-
 .../impl/LocalProfileAssistantImpl.kt         | 67 ++---------------
 7 files changed, 98 insertions(+), 107 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index c741f4971..1cb365058 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -10,7 +10,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
     private var seService: SEService? = null
 
     private suspend fun ensureSEService() {
-        if (seService == null) {
+        if (seService == null || !seService!!.isConnected) {
             seService = connectSEService(context)
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index a97867759..ec676d150 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -6,10 +6,12 @@ import android.util.Log
 import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
+import kotlinx.coroutines.withTimeout
 
 open class DefaultEuiccChannelManager(
     protected val appContainer: AppContainer,
@@ -87,14 +89,18 @@ open class DefaultEuiccChannelManager(
             }
         }
 
+    override suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
+        for (card in uiccCards) {
+            if (card.physicalSlotIndex != physicalSlotId) continue
+            return card.ports.mapNotNull { tryOpenEuiccChannel(it) }
+                .ifEmpty { null }
+        }
+        return null
+    }
+
     override fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? =
         runBlocking {
-            for (card in uiccCards) {
-                if (card.physicalSlotIndex != physicalSlotId) continue
-                return@runBlocking card.ports.mapNotNull { tryOpenEuiccChannel(it) }
-                    .ifEmpty { null }
-            }
-            return@runBlocking null
+            findAllEuiccChannelsByPhysicalSlot(physicalSlotId)
         }
 
     override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
@@ -106,6 +112,25 @@ open class DefaultEuiccChannelManager(
             }
         }
 
+    override suspend fun tryReconnectSlot(physicalSlotId: Int, timeoutMillis: Long) {
+        invalidateByPhysicalSlot(physicalSlotId)
+
+        withTimeout(timeoutMillis) {
+            while (true) {
+                try {
+                    findAllEuiccChannelsByPhysicalSlot(physicalSlotId)!!.forEach {
+                        check(it.valid) { "Invalid channel" }
+                    }
+                    break
+                } catch (e: Exception) {
+                    Log.d(TAG, "Slot reconnect failure, retrying in 1000 ms")
+                    invalidateByPhysicalSlot(physicalSlotId)
+                }
+                delay(1000)
+            }
+        }
+    }
+
     override suspend fun enumerateEuiccChannels() {
         withContext(Dispatchers.IO) {
             for (uiccInfo in uiccCards) {
@@ -132,4 +157,12 @@ open class DefaultEuiccChannelManager(
         channels.clear()
         euiccChannelFactory.cleanup()
     }
+
+    private fun invalidateByPhysicalSlot(physicalSlotId: Int) {
+        val toRemove = channels.filter { it.valid && it.slotId == physicalSlotId }
+        for (channel in toRemove) {
+            channel.close()
+            channels.remove(channel)
+        }
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index b0bce1daf..5ee40f27b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -8,6 +8,15 @@ interface EuiccChannelManager {
      */
     suspend fun enumerateEuiccChannels()
 
+    /**
+     * Reconnect ALL EuiccChannels belonging to a physical slot
+     * Throws TimeoutCancellationException when timed out
+     * If this operation times out, none of the channels belonging to the slot will be
+     * guaranteed to be consistent. The caller should either call invalidate()
+     * and try again later, or the application should simply exit entirely.
+     */
+    suspend fun tryReconnectSlot(physicalSlotId: Int, timeoutMillis: Long = 1000)
+
     /**
      * Returns the EuiccChannel corresponding to a **logical** slot
      */
@@ -24,6 +33,7 @@ interface EuiccChannelManager {
      * Returns all EuiccChannels corresponding to a **physical** slot
      * Multiple channels are possible in the case of MEP
      */
+    suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>?
     fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>?
 
     /**
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 98b3d3aca..c02f7fdb7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -31,7 +31,6 @@ import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
-import java.lang.Exception
 
 open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     EuiccChannelFragmentMarker {
@@ -132,48 +131,51 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         fab.isEnabled = false
 
         lifecycleScope.launch {
-            try {
-                if (enable) {
-                    doEnableProfile(iccid)
+            beginTrackedOperation {
+                val res = if (enable) {
+                    channel.lpa.enableProfile(iccid)
                 } else {
-                    doDisableProfile(iccid)
+                    channel.lpa.disableProfile(iccid)
                 }
-                refresh()
-                fab.isEnabled = true
-            } catch (e: TimeoutCancellationException) {
-                // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
-                AlertDialog.Builder(requireContext()).apply {
-                    setMessage(R.string.enable_disable_timeout)
-                    setPositiveButton(android.R.string.ok) { dialog, _ ->
-                        dialog.dismiss()
-                        requireActivity().finish()
-                    }
-                    setOnDismissListener { _ ->
-                        requireActivity().finish()
-                    }
-                    show()
+
+                if (!res) {
+                    Log.d(TAG, "Failed to enable / disable profile $iccid")
+                    Toast.makeText(context, R.string.toast_profile_enable_failed, Toast.LENGTH_LONG)
+                        .show()
+                    return@beginTrackedOperation false
+                }
+
+                try {
+                    euiccChannelManager.tryReconnectSlot(slotId, timeoutMillis = 30 * 1000)
+                } catch (e: TimeoutCancellationException) {
+                    withContext(Dispatchers.Main) {
+                        // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
+                        AlertDialog.Builder(requireContext()).apply {
+                            setMessage(R.string.enable_disable_timeout)
+                            setPositiveButton(android.R.string.ok) { dialog, _ ->
+                                dialog.dismiss()
+                                requireActivity().finish()
+                            }
+                            setOnDismissListener { _ ->
+                                requireActivity().finish()
+                            }
+                            show()
+                        }
+                    }
+                    return@beginTrackedOperation false
+                }
+
+                if (enable) {
+                    preferenceRepository.notificationEnableFlow.first()
+                } else {
+                    preferenceRepository.notificationDisableFlow.first()
                 }
-            } catch (e: Exception) {
-                Log.d(TAG, "Failed to enable / disable profile $iccid")
-                Log.d(TAG, Log.getStackTraceString(e))
-                fab.isEnabled = true
-                Toast.makeText(context, R.string.toast_profile_enable_failed, Toast.LENGTH_LONG).show()
             }
+            refresh()
+            fab.isEnabled = true
         }
     }
 
-    private suspend fun doEnableProfile(iccid: String) =
-        beginTrackedOperation {
-            channel.lpa.enableProfile(iccid, reconnectTimeout = 15 * 1000) &&
-                preferenceRepository.notificationEnableFlow.first()
-        }
-
-    private suspend fun doDisableProfile(iccid: String) =
-        beginTrackedOperation {
-            channel.lpa.disableProfile(iccid, reconnectTimeout = 15 * 1000) &&
-                preferenceRepository.notificationDisableFlow.first()
-        }
-
     protected open fun populatePopupWithProfileActions(popup: PopupMenu, profile: LocalProfileInfo) {
         popup.inflate(R.menu.profile_options)
         if (profile.isEnabled) {
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
index 55415012b..7993b5014 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/UnprivilegedOpenEuiccApplication.kt
@@ -15,7 +15,8 @@ class UnprivilegedOpenEuiccApplication : OpenEuiccApplication() {
     override fun onCreate() {
         super.onCreate()
 
-        Thread.setDefaultUncaughtExceptionHandler { _, _ ->
+        Thread.setDefaultUncaughtExceptionHandler { _, e ->
+            e.printStackTrace()
             Intent(this, LogsActivity::class.java).apply {
                 addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK)
                 addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index fbc853d4d..118a96335 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -19,8 +19,8 @@ interface LocalProfileAssistant {
 
     // All blocking functions in this class assume that they are executed on non-Main threads
     // The IO context in Kotlin's coroutine library is recommended.
-    fun enableProfile(iccid: String, reconnectTimeout: Long = 0): Boolean
-    fun disableProfile(iccid: String, reconnectTimeout: Long = 0): Boolean
+    fun enableProfile(iccid: String): Boolean
+    fun disableProfile(iccid: String): Boolean
     fun deleteProfile(iccid: String): Boolean
 
     fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 246ead210..98a39690e 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -1,9 +1,6 @@
 package net.typeblog.lpac_jni.impl
 
 import android.util.Log
-import kotlinx.coroutines.delay
-import kotlinx.coroutines.runBlocking
-import kotlinx.coroutines.withTimeout
 import net.typeblog.lpac_jni.LpacJni
 import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.EuiccInfo2
@@ -14,8 +11,8 @@ import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
-    private val apduInterface: ApduInterface,
-    private val httpInterface: HttpInterface
+    apduInterface: ApduInterface,
+    httpInterface: HttpInterface
 ): LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
@@ -31,48 +28,6 @@ class LocalProfileAssistantImpl(
         httpInterface.usePublicKeyIds(pkids)
     }
 
-    private fun tryReconnect(timeoutMillis: Long) = runBlocking {
-        withTimeout(timeoutMillis) {
-            try {
-                LpacJni.euiccFini(contextHandle)
-                LpacJni.destroyContext(contextHandle)
-                contextHandle = -1
-            } catch (e: Exception) {
-                // Ignored
-            }
-
-            while (true) {
-                try {
-                    apduInterface.disconnect()
-                } catch (e: Exception) {
-                    // Ignored
-                }
-
-                try {
-                    apduInterface.connect()
-                    contextHandle = LpacJni.createContext(apduInterface, httpInterface)
-                    check(LpacJni.euiccInit(contextHandle) >= 0) { "Reconnect attempt failed" }
-                    // Validate that we can actually use the APDU channel by trying to read eID and profiles
-                    check(valid) { "Reconnected channel is invalid" }
-                    break
-                } catch (e: Exception) {
-                    e.printStackTrace()
-                    if (contextHandle != -1L) {
-                        try {
-                            LpacJni.euiccFini(contextHandle)
-                            LpacJni.destroyContext(contextHandle)
-                            contextHandle = -1
-                        } catch (e: Exception) {
-                            // Ignored
-                        }
-                    }
-                    // continue retrying
-                    delay(1000)
-                }
-            }
-        }
-    }
-
     override val profiles: List<LocalProfileInfo>
         get() = LpacJni.es10cGetProfilesInfo(contextHandle)!!.asList()
 
@@ -87,21 +42,11 @@ class LocalProfileAssistantImpl(
     override val euiccInfo2: EuiccInfo2?
         get() = LpacJni.es10cexGetEuiccInfo2(contextHandle)
 
-    override fun enableProfile(iccid: String, reconnectTimeout: Long): Boolean {
-        val res = LpacJni.es10cEnableProfile(contextHandle, iccid) == 0
-        if (reconnectTimeout > 0) {
-            tryReconnect(reconnectTimeout)
-        }
-        return res
-    }
+    override fun enableProfile(iccid: String): Boolean =
+        LpacJni.es10cEnableProfile(contextHandle, iccid) == 0
 
-    override fun disableProfile(iccid: String, reconnectTimeout: Long): Boolean {
-        val res = LpacJni.es10cDisableProfile(contextHandle, iccid) == 0
-        if (reconnectTimeout > 0) {
-            tryReconnect(reconnectTimeout)
-        }
-        return res
-    }
+    override fun disableProfile(iccid: String): Boolean =
+        LpacJni.es10cDisableProfile(contextHandle, iccid) == 0
 
     override fun deleteProfile(iccid: String): Boolean {
         return LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0

From e48f9aa8289ea492fac8b14f63f880f27a3dcac0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 22 Mar 2024 21:08:59 -0400
Subject: [PATCH 029/458] refactor: Channel validity, and reconnection

* ApduInterfaces also need a concept of validity based on the underlying
  APDU channel. For example, OMAPI depends on SEService being still
  connected.
* We then rely on this validity to wait for reconnection; we do not need
  to manually remove all channels under a slot because the rest will be
  invalid anyway, and the next attempt at connection will lazily
  recreate the channel.
* We had to manage channels manually before during reconnect because
  `valid` may result in SIGSEGV's when the underlying APDU channel has
  become invalid. This is avoided by the validity concept added to APDU
  channels.
---
 .../core/DefaultEuiccChannelManager.kt        | 41 +++++++++----------
 .../openeuicc/core/EuiccChannelManager.kt     | 11 +++--
 .../openeuicc/core/OmapiApduInterface.kt      |  3 ++
 .../openeuicc/ui/EuiccManagementFragment.kt   |  2 +-
 .../core/TelephonyManagerApduInterface.kt     |  5 +++
 .../net/typeblog/lpac_jni/ApduInterface.kt    |  7 ++++
 .../lpac_jni/LocalProfileAssistant.kt         |  9 ----
 .../impl/LocalProfileAssistantImpl.kt         | 22 ++++++++--
 8 files changed, 60 insertions(+), 40 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index ec676d150..811c56ca3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -103,28 +103,35 @@ open class DefaultEuiccChannelManager(
             findAllEuiccChannelsByPhysicalSlot(physicalSlotId)
         }
 
-    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
-                    card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
-                }
+    override suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel? =
+        withContext(Dispatchers.IO) {
+            uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
+                card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
             }
         }
 
-    override suspend fun tryReconnectSlot(physicalSlotId: Int, timeoutMillis: Long) {
-        invalidateByPhysicalSlot(physicalSlotId)
+    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
+        runBlocking {
+            findEuiccChannelByPort(physicalSlotId, portId)
+        }
+
+    override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
+        // If there is already a valid channel, we close it proactively
+        // Sometimes the current channel can linger on for a bit even after it should have become invalid
+        channels.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
+            if (valid) close()
+        }
 
         withTimeout(timeoutMillis) {
             while (true) {
                 try {
-                    findAllEuiccChannelsByPhysicalSlot(physicalSlotId)!!.forEach {
-                        check(it.valid) { "Invalid channel" }
-                    }
+                    // tryOpenEuiccChannel() will automatically dispose of invalid channels
+                    // and recreate when needed
+                    val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)!!
+                    check(channel.valid) { "Invalid channel" }
                     break
                 } catch (e: Exception) {
-                    Log.d(TAG, "Slot reconnect failure, retrying in 1000 ms")
-                    invalidateByPhysicalSlot(physicalSlotId)
+                    Log.d(TAG, "Slot $physicalSlotId port $portId reconnect failure, retrying in 1000 ms")
                 }
                 delay(1000)
             }
@@ -157,12 +164,4 @@ open class DefaultEuiccChannelManager(
         channels.clear()
         euiccChannelFactory.cleanup()
     }
-
-    private fun invalidateByPhysicalSlot(physicalSlotId: Int) {
-        val toRemove = channels.filter { it.valid && it.slotId == physicalSlotId }
-        for (channel in toRemove) {
-            channel.close()
-            channels.remove(channel)
-        }
-    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 5ee40f27b..9ec303012 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -9,13 +9,11 @@ interface EuiccChannelManager {
     suspend fun enumerateEuiccChannels()
 
     /**
-     * Reconnect ALL EuiccChannels belonging to a physical slot
-     * Throws TimeoutCancellationException when timed out
-     * If this operation times out, none of the channels belonging to the slot will be
-     * guaranteed to be consistent. The caller should either call invalidate()
-     * and try again later, or the application should simply exit entirely.
+     * Wait for a slot + port to reconnect (i.e. become valid again)
+     * If the port is currently valid, this function will return immediately.
+     * On timeout, the caller can decide to either try again later, or alert the user with an error
      */
-    suspend fun tryReconnectSlot(physicalSlotId: Int, timeoutMillis: Long = 1000)
+    suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long = 1000)
 
     /**
      * Returns the EuiccChannel corresponding to a **logical** slot
@@ -39,6 +37,7 @@ interface EuiccChannelManager {
     /**
      * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
      */
+    suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel?
     fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
 
     /**
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index 3d3bfe11a..227977c90 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -13,6 +13,9 @@ class OmapiApduInterface(
     private lateinit var session: Session
     private lateinit var lastChannel: Channel
 
+    override val valid: Boolean
+        get() = service.isConnected && (this::session.isInitialized && !session.isClosed)
+
     override fun connect() {
         session = service.getUiccReaderCompat(port.logicalSlotIndex + 1).openSession()
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index c02f7fdb7..c1e5ba6d0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -146,7 +146,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
 
                 try {
-                    euiccChannelManager.tryReconnectSlot(slotId, timeoutMillis = 30 * 1000)
+                    euiccChannelManager.waitForReconnect(slotId, portId, timeoutMillis = 30 * 1000)
                 } catch (e: TimeoutCancellationException) {
                     withContext(Dispatchers.Main) {
                         // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index d6770c3c5..509d7ee89 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -11,6 +11,11 @@ class TelephonyManagerApduInterface(
 ): ApduInterface {
     private var lastChannel: Int = -1
 
+    override val valid: Boolean
+        // TelephonyManager channels will never become truly "invalid",
+        // just that transactions might return errors or nonsense
+        get() = lastChannel != -1
+
     override fun connect() {
         // Do nothing
     }
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
index 44d1a3ef1..dfa92dfa7 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
@@ -9,4 +9,11 @@ interface ApduInterface {
     fun logicalChannelOpen(aid: ByteArray): Int
     fun logicalChannelClose(handle: Int)
     fun transmit(tx: ByteArray): ByteArray
+
+    /**
+     * Is this APDU connection still valid?
+     * Note that even if this returns true, the underlying connection might be broken anyway;
+     * callers should further check with the LPA to fully determine the validity of a channel
+     */
+    val valid: Boolean
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 118a96335..16a91e778 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -2,15 +2,6 @@ package net.typeblog.lpac_jni
 
 interface LocalProfileAssistant {
     val valid: Boolean
-        get() = try {
-            // If we can read both eID and profiles properly, we are likely looking at
-            // a valid LocalProfileAssistant
-            eID
-            profiles
-            true
-        } catch (e: Exception) {
-            false
-        }
     val profiles: List<LocalProfileInfo>
     val notifications: List<LocalProfileNotification>
     val eID: String
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 98a39690e..a76ba753c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -11,13 +11,14 @@ import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
-    apduInterface: ApduInterface,
+    private val apduInterface: ApduInterface,
     httpInterface: HttpInterface
 ): LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
     }
 
+    private var finalized = false
     private var contextHandle: Long = LpacJni.createContext(apduInterface, httpInterface)
     init {
         if (LpacJni.euiccInit(contextHandle) < 0) {
@@ -28,6 +29,17 @@ class LocalProfileAssistantImpl(
         httpInterface.usePublicKeyIds(pkids)
     }
 
+    override val valid: Boolean
+        get() = !finalized && apduInterface.valid && try {
+            // If we can read both eID and profiles properly, we are likely looking at
+            // a valid LocalProfileAssistant
+            eID
+            profiles
+            true
+        } catch (e: Exception) {
+            false
+        }
+
     override val profiles: List<LocalProfileInfo>
         get() = LpacJni.es10cGetProfilesInfo(contextHandle)!!.asList()
 
@@ -71,8 +83,12 @@ class LocalProfileAssistantImpl(
         return LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
     }
 
+    @Synchronized
     override fun close() {
-        LpacJni.euiccFini(contextHandle)
-        LpacJni.destroyContext(contextHandle)
+        if (!finalized) {
+            LpacJni.euiccFini(contextHandle)
+            LpacJni.destroyContext(contextHandle)
+            finalized = true
+        }
     }
 }
\ No newline at end of file

From 2517fc817e3128579dfacbd8db508c7d0b893152 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 23 Mar 2024 11:17:10 -0400
Subject: [PATCH 030/458] ComaptibilityCheck: Clarify "Known Broken"

---
 app-unpriv/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index e6641b3af..7ba42fe77 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -15,7 +15,7 @@
     <string name="compatibility_check_isdr_channel_desc">Does your device support opening an ISD-R (management) channel to eSIMs via OMAPI?</string>
     <string name="compatibility_check_isdr_channel_desc_unknown">Cannot determine whether ISD-R access through OMAPI is supported. You might want to retry with SIM cards inserted (any SIM card will do) if not already.</string>
     <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: %s.</string>
-    <string name="compatibility_check_known_broken">Known Broken?</string>
+    <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
     <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>
 </resources>
\ No newline at end of file

From 4b842c4afeaec33c9f9304ceac834a6d39d85a7d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 23 Mar 2024 20:56:42 -0400
Subject: [PATCH 031/458] feat: Add an "verdict" to compatibility checks

---
 .../openeuicc/util/CompatibilityCheck.kt      | 69 ++++++++++++++++---
 app-unpriv/src/main/res/values/strings.xml    |  8 +++
 2 files changed, 68 insertions(+), 9 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 83c1c5d9e..d2ee8ccdb 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -16,12 +16,16 @@ fun getCompatibilityChecks(context: Context): List<CompatibilityCheck> =
         HasSystemFeaturesCheck(context),
         OmapiConnCheck(context),
         IsdrChannelAccessCheck(context),
-        KnownBrokenCheck(context)
+        KnownBrokenCheck(context),
+        Verdict(context),
     )
 
+inline fun <reified T: CompatibilityCheck> List<CompatibilityCheck>.findCheck(): T? =
+    find { it.javaClass == T::class.java }?.let { it as T }
+
 suspend fun List<CompatibilityCheck>.executeAll(callback: () -> Unit) = withContext(Dispatchers.IO) {
     forEach {
-        it.run()
+        it.run(this@executeAll)
         withContext(Dispatchers.Main) {
             callback()
         }
@@ -57,13 +61,13 @@ abstract class CompatibilityCheck(context: Context) {
             else -> defaultDescription
         }
 
-    protected abstract suspend fun doCheck(): State
+    protected abstract suspend fun doCheck(allChecks: List<CompatibilityCheck>): State
 
-    suspend fun run() {
+    suspend fun run(allChecks: List<CompatibilityCheck>) {
         state = State.IN_PROGRESS
         delay(200)
         state = try {
-            doCheck()
+            doCheck(allChecks)
         } catch (_: Exception) {
             State.FAILURE
         }
@@ -76,7 +80,7 @@ internal class HasSystemFeaturesCheck(private val context: Context): Compatibili
     override val defaultDescription: String
         get() = context.getString(R.string.compatibility_check_system_features_desc)
 
-    override suspend fun doCheck(): State {
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
         if (!context.packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY)) {
             failureDescription = context.getString(R.string.compatibility_check_system_features_no_telephony)
             return State.FAILURE
@@ -100,7 +104,7 @@ internal class OmapiConnCheck(private val context: Context): CompatibilityCheck(
     override val defaultDescription: String
         get() = context.getString(R.string.compatibility_check_omapi_connectivity_desc)
 
-    override suspend fun doCheck(): State {
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
         val seService = connectSEService(context)
         if (!seService.isConnected) {
             failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail)
@@ -132,7 +136,7 @@ internal class IsdrChannelAccessCheck(private val context: Context): Compatibili
     override val defaultDescription: String
         get() = context.getString(R.string.compatibility_check_isdr_channel_desc)
 
-    override suspend fun doCheck(): State {
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
         val seService = connectSEService(context)
         val readers = seService.readers.filter { it.isSIM }
         if (readers.isEmpty()) {
@@ -200,10 +204,57 @@ internal class KnownBrokenCheck(private val context: Context): CompatibilityChec
         failureDescription = context.getString(R.string.compatibility_check_known_broken_fail)
     }
 
-    override suspend fun doCheck(): State =
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State =
         if (Build.MANUFACTURER.lowercase() in BROKEN_MANUFACTURERS) {
             State.FAILURE
         } else {
             State.SUCCESS
         }
+}
+
+internal class Verdict(private val context: Context) : CompatibilityCheck(context) {
+    override val title: String
+        get() = context.getString(R.string.compatibility_check_verdict)
+    override val defaultDescription: String
+        get() = context.getString(R.string.compatibility_check_verdict_desc)
+
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
+        if (allChecks.findCheck<KnownBrokenCheck>()?.state == State.FAILURE) {
+            failureDescription = context.getString(
+                R.string.compatibility_check_verdict_known_broken,
+                context.getString(R.string.compatibility_check_verdict_fail_shared)
+            )
+            return State.FAILURE
+        }
+
+        if (allChecks.findCheck<OmapiConnCheck>()?.state == State.SUCCESS &&
+            allChecks.findCheck<IsdrChannelAccessCheck>()?.state == State.SUCCESS
+        ) {
+            successDescription = context.getString(R.string.compatibility_check_verdict_ok)
+            return State.SUCCESS
+        }
+
+        if (allChecks.findCheck<OmapiConnCheck>()?.state == State.FAILURE_UNKNOWN ||
+            allChecks.findCheck<IsdrChannelAccessCheck>()?.state == State.FAILURE_UNKNOWN
+        ) {
+            // We are not sure because we can't fully check OMAPI
+            // however we can guess based on feature flags
+            // TODO: We probably need a "known-good" list for these devices as well?
+            failureDescription = context.getString(
+                if (allChecks.findCheck<HasSystemFeaturesCheck>()?.state == State.SUCCESS) {
+                    R.string.compatibility_check_verdict_unknown_likely_ok
+                } else {
+                    R.string.compatibility_check_verdict_unknown_likely_fail
+                },
+                context.getString(R.string.compatibility_check_verdict_fail_shared)
+            )
+            return State.FAILURE_UNKNOWN
+        }
+
+        failureDescription = context.getString(
+            R.string.compatibility_check_verdict_unknown,
+            context.getString(R.string.compatibility_check_verdict_fail_shared)
+        )
+        return State.FAILURE_UNKNOWN
+    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 7ba42fe77..625136dce 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -18,4 +18,12 @@
     <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
     <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>
+    <string name="compatibility_check_verdict">Verdict</string>
+    <string name="compatibility_check_verdict_desc">Based on all previous checks, how likely is your device to be compatible with removable eSIMs?</string>
+    <string name="compatibility_check_verdict_ok">You can likely use and manage removable eSIMs on this device.</string>
+    <string name="compatibility_check_verdict_known_broken">Your device is known to be buggy when accessing removable eSIMs.\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_ok">We cannot determine whether removable eSIMs can be managed on your device. Your device does declare support for OMAPI, though, so it is slightly more likely that it will work.\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_fail">We cannot determine whether removable eSIMs can be managed on your device. Since your device does not declare support for OMAPI, it is more likely that managing removable eSIMs on this device is unsupported.\n%s</string>
+    <string name="compatibility_check_verdict_unknown">We cannot determine whether removable eSIMs can be managed on your device.\n%s</string>
+    <string name="compatibility_check_verdict_fail_shared">However, a removable eSIM that has already been loaded with an eSIM profile will still work; this verdict is only for management features via the app, such as switching and downloading profiles.</string>
 </resources>
\ No newline at end of file

From 1ed5a4de38d111812003aa4b42363125094e1470 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 29 Mar 2024 17:31:06 -0400
Subject: [PATCH 032/458] chore: Uprev lpac

Fixes #20
---
 libs/lpac-jni/src/main/jni/lpac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index dc09c3e66..0bb196977 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit dc09c3e668fc191694e73fede255a7a0a26f4988
+Subproject commit 0bb196977e7f2e276a1076734897ad8c48d9d5ca

From 80adac68c8b18945f35d833cb7b17d3da7542a6e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 30 Mar 2024 15:30:40 -0400
Subject: [PATCH 033/458] ui: Use KiB instead of KB for free space

Fixes #19.
---
 .../im/angry/openeuicc/ui/ProfileDownloadFragment.kt   |  3 +--
 .../main/java/im/angry/openeuicc/util/StringUtils.kt   | 10 +++++++++-
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 78a54f216..feb0ab068 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -5,7 +5,6 @@ import android.app.Dialog
 import android.content.DialogInterface
 import android.os.Bundle
 import android.text.Editable
-import android.text.format.Formatter
 import android.util.Log
 import android.view.*
 import android.widget.ProgressBar
@@ -131,7 +130,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
             // Fetch remaining NVRAM
             val str = channel.lpa.euiccInfo2?.freeNvram?.also {
                 freeNvram = it
-            }?.let { Formatter.formatShortFileSize(requireContext(), it.toLong()) }
+            }?.let { formatFreeSpace(it) }
 
             withContext(Dispatchers.Main) {
                 profileDownloadFreeSpace.text = getString(R.string.profile_download_free_space,
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index cca08745f..ebf872984 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -19,4 +19,12 @@ fun ByteArray.encodeHex(): String {
         sb.append(String.format("%02X", this[i]))
     }
     return sb.toString()
-}
\ No newline at end of file
+}
+
+fun formatFreeSpace(size: Int): String =
+    // SIM cards probably won't have much more space anytime soon.
+    if (size >= 1024) {
+        "%.2f KiB".format(size.toDouble() / 1024)
+    } else {
+        "$size B"
+    }
\ No newline at end of file

From f046d40f2ccf760cdcfe1cf9bafb090b827a8d05 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 30 Mar 2024 15:36:30 -0400
Subject: [PATCH 034/458] privileged: Disable slot mapping support for pre-T

Fixes #15.
---
 .../main/java/im/angry/openeuicc/service/OpenEuiccService.kt | 5 +++++
 .../java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt     | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 3c9eaf26e..65d791802 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.service
 
+import android.os.Build
 import android.service.euicc.*
 import android.telephony.UiccSlotMapping
 import android.telephony.euicc.DownloadableSubscription
@@ -34,6 +35,10 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         lpa.profiles.any { it.iccid == iccid }
 
     private fun ensurePortIsMapped(slotId: Int, portId: Int) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
+            return
+        }
+
         val mappings = telephonyManager.simSlotMapping.toMutableList()
 
         mappings.firstOrNull { it.physicalSlotIndex == slotId && it.portIndex == portId }?.let {
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
index f3c2b3c8a..440e52908 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.ui
 
+import android.os.Build
 import android.view.Menu
 import android.view.MenuItem
 import android.widget.Toast
@@ -11,6 +12,10 @@ class PrivilegedMainActivity : MainActivity() {
         super.onCreateOptionsMenu(menu)
         menuInflater.inflate(R.menu.activity_main_privileged, menu)
 
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
+            menu.findItem(R.id.slot_mapping).isVisible = false
+        }
+
         if (tm.supportsDSDS) {
             val dsds = menu.findItem(R.id.dsds)
             dsds.isVisible = true

From 35e543ff708a2ba862c8cce9564b515a7457ae7a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 30 Mar 2024 18:55:14 -0400
Subject: [PATCH 035/458] unpriv: Use "SIM <id>" instead of "Logical Slot <id>"

It does not make sense to refer to logical slot in an unprivileged
context.
---
 app-unpriv/src/main/res/values/strings.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 625136dce..8f1b528c0 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -1,5 +1,6 @@
 <resources>
     <string name="app_name" translatable="false">EasyEUICC</string>
+    <string name="channel_name_format">SIM %d</string>
     <string name="compatibility_check">Compatibility Check</string>
 
     <!-- Compatibility Check Descriptions -->

From 6e590cfd487fd39b681258c85957fea875f28b82 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 3 Apr 2024 20:53:48 -0400
Subject: [PATCH 036/458] OpenEuiccService: stop confusing AOSP with multiple
 eUICCs

Unfortunately, AOSP is not really good at handling more than one eUICC
chips per device, even though the EuiccService interface should
technically allow for such a situation.

Let's do the next best thing -- only ever report one eUICC chip to AOSP.
If the device has an internal one, then only report that one; otherwise,
select the first available eUICC chip to report to the system.

We might make this more configurable in the future, but for now I think
this should work for most of the situations.

Note that this does NOT affect how the rest of OpenEUICC behaves. This
does mean however OpenEUICC will keep hold of some APDU channels that it
will never access via OpenEuiccService. A mitigation is to make
EuiccChannelManager close unused channels automatically after some
timeout.
---
 .../openeuicc/service/OpenEuiccService.kt     | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 65d791802..e635d2186 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -16,6 +16,21 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         const val TAG = "OpenEuiccService"
     }
 
+    private val hasInternalEuicc by lazy {
+        telephonyManager.uiccCardsInfoCompat.any { it.isEuicc && !it.isRemovable }
+    }
+
+    // TODO: Should this be configurable?
+    private fun shouldIgnoreSlot(physicalSlotId: Int) =
+        if (hasInternalEuicc) {
+            // For devices with an internal eUICC slot, ignore any removable UICC
+            telephonyManager.uiccCardsInfoCompat.find { it.physicalSlotIndex == physicalSlotId }!!.isRemovable
+        } else {
+            // Otherwise, we can report at least one removable eUICC to the system without confusing
+            // it too much.
+            telephonyManager.uiccCardsInfoCompat.firstOrNull { it.isEuicc }?.physicalSlotIndex == physicalSlotId
+        }
+
     private fun findChannel(physicalSlotId: Int): EuiccChannel? =
         euiccChannelManager.findEuiccChannelByPhysicalSlotBlocking(physicalSlotId)
 
@@ -111,6 +126,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
 
     override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult {
         Log.i(TAG, "onGetEuiccProfileInfoList slotId=$slotId")
+        if (shouldIgnoreSlot(slotId)) {
+            Log.i(TAG, "ignoring slot $slotId")
+            return GetEuiccProfileInfoListResult(RESULT_FIRST_USER, arrayOf(), true)
+        }
+
         val channel = findChannel(slotId)!!
         val profiles = channel.lpa.profiles.operational.map {
             EuiccProfileInfo.Builder(it.iccid).apply {
@@ -142,6 +162,8 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
 
     override fun onDeleteSubscription(slotId: Int, iccid: String): Int {
         Log.i(TAG, "onDeleteSubscription slotId=$slotId iccid=$iccid")
+        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
+
         try {
             val channels = findAllChannels(slotId) ?: return RESULT_FIRST_USER
 
@@ -187,6 +209,8 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         forceDeactivateSim: Boolean
     ): Int {
         Log.i(TAG,"onSwitchToSubscriptionWithPort slotId=$slotId portIndex=$portIndex iccid=$iccid forceDeactivateSim=$forceDeactivateSim")
+        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
+
         try {
             // retryWithTimeout is needed here because this function may be called just after
             // AOSP has switched slot mappings, in which case the slots may not be ready yet.
@@ -237,6 +261,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
 
     override fun onUpdateSubscriptionNickname(slotId: Int, iccid: String, nickname: String?): Int {
         Log.i(TAG, "onUpdateSubscriptionNickname slotId=$slotId iccid=$iccid nickname=$nickname")
+        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
         val channel = findChannel(slotId) ?: return RESULT_FIRST_USER
         if (!channel.profileExists(iccid)) {
             return RESULT_FIRST_USER

From 8b38a5a58d2b6cb276ad475a3289ca475f9ea0db Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 21 Apr 2024 22:31:03 -0400
Subject: [PATCH 037/458] OpenEuiccService: prevent crashing when AOSP queries
 an unmapped slot

To properly fix this we need to temporarily enable disabled slots when
they are requested by AOSP. For now let's just stop OpenEUICC from
crashing.
---
 .../java/im/angry/openeuicc/service/OpenEuiccService.kt    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index e635d2186..74612980e 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -131,7 +131,12 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             return GetEuiccProfileInfoListResult(RESULT_FIRST_USER, arrayOf(), true)
         }
 
-        val channel = findChannel(slotId)!!
+        // TODO: Temporarily enable the slot to access its profiles if it is currently unmapped
+        val channel = findChannel(slotId) ?: return GetEuiccProfileInfoListResult(
+            RESULT_FIRST_USER,
+            arrayOf(),
+            true
+        )
         val profiles = channel.lpa.profiles.operational.map {
             EuiccProfileInfo.Builder(it.iccid).apply {
                 setProfileName(it.name)

From bf121e07a459783f163966434504afe827ee0009 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 13 Apr 2024 10:51:02 -0400
Subject: [PATCH 038/458] workflows: Correct build reproducibility

- REPRODUCIBLE_BUILD needs to be a string
- Fetch all history to generate versionCode correctly
---
 .forgejo/workflows/build-debug.yml | 1 +
 .forgejo/workflows/release.yml     | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/.forgejo/workflows/build-debug.yml b/.forgejo/workflows/build-debug.yml
index 80b0d8ec3..1dcc692b4 100644
--- a/.forgejo/workflows/build-debug.yml
+++ b/.forgejo/workflows/build-debug.yml
@@ -14,6 +14,7 @@ jobs:
         uses: https://gitea.angry.im/actions/checkout@v3
         with:
           submodules: recursive
+          fetch-depth: 0
 
       - name: Decode Secret Signing Configuration
         uses: https://gitea.angry.im/actions/base64-to-file@v1
diff --git a/.forgejo/workflows/release.yml b/.forgejo/workflows/release.yml
index 529a6d8d4..e89323ae9 100644
--- a/.forgejo/workflows/release.yml
+++ b/.forgejo/workflows/release.yml
@@ -4,7 +4,7 @@ on:
 
 env:
   # Enable reproducibility-related build system workarounds
-  REPRODUCIBLE_BUILD: true
+  REPRODUCIBLE_BUILD: 'true'
 
 jobs:
   release:
@@ -17,6 +17,7 @@ jobs:
         uses: https://gitea.angry.im/actions/checkout@v3
         with:
           submodules: recursive
+          fetch-depth: 0
 
       - name: Decode Secret Signing Configuration
         uses: https://gitea.angry.im/actions/base64-to-file@v1

From 03e63805704d728c29484d401ce0bbf423b243af Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 13 Apr 2024 11:33:00 -0400
Subject: [PATCH 039/458] Ditch REPRODUCIBLE_BUILD flag and set all prefix maps
 unconditionally

---
 .forgejo/workflows/release.yml |  4 ----
 libs/lpac-jni/build.gradle.kts | 11 +++++------
 2 files changed, 5 insertions(+), 10 deletions(-)

diff --git a/.forgejo/workflows/release.yml b/.forgejo/workflows/release.yml
index e89323ae9..650e95b5c 100644
--- a/.forgejo/workflows/release.yml
+++ b/.forgejo/workflows/release.yml
@@ -2,10 +2,6 @@ on:
   push:
     tags: '*'
 
-env:
-  # Enable reproducibility-related build system workarounds
-  REPRODUCIBLE_BUILD: 'true'
-
 jobs:
   release:
     runs-on: [docker, android-app-certs]
diff --git a/libs/lpac-jni/build.gradle.kts b/libs/lpac-jni/build.gradle.kts
index 313bf5bf3..b50a9534b 100644
--- a/libs/lpac-jni/build.gradle.kts
+++ b/libs/lpac-jni/build.gradle.kts
@@ -15,12 +15,11 @@ android {
 
         externalNativeBuild {
             ndkBuild {
-                if (System.getenv("REPRODUCIBLE_BUILD") != "true") {
-                    arguments("-j4")
-                } else {
-                    arguments("-j1")
-                    cFlags("-fmacro-prefix-map=${project.projectDir.toString()}=/fake/path/")
-                }
+                cFlags(
+                    "-fmacro-prefix-map=${project.projectDir.toString()}=/fake/path/",
+                    "-fdebug-prefix-map=${project.projectDir.toString()}=/fake/path/",
+                    "-ffile-prefix-map=${project.projectDir.toString()}=/fake/path/"
+                )
             }
         }
     }

From 1f6bad422274c48ec9ddcf7eaff905557244f95b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 13 Apr 2024 15:05:34 -0400
Subject: [PATCH 040/458] app-unpriv: Set ndkVersion as well for stripping

Otherwise, the stripping step always fails in CI builds. This breaks
reproducibility as debug info contains path to NDK.
---
 app-unpriv/build.gradle.kts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-unpriv/build.gradle.kts b/app-unpriv/build.gradle.kts
index b6648084d..f1aa79d54 100644
--- a/app-unpriv/build.gradle.kts
+++ b/app-unpriv/build.gradle.kts
@@ -18,6 +18,7 @@ apply {
 android {
     namespace = "im.angry.easyeuicc"
     compileSdk = 34
+    ndkVersion = "26.1.10909125"
 
     defaultConfig {
         applicationId = "im.angry.easyeuicc"

From 0f655f1f1fd4a722a52e5445f1fdffed1ed9744f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 13 Apr 2024 15:15:20 -0400
Subject: [PATCH 041/458] workflows: Save debug symbols for releases

---
 .forgejo/workflows/release.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.forgejo/workflows/release.yml b/.forgejo/workflows/release.yml
index 650e95b5c..f35393d14 100644
--- a/.forgejo/workflows/release.yml
+++ b/.forgejo/workflows/release.yml
@@ -34,6 +34,9 @@ jobs:
       - name: Build Release APK (Unprivileged / EasyEUICC only)
         run: ./gradlew --no-daemon :app-unpriv:assembleRelease
 
+      - name: Copy Debug Symbols to Release Path
+        run: cp app-unpriv/build/outputs/native-debug-symbols/jmpRelease/native-debug-symbols.zip app-unpriv/build/outputs/apk/jmp/release/
+
       - name: Create Release
         uses: https://gitea.angry.im/actions/forgejo-release@v1
         with:

From 59f359787412058d6c0d3e82e46eabadc03f0a78 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 4 May 2024 17:29:10 -0400
Subject: [PATCH 042/458] refactor: Wrap EuiccChannelManager in an Android
 Service instance

This allows MUCH better lifecycle control over EuiccChannelManager. We
no longer have to keep all opened APDU channels open until the
application is destroyed. Instead, they can be closed as long as no
component is bound to this Service instance.

A catch is that other long-running services must bind to this service
as-needed, otherwise a binding is going to keep the service always
alive. This only affects the EuiccService implementation, and a
suspending/blocking helper function is added to deal with this case.
---
 app-common/src/main/AndroidManifest.xml       |  4 +
 .../core/DefaultEuiccChannelManagerFactory.kt | 10 ++
 .../core/EuiccChannelManagerFactory.kt        |  7 ++
 .../im/angry/openeuicc/di/AppContainer.kt     |  2 +
 .../angry/openeuicc/di/DefaultAppContainer.kt |  6 ++
 .../service/EuiccChannelManagerService.kt     | 41 +++++++++
 .../openeuicc/ui/BaseEuiccAccessActivity.kt   | 48 ++++++++++
 .../ui/DirectProfileDownloadActivity.kt       |  7 +-
 .../im/angry/openeuicc/ui/MainActivity.kt     | 14 +--
 .../openeuicc/ui/NotificationsActivity.kt     |  5 +-
 .../angry/openeuicc/ui/SlotSelectFragment.kt  |  3 +-
 .../util/EuiccChannelFragmentUtils.kt         |  5 +-
 .../java/im/angry/openeuicc/util/Utils.kt     |  6 +-
 .../core/PrivilegedEuiccChannelManager.kt     |  5 +-
 .../PrivilegedEuiccChannelManagerFactory.kt   | 10 ++
 .../openeuicc/di/PrivilegedAppContainer.kt    |  6 ++
 .../openeuicc/service/OpenEuiccService.kt     | 92 ++++++++++++++-----
 .../angry/openeuicc/ui/SlotMappingFragment.kt |  7 +-
 .../angry/openeuicc/util/PrivilegedUtils.kt   | 27 ++++++
 19 files changed, 256 insertions(+), 49 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManagerFactory.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManagerFactory.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
 create mode 100644 app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManagerFactory.kt
 create mode 100644 app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index be37bf4be..816329904 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -28,5 +28,9 @@
             android:name="com.journeyapps.barcodescanner.CaptureActivity"
             android:screenOrientation="fullSensor"
             tools:replace="screenOrientation" />
+
+        <service
+            android:name="im.angry.openeuicc.service.EuiccChannelManagerService"
+            android:exported="false" />
     </application>
 </manifest>
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManagerFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManagerFactory.kt
new file mode 100644
index 000000000..556a5434b
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManagerFactory.kt
@@ -0,0 +1,10 @@
+package im.angry.openeuicc.core
+
+import android.app.Service
+import im.angry.openeuicc.di.AppContainer
+
+class DefaultEuiccChannelManagerFactory(private val appContainer: AppContainer) :
+    EuiccChannelManagerFactory {
+    override fun createEuiccChannelManager(serviceContext: Service) =
+        DefaultEuiccChannelManager(appContainer, serviceContext)
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManagerFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManagerFactory.kt
new file mode 100644
index 000000000..d39e6deba
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManagerFactory.kt
@@ -0,0 +1,7 @@
+package im.angry.openeuicc.core
+
+import android.app.Service
+
+interface EuiccChannelManagerFactory {
+    fun createEuiccChannelManager(serviceContext: Service): EuiccChannelManager
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
index 6ad6e0dee..4b3c3cdac 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -4,11 +4,13 @@ import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
 import im.angry.openeuicc.core.EuiccChannelFactory
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManagerFactory
 import im.angry.openeuicc.util.*
 
 interface AppContainer {
     val telephonyManager: TelephonyManager
     val euiccChannelManager: EuiccChannelManager
+    val euiccChannelManagerFactory: EuiccChannelManagerFactory
     val subscriptionManager: SubscriptionManager
     val preferenceRepository: PreferenceRepository
     val uiComponentFactory: UiComponentFactory
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
index 7a1a3fe90..93fd8b858 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -5,7 +5,9 @@ import android.telephony.SubscriptionManager
 import android.telephony.TelephonyManager
 import im.angry.openeuicc.core.DefaultEuiccChannelFactory
 import im.angry.openeuicc.core.DefaultEuiccChannelManager
+import im.angry.openeuicc.core.DefaultEuiccChannelManagerFactory
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManagerFactory
 import im.angry.openeuicc.util.*
 
 open class DefaultAppContainer(context: Context) : AppContainer {
@@ -17,6 +19,10 @@ open class DefaultAppContainer(context: Context) : AppContainer {
         DefaultEuiccChannelManager(this, context)
     }
 
+    override val euiccChannelManagerFactory: EuiccChannelManagerFactory by lazy {
+        DefaultEuiccChannelManagerFactory(this)
+    }
+
     override val subscriptionManager by lazy {
         context.getSystemService(SubscriptionManager::class.java)!!
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
new file mode 100644
index 000000000..75c58dbc9
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -0,0 +1,41 @@
+package im.angry.openeuicc.service
+
+import android.app.Service
+import android.content.Intent
+import android.os.Binder
+import android.os.IBinder
+import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.util.*
+
+/**
+ * An Android Service wrapper for EuiccChannelManager.
+ * The purpose of this wrapper is mainly lifecycle-wise: having a Service allows the manager
+ * instance to have its own independent lifecycle. This way it can be created as requested and
+ * destroyed when no other components are bound to this service anymore.
+ * This behavior allows us to avoid keeping the APDU channels open at all times. For example,
+ * the EuiccService implementation should *only* bind to this service when it requires an
+ * instance of EuiccChannelManager. UI components can keep being bound to this service for
+ * their entire lifecycles, since the whole purpose of them is to expose the current state
+ * to the user.
+ */
+class EuiccChannelManagerService : Service(), OpenEuiccContextMarker {
+    inner class LocalBinder : Binder() {
+        val service = this@EuiccChannelManagerService
+    }
+
+    private val euiccChannelManagerDelegate = lazy {
+        appContainer.euiccChannelManagerFactory.createEuiccChannelManager(this)
+    }
+    val euiccChannelManager: EuiccChannelManager by euiccChannelManagerDelegate
+
+    override fun onBind(intent: Intent?): IBinder = LocalBinder()
+
+    override fun onDestroy() {
+        super.onDestroy()
+        // This is the whole reason of the existence of this service:
+        // we can clean up opened channels when no one is using them
+        if (euiccChannelManagerDelegate.isInitialized()) {
+            euiccChannelManager.invalidate()
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
new file mode 100644
index 000000000..d760c7670
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
@@ -0,0 +1,48 @@
+package im.angry.openeuicc.ui
+
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.content.ServiceConnection
+import android.os.Bundle
+import android.os.IBinder
+import androidx.appcompat.app.AppCompatActivity
+import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.service.EuiccChannelManagerService
+
+abstract class BaseEuiccAccessActivity : AppCompatActivity() {
+    lateinit var euiccChannelManager: EuiccChannelManager
+
+    private val euiccChannelManagerServiceConnection = object : ServiceConnection {
+        override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
+            euiccChannelManager =
+                (service!! as EuiccChannelManagerService.LocalBinder).service.euiccChannelManager
+            onInit()
+        }
+
+        override fun onServiceDisconnected(name: ComponentName?) {
+            // These activities should never lose the EuiccChannelManagerService connection
+            finish()
+        }
+    }
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        bindService(
+            Intent(this, EuiccChannelManagerService::class.java),
+            euiccChannelManagerServiceConnection,
+            Context.BIND_AUTO_CREATE
+        )
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        unbindService(euiccChannelManagerServiceConnection)
+    }
+
+    /**
+     * When called, euiccChannelManager is guaranteed to have been initialized
+     */
+    abstract fun onInit()
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
index 5414a6737..dbdbe9d1d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
@@ -1,16 +1,13 @@
 package im.angry.openeuicc.ui
 
-import android.os.Bundle
-import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
-class DirectProfileDownloadActivity : AppCompatActivity(), SlotSelectFragment.SlotSelectedListener, OpenEuiccContextMarker {
-    override fun onCreate(savedInstanceState: Bundle?) {
-        super.onCreate(savedInstanceState)
+class DirectProfileDownloadActivity : BaseEuiccAccessActivity(), SlotSelectFragment.SlotSelectedListener, OpenEuiccContextMarker {
+    override fun onInit() {
         lifecycleScope.launch {
             withContext(Dispatchers.IO) {
                 euiccChannelManager.enumerateEuiccChannels()
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 2d80e3316..ab89babe9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -10,16 +10,14 @@ import android.view.View
 import android.widget.AdapterView
 import android.widget.ArrayAdapter
 import android.widget.Spinner
-import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
-open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
+open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         const val TAG = "MainActivity"
     }
@@ -45,10 +43,6 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
         tm = telephonyManager
 
         spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
-
-        lifecycleScope.launch {
-            init()
-        }
     }
 
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
@@ -94,6 +88,12 @@ open class MainActivity : AppCompatActivity(), OpenEuiccContextMarker {
             else -> super.onOptionsItemSelected(item)
         }
 
+    override fun onInit() {
+        lifecycleScope.launch {
+            init()
+        }
+    }
+
     private suspend fun init() {
         withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels()
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 925ed84b5..744a87ddb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -12,7 +12,6 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
 import androidx.appcompat.app.AlertDialog
-import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.forEach
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
@@ -27,7 +26,7 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileNotification
 
-class NotificationsActivity: AppCompatActivity(), OpenEuiccContextMarker {
+class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var notificationList: RecyclerView
     private val notificationAdapter = NotificationAdapter()
@@ -39,7 +38,9 @@ class NotificationsActivity: AppCompatActivity(), OpenEuiccContextMarker {
         setContentView(R.layout.activity_notifications)
         setSupportActionBar(requireViewById(R.id.toolbar))
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
+    }
 
+    override fun onInit() {
         euiccChannel = euiccChannelManager
             .findEuiccChannelBySlotBlocking(intent.getIntExtra("logicalSlotId", 0))!!
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
index 6288b0dfb..8fb36d9d2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
@@ -29,7 +29,8 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
     private lateinit var toolbar: Toolbar
     private lateinit var spinner: Spinner
     private val channels: List<EuiccChannel> by lazy {
-        euiccChannelManager.knownChannels.sortedBy { it.logicalSlotId }
+        (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
+            .knownChannels.sortedBy { it.logicalSlotId }
     }
 
     override fun onCreateView(
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index feee0cddf..efe232665 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -4,9 +4,10 @@ import android.os.Bundle
 import android.util.Log
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
-import net.typeblog.lpac_jni.LocalProfileAssistant
 
 private const val TAG = "EuiccChannelFragmentUtils"
 
@@ -30,6 +31,8 @@ val <T> T.slotId: Int where T: Fragment, T: EuiccChannelFragmentMarker
 val <T> T.portId: Int where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("portId")
 
+val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: EuiccChannelFragmentMarker
+    get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
 val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 175e85fad..6a43d0073 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -7,7 +7,6 @@ import android.telephony.TelephonyManager
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.di.AppContainer
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
@@ -15,7 +14,7 @@ import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileInfo
-import java.lang.RuntimeException
+import kotlin.RuntimeException
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException
 import kotlin.coroutines.suspendCoroutine
@@ -52,9 +51,6 @@ interface OpenEuiccContextMarker {
     val appContainer: AppContainer
         get() = openEuiccApplication.appContainer
 
-    val euiccChannelManager: EuiccChannelManager
-        get() = appContainer.euiccChannelManager
-
     val telephonyManager: TelephonyManager
         get() = appContainer.telephonyManager
 }
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index 1c5d13240..923bbab85 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -5,7 +5,10 @@ import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import java.lang.Exception
 
-class PrivilegedEuiccChannelManager(appContainer: AppContainer, context: Context) :
+class PrivilegedEuiccChannelManager(
+    appContainer: AppContainer,
+    context: Context
+) :
     DefaultEuiccChannelManager(appContainer, context) {
     override val uiccCards: Collection<UiccCardInfoCompat>
         get() = tm.uiccCardsInfoCompat
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManagerFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManagerFactory.kt
new file mode 100644
index 000000000..77dc5cd4a
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManagerFactory.kt
@@ -0,0 +1,10 @@
+package im.angry.openeuicc.core
+
+import android.app.Service
+import im.angry.openeuicc.di.AppContainer
+
+class PrivilegedEuiccChannelManagerFactory(private val appContainer: AppContainer) :
+    EuiccChannelManagerFactory {
+    override fun createEuiccChannelManager(serviceContext: Service): EuiccChannelManager =
+        PrivilegedEuiccChannelManager(appContainer, serviceContext)
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index 515835278..c5896f272 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -2,14 +2,20 @@ package im.angry.openeuicc.di
 
 import android.content.Context
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.core.EuiccChannelManagerFactory
 import im.angry.openeuicc.core.PrivilegedEuiccChannelFactory
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
+import im.angry.openeuicc.core.PrivilegedEuiccChannelManagerFactory
 
 class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val euiccChannelManager: EuiccChannelManager by lazy {
         PrivilegedEuiccChannelManager(this, context)
     }
 
+    override val euiccChannelManagerFactory: EuiccChannelManagerFactory by lazy {
+        PrivilegedEuiccChannelManagerFactory(this)
+    }
+
     override val uiComponentFactory by lazy {
         PrivilegedUiComponentFactory()
     }
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 74612980e..1aa9fc831 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -1,5 +1,7 @@
 package im.angry.openeuicc.service
 
+import android.content.Context
+import android.content.Intent
 import android.os.Build
 import android.service.euicc.*
 import android.telephony.UiccSlotMapping
@@ -8,7 +10,9 @@ import android.telephony.euicc.EuiccInfo
 import android.util.Log
 import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.runBlocking
 import java.lang.IllegalStateException
 
 class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
@@ -31,17 +35,51 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             telephonyManager.uiccCardsInfoCompat.firstOrNull { it.isEuicc }?.physicalSlotIndex == physicalSlotId
         }
 
-    private fun findChannel(physicalSlotId: Int): EuiccChannel? =
-        euiccChannelManager.findEuiccChannelByPhysicalSlotBlocking(physicalSlotId)
+    private data class EuiccChannelManagerContext(
+        val euiccChannelManager: EuiccChannelManager
+    ) {
+        fun findChannel(physicalSlotId: Int): EuiccChannel? =
+            euiccChannelManager.findEuiccChannelByPhysicalSlotBlocking(physicalSlotId)
 
-    private fun findChannel(slotId: Int, portId: Int): EuiccChannel? =
-        euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)
+        fun findChannel(slotId: Int, portId: Int): EuiccChannel? =
+            euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)
 
-    private fun findAllChannels(physicalSlotId: Int): List<EuiccChannel>? =
-        euiccChannelManager.findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId)
+        fun findAllChannels(physicalSlotId: Int): List<EuiccChannel>? =
+            euiccChannelManager.findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId)
+    }
 
-    override fun onGetEid(slotId: Int): String? =
+    /**
+     * Bind to EuiccChannelManagerService, run the callback with a EuiccChannelManager instance,
+     * and then unbind after the callback is finished. All methods in this class that require access
+     * to a EuiccChannelManager should be wrapped inside this call.
+     *
+     * This ensures that we only spawn and connect to APDU channels when we absolutely need to,
+     * instead of keeping them open unnecessarily in the background at all times.
+     */
+    private inline fun <T> withEuiccChannelManager(fn: EuiccChannelManagerContext.() -> T): T {
+        val (binder, unbind) = runBlocking {
+            bindServiceSuspended(
+                Intent(
+                    this@OpenEuiccService,
+                    EuiccChannelManagerService::class.java
+                ), Context.BIND_AUTO_CREATE
+            )
+        }
+
+        if (binder == null) {
+            throw RuntimeException("Unable to bind to EuiccChannelManagerService; aborting")
+        }
+
+        val ret =
+            EuiccChannelManagerContext((binder as EuiccChannelManagerService.LocalBinder).service.euiccChannelManager).fn()
+
+        unbind()
+        return ret
+    }
+
+    override fun onGetEid(slotId: Int): String? = withEuiccChannelManager {
         findChannel(slotId)?.lpa?.eID
+    }
 
     // When two eSIM cards are present on one device, the Android settings UI
     // gets confused and sets the incorrect slotId for profiles from one of
@@ -124,7 +162,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         return GetDefaultDownloadableSubscriptionListResult(RESULT_OK, arrayOf())
     }
 
-    override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult {
+    override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult = withEuiccChannelManager {
         Log.i(TAG, "onGetEuiccProfileInfoList slotId=$slotId")
         if (shouldIgnoreSlot(slotId)) {
             Log.i(TAG, "ignoring slot $slotId")
@@ -165,7 +203,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         return EuiccInfo("Unknown") // TODO: Can we actually implement this?
     }
 
-    override fun onDeleteSubscription(slotId: Int, iccid: String): Int {
+    override fun onDeleteSubscription(slotId: Int, iccid: String): Int = withEuiccChannelManager {
         Log.i(TAG, "onDeleteSubscription slotId=$slotId iccid=$iccid")
         if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
 
@@ -212,7 +250,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         portIndex: Int,
         iccid: String?,
         forceDeactivateSim: Boolean
-    ): Int {
+    ): Int = withEuiccChannelManager {
         Log.i(TAG,"onSwitchToSubscriptionWithPort slotId=$slotId portIndex=$portIndex iccid=$iccid forceDeactivateSim=$forceDeactivateSim")
         if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
 
@@ -264,22 +302,26 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         }
     }
 
-    override fun onUpdateSubscriptionNickname(slotId: Int, iccid: String, nickname: String?): Int {
-        Log.i(TAG, "onUpdateSubscriptionNickname slotId=$slotId iccid=$iccid nickname=$nickname")
-        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
-        val channel = findChannel(slotId) ?: return RESULT_FIRST_USER
-        if (!channel.profileExists(iccid)) {
-            return RESULT_FIRST_USER
+    override fun onUpdateSubscriptionNickname(slotId: Int, iccid: String, nickname: String?): Int =
+        withEuiccChannelManager {
+            Log.i(
+                TAG,
+                "onUpdateSubscriptionNickname slotId=$slotId iccid=$iccid nickname=$nickname"
+            )
+            if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
+            val channel = findChannel(slotId) ?: return RESULT_FIRST_USER
+            if (!channel.profileExists(iccid)) {
+                return RESULT_FIRST_USER
+            }
+            val success = channel.lpa
+                .setNickname(iccid, nickname!!)
+            appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
+            return if (success) {
+                RESULT_OK
+            } else {
+                RESULT_FIRST_USER
+            }
         }
-        val success = channel.lpa
-            .setNickname(iccid, nickname!!)
-        appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
-        return if (success) {
-            RESULT_OK
-        } else {
-            RESULT_FIRST_USER
-        }
-    }
 
     @Deprecated("Deprecated in Java")
     override fun onEraseSubscriptions(slotId: Int): Int {
diff --git a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
index 1514fe94f..e17f60e73 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/SlotMappingFragment.kt
@@ -96,14 +96,17 @@ class SlotMappingFragment: BaseMaterialDialogFragment(),
                 withContext(Dispatchers.IO) {
                     // Use the utility method from PrivilegedTelephonyUtils to ensure
                     // unmapped ports have all profiles disabled
-                    telephonyManager.updateSimSlotMapping(euiccChannelManager, adapter.mappings)
+                    telephonyManager.updateSimSlotMapping(
+                        (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager,
+                        adapter.mappings
+                    )
                 }
             } catch (e: Exception) {
                 Toast.makeText(requireContext(), R.string.slot_mapping_failure, Toast.LENGTH_LONG).show()
                 return@launch
             }
             Toast.makeText(requireContext(), R.string.slot_mapping_completed, Toast.LENGTH_LONG).show()
-            euiccChannelManager.invalidate()
+            (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager.invalidate()
             requireActivity().finish()
         }
     }
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
new file mode 100644
index 000000000..e295f2694
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
@@ -0,0 +1,27 @@
+package im.angry.openeuicc.util
+
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.content.ServiceConnection
+import android.os.IBinder
+import java.util.concurrent.Executors
+import kotlin.coroutines.resume
+import kotlin.coroutines.suspendCoroutine
+
+suspend fun Context.bindServiceSuspended(intent: Intent, flags: Int): Pair<IBinder?, () -> Unit> =
+    suspendCoroutine { cont ->
+        var binder: IBinder?
+        val conn = object : ServiceConnection {
+            override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
+                binder = service
+                cont.resume(Pair(binder) { unbindService(this) })
+            }
+
+            override fun onServiceDisconnected(name: ComponentName?) {
+
+            }
+        }
+
+        bindService(intent, flags, Executors.newSingleThreadExecutor(), conn)
+    }
\ No newline at end of file

From 043dff0f0a4e5f0378fb4b449af39f5cdfe72676 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 4 May 2024 22:02:11 -0400
Subject: [PATCH 043/458] lpac: bump upstream

---
 libs/lpac-jni/src/main/jni/lpac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index 0bb196977..d85537a90 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit 0bb196977e7f2e276a1076734897ad8c48d9d5ca
+Subproject commit d85537a90922901638ca86c28ac6d5a0d494807c

From 5785fe2e7c5ec9916ac661ec7704fad66b5659b5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 7 May 2024 10:06:08 -0400
Subject: [PATCH 044/458] EuiccChannelManager: Check for channel validity
 before returning

Related to #26. Sometimes we could open a channel but it somehow ends up
being invalid, for example for a slot that's not actually an eUICC
(???). This should be a bug somewhere else, but we should nevertheless
prevent OpenEUICC from crashing.
---
 .../openeuicc/core/DefaultEuiccChannelManager.kt   | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 811c56ca3..eb19c36b1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -54,8 +54,18 @@ open class DefaultEuiccChannelManager(
                 return null
             }
 
-            return euiccChannelFactory.tryOpenEuiccChannel(port)?.also {
-                channels.add(it)
+            val channel = euiccChannelFactory.tryOpenEuiccChannel(port) ?: return null
+
+            if (channel.valid) {
+                channels.add(channel)
+                return channel
+            } else {
+                Log.i(
+                    TAG,
+                    "Was able to open channel for logical slot ${port.logicalSlotIndex}, but the channel is invalid (cannot get eID or profiles without errors). This slot might be broken, aborting."
+                )
+                channel.close()
+                return null
             }
         }
     }

From 1a22854d05d567be453fa2aadb839769fceaa9b7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 9 May 2024 16:08:00 -0400
Subject: [PATCH 045/458] refactor: Remove all usage of knownChannels

enumerateEuiccChannels() should return all discovered channels on its
own. Outside classes should never access the cached open channels
directly.
---
 .../core/DefaultEuiccChannelManager.kt        | 28 ++++++-------
 .../openeuicc/core/EuiccChannelManager.kt     | 20 ++++++---
 .../ui/DirectProfileDownloadActivity.kt       | 12 +++---
 .../im/angry/openeuicc/ui/MainActivity.kt     |  7 ++--
 .../angry/openeuicc/ui/SlotSelectFragment.kt  | 41 +++++++++++++------
 .../util/PrivilegedTelephonyUtils.kt          |  4 +-
 6 files changed, 66 insertions(+), 46 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index eb19c36b1..1d6627db6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -21,7 +21,7 @@ open class DefaultEuiccChannelManager(
         const val TAG = "EuiccChannelManager"
     }
 
-    private val channels = mutableListOf<EuiccChannel>()
+    private val channelCache = mutableListOf<EuiccChannel>()
 
     private val lock = Mutex()
 
@@ -39,13 +39,13 @@ open class DefaultEuiccChannelManager(
     private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
         lock.withLock {
             val existing =
-                channels.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
+                channelCache.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
             if (existing != null) {
                 if (existing.valid && port.logicalSlotIndex == existing.logicalSlotId) {
                     return existing
                 } else {
                     existing.close()
-                    channels.remove(existing)
+                    channelCache.remove(existing)
                 }
             }
 
@@ -57,7 +57,7 @@ open class DefaultEuiccChannelManager(
             val channel = euiccChannelFactory.tryOpenEuiccChannel(port) ?: return null
 
             if (channel.valid) {
-                channels.add(channel)
+                channelCache.add(channel)
                 return channel
             } else {
                 Log.i(
@@ -128,7 +128,7 @@ open class DefaultEuiccChannelManager(
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
         // If there is already a valid channel, we close it proactively
         // Sometimes the current channel can linger on for a bit even after it should have become invalid
-        channels.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
+        channelCache.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
             if (valid) close()
         }
 
@@ -148,30 +148,26 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    override suspend fun enumerateEuiccChannels() {
+    override suspend fun enumerateEuiccChannels(): List<EuiccChannel> =
         withContext(Dispatchers.IO) {
-            for (uiccInfo in uiccCards) {
-                for (port in uiccInfo.ports) {
-                    if (tryOpenEuiccChannel(port) != null) {
+            uiccCards.flatMap { info ->
+                info.ports.mapNotNull { port ->
+                    tryOpenEuiccChannel(port)?.also {
                         Log.d(
                             TAG,
-                            "Found eUICC on slot ${uiccInfo.physicalSlotIndex} port ${port.portIndex}"
+                            "Found eUICC on slot ${info.physicalSlotIndex} port ${port.portIndex}"
                         )
                     }
                 }
             }
         }
-    }
-
-    override val knownChannels: List<EuiccChannel>
-        get() = channels.toList()
 
     override fun invalidate() {
-        for (channel in channels) {
+        for (channel in channelCache) {
             channel.close()
         }
 
-        channels.clear()
+        channelCache.clear()
         euiccChannelFactory.cleanup()
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 9ec303012..5171779bb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -1,12 +1,22 @@
 package im.angry.openeuicc.core
 
+/**
+ * EuiccChannelManager holds references to, and manages the lifecycles of, individual
+ * APDU channels to SIM cards. The find* methods will create channels when needed, and
+ * all opened channels will be held in an internal cache until invalidate() is called
+ * or when this instance is destroyed.
+ *
+ * To precisely control the lifecycle of this object itself (and thus its cached channels),
+ * all other compoents must access EuiccChannelManager objects through EuiccChannelManagerService.
+ * Holding references independent of EuiccChannelManagerService is unsupported.
+ */
 interface EuiccChannelManager {
-    val knownChannels: List<EuiccChannel>
-
     /**
-     * Scan all possible sources for EuiccChannels and have them cached for future use
+     * Scan all possible sources for EuiccChannels, return them and have all
+     * scanned channels cached; these channels will remain open for the entire lifetime of
+     * this EuiccChannelManager object, unless disconnected externally or invalidate()'d
      */
-    suspend fun enumerateEuiccChannels()
+    suspend fun enumerateEuiccChannels(): List<EuiccChannel>
 
     /**
      * Wait for a slot + port to reconnect (i.e. become valid again)
@@ -41,7 +51,7 @@ interface EuiccChannelManager {
     fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
 
     /**
-     * Invalidate all EuiccChannels previously known by this Manager
+     * Invalidate all EuiccChannels previously cached by this Manager
      */
     fun invalidate()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
index dbdbe9d1d..9e79de6ae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
@@ -9,23 +9,23 @@ import kotlinx.coroutines.withContext
 class DirectProfileDownloadActivity : BaseEuiccAccessActivity(), SlotSelectFragment.SlotSelectedListener, OpenEuiccContextMarker {
     override fun onInit() {
         lifecycleScope.launch {
-            withContext(Dispatchers.IO) {
+            val knownChannels = withContext(Dispatchers.IO) {
                 euiccChannelManager.enumerateEuiccChannels()
             }
 
             when {
-                euiccChannelManager.knownChannels.isEmpty() -> {
+                knownChannels.isEmpty() -> {
                     finish()
                 }
-                euiccChannelManager.knownChannels.hasMultipleChips -> {
-                    SlotSelectFragment.newInstance()
+                knownChannels.hasMultipleChips -> {
+                    SlotSelectFragment.newInstance(knownChannels.sortedBy { it.logicalSlotId })
                         .show(supportFragmentManager, SlotSelectFragment.TAG)
                 }
                 else -> {
                     // If the device has only one eSIM "chip" (but may be mapped to multiple slots),
                     // we can skip the slot selection dialog since there is only one chip to save to.
-                    onSlotSelected(euiccChannelManager.knownChannels[0].slotId,
-                        euiccChannelManager.knownChannels[0].portId)
+                    onSlotSelected(knownChannels[0].slotId,
+                        knownChannels[0].portId)
                 }
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index ab89babe9..9befe57f0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -95,9 +95,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private suspend fun init() {
-        withContext(Dispatchers.IO) {
-            euiccChannelManager.enumerateEuiccChannels()
-            euiccChannelManager.knownChannels.forEach {
+        val knownChannels = withContext(Dispatchers.IO) {
+            euiccChannelManager.enumerateEuiccChannels().onEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
                 Log.d(TAG, it.lpa.eID)
                 // Request the system to refresh the list of profiles every time we start
@@ -108,7 +107,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
 
         withContext(Dispatchers.Main) {
-            euiccChannelManager.knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
+            knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
                 fragments.add(appContainer.uiComponentFactory.createEuiccManagementFragment(channel))
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
index 8fb36d9d2..d1239c41d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
@@ -16,8 +16,14 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
     companion object {
         const val TAG = "SlotSelectFragment"
 
-        fun newInstance(): SlotSelectFragment {
-            return SlotSelectFragment()
+        fun newInstance(knownChannels: List<EuiccChannel>): SlotSelectFragment {
+            return SlotSelectFragment().apply {
+                arguments = Bundle().apply {
+                    putIntArray("slotIds", knownChannels.map { it.slotId }.toIntArray())
+                    putIntArray("logicalSlotIds", knownChannels.map { it.logicalSlotId }.toIntArray())
+                    putIntArray("portIds", knownChannels.map { it.portId }.toIntArray())
+                }
+            }
         }
     }
 
@@ -28,10 +34,10 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
 
     private lateinit var toolbar: Toolbar
     private lateinit var spinner: Spinner
-    private val channels: List<EuiccChannel> by lazy {
-        (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
-            .knownChannels.sortedBy { it.logicalSlotId }
-    }
+    private lateinit var adapter: ArrayAdapter<String>
+    private lateinit var slotIds: IntArray
+    private lateinit var logicalSlotIds: IntArray
+    private lateinit var portIds: IntArray
 
     override fun onCreateView(
         inflater: LayoutInflater,
@@ -44,26 +50,35 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
         toolbar.setTitle(R.string.slot_select)
         toolbar.inflateMenu(R.menu.fragment_slot_select)
 
-        val adapter = ArrayAdapter<String>(inflater.context, R.layout.spinner_item)
+        adapter = ArrayAdapter<String>(inflater.context, R.layout.spinner_item)
 
         spinner = view.requireViewById(R.id.spinner)
         spinner.adapter = adapter
 
-        channels.forEach { channel ->
-            adapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
+        return view
+    }
+
+    override fun onStart() {
+        super.onStart()
+
+        slotIds = requireArguments().getIntArray("slotIds")!!
+        logicalSlotIds = requireArguments().getIntArray("logicalSlotIds")!!
+        portIds = requireArguments().getIntArray("portIds")!!
+
+        logicalSlotIds.forEach { id ->
+            adapter.add(getString(R.string.channel_name_format, id))
         }
 
         toolbar.setNavigationOnClickListener {
             (requireActivity() as SlotSelectedListener).onSlotSelectCancelled()
         }
         toolbar.setOnMenuItemClickListener {
-            val channel = channels[spinner.selectedItemPosition]
-            (requireActivity() as SlotSelectedListener).onSlotSelected(channel.slotId, channel.portId)
+            val slotId = slotIds[spinner.selectedItemPosition]
+            val portId = portIds[spinner.selectedItemPosition]
+            (requireActivity() as SlotSelectedListener).onSlotSelected(slotId, portId)
             dismiss()
             true
         }
-
-        return view
     }
 
     override fun onResume() {
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 4675ab9c9..6a13c50e3 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -15,12 +15,12 @@ val TelephonyManager.dsdsEnabled: Boolean
     get() = activeModemCount >= 2
 
 fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled: Boolean) {
-    runBlocking {
+    val knownChannels = runBlocking {
         euiccManager.enumerateEuiccChannels()
     }
 
     // Disable all eSIM profiles before performing a DSDS switch (only for internal eSIMs)
-    euiccManager.knownChannels.forEach {
+    knownChannels.forEach {
         if (!it.removable) {
             it.lpa.disableActiveProfileWithUndo()
         }

From 8eb36c77a826477faca8ce8a470113b437a74492 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 20 May 2024 10:10:55 -0400
Subject: [PATCH 046/458] workflows: Fix path

This is not JMP SIM Manager :)
---
 .forgejo/workflows/release.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.forgejo/workflows/release.yml b/.forgejo/workflows/release.yml
index f35393d14..c8a72837c 100644
--- a/.forgejo/workflows/release.yml
+++ b/.forgejo/workflows/release.yml
@@ -35,7 +35,7 @@ jobs:
         run: ./gradlew --no-daemon :app-unpriv:assembleRelease
 
       - name: Copy Debug Symbols to Release Path
-        run: cp app-unpriv/build/outputs/native-debug-symbols/jmpRelease/native-debug-symbols.zip app-unpriv/build/outputs/apk/jmp/release/
+        run: cp app-unpriv/build/outputs/native-debug-symbols/release/native-debug-symbols.zip app-unpriv/build/outputs/apk/release/
 
       - name: Create Release
         uses: https://gitea.angry.im/actions/forgejo-release@v1

From fc4e5739de11979226f4b80a0f79acbf9953c5c9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 20 May 2024 18:09:00 -0400
Subject: [PATCH 047/458] feat: Scan QR code from gallery

Close #6.
---
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 39 +++++++++++++++++--
 .../java/im/angry/openeuicc/util/Utils.kt     | 16 ++++++++
 .../main/res/drawable/ic_gallery_black.xml    |  5 +++
 .../res/menu/fragment_profile_download.xml    |  6 +++
 app-common/src/main/res/values/strings.xml    |  1 +
 5 files changed, 63 insertions(+), 4 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_gallery_black.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index feb0ab068..98237dc01 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.ui
 import android.annotation.SuppressLint
 import android.app.Dialog
 import android.content.DialogInterface
+import android.graphics.BitmapFactory
 import android.os.Bundle
 import android.text.Editable
 import android.util.Log
@@ -10,6 +11,7 @@ import android.view.*
 import android.widget.ProgressBar
 import android.widget.TextView
 import android.widget.Toast
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.widget.Toolbar
 import androidx.lifecycle.lifecycleScope
 import com.google.android.material.textfield.TextInputLayout
@@ -54,13 +56,38 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
     private val barcodeScannerLauncher = registerForActivityResult(ScanContract()) { result ->
         result.contents?.let { content ->
             Log.d(TAG, content)
-            val components = content.split("$")
-            if (components.size < 3 || components[0] != "LPA:1") return@registerForActivityResult
-            profileDownloadServer.editText?.setText(components[1])
-            profileDownloadCode.editText?.setText(components[2])
+            onScanResult(content)
         }
     }
 
+    private val gallerySelectorLauncher = registerForActivityResult(ActivityResultContracts.GetContent()) { result ->
+        if (result == null) return@registerForActivityResult
+
+        lifecycleScope.launch(Dispatchers.IO) {
+            runCatching {
+                requireContext().contentResolver.openInputStream(result)?.let { input ->
+                    val bmp = BitmapFactory.decodeStream(input)
+                    input.close()
+
+                    decodeQrFromBitmap(bmp)?.let {
+                        withContext(Dispatchers.Main) {
+                            onScanResult(it)
+                        }
+                    }
+
+                    bmp.recycle()
+                }
+            }
+        }
+    }
+
+    private fun onScanResult(result: String) {
+        val components = result.split("$")
+        if (components.size < 3 || components[0] != "LPA:1") return
+        profileDownloadServer.editText?.setText(components[1])
+        profileDownloadCode.editText?.setText(components[2])
+    }
+
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
@@ -103,6 +130,10 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 })
                 true
             }
+            R.id.scan_from_gallery -> {
+                gallerySelectorLauncher.launch("image/*")
+                true
+            }
             R.id.ok -> {
                 startDownloadProfile()
                 true
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 6a43d0073..a93e7d271 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -2,9 +2,14 @@ package im.angry.openeuicc.util
 
 import android.content.Context
 import android.content.pm.PackageManager
+import android.graphics.Bitmap
 import android.se.omapi.SEService
 import android.telephony.TelephonyManager
 import androidx.fragment.app.Fragment
+import com.google.zxing.BinaryBitmap
+import com.google.zxing.RGBLuminanceSource
+import com.google.zxing.common.HybridBinarizer
+import com.google.zxing.qrcode.QRCodeReader
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.di.AppContainer
@@ -88,3 +93,14 @@ suspend fun connectSEService(context: Context): SEService = suspendCoroutine { c
         }
     }
 }
+
+fun decodeQrFromBitmap(bmp: Bitmap): String? =
+     runCatching {
+        val pixels = IntArray(bmp.width * bmp.height)
+        bmp.getPixels(pixels, 0, bmp.width, 0, 0, bmp.width, bmp.height)
+
+        val luminanceSource = RGBLuminanceSource(bmp.width, bmp.height, pixels)
+        val binaryBmp = BinaryBitmap(HybridBinarizer(luminanceSource))
+
+        QRCodeReader().decode(binaryBmp).text
+    }.getOrNull()
diff --git a/app-common/src/main/res/drawable/ic_gallery_black.xml b/app-common/src/main/res/drawable/ic_gallery_black.xml
new file mode 100644
index 000000000..048f74a9d
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_gallery_black.xml
@@ -0,0 +1,5 @@
+<vector android:height="24dp" android:tint="?attr/colorControlNormal"
+    android:viewportHeight="24" android:viewportWidth="24"
+    android:width="24dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@android:color/white" android:pathData="M22,16L22,4c0,-1.1 -0.9,-2 -2,-2L8,2c-1.1,0 -2,0.9 -2,2v12c0,1.1 0.9,2 2,2h12c1.1,0 2,-0.9 2,-2zM11,12l2.03,2.71L16,11l4,5L8,16l3,-4zM2,6v14c0,1.1 0.9,2 2,2h14v-2L4,20L4,6L2,6z"/>
+</vector>
diff --git a/app-common/src/main/res/menu/fragment_profile_download.xml b/app-common/src/main/res/menu/fragment_profile_download.xml
index d89c52ca3..b75822a1b 100644
--- a/app-common/src/main/res/menu/fragment_profile_download.xml
+++ b/app-common/src/main/res/menu/fragment_profile_download.xml
@@ -7,6 +7,12 @@
         android:title="@string/profile_download_scan"
         app:showAsAction="ifRoom"/>
 
+    <item
+        android:id="@+id/scan_from_gallery"
+        android:icon="@drawable/ic_gallery_black"
+        android:title="@string/profile_download_scan_from_gallery"
+        app:showAsAction="ifRoom" />
+
     <item
         android:id="@+id/ok"
         android:icon="@drawable/ic_check_black"
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index ac6b9d4e7..a2424e553 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -31,6 +31,7 @@
     <string name="profile_download_imei">IMEI (Optional)</string>
     <string name="profile_download_free_space">Space remaining: %s</string>
     <string name="profile_download_scan">Scan QR Code</string>
+    <string name="profile_download_scan_from_gallery">Scan QR Code from Gallery</string>
     <string name="profile_download_ok">Download</string>
     <string name="profile_download_failed">Failed to download eSIM. Check your activation / QR code.</string>
 

From 3869374140f6054aee3b7637485d1e4438f4ac5d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 20 May 2024 18:09:49 -0400
Subject: [PATCH 048/458] ProfileDownloadFragment: make OK always appear as
 action

---
 app-common/src/main/res/menu/fragment_profile_download.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/menu/fragment_profile_download.xml b/app-common/src/main/res/menu/fragment_profile_download.xml
index b75822a1b..f93ae8d83 100644
--- a/app-common/src/main/res/menu/fragment_profile_download.xml
+++ b/app-common/src/main/res/menu/fragment_profile_download.xml
@@ -17,5 +17,5 @@
         android:id="@+id/ok"
         android:icon="@drawable/ic_check_black"
         android:title="@string/profile_download_ok"
-        app:showAsAction="ifRoom"/>
+        app:showAsAction="always"/>
 </menu>
\ No newline at end of file

From 2d312f2216a8a6d60815dba925ff6900320d9a82 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 2 Jun 2024 17:44:10 -0400
Subject: [PATCH 049/458] lpac-jni: Avoid reloading profiles from card every
 time

Some cards may run at a low baud rate which causes issues
---
 .../impl/LocalProfileAssistantImpl.kt         | 32 +++++++++++++------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index a76ba753c..c0f81fb6b 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -20,6 +20,7 @@ class LocalProfileAssistantImpl(
 
     private var finalized = false
     private var contextHandle: Long = LpacJni.createContext(apduInterface, httpInterface)
+
     init {
         if (LpacJni.euiccInit(contextHandle) < 0) {
             throw IllegalArgumentException("Failed to initialize LPA")
@@ -40,8 +41,11 @@ class LocalProfileAssistantImpl(
             false
         }
 
+    private var _profiles: List<LocalProfileInfo>? = null
     override val profiles: List<LocalProfileInfo>
-        get() = LpacJni.es10cGetProfilesInfo(contextHandle)!!.asList()
+        get() = (_profiles ?: LpacJni.es10cGetProfilesInfo(contextHandle)!!.asList()).also {
+            _profiles = it
+        }
 
     override val notifications: List<LocalProfileNotification>
         get() =
@@ -55,19 +59,26 @@ class LocalProfileAssistantImpl(
         get() = LpacJni.es10cexGetEuiccInfo2(contextHandle)
 
     override fun enableProfile(iccid: String): Boolean =
-        LpacJni.es10cEnableProfile(contextHandle, iccid) == 0
+        (LpacJni.es10cEnableProfile(contextHandle, iccid) == 0).also {
+            _profiles = null
+        }
 
     override fun disableProfile(iccid: String): Boolean =
-        LpacJni.es10cDisableProfile(contextHandle, iccid) == 0
+        (LpacJni.es10cDisableProfile(contextHandle, iccid) == 0).also {
+            _profiles = null
+        }
 
-    override fun deleteProfile(iccid: String): Boolean {
-        return LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
-    }
+    override fun deleteProfile(iccid: String): Boolean =
+        (LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0).also {
+            _profiles = null
+        }
 
     @Synchronized
     override fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
                                  confirmationCode: String?, callback: ProfileDownloadCallback): Boolean {
-        return LpacJni.downloadProfile(contextHandle, smdp, matchingId, imei, confirmationCode, callback) == 0
+        return (LpacJni.downloadProfile(contextHandle, smdp, matchingId, imei, confirmationCode, callback) == 0).also {
+            _profiles = null
+        }
     }
 
     override fun deleteNotification(seqNumber: Long): Boolean =
@@ -79,9 +90,10 @@ class LocalProfileAssistantImpl(
             Log.d(TAG, "handleNotification $seqNumber = $it")
         } == 0
 
-    override fun setNickname(iccid: String, nickname: String): Boolean {
-        return LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
-    }
+    override fun setNickname(iccid: String, nickname: String): Boolean =
+        (LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0).also {
+            _profiles = null
+        }
 
     @Synchronized
     override fun close() {

From 5498186cf1f363dfbb189ce9cd5a92fcd5ede9f3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 2 Jun 2024 20:12:28 -0400
Subject: [PATCH 050/458] ui: Stop refreshing profiles on every UI event

---
 .../main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index c1e5ba6d0..e4c667f3d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -77,10 +77,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             ProfileDownloadFragment.newInstance(slotId, portId)
                 .show(childFragmentManager, ProfileDownloadFragment.TAG)
         }
-    }
 
-    override fun onStart() {
-        super.onStart()
         refresh()
     }
 

From 051bb9f1e385aabbff8064a700451343543f1705 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 2 Jun 2024 20:24:31 -0400
Subject: [PATCH 051/458] ui: Fix download errors, again

Also improve comments so I don't keep forgetting what I did
---
 .../im/angry/openeuicc/ui/ProfileDownloadFragment.kt   | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 98237dc01..bb406e246 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -225,7 +225,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         confirmationCode: String?,
         imei: String?
     ) = beginTrackedOperation {
-        channel.lpa.downloadProfile(
+        val res = channel.lpa.downloadProfile(
             server,
             code,
             imei,
@@ -239,8 +239,14 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 }
             })
 
+        if (!res) {
+            // TODO: Provide more details on the error
+            throw RuntimeException("Failed to download profile; this is typically caused by another error happened before.")
+        }
+
         // If we get here, we are successful
-        // Only send notifications if the user allowed us to
+        // This function is wrapped in beginTrackedOperation, so by returning the settings value,
+        // We only send notifications if the user allowed us to
         preferenceRepository.notificationDownloadFlow.first()
     }
 

From 1536343b3f8bfe0018dbcd422928cb8c77db85f4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 4 Jun 2024 22:05:29 -0400
Subject: [PATCH 052/458] fix: Add connection timeouts for notification
 handling

...and do not fail operations if notification handling fails --
notifications are best-effort.
---
 .../openeuicc/util/EuiccChannelFragmentUtils.kt   | 15 ++++++++++-----
 .../typeblog/lpac_jni/impl/HttpInterfaceImpl.kt   |  1 +
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index efe232665..aff41541d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -48,11 +48,16 @@ suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T : Fra
         Log.d(TAG, "Latest notification is $latestSeq before operation")
         if (op()) {
             Log.d(TAG, "Operation has requested notification handling")
-            // Note that the exact instance of "channel" might have changed here if reconnected;
-            // so we MUST use the automatic getter for "channel"
-            channel.lpa.notifications.filter { it.seqNumber > latestSeq }.forEach {
-                Log.d(TAG, "Handling notification $it")
-                channel.lpa.handleNotification(it.seqNumber)
+            try {
+                // Note that the exact instance of "channel" might have changed here if reconnected;
+                // so we MUST use the automatic getter for "channel"
+                channel.lpa.notifications.filter { it.seqNumber > latestSeq }.forEach {
+                    Log.d(TAG, "Handling notification $it")
+                    channel.lpa.handleNotification(it.seqNumber)
+                }
+            } catch (e: Exception) {
+                // Ignore any error during notification handling
+                e.printStackTrace()
             }
         }
         Log.d(TAG, "Operation complete")
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index bfad50c2a..356ccb28b 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -33,6 +33,7 @@ class HttpInterfaceImpl: HttpInterface {
             sslContext.init(null, trustManagers, SecureRandom())
 
             val conn = parsedUrl.openConnection() as HttpsURLConnection
+            conn.connectTimeout = 2000
             conn.sslSocketFactory = sslContext.socketFactory
             conn.requestMethod = "POST"
             conn.doInput = true

From 01e1b2b9a468fb164054921fe12d6daaa5c2c6bf Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 13 Jun 2024 20:24:42 -0400
Subject: [PATCH 053/458] fix: Show toasts from main thread

---
 .../im/angry/openeuicc/ui/EuiccManagementFragment.kt     | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index e4c667f3d..96c094981 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -137,8 +137,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
                 if (!res) {
                     Log.d(TAG, "Failed to enable / disable profile $iccid")
-                    Toast.makeText(context, R.string.toast_profile_enable_failed, Toast.LENGTH_LONG)
-                        .show()
+                    withContext(Dispatchers.Main) {
+                        Toast.makeText(
+                            context,
+                            R.string.toast_profile_enable_failed,
+                            Toast.LENGTH_LONG
+                        ).show()
+                    }
                     return@beginTrackedOperation false
                 }
 

From 20cdb99a7b52f4c6ebc674f106fdeba4e56928e8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 17:09:19 -0400
Subject: [PATCH 054/458] lpac-jni: Expose refresh flag to Kotlin

---
 .../java/net/typeblog/lpac_jni/LocalProfileAssistant.kt   | 4 ++--
 .../src/main/java/net/typeblog/lpac_jni/LpacJni.kt        | 4 ++--
 .../typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt   | 8 ++++----
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c            | 8 ++++----
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 16a91e778..89df38d9a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -10,8 +10,8 @@ interface LocalProfileAssistant {
 
     // All blocking functions in this class assume that they are executed on non-Main threads
     // The IO context in Kotlin's coroutine library is recommended.
-    fun enableProfile(iccid: String): Boolean
-    fun disableProfile(iccid: String): Boolean
+    fun enableProfile(iccid: String, refresh: Boolean = false): Boolean
+    fun disableProfile(iccid: String, refresh: Boolean = false): Boolean
     fun deleteProfile(iccid: String): Boolean
 
     fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 836332ed3..5a706b9a3 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -15,8 +15,8 @@ internal object LpacJni {
     // null returns signify errors
     external fun es10cGetEid(handle: Long): String?
     external fun es10cGetProfilesInfo(handle: Long): Array<LocalProfileInfo>?
-    external fun es10cEnableProfile(handle: Long, iccid: String): Int
-    external fun es10cDisableProfile(handle: Long, iccid: String): Int
+    external fun es10cEnableProfile(handle: Long, iccid: String, refresh: Boolean): Int
+    external fun es10cDisableProfile(handle: Long, iccid: String, refresh: Boolean): Int
     external fun es10cDeleteProfile(handle: Long, iccid: String): Int
     external fun es10cSetNickname(handle: Long, iccid: String, nick: String): Int
 
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index c0f81fb6b..b5e4b5c60 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -58,13 +58,13 @@ class LocalProfileAssistantImpl(
     override val euiccInfo2: EuiccInfo2?
         get() = LpacJni.es10cexGetEuiccInfo2(contextHandle)
 
-    override fun enableProfile(iccid: String): Boolean =
-        (LpacJni.es10cEnableProfile(contextHandle, iccid) == 0).also {
+    override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
+        (LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0).also {
             _profiles = null
         }
 
-    override fun disableProfile(iccid: String): Boolean =
-        (LpacJni.es10cDisableProfile(contextHandle, iccid) == 0).also {
+    override fun disableProfile(iccid: String, refresh: Boolean): Boolean =
+        (LpacJni.es10cDisableProfile(contextHandle, iccid, refresh) == 0).also {
             _profiles = null
         }
 
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 503f81633..6ba8ebf7e 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -242,26 +242,26 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cGetProfilesInfo(JNIEnv *env, jobject th
 
 JNIEXPORT jint JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10cEnableProfile(JNIEnv *env, jobject thiz, jlong handle,
-                                                       jstring iccid) {
+                                                       jstring iccid, jboolean refresh) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     const char *_iccid = NULL;
     int ret;
 
     _iccid = (*env)->GetStringUTFChars(env, iccid, NULL);
-    ret = es10c_enable_profile(ctx, _iccid, 1);
+    ret = es10c_enable_profile(ctx, _iccid, refresh ? 1 : 0);
     (*env)->ReleaseStringUTFChars(env, iccid, _iccid);
     return ret;
 }
 
 JNIEXPORT jint JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10cDisableProfile(JNIEnv *env, jobject thiz, jlong handle,
-                                                        jstring iccid) {
+                                                        jstring iccid, jboolean refresh) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     const char *_iccid = NULL;
     int ret;
 
     _iccid = (*env)->GetStringUTFChars(env, iccid, NULL);
-    ret = es10c_disable_profile(ctx, _iccid, 1);
+    ret = es10c_disable_profile(ctx, _iccid, refresh ? 1 : 0);
     (*env)->ReleaseStringUTFChars(env, iccid, _iccid);
     return ret;
 }

From ff427759d780971e53c19395ce8d0e5a78aa83c5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 17:27:00 -0400
Subject: [PATCH 055/458] fix: Try to disable the current profile before
 switching

---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 96c094981..999bafeab 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -130,6 +130,12 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         lifecycleScope.launch {
             beginTrackedOperation {
                 val res = if (enable) {
+                    channel.lpa.profiles.find { it.isEnabled }?.let {
+                        Log.i(TAG, "Profile ${it.iccid} is enabled; disabling before switching to new profile")
+                        // Don't refresh -- we'll refresh later when enabling.
+                        // Also ignore errors -- this is only a hard error if the enabling step fails.
+                        channel.lpa.disableProfile(it.iccid, false)
+                    }
                     channel.lpa.enableProfile(iccid)
                 } else {
                     channel.lpa.disableProfile(iccid)

From 2b3f042e39e88782b6ed42062108311572b01e5a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 17:42:21 -0400
Subject: [PATCH 056/458] Move some functions to LPAUtils

---
 .../src/main/java/im/angry/openeuicc/util/LPAUtils.kt     | 8 ++++++++
 app-common/src/main/java/im/angry/openeuicc/util/Utils.kt | 8 --------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index e5c2f5219..ee44028d2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -1,16 +1,24 @@
 package im.angry.openeuicc.util
 
+import im.angry.openeuicc.core.EuiccChannel
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 
 val LocalProfileInfo.displayName: String
     get() = nickName.ifEmpty { name }
 
+
+val LocalProfileInfo.isEnabled: Boolean
+    get() = state == LocalProfileInfo.State.Enabled
+
 val List<LocalProfileInfo>.operational: List<LocalProfileInfo>
     get() = filter {
         it.profileClass == LocalProfileInfo.Clazz.Operational
     }
 
+val List<EuiccChannel>.hasMultipleChips: Boolean
+    get() = distinctBy { it.slotId }.size > 1
+
 fun LocalProfileAssistant.disableActiveProfileWithUndo(): () -> Unit =
     profiles.find { it.state == LocalProfileInfo.State.Enabled }?.let {
         disableProfile(it.iccid)
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index a93e7d271..444c17692 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -11,14 +11,12 @@ import com.google.zxing.RGBLuminanceSource
 import com.google.zxing.common.HybridBinarizer
 import com.google.zxing.qrcode.QRCodeReader
 import im.angry.openeuicc.OpenEuiccApplication
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.di.AppContainer
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
-import net.typeblog.lpac_jni.LocalProfileInfo
 import kotlin.RuntimeException
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException
@@ -60,12 +58,6 @@ interface OpenEuiccContextMarker {
         get() = appContainer.telephonyManager
 }
 
-val LocalProfileInfo.isEnabled: Boolean
-    get() = state == LocalProfileInfo.State.Enabled
-
-val List<EuiccChannel>.hasMultipleChips: Boolean
-    get() = distinctBy { it.slotId }.size > 1
-
 // Create an instance of OMAPI SEService in a manner that "makes sense" without unpredictable callbacks
 suspend fun connectSEService(context: Context): SEService = suspendCoroutine { cont ->
     // Use a Mutex to make sure the continuation is run *after* the "service" variable is assigned

From 0e86a922d158547aeb69c4cc3f292425cee8b973 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 17:45:30 -0400
Subject: [PATCH 057/458] fix: do not refresh eUICC when switching port mapping

This is entirely unnecessary and only causes problems
---
 .../main/java/im/angry/openeuicc/util/LPAUtils.kt    | 12 +++++++++---
 .../angry/openeuicc/util/PrivilegedTelephonyUtils.kt |  4 ++--
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index ee44028d2..f799f03bb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -19,8 +19,14 @@ val List<LocalProfileInfo>.operational: List<LocalProfileInfo>
 val List<EuiccChannel>.hasMultipleChips: Boolean
     get() = distinctBy { it.slotId }.size > 1
 
-fun LocalProfileAssistant.disableActiveProfileWithUndo(): () -> Unit =
-    profiles.find { it.state == LocalProfileInfo.State.Enabled }?.let {
-        disableProfile(it.iccid)
+/**
+ * Disable the active profile, return a lambda that reverts this action when called.
+ * If refreshOnDisable is true, also cause a eUICC refresh command. Note that refreshing
+ * will disconnect the eUICC and might need some time before being operational again.
+ * See EuiccManager.waitForReconnect()
+ */
+fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean): () -> Unit =
+    profiles.find { it.isEnabled }?.let {
+        disableProfile(it.iccid, refreshOnDisable)
         return { enableProfile(it.iccid) }
     } ?: { }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 6a13c50e3..3c30bce2d 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -22,7 +22,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled:
     // Disable all eSIM profiles before performing a DSDS switch (only for internal eSIMs)
     knownChannels.forEach {
         if (!it.removable) {
-            it.lpa.disableActiveProfileWithUndo()
+            it.lpa.disableActiveProfileWithUndo(false)
         }
     }
 
@@ -45,7 +45,7 @@ fun TelephonyManager.updateSimSlotMapping(
     val undo = unmapped.mapNotNull { mapping ->
         euiccManager.findEuiccChannelByPortBlocking(mapping.physicalSlotIndex, mapping.portIndex)?.let { channel ->
             if (!channel.removable) {
-                return@mapNotNull channel.lpa.disableActiveProfileWithUndo()
+                return@mapNotNull channel.lpa.disableActiveProfileWithUndo(false)
             } else {
                 // Do not do anything for external eUICCs -- we can't really trust them to work properly
                 // with no profile enabled.

From df9cece94b6aa91c085b906a7361134bba745c27 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 17:53:26 -0400
Subject: [PATCH 058/458] refactor: Commonize logic for disabling the active
 profile

---
 .../im/angry/openeuicc/ui/EuiccManagementFragment.kt  |  9 +++------
 .../src/main/java/im/angry/openeuicc/util/LPAUtils.kt | 11 +++++++++++
 .../im/angry/openeuicc/service/OpenEuiccService.kt    |  6 +++---
 3 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 999bafeab..954cb0fc8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -130,12 +130,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         lifecycleScope.launch {
             beginTrackedOperation {
                 val res = if (enable) {
-                    channel.lpa.profiles.find { it.isEnabled }?.let {
-                        Log.i(TAG, "Profile ${it.iccid} is enabled; disabling before switching to new profile")
-                        // Don't refresh -- we'll refresh later when enabling.
-                        // Also ignore errors -- this is only a hard error if the enabling step fails.
-                        channel.lpa.disableProfile(it.iccid, false)
-                    }
+                    // Disable any active profile first, but don't do a refresh and ignore
+                    // any errors -- we only error if the enabling action fails
+                    channel.lpa.disableActiveProfile(false)
                     channel.lpa.enableProfile(iccid)
                 } else {
                     channel.lpa.disableProfile(iccid)
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index f799f03bb..556320f53 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.util
 
+import android.util.Log
 import im.angry.openeuicc.core.EuiccChannel
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
@@ -19,6 +20,16 @@ val List<LocalProfileInfo>.operational: List<LocalProfileInfo>
 val List<EuiccChannel>.hasMultipleChips: Boolean
     get() = distinctBy { it.slotId }.size > 1
 
+/**
+ * Disable the current active profile if any. If refresh is true, also cause a refresh command.
+ * See EuiccManager.waitForReconnect()
+ */
+fun LocalProfileAssistant.disableActiveProfile(refresh: Boolean): Boolean =
+    profiles.find { it.isEnabled }?.let {
+        Log.i("LPAUtils", "Disabling active profile ${it.iccid}")
+        disableProfile(it.iccid, refresh)
+    } ?: true
+
 /**
  * Disable the active profile, return a lambda that reverts this action when called.
  * If refreshOnDisable is true, also cause a eUICC refresh command. Note that refreshing
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 1aa9fc831..74d2d753a 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -284,9 +284,9 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             }
 
             // Disable any active profile first if present
-            channel.lpa.profiles.find {
-                it.state == LocalProfileInfo.State.Enabled
-            }?.let { if (!channel.lpa.disableProfile(it.iccid)) return RESULT_FIRST_USER }
+            if (!channel.lpa.disableActiveProfile(false)) {
+                return RESULT_FIRST_USER
+            }
 
             if (iccid != null) {
                 if (!channel.lpa.enableProfile(iccid)) {

From f73af48b5908ebc7197e7cb2b16b53f1bf8307fe Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 20:25:25 -0400
Subject: [PATCH 059/458] refactor: beginTrackedOperation should be a LPA
 extension

---
 .../util/EuiccChannelFragmentUtils.kt         | 36 +++----------------
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 34 ++++++++++++++++--
 2 files changed, 36 insertions(+), 34 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index aff41541d..582f86c02 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -1,15 +1,10 @@
 package im.angry.openeuicc.util
 
 import android.os.Bundle
-import android.util.Log
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.withContext
-
-private const val TAG = "EuiccChannelFragmentUtils"
 
 interface EuiccChannelFragmentMarker: OpenEuiccContextMarker
 
@@ -37,32 +32,9 @@ val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
 
-/*
- * Begin a "tracked" operation where notifications may be generated by the eSIM
- * Automatically handle any newly generated notification during the operation
- * if the function "op" returns true.
- */
-suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T : Fragment, T : EuiccChannelFragmentMarker =
-    withContext(Dispatchers.IO) {
-        val latestSeq = channel.lpa.notifications.firstOrNull()?.seqNumber ?: 0
-        Log.d(TAG, "Latest notification is $latestSeq before operation")
-        if (op()) {
-            Log.d(TAG, "Operation has requested notification handling")
-            try {
-                // Note that the exact instance of "channel" might have changed here if reconnected;
-                // so we MUST use the automatic getter for "channel"
-                channel.lpa.notifications.filter { it.seqNumber > latestSeq }.forEach {
-                    Log.d(TAG, "Handling notification $it")
-                    channel.lpa.handleNotification(it.seqNumber)
-                }
-            } catch (e: Exception) {
-                // Ignore any error during notification handling
-                e.printStackTrace()
-            }
-        }
-        Log.d(TAG, "Operation complete")
-    }
-
 interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()
-}
\ No newline at end of file
+}
+
+suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T: Fragment, T: EuiccChannelFragmentMarker =
+    channel.lpa.beginTrackedOperation(op)
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 556320f53..1f68c4687 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -2,9 +2,13 @@ package im.angry.openeuicc.util
 
 import android.util.Log
 import im.angry.openeuicc.core.EuiccChannel
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 
+private const val TAG = "LPAUtils"
+
 val LocalProfileInfo.displayName: String
     get() = nickName.ifEmpty { name }
 
@@ -26,7 +30,7 @@ val List<EuiccChannel>.hasMultipleChips: Boolean
  */
 fun LocalProfileAssistant.disableActiveProfile(refresh: Boolean): Boolean =
     profiles.find { it.isEnabled }?.let {
-        Log.i("LPAUtils", "Disabling active profile ${it.iccid}")
+        Log.i(TAG, "Disabling active profile ${it.iccid}")
         disableProfile(it.iccid, refresh)
     } ?: true
 
@@ -40,4 +44,30 @@ fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean
     profiles.find { it.isEnabled }?.let {
         disableProfile(it.iccid, refreshOnDisable)
         return { enableProfile(it.iccid) }
-    } ?: { }
\ No newline at end of file
+    } ?: { }
+
+/**
+ * Begin a "tracked" operation where notifications may be generated by the eSIM
+ * Automatically handle any newly generated notification during the operation
+ * if the function "op" returns true.
+ */
+suspend fun LocalProfileAssistant.beginTrackedOperation(op: suspend () -> Boolean) =
+    withContext(Dispatchers.IO) {
+        val latestSeq = notifications.firstOrNull()?.seqNumber ?: 0
+        Log.d(TAG, "Latest notification is $latestSeq before operation")
+        if (op()) {
+            Log.d(TAG, "Operation has requested notification handling")
+            try {
+                // Note that the exact instance of "channel" might have changed here if reconnected;
+                // so we MUST use the automatic getter for "channel"
+                notifications.filter { it.seqNumber > latestSeq }.forEach {
+                    Log.d(TAG, "Handling notification $it")
+                    handleNotification(it.seqNumber)
+                }
+            } catch (e: Exception) {
+                // Ignore any error during notification handling
+                e.printStackTrace()
+            }
+        }
+        Log.d(TAG, "Operation complete")
+    }
\ No newline at end of file

From 261ad6dbeb0617cf325761de4dd7e9ddb9b3afb8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 20:53:25 -0400
Subject: [PATCH 060/458] OpenEuiccService: track LPA actions for notifications

---
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 39 +++++++++++--------
 .../openeuicc/service/OpenEuiccService.kt     | 36 +++++++++++------
 2 files changed, 47 insertions(+), 28 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 1f68c4687..5d0c6ce3d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -3,11 +3,12 @@ package im.angry.openeuicc.util
 import android.util.Log
 import im.angry.openeuicc.core.EuiccChannel
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 
-private const val TAG = "LPAUtils"
+const val TAG = "LPAUtils"
 
 val LocalProfileInfo.displayName: String
     get() = nickName.ifEmpty { name }
@@ -53,21 +54,25 @@ fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean
  */
 suspend fun LocalProfileAssistant.beginTrackedOperation(op: suspend () -> Boolean) =
     withContext(Dispatchers.IO) {
-        val latestSeq = notifications.firstOrNull()?.seqNumber ?: 0
-        Log.d(TAG, "Latest notification is $latestSeq before operation")
-        if (op()) {
-            Log.d(TAG, "Operation has requested notification handling")
-            try {
-                // Note that the exact instance of "channel" might have changed here if reconnected;
-                // so we MUST use the automatic getter for "channel"
-                notifications.filter { it.seqNumber > latestSeq }.forEach {
-                    Log.d(TAG, "Handling notification $it")
-                    handleNotification(it.seqNumber)
-                }
-            } catch (e: Exception) {
-                // Ignore any error during notification handling
-                e.printStackTrace()
+        beginTrackedOperationBlocking { op() }
+    }
+
+inline fun LocalProfileAssistant.beginTrackedOperationBlocking(op: () -> Boolean) {
+    val latestSeq = notifications.firstOrNull()?.seqNumber ?: 0
+    Log.d(TAG, "Latest notification is $latestSeq before operation")
+    if (op()) {
+        Log.d(TAG, "Operation has requested notification handling")
+        try {
+            // Note that the exact instance of "channel" might have changed here if reconnected;
+            // so we MUST use the automatic getter for "channel"
+            notifications.filter { it.seqNumber > latestSeq }.forEach {
+                Log.d(TAG, "Handling notification $it")
+                handleNotification(it.seqNumber)
             }
+        } catch (e: Exception) {
+            // Ignore any error during notification handling
+            e.printStackTrace()
         }
-        Log.d(TAG, "Operation complete")
-    }
\ No newline at end of file
+    }
+    Log.d(TAG, "Operation complete")
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 74d2d753a..dd7bc5927 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -12,6 +12,8 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.single
 import kotlinx.coroutines.runBlocking
 import java.lang.IllegalStateException
 
@@ -226,11 +228,17 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 }
             }
 
-            return if (channels[0].lpa.deleteProfile(iccid)) {
-                RESULT_OK
-            } else {
-                RESULT_FIRST_USER
+            channels[0].lpa.beginTrackedOperationBlocking {
+                if (channels[0].lpa.deleteProfile(iccid)) {
+                    return RESULT_OK
+                }
+
+                runBlocking {
+                    preferenceRepository.notificationDeleteFlow.first()
+                }
             }
+
+            return RESULT_FIRST_USER
         } catch (e: Exception) {
             return RESULT_FIRST_USER
         }
@@ -283,14 +291,20 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 return RESULT_FIRST_USER
             }
 
-            // Disable any active profile first if present
-            if (!channel.lpa.disableActiveProfile(false)) {
-                return RESULT_FIRST_USER
-            }
+            channel.lpa.beginTrackedOperationBlocking {
+                if (iccid != null) {
+                    // Disable any active profile first if present
+                    channel.lpa.disableActiveProfile(false)
+                    if (!channel.lpa.enableProfile(iccid)) {
+                        return RESULT_FIRST_USER
+                    }
+                } else {
+                    channel.lpa.disableActiveProfile(true)
+                }
 
-            if (iccid != null) {
-                if (!channel.lpa.enableProfile(iccid)) {
-                    return RESULT_FIRST_USER
+                runBlocking {
+                    // TODO: The enable / disable operations should really be one
+                    preferenceRepository.notificationEnableFlow.first()
                 }
             }
 

From 790a5cf778ed88f8920f1c23330ad238bccf2863 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Jun 2024 20:58:07 -0400
Subject: [PATCH 061/458] OpenEuiccService: handle errors in disabling active
 profiles

---
 .../main/java/im/angry/openeuicc/service/OpenEuiccService.kt  | 4 +++-
 .../main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt  | 4 ++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index dd7bc5927..4b46164ea 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -299,7 +299,9 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                         return RESULT_FIRST_USER
                     }
                 } else {
-                    channel.lpa.disableActiveProfile(true)
+                    if (!channel.lpa.disableActiveProfile(true)) {
+                        return RESULT_FIRST_USER
+                    }
                 }
 
                 runBlocking {
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 89df38d9a..7e0a31bf8 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -10,8 +10,8 @@ interface LocalProfileAssistant {
 
     // All blocking functions in this class assume that they are executed on non-Main threads
     // The IO context in Kotlin's coroutine library is recommended.
-    fun enableProfile(iccid: String, refresh: Boolean = false): Boolean
-    fun disableProfile(iccid: String, refresh: Boolean = false): Boolean
+    fun enableProfile(iccid: String, refresh: Boolean = true): Boolean
+    fun disableProfile(iccid: String, refresh: Boolean = true): Boolean
     fun deleteProfile(iccid: String): Boolean
 
     fun downloadProfile(smdp: String, matchingId: String?, imei: String?,

From c8d2269efb7d3d037f70e4c0140ee368fa2ad128 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 23 Jun 2024 21:40:14 -0400
Subject: [PATCH 062/458] fix: beginTrackedOperation() should work with
 channels that get invalidated

---
 .../util/EuiccChannelFragmentUtils.kt         | 11 ++++--
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 35 ++++++++++++++-----
 .../openeuicc/service/OpenEuiccService.kt     |  4 +--
 3 files changed, 37 insertions(+), 13 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 582f86c02..8b2aadbbe 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -5,6 +5,8 @@ import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
 
 interface EuiccChannelFragmentMarker: OpenEuiccContextMarker
 
@@ -36,5 +38,10 @@ interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()
 }
 
-suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T: Fragment, T: EuiccChannelFragmentMarker =
-    channel.lpa.beginTrackedOperation(op)
\ No newline at end of file
+suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T: Fragment, T: EuiccChannelFragmentMarker {
+    withContext(Dispatchers.IO) {
+        euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+            op()
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 5d0c6ce3d..860abc95e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -2,6 +2,7 @@ package im.angry.openeuicc.util
 
 import android.util.Log
 import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.withContext
@@ -51,23 +52,39 @@ fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean
  * Begin a "tracked" operation where notifications may be generated by the eSIM
  * Automatically handle any newly generated notification during the operation
  * if the function "op" returns true.
+ *
+ * This requires the EuiccChannelManager object and a slotId / portId instead of
+ * just an LPA object, because a LPA might become invalid during an operation
+ * that generates notifications. As such, we will end up having to reconnect
+ * when this happens.
+ *
+ * Note that however, if reconnect is required and will not be instant, waiting
+ * should be the concern of op() itself, and this function assumes that when
+ * op() returns, the slotId and portId will correspond to a valid channel again.
  */
-suspend fun LocalProfileAssistant.beginTrackedOperation(op: suspend () -> Boolean) =
-    withContext(Dispatchers.IO) {
-        beginTrackedOperationBlocking { op() }
-    }
-
-inline fun LocalProfileAssistant.beginTrackedOperationBlocking(op: () -> Boolean) {
-    val latestSeq = notifications.firstOrNull()?.seqNumber ?: 0
+inline fun EuiccChannelManager.beginTrackedOperationBlocking(
+    slotId: Int,
+    portId: Int,
+    op: () -> Boolean
+) {
+    val latestSeq =
+        findEuiccChannelByPortBlocking(slotId, portId)!!.lpa.notifications.firstOrNull()?.seqNumber
+            ?: 0
     Log.d(TAG, "Latest notification is $latestSeq before operation")
     if (op()) {
         Log.d(TAG, "Operation has requested notification handling")
         try {
             // Note that the exact instance of "channel" might have changed here if reconnected;
             // so we MUST use the automatic getter for "channel"
-            notifications.filter { it.seqNumber > latestSeq }.forEach {
+            findEuiccChannelByPortBlocking(
+                slotId,
+                portId
+            )?.lpa?.notifications?.filter { it.seqNumber > latestSeq }?.forEach {
                 Log.d(TAG, "Handling notification $it")
-                handleNotification(it.seqNumber)
+                findEuiccChannelByPortBlocking(
+                    slotId,
+                    portId
+                )?.lpa?.handleNotification(it.seqNumber)
             }
         } catch (e: Exception) {
             // Ignore any error during notification handling
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 4b46164ea..219bcaf31 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -228,7 +228,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 }
             }
 
-            channels[0].lpa.beginTrackedOperationBlocking {
+            euiccChannelManager.beginTrackedOperationBlocking(channels[0].slotId, channels[0].portId) {
                 if (channels[0].lpa.deleteProfile(iccid)) {
                     return RESULT_OK
                 }
@@ -291,7 +291,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 return RESULT_FIRST_USER
             }
 
-            channel.lpa.beginTrackedOperationBlocking {
+            euiccChannelManager.beginTrackedOperationBlocking(channel.slotId, channel.portId) {
                 if (iccid != null) {
                     // Disable any active profile first if present
                     channel.lpa.disableActiveProfile(false)

From 113cc1b4cfe9d6aa715e9e91d6646061abe7a572 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 24 Jun 2024 20:59:18 -0400
Subject: [PATCH 063/458] revert back to calling enableProfile directly

Disabling without refreshing causes issues on eSTK.me
---
 .../main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 954cb0fc8..96c094981 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -130,9 +130,6 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         lifecycleScope.launch {
             beginTrackedOperation {
                 val res = if (enable) {
-                    // Disable any active profile first, but don't do a refresh and ignore
-                    // any errors -- we only error if the enabling action fails
-                    channel.lpa.disableActiveProfile(false)
                     channel.lpa.enableProfile(iccid)
                 } else {
                     channel.lpa.disableProfile(iccid)

From 4914a35c3dbe7114fc095ca23dc6b997697f54f5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 24 Jun 2024 21:02:13 -0400
Subject: [PATCH 064/458] fix: EuiccService should ignore negative slot IDs

---
 .../main/java/im/angry/openeuicc/service/OpenEuiccService.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 219bcaf31..2910590f5 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -166,7 +166,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
 
     override fun onGetEuiccProfileInfoList(slotId: Int): GetEuiccProfileInfoListResult = withEuiccChannelManager {
         Log.i(TAG, "onGetEuiccProfileInfoList slotId=$slotId")
-        if (shouldIgnoreSlot(slotId)) {
+        if (slotId == -1 || shouldIgnoreSlot(slotId)) {
             Log.i(TAG, "ignoring slot $slotId")
             return GetEuiccProfileInfoListResult(RESULT_FIRST_USER, arrayOf(), true)
         }

From f3391bb8ee6e2a099137598344b60b7d3c521c76 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 24 Jun 2024 21:07:50 -0400
Subject: [PATCH 065/458] lpac-jni: Bump

---
 libs/lpac-jni/src/main/jni/lpac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index d85537a90..0011ea6cc 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit d85537a90922901638ca86c28ac6d5a0d494807c
+Subproject commit 0011ea6cc4c045c84f7aac839c1cce7804422355

From a29b06803572d56477ea33dec661b6a2911ea14e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 26 Jun 2024 21:20:53 -0400
Subject: [PATCH 066/458] ui: Prevent crash after a profile switch that timed
 out

...and improve the prompt when this happens.
---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt  | 7 +++++++
 app-common/src/main/res/values/strings.xml                 | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 96c094981..551f0c26f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -47,6 +47,10 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
     private val adapter = EuiccProfileAdapter()
 
+    // Marker for when this fragment might enter an invalid state
+    // e.g. after a failed enable / disable operation
+    private var invalid = false
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setHasOptionsMenu(true)
@@ -106,6 +110,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
     @SuppressLint("NotifyDataSetChanged")
     private fun refresh() {
+        if (invalid) return
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
@@ -151,6 +156,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     euiccChannelManager.waitForReconnect(slotId, portId, timeoutMillis = 30 * 1000)
                 } catch (e: TimeoutCancellationException) {
                     withContext(Dispatchers.Main) {
+                        // Prevent this Fragment from being used again
+                        invalid = true
                         // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
                         AlertDialog.Builder(requireContext()).apply {
                             setMessage(R.string.enable_disable_timeout)
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a2424e553..2920bfab2 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -16,7 +16,7 @@
     <string name="delete">Delete</string>
     <string name="rename">Rename</string>
 
-    <string name="enable_disable_timeout">Timed out waiting for the eSIM chip to switch profiles. You might want to restart the application or even the phone.</string>
+    <string name="enable_disable_timeout">Timed out waiting for the eSIM chip to switch profiles. This may be a bug in your phone\'s modem firmware. Try toggling airplane mode, restarting the application, or rebooting the phone.</string>
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>

From 4790f87b65c3b5c70b20b8b6a10767d9bcf877a7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 26 Jun 2024 21:23:10 -0400
Subject: [PATCH 067/458] ui: Prevent users from doing multiple things at once

---
 .../main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 551f0c26f..cff6e8953 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -254,6 +254,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         }
 
         private fun showOptionsMenu() {
+            // Prevent users from doing multiple things at once
+            if (invalid || swipeRefresh.isRefreshing) return
+
             PopupMenu(root.context, profileMenu).apply {
                 setOnMenuItemClickListener(::onMenuItemClicked)
                 populatePopupWithProfileActions(this, profile)

From 6396f170128f6950562339b3d089fd86a3744eda Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 27 Jun 2024 20:01:44 -0400
Subject: [PATCH 068/458] Retry profile switching with refresh = false if
 refresh = true failed

---
 .../openeuicc/ui/EuiccManagementFragment.kt   | 33 ++++++++++++++++---
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 11 +++++++
 app-common/src/main/res/values/strings.xml    |  1 +
 3 files changed, 40 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index cff6e8953..6aa1acedb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -134,11 +134,17 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
         lifecycleScope.launch {
             beginTrackedOperation {
-                val res = if (enable) {
-                    channel.lpa.enableProfile(iccid)
-                } else {
-                    channel.lpa.disableProfile(iccid)
-                }
+                val (res, refreshed) =
+                    if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
+                        // Sometimes, we *can* enable or disable the profile, but we cannot
+                        // send the refresh command to the modem because the profile somehow
+                        // makes the modem "busy". In this case, we can still switch by setting
+                        // refresh to false, but then the switch cannot take effect until the
+                        // user resets the modem manually by toggling airplane mode or rebooting.
+                        Pair(channel.lpa.switchProfile(iccid, enable, refresh = false), false)
+                    } else {
+                        Pair(true, true)
+                    }
 
                 if (!res) {
                     Log.d(TAG, "Failed to enable / disable profile $iccid")
@@ -152,6 +158,23 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     return@beginTrackedOperation false
                 }
 
+                if (!refreshed) {
+                    withContext(Dispatchers.Main) {
+                        AlertDialog.Builder(requireContext()).apply {
+                            setMessage(R.string.switch_did_not_refresh)
+                            setPositiveButton(android.R.string.ok) { dialog, _ ->
+                                dialog.dismiss()
+                                requireActivity().finish()
+                            }
+                            setOnDismissListener { _ ->
+                                requireActivity().finish()
+                            }
+                            show()
+                        }
+                    }
+                    return@beginTrackedOperation true
+                }
+
                 try {
                     euiccChannelManager.waitForReconnect(slotId, portId, timeoutMillis = 30 * 1000)
                 } catch (e: TimeoutCancellationException) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 860abc95e..50b207757 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -26,6 +26,17 @@ val List<LocalProfileInfo>.operational: List<LocalProfileInfo>
 val List<EuiccChannel>.hasMultipleChips: Boolean
     get() = distinctBy { it.slotId }.size > 1
 
+fun LocalProfileAssistant.switchProfile(
+    iccid: String,
+    enable: Boolean = false,
+    refresh: Boolean = false
+): Boolean =
+    if (enable) {
+        enableProfile(iccid, refresh)
+    } else {
+        disableProfile(iccid, refresh)
+    }
+
 /**
  * Disable the current active profile if any. If refresh is true, also cause a refresh command.
  * See EuiccManager.waitForReconnect()
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 2920bfab2..c42e5da56 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -17,6 +17,7 @@
     <string name="rename">Rename</string>
 
     <string name="enable_disable_timeout">Timed out waiting for the eSIM chip to switch profiles. This may be a bug in your phone\'s modem firmware. Try toggling airplane mode, restarting the application, or rebooting the phone.</string>
+    <string name="switch_did_not_refresh">The operation was successful, but your phone\'s modem refused to refresh. You might need to toggle airplane mode or reboot in order to use the new profile.</string>
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>

From 803b88f74ed7c8f519b68a3b40baa82dec0fabb3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 29 Jun 2024 20:02:48 -0400
Subject: [PATCH 069/458] feat: USB CCID reader support [1/n]

---
 .../core/DefaultEuiccChannelFactory.kt        |  20 ++++
 .../core/DefaultEuiccChannelManager.kt        |  44 ++++++++
 .../openeuicc/core/EuiccChannelFactory.kt     |   4 +
 .../openeuicc/core/EuiccChannelManager.kt     |  16 ++-
 .../openeuicc/core/usb/UsbApduInterface.kt    |  37 ++++++
 .../openeuicc/core/usb/UsbCcidDescription.kt  | 106 ++++++++++++++++++
 .../angry/openeuicc/core/usb/UsbCcidUtils.kt  |  34 ++++++
 .../im/angry/openeuicc/ui/MainActivity.kt     |  85 +++++++++++++-
 8 files changed, 343 insertions(+), 3 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 1cb365058..e653a0782 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -1,14 +1,23 @@
 package im.angry.openeuicc.core
 
 import android.content.Context
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbInterface
+import android.hardware.usb.UsbManager
 import android.se.omapi.SEService
 import android.util.Log
+import im.angry.openeuicc.core.usb.UsbApduInterface
+import im.angry.openeuicc.core.usb.getIoEndpoints
 import im.angry.openeuicc.util.*
 import java.lang.IllegalArgumentException
 
 open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccChannelFactory {
     private var seService: SEService? = null
 
+    private val usbManager by lazy {
+        context.getSystemService(Context.USB_SERVICE) as UsbManager
+    }
+
     private suspend fun ensureSEService() {
         if (seService == null || !seService!!.isConnected) {
             seService = connectSEService(context)
@@ -36,6 +45,17 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         return null
     }
 
+    override fun tryOpenUsbEuiccChannel(usbDevice: UsbDevice, usbInterface: UsbInterface): EuiccChannel? {
+        val (bulkIn, bulkOut) = usbInterface.getIoEndpoints()
+        if (bulkIn == null || bulkOut == null) return null
+        val conn = usbManager.openDevice(usbDevice) ?: return null
+        if (!conn.claimInterface(usbInterface, true)) return null
+        return EuiccChannel(
+            FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
+            UsbApduInterface(conn, bulkIn, bulkOut)
+        )
+    }
+
     override fun cleanup() {
         seService?.shutdown()
         seService = null
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 1d6627db6..81d86eecf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -1,8 +1,11 @@
 package im.angry.openeuicc.core
 
 import android.content.Context
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbManager
 import android.telephony.SubscriptionManager
 import android.util.Log
+import im.angry.openeuicc.core.usb.getSmartCardInterface
 import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -23,12 +26,18 @@ open class DefaultEuiccChannelManager(
 
     private val channelCache = mutableListOf<EuiccChannel>()
 
+    private var usbChannel: EuiccChannel? = null
+
     private val lock = Mutex()
 
     protected val tm by lazy {
         appContainer.telephonyManager
     }
 
+    private val usbManager by lazy {
+        context.getSystemService(Context.USB_SERVICE) as UsbManager
+    }
+
     private val euiccChannelFactory by lazy {
         appContainer.euiccChannelFactory
     }
@@ -38,6 +47,15 @@ open class DefaultEuiccChannelManager(
 
     private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
         lock.withLock {
+            if (port.card.physicalSlotIndex == EuiccChannelManager.USB_CHANNEL_ID) {
+                return if (usbChannel != null && usbChannel!!.valid) {
+                    usbChannel
+                } else {
+                    usbChannel = null
+                    null
+                }
+            }
+
             val existing =
                 channelCache.find { it.slotId == port.card.physicalSlotIndex && it.portId == port.portIndex }
             if (existing != null) {
@@ -162,11 +180,37 @@ open class DefaultEuiccChannelManager(
             }
         }
 
+    override suspend fun enumerateUsbEuiccChannel(): Pair<UsbDevice?, EuiccChannel?> =
+        withContext(Dispatchers.IO) {
+            usbManager.deviceList.values.forEach { device ->
+                Log.i(TAG, "Scanning USB device ${device.deviceId}:${device.vendorId}")
+                val iface = device.getSmartCardInterface() ?: return@forEach
+                // If we don't have permission, tell UI code that we found a candidate device, but we
+                // need permission to be able to do anything with it
+                if (!usbManager.hasPermission(device)) return@withContext Pair(device, null)
+                Log.i(TAG, "Found CCID interface on ${device.deviceId}:${device.vendorId}, and has permission; trying to open channel")
+                try {
+                    val channel = euiccChannelFactory.tryOpenUsbEuiccChannel(device, iface)
+                    if (channel != null && channel.lpa.valid) {
+                        usbChannel = channel
+                        return@withContext Pair(device, channel)
+                    }
+                } catch (e: Exception) {
+                    // Ignored -- skip forward
+                    e.printStackTrace()
+                }
+                Log.i(TAG, "No valid eUICC channel found on USB device ${device.deviceId}:${device.vendorId}")
+            }
+            return@withContext Pair(null, null)
+        }
+
     override fun invalidate() {
         for (channel in channelCache) {
             channel.close()
         }
 
+        usbChannel?.close()
+        usbChannel = null
         channelCache.clear()
         euiccChannelFactory.cleanup()
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
index c8435dcad..fb5d95d8b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
@@ -1,5 +1,7 @@
 package im.angry.openeuicc.core
 
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbInterface
 import im.angry.openeuicc.util.*
 
 // This class is here instead of inside DI because it contains a bit more logic than just
@@ -7,6 +9,8 @@ import im.angry.openeuicc.util.*
 interface EuiccChannelFactory {
     suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel?
 
+    fun tryOpenUsbEuiccChannel(usbDevice: UsbDevice, usbInterface: UsbInterface): EuiccChannel?
+
     /**
      * Release all resources used by this EuiccChannelFactory
      * Note that the same instance may be reused; any resources allocated must be automatically
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 5171779bb..b21ccf614 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -1,5 +1,7 @@
 package im.angry.openeuicc.core
 
+import android.hardware.usb.UsbDevice
+
 /**
  * EuiccChannelManager holds references to, and manages the lifecycles of, individual
  * APDU channels to SIM cards. The find* methods will create channels when needed, and
@@ -11,13 +13,25 @@ package im.angry.openeuicc.core
  * Holding references independent of EuiccChannelManagerService is unsupported.
  */
 interface EuiccChannelManager {
+    companion object {
+        const val USB_CHANNEL_ID = 99
+    }
+
     /**
-     * Scan all possible sources for EuiccChannels, return them and have all
+     * Scan all possible _device internal_ sources for EuiccChannels, return them and have all
      * scanned channels cached; these channels will remain open for the entire lifetime of
      * this EuiccChannelManager object, unless disconnected externally or invalidate()'d
      */
     suspend fun enumerateEuiccChannels(): List<EuiccChannel>
 
+    /**
+     * Scan all possible USB devices for CCID readers that may contain eUICC cards.
+     * If found, try to open it for access, and add it to the internal EuiccChannel cache
+     * as a "port" with id 99. When user interaction is required to obtain permission
+     * to interact with the device, the second return value (EuiccChannel) will be null.
+     */
+    suspend fun enumerateUsbEuiccChannel(): Pair<UsbDevice?, EuiccChannel?>
+
     /**
      * Wait for a slot + port to reconnect (i.e. become valid again)
      * If the port is currently valid, this function will return immediately.
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
new file mode 100644
index 000000000..86efc2437
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -0,0 +1,37 @@
+package im.angry.openeuicc.core.usb
+
+import android.hardware.usb.UsbDeviceConnection
+import android.hardware.usb.UsbEndpoint
+import net.typeblog.lpac_jni.ApduInterface
+
+class UsbApduInterface(
+    private val conn: UsbDeviceConnection,
+    private val bulkIn: UsbEndpoint,
+    private val bulkOut: UsbEndpoint
+): ApduInterface {
+    private lateinit var ccidDescription: UsbCcidDescription
+
+    override fun connect() {
+        ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
+        ccidDescription.checkTransportProtocol()
+    }
+
+    override fun disconnect() {
+        conn.close()
+    }
+
+    override fun logicalChannelOpen(aid: ByteArray): Int {
+        return 0
+    }
+
+    override fun logicalChannelClose(handle: Int) {
+
+    }
+
+    override fun transmit(tx: ByteArray): ByteArray {
+        return byteArrayOf()
+    }
+
+    override val valid: Boolean
+        get() = true
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
new file mode 100644
index 000000000..a9fa39489
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
@@ -0,0 +1,106 @@
+package im.angry.openeuicc.core.usb
+
+import java.nio.ByteBuffer
+import java.nio.ByteOrder
+
+data class UsbCcidDescription(
+    private val bMaxSlotIndex: Byte,
+    private val bVoltageSupport: Byte,
+    private val dwProtocols: Int,
+    private val dwFeatures: Int
+) {
+    companion object {
+        private const val DESCRIPTOR_LENGTH: Byte = 0x36
+        private const val DESCRIPTOR_TYPE: Byte = 0x21
+
+        // dwFeatures Masks
+        private const val FEATURE_AUTOMATIC_VOLTAGE = 0x00008
+        private const val FEATURE_AUTOMATIC_PPS = 0x00080
+
+        private const val FEATURE_EXCHANGE_LEVEL_TPDU = 0x10000
+        private const val FEATURE_EXCHANGE_LEVEL_SHORT_APDU = 0x20000
+        private const val FEATURE_EXCHAGE_LEVEL_EXTENDED_APDU = 0x40000
+
+        // bVoltageSupport Masks
+        private const val VOLTAGE_5V: Byte = 1
+        private const val VOLTAGE_3V: Byte = 2
+        private const val VOLTAGE_1_8V: Byte = 4
+
+        private const val SLOT_OFFSET = 4
+        private const val FEATURES_OFFSET = 40
+        private const val MASK_T0_PROTO = 1
+        private const val MASK_T1_PROTO = 2
+
+        fun fromRawDescriptors(desc: ByteArray): UsbCcidDescription? {
+            var dwProtocols = 0
+            var dwFeatures = 0
+            var bMaxSlotIndex: Byte = 0
+            var bVoltageSupport: Byte = 0
+
+            var hasCcidDescriptor = false
+
+            val byteBuffer = ByteBuffer.wrap(desc).order(ByteOrder.LITTLE_ENDIAN)
+
+            while (byteBuffer.hasRemaining()) {
+                byteBuffer.mark()
+                val len = byteBuffer.get()
+                val type = byteBuffer.get()
+                if (type == DESCRIPTOR_TYPE && len == DESCRIPTOR_LENGTH) {
+                    byteBuffer.reset()
+                    byteBuffer.position(byteBuffer.position() + SLOT_OFFSET)
+                    bMaxSlotIndex = byteBuffer.get()
+                    bVoltageSupport = byteBuffer.get()
+                    dwProtocols = byteBuffer.int
+                    byteBuffer.reset()
+                    byteBuffer.position(byteBuffer.position() + FEATURES_OFFSET)
+                    dwFeatures = byteBuffer.int
+                    hasCcidDescriptor = true
+                    break
+                } else {
+                    byteBuffer.position(byteBuffer.position() + len - 2)
+                }
+            }
+
+            return if (hasCcidDescriptor) {
+                UsbCcidDescription(bMaxSlotIndex, bVoltageSupport, dwProtocols, dwFeatures)
+            } else {
+                null
+            }
+        }
+    }
+
+    enum class Voltage(powerOnValue: Int, mask: Int) {
+        AUTO(0, 0), _5V(1, VOLTAGE_5V.toInt()), _3V(2, VOLTAGE_3V.toInt()), _1_8V(
+            3,
+            VOLTAGE_1_8V.toInt()
+        );
+
+        val mask = powerOnValue.toByte()
+        val powerOnValue = mask.toByte()
+    }
+
+    private fun hasFeature(feature: Int): Boolean =
+        (dwFeatures and feature) != 0
+
+    val voltages: Array<Voltage>
+        get() =
+            if (hasFeature(FEATURE_AUTOMATIC_VOLTAGE)) {
+                arrayOf(Voltage.AUTO)
+            } else {
+                Voltage.values().mapNotNull {
+                    if ((it.mask.toInt() and bVoltageSupport.toInt()) != 0) {
+                        it
+                    } else {
+                        null
+                    }
+                }.toTypedArray()
+            }
+
+    val hasAutomaticPps: Boolean = hasFeature(FEATURE_AUTOMATIC_PPS)
+
+    fun checkTransportProtocol() {
+        val hasT1Protocol = dwProtocols and MASK_T1_PROTO != 0
+        val hasT0Protocol = dwProtocols and MASK_T0_PROTO != 0
+        android.util.Log.d("CcidDescription", "hasT1Protocol = $hasT1Protocol, hasT0Protocol = $hasT0Protocol")
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
new file mode 100644
index 000000000..f4e9a878c
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
@@ -0,0 +1,34 @@
+// Adapted from <https://github.com/open-keychain/open-keychain/blob/master/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/usb>
+package im.angry.openeuicc.core.usb
+
+import android.hardware.usb.UsbConstants
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbEndpoint
+import android.hardware.usb.UsbInterface
+
+fun UsbInterface.getIoEndpoints(): Pair<UsbEndpoint?, UsbEndpoint?> {
+    var bulkIn: UsbEndpoint? = null
+    var bulkOut: UsbEndpoint? = null
+    for (i in 0 until endpointCount) {
+        val endpoint = getEndpoint(i)
+        if (endpoint.type != UsbConstants.USB_ENDPOINT_XFER_BULK) {
+            continue
+        }
+        if (endpoint.direction == UsbConstants.USB_DIR_IN) {
+            bulkIn = endpoint
+        } else if (endpoint.direction == UsbConstants.USB_DIR_OUT) {
+            bulkOut = endpoint
+        }
+    }
+    return Pair(bulkIn, bulkOut)
+}
+
+fun UsbDevice.getSmartCardInterface(): UsbInterface? {
+    for (i in 0 until interfaceCount) {
+        val anInterface = getInterface(i)
+        if (anInterface.interfaceClass == UsbConstants.USB_CLASS_CSCID) {
+            return anInterface
+        }
+    }
+    return null
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 9befe57f0..485d87f28 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -1,6 +1,14 @@
 package im.angry.openeuicc.ui
 
+import android.annotation.SuppressLint
+import android.app.PendingIntent
+import android.content.BroadcastReceiver
+import android.content.Context
 import android.content.Intent
+import android.content.IntentFilter
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbManager
+import android.os.Build
 import android.os.Bundle
 import android.telephony.TelephonyManager
 import android.util.Log
@@ -12,6 +20,7 @@ import android.widget.ArrayAdapter
 import android.widget.Spinner
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
@@ -20,6 +29,7 @@ import kotlinx.coroutines.withContext
 open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         const val TAG = "MainActivity"
+        const val ACTION_USB_PERMISSION = "im.angry.openeuicc.USB_PERMISSION"
     }
 
     private lateinit var spinnerAdapter: ArrayAdapter<String>
@@ -30,6 +40,28 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     protected lateinit var tm: TelephonyManager
 
+    private val usbManager: UsbManager by lazy {
+        getSystemService(USB_SERVICE) as UsbManager
+    }
+
+    private var usbDevice: UsbDevice? = null
+    private var usbChannel: EuiccChannel? = null
+
+    private lateinit var usbPendingIntent: PendingIntent
+
+    private val usbPermissionReceiver = object : BroadcastReceiver() {
+        override fun onReceive(context: Context?, intent: Intent?) {
+            if (intent?.action == ACTION_USB_PERMISSION) {
+                if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
+                    lifecycleScope.launch(Dispatchers.Main) {
+                        switchToUsbFragmentIfPossible()
+                    }
+                }
+            }
+        }
+    }
+
+    @SuppressLint("WrongConstant", "UnspecifiedRegisterReceiverFlag")
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
@@ -43,6 +75,15 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         tm = telephonyManager
 
         spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
+
+        usbPendingIntent = PendingIntent.getBroadcast(this, 0,
+            Intent(ACTION_USB_PERMISSION), PendingIntent.FLAG_IMMUTABLE)
+        val filter = IntentFilter(ACTION_USB_PERMISSION)
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            registerReceiver(usbPermissionReceiver, filter, Context.RECEIVER_EXPORTED)
+        } else {
+            registerReceiver(usbPermissionReceiver, filter)
+        }
     }
 
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
@@ -62,8 +103,15 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                     position: Int,
                     id: Long
                 ) {
-                    supportFragmentManager.beginTransaction()
-                        .replace(R.id.fragment_root, fragments[position]).commit()
+                    if (position < fragments.size) {
+                        supportFragmentManager.beginTransaction()
+                            .replace(R.id.fragment_root, fragments[position]).commit()
+                    } else if (position == fragments.size) {
+                        // If we are at the last position, this is the USB device
+                        lifecycleScope.launch(Dispatchers.Main) {
+                            switchToUsbFragmentIfPossible()
+                        }
+                    }
                 }
 
                 override fun onNothingSelected(parent: AdapterView<*>?) {
@@ -106,12 +154,22 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
 
+        withContext(Dispatchers.IO) {
+            val res = euiccChannelManager.enumerateUsbEuiccChannel()
+            usbDevice = res.first
+            usbChannel = res.second
+        }
+
         withContext(Dispatchers.Main) {
             knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
                 fragments.add(appContainer.uiComponentFactory.createEuiccManagementFragment(channel))
             }
 
+            // If USB readers exist, add them at the very last
+            // The adapter logic depends on this assumption
+            usbDevice?.let { spinnerAdapter.add(it.productName) }
+
             if (fragments.isNotEmpty()) {
                 if (this@MainActivity::spinner.isInitialized) {
                     spinnerItem.isVisible = true
@@ -120,4 +178,27 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
     }
+
+    private suspend fun switchToUsbFragmentIfPossible() {
+        if (usbDevice != null && usbChannel == null) {
+            if (!usbManager.hasPermission(usbDevice)) {
+                usbManager.requestPermission(usbDevice, usbPendingIntent)
+                return
+            }  else {
+               val (device, channel) = withContext(Dispatchers.IO) {
+                    euiccChannelManager.enumerateUsbEuiccChannel()
+                }
+
+                if (device != null && channel != null) {
+                    usbDevice = device
+                    usbChannel = channel
+                }
+            }
+        }
+
+        if (usbChannel != null) {
+            supportFragmentManager.beginTransaction().replace(R.id.fragment_root,
+                appContainer.uiComponentFactory.createEuiccManagementFragment(usbChannel!!)).commit()
+        }
+    }
 }
\ No newline at end of file

From 3667f578d7d33dbb2bba2047e0a5de74ae344442 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 16:51:59 -0400
Subject: [PATCH 070/458] [2/n] USB CCID Reader support

*cough* copied CCID driver from OpenKeychains
---
 .../core/DefaultEuiccChannelManager.kt        |  16 +
 .../openeuicc/core/usb/UsbApduInterface.kt    | 128 ++++++-
 .../openeuicc/core/usb/UsbCcidDescription.kt  |  10 +-
 .../openeuicc/core/usb/UsbCcidTransceiver.kt  | 348 ++++++++++++++++++
 .../angry/openeuicc/core/usb/UsbCcidUtils.kt  |   2 +
 .../util/PrivilegedTelephonyUtils.kt          |   7 +-
 6 files changed, 499 insertions(+), 12 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 81d86eecf..09559598a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -91,6 +91,10 @@ open class DefaultEuiccChannelManager(
     override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
         runBlocking {
             withContext(Dispatchers.IO) {
+                if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                    return@withContext usbChannel
+                }
+
                 for (card in uiccCards) {
                     for (port in card.ports) {
                         if (port.logicalSlotIndex == logicalSlotId) {
@@ -106,6 +110,10 @@ open class DefaultEuiccChannelManager(
     override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
         runBlocking {
             withContext(Dispatchers.IO) {
+                if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                    return@withContext usbChannel
+                }
+
                 for (card in uiccCards) {
                     if (card.physicalSlotIndex != physicalSlotId) continue
                     for (port in card.ports) {
@@ -118,6 +126,10 @@ open class DefaultEuiccChannelManager(
         }
 
     override suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
+        if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+            return usbChannel?.let { listOf(it) }
+        }
+
         for (card in uiccCards) {
             if (card.physicalSlotIndex != physicalSlotId) continue
             return card.ports.mapNotNull { tryOpenEuiccChannel(it) }
@@ -133,6 +145,10 @@ open class DefaultEuiccChannelManager(
 
     override suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel? =
         withContext(Dispatchers.IO) {
+            if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                return@withContext usbChannel
+            }
+
             uiccCards.find { it.physicalSlotIndex == physicalSlotId }?.let { card ->
                 card.ports.find { it.portIndex == portId }?.let { tryOpenEuiccChannel(it) }
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 86efc2437..d181e539d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -2,6 +2,8 @@ package im.angry.openeuicc.core.usb
 
 import android.hardware.usb.UsbDeviceConnection
 import android.hardware.usb.UsbEndpoint
+import android.util.Log
+import im.angry.openeuicc.util.*
 import net.typeblog.lpac_jni.ApduInterface
 
 class UsbApduInterface(
@@ -9,11 +11,30 @@ class UsbApduInterface(
     private val bulkIn: UsbEndpoint,
     private val bulkOut: UsbEndpoint
 ): ApduInterface {
+    companion object {
+        private const val TAG = "UsbApduInterface"
+    }
+
     private lateinit var ccidDescription: UsbCcidDescription
+    private lateinit var transceiver: UsbCcidTransceiver
+
+    private var channelId = -1
 
     override fun connect() {
         ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
-        ccidDescription.checkTransportProtocol()
+
+        if (!ccidDescription.hasT0Protocol) {
+            throw IllegalArgumentException("Unsupported card reader; T=0 support is required")
+        }
+
+        transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription)
+
+        try {
+            transceiver.iccPowerOn()
+        } catch (e: Exception) {
+            e.printStackTrace()
+            throw e
+        }
     }
 
     override fun disconnect() {
@@ -21,17 +42,118 @@ class UsbApduInterface(
     }
 
     override fun logicalChannelOpen(aid: ByteArray): Int {
-        return 0
+        check(channelId == -1) { "Logical channel already opened" }
+
+        // OPEN LOGICAL CHANNEL
+        val req = manageChannelCmd(true, 0)
+        Log.d(TAG, "OPEN LOGICAL CHANNEL: ${req.encodeHex()}")
+
+        val resp = try {
+            transmitApduByChannel(req, 0)
+        } catch (e: Exception) {
+            e.printStackTrace()
+            return -1
+        }
+        Log.d(TAG, "OPEN LOGICAL CHANNEL response: ${resp.encodeHex()}")
+
+        return if (resp.size >= 2 && resp.sliceArray((resp.size - 2) until resp.size).contentEquals(
+                byteArrayOf(0x90.toByte(), 0x00)
+            )
+        ) {
+            channelId = resp[0].toInt()
+            Log.d(TAG, "channelId = $channelId")
+
+            // Then, select AID
+            val selectAid = selectByDfCmd(aid, channelId.toByte())
+            Log.d(TAG, "Select DF command: ${selectAid.encodeHex()}")
+            val selectAidResp = transmitApduByChannel(selectAid, channelId.toByte())
+            Log.d(TAG, "Select DF resp: ${selectAidResp.encodeHex()}")
+            channelId
+        } else {
+            -1
+        }
     }
 
     override fun logicalChannelClose(handle: Int) {
+        check(handle == channelId) { "Logical channel ID mismatch" }
+        check(channelId != -1) { "Logical channel is not opened" }
 
+        // CLOSE LOGICAL CHANNEL
+        val req = manageChannelCmd(false, channelId.toByte())
+        Log.d(TAG, "CLOSE LOGICAL CHANNEL: ${req.encodeHex()}")
+
+        val resp = transmitApduByChannel(req, channelId.toByte())
+        Log.d(TAG, "CLOSE LOGICAL CHANNEL response: ${resp.encodeHex()}")
+
+        channelId = -1
     }
 
     override fun transmit(tx: ByteArray): ByteArray {
-        return byteArrayOf()
+        check(channelId != -1) { "Logical channel is not opened" }
+        Log.d(TAG, "USB APDU command: ${tx.encodeHex()}")
+        val resp = transmitApduByChannel(tx, channelId.toByte())
+        Log.d(TAG, "USB APDU response: ${resp.encodeHex()}")
+        return resp
     }
 
     override val valid: Boolean
         get() = true
+
+    private fun buildCmd(cla: Byte, ins: Byte, p1: Byte, p2: Byte, data: ByteArray?, le: Byte?) =
+        byteArrayOf(cla, ins, p1, p2).let {
+            if (data != null) {
+                it + data.size.toByte() + data
+            } else {
+                it
+            }
+        }.let {
+            if (le != null) {
+                it + byteArrayOf(le)
+            } else {
+                it
+            }
+        }
+
+    private fun manageChannelCmd(open: Boolean, channel: Byte) =
+        if (open) {
+            buildCmd(0x00, 0x70, 0x00, 0x00, null, 0x01)
+        } else {
+            buildCmd(channel, 0x70, 0x80.toByte(), channel, null, null)
+        }
+
+    private fun selectByDfCmd(aid: ByteArray, channel: Byte) =
+        buildCmd(channel, 0xA4.toByte(), 0x04, 0x00, aid, null)
+
+    private fun transmitApduByChannel(tx: ByteArray, channel: Byte): ByteArray {
+        val realTx = tx.copyOf()
+        // OR the channel mask into the CLA byte
+        realTx[0] = ((realTx[0].toInt() and 0xFC) or channel.toInt()).toByte()
+
+        var resp = transceiver.sendXfrBlock(realTx)!!.data!!
+
+        if (resp.size >= 2) {
+            var sw1 = resp[resp.size - 2].toInt() and 0xFF
+            var sw2 = resp[resp.size - 1].toInt() and 0xFF
+
+            if (sw1 == 0x6C) {
+                realTx[realTx.size - 1] = resp[resp.size - 1]
+                resp = transceiver.sendXfrBlock(realTx)!!.data!!
+            } else if (sw1 == 0x61) {
+                do {
+                    val getResponseCmd = byteArrayOf(
+                        realTx[0], 0xC0.toByte(), 0x00, 0x00, sw2.toByte()
+                    )
+
+                    val tmp = transceiver.sendXfrBlock(getResponseCmd)!!.data!!
+
+                    resp = resp.sliceArray(0 until (resp.size - 2)) + tmp
+
+                    sw1 = resp[resp.size - 2].toInt() and 0xFF
+                    sw2 = resp[resp.size - 1].toInt() and 0xFF
+                } while (sw1 == 0x61)
+            }
+        }
+
+        return resp
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
index a9fa39489..8a2ed39a4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
@@ -96,11 +96,9 @@ data class UsbCcidDescription(
                 }.toTypedArray()
             }
 
-    val hasAutomaticPps: Boolean = hasFeature(FEATURE_AUTOMATIC_PPS)
+    val hasAutomaticPps: Boolean
+        get() = hasFeature(FEATURE_AUTOMATIC_PPS)
 
-    fun checkTransportProtocol() {
-        val hasT1Protocol = dwProtocols and MASK_T1_PROTO != 0
-        val hasT0Protocol = dwProtocols and MASK_T0_PROTO != 0
-        android.util.Log.d("CcidDescription", "hasT1Protocol = $hasT1Protocol, hasT0Protocol = $hasT0Protocol")
-    }
+    val hasT0Protocol: Boolean
+        get() = (dwProtocols and MASK_T0_PROTO) != 0
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
new file mode 100644
index 000000000..ac2e1dc75
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -0,0 +1,348 @@
+package im.angry.openeuicc.core.usb
+
+import android.hardware.usb.UsbDeviceConnection
+import android.hardware.usb.UsbEndpoint
+import android.os.SystemClock
+import android.util.Log
+import im.angry.openeuicc.util.*
+import java.nio.ByteBuffer
+import java.nio.ByteOrder
+
+
+/**
+ * Provides raw, APDU-agnostic transmission to the CCID reader
+ * Adapted from <https://github.com/open-keychain/open-keychain/blob/master/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/usb/CcidTransceiver.java>
+ */
+class UsbCcidTransceiver(
+    private val usbConnection: UsbDeviceConnection,
+    private val usbBulkIn: UsbEndpoint,
+    private val usbBulkOut: UsbEndpoint,
+    private val usbCcidDescription: UsbCcidDescription
+) {
+    companion object {
+        private const val TAG = "UsbCcidTransceiver"
+
+        private const val CCID_HEADER_LENGTH = 10
+
+        private const val MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK = 0x80
+        private const val MESSAGE_TYPE_PC_TO_RDR_ICC_POWER_ON = 0x62
+        private const val MESSAGE_TYPE_PC_TO_RDR_ICC_POWER_OFF = 0x63
+        private const val MESSAGE_TYPE_PC_TO_RDR_XFR_BLOCK = 0x6f
+
+        private const val COMMAND_STATUS_SUCCESS: Byte = 0
+        private const val COMMAND_STATUS_TIME_EXTENSION_RQUESTED: Byte = 2
+
+        /**
+         * Level Parameter: APDU is a single command.
+         *
+         * "the command APDU begins and ends with this command"
+         * -- DWG Smart-Card USB Integrated Circuit(s) Card Devices rev 1.0
+         * § 6.1.1.3
+         */
+        const val LEVEL_PARAM_START_SINGLE_CMD_APDU: Short = 0x0000
+
+        /**
+         * Level Parameter: First APDU in a multi-command APDU.
+         *
+         * "the command APDU begins with this command, and continue in the
+         * next PC_to_RDR_XfrBlock"
+         * -- DWG Smart-Card USB Integrated Circuit(s) Card Devices rev 1.0
+         * § 6.1.1.3
+         */
+        const val LEVEL_PARAM_START_MULTI_CMD_APDU: Short = 0x0001
+
+        /**
+         * Level Parameter: Final APDU in a multi-command APDU.
+         *
+         * "this abData field continues a command APDU and ends the command APDU"
+         * -- DWG Smart-Card USB Integrated Circuit(s) Card Devices rev 1.0
+         * § 6.1.1.3
+         */
+        const val LEVEL_PARAM_END_MULTI_CMD_APDU: Short = 0x0002
+
+        /**
+         * Level Parameter: Next command in a multi-command APDU.
+         *
+         * "the abData field continues a command APDU and another block is to follow"
+         * -- DWG Smart-Card USB Integrated Circuit(s) Card Devices rev 1.0
+         * § 6.1.1.3
+         */
+        const val LEVEL_PARAM_CONTINUE_MULTI_CMD_APDU: Short = 0x0003
+
+        /**
+         * Level Parameter: Request the device continue sending APDU.
+         *
+         * "empty abData field, continuation of response APDU is expected in the next
+         * RDR_to_PC_DataBlock"
+         * -- DWG Smart-Card USB Integrated Circuit(s) Card Devices rev 1.0
+         * § 6.1.1.3
+         */
+        const val LEVEL_PARAM_CONTINUE_RESPONSE: Short = 0x0010
+
+        private const val SLOT_NUMBER = 0x00
+
+        private const val ICC_STATUS_SUCCESS: Byte = 0
+
+        private const val DEVICE_COMMUNICATE_TIMEOUT_MILLIS = 5000
+        private const val DEVICE_SKIP_TIMEOUT_MILLIS = 100
+    }
+
+    data class UsbCcidErrorException(val msg: String, val errorResponse: CcidDataBlock) :
+        Exception(msg)
+
+    data class CcidDataBlock(
+        val dwLength: Int,
+        val bSlot: Byte,
+        val bSeq: Byte,
+        val bStatus: Byte,
+        val bError: Byte,
+        val bChainParameter: Byte,
+        val data: ByteArray?
+    ) {
+        companion object {
+            fun parseHeaderFromBytes(headerBytes: ByteArray): CcidDataBlock {
+                val buf = ByteBuffer.wrap(headerBytes)
+                buf.order(ByteOrder.LITTLE_ENDIAN)
+
+                val type = buf.get()
+                require(type == MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK.toByte()) { "Header has incorrect type value!" }
+                val dwLength = buf.int
+                val bSlot = buf.get()
+                val bSeq = buf.get()
+                val bStatus = buf.get()
+                val bError = buf.get()
+                val bChainParameter = buf.get()
+
+                return CcidDataBlock(dwLength, bSlot, bSeq, bStatus, bError, bChainParameter, null)
+            }
+        }
+
+        fun withData(d: ByteArray): CcidDataBlock {
+            require(data == null) { "Cannot add data twice" }
+            return CcidDataBlock(dwLength, bSlot, bSeq, bStatus, bError, bChainParameter, d)
+        }
+
+        val iccStatus: Byte
+            get() = (bStatus.toInt() and 0x03).toByte()
+
+        val commandStatus: Byte
+            get() = ((bStatus.toInt() shr 6) and 0x03).toByte()
+
+        val isStatusTimeoutExtensionRequest: Boolean
+            get() = commandStatus == COMMAND_STATUS_TIME_EXTENSION_RQUESTED
+
+        val isStatusSuccess: Boolean
+            get() = iccStatus == ICC_STATUS_SUCCESS && commandStatus == COMMAND_STATUS_SUCCESS
+    }
+
+    val hasAutomaticPps = usbCcidDescription.hasAutomaticPps
+
+    private val inputBuffer = ByteArray(usbBulkIn.maxPacketSize)
+
+    private var currentSequenceNumber: Byte = 0
+
+    private fun sendRaw(data: ByteArray, offset: Int, length: Int) {
+        val tr1 = usbConnection.bulkTransfer(
+            usbBulkOut, data, offset, length, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
+        )
+        if (tr1 != length) {
+            throw UsbTransportException(
+                "USB error - failed to transmit data ($tr1/$length)"
+            )
+        }
+    }
+
+    private fun receiveDataBlock(expectedSequenceNumber: Byte): CcidDataBlock? {
+        var response: CcidDataBlock?
+        do {
+            response = receiveDataBlockImmediate(expectedSequenceNumber)
+        } while (response!!.isStatusTimeoutExtensionRequest)
+        if (!response.isStatusSuccess) {
+            throw UsbCcidErrorException("USB-CCID error!", response)
+        }
+        return response
+    }
+
+    private fun receiveDataBlockImmediate(expectedSequenceNumber: Byte): CcidDataBlock? {
+        /*
+         * Some USB CCID devices (notably NitroKey 3) may time-out and need a subsequent poke to
+         * carry on communications.  No particular reason why the number 3 was chosen.  If we get a
+         * zero-sized reply (or a time-out), we try again.  Clamped retries prevent an infinite loop
+         * if things really turn sour.
+         */
+        var attempts = 3
+        Log.d(TAG, "Receive data block immediate seq=$expectedSequenceNumber")
+        var readBytes: Int
+        do {
+            readBytes = usbConnection.bulkTransfer(
+                usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
+            )
+            Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
+        } while (readBytes <= 0 && attempts-- > 0)
+        if (readBytes < CCID_HEADER_LENGTH) {
+            throw UsbTransportException("USB-CCID error - failed to receive CCID header")
+        }
+        if (inputBuffer[0] != MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK.toByte()) {
+            if (expectedSequenceNumber != inputBuffer[6]) {
+                throw UsbTransportException(
+                    ((("USB-CCID error - bad CCID header, type " + inputBuffer[0]) + " (expected " +
+                            MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK) + "), sequence number " + inputBuffer[6]
+                            ) + " (expected " +
+                            expectedSequenceNumber + ")"
+                )
+            }
+            throw UsbTransportException(
+                "USB-CCID error - bad CCID header type " + inputBuffer[0]
+            )
+        }
+        var result = CcidDataBlock.parseHeaderFromBytes(inputBuffer)
+        if (expectedSequenceNumber != result.bSeq) {
+            throw UsbTransportException(
+                ("USB-CCID error - expected sequence number " +
+                        expectedSequenceNumber + ", got " + result)
+            )
+        }
+
+        val dataBuffer = ByteArray(result.dwLength)
+        var bufferedBytes = readBytes - CCID_HEADER_LENGTH
+        System.arraycopy(inputBuffer, CCID_HEADER_LENGTH, dataBuffer, 0, bufferedBytes)
+        while (bufferedBytes < dataBuffer.size) {
+            readBytes = usbConnection.bulkTransfer(
+                usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
+            )
+            if (readBytes < 0) {
+                throw UsbTransportException(
+                    "USB error - failed reading response data! Header: $result"
+                )
+            }
+            System.arraycopy(inputBuffer, 0, dataBuffer, bufferedBytes, readBytes)
+            bufferedBytes += readBytes
+        }
+        result = result.withData(dataBuffer)
+        return result
+    }
+
+
+    private fun skipAvailableInput() {
+        var ignoredBytes: Int
+        do {
+            ignoredBytes = usbConnection.bulkTransfer(
+                usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_SKIP_TIMEOUT_MILLIS
+            )
+            if (ignoredBytes > 0) {
+                Log.e(TAG, "Skipped $ignoredBytes bytes")
+            }
+        } while (ignoredBytes > 0)
+    }
+
+    /**
+     * Transmits XfrBlock
+     * 6.1.4 PC_to_RDR_XfrBlock
+     *
+     * @param payload payload to transmit
+     */
+    fun sendXfrBlock(payload: ByteArray): CcidDataBlock? {
+        return sendXfrBlock(payload, LEVEL_PARAM_START_SINGLE_CMD_APDU)
+    }
+
+    /**
+     * Receives a continued XfrBlock. Should be called when a multiblock response is indicated
+     * 6.1.4 PC_to_RDR_XfrBlock
+     */
+    fun receiveContinuedResponse(): CcidDataBlock? {
+        return sendXfrBlock(ByteArray(0), LEVEL_PARAM_CONTINUE_RESPONSE)
+    }
+
+    /**
+     * Transmits XfrBlock
+     * 6.1.4 PC_to_RDR_XfrBlock
+     *
+     * @param payload payload to transmit
+     * @param levelParam Level parameter
+     */
+    private fun sendXfrBlock(payload: ByteArray, levelParam: Short): CcidDataBlock? {
+        val startTime = SystemClock.elapsedRealtime()
+        val l = payload.size
+        val sequenceNumber: Byte = currentSequenceNumber++
+        val headerData = byteArrayOf(
+            MESSAGE_TYPE_PC_TO_RDR_XFR_BLOCK.toByte(),
+            l.toByte(),
+            (l shr 8).toByte(),
+            (l shr 16).toByte(),
+            (l shr 24).toByte(),
+            SLOT_NUMBER.toByte(),
+            sequenceNumber,
+            0x00.toByte(),
+            (levelParam.toInt() and 0x00ff).toByte(),
+            (levelParam.toInt() shr 8).toByte()
+        )
+        val data: ByteArray = headerData + payload
+        var sentBytes = 0
+        while (sentBytes < data.size) {
+            val bytesToSend = Math.min(usbBulkOut.maxPacketSize, data.size - sentBytes)
+            sendRaw(data, sentBytes, bytesToSend)
+            sentBytes += bytesToSend
+        }
+        val ccidDataBlock = receiveDataBlock(sequenceNumber)
+        val elapsedTime = SystemClock.elapsedRealtime() - startTime
+        Log.d(TAG, "USB XferBlock call took " + elapsedTime + "ms")
+        return ccidDataBlock
+    }
+
+    fun iccPowerOn(): CcidDataBlock {
+        val startTime = SystemClock.elapsedRealtime()
+        skipAvailableInput()
+        var response: CcidDataBlock? = null
+        for (v in usbCcidDescription.voltages) {
+            Log.v(TAG, "CCID: attempting to power on with voltage $v")
+            response = try {
+                iccPowerOnVoltage(v.powerOnValue)
+            } catch (e: UsbCcidErrorException) {
+                if (e.errorResponse.bError.toInt() == 7) { // Power select error
+                    Log.v(TAG, "CCID: failed to power on with voltage $v")
+                    iccPowerOff()
+                    Log.v(TAG, "CCID: powered off")
+                    continue
+                }
+                throw e
+            }
+            break
+        }
+        if (response == null) {
+            throw UsbTransportException("Couldn't power up ICC2")
+        }
+        val elapsedTime = SystemClock.elapsedRealtime() - startTime
+        Log.d(
+            TAG,
+            "Usb transport connected, took " + elapsedTime + "ms, ATR=" +
+                    response.data?.encodeHex()
+        )
+        return response
+    }
+
+    private fun iccPowerOnVoltage(voltage: Byte): CcidDataBlock? {
+        val sequenceNumber = currentSequenceNumber++
+        val iccPowerCommand = byteArrayOf(
+            MESSAGE_TYPE_PC_TO_RDR_ICC_POWER_ON.toByte(),
+            0x00, 0x00, 0x00, 0x00,
+            SLOT_NUMBER.toByte(),
+            sequenceNumber,
+            voltage,
+            0x00, 0x00 // reserved for future use
+        )
+        sendRaw(iccPowerCommand, 0, iccPowerCommand.size)
+        return receiveDataBlock(sequenceNumber)
+    }
+
+    private fun iccPowerOff() {
+        val sequenceNumber = currentSequenceNumber++
+        val iccPowerCommand = byteArrayOf(
+            MESSAGE_TYPE_PC_TO_RDR_ICC_POWER_OFF.toByte(),
+            0x00, 0x00, 0x00, 0x00,
+            0x00,
+            sequenceNumber,
+            0x00
+        )
+        sendRaw(iccPowerCommand, 0, iccPowerCommand.size)
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
index f4e9a878c..edca7a03a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
@@ -6,6 +6,8 @@ import android.hardware.usb.UsbDevice
 import android.hardware.usb.UsbEndpoint
 import android.hardware.usb.UsbInterface
 
+class UsbTransportException(msg: String) : Exception(msg)
+
 fun UsbInterface.getIoEndpoints(): Pair<UsbEndpoint?, UsbEndpoint?> {
     var bulkIn: UsbEndpoint? = null
     var bulkOut: UsbEndpoint? = null
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 3c30bce2d..ae7294a6a 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -74,11 +74,12 @@ fun SubscriptionManager.tryRefreshCachedEuiccInfo(cardId: Int) {
 }
 
 // Every EuiccChannel we use here should be backed by a RealUiccPortInfoCompat
+// except when it is from a USB card reader
 val EuiccChannel.removable
-    get() = (port as RealUiccPortInfoCompat).card.isRemovable
+    get() = (port as? RealUiccPortInfoCompat)?.card?.isRemovable ?: true
 
 val EuiccChannel.cardId
-    get() = (port as RealUiccPortInfoCompat).card.cardId
+    get() = (port as? RealUiccPortInfoCompat)?.card?.cardId ?: -1
 
 val EuiccChannel.isMEP
-    get() = (port as RealUiccPortInfoCompat).card.isMultipleEnabledProfilesSupported
\ No newline at end of file
+    get() = (port as? RealUiccPortInfoCompat)?.card?.isMultipleEnabledProfilesSupported ?: false
\ No newline at end of file

From 87fc1cd2f87dc7fb9b6c2119b261870031f30790 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 16:55:55 -0400
Subject: [PATCH 071/458] NotificationsActivity: Prevent simulatenous
 handleNotification + refresh

---
 .../java/im/angry/openeuicc/ui/NotificationsActivity.kt     | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 744a87ddb..9758d18df 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -180,8 +180,9 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                         withContext(Dispatchers.IO) {
                             euiccChannel.lpa.handleNotification(notification.inner.seqNumber)
                         }
+
+                        refresh()
                     }
-                    refresh()
                     true
                 }
                 R.id.notification_delete -> {
@@ -189,8 +190,9 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                         withContext(Dispatchers.IO) {
                             euiccChannel.lpa.deleteNotification(notification.inner.seqNumber)
                         }
+
+                        refresh()
                     }
-                    refresh()
                     true
                 }
                 else -> false

From ccf21675d64bd989e853b6e2fd7db6e5a572cf9c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 17:06:58 -0400
Subject: [PATCH 072/458] [3/n] Handle USB permission responses properly

---
 app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 485d87f28..46417326e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -52,7 +52,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private val usbPermissionReceiver = object : BroadcastReceiver() {
         override fun onReceive(context: Context?, intent: Intent?) {
             if (intent?.action == ACTION_USB_PERMISSION) {
-                if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
+                if (usbDevice != null && usbManager.hasPermission(usbDevice)) {
                     lifecycleScope.launch(Dispatchers.Main) {
                         switchToUsbFragmentIfPossible()
                     }

From 70f20f9de83a29eb5d2d305920aad1c6e43e528c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 20:08:01 -0400
Subject: [PATCH 073/458] OpenEUICC is now GPLv3 only

We have included code originating from OpenKeychains. Our current
downstreams should all be okay with GPLv3. If not, contact me and we
might be able to figure something out (e.g. isolating GPLv3 code)
---
 LICENSE   | 833 ++++++++++++++++++++++++++++++++++++++----------------
 README.md |   2 +-
 2 files changed, 585 insertions(+), 250 deletions(-)

diff --git a/LICENSE b/LICENSE
index d159169d1..f288702d2 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,281 +1,622 @@
                     GNU GENERAL PUBLIC LICENSE
-                       Version 2, June 1991
+                       Version 3, 29 June 2007
 
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
                             Preamble
 
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Lesser General Public License instead.)  You can apply it to
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
 your programs, too.
 
   When we speak of free software, we are referring to freedom, not
 price.  Our General Public Licenses are designed to make sure that you
 have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
 
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
 
   For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
 
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
 
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
 
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
 
   The precise terms and conditions for copying, distribution and
 modification follow.
 
-                    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+                       TERMS AND CONDITIONS
 
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
+  0. Definitions.
 
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
+  "This License" refers to version 3 of the GNU General Public License.
 
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
 
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
 
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
 
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
 
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
 
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
 
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
 
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
+  1. Source Code.
 
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
 
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
 
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
 
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
 
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
 
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
+  The Corresponding Source for a work in source code form is that
+same work.
 
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
+  2. Basic Permissions.
 
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
 
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
 
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
 this License.
 
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
 otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
 
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
+  13. Use with the GNU Affero General Public License.
 
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
 
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
+  14. Revised Versions of this License.
 
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
 be similar in spirit to the present version, but may differ in detail to
 address new problems or concerns.
 
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
 
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
 
-                            NO WARRANTY
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
 
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
+  15. Disclaimer of Warranty.
 
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
 
                      END OF TERMS AND CONDITIONS
 
@@ -287,15 +628,15 @@ free software which everyone can redistribute and change under these terms.
 
   To do so, attach the following notices to the program.  It is safest
 to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
+state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
     <one line to give the program's name and a brief idea of what it does.>
     Copyright (C) <year>  <name of author>
 
-    This program is free software; you can redistribute it and/or modify
+    This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
+    the Free Software Foundation, either version 3 of the License, or
     (at your option) any later version.
 
     This program is distributed in the hope that it will be useful,
@@ -303,37 +644,31 @@ the "copyright" line and a pointer to where the full notice is found.
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
 
-    You should have received a copy of the GNU General Public License along
-    with this program; if not, write to the Free Software Foundation, Inc.,
-    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
 
-    Gnomovision version 69, Copyright (C) year name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.
 
 The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
 
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
 
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Lesser General
-Public License instead of this License.
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.
diff --git a/README.md b/README.md
index a90df38c3..7ec6c7b82 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,7 @@ Copyright 2022-2024 OpenEUICC contributors
 
 This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation, version 2.
+as published by the Free Software Foundation, version 3.
 
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of

From 3960a2d9d8578223eab0469ff6b449a6a0039104 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 20:20:32 -0400
Subject: [PATCH 074/458] ui: Add progress spinner when MainActivity is loading

---
 .../im/angry/openeuicc/ui/MainActivity.kt     | 28 +++++++++++++++----
 .../src/main/res/layout/activity_main.xml     | 10 +++++++
 2 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 46417326e..274a8ec6d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -17,6 +17,7 @@ import android.view.MenuItem
 import android.view.View
 import android.widget.AdapterView
 import android.widget.ArrayAdapter
+import android.widget.ProgressBar
 import android.widget.Spinner
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
@@ -35,6 +36,17 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private lateinit var spinnerAdapter: ArrayAdapter<String>
     private lateinit var spinnerItem: MenuItem
     private lateinit var spinner: Spinner
+    private lateinit var loadingProgress: ProgressBar
+
+    var loading: Boolean
+        get() = loadingProgress.visibility == View.VISIBLE
+        set(value) {
+            loadingProgress.visibility = if (value) {
+                View.VISIBLE
+            } else {
+                View.GONE
+            }
+        }
 
     private val fragments = arrayListOf<EuiccManagementFragment>()
 
@@ -66,11 +78,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
         setSupportActionBar(requireViewById(R.id.toolbar))
-
-        supportFragmentManager.beginTransaction().replace(
-            R.id.fragment_root,
-            appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
-        ).commit()
+        loadingProgress = requireViewById(R.id.loading)
 
         tm = telephonyManager
 
@@ -143,6 +151,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private suspend fun init() {
+        loading = true
+
         val knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
@@ -161,6 +171,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
 
         withContext(Dispatchers.Main) {
+            loading = false
+
             knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
                 fragments.add(appContainer.uiComponentFactory.createEuiccManagementFragment(channel))
@@ -175,6 +187,12 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                     spinnerItem.isVisible = true
                 }
                 supportFragmentManager.beginTransaction().replace(R.id.fragment_root, fragments.first()).commit()
+            } else {
+                // TODO: Handle cases where there is _only_ a USB reader
+                supportFragmentManager.beginTransaction().replace(
+                    R.id.fragment_root,
+                    appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
+                ).commit()
             }
         }
     }
diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index 4f1020d74..89b9d7ed4 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -14,6 +14,16 @@
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintWidth_percent="1" />
 
+    <ProgressBar
+        android:id="@+id/loading"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:indeterminate="true"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/toolbar"
+        app:layout_constraintBottom_toBottomOf="parent" />
+
     <FrameLayout
         android:id="@+id/fragment_root"
         android:layout_width="0dp"

From b67791412aaad1037c4fe60337176c3794ac884e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 21:00:30 -0400
Subject: [PATCH 075/458] ui: Decouple USB-specific logic from MainActivity
 into a dedicated fragment

---
 .../im/angry/openeuicc/ui/MainActivity.kt     |  87 ++--------
 .../openeuicc/ui/UsbCcidReaderFragment.kt     | 159 ++++++++++++++++++
 .../res/layout/fragment_usb_ccid_reader.xml   |  37 ++++
 app-common/src/main/res/values/strings.xml    |   4 +
 4 files changed, 211 insertions(+), 76 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
 create mode 100644 app-common/src/main/res/layout/fragment_usb_ccid_reader.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 274a8ec6d..f8a191586 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -1,14 +1,7 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
-import android.app.PendingIntent
-import android.content.BroadcastReceiver
-import android.content.Context
 import android.content.Intent
-import android.content.IntentFilter
-import android.hardware.usb.UsbDevice
-import android.hardware.usb.UsbManager
-import android.os.Build
 import android.os.Bundle
 import android.telephony.TelephonyManager
 import android.util.Log
@@ -19,9 +12,9 @@ import android.widget.AdapterView
 import android.widget.ArrayAdapter
 import android.widget.ProgressBar
 import android.widget.Spinner
+import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
@@ -30,7 +23,6 @@ import kotlinx.coroutines.withContext
 open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         const val TAG = "MainActivity"
-        const val ACTION_USB_PERMISSION = "im.angry.openeuicc.USB_PERMISSION"
     }
 
     private lateinit var spinnerAdapter: ArrayAdapter<String>
@@ -48,31 +40,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
 
-    private val fragments = arrayListOf<EuiccManagementFragment>()
+    private val fragments = arrayListOf<Fragment>()
 
     protected lateinit var tm: TelephonyManager
 
-    private val usbManager: UsbManager by lazy {
-        getSystemService(USB_SERVICE) as UsbManager
-    }
-
-    private var usbDevice: UsbDevice? = null
-    private var usbChannel: EuiccChannel? = null
-
-    private lateinit var usbPendingIntent: PendingIntent
-
-    private val usbPermissionReceiver = object : BroadcastReceiver() {
-        override fun onReceive(context: Context?, intent: Intent?) {
-            if (intent?.action == ACTION_USB_PERMISSION) {
-                if (usbDevice != null && usbManager.hasPermission(usbDevice)) {
-                    lifecycleScope.launch(Dispatchers.Main) {
-                        switchToUsbFragmentIfPossible()
-                    }
-                }
-            }
-        }
-    }
-
     @SuppressLint("WrongConstant", "UnspecifiedRegisterReceiverFlag")
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
@@ -83,15 +54,6 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         tm = telephonyManager
 
         spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
-
-        usbPendingIntent = PendingIntent.getBroadcast(this, 0,
-            Intent(ACTION_USB_PERMISSION), PendingIntent.FLAG_IMMUTABLE)
-        val filter = IntentFilter(ACTION_USB_PERMISSION)
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            registerReceiver(usbPermissionReceiver, filter, Context.RECEIVER_EXPORTED)
-        } else {
-            registerReceiver(usbPermissionReceiver, filter)
-        }
     }
 
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
@@ -114,11 +76,6 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                     if (position < fragments.size) {
                         supportFragmentManager.beginTransaction()
                             .replace(R.id.fragment_root, fragments[position]).commit()
-                    } else if (position == fragments.size) {
-                        // If we are at the last position, this is the USB device
-                        lifecycleScope.launch(Dispatchers.Main) {
-                            switchToUsbFragmentIfPossible()
-                        }
                     }
                 }
 
@@ -164,10 +121,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
 
-        withContext(Dispatchers.IO) {
-            val res = euiccChannelManager.enumerateUsbEuiccChannel()
-            usbDevice = res.first
-            usbChannel = res.second
+        val (usbDevice, _) = withContext(Dispatchers.IO) {
+            euiccChannelManager.enumerateUsbEuiccChannel()
         }
 
         withContext(Dispatchers.Main) {
@@ -179,16 +134,19 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
 
             // If USB readers exist, add them at the very last
-            // The adapter logic depends on this assumption
-            usbDevice?.let { spinnerAdapter.add(it.productName) }
+            // We use a wrapper fragment to handle logic specific to USB readers
+            usbDevice?.let {
+                spinnerAdapter.add(it.productName)
+                fragments.add(UsbCcidReaderFragment())
+            }
 
             if (fragments.isNotEmpty()) {
                 if (this@MainActivity::spinner.isInitialized) {
                     spinnerItem.isVisible = true
                 }
-                supportFragmentManager.beginTransaction().replace(R.id.fragment_root, fragments.first()).commit()
+                supportFragmentManager.beginTransaction()
+                    .replace(R.id.fragment_root, fragments.first()).commit()
             } else {
-                // TODO: Handle cases where there is _only_ a USB reader
                 supportFragmentManager.beginTransaction().replace(
                     R.id.fragment_root,
                     appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
@@ -196,27 +154,4 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
     }
-
-    private suspend fun switchToUsbFragmentIfPossible() {
-        if (usbDevice != null && usbChannel == null) {
-            if (!usbManager.hasPermission(usbDevice)) {
-                usbManager.requestPermission(usbDevice, usbPendingIntent)
-                return
-            }  else {
-               val (device, channel) = withContext(Dispatchers.IO) {
-                    euiccChannelManager.enumerateUsbEuiccChannel()
-                }
-
-                if (device != null && channel != null) {
-                    usbDevice = device
-                    usbChannel = channel
-                }
-            }
-        }
-
-        if (usbChannel != null) {
-            supportFragmentManager.beginTransaction().replace(R.id.fragment_root,
-                appContainer.uiComponentFactory.createEuiccManagementFragment(usbChannel!!)).commit()
-        }
-    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
new file mode 100644
index 000000000..4660d97d2
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -0,0 +1,159 @@
+package im.angry.openeuicc.ui
+
+import android.annotation.SuppressLint
+import android.app.PendingIntent
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import android.content.IntentFilter
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbManager
+import android.os.Build
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.Button
+import android.widget.TextView
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.commit
+import androidx.lifecycle.lifecycleScope
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
+
+/**
+ * A wrapper fragment over EuiccManagementFragment where we handle
+ * logic specific to USB devices. This is mainly USB permission
+ * requests, and the fact that USB devices may or may not be
+ * available by the time the user selects it from MainActivity.
+ *
+ * Having this fragment allows MainActivity to be (mostly) agnostic
+ * of the underlying implementation of different types of channels.
+ * When permission is granted, this fragment will simply load
+ * EuiccManagementFragment using its own childFragmentManager.
+ *
+ * Note that for now we assume there will only be one USB card reader
+ * device. This is also an implicit assumption in EuiccChannelManager.
+ */
+class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
+    companion object {
+        const val ACTION_USB_PERMISSION = "im.angry.openeuicc.USB_PERMISSION"
+    }
+
+    private val euiccChannelManager: EuiccChannelManager by lazy {
+        (requireActivity() as MainActivity).euiccChannelManager
+    }
+
+    private val usbManager: UsbManager by lazy {
+        requireContext().getSystemService(Context.USB_SERVICE) as UsbManager
+    }
+
+    private val usbPermissionReceiver = object : BroadcastReceiver() {
+        override fun onReceive(context: Context?, intent: Intent?) {
+            if (intent?.action == ACTION_USB_PERMISSION) {
+                if (usbDevice != null && usbManager.hasPermission(usbDevice)) {
+                    lifecycleScope.launch(Dispatchers.Main) {
+                        tryLoadUsbChannel()
+                    }
+                }
+            }
+        }
+    }
+
+    private lateinit var usbPendingIntent: PendingIntent
+
+    private lateinit var text: TextView
+    private lateinit var permissionButton: Button
+
+    private var usbDevice: UsbDevice? = null
+    private var usbChannel: EuiccChannel? = null
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_usb_ccid_reader, container, false)
+
+        text = view.requireViewById(R.id.usb_reader_text)
+        permissionButton = view.requireViewById(R.id.usb_grant_permission)
+
+        permissionButton.setOnClickListener {
+            usbManager.requestPermission(usbDevice, usbPendingIntent)
+        }
+
+        return view
+    }
+
+    @SuppressLint("UnspecifiedRegisterReceiverFlag", "WrongConstant")
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+
+        usbPendingIntent = PendingIntent.getBroadcast(
+            requireContext(), 0,
+            Intent(ACTION_USB_PERMISSION), PendingIntent.FLAG_IMMUTABLE
+        )
+        val filter = IntentFilter(ACTION_USB_PERMISSION)
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            requireContext().registerReceiver(
+                usbPermissionReceiver,
+                filter,
+                Context.RECEIVER_EXPORTED
+            )
+        } else {
+            requireContext().registerReceiver(usbPermissionReceiver, filter)
+        }
+
+        lifecycleScope.launch(Dispatchers.Main) {
+            tryLoadUsbChannel()
+        }
+    }
+
+    override fun onDetach() {
+        super.onDetach()
+        requireContext().unregisterReceiver(usbPermissionReceiver)
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        requireContext().unregisterReceiver(usbPermissionReceiver)
+    }
+
+    private suspend fun tryLoadUsbChannel() {
+        text.visibility = View.GONE
+        permissionButton.visibility = View.GONE
+
+        (requireActivity() as MainActivity).loading = true
+
+        val (device, channel) = withContext(Dispatchers.IO) {
+            euiccChannelManager.enumerateUsbEuiccChannel()
+        }
+
+        (requireActivity() as MainActivity).loading = false
+
+        usbDevice = device
+        usbChannel = channel
+
+        if (device != null && channel == null && !usbManager.hasPermission(device)) {
+            text.text = getString(R.string.usb_permission_needed)
+            text.visibility = View.VISIBLE
+            permissionButton.visibility = View.VISIBLE
+        } else if (device != null && channel != null) {
+            childFragmentManager.commit {
+                replace(
+                    R.id.child_container,
+                    appContainer.uiComponentFactory.createEuiccManagementFragment(channel)
+                )
+            }
+        } else {
+            text.text = getString(R.string.usb_failed)
+            text.visibility = View.VISIBLE
+            permissionButton.visibility = View.GONE
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml b/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml
new file mode 100644
index 000000000..1207990d5
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <TextView
+        android:id="@+id/usb_reader_text"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="40dp"
+        android:gravity="center"
+        android:visibility="gone"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+    <Button
+        android:id="@+id/usb_grant_permission"
+        android:text="@string/usb_permission"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="20dp"
+        android:visibility="gone"
+        app:layout_constraintTop_toBottomOf="@id/usb_reader_text"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+    <FrameLayout
+        android:id="@+id/child_container"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintStart_toStartOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index c42e5da56..3e66d381b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -25,6 +25,10 @@
     <string name="slot_select">Select Slot</string>
     <string name="slot_select_select">Select</string>
 
+    <string name="usb_permission">Grant USB permission</string>
+    <string name="usb_permission_needed">Permission is needed to access the USB smart card reader.</string>
+    <string name="usb_failed">Cannot connect to eSIM via a USB smart card reader.</string>
+
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>
     <string name="profile_download_code">Activation Code</string>

From 0a971b68b21e29793841a3fb5c777415b9c5f1a8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 21:01:18 -0400
Subject: [PATCH 076/458] ProfileDownloadFragment: Do not crash for USB
 channels

---
 .../main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index bb406e246..f8399a914 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -151,7 +151,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         super.onStart()
         profileDownloadIMEI.editText!!.text = Editable.Factory.getInstance().newEditable(
             try {
-                telephonyManager.getImei(channel.logicalSlotId)
+                telephonyManager.getImei(channel.logicalSlotId) ?: ""
             } catch (e: Exception) {
                 ""
             }

From d1d85161ccf25f29ab9090a6065200490b2769fa Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 30 Jun 2024 21:10:41 -0400
Subject: [PATCH 077/458] fix: USB CCID channels do not need reconnects on
 switch

---
 .../core/DefaultEuiccChannelManager.kt        |  2 +
 .../openeuicc/ui/EuiccManagementFragment.kt   | 43 +++++++++++--------
 2 files changed, 27 insertions(+), 18 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 09559598a..b943820a0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -160,6 +160,8 @@ open class DefaultEuiccChannelManager(
         }
 
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
+        if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) return
+
         // If there is already a valid channel, we close it proactively
         // Sometimes the current channel can linger on for a bit even after it should have become invalid
         channelCache.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 6aa1acedb..b83b241b2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -25,6 +25,7 @@ import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import com.google.android.material.floatingactionbutton.FloatingActionButton
 import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
@@ -158,7 +159,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     return@beginTrackedOperation false
                 }
 
-                if (!refreshed) {
+                if (!refreshed && channel.slotId != EuiccChannelManager.USB_CHANNEL_ID) {
                     withContext(Dispatchers.Main) {
                         AlertDialog.Builder(requireContext()).apply {
                             setMessage(R.string.switch_did_not_refresh)
@@ -175,26 +176,32 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     return@beginTrackedOperation true
                 }
 
-                try {
-                    euiccChannelManager.waitForReconnect(slotId, portId, timeoutMillis = 30 * 1000)
-                } catch (e: TimeoutCancellationException) {
-                    withContext(Dispatchers.Main) {
-                        // Prevent this Fragment from being used again
-                        invalid = true
-                        // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
-                        AlertDialog.Builder(requireContext()).apply {
-                            setMessage(R.string.enable_disable_timeout)
-                            setPositiveButton(android.R.string.ok) { dialog, _ ->
-                                dialog.dismiss()
-                                requireActivity().finish()
+                if (channel.slotId != EuiccChannelManager.USB_CHANNEL_ID) {
+                    try {
+                        euiccChannelManager.waitForReconnect(
+                            slotId,
+                            portId,
+                            timeoutMillis = 30 * 1000
+                        )
+                    } catch (e: TimeoutCancellationException) {
+                        withContext(Dispatchers.Main) {
+                            // Prevent this Fragment from being used again
+                            invalid = true
+                            // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
+                            AlertDialog.Builder(requireContext()).apply {
+                                setMessage(R.string.enable_disable_timeout)
+                                setPositiveButton(android.R.string.ok) { dialog, _ ->
+                                    dialog.dismiss()
+                                    requireActivity().finish()
+                                }
+                                setOnDismissListener { _ ->
+                                    requireActivity().finish()
+                                }
+                                show()
                             }
-                            setOnDismissListener { _ ->
-                                requireActivity().finish()
-                            }
-                            show()
                         }
+                        return@beginTrackedOperation false
                     }
-                    return@beginTrackedOperation false
                 }
 
                 if (enable) {

From bc238cc6802a517c5788e26579f31615686f2939 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 13:28:20 -0400
Subject: [PATCH 078/458] Add VTuber-style logo courtesy of Aikoyori

---
 README.md                |   9 +--
 art/OpenEUICCBG.png      | Bin 0 -> 226129 bytes
 art/OpenEUICCBG.svg      | 115 +++++++++++++++++++++++++++++++++++++
 art/OpenEUICCSVG.png     | Bin 0 -> 193433 bytes
 art/OpenEUICCSVG.svg     | 112 ++++++++++++++++++++++++++++++++++++
 art/OpenEUICCThicken.png | Bin 0 -> 272558 bytes
 art/OpenEUICCThicken.svg | 119 +++++++++++++++++++++++++++++++++++++++
 7 files changed, 351 insertions(+), 4 deletions(-)
 create mode 100644 art/OpenEUICCBG.png
 create mode 100644 art/OpenEUICCBG.svg
 create mode 100644 art/OpenEUICCSVG.png
 create mode 100644 art/OpenEUICCSVG.svg
 create mode 100644 art/OpenEUICCThicken.png
 create mode 100644 art/OpenEUICCThicken.svg

diff --git a/README.md b/README.md
index 7ec6c7b82..dc0fe56d5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,4 @@
-{Open,Easy}EUICC
----
+![](art/OpenEUICCBG.png)
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 
@@ -78,7 +77,7 @@ FAQs
 Copyright
 ===
 
-Everything except `libs/lpac-jni`:
+Everything except `libs/lpac-jni` and `art/`:
 
 ```
 Copyright 2022-2024 OpenEUICC contributors
@@ -114,4 +113,6 @@ Lesser General Public License for more details.
 You should have received a copy of the GNU Lesser General Public
 License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-```
\ No newline at end of file
+```
+
+`art/`: Courtesy of [Aikoyori](https://github.com/Aikoyori), CC NC-SA 4.0.
\ No newline at end of file
diff --git a/art/OpenEUICCBG.png b/art/OpenEUICCBG.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e4d02d217b2fe842fb53b101b9636aced787a66
GIT binary patch
literal 226129
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%0A$QOz
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

literal 0
HcmV?d00001

diff --git a/art/OpenEUICCBG.svg b/art/OpenEUICCBG.svg
new file mode 100644
index 000000000..6346f3103
--- /dev/null
+++ b/art/OpenEUICCBG.svg
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 1529 897" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-536,-454)">
+        <g id="OpenEUICCBG">
+            <path id="OpenEUICCSVG" d="M536.536,813.239C536.333,799.556 537.449,785.146 540.07,770.087L540.153,769.618C555.219,686.95 626.809,636.372 700.624,624.894C797.308,609.86 859.29,659.193 890.537,714.163C891.854,714.184 893.169,714.27 894.478,714.421L895.05,714.487L898.248,714.944L904.056,715.933L903.375,714.712C901.981,712.211 900.859,709.567 900.03,706.827L898.252,700.956C897.441,698.275 896.913,695.515 896.678,692.724L896.173,686.737C895.942,683.995 895.995,681.237 896.33,678.506C896.33,678.506 896.356,678.356 896.356,678.354C896.34,676.293 896.35,674.158 896.385,672.18L896.217,670.083C895.909,666.217 896.164,662.326 896.976,658.533L898.725,650.358C899.539,646.549 900.906,642.88 902.781,639.467L906.877,632.012C908.803,628.506 911.244,625.309 914.118,622.527L920.427,616.422C921.88,615.016 923.438,613.722 925.087,612.551L1070.48,509.323C1071.55,508.561 1072.66,507.853 1073.81,507.201L1078.77,504.366C1081.05,503.067 1083.45,501.994 1085.93,501.164L1091.31,499.37C1093.78,498.544 1096.33,497.962 1098.92,497.632L1104.54,496.916C1107.13,496.585 1109.76,496.51 1112.38,496.693L1118.08,497.091C1120.71,497.274 1123.31,497.717 1125.85,498.412L1131.37,499.921C1133.89,500.612 1136.35,501.551 1138.69,502.723L1143.76,505.255C1146.09,506.422 1148.31,507.814 1150.37,509.411L1154.85,512.879C1156.92,514.484 1158.83,516.289 1160.55,518.268L1164.3,522.584C1165.16,523.578 1165.97,524.613 1166.73,525.687L1187.07,554.371C1187.67,553.451 1188.29,552.541 1188.93,551.641C1204.06,530.421 1222.61,511.867 1243.83,496.738C1255.92,488.122 1269.89,483.206 1284.16,482.113C1298.42,481.019 1312.98,483.748 1326.24,490.421L1327.4,491.005L1328.12,489.918C1336.26,477.511 1347.51,467.868 1360.41,461.681C1366.86,458.589 1373.72,456.361 1380.82,455.083L1402.64,454.185C1428.59,456.676 1453.93,463.468 1477.64,474.281C1504.65,486.597 1522.62,512.855 1524.32,542.491L1524.39,543.789L1525.69,543.863C1527.51,543.968 1529.33,544.197 1531.12,544.549L1541.83,546.656C1543.63,547.009 1545.39,547.484 1547.12,548.078C1553.94,550.423 1560.39,553.671 1566.29,557.71C1572.19,561.75 1577.56,566.581 1582.21,572.089C1583.39,573.485 1584.47,574.96 1585.45,576.503L1591.3,585.728C1592.27,587.271 1593.14,588.878 1593.9,590.539C1604.71,614.251 1611.51,639.597 1614,665.538C1614.04,666.013 1614.08,670.473 1614.11,676.425C1614.66,676.516 1615.21,676.614 1615.76,676.717C1622.8,678.035 1629.65,680.295 1636.13,683.46C1637.77,684.262 1639.36,685.175 1640.87,686.194L1649.94,692.281C1651.46,693.299 1652.9,694.419 1654.26,695.634L1655.23,696.499L1656.2,695.634C1678.36,675.88 1709.63,670.018 1737.44,680.407C1761.85,689.528 1784.58,702.648 1804.68,719.229C1805.96,720.283 1807.17,721.415 1808.31,722.619L1815.12,729.826C1817.38,732.218 1819.33,734.879 1820.94,737.749L1825.7,746.248C1826.5,747.668 1827.2,749.135 1827.82,750.642C1830.28,756.64 1832,762.929 1832.94,769.368C1833.18,770.995 1833.32,772.634 1833.35,774.277L1833.5,780.947L1833.58,780.943L1833.58,784.984C1833.58,786.611 1833.48,788.216 1833.29,789.793C1833.25,792.629 1833.19,795.732 1833.12,798.888C1861.29,808.208 1881.99,832.353 1886.89,861.617C1889.17,875.193 1890.24,888.919 1890.11,902.617C1890.11,903.534 1890.12,905.339 1890.12,907.571C1912.02,906.503 1934.46,908.86 1956.42,914.38C1993.53,923.711 2025.76,942.33 2047,965.404L2048.59,967.195C2049.79,968.615 2050.89,970.116 2051.89,971.689L2055.78,977.823C2057.5,980.551 2058.89,983.478 2059.92,986.54L2061.87,992.378C2062.71,994.891 2063.3,997.481 2063.63,1000.11L2064.35,1005.86C2064.66,1008.4 2064.74,1010.97 2064.56,1013.52C2064.56,1013.52 2064.46,1014.76 2064.34,1016.21C2064.31,1031.38 2062.96,1065.08 2062.57,1066.62C2062.08,1068.58 2061.44,1070.49 2060.66,1072.35L2057.28,1080.4C2056.4,1082.5 2055.34,1084.52 2054.12,1086.44L2053.5,1087.38L2033.23,1117.86C2033.73,1119.16 2034.17,1120.5 2034.54,1121.88C2034.54,1121.88 2046.03,1164.4 2046.08,1164.58C2046.36,1165.64 2046.6,1166.72 2046.8,1167.81L2048.18,1175.58C2048.74,1178.71 2048.93,1181.88 2048.73,1185.05C2048.73,1185.05 2048.66,1186.1 2048.56,1187.35C2048.56,1201.13 2047.2,1237.58 2046.83,1239.06C2046.44,1240.58 2045.97,1242.08 2045.42,1243.54L2043.05,1249.76C2041.94,1252.68 2040.49,1255.45 2038.74,1258.03L2034.97,1263.57C2032.82,1266.73 2030.23,1269.56 2027.28,1271.98L2018.06,1279.55C2016.53,1280.81 2014.91,1281.95 2013.21,1282.97C1959.08,1315.35 1904.09,1320.87 1856.9,1309C1840.78,1304.95 1825.53,1298.85 1811.45,1291.02C1767.76,1332.79 1717.43,1350.45 1670.23,1350.45C1619.77,1350.45 1572.48,1330.34 1538.45,1296.02C1535.74,1297.66 1532.85,1298.98 1529.82,1299.94L1524.74,1301.55C1522.15,1302.38 1519.48,1302.94 1516.77,1303.22L1511.27,1303.79C1509.89,1303.94 1508.5,1304.01 1507.11,1304.01L1443.47,1304.01C1442.08,1304.01 1440.69,1303.94 1439.31,1303.79L1433.81,1303.22C1431.1,1302.94 1428.43,1302.38 1425.84,1301.55L1420.76,1299.94C1417.08,1298.77 1413.59,1297.07 1410.4,1294.9L1401.98,1289.18C1400.54,1288.2 1399.16,1287.13 1397.86,1285.97C1357.12,1328.06 1296.58,1342.84 1240.54,1333.13C1206.4,1327.21 1174.6,1312.23 1149.97,1289.62C1149.59,1289.74 1149.21,1289.85 1148.83,1289.96L1143.56,1291.43C1142.27,1291.79 1140.97,1292.09 1139.66,1292.32L1138.62,1292.49L1067.56,1303.64C1066.16,1304.02 1064.73,1304.32 1063.27,1304.54L1007.7,1313.12L1004.65,1313.51L1004.07,1313.57C1002.59,1313.72 1001.09,1313.79 999.598,1313.78L993.857,1313.72C990.969,1313.69 988.093,1313.35 985.278,1312.7L979.999,1311.48C976.234,1310.61 972.615,1309.2 969.254,1307.3L960.698,1302.44C956.626,1300.14 952.99,1297.13 949.957,1293.56L943.977,1286.53C941.012,1283.04 938.667,1279.07 937.045,1274.79L933.645,1265.82C932.807,1263.61 932.167,1261.33 931.732,1259L931.422,1257.19L910.096,1120.16L905.372,1120.45C903.044,1120.59 900.708,1120.52 898.391,1120.26L895.129,1119.79L838.271,1110.04C836.63,1109.76 835.03,1109.38 833.475,1108.91L831.916,1108.56C829.156,1107.93 826.471,1107.01 823.906,1105.81L819.231,1103.63C815.691,1101.98 812.411,1099.82 809.497,1097.21L802.283,1090.77C798.547,1087.43 795.471,1083.42 793.215,1078.95L788.899,1070.4C787.196,1067.02 785.98,1063.42 785.288,1059.7L784.37,1054.78C783.886,1052.18 783.66,1049.54 783.698,1046.89L783.77,1041.7C783.778,1041.17 783.796,1040.63 783.825,1040.1L783.773,1037.25C783.755,1036.28 783.773,1035.32 783.825,1034.36L783.773,1031.51C783.755,1030.54 783.773,1029.58 783.825,1028.62L783.773,1025.76C783.755,1024.8 783.773,1023.84 783.825,1022.87L783.798,1021.42C771.651,1025.96 759.457,1029.2 747.62,1031.04C650.746,1046.11 555.311,987.041 538.86,881.245C537.17,870.379 536.36,858.979 536.536,847.113C536.51,841.88 536.509,818.522 536.536,813.239ZM1747.57,1128.43L1746.11,1129.87L1746.55,1129.79L1747.57,1129.93C1747.57,1129.43 1747.57,1128.93 1747.57,1128.43ZM1725.91,1137.76C1726.11,1138.18 1726.32,1138.59 1726.52,1139C1726.88,1138.63 1727.25,1138.25 1727.6,1137.87L1727.25,1137.94L1725.91,1137.76ZM1186.12,735.525L1184.79,736.677L1179.35,740.53C1181.69,740.656 1183.97,740.843 1186.19,741.087C1186.16,740.711 1186.14,738.591 1186.12,735.525ZM904.625,695.316C900.099,689.396 897.181,682.157 896.548,674.224L896.496,673.569C897.027,682.963 900.236,690.019 904.625,695.316ZM543.965,836.24C539.416,829.87 536.686,822.105 536.543,813.698C536.686,823.387 539.677,830.711 543.965,836.24Z" style="fill:rgb(253,230,138);"/>
+            <g id="OpenEUICCSVG1" serif:id="OpenEUICCSVG">
+                <g id="Sim" transform="matrix(0.785112,1.10765,-1.10765,0.785112,658.755,-1281.43)">
+                    <g transform="matrix(1.20427,0,2.22045e-16,1.44928,-38.8349,-460.554)">
+                        <path d="M1109.4,779.255C1107.87,778.394 1106.09,777.339 1104.71,776.471L1104.7,776.469L1102.52,775.389L1099.06,772.262L1096.79,768.373L1095.97,763.963L1095.89,673.341L1096.23,670.449L1097.23,667.695L1098.86,665.155L1101.08,662.908L1103.78,661.065L1106.84,659.709L1110.15,658.872L1113.63,658.585L1182.83,658.585L1186.42,658.89L1189.83,659.779L1192.95,661.218C1192.95,661.218 1193.81,661.826 1193.81,661.828C1194.56,662.274 1202.69,667.135 1203.24,667.613L1220.41,682.619L1222.5,684.831L1224.03,687.308L1224.98,689.981L1225.3,692.779L1225.3,768.395L1224.94,771.356L1223.9,774.138L1222.26,776.646L1220.1,778.821L1217.48,780.615L1214.46,781.976L1211.12,782.84L1207.55,783.139L1121.26,783.139L1117.44,782.795L1113.89,781.807L1110.72,780.256C1110.72,780.256 1109.4,779.257 1109.4,779.255Z" style="fill:rgb(80,7,36);"/>
+                    </g>
+                    <g transform="matrix(1.20427,0,0,1.44928,-38.8349,-460.554)">
+                        <path d="M1111.62,768.187C1109.62,767.502 1108.21,765.865 1108.2,763.955L1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1186.83,670.173 1193.92,674.225 1194.37,674.617L1211.55,689.624C1212.52,690.475 1213.07,691.605 1213.07,692.779L1213.07,768.395C1213.07,770.925 1210.6,772.975 1207.55,772.975L1121.26,772.975C1119.63,772.975 1118.16,772.385 1117.15,771.447C1116.38,771.181 1112.17,768.698 1111.62,768.187Z" style="fill:rgb(190,24,93);"/>
+                    </g>
+                    <g transform="matrix(1.20427,0,1.11022e-16,1.44928,-38.8349,-460.554)">
+                        <path d="M1204,685.179C1204.98,686.031 1205.52,687.16 1205.52,688.335L1205.52,763.951C1205.52,766.48 1203.05,768.531 1200.01,768.531L1113.72,768.531C1110.67,768.531 1108.21,766.483 1108.2,763.955C1108.19,747.298 1108.14,690.002 1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1190.67,673.533 1200.27,681.919 1204,685.179Z" style="fill:rgb(244,63,94);"/>
+                    </g>
+                    <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                        <path d="M1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,613.249C1553.44,618.429 1549.29,622.628 1544.17,622.628C1527.95,622.628 1494.61,622.628 1478.39,622.628C1473.27,622.628 1469.12,618.429 1469.12,613.249L1469.12,522.748C1469.12,517.568 1473.27,513.37 1478.39,513.37L1544.17,513.37Z" style="fill:rgb(255,209,0);"/>
+                    </g>
+                    <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                        <path d="M1469.24,614.766C1469.16,614.272 1469.12,613.766 1469.12,613.249L1469.12,567.058L1522.19,513.37L1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,529.581L1469.24,614.766Z" style="fill:rgb(255,243,138);"/>
+                    </g>
+                    <g transform="matrix(1,-5.55112e-17,5.55112e-17,1,-676.337,255.223)">
+                        <path d="M2010.77,311.863C2009.48,312.543 2003.51,316.132 2002.59,316.644C2001.38,317.313 1999.86,316.877 1999.19,315.671C1998.52,314.464 1998.96,312.941 2000.17,312.272C2000.92,311.854 2001.66,311.419 2002.4,310.979L2002.4,274.565C2002.4,273.185 2003.52,272.065 2004.9,272.065C2006.28,272.065 2007.4,273.185 2007.4,274.565L2007.4,308.007C2007.75,307.811 2008.1,307.621 2008.45,307.437C2011.52,305.821 2014.64,304.694 2017.95,304.671C2022.22,304.642 2026.42,306.561 2030.64,308.867L2030.64,274.565C2030.64,273.185 2031.76,272.065 2033.14,272.065C2034.52,272.065 2035.64,273.185 2035.64,274.565L2035.64,311.664C2039.1,313.557 2042.63,315.118 2046.37,315.118C2054.72,315.118 2061.73,308.414 2061.73,308.414C2062.83,307.579 2064.4,307.793 2065.23,308.891C2066.07,309.99 2065.86,311.56 2064.76,312.395C2064.76,312.395 2056.58,319.964 2046.45,320.118C2040.93,320.202 2035.72,317.467 2030.66,314.605C2026.4,312.193 2022.27,309.642 2017.99,309.671C2015.46,309.689 2013.12,310.633 2010.77,311.863ZM2002.4,351.73C1998.65,349.472 1994.72,347.293 1990.06,347.204C1983.86,347.085 1977.25,354.288 1977.25,354.288C1976.4,355.379 1974.83,355.578 1973.74,354.733C1972.65,353.888 1972.45,352.317 1973.3,351.226C1973.3,351.226 1981.5,342.039 1990.16,342.205C1995.95,342.316 2000.87,344.972 2005.52,347.774L2006.76,348.528C2010.47,350.797 2014.01,353.011 2017.99,353.038C2022.27,353.068 2026.4,350.517 2030.66,348.105C2035.72,345.243 2040.93,342.508 2046.45,342.592C2055.63,342.731 2064.52,348.783 2064.52,348.783C2065.62,349.618 2065.83,351.188 2064.99,352.286C2064.16,353.384 2062.59,353.598 2061.49,352.763C2061.49,352.763 2054.12,347.591 2046.37,347.591C2042.63,347.591 2039.1,349.153 2035.64,351.045L2035.64,388.469C2035.64,389.848 2034.52,390.969 2033.14,390.969C2031.76,390.969 2030.64,389.848 2030.64,388.469L2030.64,353.842C2026.42,356.148 2022.22,358.067 2017.95,358.038C2014.27,358.013 2010.83,356.574 2007.4,354.682L2007.4,388.469C2007.4,389.848 2006.28,390.969 2004.9,390.969C2003.52,390.969 2002.4,389.848 2002.4,388.469L2002.4,351.73ZM1973,310.59C1972.15,309.499 1972.35,307.927 1973.44,307.082C1974.53,306.237 1976.11,306.436 1976.95,307.527C1976.95,307.527 1982.05,313.224 1985.65,314.67C1986.93,315.185 1987.55,316.642 1987.03,317.922C1986.52,319.202 1985.06,319.824 1983.78,319.309C1978.86,317.332 1973,310.59 1973,310.59Z" style="fill:rgb(154,78,3);"/>
+                    </g>
+                </g>
+                <g id="Cogs">
+                    <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                        <path d="M713.5,735.152L713.524,735.11C719.147,725.132 725.647,715.652 732.959,706.786C742.403,695.336 757.41,690.056 771.943,693.07C771.943,693.07 789.986,696.813 800.929,699.083C801.619,698.652 802.312,698.226 803.008,697.805L805.605,689.944C806.386,687.579 822.308,659.429 823.248,658.126L821.227,661.626L826.328,653.226C828.346,650.673 830.664,648.38 833.228,646.395L841.6,641.415L851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C937.664,649.993 940.067,652.685 942.082,655.676L946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577L1068.16,772.222L1068.04,781.962C1067.6,785.174 1066.77,788.329 1065.57,791.353L1060.85,799.971L1062.87,796.471C1062.21,797.936 1045.79,825.8 1044.13,827.659C1044.13,827.659 1041.84,830.237 1038.62,833.837C1038.61,834.651 1038.59,835.465 1038.56,836.277L1058.26,858.374C1068.13,869.453 1071.07,885.089 1065.87,898.993C1061.85,909.77 1056.88,920.151 1051.05,930.004C1049.68,932.395 1040.32,948.617 1039,950.881C1033.37,960.874 1026.86,970.368 1019.54,979.247C1010.09,990.697 995.086,995.977 980.553,992.963C980.553,992.963 962.509,989.22 951.566,986.95C950.877,987.381 950.184,987.807 949.488,988.227L946.891,996.089L941.354,1006.94L943.375,1003.44C942.724,1004.89 930.161,1026.64 929.248,1027.91L931.269,1024.41L926.168,1032.81C924.15,1035.36 921.832,1037.65 919.268,1039.64L910.896,1044.62L901.397,1047.45C880.072,1051.03 858.3,1051.03 836.975,1047.45C822.337,1045 810.261,1034.64 805.605,1020.55C805.605,1020.55 799.825,1003.05 796.319,992.442C793.084,990.724 789.911,988.892 786.806,986.95L757.819,992.963C743.286,995.977 728.279,990.697 718.836,979.247C705.078,962.565 694.192,943.711 686.625,923.456L684.332,913.811L684.459,904.07C684.896,900.858 685.722,897.704 686.924,894.679L691.649,886.062L689.629,889.562C690.268,888.138 702.827,866.381 703.755,865.094L701.735,868.593L708.362,858.374C708.362,858.374 710.661,855.796 713.872,852.195C713.888,851.382 713.91,850.568 713.939,849.755L694.238,827.659L688.151,818.592C686.569,815.351 685.439,811.924 684.78,808.409C684.121,804.893 683.933,801.289 684.234,797.696L686.625,787.04C690.651,776.263 695.618,765.881 701.447,756.028C702.804,753.652 712.07,737.603 713.5,735.152Z" style="fill:rgb(80,7,36);"/>
+                    </g>
+                    <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                        <path d="M730.855,745.094C735.921,736.08 741.787,727.517 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C809.701,717.064 814.558,714.064 819.587,711.38L824.596,696.218C825.246,694.249 838.687,670.91 839.469,669.825C842.19,663.773 847.771,659.415 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.49,775.877 1048.51,782.89 1044.62,788.272C1044.08,789.492 1030.59,812.801 1029.21,814.349C1029.21,814.349 1024.16,820.008 1018.58,826.268C1018.77,831.965 1018.6,837.671 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1043.5,901.713 1039.02,911.074 1033.75,919.97C1033.09,921.142 1022.33,939.781 1021.64,940.938C1016.57,949.953 1010.71,958.516 1004.11,966.522C999.385,972.247 991.882,974.887 984.615,973.379C984.615,973.379 947.449,965.67 947.449,965.67C942.795,968.969 937.938,971.969 932.909,974.653L927.9,989.815C927.25,991.784 926.31,993.607 925.133,995.239C924.575,996.48 913.809,1015.12 913.027,1016.21C910.306,1022.26 904.725,1026.62 898.091,1027.73C878.955,1030.94 859.418,1030.94 840.281,1027.73C832.962,1026.5 826.924,1021.33 824.596,1014.28C824.596,1014.28 812.689,978.237 812.69,978.237C805.06,974.732 797.773,970.525 790.923,965.67L753.757,973.379C746.49,974.887 738.987,972.247 734.265,966.522C721.919,951.552 712.151,934.633 705.36,916.456C703.006,910.155 703.989,903.143 707.871,897.761C708.419,896.541 719.181,877.895 719.977,876.792C720.802,874.957 721.91,873.231 723.29,871.684C723.29,871.684 728.336,866.024 733.917,859.765C733.727,854.068 733.897,848.362 734.426,842.681L709.167,814.349C704.228,808.81 702.763,800.992 705.36,794.04C708.992,784.319 713.475,774.958 718.748,766.063C719.408,764.89 730.169,746.252 730.855,745.094ZM847.058,755.4C844.88,760.245 840.846,764.055 835.817,765.934C825.907,769.636 816.683,774.962 808.522,781.692C803.845,785.549 797.671,787.077 791.735,785.846C791.735,785.846 778.919,783.187 769.09,781.148L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.164,851.838 788.882,857.237 785.775,861.545C785.225,862.768 771.731,886.08 770.356,887.622C770.356,887.622 767.776,890.516 764.346,894.363C766.704,898.775 769.307,903.055 772.143,907.181L805.859,900.187C807.17,899.915 808.493,899.778 809.809,899.77C800.487,887.364 794.962,871.946 794.962,855.248C794.962,841.044 798.96,827.767 805.891,816.481C806.533,815.297 815.277,800.152 815.98,799.008C816.622,797.823 817.294,796.658 817.998,795.513C830.557,772.324 855.107,756.56 883.31,756.56C886.308,756.56 889.264,756.738 892.169,757.085C891.522,755.946 890.983,754.738 890.565,753.472L879.763,720.776C874.772,720.384 869.765,720.269 864.764,720.433L861.931,729.009C861.284,730.97 847.842,754.313 847.058,755.4ZM860.327,928.948C860.974,930.086 861.513,931.295 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C877.724,965.649 882.731,965.763 887.732,965.599L890.565,957.024C891.212,955.063 902.636,935.215 903.42,934.127C903.976,932.89 904.654,931.72 905.438,930.633C907.616,925.788 911.65,921.978 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 973.577,902.845 983.406,904.884L968.016,887.622C963.981,883.096 962.217,876.986 963.219,871.006C964.968,860.574 964.968,849.922 963.219,839.489C962.332,834.194 963.614,828.796 966.721,824.487C967.27,823.265 980.765,799.952 982.14,798.411C982.14,798.411 984.72,795.516 988.15,791.67C985.791,787.257 983.189,782.978 980.353,778.852L946.637,785.846C945.326,786.118 944.003,786.255 942.687,786.263C952.008,798.669 957.534,814.087 957.534,830.785C957.534,844.989 953.536,858.266 946.605,869.552C945.963,870.736 935.201,889.375 934.498,890.52C921.939,913.709 897.389,929.472 869.186,929.472C866.188,929.472 863.232,929.294 860.327,928.948ZM903.248,858.597C903.356,857.495 903.411,856.378 903.411,855.248C903.411,836.359 888.075,821.024 869.186,821.024C861.749,821.024 854.864,823.401 849.248,827.436C849.14,828.538 849.085,829.655 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C890.747,865.009 897.632,862.632 903.248,858.597Z" style="fill:rgb(190,24,93);"/>
+                    </g>
+                    <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                        <path d="M792.854,697.408L795.347,689.863C797.63,682.952 801.697,676.94 806.966,672.326C811.488,667.744 823.043,656.19 827.618,651.675C833.598,644.848 841.835,640.131 851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C940.38,652.322 944.563,658.434 946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577C1071.07,776.48 1068.13,792.117 1058.26,803.195C1058.26,803.195 1046,816.95 1038.56,825.292C1038.69,828.953 1038.69,832.617 1038.56,836.277L1058.26,858.374L1064.35,867.441C1065.93,870.682 1067.06,874.109 1067.72,877.624C1068.38,881.14 1068.56,884.743 1068.26,888.337L1065.87,898.993C1058.3,919.248 1047.42,938.102 1033.66,954.784C1032.84,955.781 1007.48,981.175 1006.61,981.916L1008.83,979.7L1000.82,986.853C997.886,988.839 994.707,990.418 991.376,991.559C988.045,992.699 984.563,993.401 981.02,993.632L970.295,992.882C970.295,992.882 959.382,990.618 949.383,988.544L946.891,996.089C944.608,1003 940.54,1009.01 935.271,1013.63C930.749,1018.21 919.195,1029.76 914.619,1034.28C908.64,1041.1 900.402,1045.82 891.138,1047.37C869.813,1050.95 848.042,1050.95 826.717,1047.37L816.293,1044.12C813.03,1042.58 810.003,1040.62 807.288,1038.29C804.573,1035.96 802.17,1033.27 800.155,1030.28L795.347,1020.47C795.347,1020.47 789.566,1002.97 786.061,992.362C782.825,990.643 779.652,988.811 776.547,986.869L747.56,992.882C733.028,995.896 718.02,990.616 708.577,979.166C694.819,962.485 683.934,943.63 676.366,923.375L673.976,912.719C673.674,909.126 673.862,905.522 674.521,902.007C675.18,898.491 676.31,895.064 677.892,891.823L683.98,882.757C683.98,882.757 696.243,869.002 703.68,860.66C703.551,856.999 703.551,853.335 703.68,849.675L683.98,827.578C679.041,822.039 675.839,815.36 674.521,808.328C673.862,804.813 673.674,801.209 673.976,797.615L676.366,786.959C683.934,766.704 694.819,747.85 708.577,731.168C709.4,730.171 734.757,704.777 735.624,704.036L733.408,706.252L741.413,699.099C744.352,697.113 747.531,695.534 750.861,694.393C754.192,693.253 757.674,692.552 761.217,692.32L771.943,693.07C771.943,693.07 782.855,695.334 792.854,697.408Z" style="fill:rgb(46,16,101);"/>
+                    </g>
+                    <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                        <path d="M748.614,719.244C753.347,713.704 760.728,711.17 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C805.601,719.97 806.159,719.581 806.719,719.196L814.337,696.137C815.505,692.601 817.607,689.536 820.336,687.205C821.017,686.408 841.707,665.718 842.502,665.039C845.504,661.524 849.689,659.093 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1017.48,942.965 994.412,966.035 993.624,966.709C988.891,972.248 981.509,974.782 974.357,973.299C974.357,973.299 937.19,965.589 937.191,965.589C936.636,965.982 936.078,966.371 935.518,966.756L927.9,989.815C926.732,993.351 924.63,996.416 921.901,998.747C921.221,999.544 900.53,1020.23 899.735,1020.91C896.733,1024.43 892.549,1026.86 887.833,1027.65C868.696,1030.86 849.159,1030.86 830.022,1027.65C822.703,1026.42 816.665,1021.24 814.337,1014.2C814.337,1014.2 802.431,978.156 802.431,978.156C794.801,974.651 787.514,970.444 780.665,965.589L743.498,973.299C736.232,974.806 728.728,972.166 724.007,966.441C711.661,951.471 701.892,934.552 695.101,916.375C692.504,909.424 693.969,901.605 698.908,896.066C698.908,896.066 724.168,867.734 724.168,867.734C723.388,859.374 723.388,850.96 724.168,842.601L698.908,814.268C693.969,808.729 692.504,800.911 695.101,793.959C701.892,775.783 711.661,758.863 724.007,743.894C724.754,742.987 747.825,719.917 748.614,719.244ZM833.765,760.108C831.587,762.657 828.777,764.65 825.558,765.853C815.649,769.555 806.425,774.881 798.264,781.611C793.587,785.469 787.412,786.996 781.476,785.765C781.476,785.765 777.01,784.839 771.329,783.66L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C788.162,821.677 787.758,828.416 788.065,835.131C791.678,822.344 798.662,810.966 807.996,802.019C808.719,801.265 829.407,780.576 830.162,779.853C843.287,766.161 861.644,757.524 882.006,757.169C881.316,755.983 880.744,754.718 880.306,753.391L869.505,720.696C867.929,720.572 866.351,720.475 864.773,720.407L861.931,729.009C860.771,732.521 858.677,735.596 855.931,737.942C855.252,738.738 854.51,739.479 853.715,740.159C853.035,740.954 834.561,759.428 833.765,760.108ZM785.595,861.791C785.245,862.261 784.874,862.717 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L801.408,901.11C792.625,890.132 786.917,876.589 785.595,861.791ZM860.232,928.783C860.921,929.969 861.493,931.234 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C874.309,965.38 875.886,965.477 877.464,965.545L880.306,956.943C881.466,953.431 883.56,950.356 886.306,948.01C886.986,947.214 907.676,926.524 908.472,925.844C910.65,923.295 913.461,921.302 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 965.227,901.113 970.908,902.292L957.757,887.541C953.723,883.016 951.959,876.905 952.961,870.926C954.075,864.275 954.479,857.536 954.173,850.821C950.559,863.608 943.575,874.986 934.242,883.933C933.518,884.688 912.83,905.376 912.076,906.099C898.951,919.791 880.593,928.428 860.232,928.783ZM956.642,824.161C956.992,823.691 957.364,823.235 957.757,822.794C957.757,822.794 980.672,797.092 980.672,797.091C977.631,790.717 974.095,784.592 970.095,778.771L940.829,784.842C949.612,795.82 955.32,809.363 956.642,824.161ZM891.538,863.396C892.202,860.762 892.554,858.006 892.554,855.167C892.554,836.608 877.487,821.541 858.927,821.541C856.089,821.541 853.333,821.893 850.699,822.556C850.036,825.19 849.683,827.947 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C886.148,864.412 888.905,864.059 891.538,863.396Z" style="fill:rgb(91,33,182);"/>
+                    </g>
+                    <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                        <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                    </g>
+                    <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                        <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                    </g>
+                    <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                        <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,757.158C923.946,757.158 956.937,790.149 956.937,830.785C956.937,871.42 923.946,904.412 883.31,904.412C842.674,904.412 809.683,871.42 809.683,830.785C809.683,790.149 842.674,757.158 883.31,757.158ZM883.31,797.158C864.751,797.158 849.683,812.226 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C901.869,864.412 916.937,849.344 916.937,830.785C916.937,812.226 901.869,797.158 883.31,797.158Z" style="fill:rgb(192,132,252);"/>
+                    </g>
+                </g>
+                <g id="Open">
+                    <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                        <path d="M612.752,414.417L612.755,414.399C614.319,403.074 617.1,391.317 621.202,379.208C621.219,379.158 621.236,379.108 621.254,379.058C642.929,316.699 705.583,287.576 764.273,287.576C857.693,287.576 899.91,355.117 909.048,409.366L912.08,406.88L920.961,403.785L926.073,403.523L931.434,404.387L931.989,404.54C932.335,404.635 932.679,404.74 933.019,404.854C933.019,404.854 974.915,418.876 974.914,418.876C989.032,418.097 1002.75,419.574 1015.32,423.041C1050.44,432.728 1078.94,457.158 1092.88,488.192C1110.76,451.897 1150.23,424.424 1212.42,434.095C1239.04,438.234 1256.7,448.747 1268.64,461.131C1275.52,468.266 1280.49,476.151 1284.04,484.118L1284.99,482.987L1293.13,478.28L1298.1,477.063L1303.53,476.905L1304.1,476.951C1304.46,476.98 1304.81,477.018 1305.17,477.066C1305.17,477.066 1334.69,481.041 1334.69,481.041C1346.52,479.74 1357.72,479.533 1368.54,480.404C1438.82,486.06 1487.4,534.497 1482.08,600.62L1481.32,610.093C1480.51,620.186 1481.57,628.665 1488.4,636.108L1487.67,635.351L1492.45,641.009L1495.93,647.625L1497.49,653.901L1497.6,659.077C1497.52,660.131 1491.5,697.889 1491.43,698.792L1490.09,705.087L1487.17,710.887L1483.11,715.574L1479.26,718.437L1478.66,719.013C1473.59,722.475 1448.44,737.641 1448.44,737.641L1449.32,737.075L1438.88,741.908L1427.94,742.929C1425.38,742.723 1416.57,740.653 1406.2,734.34C1389.73,724.313 1366.97,703.451 1363.86,667.715C1362.1,679.162 1358.42,702.879 1358.42,702.879L1358.6,701.393L1357.58,706.702L1355.61,711.379L1349.67,718.691L1341.5,723.391L1336.57,724.585L1331.16,724.74L1330.59,724.693C1330.26,724.667 1329.93,724.632 1329.6,724.588L1272.41,717.097C1272.19,717.068 1271.98,717.036 1271.76,717L1262.63,713.726L1255.14,707.13L1250.74,698.303L1249.84,688.884C1249.87,688.54 1249.91,688.196 1249.95,687.853L1259.27,617.763C1254.48,620.155 1248.87,622.015 1242.29,623.164C1240.48,623.48 1238.57,623.762 1236.57,624.009C1235.96,628.258 1235.46,631.658 1235.4,632.073L1232.32,641.012C1229,647.924 1220.84,662.066 1215.85,669.847C1215.68,670.117 1215.5,670.383 1215.31,670.645L1208.75,677.837L1202,682.239L1191.47,685.368L1180.38,685.146L1176.97,684.615C1128.26,677.041 1098.27,650.794 1084.5,619.41C1074.54,640.111 1059.38,655.378 1040.91,664.889C1017.42,676.986 988.146,679.803 956.468,671.066C951.326,669.647 946.309,667.961 941.466,666.025L926.148,712.05C926.083,712.246 926.015,712.441 925.943,712.635L921.014,720.988L913.129,727.106L903.633,729.774L894.214,728.882C893.861,728.785 893.511,728.678 893.164,728.561L838.479,710.193L839.53,710.514L834.479,708.504L830.194,705.63L824.055,698.154L821.104,689.036L820.955,684.026L821.824,678.908L821.977,678.353C821.995,678.287 822.014,678.222 822.032,678.157L822.706,673.235L822.859,672.679C822.877,672.614 822.896,672.548 822.915,672.483L823.588,667.561L823.742,667.006C823.76,666.94 823.778,666.875 823.797,666.809L824.471,661.887L824.624,661.332C824.642,661.267 824.66,661.201 824.679,661.136L825.353,656.214L825.506,655.659C825.524,655.593 825.543,655.528 825.561,655.462L826.235,650.54L826.388,649.985C826.406,649.919 826.425,649.854 826.444,649.789L827.117,644.867L827.271,644.311C827.289,644.246 827.307,644.18 827.326,644.115L828,639.193L828.153,638.638C828.242,638.313 828.34,637.99 828.446,637.67L846.94,581.81C817.038,604.131 780.223,616.124 748.305,616.124C671.85,616.124 605.041,559.525 605.041,476.028C605.041,467.083 605.838,457.816 607.487,448.278C608.094,444.183 612.083,418.528 612.752,414.417ZM790.912,458.612L790.912,458.61C787.598,443.525 777.649,429.212 756.945,429.212C743.147,429.212 734.01,435.276 728.478,443.499C733.147,461.149 748.071,472.76 764.273,472.76C776.166,472.76 785.212,467.091 790.912,458.612Z" style="fill:rgb(80,7,36);"/>
+                    </g>
+                    <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                        <path d="M632.531,417.395C633.925,407.173 636.441,396.561 640.145,385.624C658.865,331.768 713.585,307.576 764.273,307.576C856.433,307.576 890.993,383.608 890.993,431.704C890.993,438.849 890.358,445.719 889.159,452.306C888.912,454.22 884.206,484.479 883.866,486.347C874.812,556.31 802.991,596.124 748.305,596.124C682.641,596.124 625.041,547.74 625.041,476.028C625.041,468.107 625.761,459.898 627.238,451.437C627.494,449.559 632.199,419.299 632.531,417.395ZM811.755,462.297C808.871,436.154 792.895,409.212 756.945,409.212C730.795,409.212 715.373,423.215 707.498,440.12C711.482,471.866 737.027,492.76 764.273,492.76C786.905,492.76 803.258,480.201 811.755,462.297ZM847.255,647.501C847.013,646.551 847,645.524 847.28,644.511L847.433,643.955L919.032,427.688C920.152,424.711 923.34,422.901 926.116,423.667L926.671,423.82L972.347,439.107C985.511,437.957 998.339,439.105 1010,442.322C1056.58,455.168 1089.71,499.051 1080.64,546.893C1080.41,548.777 1074,589.404 1072.82,593.679C1058.88,644.208 1014.26,666.258 961.785,651.785C950.125,648.569 939.201,643.764 929.848,637.599L907.171,705.734C905.975,708.989 902.864,710.521 899.532,709.602L844.848,691.234C842.071,690.468 840.262,687.28 841.104,684.226L841.257,683.671L841.962,681.542C841.719,680.593 841.707,679.565 841.986,678.552L842.139,677.997L842.844,675.869C842.602,674.919 842.589,673.892 842.869,672.879L843.022,672.323L843.726,670.195C843.484,669.246 843.471,668.218 843.751,667.205L843.904,666.65L844.609,664.521C844.366,663.572 844.354,662.545 844.633,661.532L844.786,660.976L845.491,658.848C845.248,657.899 845.236,656.871 845.515,655.858L845.668,655.303L846.373,653.174C846.13,652.225 846.118,651.197 846.397,650.184L846.551,649.629L847.255,647.501ZM1002.3,551.339C998.055,542.959 990.041,536.492 979.452,533.572C975.01,532.347 970.061,531.878 964.958,531.964L958.449,551.34C962.843,554.288 967.966,556.802 973.243,558.258C974.951,558.729 991.099,563.182 1002.3,551.339ZM1096.58,562.396C1096.73,561.452 1102.61,523.627 1102.76,522.681C1109.09,481.986 1144.47,443.769 1209.35,453.858C1279.93,464.832 1273.28,528.211 1271.82,537.603C1271.67,538.513 1265.75,576.612 1265.64,577.318C1263.61,590.408 1256.52,600.382 1238.84,603.462C1233.2,604.453 1226.37,605.023 1219.25,605.24C1219.25,605.586 1215.8,627.954 1215.63,629C1215.19,631.846 1204.78,650.046 1199.01,659.058C1196.03,663.258 1191.71,666.667 1183.45,665.383L1180.04,664.852C1115.44,654.807 1089.86,605.652 1096.58,562.396ZM1177.74,567.147C1177.91,566.104 1181.57,543.215 1181.85,542.724C1175.88,543.144 1170.25,545.887 1165.85,550.525C1168.19,556.603 1172.07,562.375 1177.74,567.22C1177.74,567.191 1177.74,567.167 1177.74,567.147ZM1289.54,541.835C1289.61,541.484 1295.72,502.12 1295.72,502.12C1296.26,498.985 1299.05,496.61 1301.92,496.841L1302.5,496.887L1334.51,501.197C1345.89,499.801 1356.61,499.508 1366.94,500.34C1425.22,505.03 1466.56,544.184 1462.15,599.015L1461.38,608.489C1460.09,624.565 1462.78,637.783 1473.67,649.639C1475.28,651.213 1477.92,654.315 1477.67,657.473C1477.58,658.527 1471.57,696.285 1471.49,697.188C1471.35,698.91 1470.35,700.563 1468.23,701.837C1468.18,702.411 1438.12,720.506 1438.12,720.506C1435.07,722.572 1432.13,723.202 1429.54,722.994C1424.38,722.578 1379.67,703.667 1383.78,652.568L1384.57,642.807C1386.96,613.082 1373.74,599.241 1353.37,596.145L1344.84,660.073C1344.8,660.541 1338.66,699.789 1338.66,699.789C1338.43,702.659 1335.64,705.035 1332.77,704.804L1332.2,704.758L1275.01,697.266C1271.59,696.702 1269.5,693.934 1269.78,690.489L1289.54,541.835Z" style="fill:rgb(190,24,93);"/>
+                    </g>
+                    <g transform="matrix(1,0,0,1,-43.4435,390.084)">
+                        <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                            <path d="M890.993,431.704C890.993,383.608 856.433,307.576 764.273,307.576C713.585,307.576 658.865,331.768 640.145,385.624C634.097,403.48 631.217,420.472 631.217,436.312C631.217,508.024 688.817,556.408 754.481,556.408C812.945,556.408 890.993,510.904 890.993,431.704ZM764.273,492.76C734.609,492.76 706.961,467.992 706.961,431.416C706.961,405.208 721.361,369.496 763.121,369.496C803.153,369.496 818.417,402.904 818.417,431.416C818.417,463.96 798.545,492.76 764.273,492.76Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                            <path d="M658.955,513.568C645.897,498.25 636.678,479.342 632.996,457.701L714.963,397.795C709.338,408.549 706.961,420.767 706.961,431.416C706.961,446.421 711.614,459.439 719.15,469.574L658.955,513.568ZM752.552,370.323L821.848,319.678C842.275,329.346 857.63,343.956 868.616,360.337L812.433,401.398C804.743,383.652 789.179,369.496 763.121,369.496C759.381,369.496 755.862,369.783 752.552,370.323ZM816.987,416.323L876.142,373.089C881.54,383.546 885.366,394.366 887.782,404.821L813.016,459.464C816.564,450.939 818.417,441.352 818.417,431.416C818.417,426.466 817.957,421.368 816.987,416.323ZM767.582,492.669L697.945,543.564C687.488,538.487 677.836,531.996 669.311,524.252L729.459,480.292C739.38,488.271 751.644,492.76 764.273,492.76C765.391,492.76 766.495,492.73 767.582,492.669Z" style="fill:rgb(254,205,211);"/>
+                        </g>
+                        <g transform="matrix(0.993411,0.114605,-0.114605,0.993411,47.4331,-108.207)">
+                            <path d="M979.985,630.424C983.441,630.424 986.033,628.12 986.321,624.664L990.065,552.952C1000.72,556.408 1012.53,558.136 1024.62,558.136C1079.06,558.136 1116.21,525.016 1116.21,472.6C1116.21,420.184 1070.7,383.32 1020.02,383.32C1007.92,383.32 995.249,385.624 982.865,390.232L934.769,387.64L934.193,387.64C931.313,387.64 928.721,390.232 928.433,393.4L916.913,620.92L916.913,621.496C916.913,624.664 919.505,627.256 922.385,627.256L979.985,630.424ZM995.825,441.784C1000.72,440.344 1005.62,439.48 1010.23,439.48C1030.38,439.48 1045.36,453.304 1045.36,473.176C1045.36,504.856 1017.71,504.856 1015.41,504.856C1007.35,504.856 998.993,502.552 992.657,499.384L995.825,441.784Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(1,0,0,1,-17.5818,-14.5051)">
+                            <path d="M1240.05,557.56C1248.4,557.56 1252.14,553.528 1254.45,548.92C1258.77,539.128 1266.26,519.544 1266.26,516.664C1266.26,511.768 1261.36,509.176 1257.33,509.176L1256.75,509.176C1254.74,509.464 1252.43,509.464 1250.42,509.464C1214.42,509.464 1199.44,486.424 1199.44,465.976C1199.44,448.12 1210.96,436.024 1224.79,436.024C1236.88,436.024 1242.35,445.24 1242.35,447.832C1242.35,451.864 1203.27,460.514 1188.3,463.97C1184.55,464.834 1182.25,466.274 1182.25,469.442C1182.25,470.594 1187.72,489.314 1191.18,498.818C1192.33,502.274 1193.77,504.29 1198.38,504.29C1213.35,503.714 1271.73,492.472 1285.27,487.864C1302.26,482.104 1307.73,471.16 1307.73,457.912C1307.73,448.408 1304.56,384.76 1233.14,384.76C1167.47,384.76 1138.38,427.96 1138.38,469.144C1138.38,512.92 1171.22,557.56 1236.59,557.56L1240.05,557.56Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                            <path d="M1517.97,474.04C1517.97,419.032 1473.62,383.32 1415.15,383.32C1404.79,383.32 1394.13,384.472 1382.9,386.776L1350.64,385.048L1350.07,385.048C1347.18,385.048 1344.59,387.64 1344.31,390.808L1336.53,540.568C1336.53,544.024 1338.83,546.616 1342.29,546.904L1399.89,549.784L1400.46,549.784C1403.35,549.784 1405.94,547.192 1405.94,544.312L1411.41,439.768C1432.43,440.92 1447.12,453.592 1447.12,483.832L1447.12,493.624C1447.12,544.888 1493.2,560.152 1498.38,560.152C1500.98,560.152 1503.86,559.288 1506.74,556.984C1506.74,556.984 1535.25,536.536 1535.25,535.96C1537.27,534.52 1538.13,532.792 1538.13,531.064C1538.13,527.896 1535.25,525.016 1533.52,523.576C1521.71,512.632 1517.97,499.672 1517.97,483.544L1517.97,474.04Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                            <path d="M1336.98,531.794L1341.07,453.028L1421.76,383.474C1446.18,384.621 1467.83,392.129 1484.38,404.732L1434.2,447.993C1428.18,442.845 1420.37,440.26 1411.41,439.768L1409.88,468.954L1336.98,531.794Z" style="fill:rgb(254,205,211);"/>
+                        </g>
+                    </g>
+                </g>
+                <g id="EUICC">
+                    <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                        <path d="M1529.66,323.25L1530.24,318.097L1531.91,313.067L1537.48,304.991L1545.56,299.416L1550.59,297.742L1556.23,297.117L1555.14,297.147L1607.55,294.267C1607.92,294.247 1608.28,294.237 1608.65,294.237L1609.28,294.237L1685.36,290.232C1685.71,290.214 1686.06,290.205 1686.41,290.205L1686.99,290.205L1692.62,290.829L1697.63,292.486L1705.57,297.875L1711.07,305.392L1713.83,315.168C1713.85,315.415 1713.87,315.662 1713.88,315.91L1716.18,366.022C1716.23,366.997 1716.2,367.974 1716.1,368.945L1712.25,407.169L1712.35,405.165L1711.73,410.803L1710.07,415.805L1704.68,423.745L1702.17,425.582L1701.8,454.178C1701.8,454.566 1701.78,454.954 1701.75,455.342C1701.74,455.569 1701.35,459.409 1700.84,464.369L1704.27,464.726L1709.3,466.307L1717.59,471.827L1720.39,475.797L1750.15,343.037C1750.23,342.693 1750.31,342.351 1750.41,342.011L1750.56,341.457L1755.18,332.244L1762.58,325.657L1771.65,322.228L1781.57,322.274C1781.79,322.317 1782.01,322.364 1782.23,322.414L1839.3,335.429C1839.62,335.502 1839.94,335.583 1840.26,335.671L1840.81,335.827L1845.81,337.802L1850.15,340.632L1856.52,348.037L1859.79,356.937L1859.72,366.648C1859.81,366.106 1859.92,365.462 1859.92,365.462C1859.92,365.462 1859.88,365.868 1859.84,366.203C1859.15,372.715 1856,403.718 1855.87,404.404C1855.83,404.61 1855.79,404.814 1855.74,405.018C1840.04,474.681 1834.97,497.588 1832.54,508.606C1834.98,512.172 1839.03,514.495 1843.31,515.695C1852.53,518.282 1863.62,514.988 1867.93,503.383C1867.94,503.366 1867.95,503.349 1867.95,503.332C1872.56,491.026 1877.62,473.928 1882.81,455.42C1889.74,430.734 1896.6,403.073 1902.51,377.805C1902.57,377.52 1902.65,377.236 1902.73,376.954L1902.88,376.4L1904.79,371.384L1907.74,366.67L1911.59,362.679L1915.93,359.72L1921.17,357.555L1925.98,356.587L1932.13,356.545L1937.33,357.512L1992.79,373.066L1997.92,375.104L2002.36,378.011L2006.47,382.81L2009.04,357.694L2010.17,352.278L2012.29,347.386L2018.84,339.595L2027.79,334.762L2033.01,333.671L2038.55,333.659L2101.87,340.132L2107.28,341.264L2112.17,343.389L2119.96,349.934L2124.8,358.887L2125.89,364.108L2125.9,369.642L2115.53,471.116C2143.21,409.347 2206.89,385.97 2270.03,392.426C2299.72,395.461 2326.88,405.708 2345.87,421.131C2346.07,421.298 2346.28,421.47 2346.47,421.646L2350.73,426.445L2354.33,433.635L2355.74,439.783L2355.83,446.488C2355.81,446.624 2355.65,448.219 2355.39,450.706C2394.87,378.213 2471.61,366.264 2538.55,390.564C2566.6,400.747 2590.44,417.309 2605.09,436.895C2605.25,437.108 2605.4,437.324 2605.55,437.543L2608.8,444.04L2610.14,450.046L2610.27,455.837C2610.27,455.837 2609.5,460.324 2609.5,460.335C2608.32,472.137 2605.17,500.328 2604.72,501.565L2600.54,509.227C2600.46,509.325 2600.38,509.423 2600.3,509.52L2569.61,546.79C2569.54,546.883 2569.46,546.976 2569.38,547.068L2563.29,552.297L2557.1,555.157L2557.72,555.483L2562.91,560.182L2567.64,567.768L2569.47,574.713L2569.34,573.79C2569.34,573.79 2576.42,617.086 2576.45,617.261L2577.04,625.138C2577.04,625.138 2576.38,629.107 2576.38,629.115C2575.36,639.604 2571.95,670.32 2571.52,671.508L2568.53,677.46L2564.22,682.586L2554.28,689.179C2508.17,710.726 2463.62,711.215 2426.71,697.818C2400.61,688.344 2378.3,671.989 2361.82,651.186L2361.22,657.045L2359.78,663.547L2356.85,669.569L2348.81,678.388C2309.35,710.528 2266.26,721.867 2227.21,717.875C2166.55,711.673 2115.4,668.929 2101.42,609.116L2099.18,631.051L2098.04,636.468L2095.92,641.36L2089.37,649.151L2080.42,653.983L2075.2,655.075L2069.66,655.087L2006.35,648.614L2000.93,647.482L1996.04,645.357L1988.25,638.812L1983.42,629.858L1982.32,624.637L1982.31,619.104L1994.61,498.787C1992.33,507.533 1989.89,516.562 1987.37,525.565C1981.93,544.968 1976.1,564.57 1970.05,580.691C1942.99,654.487 1869.67,675.445 1808.25,658.22C1770.35,647.591 1737.45,622.729 1722.23,587.267L1722,588.508L1716.83,596.917L1708.76,603.114L1703.78,605.045L1698.39,605.978C1698.27,605.986 1698.15,605.994 1698.04,606L1623.16,610.032C1623,610.04 1622.84,610.047 1622.68,610.052L1620.93,610.349L1621.95,610.323L1565.79,613.203C1565.45,613.22 1565.11,613.229 1564.77,613.229L1564.19,613.229L1558.49,612.587L1553.36,610.839L1545.34,605.142L1540.11,597.538L1537.64,588.266C1537.62,588.062 1537.61,587.859 1537.6,587.655L1525.79,363.015C1525.74,361.986 1525.76,360.955 1525.87,359.931L1529.71,322.283L1529.66,323.25ZM2332.02,549.385C2332.09,548.761 2332.16,548.136 2332.23,547.51C2332.45,545.229 2333.61,533.848 2334.54,524.786L2328.96,536.557C2328.91,536.666 2328.86,536.775 2328.8,536.883L2324.18,543.44L2321.07,545.949L2321.51,545.913L2328.84,547.691L2332.02,549.385ZM2533.29,552.067L2533.05,551.946C2533.05,551.946 2527.22,546.283 2527.4,546.524C2522.66,540.295 2512.51,533.182 2501.15,529.058C2490.46,525.177 2480.78,524.606 2472.69,528.046C2466.84,530.534 2462.07,535.044 2458.31,541.082C2462.57,548.738 2470.22,554.495 2479.36,557.815C2493.84,563.071 2512.48,562.197 2530.54,553.069C2530.72,552.977 2530.91,552.887 2531.09,552.8L2533.29,552.067ZM1622.69,610.051C1624.08,610.004 1626,609.79 1627.83,609.179L1622.69,610.051ZM2301.84,552.027L2301.48,552.057L2294.76,550.474C2294.76,550.474 2287.72,546.405 2287.96,546.595C2281.85,541.707 2270.27,537.286 2258.24,536.056C2242.55,534.452 2230.31,539.236 2223.53,549.756C2228.51,561.063 2240.18,567.707 2253.42,569.061C2268.73,570.626 2286.56,565.249 2301.84,552.027Z" style="fill:rgb(46,16,101);"/>
+                    </g>
+                    <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                        <path d="M2002.21,621.138L2028.93,359.728C2029.31,356.004 2032.79,353.174 2036.51,353.555L2099.83,360.028C2103.55,360.409 2106.38,363.883 2106,367.608L2079.28,629.017C2078.9,632.742 2075.42,635.571 2071.7,635.191L2008.38,628.717C2004.66,628.336 2001.83,624.863 2002.21,621.138ZM1545.76,361.965L1549.61,324.317L1549.61,323.741C1549.61,320.285 1552.78,317.117 1556.23,317.117L1608.65,314.237L1609.8,314.237L1686.41,310.205L1686.99,310.205C1690.44,310.205 1693.61,313.373 1693.9,316.829L1696.2,366.941L1692.35,405.165C1692.35,408.621 1689.18,411.789 1685.73,412.077L1682.35,412.251L1681.8,453.917C1681.76,454.559 1678.62,485.045 1678.61,485.206L1698.22,484.157L1698.79,484.157C1702.54,484.157 1705.71,487.325 1705.71,490.781L1707.72,540.893C1707.72,541.708 1703.87,578.541 1703.87,578.541C1703.87,582.285 1700.99,585.741 1696.96,586.029L1622.08,590.061C1621.79,590.061 1621.22,590.349 1620.93,590.349L1564.77,593.229L1564.19,593.229C1560.74,593.229 1557.86,590.061 1557.57,586.605L1545.76,361.965ZM1737.5,495.591C1737.93,490.61 1738.72,485.491 1739.89,480.242L1769.66,347.412L1769.82,346.858C1770.83,343.253 1774.38,341.257 1777.79,341.913L1834.86,354.928L1835.41,355.084C1838.74,356.017 1840.73,359.568 1840.08,362.973C1839.98,363.389 1836.37,399.892 1836.23,400.621C1816.75,487.073 1813.63,501.561 1811.61,510.641C1815.31,523.002 1825.75,531.543 1837.91,534.952C1856.21,540.085 1878.13,533.372 1886.68,510.346C1891.45,497.624 1896.7,479.955 1902.07,460.821C1909.07,435.864 1916.02,407.901 1921.98,382.355L1922.14,381.801C1923.77,375.977 1929.15,375.991 1931.92,376.769L1987.38,392.323C1990.99,393.334 1993.18,397.24 1992.45,400.923C1992.37,401.306 1988.75,437.82 1988.6,438.571C1984.58,457.184 1976.9,488.83 1968.11,520.165C1962.82,539.021 1957.18,558.077 1951.28,573.771C1928.32,636.428 1865.78,653.585 1813.65,638.963C1766.18,625.65 1727.35,586.23 1734,529.817C1734.1,528.683 1737.36,496.739 1737.5,495.591ZM2118.35,562.156C2118.41,561.55 2122.15,525.047 2122.2,524.508C2131.08,437.697 2200.1,405.381 2268,412.323C2293.5,414.929 2316.95,423.407 2333.26,436.654C2335.11,438.291 2336.22,441.589 2335.93,444.454C2335.86,445.139 2331.94,483.535 2331.56,484.365L2310.89,527.993C2309.8,530.197 2306.67,532.483 2303.51,532.16C2302.37,532.043 2301.25,531.64 2300.45,530.979C2292.16,524.341 2276.61,517.83 2260.28,516.16C2231.63,513.231 2211.11,525.354 2202.07,547.952C2206.98,571.507 2227.03,586.467 2251.39,588.957C2271.44,591.007 2294.99,584.44 2315,567.089C2316.26,566.06 2318.04,565.663 2319.47,565.809C2322.34,566.102 2325.31,568.144 2326.22,570.553L2343.79,611.141C2344.73,613.264 2345.38,615.358 2345.18,617.363C2345.12,617.946 2341.39,654.456 2341.33,655.011C2341.07,657.59 2339.66,660.051 2336.18,662.881C2301.44,691.174 2263.62,701.493 2229.24,697.978C2163.63,691.271 2110.91,634.929 2118.35,562.156ZM2355.61,515.419C2356.56,504.634 2358.96,493.637 2362.97,482.606C2392.74,400.58 2467.56,386.072 2531.72,409.364C2555.82,418.11 2576.49,432.051 2589.07,448.874C2590.36,450.748 2590.7,453.826 2589.98,456.412C2590.05,457.555 2586.38,493.465 2585.92,494.74C2585.62,495.552 2585.43,496.093 2584.86,496.807L2554.17,534.077C2552.58,535.947 2548.98,537.401 2546.01,536.32C2544.92,535.927 2543.94,535.263 2543.32,534.427C2536.9,525.966 2523.41,515.86 2507.98,510.259C2475.6,498.505 2449.24,510.468 2436.39,539.959C2441.03,556.869 2454.59,570.098 2472.54,576.614C2491.49,583.494 2515.92,582.866 2539.56,570.919C2541.03,570.229 2542.86,570.278 2544.21,570.769C2546.92,571.752 2549.3,574.457 2549.6,577.016L2556.74,620.662C2557.11,622.803 2557.24,624.857 2556.69,626.664C2556.75,627.869 2553.14,663.515 2552.72,664.683C2551.83,667.12 2549.87,669.163 2545.81,671.06C2505.22,690.028 2466.02,690.812 2433.54,679.019C2380.44,659.742 2345.39,607.458 2352.11,549.644C2352.21,548.506 2355.48,516.562 2355.61,515.419Z" style="fill:rgb(91,33,182);"/>
+                    </g>
+                    <g transform="matrix(1,0,0,1,-45.5223,-53.0944)">
+                        <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-572.922,875.907)">
+                            <path d="M1700.81,548.381C1704.84,548.093 1707.72,544.637 1707.72,540.893L1705.71,490.781C1705.71,487.325 1702.54,484.157 1698.79,484.157L1698.22,484.157L1628.23,487.901L1626.79,461.117L1674.6,461.117C1678.63,461.117 1681.51,457.949 1681.8,453.917L1682.38,409.853L1682.38,409.277C1682.38,405.533 1678.92,402.653 1675.47,402.653L1623.91,402.653L1622.47,377.885L1689.58,374.429C1693.03,374.141 1696.2,370.973 1696.2,367.517L1696.2,366.941L1693.9,316.829C1693.61,313.373 1690.44,310.205 1686.99,310.205L1686.41,310.205L1609.8,314.237L1608.65,314.237L1556.23,317.117C1552.78,317.117 1549.61,320.285 1549.61,323.741L1549.61,324.317L1561.42,548.957C1561.71,552.413 1564.59,555.581 1568.04,555.581L1568.62,555.581L1624.78,552.701C1625.07,552.701 1625.64,552.413 1625.93,552.413L1700.81,548.381Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(0.98532,0.170719,-0.170719,0.98532,-440.459,422.474)">
+                            <path d="M1908.79,310.456C1905.9,310.456 1900.72,311.896 1900.72,317.944L1900.72,318.52C1901.87,344.728 1902.74,373.528 1902.74,399.448C1902.74,419.32 1902.45,437.752 1901.3,451.288C1899.28,475.768 1879.99,488.152 1860.98,488.152C1842.55,488.152 1824.69,476.632 1823.54,453.304C1822.1,421.336 1823.54,455.32 1816.62,321.976C1816.34,318.52 1813.46,315.64 1810,315.64L1809.42,315.64L1750.96,318.52C1747.51,318.808 1744.62,321.688 1744.62,325.432L1744.62,326.008L1751.83,461.944C1755.28,526.168 1806.55,557.56 1859.25,557.56C1913.39,557.56 1968.98,524.152 1974.16,457.624C1975.6,440.92 1975.89,421.048 1975.89,401.464C1975.89,368.92 1974.74,336.376 1973.59,317.368C1973.3,313.624 1970.13,310.456 1966.38,310.456L1908.79,310.456Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(1,0,0,1,-537.877,707.46)">
+                            <path d="M2090.51,551.8C2094.26,551.8 2097.43,548.632 2097.43,544.888L2097.43,319.96C2097.43,316.216 2094.26,313.048 2090.51,313.048L2026.87,313.048C2023.12,313.048 2019.95,316.216 2019.95,319.96L2019.95,544.888C2019.95,548.632 2023.12,551.8 2026.87,551.8L2090.51,551.8Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(1,0,0,1,-542.093,747.563)">
+                            <path d="M2341.36,459.352C2340.21,457.048 2337.04,455.32 2334.16,455.32C2332.72,455.32 2330.99,455.896 2329.84,457.048C2311.7,476.344 2288.95,485.272 2268.78,485.272C2238.55,485.272 2212.91,465.688 2212.91,431.704C2212.91,396.568 2233.94,374.104 2270.22,374.104C2286.64,374.104 2302.77,379 2311.7,384.76C2312.56,385.336 2313.71,385.624 2314.87,385.624C2318.03,385.624 2320.91,383.032 2321.78,380.728L2337.91,335.224C2338.19,334.36 2338.19,333.784 2338.19,332.92C2338.19,330.04 2336.75,326.872 2334.74,325.432C2317.17,313.912 2292.98,307.864 2267.35,307.864C2199.09,307.864 2133.71,347.032 2133.71,434.296C2133.71,507.448 2191.89,558.136 2257.84,558.136C2292.4,558.136 2328.98,544.024 2360.66,512.344C2363.83,509.176 2364.98,506.584 2364.98,503.992C2364.98,501.976 2364.11,499.96 2362.96,497.944L2341.36,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                        </g>
+                        <g transform="matrix(0.969808,0.24387,-0.24387,0.969808,-375.869,113.966)">
+                            <path d="M2588.18,459.352C2587.03,457.048 2583.86,455.32 2580.98,455.32C2579.54,455.32 2577.81,455.896 2576.66,457.048C2558.51,476.344 2535.76,485.272 2515.6,485.272C2485.36,485.272 2459.73,465.688 2459.73,431.704C2459.73,396.568 2480.75,374.104 2517.04,374.104C2533.46,374.104 2549.59,379 2558.51,384.76C2559.38,385.336 2560.53,385.624 2561.68,385.624C2564.85,385.624 2567.73,383.032 2568.59,380.728L2584.72,335.224C2585.01,334.36 2585.01,333.784 2585.01,332.92C2585.01,330.04 2583.57,326.872 2581.55,325.432C2563.99,313.912 2539.79,307.864 2514.16,307.864C2445.91,307.864 2380.53,347.032 2380.53,434.296C2380.53,507.448 2438.7,558.136 2504.66,558.136C2539.22,558.136 2575.79,544.024 2607.47,512.344C2610.64,509.176 2611.79,506.584 2611.79,503.992C2611.79,501.976 2610.93,499.96 2609.78,497.944L2588.18,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                        </g>
+                    </g>
+                </g>
+                <path d="M988.333,1002.5C988.379,1003.47 988.508,1005.49 988.818,1007.18C989.725,1012.13 991.45,1018.87 993.403,1028.25C994.303,1032.57 991.525,1036.81 987.202,1037.71C982.88,1038.61 978.639,1035.83 977.739,1031.51C974.599,1016.43 972.184,1007.68 972.265,1002.27C972.315,998.949 973.077,996.344 974.363,994.171L977.247,990.719C978.213,989.878 979.348,989.105 980.697,988.415C983.011,987.231 987.42,986.061 992.612,985.228C1002.58,983.629 1015.86,982.795 1017.84,982.672C1022.25,982.398 1026.05,985.753 1026.32,990.16C1026.6,994.567 1023.24,998.367 1018.83,998.641C1016.97,998.757 1004.5,999.525 995.145,1001.03C992.296,1001.48 989.786,1001.89 988.333,1002.5Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1195.95,1039.37C1195.02,1043.68 1190.77,1046.44 1186.45,1045.51C1182.13,1044.59 1179.38,1040.33 1180.3,1036.02C1180.85,1033.44 1184.24,1017.62 1186.73,1003.7C1187.37,1000.08 1190.41,997.365 1194.08,997.125C1204.16,996.469 1204.01,996.191 1214,997.195C1218.39,997.636 1221.6,1001.56 1221.16,1005.96C1220.71,1010.35 1216.79,1013.56 1212.4,1013.11C1206.5,1012.52 1204.67,1012.46 1201.35,1012.66C1199.02,1024.99 1196.43,1037.12 1195.95,1039.37Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1289.49,1196.2C1285.4,1197.87 1280.73,1195.9 1279.06,1191.81C1277.39,1187.73 1279.36,1183.05 1283.45,1181.38C1291.16,1178.24 1295.88,1176.49 1299.86,1172.93C1303.92,1169.3 1307.14,1163.9 1312.33,1154.03C1314.38,1150.12 1319.22,1148.61 1323.13,1150.66C1327.04,1152.72 1328.54,1157.56 1326.49,1161.47C1320.01,1173.81 1315.6,1180.32 1310.53,1184.86C1305.38,1189.46 1299.47,1192.13 1289.49,1196.2Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1463.37,993.495C1463.11,995.117 1462.65,998.235 1462.56,1000.72C1462.29,1008.23 1462.8,1016.95 1462.83,1021.2C1462.85,1025.62 1459.29,1029.22 1454.87,1029.25C1450.45,1029.27 1446.85,1025.7 1446.83,1021.29C1446.79,1014.44 1445.8,996.976 1447.92,988.886C1448.48,986.742 1449.26,985.008 1450.11,983.729L1452.06,981.477L1454.04,980.104C1457.58,978.226 1457.62,978.465 1473.31,975.976C1477.67,975.284 1481.77,978.263 1482.46,982.624C1483.15,986.985 1480.18,991.086 1475.82,991.778C1467.37,993.118 1465.03,993.073 1463.37,993.495Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1585.5,1098.21C1585.07,1102.6 1581.16,1105.82 1576.76,1105.4C1572.37,1104.97 1569.15,1101.05 1569.58,1096.66C1572.43,1067.37 1598.83,1046.25 1614.85,1037.04C1618.67,1034.84 1623.57,1036.16 1625.77,1039.99C1627.97,1043.82 1626.64,1048.72 1622.82,1050.91C1609.93,1058.32 1587.8,1074.63 1585.5,1098.21Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1740.17,1170.75C1743.74,1168.16 1748.75,1168.95 1751.34,1172.53C1753.93,1176.1 1753.14,1181.11 1749.56,1183.7C1735.58,1193.84 1735.59,1194.13 1721.98,1197.65C1717.71,1198.76 1713.34,1196.19 1712.23,1191.91C1711.12,1187.64 1713.7,1183.27 1717.97,1182.16C1728.96,1179.32 1728.88,1178.94 1740.17,1170.75Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1822.12,1050.48C1820.66,1054.65 1816.09,1056.85 1811.93,1055.39C1807.76,1053.93 1805.56,1049.36 1807.02,1045.19C1812.53,1029.48 1820.56,1007.67 1857.96,995.197C1862.15,993.8 1866.68,996.067 1868.08,1000.25C1869.48,1004.44 1867.21,1008.98 1863.02,1010.38C1833.01,1020.38 1826.54,1037.87 1822.12,1050.48Z" style="fill:rgb(233,213,255);"/>
+                <path d="M1930.13,1172.93C1925.81,1173.86 1921.55,1171.1 1920.63,1166.78C1919.7,1162.46 1922.46,1158.21 1926.78,1157.29C1941.59,1154.11 1941.14,1153.31 1950.54,1149.02C1954.55,1147.19 1959.3,1148.96 1961.14,1152.97C1962.97,1156.99 1961.2,1161.74 1957.18,1163.57C1946.5,1168.46 1946.99,1169.32 1930.13,1172.93Z" style="fill:rgb(233,213,255);"/>
+            </g>
+        </g>
+    </g>
+</svg>
diff --git a/art/OpenEUICCSVG.png b/art/OpenEUICCSVG.png
new file mode 100644
index 0000000000000000000000000000000000000000..89c86ba9c4bd09c90b7aca13d653d61a04dfea7e
GIT binary patch
literal 193433
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

literal 0
HcmV?d00001

diff --git a/art/OpenEUICCSVG.svg b/art/OpenEUICCSVG.svg
new file mode 100644
index 000000000..da5699a94
--- /dev/null
+++ b/art/OpenEUICCSVG.svg
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 1449 818" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-576,-493)">
+        <g id="OpenEUICCSVG">
+            <g id="Sim" transform="matrix(0.785112,1.10765,-1.10765,0.785112,658.755,-1281.43)">
+                <g transform="matrix(1.20427,0,2.22045e-16,1.44928,-38.8349,-460.554)">
+                    <path d="M1109.4,779.255C1107.87,778.394 1106.09,777.339 1104.71,776.471L1104.7,776.469L1102.52,775.389L1099.06,772.262L1096.79,768.373L1095.97,763.963L1095.89,673.341L1096.23,670.449L1097.23,667.695L1098.86,665.155L1101.08,662.908L1103.78,661.065L1106.84,659.709L1110.15,658.872L1113.63,658.585L1182.83,658.585L1186.42,658.89L1189.83,659.779L1192.95,661.218C1192.95,661.218 1193.81,661.826 1193.81,661.828C1194.56,662.274 1202.69,667.135 1203.24,667.613L1220.41,682.619L1222.5,684.831L1224.03,687.308L1224.98,689.981L1225.3,692.779L1225.3,768.395L1224.94,771.356L1223.9,774.138L1222.26,776.646L1220.1,778.821L1217.48,780.615L1214.46,781.976L1211.12,782.84L1207.55,783.139L1121.26,783.139L1117.44,782.795L1113.89,781.807L1110.72,780.256C1110.72,780.256 1109.4,779.257 1109.4,779.255Z" style="fill:rgb(80,7,36);"/>
+                </g>
+                <g transform="matrix(1.20427,0,0,1.44928,-38.8349,-460.554)">
+                    <path d="M1111.62,768.187C1109.62,767.502 1108.21,765.865 1108.2,763.955L1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1186.83,670.173 1193.92,674.225 1194.37,674.617L1211.55,689.624C1212.52,690.475 1213.07,691.605 1213.07,692.779L1213.07,768.395C1213.07,770.925 1210.6,772.975 1207.55,772.975L1121.26,772.975C1119.63,772.975 1118.16,772.385 1117.15,771.447C1116.38,771.181 1112.17,768.698 1111.62,768.187Z" style="fill:rgb(190,24,93);"/>
+                </g>
+                <g transform="matrix(1.20427,0,1.11022e-16,1.44928,-38.8349,-460.554)">
+                    <path d="M1204,685.179C1204.98,686.031 1205.52,687.16 1205.52,688.335L1205.52,763.951C1205.52,766.48 1203.05,768.531 1200.01,768.531L1113.72,768.531C1110.67,768.531 1108.21,766.483 1108.2,763.955C1108.19,747.298 1108.14,690.002 1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1190.67,673.533 1200.27,681.919 1204,685.179Z" style="fill:rgb(244,63,94);"/>
+                </g>
+                <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                    <path d="M1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,613.249C1553.44,618.429 1549.29,622.628 1544.17,622.628C1527.95,622.628 1494.61,622.628 1478.39,622.628C1473.27,622.628 1469.12,618.429 1469.12,613.249L1469.12,522.748C1469.12,517.568 1473.27,513.37 1478.39,513.37L1544.17,513.37Z" style="fill:rgb(255,209,0);"/>
+                </g>
+                <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                    <path d="M1469.24,614.766C1469.16,614.272 1469.12,613.766 1469.12,613.249L1469.12,567.058L1522.19,513.37L1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,529.581L1469.24,614.766Z" style="fill:rgb(255,243,138);"/>
+                </g>
+                <g transform="matrix(1,-5.55112e-17,5.55112e-17,1,-676.337,255.223)">
+                    <path d="M2010.77,311.863C2009.48,312.543 2003.51,316.132 2002.59,316.644C2001.38,317.313 1999.86,316.877 1999.19,315.671C1998.52,314.464 1998.96,312.941 2000.17,312.272C2000.92,311.854 2001.66,311.419 2002.4,310.979L2002.4,274.565C2002.4,273.185 2003.52,272.065 2004.9,272.065C2006.28,272.065 2007.4,273.185 2007.4,274.565L2007.4,308.007C2007.75,307.811 2008.1,307.621 2008.45,307.437C2011.52,305.821 2014.64,304.694 2017.95,304.671C2022.22,304.642 2026.42,306.561 2030.64,308.867L2030.64,274.565C2030.64,273.185 2031.76,272.065 2033.14,272.065C2034.52,272.065 2035.64,273.185 2035.64,274.565L2035.64,311.664C2039.1,313.557 2042.63,315.118 2046.37,315.118C2054.72,315.118 2061.73,308.414 2061.73,308.414C2062.83,307.579 2064.4,307.793 2065.23,308.891C2066.07,309.99 2065.86,311.56 2064.76,312.395C2064.76,312.395 2056.58,319.964 2046.45,320.118C2040.93,320.202 2035.72,317.467 2030.66,314.605C2026.4,312.193 2022.27,309.642 2017.99,309.671C2015.46,309.689 2013.12,310.633 2010.77,311.863ZM2002.4,351.73C1998.65,349.472 1994.72,347.293 1990.06,347.204C1983.86,347.085 1977.25,354.288 1977.25,354.288C1976.4,355.379 1974.83,355.578 1973.74,354.733C1972.65,353.888 1972.45,352.317 1973.3,351.226C1973.3,351.226 1981.5,342.039 1990.16,342.205C1995.95,342.316 2000.87,344.972 2005.52,347.774L2006.76,348.528C2010.47,350.797 2014.01,353.011 2017.99,353.038C2022.27,353.068 2026.4,350.517 2030.66,348.105C2035.72,345.243 2040.93,342.508 2046.45,342.592C2055.63,342.731 2064.52,348.783 2064.52,348.783C2065.62,349.618 2065.83,351.188 2064.99,352.286C2064.16,353.384 2062.59,353.598 2061.49,352.763C2061.49,352.763 2054.12,347.591 2046.37,347.591C2042.63,347.591 2039.1,349.153 2035.64,351.045L2035.64,388.469C2035.64,389.848 2034.52,390.969 2033.14,390.969C2031.76,390.969 2030.64,389.848 2030.64,388.469L2030.64,353.842C2026.42,356.148 2022.22,358.067 2017.95,358.038C2014.27,358.013 2010.83,356.574 2007.4,354.682L2007.4,388.469C2007.4,389.848 2006.28,390.969 2004.9,390.969C2003.52,390.969 2002.4,389.848 2002.4,388.469L2002.4,351.73ZM1973,310.59C1972.15,309.499 1972.35,307.927 1973.44,307.082C1974.53,306.237 1976.11,306.436 1976.95,307.527C1976.95,307.527 1982.05,313.224 1985.65,314.67C1986.93,315.185 1987.55,316.642 1987.03,317.922C1986.52,319.202 1985.06,319.824 1983.78,319.309C1978.86,317.332 1973,310.59 1973,310.59Z" style="fill:rgb(154,78,3);"/>
+                </g>
+            </g>
+            <g id="Cogs">
+                <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                    <path d="M713.5,735.152L713.524,735.11C719.147,725.132 725.647,715.652 732.959,706.786C742.403,695.336 757.41,690.056 771.943,693.07C771.943,693.07 789.986,696.813 800.929,699.083C801.619,698.652 802.312,698.226 803.008,697.805L805.605,689.944C806.386,687.579 822.308,659.429 823.248,658.126L821.227,661.626L826.328,653.226C828.346,650.673 830.664,648.38 833.228,646.395L841.6,641.415L851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C937.664,649.993 940.067,652.685 942.082,655.676L946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577L1068.16,772.222L1068.04,781.962C1067.6,785.174 1066.77,788.329 1065.57,791.353L1060.85,799.971L1062.87,796.471C1062.21,797.936 1045.79,825.8 1044.13,827.659C1044.13,827.659 1041.84,830.237 1038.62,833.837C1038.61,834.651 1038.59,835.465 1038.56,836.277L1058.26,858.374C1068.13,869.453 1071.07,885.089 1065.87,898.993C1061.85,909.77 1056.88,920.151 1051.05,930.004C1049.68,932.395 1040.32,948.617 1039,950.881C1033.37,960.874 1026.86,970.368 1019.54,979.247C1010.09,990.697 995.086,995.977 980.553,992.963C980.553,992.963 962.509,989.22 951.566,986.95C950.877,987.381 950.184,987.807 949.488,988.227L946.891,996.089L941.354,1006.94L943.375,1003.44C942.724,1004.89 930.161,1026.64 929.248,1027.91L931.269,1024.41L926.168,1032.81C924.15,1035.36 921.832,1037.65 919.268,1039.64L910.896,1044.62L901.397,1047.45C880.072,1051.03 858.3,1051.03 836.975,1047.45C822.337,1045 810.261,1034.64 805.605,1020.55C805.605,1020.55 799.825,1003.05 796.319,992.442C793.084,990.724 789.911,988.892 786.806,986.95L757.819,992.963C743.286,995.977 728.279,990.697 718.836,979.247C705.078,962.565 694.192,943.711 686.625,923.456L684.332,913.811L684.459,904.07C684.896,900.858 685.722,897.704 686.924,894.679L691.649,886.062L689.629,889.562C690.268,888.138 702.827,866.381 703.755,865.094L701.735,868.593L708.362,858.374C708.362,858.374 710.661,855.796 713.872,852.195C713.888,851.382 713.91,850.568 713.939,849.755L694.238,827.659L688.151,818.592C686.569,815.351 685.439,811.924 684.78,808.409C684.121,804.893 683.933,801.289 684.234,797.696L686.625,787.04C690.651,776.263 695.618,765.881 701.447,756.028C702.804,753.652 712.07,737.603 713.5,735.152Z" style="fill:rgb(80,7,36);"/>
+                </g>
+                <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                    <path d="M730.855,745.094C735.921,736.08 741.787,727.517 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C809.701,717.064 814.558,714.064 819.587,711.38L824.596,696.218C825.246,694.249 838.687,670.91 839.469,669.825C842.19,663.773 847.771,659.415 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.49,775.877 1048.51,782.89 1044.62,788.272C1044.08,789.492 1030.59,812.801 1029.21,814.349C1029.21,814.349 1024.16,820.008 1018.58,826.268C1018.77,831.965 1018.6,837.671 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1043.5,901.713 1039.02,911.074 1033.75,919.97C1033.09,921.142 1022.33,939.781 1021.64,940.938C1016.57,949.953 1010.71,958.516 1004.11,966.522C999.385,972.247 991.882,974.887 984.615,973.379C984.615,973.379 947.449,965.67 947.449,965.67C942.795,968.969 937.938,971.969 932.909,974.653L927.9,989.815C927.25,991.784 926.31,993.607 925.133,995.239C924.575,996.48 913.809,1015.12 913.027,1016.21C910.306,1022.26 904.725,1026.62 898.091,1027.73C878.955,1030.94 859.418,1030.94 840.281,1027.73C832.962,1026.5 826.924,1021.33 824.596,1014.28C824.596,1014.28 812.689,978.237 812.69,978.237C805.06,974.732 797.773,970.525 790.923,965.67L753.757,973.379C746.49,974.887 738.987,972.247 734.265,966.522C721.919,951.552 712.151,934.633 705.36,916.456C703.006,910.155 703.989,903.143 707.871,897.761C708.419,896.541 719.181,877.895 719.977,876.792C720.802,874.957 721.91,873.231 723.29,871.684C723.29,871.684 728.336,866.024 733.917,859.765C733.727,854.068 733.897,848.362 734.426,842.681L709.167,814.349C704.228,808.81 702.763,800.992 705.36,794.04C708.992,784.319 713.475,774.958 718.748,766.063C719.408,764.89 730.169,746.252 730.855,745.094ZM847.058,755.4C844.88,760.245 840.846,764.055 835.817,765.934C825.907,769.636 816.683,774.962 808.522,781.692C803.845,785.549 797.671,787.077 791.735,785.846C791.735,785.846 778.919,783.187 769.09,781.148L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.164,851.838 788.882,857.237 785.775,861.545C785.225,862.768 771.731,886.08 770.356,887.622C770.356,887.622 767.776,890.516 764.346,894.363C766.704,898.775 769.307,903.055 772.143,907.181L805.859,900.187C807.17,899.915 808.493,899.778 809.809,899.77C800.487,887.364 794.962,871.946 794.962,855.248C794.962,841.044 798.96,827.767 805.891,816.481C806.533,815.297 815.277,800.152 815.98,799.008C816.622,797.823 817.294,796.658 817.998,795.513C830.557,772.324 855.107,756.56 883.31,756.56C886.308,756.56 889.264,756.738 892.169,757.085C891.522,755.946 890.983,754.738 890.565,753.472L879.763,720.776C874.772,720.384 869.765,720.269 864.764,720.433L861.931,729.009C861.284,730.97 847.842,754.313 847.058,755.4ZM860.327,928.948C860.974,930.086 861.513,931.295 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C877.724,965.649 882.731,965.763 887.732,965.599L890.565,957.024C891.212,955.063 902.636,935.215 903.42,934.127C903.976,932.89 904.654,931.72 905.438,930.633C907.616,925.788 911.65,921.978 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 973.577,902.845 983.406,904.884L968.016,887.622C963.981,883.096 962.217,876.986 963.219,871.006C964.968,860.574 964.968,849.922 963.219,839.489C962.332,834.194 963.614,828.796 966.721,824.487C967.27,823.265 980.765,799.952 982.14,798.411C982.14,798.411 984.72,795.516 988.15,791.67C985.791,787.257 983.189,782.978 980.353,778.852L946.637,785.846C945.326,786.118 944.003,786.255 942.687,786.263C952.008,798.669 957.534,814.087 957.534,830.785C957.534,844.989 953.536,858.266 946.605,869.552C945.963,870.736 935.201,889.375 934.498,890.52C921.939,913.709 897.389,929.472 869.186,929.472C866.188,929.472 863.232,929.294 860.327,928.948ZM903.248,858.597C903.356,857.495 903.411,856.378 903.411,855.248C903.411,836.359 888.075,821.024 869.186,821.024C861.749,821.024 854.864,823.401 849.248,827.436C849.14,828.538 849.085,829.655 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C890.747,865.009 897.632,862.632 903.248,858.597Z" style="fill:rgb(190,24,93);"/>
+                </g>
+                <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                    <path d="M792.854,697.408L795.347,689.863C797.63,682.952 801.697,676.94 806.966,672.326C811.488,667.744 823.043,656.19 827.618,651.675C833.598,644.848 841.835,640.131 851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C940.38,652.322 944.563,658.434 946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577C1071.07,776.48 1068.13,792.117 1058.26,803.195C1058.26,803.195 1046,816.95 1038.56,825.292C1038.69,828.953 1038.69,832.617 1038.56,836.277L1058.26,858.374L1064.35,867.441C1065.93,870.682 1067.06,874.109 1067.72,877.624C1068.38,881.14 1068.56,884.743 1068.26,888.337L1065.87,898.993C1058.3,919.248 1047.42,938.102 1033.66,954.784C1032.84,955.781 1007.48,981.175 1006.61,981.916L1008.83,979.7L1000.82,986.853C997.886,988.839 994.707,990.418 991.376,991.559C988.045,992.699 984.563,993.401 981.02,993.632L970.295,992.882C970.295,992.882 959.382,990.618 949.383,988.544L946.891,996.089C944.608,1003 940.54,1009.01 935.271,1013.63C930.749,1018.21 919.195,1029.76 914.619,1034.28C908.64,1041.1 900.402,1045.82 891.138,1047.37C869.813,1050.95 848.042,1050.95 826.717,1047.37L816.293,1044.12C813.03,1042.58 810.003,1040.62 807.288,1038.29C804.573,1035.96 802.17,1033.27 800.155,1030.28L795.347,1020.47C795.347,1020.47 789.566,1002.97 786.061,992.362C782.825,990.643 779.652,988.811 776.547,986.869L747.56,992.882C733.028,995.896 718.02,990.616 708.577,979.166C694.819,962.485 683.934,943.63 676.366,923.375L673.976,912.719C673.674,909.126 673.862,905.522 674.521,902.007C675.18,898.491 676.31,895.064 677.892,891.823L683.98,882.757C683.98,882.757 696.243,869.002 703.68,860.66C703.551,856.999 703.551,853.335 703.68,849.675L683.98,827.578C679.041,822.039 675.839,815.36 674.521,808.328C673.862,804.813 673.674,801.209 673.976,797.615L676.366,786.959C683.934,766.704 694.819,747.85 708.577,731.168C709.4,730.171 734.757,704.777 735.624,704.036L733.408,706.252L741.413,699.099C744.352,697.113 747.531,695.534 750.861,694.393C754.192,693.253 757.674,692.552 761.217,692.32L771.943,693.07C771.943,693.07 782.855,695.334 792.854,697.408Z" style="fill:rgb(46,16,101);"/>
+                </g>
+                <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                    <path d="M748.614,719.244C753.347,713.704 760.728,711.17 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C805.601,719.97 806.159,719.581 806.719,719.196L814.337,696.137C815.505,692.601 817.607,689.536 820.336,687.205C821.017,686.408 841.707,665.718 842.502,665.039C845.504,661.524 849.689,659.093 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1017.48,942.965 994.412,966.035 993.624,966.709C988.891,972.248 981.509,974.782 974.357,973.299C974.357,973.299 937.19,965.589 937.191,965.589C936.636,965.982 936.078,966.371 935.518,966.756L927.9,989.815C926.732,993.351 924.63,996.416 921.901,998.747C921.221,999.544 900.53,1020.23 899.735,1020.91C896.733,1024.43 892.549,1026.86 887.833,1027.65C868.696,1030.86 849.159,1030.86 830.022,1027.65C822.703,1026.42 816.665,1021.24 814.337,1014.2C814.337,1014.2 802.431,978.156 802.431,978.156C794.801,974.651 787.514,970.444 780.665,965.589L743.498,973.299C736.232,974.806 728.728,972.166 724.007,966.441C711.661,951.471 701.892,934.552 695.101,916.375C692.504,909.424 693.969,901.605 698.908,896.066C698.908,896.066 724.168,867.734 724.168,867.734C723.388,859.374 723.388,850.96 724.168,842.601L698.908,814.268C693.969,808.729 692.504,800.911 695.101,793.959C701.892,775.783 711.661,758.863 724.007,743.894C724.754,742.987 747.825,719.917 748.614,719.244ZM833.765,760.108C831.587,762.657 828.777,764.65 825.558,765.853C815.649,769.555 806.425,774.881 798.264,781.611C793.587,785.469 787.412,786.996 781.476,785.765C781.476,785.765 777.01,784.839 771.329,783.66L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C788.162,821.677 787.758,828.416 788.065,835.131C791.678,822.344 798.662,810.966 807.996,802.019C808.719,801.265 829.407,780.576 830.162,779.853C843.287,766.161 861.644,757.524 882.006,757.169C881.316,755.983 880.744,754.718 880.306,753.391L869.505,720.696C867.929,720.572 866.351,720.475 864.773,720.407L861.931,729.009C860.771,732.521 858.677,735.596 855.931,737.942C855.252,738.738 854.51,739.479 853.715,740.159C853.035,740.954 834.561,759.428 833.765,760.108ZM785.595,861.791C785.245,862.261 784.874,862.717 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L801.408,901.11C792.625,890.132 786.917,876.589 785.595,861.791ZM860.232,928.783C860.921,929.969 861.493,931.234 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C874.309,965.38 875.886,965.477 877.464,965.545L880.306,956.943C881.466,953.431 883.56,950.356 886.306,948.01C886.986,947.214 907.676,926.524 908.472,925.844C910.65,923.295 913.461,921.302 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 965.227,901.113 970.908,902.292L957.757,887.541C953.723,883.016 951.959,876.905 952.961,870.926C954.075,864.275 954.479,857.536 954.173,850.821C950.559,863.608 943.575,874.986 934.242,883.933C933.518,884.688 912.83,905.376 912.076,906.099C898.951,919.791 880.593,928.428 860.232,928.783ZM956.642,824.161C956.992,823.691 957.364,823.235 957.757,822.794C957.757,822.794 980.672,797.092 980.672,797.091C977.631,790.717 974.095,784.592 970.095,778.771L940.829,784.842C949.612,795.82 955.32,809.363 956.642,824.161ZM891.538,863.396C892.202,860.762 892.554,858.006 892.554,855.167C892.554,836.608 877.487,821.541 858.927,821.541C856.089,821.541 853.333,821.893 850.699,822.556C850.036,825.19 849.683,827.947 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C886.148,864.412 888.905,864.059 891.538,863.396Z" style="fill:rgb(91,33,182);"/>
+                </g>
+                <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                    <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                </g>
+                <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                    <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                </g>
+                <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                    <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,757.158C923.946,757.158 956.937,790.149 956.937,830.785C956.937,871.42 923.946,904.412 883.31,904.412C842.674,904.412 809.683,871.42 809.683,830.785C809.683,790.149 842.674,757.158 883.31,757.158ZM883.31,797.158C864.751,797.158 849.683,812.226 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C901.869,864.412 916.937,849.344 916.937,830.785C916.937,812.226 901.869,797.158 883.31,797.158Z" style="fill:rgb(192,132,252);"/>
+                </g>
+            </g>
+            <g id="Open">
+                <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                    <path d="M612.752,414.417L612.755,414.399C614.319,403.074 617.1,391.317 621.202,379.208C621.219,379.158 621.236,379.108 621.254,379.058C642.929,316.699 705.583,287.576 764.273,287.576C857.693,287.576 899.91,355.117 909.048,409.366L912.08,406.88L920.961,403.785L926.073,403.523L931.434,404.387L931.989,404.54C932.335,404.635 932.679,404.74 933.019,404.854C933.019,404.854 974.915,418.876 974.914,418.876C989.032,418.097 1002.75,419.574 1015.32,423.041C1050.44,432.728 1078.94,457.158 1092.88,488.192C1110.76,451.897 1150.23,424.424 1212.42,434.095C1239.04,438.234 1256.7,448.747 1268.64,461.131C1275.52,468.266 1280.49,476.151 1284.04,484.118L1284.99,482.987L1293.13,478.28L1298.1,477.063L1303.53,476.905L1304.1,476.951C1304.46,476.98 1304.81,477.018 1305.17,477.066C1305.17,477.066 1334.69,481.041 1334.69,481.041C1346.52,479.74 1357.72,479.533 1368.54,480.404C1438.82,486.06 1487.4,534.497 1482.08,600.62L1481.32,610.093C1480.51,620.186 1481.57,628.665 1488.4,636.108L1487.67,635.351L1492.45,641.009L1495.93,647.625L1497.49,653.901L1497.6,659.077C1497.52,660.131 1491.5,697.889 1491.43,698.792L1490.09,705.087L1487.17,710.887L1483.11,715.574L1479.26,718.437L1478.66,719.013C1473.59,722.475 1448.44,737.641 1448.44,737.641L1449.32,737.075L1438.88,741.908L1427.94,742.929C1425.38,742.723 1416.57,740.653 1406.2,734.34C1389.73,724.313 1366.97,703.451 1363.86,667.715C1362.1,679.162 1358.42,702.879 1358.42,702.879L1358.6,701.393L1357.58,706.702L1355.61,711.379L1349.67,718.691L1341.5,723.391L1336.57,724.585L1331.16,724.74L1330.59,724.693C1330.26,724.667 1329.93,724.632 1329.6,724.588L1272.41,717.097C1272.19,717.068 1271.98,717.036 1271.76,717L1262.63,713.726L1255.14,707.13L1250.74,698.303L1249.84,688.884C1249.87,688.54 1249.91,688.196 1249.95,687.853L1259.27,617.763C1254.48,620.155 1248.87,622.015 1242.29,623.164C1240.48,623.48 1238.57,623.762 1236.57,624.009C1235.96,628.258 1235.46,631.658 1235.4,632.073L1232.32,641.012C1229,647.924 1220.84,662.066 1215.85,669.847C1215.68,670.117 1215.5,670.383 1215.31,670.645L1208.75,677.837L1202,682.239L1191.47,685.368L1180.38,685.146L1176.97,684.615C1128.26,677.041 1098.27,650.794 1084.5,619.41C1074.54,640.111 1059.38,655.378 1040.91,664.889C1017.42,676.986 988.146,679.803 956.468,671.066C951.326,669.647 946.309,667.961 941.466,666.025L926.148,712.05C926.083,712.246 926.015,712.441 925.943,712.635L921.014,720.988L913.129,727.106L903.633,729.774L894.214,728.882C893.861,728.785 893.511,728.678 893.164,728.561L838.479,710.193L839.53,710.514L834.479,708.504L830.194,705.63L824.055,698.154L821.104,689.036L820.955,684.026L821.824,678.908L821.977,678.353C821.995,678.287 822.014,678.222 822.032,678.157L822.706,673.235L822.859,672.679C822.877,672.614 822.896,672.548 822.915,672.483L823.588,667.561L823.742,667.006C823.76,666.94 823.778,666.875 823.797,666.809L824.471,661.887L824.624,661.332C824.642,661.267 824.66,661.201 824.679,661.136L825.353,656.214L825.506,655.659C825.524,655.593 825.543,655.528 825.561,655.462L826.235,650.54L826.388,649.985C826.406,649.919 826.425,649.854 826.444,649.789L827.117,644.867L827.271,644.311C827.289,644.246 827.307,644.18 827.326,644.115L828,639.193L828.153,638.638C828.242,638.313 828.34,637.99 828.446,637.67L846.94,581.81C817.038,604.131 780.223,616.124 748.305,616.124C671.85,616.124 605.041,559.525 605.041,476.028C605.041,467.083 605.838,457.816 607.487,448.278C608.094,444.183 612.083,418.528 612.752,414.417ZM790.912,458.612L790.912,458.61C787.598,443.525 777.649,429.212 756.945,429.212C743.147,429.212 734.01,435.276 728.478,443.499C733.147,461.149 748.071,472.76 764.273,472.76C776.166,472.76 785.212,467.091 790.912,458.612Z" style="fill:rgb(80,7,36);"/>
+                </g>
+                <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                    <path d="M632.531,417.395C633.925,407.173 636.441,396.561 640.145,385.624C658.865,331.768 713.585,307.576 764.273,307.576C856.433,307.576 890.993,383.608 890.993,431.704C890.993,438.849 890.358,445.719 889.159,452.306C888.912,454.22 884.206,484.479 883.866,486.347C874.812,556.31 802.991,596.124 748.305,596.124C682.641,596.124 625.041,547.74 625.041,476.028C625.041,468.107 625.761,459.898 627.238,451.437C627.494,449.559 632.199,419.299 632.531,417.395ZM811.755,462.297C808.871,436.154 792.895,409.212 756.945,409.212C730.795,409.212 715.373,423.215 707.498,440.12C711.482,471.866 737.027,492.76 764.273,492.76C786.905,492.76 803.258,480.201 811.755,462.297ZM847.255,647.501C847.013,646.551 847,645.524 847.28,644.511L847.433,643.955L919.032,427.688C920.152,424.711 923.34,422.901 926.116,423.667L926.671,423.82L972.347,439.107C985.511,437.957 998.339,439.105 1010,442.322C1056.58,455.168 1089.71,499.051 1080.64,546.893C1080.41,548.777 1074,589.404 1072.82,593.679C1058.88,644.208 1014.26,666.258 961.785,651.785C950.125,648.569 939.201,643.764 929.848,637.599L907.171,705.734C905.975,708.989 902.864,710.521 899.532,709.602L844.848,691.234C842.071,690.468 840.262,687.28 841.104,684.226L841.257,683.671L841.962,681.542C841.719,680.593 841.707,679.565 841.986,678.552L842.139,677.997L842.844,675.869C842.602,674.919 842.589,673.892 842.869,672.879L843.022,672.323L843.726,670.195C843.484,669.246 843.471,668.218 843.751,667.205L843.904,666.65L844.609,664.521C844.366,663.572 844.354,662.545 844.633,661.532L844.786,660.976L845.491,658.848C845.248,657.899 845.236,656.871 845.515,655.858L845.668,655.303L846.373,653.174C846.13,652.225 846.118,651.197 846.397,650.184L846.551,649.629L847.255,647.501ZM1002.3,551.339C998.055,542.959 990.041,536.492 979.452,533.572C975.01,532.347 970.061,531.878 964.958,531.964L958.449,551.34C962.843,554.288 967.966,556.802 973.243,558.258C974.951,558.729 991.099,563.182 1002.3,551.339ZM1096.58,562.396C1096.73,561.452 1102.61,523.627 1102.76,522.681C1109.09,481.986 1144.47,443.769 1209.35,453.858C1279.93,464.832 1273.28,528.211 1271.82,537.603C1271.67,538.513 1265.75,576.612 1265.64,577.318C1263.61,590.408 1256.52,600.382 1238.84,603.462C1233.2,604.453 1226.37,605.023 1219.25,605.24C1219.25,605.586 1215.8,627.954 1215.63,629C1215.19,631.846 1204.78,650.046 1199.01,659.058C1196.03,663.258 1191.71,666.667 1183.45,665.383L1180.04,664.852C1115.44,654.807 1089.86,605.652 1096.58,562.396ZM1177.74,567.147C1177.91,566.104 1181.57,543.215 1181.85,542.724C1175.88,543.144 1170.25,545.887 1165.85,550.525C1168.19,556.603 1172.07,562.375 1177.74,567.22C1177.74,567.191 1177.74,567.167 1177.74,567.147ZM1289.54,541.835C1289.61,541.484 1295.72,502.12 1295.72,502.12C1296.26,498.985 1299.05,496.61 1301.92,496.841L1302.5,496.887L1334.51,501.197C1345.89,499.801 1356.61,499.508 1366.94,500.34C1425.22,505.03 1466.56,544.184 1462.15,599.015L1461.38,608.489C1460.09,624.565 1462.78,637.783 1473.67,649.639C1475.28,651.213 1477.92,654.315 1477.67,657.473C1477.58,658.527 1471.57,696.285 1471.49,697.188C1471.35,698.91 1470.35,700.563 1468.23,701.837C1468.18,702.411 1438.12,720.506 1438.12,720.506C1435.07,722.572 1432.13,723.202 1429.54,722.994C1424.38,722.578 1379.67,703.667 1383.78,652.568L1384.57,642.807C1386.96,613.082 1373.74,599.241 1353.37,596.145L1344.84,660.073C1344.8,660.541 1338.66,699.789 1338.66,699.789C1338.43,702.659 1335.64,705.035 1332.77,704.804L1332.2,704.758L1275.01,697.266C1271.59,696.702 1269.5,693.934 1269.78,690.489L1289.54,541.835Z" style="fill:rgb(190,24,93);"/>
+                </g>
+                <g transform="matrix(1,0,0,1,-43.4435,390.084)">
+                    <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                        <path d="M890.993,431.704C890.993,383.608 856.433,307.576 764.273,307.576C713.585,307.576 658.865,331.768 640.145,385.624C634.097,403.48 631.217,420.472 631.217,436.312C631.217,508.024 688.817,556.408 754.481,556.408C812.945,556.408 890.993,510.904 890.993,431.704ZM764.273,492.76C734.609,492.76 706.961,467.992 706.961,431.416C706.961,405.208 721.361,369.496 763.121,369.496C803.153,369.496 818.417,402.904 818.417,431.416C818.417,463.96 798.545,492.76 764.273,492.76Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                        <path d="M658.955,513.568C645.897,498.25 636.678,479.342 632.996,457.701L714.963,397.795C709.338,408.549 706.961,420.767 706.961,431.416C706.961,446.421 711.614,459.439 719.15,469.574L658.955,513.568ZM752.552,370.323L821.848,319.678C842.275,329.346 857.63,343.956 868.616,360.337L812.433,401.398C804.743,383.652 789.179,369.496 763.121,369.496C759.381,369.496 755.862,369.783 752.552,370.323ZM816.987,416.323L876.142,373.089C881.54,383.546 885.366,394.366 887.782,404.821L813.016,459.464C816.564,450.939 818.417,441.352 818.417,431.416C818.417,426.466 817.957,421.368 816.987,416.323ZM767.582,492.669L697.945,543.564C687.488,538.487 677.836,531.996 669.311,524.252L729.459,480.292C739.38,488.271 751.644,492.76 764.273,492.76C765.391,492.76 766.495,492.73 767.582,492.669Z" style="fill:rgb(254,205,211);"/>
+                    </g>
+                    <g transform="matrix(0.993411,0.114605,-0.114605,0.993411,47.4331,-108.207)">
+                        <path d="M979.985,630.424C983.441,630.424 986.033,628.12 986.321,624.664L990.065,552.952C1000.72,556.408 1012.53,558.136 1024.62,558.136C1079.06,558.136 1116.21,525.016 1116.21,472.6C1116.21,420.184 1070.7,383.32 1020.02,383.32C1007.92,383.32 995.249,385.624 982.865,390.232L934.769,387.64L934.193,387.64C931.313,387.64 928.721,390.232 928.433,393.4L916.913,620.92L916.913,621.496C916.913,624.664 919.505,627.256 922.385,627.256L979.985,630.424ZM995.825,441.784C1000.72,440.344 1005.62,439.48 1010.23,439.48C1030.38,439.48 1045.36,453.304 1045.36,473.176C1045.36,504.856 1017.71,504.856 1015.41,504.856C1007.35,504.856 998.993,502.552 992.657,499.384L995.825,441.784Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(1,0,0,1,-17.5818,-14.5051)">
+                        <path d="M1240.05,557.56C1248.4,557.56 1252.14,553.528 1254.45,548.92C1258.77,539.128 1266.26,519.544 1266.26,516.664C1266.26,511.768 1261.36,509.176 1257.33,509.176L1256.75,509.176C1254.74,509.464 1252.43,509.464 1250.42,509.464C1214.42,509.464 1199.44,486.424 1199.44,465.976C1199.44,448.12 1210.96,436.024 1224.79,436.024C1236.88,436.024 1242.35,445.24 1242.35,447.832C1242.35,451.864 1203.27,460.514 1188.3,463.97C1184.55,464.834 1182.25,466.274 1182.25,469.442C1182.25,470.594 1187.72,489.314 1191.18,498.818C1192.33,502.274 1193.77,504.29 1198.38,504.29C1213.35,503.714 1271.73,492.472 1285.27,487.864C1302.26,482.104 1307.73,471.16 1307.73,457.912C1307.73,448.408 1304.56,384.76 1233.14,384.76C1167.47,384.76 1138.38,427.96 1138.38,469.144C1138.38,512.92 1171.22,557.56 1236.59,557.56L1240.05,557.56Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                        <path d="M1517.97,474.04C1517.97,419.032 1473.62,383.32 1415.15,383.32C1404.79,383.32 1394.13,384.472 1382.9,386.776L1350.64,385.048L1350.07,385.048C1347.18,385.048 1344.59,387.64 1344.31,390.808L1336.53,540.568C1336.53,544.024 1338.83,546.616 1342.29,546.904L1399.89,549.784L1400.46,549.784C1403.35,549.784 1405.94,547.192 1405.94,544.312L1411.41,439.768C1432.43,440.92 1447.12,453.592 1447.12,483.832L1447.12,493.624C1447.12,544.888 1493.2,560.152 1498.38,560.152C1500.98,560.152 1503.86,559.288 1506.74,556.984C1506.74,556.984 1535.25,536.536 1535.25,535.96C1537.27,534.52 1538.13,532.792 1538.13,531.064C1538.13,527.896 1535.25,525.016 1533.52,523.576C1521.71,512.632 1517.97,499.672 1517.97,483.544L1517.97,474.04Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                        <path d="M1336.98,531.794L1341.07,453.028L1421.76,383.474C1446.18,384.621 1467.83,392.129 1484.38,404.732L1434.2,447.993C1428.18,442.845 1420.37,440.26 1411.41,439.768L1409.88,468.954L1336.98,531.794Z" style="fill:rgb(254,205,211);"/>
+                    </g>
+                </g>
+            </g>
+            <g id="EUICC">
+                <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                    <path d="M1529.66,323.25L1530.24,318.097L1531.91,313.067L1537.48,304.991L1545.56,299.416L1550.59,297.742L1556.23,297.117L1555.14,297.147L1607.55,294.267C1607.92,294.247 1608.28,294.237 1608.65,294.237L1609.28,294.237L1685.36,290.232C1685.71,290.214 1686.06,290.205 1686.41,290.205L1686.99,290.205L1692.62,290.829L1697.63,292.486L1705.57,297.875L1711.07,305.392L1713.83,315.168C1713.85,315.415 1713.87,315.662 1713.88,315.91L1716.18,366.022C1716.23,366.997 1716.2,367.974 1716.1,368.945L1712.25,407.169L1712.35,405.165L1711.73,410.803L1710.07,415.805L1704.68,423.745L1702.17,425.582L1701.8,454.178C1701.8,454.566 1701.78,454.954 1701.75,455.342C1701.74,455.569 1701.35,459.409 1700.84,464.369L1704.27,464.726L1709.3,466.307L1717.59,471.827L1720.39,475.797L1750.15,343.037C1750.23,342.693 1750.31,342.351 1750.41,342.011L1750.56,341.457L1755.18,332.244L1762.58,325.657L1771.65,322.228L1781.57,322.274C1781.79,322.317 1782.01,322.364 1782.23,322.414L1839.3,335.429C1839.62,335.502 1839.94,335.583 1840.26,335.671L1840.81,335.827L1845.81,337.802L1850.15,340.632L1856.52,348.037L1859.79,356.937L1859.72,366.648C1859.81,366.106 1859.92,365.462 1859.92,365.462C1859.92,365.462 1859.88,365.868 1859.84,366.203C1859.15,372.715 1856,403.718 1855.87,404.404C1855.83,404.61 1855.79,404.814 1855.74,405.018C1840.04,474.681 1834.97,497.588 1832.54,508.606C1834.98,512.172 1839.03,514.495 1843.31,515.695C1852.53,518.282 1863.62,514.988 1867.93,503.383C1867.94,503.366 1867.95,503.349 1867.95,503.332C1872.56,491.026 1877.62,473.928 1882.81,455.42C1889.74,430.734 1896.6,403.073 1902.51,377.805C1902.57,377.52 1902.65,377.236 1902.73,376.954L1902.88,376.4L1904.79,371.384L1907.74,366.67L1911.59,362.679L1915.93,359.72L1921.17,357.555L1925.98,356.587L1932.13,356.545L1937.33,357.512L1992.79,373.066L1997.92,375.104L2002.36,378.011L2006.47,382.81L2009.04,357.694L2010.17,352.278L2012.29,347.386L2018.84,339.595L2027.79,334.762L2033.01,333.671L2038.55,333.659L2101.87,340.132L2107.28,341.264L2112.17,343.389L2119.96,349.934L2124.8,358.887L2125.89,364.108L2125.9,369.642L2115.53,471.116C2143.21,409.347 2206.89,385.97 2270.03,392.426C2299.72,395.461 2326.88,405.708 2345.87,421.131C2346.07,421.298 2346.28,421.47 2346.47,421.646L2350.73,426.445L2354.33,433.635L2355.74,439.783L2355.83,446.488C2355.81,446.624 2355.65,448.219 2355.39,450.706C2394.87,378.213 2471.61,366.264 2538.55,390.564C2566.6,400.747 2590.44,417.309 2605.09,436.895C2605.25,437.108 2605.4,437.324 2605.55,437.543L2608.8,444.04L2610.14,450.046L2610.27,455.837C2610.27,455.837 2609.5,460.324 2609.5,460.335C2608.32,472.137 2605.17,500.328 2604.72,501.565L2600.54,509.227C2600.46,509.325 2600.38,509.423 2600.3,509.52L2569.61,546.79C2569.54,546.883 2569.46,546.976 2569.38,547.068L2563.29,552.297L2557.1,555.157L2557.72,555.483L2562.91,560.182L2567.64,567.768L2569.47,574.713L2569.34,573.79C2569.34,573.79 2576.42,617.086 2576.45,617.261L2577.04,625.138C2577.04,625.138 2576.38,629.107 2576.38,629.115C2575.36,639.604 2571.95,670.32 2571.52,671.508L2568.53,677.46L2564.22,682.586L2554.28,689.179C2508.17,710.726 2463.62,711.215 2426.71,697.818C2400.61,688.344 2378.3,671.989 2361.82,651.186L2361.22,657.045L2359.78,663.547L2356.85,669.569L2348.81,678.388C2309.35,710.528 2266.26,721.867 2227.21,717.875C2166.55,711.673 2115.4,668.929 2101.42,609.116L2099.18,631.051L2098.04,636.468L2095.92,641.36L2089.37,649.151L2080.42,653.983L2075.2,655.075L2069.66,655.087L2006.35,648.614L2000.93,647.482L1996.04,645.357L1988.25,638.812L1983.42,629.858L1982.32,624.637L1982.31,619.104L1994.61,498.787C1992.33,507.533 1989.89,516.562 1987.37,525.565C1981.93,544.968 1976.1,564.57 1970.05,580.691C1942.99,654.487 1869.67,675.445 1808.25,658.22C1770.35,647.591 1737.45,622.729 1722.23,587.267L1722,588.508L1716.83,596.917L1708.76,603.114L1703.78,605.045L1698.39,605.978C1698.27,605.986 1698.15,605.994 1698.04,606L1623.16,610.032C1623,610.04 1622.84,610.047 1622.68,610.052L1620.93,610.349L1621.95,610.323L1565.79,613.203C1565.45,613.22 1565.11,613.229 1564.77,613.229L1564.19,613.229L1558.49,612.587L1553.36,610.839L1545.34,605.142L1540.11,597.538L1537.64,588.266C1537.62,588.062 1537.61,587.859 1537.6,587.655L1525.79,363.015C1525.74,361.986 1525.76,360.955 1525.87,359.931L1529.71,322.283L1529.66,323.25ZM2332.02,549.385C2332.09,548.761 2332.16,548.136 2332.23,547.51C2332.45,545.229 2333.61,533.848 2334.54,524.786L2328.96,536.557C2328.91,536.666 2328.86,536.775 2328.8,536.883L2324.18,543.44L2321.07,545.949L2321.51,545.913L2328.84,547.691L2332.02,549.385ZM2533.29,552.067L2533.05,551.946C2533.05,551.946 2527.22,546.283 2527.4,546.524C2522.66,540.295 2512.51,533.182 2501.15,529.058C2490.46,525.177 2480.78,524.606 2472.69,528.046C2466.84,530.534 2462.07,535.044 2458.31,541.082C2462.57,548.738 2470.22,554.495 2479.36,557.815C2493.84,563.071 2512.48,562.197 2530.54,553.069C2530.72,552.977 2530.91,552.887 2531.09,552.8L2533.29,552.067ZM1622.69,610.051C1624.08,610.004 1626,609.79 1627.83,609.179L1622.69,610.051ZM2301.84,552.027L2301.48,552.057L2294.76,550.474C2294.76,550.474 2287.72,546.405 2287.96,546.595C2281.85,541.707 2270.27,537.286 2258.24,536.056C2242.55,534.452 2230.31,539.236 2223.53,549.756C2228.51,561.063 2240.18,567.707 2253.42,569.061C2268.73,570.626 2286.56,565.249 2301.84,552.027Z" style="fill:rgb(46,16,101);"/>
+                </g>
+                <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                    <path d="M2002.21,621.138L2028.93,359.728C2029.31,356.004 2032.79,353.174 2036.51,353.555L2099.83,360.028C2103.55,360.409 2106.38,363.883 2106,367.608L2079.28,629.017C2078.9,632.742 2075.42,635.571 2071.7,635.191L2008.38,628.717C2004.66,628.336 2001.83,624.863 2002.21,621.138ZM1545.76,361.965L1549.61,324.317L1549.61,323.741C1549.61,320.285 1552.78,317.117 1556.23,317.117L1608.65,314.237L1609.8,314.237L1686.41,310.205L1686.99,310.205C1690.44,310.205 1693.61,313.373 1693.9,316.829L1696.2,366.941L1692.35,405.165C1692.35,408.621 1689.18,411.789 1685.73,412.077L1682.35,412.251L1681.8,453.917C1681.76,454.559 1678.62,485.045 1678.61,485.206L1698.22,484.157L1698.79,484.157C1702.54,484.157 1705.71,487.325 1705.71,490.781L1707.72,540.893C1707.72,541.708 1703.87,578.541 1703.87,578.541C1703.87,582.285 1700.99,585.741 1696.96,586.029L1622.08,590.061C1621.79,590.061 1621.22,590.349 1620.93,590.349L1564.77,593.229L1564.19,593.229C1560.74,593.229 1557.86,590.061 1557.57,586.605L1545.76,361.965ZM1737.5,495.591C1737.93,490.61 1738.72,485.491 1739.89,480.242L1769.66,347.412L1769.82,346.858C1770.83,343.253 1774.38,341.257 1777.79,341.913L1834.86,354.928L1835.41,355.084C1838.74,356.017 1840.73,359.568 1840.08,362.973C1839.98,363.389 1836.37,399.892 1836.23,400.621C1816.75,487.073 1813.63,501.561 1811.61,510.641C1815.31,523.002 1825.75,531.543 1837.91,534.952C1856.21,540.085 1878.13,533.372 1886.68,510.346C1891.45,497.624 1896.7,479.955 1902.07,460.821C1909.07,435.864 1916.02,407.901 1921.98,382.355L1922.14,381.801C1923.77,375.977 1929.15,375.991 1931.92,376.769L1987.38,392.323C1990.99,393.334 1993.18,397.24 1992.45,400.923C1992.37,401.306 1988.75,437.82 1988.6,438.571C1984.58,457.184 1976.9,488.83 1968.11,520.165C1962.82,539.021 1957.18,558.077 1951.28,573.771C1928.32,636.428 1865.78,653.585 1813.65,638.963C1766.18,625.65 1727.35,586.23 1734,529.817C1734.1,528.683 1737.36,496.739 1737.5,495.591ZM2118.35,562.156C2118.41,561.55 2122.15,525.047 2122.2,524.508C2131.08,437.697 2200.1,405.381 2268,412.323C2293.5,414.929 2316.95,423.407 2333.26,436.654C2335.11,438.291 2336.22,441.589 2335.93,444.454C2335.86,445.139 2331.94,483.535 2331.56,484.365L2310.89,527.993C2309.8,530.197 2306.67,532.483 2303.51,532.16C2302.37,532.043 2301.25,531.64 2300.45,530.979C2292.16,524.341 2276.61,517.83 2260.28,516.16C2231.63,513.231 2211.11,525.354 2202.07,547.952C2206.98,571.507 2227.03,586.467 2251.39,588.957C2271.44,591.007 2294.99,584.44 2315,567.089C2316.26,566.06 2318.04,565.663 2319.47,565.809C2322.34,566.102 2325.31,568.144 2326.22,570.553L2343.79,611.141C2344.73,613.264 2345.38,615.358 2345.18,617.363C2345.12,617.946 2341.39,654.456 2341.33,655.011C2341.07,657.59 2339.66,660.051 2336.18,662.881C2301.44,691.174 2263.62,701.493 2229.24,697.978C2163.63,691.271 2110.91,634.929 2118.35,562.156ZM2355.61,515.419C2356.56,504.634 2358.96,493.637 2362.97,482.606C2392.74,400.58 2467.56,386.072 2531.72,409.364C2555.82,418.11 2576.49,432.051 2589.07,448.874C2590.36,450.748 2590.7,453.826 2589.98,456.412C2590.05,457.555 2586.38,493.465 2585.92,494.74C2585.62,495.552 2585.43,496.093 2584.86,496.807L2554.17,534.077C2552.58,535.947 2548.98,537.401 2546.01,536.32C2544.92,535.927 2543.94,535.263 2543.32,534.427C2536.9,525.966 2523.41,515.86 2507.98,510.259C2475.6,498.505 2449.24,510.468 2436.39,539.959C2441.03,556.869 2454.59,570.098 2472.54,576.614C2491.49,583.494 2515.92,582.866 2539.56,570.919C2541.03,570.229 2542.86,570.278 2544.21,570.769C2546.92,571.752 2549.3,574.457 2549.6,577.016L2556.74,620.662C2557.11,622.803 2557.24,624.857 2556.69,626.664C2556.75,627.869 2553.14,663.515 2552.72,664.683C2551.83,667.12 2549.87,669.163 2545.81,671.06C2505.22,690.028 2466.02,690.812 2433.54,679.019C2380.44,659.742 2345.39,607.458 2352.11,549.644C2352.21,548.506 2355.48,516.562 2355.61,515.419Z" style="fill:rgb(91,33,182);"/>
+                </g>
+                <g transform="matrix(1,0,0,1,-45.5223,-53.0944)">
+                    <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-572.922,875.907)">
+                        <path d="M1700.81,548.381C1704.84,548.093 1707.72,544.637 1707.72,540.893L1705.71,490.781C1705.71,487.325 1702.54,484.157 1698.79,484.157L1698.22,484.157L1628.23,487.901L1626.79,461.117L1674.6,461.117C1678.63,461.117 1681.51,457.949 1681.8,453.917L1682.38,409.853L1682.38,409.277C1682.38,405.533 1678.92,402.653 1675.47,402.653L1623.91,402.653L1622.47,377.885L1689.58,374.429C1693.03,374.141 1696.2,370.973 1696.2,367.517L1696.2,366.941L1693.9,316.829C1693.61,313.373 1690.44,310.205 1686.99,310.205L1686.41,310.205L1609.8,314.237L1608.65,314.237L1556.23,317.117C1552.78,317.117 1549.61,320.285 1549.61,323.741L1549.61,324.317L1561.42,548.957C1561.71,552.413 1564.59,555.581 1568.04,555.581L1568.62,555.581L1624.78,552.701C1625.07,552.701 1625.64,552.413 1625.93,552.413L1700.81,548.381Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(0.98532,0.170719,-0.170719,0.98532,-440.459,422.474)">
+                        <path d="M1908.79,310.456C1905.9,310.456 1900.72,311.896 1900.72,317.944L1900.72,318.52C1901.87,344.728 1902.74,373.528 1902.74,399.448C1902.74,419.32 1902.45,437.752 1901.3,451.288C1899.28,475.768 1879.99,488.152 1860.98,488.152C1842.55,488.152 1824.69,476.632 1823.54,453.304C1822.1,421.336 1823.54,455.32 1816.62,321.976C1816.34,318.52 1813.46,315.64 1810,315.64L1809.42,315.64L1750.96,318.52C1747.51,318.808 1744.62,321.688 1744.62,325.432L1744.62,326.008L1751.83,461.944C1755.28,526.168 1806.55,557.56 1859.25,557.56C1913.39,557.56 1968.98,524.152 1974.16,457.624C1975.6,440.92 1975.89,421.048 1975.89,401.464C1975.89,368.92 1974.74,336.376 1973.59,317.368C1973.3,313.624 1970.13,310.456 1966.38,310.456L1908.79,310.456Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(1,0,0,1,-537.877,707.46)">
+                        <path d="M2090.51,551.8C2094.26,551.8 2097.43,548.632 2097.43,544.888L2097.43,319.96C2097.43,316.216 2094.26,313.048 2090.51,313.048L2026.87,313.048C2023.12,313.048 2019.95,316.216 2019.95,319.96L2019.95,544.888C2019.95,548.632 2023.12,551.8 2026.87,551.8L2090.51,551.8Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(1,0,0,1,-542.093,747.563)">
+                        <path d="M2341.36,459.352C2340.21,457.048 2337.04,455.32 2334.16,455.32C2332.72,455.32 2330.99,455.896 2329.84,457.048C2311.7,476.344 2288.95,485.272 2268.78,485.272C2238.55,485.272 2212.91,465.688 2212.91,431.704C2212.91,396.568 2233.94,374.104 2270.22,374.104C2286.64,374.104 2302.77,379 2311.7,384.76C2312.56,385.336 2313.71,385.624 2314.87,385.624C2318.03,385.624 2320.91,383.032 2321.78,380.728L2337.91,335.224C2338.19,334.36 2338.19,333.784 2338.19,332.92C2338.19,330.04 2336.75,326.872 2334.74,325.432C2317.17,313.912 2292.98,307.864 2267.35,307.864C2199.09,307.864 2133.71,347.032 2133.71,434.296C2133.71,507.448 2191.89,558.136 2257.84,558.136C2292.4,558.136 2328.98,544.024 2360.66,512.344C2363.83,509.176 2364.98,506.584 2364.98,503.992C2364.98,501.976 2364.11,499.96 2362.96,497.944L2341.36,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                    </g>
+                    <g transform="matrix(0.969808,0.24387,-0.24387,0.969808,-375.869,113.966)">
+                        <path d="M2588.18,459.352C2587.03,457.048 2583.86,455.32 2580.98,455.32C2579.54,455.32 2577.81,455.896 2576.66,457.048C2558.51,476.344 2535.76,485.272 2515.6,485.272C2485.36,485.272 2459.73,465.688 2459.73,431.704C2459.73,396.568 2480.75,374.104 2517.04,374.104C2533.46,374.104 2549.59,379 2558.51,384.76C2559.38,385.336 2560.53,385.624 2561.68,385.624C2564.85,385.624 2567.73,383.032 2568.59,380.728L2584.72,335.224C2585.01,334.36 2585.01,333.784 2585.01,332.92C2585.01,330.04 2583.57,326.872 2581.55,325.432C2563.99,313.912 2539.79,307.864 2514.16,307.864C2445.91,307.864 2380.53,347.032 2380.53,434.296C2380.53,507.448 2438.7,558.136 2504.66,558.136C2539.22,558.136 2575.79,544.024 2607.47,512.344C2610.64,509.176 2611.79,506.584 2611.79,503.992C2611.79,501.976 2610.93,499.96 2609.78,497.944L2588.18,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                    </g>
+                </g>
+            </g>
+            <path d="M988.333,1002.5C988.379,1003.47 988.508,1005.49 988.818,1007.18C989.725,1012.13 991.45,1018.87 993.403,1028.25C994.303,1032.57 991.525,1036.81 987.202,1037.71C982.88,1038.61 978.639,1035.83 977.739,1031.51C974.599,1016.43 972.184,1007.68 972.265,1002.27C972.315,998.949 973.077,996.344 974.363,994.171L977.247,990.719C978.213,989.878 979.348,989.105 980.697,988.415C983.011,987.231 987.42,986.061 992.612,985.228C1002.58,983.629 1015.86,982.795 1017.84,982.672C1022.25,982.398 1026.05,985.753 1026.32,990.16C1026.6,994.567 1023.24,998.367 1018.83,998.641C1016.97,998.757 1004.5,999.525 995.145,1001.03C992.296,1001.48 989.786,1001.89 988.333,1002.5Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1195.95,1039.37C1195.02,1043.68 1190.77,1046.44 1186.45,1045.51C1182.13,1044.59 1179.38,1040.33 1180.3,1036.02C1180.85,1033.44 1184.24,1017.62 1186.73,1003.7C1187.37,1000.08 1190.41,997.365 1194.08,997.125C1204.16,996.469 1204.01,996.191 1214,997.195C1218.39,997.636 1221.6,1001.56 1221.16,1005.96C1220.71,1010.35 1216.79,1013.56 1212.4,1013.11C1206.5,1012.52 1204.67,1012.46 1201.35,1012.66C1199.02,1024.99 1196.43,1037.12 1195.95,1039.37Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1289.49,1196.2C1285.4,1197.87 1280.73,1195.9 1279.06,1191.81C1277.39,1187.73 1279.36,1183.05 1283.45,1181.38C1291.16,1178.24 1295.88,1176.49 1299.86,1172.93C1303.92,1169.3 1307.14,1163.9 1312.33,1154.03C1314.38,1150.12 1319.22,1148.61 1323.13,1150.66C1327.04,1152.72 1328.54,1157.56 1326.49,1161.47C1320.01,1173.81 1315.6,1180.32 1310.53,1184.86C1305.38,1189.46 1299.47,1192.13 1289.49,1196.2Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1463.37,993.495C1463.11,995.117 1462.65,998.235 1462.56,1000.72C1462.29,1008.23 1462.8,1016.95 1462.83,1021.2C1462.85,1025.62 1459.29,1029.22 1454.87,1029.25C1450.45,1029.27 1446.85,1025.7 1446.83,1021.29C1446.79,1014.44 1445.8,996.976 1447.92,988.886C1448.48,986.742 1449.26,985.008 1450.11,983.729L1452.06,981.477L1454.04,980.104C1457.58,978.226 1457.62,978.465 1473.31,975.976C1477.67,975.284 1481.77,978.263 1482.46,982.624C1483.15,986.985 1480.18,991.086 1475.82,991.778C1467.37,993.118 1465.03,993.073 1463.37,993.495Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1585.5,1098.21C1585.07,1102.6 1581.16,1105.82 1576.76,1105.4C1572.37,1104.97 1569.15,1101.05 1569.58,1096.66C1572.43,1067.37 1598.83,1046.25 1614.85,1037.04C1618.67,1034.84 1623.57,1036.16 1625.77,1039.99C1627.97,1043.82 1626.64,1048.72 1622.82,1050.91C1609.93,1058.32 1587.8,1074.63 1585.5,1098.21Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1740.17,1170.75C1743.74,1168.16 1748.75,1168.95 1751.34,1172.53C1753.93,1176.1 1753.14,1181.11 1749.56,1183.7C1735.58,1193.84 1735.59,1194.13 1721.98,1197.65C1717.71,1198.76 1713.34,1196.19 1712.23,1191.91C1711.12,1187.64 1713.7,1183.27 1717.97,1182.16C1728.96,1179.32 1728.88,1178.94 1740.17,1170.75Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1822.12,1050.48C1820.66,1054.65 1816.09,1056.85 1811.93,1055.39C1807.76,1053.93 1805.56,1049.36 1807.02,1045.19C1812.53,1029.48 1820.56,1007.67 1857.96,995.197C1862.15,993.8 1866.68,996.067 1868.08,1000.25C1869.48,1004.44 1867.21,1008.98 1863.02,1010.38C1833.01,1020.38 1826.54,1037.87 1822.12,1050.48Z" style="fill:rgb(233,213,255);"/>
+            <path d="M1930.13,1172.93C1925.81,1173.86 1921.55,1171.1 1920.63,1166.78C1919.7,1162.46 1922.46,1158.21 1926.78,1157.29C1941.59,1154.11 1941.14,1153.31 1950.54,1149.02C1954.55,1147.19 1959.3,1148.96 1961.14,1152.97C1962.97,1156.99 1961.2,1161.74 1957.18,1163.57C1946.5,1168.46 1946.99,1169.32 1930.13,1172.93Z" style="fill:rgb(233,213,255);"/>
+        </g>
+    </g>
+</svg>
diff --git a/art/OpenEUICCThicken.png b/art/OpenEUICCThicken.png
new file mode 100644
index 0000000000000000000000000000000000000000..c440df87cd6098174f5a3019ee235d2623fc5961
GIT binary patch
literal 272558
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%0D}qL%D0~#A={hpUsA@g&89uOuRR3q1l?7Hj
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

literal 0
HcmV?d00001

diff --git a/art/OpenEUICCThicken.svg b/art/OpenEUICCThicken.svg
new file mode 100644
index 000000000..0afc22947
--- /dev/null
+++ b/art/OpenEUICCThicken.svg
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 1569 969" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-516,-434)">
+        <g id="OpenEUICCThicken">
+            <path id="OpenEUICCSVG" d="M1853.49,780.506L1853.58,780.95C1853.58,780.95 1853.58,783.044 1853.57,785.83C1881.45,800.101 1901.34,826.838 1906.62,858.311C1908.24,867.99 1909.3,877.74 1909.79,887.504C1926.96,888.179 1944.26,890.701 1961.29,894.983C2002.49,905.342 2038.14,926.245 2061.72,951.859C2061.8,951.957 2061.89,952.055 2061.98,952.155L2063.57,953.946C2063.65,954.045 2063.74,954.146 2063.83,954.247C2065.64,956.376 2067.29,958.628 2068.79,960.988L2072.67,967.121C2075.26,971.213 2077.35,975.604 2078.89,980.197L2080.84,986.036C2082.1,989.804 2082.98,993.689 2083.47,997.632L2084.19,1003.38C2084.54,1006.17 2084.66,1044.76 2084.52,1046.93C2084.51,1047.02 2084.5,1047.1 2084.5,1047.19C2084.5,1047.19 2084.43,1048.02 2084.34,1049.11C2084.25,1066.09 2082.39,1101.88 2081.97,1103.56C2081.23,1106.49 2080.27,1109.36 2079.1,1112.15L2075.72,1120.2C2074.4,1123.35 2072.81,1126.38 2070.97,1129.25C2070.94,1129.31 2070.91,1129.36 2070.87,1129.41L2070.25,1130.36C2070.22,1130.41 2070.19,1130.46 2070.15,1130.52C2070.15,1130.52 2061.22,1143.94 2061.22,1143.94C2063.48,1152.31 2065.39,1159.37 2065.41,1159.44C2065.83,1161.04 2066.19,1162.66 2066.48,1164.29L2067.87,1172.07C2068.71,1176.75 2068.99,1181.52 2068.7,1186.27C2068.69,1186.36 2068.68,1186.45 2068.68,1186.53C2068.68,1186.57 2068.67,1186.63 2068.66,1186.72C2068.73,1194.5 2068.61,1217.07 2068.52,1220.49L2068.56,1219.4C2068.56,1234.49 2066.63,1274.38 2066.22,1275.99C2065.65,1278.27 2064.94,1280.52 2064.11,1282.71L2061.74,1288.94C2060.07,1293.31 2057.9,1297.47 2055.27,1301.34L2051.51,1306.87C2048.28,1311.61 2044.4,1315.86 2039.97,1319.49L2030.76,1327.06C2028.46,1328.95 2026.03,1330.66 2023.48,1332.19C1964.12,1367.69 1903.77,1373.46 1852.02,1360.45C1839.01,1357.18 1826.51,1352.7 1814.64,1347.15C1769.27,1386.06 1718.23,1402.51 1670.23,1402.51C1619.11,1402.51 1570.94,1383.84 1534.25,1351.57L1530.8,1352.67C1526.91,1353.91 1522.91,1354.74 1518.85,1355.17L1513.35,1355.74C1511.28,1355.96 1509.2,1356.07 1507.11,1356.07L1443.47,1356.07C1441.38,1356.07 1439.3,1355.96 1437.23,1355.74L1431.73,1355.17C1427.67,1354.74 1423.67,1353.91 1419.78,1352.67L1414.69,1351.05C1409.34,1349.35 1404.24,1346.9 1399.57,1343.78C1354.87,1381.62 1293.97,1394.74 1237.13,1384.89C1202.97,1378.97 1170.96,1364.82 1144.93,1343.73C1144.32,1343.85 1143.71,1343.97 1143.11,1344.08C1143.05,1344.09 1142.99,1344.1 1142.93,1344.1L1141.89,1344.28C1141.84,1344.29 1141.78,1344.3 1141.72,1344.3C1141.72,1344.3 1071.6,1355.31 1071.61,1355.31C1069.88,1355.74 1068.12,1356.09 1066.32,1356.37L1010.75,1364.94C1010.58,1364.97 1010.41,1364.99 1010.24,1365.01L1007.19,1365.4C1007.02,1365.43 1006.85,1365.45 1006.68,1365.46L1006.11,1365.52C1003.88,1365.75 1001.64,1365.85 999.395,1365.83L993.654,1365.77C989.321,1365.73 985.007,1365.21 980.785,1364.24L975.506,1363.02C969.858,1361.72 964.43,1359.61 959.389,1356.75L950.833,1351.9C944.724,1348.43 939.27,1343.92 934.721,1338.57L928.741,1331.54C924.293,1326.31 920.775,1320.36 918.342,1313.93L914.942,1304.96C913.686,1301.64 912.726,1298.22 912.074,1294.74C912.055,1294.64 912.037,1294.54 912.02,1294.44L911.709,1292.63C911.692,1292.53 911.676,1292.42 911.66,1292.32L892.891,1171.73L892.292,1171.64C892.11,1171.62 891.929,1171.59 891.749,1171.56L834.891,1161.81C832.683,1161.43 830.523,1160.93 828.433,1160.33L827.464,1160.11C823.325,1159.17 819.298,1157.79 815.451,1155.99L810.775,1153.81C805.465,1151.33 800.545,1148.09 796.175,1144.18L788.96,1137.74C783.356,1132.74 778.743,1126.72 775.359,1120.02L771.042,1111.46C768.488,1106.4 766.665,1101 765.626,1095.42L764.708,1090.5C764.085,1087.15 763.748,1083.76 763.7,1080.36C759.332,1081.36 754.991,1082.19 750.693,1082.86C643.155,1099.58 537.359,1033.82 519.097,916.374C517.255,904.527 516.359,892.101 516.534,879.175C516.509,877.376 516.506,875.567 516.523,873.748C516.522,873.065 516.522,872.344 516.521,871.593C516.521,871.552 516.521,871.5 516.521,871.437C516.512,868.214 516.521,821.396 516.523,818.716C516.506,816.917 516.51,815.106 516.534,813.284C516.331,798.494 517.535,782.924 520.366,766.658C519.353,772.475 517.734,781.429 520.461,766.123C520.466,766.092 520.472,766.063 520.479,766.034C520.479,766.034 521.347,762.416 520.479,766.034L520.477,766.032C537.158,674.503 615.823,617.84 697.55,605.132C778.477,592.548 837.408,620.776 876.326,661.592C876.542,659.161 876.906,656.742 877.418,654.35L879.167,646.174C880.389,640.461 882.439,634.957 885.252,629.837L889.348,622.382C892.237,617.123 895.898,612.328 900.21,608.155L906.518,602.05C908.698,599.941 911.035,597.999 913.509,596.243L1058.9,493.016C1060.51,491.873 1062.18,490.81 1063.89,489.831L1068.86,486.997C1072.27,485.048 1075.87,483.439 1079.6,482.193L1084.97,480.4C1088.68,479.16 1092.51,478.287 1096.39,477.793L1102.01,477.077C1105.91,476.58 1109.85,476.467 1113.77,476.741L1119.47,477.139C1123.41,477.415 1127.32,478.078 1131.13,479.121L1136.64,480.63C1140.44,481.668 1144.12,483.076 1147.64,484.834L1152.7,487.366C1156.2,489.115 1159.52,491.203 1162.62,493.599L1167.09,497.067C1170.2,499.475 1173.07,502.183 1175.64,505.151L1179.39,509.467C1180.69,510.957 1181.91,512.511 1183.05,514.121L1187.79,520.809C1200.94,505.676 1215.85,492.125 1232.22,480.453C1247.33,469.683 1264.8,463.538 1282.63,462.171C1295.44,461.189 1308.44,462.672 1320.88,466.677C1329.66,456.985 1340.18,449.201 1351.76,443.647C1359.82,439.781 1368.4,436.997 1377.28,435.399C1378.18,435.237 1379.09,435.137 1380,435.1L1401.82,434.202C1402.73,434.164 1403.65,434.189 1404.56,434.276C1432.71,436.98 1460.21,444.35 1485.94,456.083C1515.07,469.365 1535.78,495.618 1542.29,526.362L1545.69,527.032C1548.38,527.561 1551.03,528.273 1553.63,529.165C1562.15,532.096 1570.21,536.155 1577.59,541.205C1584.96,546.254 1591.67,552.293 1597.49,559.178C1599.26,561.271 1600.88,563.484 1602.35,565.8L1608.19,575.025C1609.66,577.338 1610.96,579.749 1612.1,582.241C1623.44,607.113 1630.7,633.641 1633.62,660.808C1637.46,662.133 1641.23,663.694 1644.9,665.488C1647.37,666.691 1649.75,668.061 1652.02,669.589L1654.91,671.525C1681.24,654.384 1714.45,650.469 1744.44,661.672C1770.93,671.57 1795.59,685.807 1817.41,703.8C1819.33,705.381 1821.14,707.079 1822.85,708.885L1829.66,716.092C1833.05,719.679 1835.98,723.67 1838.39,727.976L1843.15,736.475C1844.34,738.605 1845.4,740.806 1846.33,743.066C1849.4,750.564 1851.55,758.425 1852.73,766.473C1853.09,768.912 1853.29,771.372 1853.35,773.836L1853.49,780.506Z" style="fill:rgb(80,7,36);"/>
+            <path id="OpenEUICCSVG1" serif:id="OpenEUICCSVG" d="M536.52,871.418C536.511,870.296 536.522,819.383 536.523,818.585C536.506,816.855 536.51,815.114 536.535,813.362C536.535,813.32 536.536,813.279 536.536,813.239C536.333,799.556 537.449,785.146 540.07,770.087L540.153,769.618C555.219,686.95 626.809,636.372 700.624,624.894C797.308,609.86 859.29,659.193 890.537,714.163C891.854,714.184 893.169,714.27 894.478,714.421L895.05,714.487L896.04,714.629C896.056,713.828 896.097,713.028 896.161,712.23C895.989,710.096 896.102,677.979 896.219,676.518L896.217,676.495C896.048,674.366 896.049,672.23 896.219,670.107L896.217,670.083C895.909,666.217 896.164,662.326 896.976,658.533L898.725,650.358C899.539,646.549 900.906,642.88 902.781,639.467L906.877,632.012C908.803,628.506 911.244,625.309 914.118,622.527L920.427,616.422C921.88,615.016 923.438,613.722 925.087,612.551L1070.48,509.323C1071.55,508.561 1072.66,507.853 1073.81,507.201L1078.77,504.366C1081.05,503.067 1083.45,501.994 1085.93,501.164L1091.31,499.37C1093.78,498.544 1096.33,497.962 1098.92,497.632L1104.54,496.916C1107.13,496.585 1109.76,496.51 1112.38,496.693L1118.08,497.091C1120.71,497.274 1123.31,497.717 1125.85,498.412L1131.37,499.921C1133.89,500.612 1136.35,501.551 1138.69,502.723L1143.76,505.255C1146.09,506.422 1148.31,507.814 1150.37,509.411L1154.85,512.879C1156.92,514.484 1158.83,516.289 1160.55,518.268L1164.3,522.584C1165.16,523.578 1165.97,524.613 1166.73,525.687L1187.07,554.371C1187.67,553.451 1188.29,552.541 1188.93,551.641C1204.06,530.421 1222.61,511.867 1243.83,496.738C1255.92,488.122 1269.89,483.206 1284.16,482.113C1298.42,481.019 1312.98,483.748 1326.24,490.421L1327.4,491.005L1328.12,489.918C1336.26,477.511 1347.51,467.868 1360.41,461.681C1366.86,458.589 1373.72,456.361 1380.82,455.083L1402.64,454.185C1428.59,456.676 1453.93,463.468 1477.64,474.281C1504.65,486.597 1522.62,512.855 1524.32,542.491L1524.39,543.789L1525.69,543.863C1527.51,543.968 1529.33,544.197 1531.12,544.549L1541.83,546.656C1543.63,547.009 1545.39,547.484 1547.12,548.078C1553.94,550.423 1560.39,553.671 1566.29,557.71C1572.19,561.75 1577.56,566.581 1582.21,572.089C1583.39,573.485 1584.47,574.96 1585.45,576.503L1591.3,585.728C1592.27,587.271 1593.14,588.878 1593.9,590.539C1604.71,614.251 1611.51,639.597 1614,665.538C1614.04,666.013 1614.08,670.473 1614.11,676.425C1614.66,676.516 1615.21,676.614 1615.76,676.717C1622.8,678.035 1629.65,680.295 1636.13,683.46C1637.77,684.262 1639.36,685.175 1640.87,686.194L1649.94,692.281C1651.46,693.299 1652.9,694.419 1654.26,695.634L1655.23,696.499L1656.2,695.634C1678.36,675.88 1709.63,670.018 1737.44,680.407C1761.85,689.528 1784.58,702.648 1804.68,719.229C1805.96,720.283 1807.17,721.415 1808.31,722.619L1815.12,729.826C1817.38,732.218 1819.33,734.879 1820.94,737.749L1825.7,746.248C1826.5,747.668 1827.2,749.135 1827.82,750.642C1830.28,756.64 1832,762.929 1832.94,769.368C1833.18,770.995 1833.32,772.634 1833.35,774.277L1833.5,780.947L1833.58,780.943C1833.58,780.943 1833.57,798.627 1833.56,799.035C1861.5,808.46 1882.01,832.505 1886.89,861.617C1889.17,875.193 1890.24,888.919 1890.11,902.617C1890.11,903.185 1890.11,904.093 1890.12,905.233C1890.12,906.012 1890.12,906.792 1890.12,907.571C1912.02,906.503 1934.47,908.86 1956.42,914.38C1993.53,923.711 2025.76,942.33 2047,965.404L2048.59,967.195C2049.79,968.615 2050.89,970.116 2051.89,971.689L2055.78,977.823C2057.5,980.551 2058.89,983.478 2059.92,986.54L2061.87,992.378C2062.71,994.891 2063.3,997.481 2063.63,1000.11L2064.35,1005.86C2064.66,1008.4 2064.7,1043.6 2064.56,1045.58C2064.56,1045.58 2064.46,1046.82 2064.34,1048.27C2064.31,1063.44 2062.96,1097.13 2062.57,1098.68C2062.08,1100.63 2061.44,1102.55 2060.66,1104.41L2057.28,1112.46C2056.4,1114.55 2055.34,1116.57 2054.12,1118.49L2053.5,1119.44L2039.55,1140.41C2042.65,1151.89 2046.06,1164.48 2046.08,1164.58C2046.36,1165.64 2046.6,1166.72 2046.8,1167.81L2048.18,1175.58C2048.74,1178.71 2048.93,1181.88 2048.73,1185.05C2048.73,1185.05 2048.71,1185.34 2048.68,1185.8C2048.83,1187.69 2048.66,1218.15 2048.56,1219.4C2048.56,1233.19 2047.2,1269.64 2046.83,1271.12C2046.44,1272.64 2045.97,1274.13 2045.42,1275.6L2043.05,1281.82C2041.94,1284.73 2040.49,1287.51 2038.74,1290.09L2034.97,1295.62C2032.82,1298.78 2030.23,1301.61 2027.28,1304.04L2018.06,1311.61C2016.53,1312.87 2014.91,1314.01 2013.21,1315.02C1959.08,1347.4 1904.09,1352.92 1856.9,1341.06C1840.78,1337 1825.53,1330.91 1811.45,1323.07C1767.76,1364.85 1717.43,1382.51 1670.23,1382.51C1619.77,1382.51 1572.48,1362.39 1538.45,1328.07C1535.74,1329.72 1532.85,1331.03 1529.82,1331.99L1524.74,1333.61C1522.15,1334.43 1519.48,1334.99 1516.77,1335.28L1511.27,1335.85C1509.89,1335.99 1508.5,1336.07 1507.11,1336.07L1443.47,1336.07C1442.08,1336.07 1440.69,1335.99 1439.31,1335.85L1433.81,1335.28C1431.1,1334.99 1428.43,1334.43 1425.84,1333.61L1420.76,1331.99C1417.08,1330.82 1413.59,1329.13 1410.4,1326.96L1401.98,1321.24C1400.54,1320.26 1399.16,1319.18 1397.86,1318.02C1357.12,1360.12 1296.58,1374.89 1240.54,1365.18C1206.4,1359.27 1174.6,1344.28 1149.97,1321.67C1149.59,1321.79 1149.21,1321.91 1148.83,1322.01L1143.56,1323.49C1142.27,1323.85 1140.97,1324.14 1139.66,1324.37L1138.62,1324.55L1067.56,1335.7C1066.16,1336.07 1064.73,1336.37 1063.27,1336.6L1007.7,1345.18L1004.65,1345.57L1004.07,1345.63C1002.59,1345.78 1001.09,1345.85 999.598,1345.83L993.857,1345.77C990.969,1345.74 988.093,1345.4 985.278,1344.75L979.999,1343.54C976.234,1342.67 972.615,1341.26 969.254,1339.35L960.698,1334.5C956.626,1332.19 952.99,1329.18 949.957,1325.62L943.977,1318.59C941.012,1315.1 938.667,1311.13 937.045,1306.85L933.645,1297.87C932.807,1295.66 932.167,1293.38 931.732,1291.06L931.422,1289.25L910.096,1152.22L905.372,1152.5C903.044,1152.64 900.708,1152.58 898.391,1152.31L895.129,1151.84L838.271,1142.1C836.63,1141.81 835.03,1141.44 833.475,1140.97L831.916,1140.61C829.156,1139.98 826.471,1139.06 823.906,1137.87L819.231,1135.68C815.691,1134.03 812.411,1131.87 809.497,1129.27L802.283,1122.83C798.547,1119.49 795.471,1115.48 793.215,1111.01L788.899,1102.45C787.196,1099.08 785.98,1095.48 785.288,1091.76L784.37,1086.83C783.886,1084.23 783.66,1081.59 783.698,1078.95C783.698,1078.95 783.688,1054.34 783.695,1053.51C771.582,1058.04 759.424,1061.26 747.62,1063.1C650.746,1078.16 555.311,1019.1 538.86,913.301C537.17,902.435 536.361,891.035 536.537,879.169C536.51,877.399 536.505,875.618 536.523,873.826C536.522,873.068 536.521,872.261 536.52,871.418Z" style="fill:rgb(217,119,6);"/>
+            <g id="OpenEUICCBG">
+                <path id="OpenEUICCSVG2" serif:id="OpenEUICCSVG" d="M536.536,813.239C536.333,799.556 537.449,785.146 540.07,770.087L540.153,769.618C555.219,686.95 626.809,636.372 700.624,624.894C797.308,609.86 859.29,659.193 890.537,714.163C891.854,714.184 893.169,714.27 894.478,714.421L895.05,714.487L898.248,714.944L904.056,715.933L903.375,714.712C901.981,712.211 900.859,709.567 900.03,706.827L898.252,700.956C897.441,698.275 896.913,695.515 896.678,692.724L896.173,686.737C895.942,683.995 895.995,681.237 896.33,678.506C896.33,678.506 896.356,678.356 896.356,678.354C896.34,676.293 896.35,674.158 896.385,672.18L896.217,670.083C895.909,666.217 896.164,662.326 896.976,658.533L898.725,650.358C899.539,646.549 900.906,642.88 902.781,639.467L906.877,632.012C908.803,628.506 911.244,625.309 914.118,622.527L920.427,616.422C921.88,615.016 923.438,613.722 925.087,612.551L1070.48,509.323C1071.55,508.561 1072.66,507.853 1073.81,507.201L1078.77,504.366C1081.05,503.067 1083.45,501.994 1085.93,501.164L1091.31,499.37C1093.78,498.544 1096.33,497.962 1098.92,497.632L1104.54,496.916C1107.13,496.585 1109.76,496.51 1112.38,496.693L1118.08,497.091C1120.71,497.274 1123.31,497.717 1125.85,498.412L1131.37,499.921C1133.89,500.612 1136.35,501.551 1138.69,502.723L1143.76,505.255C1146.09,506.422 1148.31,507.814 1150.37,509.411L1154.85,512.879C1156.92,514.484 1158.83,516.289 1160.55,518.268L1164.3,522.584C1165.16,523.578 1165.97,524.613 1166.73,525.687L1187.07,554.371C1187.67,553.451 1188.29,552.541 1188.93,551.641C1204.06,530.421 1222.61,511.867 1243.83,496.738C1255.92,488.122 1269.89,483.206 1284.16,482.113C1298.42,481.019 1312.98,483.748 1326.24,490.421L1327.4,491.005L1328.12,489.918C1336.26,477.511 1347.51,467.868 1360.41,461.681C1366.86,458.589 1373.72,456.361 1380.82,455.083L1402.64,454.185C1428.59,456.676 1453.93,463.468 1477.64,474.281C1504.65,486.597 1522.62,512.855 1524.32,542.491L1524.39,543.789L1525.69,543.863C1527.51,543.968 1529.33,544.197 1531.12,544.549L1541.83,546.656C1543.63,547.009 1545.39,547.484 1547.12,548.078C1553.94,550.423 1560.39,553.671 1566.29,557.71C1572.19,561.75 1577.56,566.581 1582.21,572.089C1583.39,573.485 1584.47,574.96 1585.45,576.503L1591.3,585.728C1592.27,587.271 1593.14,588.878 1593.9,590.539C1604.71,614.251 1611.51,639.597 1614,665.538C1614.04,666.013 1614.08,670.473 1614.11,676.425C1614.66,676.516 1615.21,676.614 1615.76,676.717C1622.8,678.035 1629.65,680.295 1636.13,683.46C1637.77,684.262 1639.36,685.175 1640.87,686.194L1649.94,692.281C1651.46,693.299 1652.9,694.419 1654.26,695.634L1655.23,696.499L1656.2,695.634C1678.36,675.88 1709.63,670.018 1737.44,680.407C1761.85,689.528 1784.58,702.648 1804.68,719.229C1805.96,720.283 1807.17,721.415 1808.31,722.619L1815.12,729.826C1817.38,732.218 1819.33,734.879 1820.94,737.749L1825.7,746.248C1826.5,747.668 1827.2,749.135 1827.82,750.642C1830.28,756.64 1832,762.929 1832.94,769.368C1833.18,770.995 1833.32,772.634 1833.35,774.277L1833.5,780.947L1833.58,780.943L1833.58,784.984C1833.58,786.611 1833.48,788.216 1833.29,789.793C1833.25,792.629 1833.19,795.732 1833.12,798.888C1861.29,808.208 1881.99,832.353 1886.89,861.617C1889.17,875.193 1890.24,888.919 1890.11,902.617C1890.11,903.534 1890.12,905.339 1890.12,907.571C1912.02,906.503 1934.46,908.86 1956.42,914.38C1993.53,923.711 2025.76,942.33 2047,965.404L2048.59,967.195C2049.79,968.615 2050.89,970.116 2051.89,971.689L2055.78,977.823C2057.5,980.551 2058.89,983.478 2059.92,986.54L2061.87,992.378C2062.71,994.891 2063.3,997.481 2063.63,1000.11L2064.35,1005.86C2064.66,1008.4 2064.74,1010.97 2064.56,1013.52C2064.56,1013.52 2064.46,1014.76 2064.34,1016.21C2064.31,1031.38 2062.96,1065.08 2062.57,1066.62C2062.08,1068.58 2061.44,1070.49 2060.66,1072.35L2057.28,1080.4C2056.4,1082.5 2055.34,1084.52 2054.12,1086.44L2053.5,1087.38L2033.23,1117.86C2033.73,1119.16 2034.17,1120.5 2034.54,1121.88C2034.54,1121.88 2046.03,1164.4 2046.08,1164.58C2046.36,1165.64 2046.6,1166.72 2046.8,1167.81L2048.18,1175.58C2048.74,1178.71 2048.93,1181.88 2048.73,1185.05C2048.73,1185.05 2048.66,1186.1 2048.56,1187.35C2048.56,1201.13 2047.2,1237.58 2046.83,1239.06C2046.44,1240.58 2045.97,1242.08 2045.42,1243.54L2043.05,1249.76C2041.94,1252.68 2040.49,1255.45 2038.74,1258.03L2034.97,1263.57C2032.82,1266.73 2030.23,1269.56 2027.28,1271.98L2018.06,1279.55C2016.53,1280.81 2014.91,1281.95 2013.21,1282.97C1959.08,1315.35 1904.09,1320.87 1856.9,1309C1840.78,1304.95 1825.53,1298.85 1811.45,1291.02C1767.76,1332.79 1717.43,1350.45 1670.23,1350.45C1619.77,1350.45 1572.48,1330.34 1538.45,1296.02C1535.74,1297.66 1532.85,1298.98 1529.82,1299.94L1524.74,1301.55C1522.15,1302.38 1519.48,1302.94 1516.77,1303.22L1511.27,1303.79C1509.89,1303.94 1508.5,1304.01 1507.11,1304.01L1443.47,1304.01C1442.08,1304.01 1440.69,1303.94 1439.31,1303.79L1433.81,1303.22C1431.1,1302.94 1428.43,1302.38 1425.84,1301.55L1420.76,1299.94C1417.08,1298.77 1413.59,1297.07 1410.4,1294.9L1401.98,1289.18C1400.54,1288.2 1399.16,1287.13 1397.86,1285.97C1357.12,1328.06 1296.58,1342.84 1240.54,1333.13C1206.4,1327.21 1174.6,1312.23 1149.97,1289.62C1149.59,1289.74 1149.21,1289.85 1148.83,1289.96L1143.56,1291.43C1142.27,1291.79 1140.97,1292.09 1139.66,1292.32L1138.62,1292.49L1067.56,1303.64C1066.16,1304.02 1064.73,1304.32 1063.27,1304.54L1007.7,1313.12L1004.65,1313.51L1004.07,1313.57C1002.59,1313.72 1001.09,1313.79 999.598,1313.78L993.857,1313.72C990.969,1313.69 988.093,1313.35 985.278,1312.7L979.999,1311.48C976.234,1310.61 972.615,1309.2 969.254,1307.3L960.698,1302.44C956.626,1300.14 952.99,1297.13 949.957,1293.56L943.977,1286.53C941.012,1283.04 938.667,1279.07 937.045,1274.79L933.645,1265.82C932.807,1263.61 932.167,1261.33 931.732,1259L931.422,1257.19L910.096,1120.16L905.372,1120.45C903.044,1120.59 900.708,1120.52 898.391,1120.26L895.129,1119.79L838.271,1110.04C836.63,1109.76 835.03,1109.38 833.475,1108.91L831.916,1108.56C829.156,1107.93 826.471,1107.01 823.906,1105.81L819.231,1103.63C815.691,1101.98 812.411,1099.82 809.497,1097.21L802.283,1090.77C798.547,1087.43 795.471,1083.42 793.215,1078.95L788.899,1070.4C787.196,1067.02 785.98,1063.42 785.288,1059.7L784.37,1054.78C783.886,1052.18 783.66,1049.54 783.698,1046.89L783.77,1041.7C783.778,1041.17 783.796,1040.63 783.825,1040.1L783.773,1037.25C783.755,1036.28 783.773,1035.32 783.825,1034.36L783.773,1031.51C783.755,1030.54 783.773,1029.58 783.825,1028.62L783.773,1025.76C783.755,1024.8 783.773,1023.84 783.825,1022.87L783.798,1021.42C771.651,1025.96 759.457,1029.2 747.62,1031.04C650.746,1046.11 555.311,987.041 538.86,881.245C537.17,870.379 536.36,858.979 536.536,847.113C536.51,841.88 536.509,818.522 536.536,813.239ZM1747.57,1128.43L1746.11,1129.87L1746.55,1129.79L1747.57,1129.93C1747.57,1129.43 1747.57,1128.93 1747.57,1128.43ZM1725.91,1137.76C1726.11,1138.18 1726.32,1138.59 1726.52,1139C1726.88,1138.63 1727.25,1138.25 1727.6,1137.87L1727.25,1137.94L1725.91,1137.76ZM1186.12,735.525L1184.79,736.677L1179.35,740.53C1181.69,740.656 1183.97,740.843 1186.19,741.087C1186.16,740.711 1186.14,738.591 1186.12,735.525ZM904.625,695.316C900.099,689.396 897.181,682.157 896.548,674.224L896.496,673.569C897.027,682.963 900.236,690.019 904.625,695.316ZM543.965,836.24C539.416,829.87 536.686,822.105 536.543,813.698C536.686,823.387 539.677,830.711 543.965,836.24Z" style="fill:rgb(253,230,138);"/>
+                <g id="OpenEUICCSVG3" serif:id="OpenEUICCSVG">
+                    <g id="Sim" transform="matrix(0.785112,1.10765,-1.10765,0.785112,658.755,-1281.43)">
+                        <g transform="matrix(1.20427,0,2.22045e-16,1.44928,-38.8349,-460.554)">
+                            <path d="M1109.4,779.255C1107.87,778.394 1106.09,777.339 1104.71,776.471L1104.7,776.469L1102.52,775.389L1099.06,772.262L1096.79,768.373L1095.97,763.963L1095.89,673.341L1096.23,670.449L1097.23,667.695L1098.86,665.155L1101.08,662.908L1103.78,661.065L1106.84,659.709L1110.15,658.872L1113.63,658.585L1182.83,658.585L1186.42,658.89L1189.83,659.779L1192.95,661.218C1192.95,661.218 1193.81,661.826 1193.81,661.828C1194.56,662.274 1202.69,667.135 1203.24,667.613L1220.41,682.619L1222.5,684.831L1224.03,687.308L1224.98,689.981L1225.3,692.779L1225.3,768.395L1224.94,771.356L1223.9,774.138L1222.26,776.646L1220.1,778.821L1217.48,780.615L1214.46,781.976L1211.12,782.84L1207.55,783.139L1121.26,783.139L1117.44,782.795L1113.89,781.807L1110.72,780.256C1110.72,780.256 1109.4,779.257 1109.4,779.255Z" style="fill:rgb(80,7,36);"/>
+                        </g>
+                        <g transform="matrix(1.20427,0,0,1.44928,-38.8349,-460.554)">
+                            <path d="M1111.62,768.187C1109.62,767.502 1108.21,765.865 1108.2,763.955L1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1186.83,670.173 1193.92,674.225 1194.37,674.617L1211.55,689.624C1212.52,690.475 1213.07,691.605 1213.07,692.779L1213.07,768.395C1213.07,770.925 1210.6,772.975 1207.55,772.975L1121.26,772.975C1119.63,772.975 1118.16,772.385 1117.15,771.447C1116.38,771.181 1112.17,768.698 1111.62,768.187Z" style="fill:rgb(190,24,93);"/>
+                        </g>
+                        <g transform="matrix(1.20427,0,1.11022e-16,1.44928,-38.8349,-460.554)">
+                            <path d="M1204,685.179C1204.98,686.031 1205.52,687.16 1205.52,688.335L1205.52,763.951C1205.52,766.48 1203.05,768.531 1200.01,768.531L1113.72,768.531C1110.67,768.531 1108.21,766.483 1108.2,763.955C1108.19,747.298 1108.14,690.002 1108.12,673.333C1108.12,672.118 1108.7,670.952 1109.73,670.092C1110.77,669.233 1112.17,668.75 1113.63,668.75L1182.83,668.75C1184.34,668.75 1185.79,669.264 1186.83,670.173C1190.67,673.533 1200.27,681.919 1204,685.179Z" style="fill:rgb(244,63,94);"/>
+                        </g>
+                        <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                            <path d="M1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,613.249C1553.44,618.429 1549.29,622.628 1544.17,622.628C1527.95,622.628 1494.61,622.628 1478.39,622.628C1473.27,622.628 1469.12,618.429 1469.12,613.249L1469.12,522.748C1469.12,517.568 1473.27,513.37 1478.39,513.37L1544.17,513.37Z" style="fill:rgb(255,209,0);"/>
+                        </g>
+                        <g transform="matrix(1,0,0,0.988468,-168.973,24.7553)">
+                            <path d="M1469.24,614.766C1469.16,614.272 1469.12,613.766 1469.12,613.249L1469.12,567.058L1522.19,513.37L1544.17,513.37C1549.29,513.37 1553.44,517.568 1553.44,522.748L1553.44,529.581L1469.24,614.766Z" style="fill:rgb(255,243,138);"/>
+                        </g>
+                        <g transform="matrix(1,-5.55112e-17,5.55112e-17,1,-676.337,255.223)">
+                            <path d="M2010.77,311.863C2009.48,312.543 2003.51,316.132 2002.59,316.644C2001.38,317.313 1999.86,316.877 1999.19,315.671C1998.52,314.464 1998.96,312.941 2000.17,312.272C2000.92,311.854 2001.66,311.419 2002.4,310.979L2002.4,274.565C2002.4,273.185 2003.52,272.065 2004.9,272.065C2006.28,272.065 2007.4,273.185 2007.4,274.565L2007.4,308.007C2007.75,307.811 2008.1,307.621 2008.45,307.437C2011.52,305.821 2014.64,304.694 2017.95,304.671C2022.22,304.642 2026.42,306.561 2030.64,308.867L2030.64,274.565C2030.64,273.185 2031.76,272.065 2033.14,272.065C2034.52,272.065 2035.64,273.185 2035.64,274.565L2035.64,311.664C2039.1,313.557 2042.63,315.118 2046.37,315.118C2054.72,315.118 2061.73,308.414 2061.73,308.414C2062.83,307.579 2064.4,307.793 2065.23,308.891C2066.07,309.99 2065.86,311.56 2064.76,312.395C2064.76,312.395 2056.58,319.964 2046.45,320.118C2040.93,320.202 2035.72,317.467 2030.66,314.605C2026.4,312.193 2022.27,309.642 2017.99,309.671C2015.46,309.689 2013.12,310.633 2010.77,311.863ZM2002.4,351.73C1998.65,349.472 1994.72,347.293 1990.06,347.204C1983.86,347.085 1977.25,354.288 1977.25,354.288C1976.4,355.379 1974.83,355.578 1973.74,354.733C1972.65,353.888 1972.45,352.317 1973.3,351.226C1973.3,351.226 1981.5,342.039 1990.16,342.205C1995.95,342.316 2000.87,344.972 2005.52,347.774L2006.76,348.528C2010.47,350.797 2014.01,353.011 2017.99,353.038C2022.27,353.068 2026.4,350.517 2030.66,348.105C2035.72,345.243 2040.93,342.508 2046.45,342.592C2055.63,342.731 2064.52,348.783 2064.52,348.783C2065.62,349.618 2065.83,351.188 2064.99,352.286C2064.16,353.384 2062.59,353.598 2061.49,352.763C2061.49,352.763 2054.12,347.591 2046.37,347.591C2042.63,347.591 2039.1,349.153 2035.64,351.045L2035.64,388.469C2035.64,389.848 2034.52,390.969 2033.14,390.969C2031.76,390.969 2030.64,389.848 2030.64,388.469L2030.64,353.842C2026.42,356.148 2022.22,358.067 2017.95,358.038C2014.27,358.013 2010.83,356.574 2007.4,354.682L2007.4,388.469C2007.4,389.848 2006.28,390.969 2004.9,390.969C2003.52,390.969 2002.4,389.848 2002.4,388.469L2002.4,351.73ZM1973,310.59C1972.15,309.499 1972.35,307.927 1973.44,307.082C1974.53,306.237 1976.11,306.436 1976.95,307.527C1976.95,307.527 1982.05,313.224 1985.65,314.67C1986.93,315.185 1987.55,316.642 1987.03,317.922C1986.52,319.202 1985.06,319.824 1983.78,319.309C1978.86,317.332 1973,310.59 1973,310.59Z" style="fill:rgb(154,78,3);"/>
+                        </g>
+                    </g>
+                    <g id="Cogs">
+                        <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                            <path d="M713.5,735.152L713.524,735.11C719.147,725.132 725.647,715.652 732.959,706.786C742.403,695.336 757.41,690.056 771.943,693.07C771.943,693.07 789.986,696.813 800.929,699.083C801.619,698.652 802.312,698.226 803.008,697.805L805.605,689.944C806.386,687.579 822.308,659.429 823.248,658.126L821.227,661.626L826.328,653.226C828.346,650.673 830.664,648.38 833.228,646.395L841.6,641.415L851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C937.664,649.993 940.067,652.685 942.082,655.676L946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577L1068.16,772.222L1068.04,781.962C1067.6,785.174 1066.77,788.329 1065.57,791.353L1060.85,799.971L1062.87,796.471C1062.21,797.936 1045.79,825.8 1044.13,827.659C1044.13,827.659 1041.84,830.237 1038.62,833.837C1038.61,834.651 1038.59,835.465 1038.56,836.277L1058.26,858.374C1068.13,869.453 1071.07,885.089 1065.87,898.993C1061.85,909.77 1056.88,920.151 1051.05,930.004C1049.68,932.395 1040.32,948.617 1039,950.881C1033.37,960.874 1026.86,970.368 1019.54,979.247C1010.09,990.697 995.086,995.977 980.553,992.963C980.553,992.963 962.509,989.22 951.566,986.95C950.877,987.381 950.184,987.807 949.488,988.227L946.891,996.089L941.354,1006.94L943.375,1003.44C942.724,1004.89 930.161,1026.64 929.248,1027.91L931.269,1024.41L926.168,1032.81C924.15,1035.36 921.832,1037.65 919.268,1039.64L910.896,1044.62L901.397,1047.45C880.072,1051.03 858.3,1051.03 836.975,1047.45C822.337,1045 810.261,1034.64 805.605,1020.55C805.605,1020.55 799.825,1003.05 796.319,992.442C793.084,990.724 789.911,988.892 786.806,986.95L757.819,992.963C743.286,995.977 728.279,990.697 718.836,979.247C705.078,962.565 694.192,943.711 686.625,923.456L684.332,913.811L684.459,904.07C684.896,900.858 685.722,897.704 686.924,894.679L691.649,886.062L689.629,889.562C690.268,888.138 702.827,866.381 703.755,865.094L701.735,868.593L708.362,858.374C708.362,858.374 710.661,855.796 713.872,852.195C713.888,851.382 713.91,850.568 713.939,849.755L694.238,827.659L688.151,818.592C686.569,815.351 685.439,811.924 684.78,808.409C684.121,804.893 683.933,801.289 684.234,797.696L686.625,787.04C690.651,776.263 695.618,765.881 701.447,756.028C702.804,753.652 712.07,737.603 713.5,735.152Z" style="fill:rgb(80,7,36);"/>
+                        </g>
+                        <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                            <path d="M730.855,745.094C735.921,736.08 741.787,727.517 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C809.701,717.064 814.558,714.064 819.587,711.38L824.596,696.218C825.246,694.249 838.687,670.91 839.469,669.825C842.19,663.773 847.771,659.415 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.49,775.877 1048.51,782.89 1044.62,788.272C1044.08,789.492 1030.59,812.801 1029.21,814.349C1029.21,814.349 1024.16,820.008 1018.58,826.268C1018.77,831.965 1018.6,837.671 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1043.5,901.713 1039.02,911.074 1033.75,919.97C1033.09,921.142 1022.33,939.781 1021.64,940.938C1016.57,949.953 1010.71,958.516 1004.11,966.522C999.385,972.247 991.882,974.887 984.615,973.379C984.615,973.379 947.449,965.67 947.449,965.67C942.795,968.969 937.938,971.969 932.909,974.653L927.9,989.815C927.25,991.784 926.31,993.607 925.133,995.239C924.575,996.48 913.809,1015.12 913.027,1016.21C910.306,1022.26 904.725,1026.62 898.091,1027.73C878.955,1030.94 859.418,1030.94 840.281,1027.73C832.962,1026.5 826.924,1021.33 824.596,1014.28C824.596,1014.28 812.689,978.237 812.69,978.237C805.06,974.732 797.773,970.525 790.923,965.67L753.757,973.379C746.49,974.887 738.987,972.247 734.265,966.522C721.919,951.552 712.151,934.633 705.36,916.456C703.006,910.155 703.989,903.143 707.871,897.761C708.419,896.541 719.181,877.895 719.977,876.792C720.802,874.957 721.91,873.231 723.29,871.684C723.29,871.684 728.336,866.024 733.917,859.765C733.727,854.068 733.897,848.362 734.426,842.681L709.167,814.349C704.228,808.81 702.763,800.992 705.36,794.04C708.992,784.319 713.475,774.958 718.748,766.063C719.408,764.89 730.169,746.252 730.855,745.094ZM847.058,755.4C844.88,760.245 840.846,764.055 835.817,765.934C825.907,769.636 816.683,774.962 808.522,781.692C803.845,785.549 797.671,787.077 791.735,785.846C791.735,785.846 778.919,783.187 769.09,781.148L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.164,851.838 788.882,857.237 785.775,861.545C785.225,862.768 771.731,886.08 770.356,887.622C770.356,887.622 767.776,890.516 764.346,894.363C766.704,898.775 769.307,903.055 772.143,907.181L805.859,900.187C807.17,899.915 808.493,899.778 809.809,899.77C800.487,887.364 794.962,871.946 794.962,855.248C794.962,841.044 798.96,827.767 805.891,816.481C806.533,815.297 815.277,800.152 815.98,799.008C816.622,797.823 817.294,796.658 817.998,795.513C830.557,772.324 855.107,756.56 883.31,756.56C886.308,756.56 889.264,756.738 892.169,757.085C891.522,755.946 890.983,754.738 890.565,753.472L879.763,720.776C874.772,720.384 869.765,720.269 864.764,720.433L861.931,729.009C861.284,730.97 847.842,754.313 847.058,755.4ZM860.327,928.948C860.974,930.086 861.513,931.295 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C877.724,965.649 882.731,965.763 887.732,965.599L890.565,957.024C891.212,955.063 902.636,935.215 903.42,934.127C903.976,932.89 904.654,931.72 905.438,930.633C907.616,925.788 911.65,921.978 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 973.577,902.845 983.406,904.884L968.016,887.622C963.981,883.096 962.217,876.986 963.219,871.006C964.968,860.574 964.968,849.922 963.219,839.489C962.332,834.194 963.614,828.796 966.721,824.487C967.27,823.265 980.765,799.952 982.14,798.411C982.14,798.411 984.72,795.516 988.15,791.67C985.791,787.257 983.189,782.978 980.353,778.852L946.637,785.846C945.326,786.118 944.003,786.255 942.687,786.263C952.008,798.669 957.534,814.087 957.534,830.785C957.534,844.989 953.536,858.266 946.605,869.552C945.963,870.736 935.201,889.375 934.498,890.52C921.939,913.709 897.389,929.472 869.186,929.472C866.188,929.472 863.232,929.294 860.327,928.948ZM903.248,858.597C903.356,857.495 903.411,856.378 903.411,855.248C903.411,836.359 888.075,821.024 869.186,821.024C861.749,821.024 854.864,823.401 849.248,827.436C849.14,828.538 849.085,829.655 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C890.747,865.009 897.632,862.632 903.248,858.597Z" style="fill:rgb(190,24,93);"/>
+                        </g>
+                        <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                            <path d="M792.854,697.408L795.347,689.863C797.63,682.952 801.697,676.94 806.966,672.326C811.488,667.744 823.043,656.19 827.618,651.675C833.598,644.848 841.835,640.131 851.099,638.578C872.424,635.004 894.196,635.004 915.521,638.578C922.84,639.805 929.518,643.007 934.949,647.664C940.38,652.322 944.563,658.434 946.891,665.481C946.891,665.481 952.671,682.978 956.177,693.59C959.412,695.309 962.585,697.141 965.69,699.083L994.677,693.07C1009.21,690.056 1024.22,695.336 1033.66,706.786C1047.42,723.467 1058.3,742.322 1065.87,762.577C1071.07,776.48 1068.13,792.117 1058.26,803.195C1058.26,803.195 1046,816.95 1038.56,825.292C1038.69,828.953 1038.69,832.617 1038.56,836.277L1058.26,858.374L1064.35,867.441C1065.93,870.682 1067.06,874.109 1067.72,877.624C1068.38,881.14 1068.56,884.743 1068.26,888.337L1065.87,898.993C1058.3,919.248 1047.42,938.102 1033.66,954.784C1032.84,955.781 1007.48,981.175 1006.61,981.916L1008.83,979.7L1000.82,986.853C997.886,988.839 994.707,990.418 991.376,991.559C988.045,992.699 984.563,993.401 981.02,993.632L970.295,992.882C970.295,992.882 959.382,990.618 949.383,988.544L946.891,996.089C944.608,1003 940.54,1009.01 935.271,1013.63C930.749,1018.21 919.195,1029.76 914.619,1034.28C908.64,1041.1 900.402,1045.82 891.138,1047.37C869.813,1050.95 848.042,1050.95 826.717,1047.37L816.293,1044.12C813.03,1042.58 810.003,1040.62 807.288,1038.29C804.573,1035.96 802.17,1033.27 800.155,1030.28L795.347,1020.47C795.347,1020.47 789.566,1002.97 786.061,992.362C782.825,990.643 779.652,988.811 776.547,986.869L747.56,992.882C733.028,995.896 718.02,990.616 708.577,979.166C694.819,962.485 683.934,943.63 676.366,923.375L673.976,912.719C673.674,909.126 673.862,905.522 674.521,902.007C675.18,898.491 676.31,895.064 677.892,891.823L683.98,882.757C683.98,882.757 696.243,869.002 703.68,860.66C703.551,856.999 703.551,853.335 703.68,849.675L683.98,827.578C679.041,822.039 675.839,815.36 674.521,808.328C673.862,804.813 673.674,801.209 673.976,797.615L676.366,786.959C683.934,766.704 694.819,747.85 708.577,731.168C709.4,730.171 734.757,704.777 735.624,704.036L733.408,706.252L741.413,699.099C744.352,697.113 747.531,695.534 750.861,694.393C754.192,693.253 757.674,692.552 761.217,692.32L771.943,693.07C771.943,693.07 782.855,695.334 792.854,697.408Z" style="fill:rgb(46,16,101);"/>
+                        </g>
+                        <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                            <path d="M748.614,719.244C753.347,713.704 760.728,711.17 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C805.601,719.97 806.159,719.581 806.719,719.196L814.337,696.137C815.505,692.601 817.607,689.536 820.336,687.205C821.017,686.408 841.707,665.718 842.502,665.039C845.504,661.524 849.689,659.093 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1017.48,942.965 994.412,966.035 993.624,966.709C988.891,972.248 981.509,974.782 974.357,973.299C974.357,973.299 937.19,965.589 937.191,965.589C936.636,965.982 936.078,966.371 935.518,966.756L927.9,989.815C926.732,993.351 924.63,996.416 921.901,998.747C921.221,999.544 900.53,1020.23 899.735,1020.91C896.733,1024.43 892.549,1026.86 887.833,1027.65C868.696,1030.86 849.159,1030.86 830.022,1027.65C822.703,1026.42 816.665,1021.24 814.337,1014.2C814.337,1014.2 802.431,978.156 802.431,978.156C794.801,974.651 787.514,970.444 780.665,965.589L743.498,973.299C736.232,974.806 728.728,972.166 724.007,966.441C711.661,951.471 701.892,934.552 695.101,916.375C692.504,909.424 693.969,901.605 698.908,896.066C698.908,896.066 724.168,867.734 724.168,867.734C723.388,859.374 723.388,850.96 724.168,842.601L698.908,814.268C693.969,808.729 692.504,800.911 695.101,793.959C701.892,775.783 711.661,758.863 724.007,743.894C724.754,742.987 747.825,719.917 748.614,719.244ZM833.765,760.108C831.587,762.657 828.777,764.65 825.558,765.853C815.649,769.555 806.425,774.881 798.264,781.611C793.587,785.469 787.412,786.996 781.476,785.765C781.476,785.765 777.01,784.839 771.329,783.66L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C788.162,821.677 787.758,828.416 788.065,835.131C791.678,822.344 798.662,810.966 807.996,802.019C808.719,801.265 829.407,780.576 830.162,779.853C843.287,766.161 861.644,757.524 882.006,757.169C881.316,755.983 880.744,754.718 880.306,753.391L869.505,720.696C867.929,720.572 866.351,720.475 864.773,720.407L861.931,729.009C860.771,732.521 858.677,735.596 855.931,737.942C855.252,738.738 854.51,739.479 853.715,740.159C853.035,740.954 834.561,759.428 833.765,760.108ZM785.595,861.791C785.245,862.261 784.874,862.717 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L801.408,901.11C792.625,890.132 786.917,876.589 785.595,861.791ZM860.232,928.783C860.921,929.969 861.493,931.234 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C874.309,965.38 875.886,965.477 877.464,965.545L880.306,956.943C881.466,953.431 883.56,950.356 886.306,948.01C886.986,947.214 907.676,926.524 908.472,925.844C910.65,923.295 913.461,921.302 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 965.227,901.113 970.908,902.292L957.757,887.541C953.723,883.016 951.959,876.905 952.961,870.926C954.075,864.275 954.479,857.536 954.173,850.821C950.559,863.608 943.575,874.986 934.242,883.933C933.518,884.688 912.83,905.376 912.076,906.099C898.951,919.791 880.593,928.428 860.232,928.783ZM956.642,824.161C956.992,823.691 957.364,823.235 957.757,822.794C957.757,822.794 980.672,797.092 980.672,797.091C977.631,790.717 974.095,784.592 970.095,778.771L940.829,784.842C949.612,795.82 955.32,809.363 956.642,824.161ZM891.538,863.396C892.202,860.762 892.554,858.006 892.554,855.167C892.554,836.608 877.487,821.541 858.927,821.541C856.089,821.541 853.333,821.893 850.699,822.556C850.036,825.19 849.683,827.947 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C886.148,864.412 888.905,864.059 891.538,863.396Z" style="fill:rgb(91,33,182);"/>
+                        </g>
+                        <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                            <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                        </g>
+                        <g transform="matrix(0.866025,-0.5,0.5,0.866025,474.873,622.613)">
+                            <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,756.56C924.275,756.56 957.534,789.819 957.534,830.785C957.534,871.75 924.275,905.009 883.31,905.009C842.344,905.009 809.085,871.75 809.085,830.785C809.085,789.819 842.344,756.56 883.31,756.56ZM883.31,796.56C864.421,796.56 849.085,811.896 849.085,830.785C849.085,849.674 864.421,865.009 883.31,865.009C902.199,865.009 917.534,849.674 917.534,830.785C917.534,811.896 902.199,796.56 883.31,796.56Z" style="fill:rgb(251,113,133);"/>
+                        </g>
+                        <g transform="matrix(0.707107,-0.707107,0.707107,0.707107,168.138,725.137)">
+                            <path d="M927.9,671.754C927.9,671.754 939.807,707.796 939.806,707.796C947.436,711.301 954.723,715.508 961.573,720.363L998.739,712.653C1006,711.146 1013.51,713.786 1018.23,719.511C1030.58,734.481 1040.35,751.4 1047.14,769.577C1049.73,776.528 1048.27,784.347 1043.33,789.886C1043.33,789.886 1018.07,818.218 1018.07,818.218C1018.85,826.578 1018.85,834.992 1018.07,843.351L1043.33,871.684C1048.27,877.223 1049.73,885.041 1047.14,891.993C1040.35,910.169 1030.58,927.089 1018.23,942.058C1013.51,947.784 1006,950.424 998.739,948.916C998.739,948.916 961.573,941.207 961.573,941.207C954.723,946.062 947.436,950.269 939.807,953.773L927.9,989.815C925.572,996.862 919.534,1002.04 912.215,1003.27C893.078,1006.47 873.541,1006.47 854.405,1003.27C847.086,1002.04 841.047,996.862 838.72,989.815C838.72,989.815 826.813,953.774 826.813,953.774C819.184,950.269 811.896,946.062 805.047,941.207L767.881,948.916C760.614,950.424 753.111,947.784 748.389,942.058C736.043,927.089 726.275,910.169 719.484,891.993C716.886,885.041 718.352,877.223 723.29,871.684C723.29,871.684 748.55,843.351 748.55,843.352C747.771,834.992 747.771,826.577 748.55,818.218L723.29,789.886C718.352,784.347 716.886,776.528 719.484,769.577C726.275,751.4 736.043,734.481 748.389,719.511C753.111,713.786 760.614,711.146 767.881,712.653C767.881,712.653 805.047,720.363 805.047,720.363C811.897,715.508 819.184,711.301 826.813,707.796L838.72,671.754C841.047,664.708 847.086,659.53 854.405,658.303C873.541,655.096 893.078,655.096 912.215,658.303C919.534,659.53 925.572,664.708 927.9,671.754ZM893.887,696.313C886.847,695.759 879.773,695.759 872.733,696.313L861.931,729.009C860.03,734.765 855.62,739.349 849.941,741.47C840.031,745.173 830.807,750.498 822.646,757.229C817.969,761.086 811.795,762.614 805.859,761.383C805.859,761.383 772.143,754.389 772.142,754.389C768.143,760.209 764.606,766.335 761.565,772.709L784.48,798.411C788.515,802.936 790.279,809.047 789.277,815.026C787.528,825.459 787.528,836.11 789.277,846.543C790.279,852.522 788.515,858.633 784.48,863.158C784.48,863.158 761.565,888.86 761.566,888.861C764.606,895.235 768.143,901.36 772.143,907.181L805.859,900.187C811.795,898.956 817.969,900.483 822.646,904.341C830.807,911.071 840.031,916.397 849.941,920.099C855.62,922.221 860.03,926.804 861.931,932.561C861.931,932.561 872.733,965.256 872.733,965.256C879.773,965.81 886.846,965.81 893.887,965.256L904.688,932.561C906.59,926.804 911,922.221 916.679,920.099C926.589,916.397 935.813,911.071 943.974,904.341C948.651,900.483 954.825,898.956 960.761,900.187C960.761,900.187 994.477,907.181 994.477,907.181C998.477,901.36 1002.01,895.235 1005.05,888.86L982.14,863.158C978.105,858.633 976.341,852.522 977.343,846.543C979.091,836.11 979.091,825.459 977.343,815.026C976.341,809.047 978.105,802.936 982.14,798.411C982.14,798.411 1005.05,772.709 1005.05,772.709C1002.01,766.335 998.477,760.209 994.477,754.389L960.761,761.383C954.825,762.614 948.651,761.086 943.974,757.229C935.813,750.498 926.589,745.173 916.679,741.47C911,739.349 906.59,734.765 904.688,729.009L893.887,696.313ZM883.31,757.158C923.946,757.158 956.937,790.149 956.937,830.785C956.937,871.42 923.946,904.412 883.31,904.412C842.674,904.412 809.683,871.42 809.683,830.785C809.683,790.149 842.674,757.158 883.31,757.158ZM883.31,797.158C864.751,797.158 849.683,812.226 849.683,830.785C849.683,849.344 864.751,864.412 883.31,864.412C901.869,864.412 916.937,849.344 916.937,830.785C916.937,812.226 901.869,797.158 883.31,797.158Z" style="fill:rgb(192,132,252);"/>
+                        </g>
+                    </g>
+                    <g id="Open">
+                        <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                            <path d="M612.752,414.417L612.755,414.399C614.319,403.074 617.1,391.317 621.202,379.208C621.219,379.158 621.236,379.108 621.254,379.058C642.929,316.699 705.583,287.576 764.273,287.576C857.693,287.576 899.91,355.117 909.048,409.366L912.08,406.88L920.961,403.785L926.073,403.523L931.434,404.387L931.989,404.54C932.335,404.635 932.679,404.74 933.019,404.854C933.019,404.854 974.915,418.876 974.914,418.876C989.032,418.097 1002.75,419.574 1015.32,423.041C1050.44,432.728 1078.94,457.158 1092.88,488.192C1110.76,451.897 1150.23,424.424 1212.42,434.095C1239.04,438.234 1256.7,448.747 1268.64,461.131C1275.52,468.266 1280.49,476.151 1284.04,484.118L1284.99,482.987L1293.13,478.28L1298.1,477.063L1303.53,476.905L1304.1,476.951C1304.46,476.98 1304.81,477.018 1305.17,477.066C1305.17,477.066 1334.69,481.041 1334.69,481.041C1346.52,479.74 1357.72,479.533 1368.54,480.404C1438.82,486.06 1487.4,534.497 1482.08,600.62L1481.32,610.093C1480.51,620.186 1481.57,628.665 1488.4,636.108L1487.67,635.351L1492.45,641.009L1495.93,647.625L1497.49,653.901L1497.6,659.077C1497.52,660.131 1491.5,697.889 1491.43,698.792L1490.09,705.087L1487.17,710.887L1483.11,715.574L1479.26,718.437L1478.66,719.013C1473.59,722.475 1448.44,737.641 1448.44,737.641L1449.32,737.075L1438.88,741.908L1427.94,742.929C1425.38,742.723 1416.57,740.653 1406.2,734.34C1389.73,724.313 1366.97,703.451 1363.86,667.715C1362.1,679.162 1358.42,702.879 1358.42,702.879L1358.6,701.393L1357.58,706.702L1355.61,711.379L1349.67,718.691L1341.5,723.391L1336.57,724.585L1331.16,724.74L1330.59,724.693C1330.26,724.667 1329.93,724.632 1329.6,724.588L1272.41,717.097C1272.19,717.068 1271.98,717.036 1271.76,717L1262.63,713.726L1255.14,707.13L1250.74,698.303L1249.84,688.884C1249.87,688.54 1249.91,688.196 1249.95,687.853L1259.27,617.763C1254.48,620.155 1248.87,622.015 1242.29,623.164C1240.48,623.48 1238.57,623.762 1236.57,624.009C1235.96,628.258 1235.46,631.658 1235.4,632.073L1232.32,641.012C1229,647.924 1220.84,662.066 1215.85,669.847C1215.68,670.117 1215.5,670.383 1215.31,670.645L1208.75,677.837L1202,682.239L1191.47,685.368L1180.38,685.146L1176.97,684.615C1128.26,677.041 1098.27,650.794 1084.5,619.41C1074.54,640.111 1059.38,655.378 1040.91,664.889C1017.42,676.986 988.146,679.803 956.468,671.066C951.326,669.647 946.309,667.961 941.466,666.025L926.148,712.05C926.083,712.246 926.015,712.441 925.943,712.635L921.014,720.988L913.129,727.106L903.633,729.774L894.214,728.882C893.861,728.785 893.511,728.678 893.164,728.561L838.479,710.193L839.53,710.514L834.479,708.504L830.194,705.63L824.055,698.154L821.104,689.036L820.955,684.026L821.824,678.908L821.977,678.353C821.995,678.287 822.014,678.222 822.032,678.157L822.706,673.235L822.859,672.679C822.877,672.614 822.896,672.548 822.915,672.483L823.588,667.561L823.742,667.006C823.76,666.94 823.778,666.875 823.797,666.809L824.471,661.887L824.624,661.332C824.642,661.267 824.66,661.201 824.679,661.136L825.353,656.214L825.506,655.659C825.524,655.593 825.543,655.528 825.561,655.462L826.235,650.54L826.388,649.985C826.406,649.919 826.425,649.854 826.444,649.789L827.117,644.867L827.271,644.311C827.289,644.246 827.307,644.18 827.326,644.115L828,639.193L828.153,638.638C828.242,638.313 828.34,637.99 828.446,637.67L846.94,581.81C817.038,604.131 780.223,616.124 748.305,616.124C671.85,616.124 605.041,559.525 605.041,476.028C605.041,467.083 605.838,457.816 607.487,448.278C608.094,444.183 612.083,418.528 612.752,414.417ZM790.912,458.612L790.912,458.61C787.598,443.525 777.649,429.212 756.945,429.212C743.147,429.212 734.01,435.276 728.478,443.499C733.147,461.149 748.071,472.76 764.273,472.76C776.166,472.76 785.212,467.091 790.912,458.612Z" style="fill:rgb(80,7,36);"/>
+                        </g>
+                        <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-92.6142,497.69)">
+                            <path d="M632.531,417.395C633.925,407.173 636.441,396.561 640.145,385.624C658.865,331.768 713.585,307.576 764.273,307.576C856.433,307.576 890.993,383.608 890.993,431.704C890.993,438.849 890.358,445.719 889.159,452.306C888.912,454.22 884.206,484.479 883.866,486.347C874.812,556.31 802.991,596.124 748.305,596.124C682.641,596.124 625.041,547.74 625.041,476.028C625.041,468.107 625.761,459.898 627.238,451.437C627.494,449.559 632.199,419.299 632.531,417.395ZM811.755,462.297C808.871,436.154 792.895,409.212 756.945,409.212C730.795,409.212 715.373,423.215 707.498,440.12C711.482,471.866 737.027,492.76 764.273,492.76C786.905,492.76 803.258,480.201 811.755,462.297ZM847.255,647.501C847.013,646.551 847,645.524 847.28,644.511L847.433,643.955L919.032,427.688C920.152,424.711 923.34,422.901 926.116,423.667L926.671,423.82L972.347,439.107C985.511,437.957 998.339,439.105 1010,442.322C1056.58,455.168 1089.71,499.051 1080.64,546.893C1080.41,548.777 1074,589.404 1072.82,593.679C1058.88,644.208 1014.26,666.258 961.785,651.785C950.125,648.569 939.201,643.764 929.848,637.599L907.171,705.734C905.975,708.989 902.864,710.521 899.532,709.602L844.848,691.234C842.071,690.468 840.262,687.28 841.104,684.226L841.257,683.671L841.962,681.542C841.719,680.593 841.707,679.565 841.986,678.552L842.139,677.997L842.844,675.869C842.602,674.919 842.589,673.892 842.869,672.879L843.022,672.323L843.726,670.195C843.484,669.246 843.471,668.218 843.751,667.205L843.904,666.65L844.609,664.521C844.366,663.572 844.354,662.545 844.633,661.532L844.786,660.976L845.491,658.848C845.248,657.899 845.236,656.871 845.515,655.858L845.668,655.303L846.373,653.174C846.13,652.225 846.118,651.197 846.397,650.184L846.551,649.629L847.255,647.501ZM1002.3,551.339C998.055,542.959 990.041,536.492 979.452,533.572C975.01,532.347 970.061,531.878 964.958,531.964L958.449,551.34C962.843,554.288 967.966,556.802 973.243,558.258C974.951,558.729 991.099,563.182 1002.3,551.339ZM1096.58,562.396C1096.73,561.452 1102.61,523.627 1102.76,522.681C1109.09,481.986 1144.47,443.769 1209.35,453.858C1279.93,464.832 1273.28,528.211 1271.82,537.603C1271.67,538.513 1265.75,576.612 1265.64,577.318C1263.61,590.408 1256.52,600.382 1238.84,603.462C1233.2,604.453 1226.37,605.023 1219.25,605.24C1219.25,605.586 1215.8,627.954 1215.63,629C1215.19,631.846 1204.78,650.046 1199.01,659.058C1196.03,663.258 1191.71,666.667 1183.45,665.383L1180.04,664.852C1115.44,654.807 1089.86,605.652 1096.58,562.396ZM1177.74,567.147C1177.91,566.104 1181.57,543.215 1181.85,542.724C1175.88,543.144 1170.25,545.887 1165.85,550.525C1168.19,556.603 1172.07,562.375 1177.74,567.22C1177.74,567.191 1177.74,567.167 1177.74,567.147ZM1289.54,541.835C1289.61,541.484 1295.72,502.12 1295.72,502.12C1296.26,498.985 1299.05,496.61 1301.92,496.841L1302.5,496.887L1334.51,501.197C1345.89,499.801 1356.61,499.508 1366.94,500.34C1425.22,505.03 1466.56,544.184 1462.15,599.015L1461.38,608.489C1460.09,624.565 1462.78,637.783 1473.67,649.639C1475.28,651.213 1477.92,654.315 1477.67,657.473C1477.58,658.527 1471.57,696.285 1471.49,697.188C1471.35,698.91 1470.35,700.563 1468.23,701.837C1468.18,702.411 1438.12,720.506 1438.12,720.506C1435.07,722.572 1432.13,723.202 1429.54,722.994C1424.38,722.578 1379.67,703.667 1383.78,652.568L1384.57,642.807C1386.96,613.082 1373.74,599.241 1353.37,596.145L1344.84,660.073C1344.8,660.541 1338.66,699.789 1338.66,699.789C1338.43,702.659 1335.64,705.035 1332.77,704.804L1332.2,704.758L1275.01,697.266C1271.59,696.702 1269.5,693.934 1269.78,690.489L1289.54,541.835Z" style="fill:rgb(190,24,93);"/>
+                        </g>
+                        <g transform="matrix(1,0,0,1,-43.4435,390.084)">
+                            <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                                <path d="M890.993,431.704C890.993,383.608 856.433,307.576 764.273,307.576C713.585,307.576 658.865,331.768 640.145,385.624C634.097,403.48 631.217,420.472 631.217,436.312C631.217,508.024 688.817,556.408 754.481,556.408C812.945,556.408 890.993,510.904 890.993,431.704ZM764.273,492.76C734.609,492.76 706.961,467.992 706.961,431.416C706.961,405.208 721.361,369.496 763.121,369.496C803.153,369.496 818.417,402.904 818.417,431.416C818.417,463.96 798.545,492.76 764.273,492.76Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(0.988125,-0.153652,0.153652,0.988125,-49.1707,107.606)">
+                                <path d="M658.955,513.568C645.897,498.25 636.678,479.342 632.996,457.701L714.963,397.795C709.338,408.549 706.961,420.767 706.961,431.416C706.961,446.421 711.614,459.439 719.15,469.574L658.955,513.568ZM752.552,370.323L821.848,319.678C842.275,329.346 857.63,343.956 868.616,360.337L812.433,401.398C804.743,383.652 789.179,369.496 763.121,369.496C759.381,369.496 755.862,369.783 752.552,370.323ZM816.987,416.323L876.142,373.089C881.54,383.546 885.366,394.366 887.782,404.821L813.016,459.464C816.564,450.939 818.417,441.352 818.417,431.416C818.417,426.466 817.957,421.368 816.987,416.323ZM767.582,492.669L697.945,543.564C687.488,538.487 677.836,531.996 669.311,524.252L729.459,480.292C739.38,488.271 751.644,492.76 764.273,492.76C765.391,492.76 766.495,492.73 767.582,492.669Z" style="fill:rgb(254,205,211);"/>
+                            </g>
+                            <g transform="matrix(0.993411,0.114605,-0.114605,0.993411,47.4331,-108.207)">
+                                <path d="M979.985,630.424C983.441,630.424 986.033,628.12 986.321,624.664L990.065,552.952C1000.72,556.408 1012.53,558.136 1024.62,558.136C1079.06,558.136 1116.21,525.016 1116.21,472.6C1116.21,420.184 1070.7,383.32 1020.02,383.32C1007.92,383.32 995.249,385.624 982.865,390.232L934.769,387.64L934.193,387.64C931.313,387.64 928.721,390.232 928.433,393.4L916.913,620.92L916.913,621.496C916.913,624.664 919.505,627.256 922.385,627.256L979.985,630.424ZM995.825,441.784C1000.72,440.344 1005.62,439.48 1010.23,439.48C1030.38,439.48 1045.36,453.304 1045.36,473.176C1045.36,504.856 1017.71,504.856 1015.41,504.856C1007.35,504.856 998.993,502.552 992.657,499.384L995.825,441.784Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(1,0,0,1,-17.5818,-14.5051)">
+                                <path d="M1240.05,557.56C1248.4,557.56 1252.14,553.528 1254.45,548.92C1258.77,539.128 1266.26,519.544 1266.26,516.664C1266.26,511.768 1261.36,509.176 1257.33,509.176L1256.75,509.176C1254.74,509.464 1252.43,509.464 1250.42,509.464C1214.42,509.464 1199.44,486.424 1199.44,465.976C1199.44,448.12 1210.96,436.024 1224.79,436.024C1236.88,436.024 1242.35,445.24 1242.35,447.832C1242.35,451.864 1203.27,460.514 1188.3,463.97C1184.55,464.834 1182.25,466.274 1182.25,469.442C1182.25,470.594 1187.72,489.314 1191.18,498.818C1192.33,502.274 1193.77,504.29 1198.38,504.29C1213.35,503.714 1271.73,492.472 1285.27,487.864C1302.26,482.104 1307.73,471.16 1307.73,457.912C1307.73,448.408 1304.56,384.76 1233.14,384.76C1167.47,384.76 1138.38,427.96 1138.38,469.144C1138.38,512.92 1171.22,557.56 1236.59,557.56L1240.05,557.56Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                                <path d="M1517.97,474.04C1517.97,419.032 1473.62,383.32 1415.15,383.32C1404.79,383.32 1394.13,384.472 1382.9,386.776L1350.64,385.048L1350.07,385.048C1347.18,385.048 1344.59,387.64 1344.31,390.808L1336.53,540.568C1336.53,544.024 1338.83,546.616 1342.29,546.904L1399.89,549.784L1400.46,549.784C1403.35,549.784 1405.94,547.192 1405.94,544.312L1411.41,439.768C1432.43,440.92 1447.12,453.592 1447.12,483.832L1447.12,493.624C1447.12,544.888 1493.2,560.152 1498.38,560.152C1500.98,560.152 1503.86,559.288 1506.74,556.984C1506.74,556.984 1535.25,536.536 1535.25,535.96C1537.27,534.52 1538.13,532.792 1538.13,531.064C1538.13,527.896 1535.25,525.016 1533.52,523.576C1521.71,512.632 1517.97,499.672 1517.97,483.544L1517.97,474.04Z" style="fill:rgb(251,113,133);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(0.997266,-0.0738892,0.0738892,0.997266,-61.1926,114.263)">
+                                <path d="M1336.98,531.794L1341.07,453.028L1421.76,383.474C1446.18,384.621 1467.83,392.129 1484.38,404.732L1434.2,447.993C1428.18,442.845 1420.37,440.26 1411.41,439.768L1409.88,468.954L1336.98,531.794Z" style="fill:rgb(254,205,211);"/>
+                            </g>
+                        </g>
+                    </g>
+                    <g id="EUICC">
+                        <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                            <path d="M1529.66,323.25L1530.24,318.097L1531.91,313.067L1537.48,304.991L1545.56,299.416L1550.59,297.742L1556.23,297.117L1555.14,297.147L1607.55,294.267C1607.92,294.247 1608.28,294.237 1608.65,294.237L1609.28,294.237L1685.36,290.232C1685.71,290.214 1686.06,290.205 1686.41,290.205L1686.99,290.205L1692.62,290.829L1697.63,292.486L1705.57,297.875L1711.07,305.392L1713.83,315.168C1713.85,315.415 1713.87,315.662 1713.88,315.91L1716.18,366.022C1716.23,366.997 1716.2,367.974 1716.1,368.945L1712.25,407.169L1712.35,405.165L1711.73,410.803L1710.07,415.805L1704.68,423.745L1702.17,425.582L1701.8,454.178C1701.8,454.566 1701.78,454.954 1701.75,455.342C1701.74,455.569 1701.35,459.409 1700.84,464.369L1704.27,464.726L1709.3,466.307L1717.59,471.827L1720.39,475.797L1750.15,343.037C1750.23,342.693 1750.31,342.351 1750.41,342.011L1750.56,341.457L1755.18,332.244L1762.58,325.657L1771.65,322.228L1781.57,322.274C1781.79,322.317 1782.01,322.364 1782.23,322.414L1839.3,335.429C1839.62,335.502 1839.94,335.583 1840.26,335.671L1840.81,335.827L1845.81,337.802L1850.15,340.632L1856.52,348.037L1859.79,356.937L1859.72,366.648C1859.81,366.106 1859.92,365.462 1859.92,365.462C1859.92,365.462 1859.88,365.868 1859.84,366.203C1859.15,372.715 1856,403.718 1855.87,404.404C1855.83,404.61 1855.79,404.814 1855.74,405.018C1840.04,474.681 1834.97,497.588 1832.54,508.606C1834.98,512.172 1839.03,514.495 1843.31,515.695C1852.53,518.282 1863.62,514.988 1867.93,503.383C1867.94,503.366 1867.95,503.349 1867.95,503.332C1872.56,491.026 1877.62,473.928 1882.81,455.42C1889.74,430.734 1896.6,403.073 1902.51,377.805C1902.57,377.52 1902.65,377.236 1902.73,376.954L1902.88,376.4L1904.79,371.384L1907.74,366.67L1911.59,362.679L1915.93,359.72L1921.17,357.555L1925.98,356.587L1932.13,356.545L1937.33,357.512L1992.79,373.066L1997.92,375.104L2002.36,378.011L2006.47,382.81L2009.04,357.694L2010.17,352.278L2012.29,347.386L2018.84,339.595L2027.79,334.762L2033.01,333.671L2038.55,333.659L2101.87,340.132L2107.28,341.264L2112.17,343.389L2119.96,349.934L2124.8,358.887L2125.89,364.108L2125.9,369.642L2115.53,471.116C2143.21,409.347 2206.89,385.97 2270.03,392.426C2299.72,395.461 2326.88,405.708 2345.87,421.131C2346.07,421.298 2346.28,421.47 2346.47,421.646L2350.73,426.445L2354.33,433.635L2355.74,439.783L2355.83,446.488C2355.81,446.624 2355.65,448.219 2355.39,450.706C2394.87,378.213 2471.61,366.264 2538.55,390.564C2566.6,400.747 2590.44,417.309 2605.09,436.895C2605.25,437.108 2605.4,437.324 2605.55,437.543L2608.8,444.04L2610.14,450.046L2610.27,455.837C2610.27,455.837 2609.5,460.324 2609.5,460.335C2608.32,472.137 2605.17,500.328 2604.72,501.565L2600.54,509.227C2600.46,509.325 2600.38,509.423 2600.3,509.52L2569.61,546.79C2569.54,546.883 2569.46,546.976 2569.38,547.068L2563.29,552.297L2557.1,555.157L2557.72,555.483L2562.91,560.182L2567.64,567.768L2569.47,574.713L2569.34,573.79C2569.34,573.79 2576.42,617.086 2576.45,617.261L2577.04,625.138C2577.04,625.138 2576.38,629.107 2576.38,629.115C2575.36,639.604 2571.95,670.32 2571.52,671.508L2568.53,677.46L2564.22,682.586L2554.28,689.179C2508.17,710.726 2463.62,711.215 2426.71,697.818C2400.61,688.344 2378.3,671.989 2361.82,651.186L2361.22,657.045L2359.78,663.547L2356.85,669.569L2348.81,678.388C2309.35,710.528 2266.26,721.867 2227.21,717.875C2166.55,711.673 2115.4,668.929 2101.42,609.116L2099.18,631.051L2098.04,636.468L2095.92,641.36L2089.37,649.151L2080.42,653.983L2075.2,655.075L2069.66,655.087L2006.35,648.614L2000.93,647.482L1996.04,645.357L1988.25,638.812L1983.42,629.858L1982.32,624.637L1982.31,619.104L1994.61,498.787C1992.33,507.533 1989.89,516.562 1987.37,525.565C1981.93,544.968 1976.1,564.57 1970.05,580.691C1942.99,654.487 1869.67,675.445 1808.25,658.22C1770.35,647.591 1737.45,622.729 1722.23,587.267L1722,588.508L1716.83,596.917L1708.76,603.114L1703.78,605.045L1698.39,605.978C1698.27,605.986 1698.15,605.994 1698.04,606L1623.16,610.032C1623,610.04 1622.84,610.047 1622.68,610.052L1620.93,610.349L1621.95,610.323L1565.79,613.203C1565.45,613.22 1565.11,613.229 1564.77,613.229L1564.19,613.229L1558.49,612.587L1553.36,610.839L1545.34,605.142L1540.11,597.538L1537.64,588.266C1537.62,588.062 1537.61,587.859 1537.6,587.655L1525.79,363.015C1525.74,361.986 1525.76,360.955 1525.87,359.931L1529.71,322.283L1529.66,323.25ZM2332.02,549.385C2332.09,548.761 2332.16,548.136 2332.23,547.51C2332.45,545.229 2333.61,533.848 2334.54,524.786L2328.96,536.557C2328.91,536.666 2328.86,536.775 2328.8,536.883L2324.18,543.44L2321.07,545.949L2321.51,545.913L2328.84,547.691L2332.02,549.385ZM2533.29,552.067L2533.05,551.946C2533.05,551.946 2527.22,546.283 2527.4,546.524C2522.66,540.295 2512.51,533.182 2501.15,529.058C2490.46,525.177 2480.78,524.606 2472.69,528.046C2466.84,530.534 2462.07,535.044 2458.31,541.082C2462.57,548.738 2470.22,554.495 2479.36,557.815C2493.84,563.071 2512.48,562.197 2530.54,553.069C2530.72,552.977 2530.91,552.887 2531.09,552.8L2533.29,552.067ZM1622.69,610.051C1624.08,610.004 1626,609.79 1627.83,609.179L1622.69,610.051ZM2301.84,552.027L2301.48,552.057L2294.76,550.474C2294.76,550.474 2287.72,546.405 2287.96,546.595C2281.85,541.707 2270.27,537.286 2258.24,536.056C2242.55,534.452 2230.31,539.236 2223.53,549.756C2228.51,561.063 2240.18,567.707 2253.42,569.061C2268.73,570.626 2286.56,565.249 2301.84,552.027Z" style="fill:rgb(46,16,101);"/>
+                        </g>
+                        <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-618.445,822.813)">
+                            <path d="M2002.21,621.138L2028.93,359.728C2029.31,356.004 2032.79,353.174 2036.51,353.555L2099.83,360.028C2103.55,360.409 2106.38,363.883 2106,367.608L2079.28,629.017C2078.9,632.742 2075.42,635.571 2071.7,635.191L2008.38,628.717C2004.66,628.336 2001.83,624.863 2002.21,621.138ZM1545.76,361.965L1549.61,324.317L1549.61,323.741C1549.61,320.285 1552.78,317.117 1556.23,317.117L1608.65,314.237L1609.8,314.237L1686.41,310.205L1686.99,310.205C1690.44,310.205 1693.61,313.373 1693.9,316.829L1696.2,366.941L1692.35,405.165C1692.35,408.621 1689.18,411.789 1685.73,412.077L1682.35,412.251L1681.8,453.917C1681.76,454.559 1678.62,485.045 1678.61,485.206L1698.22,484.157L1698.79,484.157C1702.54,484.157 1705.71,487.325 1705.71,490.781L1707.72,540.893C1707.72,541.708 1703.87,578.541 1703.87,578.541C1703.87,582.285 1700.99,585.741 1696.96,586.029L1622.08,590.061C1621.79,590.061 1621.22,590.349 1620.93,590.349L1564.77,593.229L1564.19,593.229C1560.74,593.229 1557.86,590.061 1557.57,586.605L1545.76,361.965ZM1737.5,495.591C1737.93,490.61 1738.72,485.491 1739.89,480.242L1769.66,347.412L1769.82,346.858C1770.83,343.253 1774.38,341.257 1777.79,341.913L1834.86,354.928L1835.41,355.084C1838.74,356.017 1840.73,359.568 1840.08,362.973C1839.98,363.389 1836.37,399.892 1836.23,400.621C1816.75,487.073 1813.63,501.561 1811.61,510.641C1815.31,523.002 1825.75,531.543 1837.91,534.952C1856.21,540.085 1878.13,533.372 1886.68,510.346C1891.45,497.624 1896.7,479.955 1902.07,460.821C1909.07,435.864 1916.02,407.901 1921.98,382.355L1922.14,381.801C1923.77,375.977 1929.15,375.991 1931.92,376.769L1987.38,392.323C1990.99,393.334 1993.18,397.24 1992.45,400.923C1992.37,401.306 1988.75,437.82 1988.6,438.571C1984.58,457.184 1976.9,488.83 1968.11,520.165C1962.82,539.021 1957.18,558.077 1951.28,573.771C1928.32,636.428 1865.78,653.585 1813.65,638.963C1766.18,625.65 1727.35,586.23 1734,529.817C1734.1,528.683 1737.36,496.739 1737.5,495.591ZM2118.35,562.156C2118.41,561.55 2122.15,525.047 2122.2,524.508C2131.08,437.697 2200.1,405.381 2268,412.323C2293.5,414.929 2316.95,423.407 2333.26,436.654C2335.11,438.291 2336.22,441.589 2335.93,444.454C2335.86,445.139 2331.94,483.535 2331.56,484.365L2310.89,527.993C2309.8,530.197 2306.67,532.483 2303.51,532.16C2302.37,532.043 2301.25,531.64 2300.45,530.979C2292.16,524.341 2276.61,517.83 2260.28,516.16C2231.63,513.231 2211.11,525.354 2202.07,547.952C2206.98,571.507 2227.03,586.467 2251.39,588.957C2271.44,591.007 2294.99,584.44 2315,567.089C2316.26,566.06 2318.04,565.663 2319.47,565.809C2322.34,566.102 2325.31,568.144 2326.22,570.553L2343.79,611.141C2344.73,613.264 2345.38,615.358 2345.18,617.363C2345.12,617.946 2341.39,654.456 2341.33,655.011C2341.07,657.59 2339.66,660.051 2336.18,662.881C2301.44,691.174 2263.62,701.493 2229.24,697.978C2163.63,691.271 2110.91,634.929 2118.35,562.156ZM2355.61,515.419C2356.56,504.634 2358.96,493.637 2362.97,482.606C2392.74,400.58 2467.56,386.072 2531.72,409.364C2555.82,418.11 2576.49,432.051 2589.07,448.874C2590.36,450.748 2590.7,453.826 2589.98,456.412C2590.05,457.555 2586.38,493.465 2585.92,494.74C2585.62,495.552 2585.43,496.093 2584.86,496.807L2554.17,534.077C2552.58,535.947 2548.98,537.401 2546.01,536.32C2544.92,535.927 2543.94,535.263 2543.32,534.427C2536.9,525.966 2523.41,515.86 2507.98,510.259C2475.6,498.505 2449.24,510.468 2436.39,539.959C2441.03,556.869 2454.59,570.098 2472.54,576.614C2491.49,583.494 2515.92,582.866 2539.56,570.919C2541.03,570.229 2542.86,570.278 2544.21,570.769C2546.92,571.752 2549.3,574.457 2549.6,577.016L2556.74,620.662C2557.11,622.803 2557.24,624.857 2556.69,626.664C2556.75,627.869 2553.14,663.515 2552.72,664.683C2551.83,667.12 2549.87,669.163 2545.81,671.06C2505.22,690.028 2466.02,690.812 2433.54,679.019C2380.44,659.742 2345.39,607.458 2352.11,549.644C2352.21,548.506 2355.48,516.562 2355.61,515.419Z" style="fill:rgb(91,33,182);"/>
+                        </g>
+                        <g transform="matrix(1,0,0,1,-45.5223,-53.0944)">
+                            <g transform="matrix(0.994815,-0.101704,0.101704,0.994815,-572.922,875.907)">
+                                <path d="M1700.81,548.381C1704.84,548.093 1707.72,544.637 1707.72,540.893L1705.71,490.781C1705.71,487.325 1702.54,484.157 1698.79,484.157L1698.22,484.157L1628.23,487.901L1626.79,461.117L1674.6,461.117C1678.63,461.117 1681.51,457.949 1681.8,453.917L1682.38,409.853L1682.38,409.277C1682.38,405.533 1678.92,402.653 1675.47,402.653L1623.91,402.653L1622.47,377.885L1689.58,374.429C1693.03,374.141 1696.2,370.973 1696.2,367.517L1696.2,366.941L1693.9,316.829C1693.61,313.373 1690.44,310.205 1686.99,310.205L1686.41,310.205L1609.8,314.237L1608.65,314.237L1556.23,317.117C1552.78,317.117 1549.61,320.285 1549.61,323.741L1549.61,324.317L1561.42,548.957C1561.71,552.413 1564.59,555.581 1568.04,555.581L1568.62,555.581L1624.78,552.701C1625.07,552.701 1625.64,552.413 1625.93,552.413L1700.81,548.381Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(0.98532,0.170719,-0.170719,0.98532,-440.459,422.474)">
+                                <path d="M1908.79,310.456C1905.9,310.456 1900.72,311.896 1900.72,317.944L1900.72,318.52C1901.87,344.728 1902.74,373.528 1902.74,399.448C1902.74,419.32 1902.45,437.752 1901.3,451.288C1899.28,475.768 1879.99,488.152 1860.98,488.152C1842.55,488.152 1824.69,476.632 1823.54,453.304C1822.1,421.336 1823.54,455.32 1816.62,321.976C1816.34,318.52 1813.46,315.64 1810,315.64L1809.42,315.64L1750.96,318.52C1747.51,318.808 1744.62,321.688 1744.62,325.432L1744.62,326.008L1751.83,461.944C1755.28,526.168 1806.55,557.56 1859.25,557.56C1913.39,557.56 1968.98,524.152 1974.16,457.624C1975.6,440.92 1975.89,421.048 1975.89,401.464C1975.89,368.92 1974.74,336.376 1973.59,317.368C1973.3,313.624 1970.13,310.456 1966.38,310.456L1908.79,310.456Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(1,0,0,1,-537.877,707.46)">
+                                <path d="M2090.51,551.8C2094.26,551.8 2097.43,548.632 2097.43,544.888L2097.43,319.96C2097.43,316.216 2094.26,313.048 2090.51,313.048L2026.87,313.048C2023.12,313.048 2019.95,316.216 2019.95,319.96L2019.95,544.888C2019.95,548.632 2023.12,551.8 2026.87,551.8L2090.51,551.8Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(1,0,0,1,-542.093,747.563)">
+                                <path d="M2341.36,459.352C2340.21,457.048 2337.04,455.32 2334.16,455.32C2332.72,455.32 2330.99,455.896 2329.84,457.048C2311.7,476.344 2288.95,485.272 2268.78,485.272C2238.55,485.272 2212.91,465.688 2212.91,431.704C2212.91,396.568 2233.94,374.104 2270.22,374.104C2286.64,374.104 2302.77,379 2311.7,384.76C2312.56,385.336 2313.71,385.624 2314.87,385.624C2318.03,385.624 2320.91,383.032 2321.78,380.728L2337.91,335.224C2338.19,334.36 2338.19,333.784 2338.19,332.92C2338.19,330.04 2336.75,326.872 2334.74,325.432C2317.17,313.912 2292.98,307.864 2267.35,307.864C2199.09,307.864 2133.71,347.032 2133.71,434.296C2133.71,507.448 2191.89,558.136 2257.84,558.136C2292.4,558.136 2328.98,544.024 2360.66,512.344C2363.83,509.176 2364.98,506.584 2364.98,503.992C2364.98,501.976 2364.11,499.96 2362.96,497.944L2341.36,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                            </g>
+                            <g transform="matrix(0.969808,0.24387,-0.24387,0.969808,-375.869,113.966)">
+                                <path d="M2588.18,459.352C2587.03,457.048 2583.86,455.32 2580.98,455.32C2579.54,455.32 2577.81,455.896 2576.66,457.048C2558.51,476.344 2535.76,485.272 2515.6,485.272C2485.36,485.272 2459.73,465.688 2459.73,431.704C2459.73,396.568 2480.75,374.104 2517.04,374.104C2533.46,374.104 2549.59,379 2558.51,384.76C2559.38,385.336 2560.53,385.624 2561.68,385.624C2564.85,385.624 2567.73,383.032 2568.59,380.728L2584.72,335.224C2585.01,334.36 2585.01,333.784 2585.01,332.92C2585.01,330.04 2583.57,326.872 2581.55,325.432C2563.99,313.912 2539.79,307.864 2514.16,307.864C2445.91,307.864 2380.53,347.032 2380.53,434.296C2380.53,507.448 2438.7,558.136 2504.66,558.136C2539.22,558.136 2575.79,544.024 2607.47,512.344C2610.64,509.176 2611.79,506.584 2611.79,503.992C2611.79,501.976 2610.93,499.96 2609.78,497.944L2588.18,459.352Z" style="fill:rgb(192,132,252);fill-rule:nonzero;"/>
+                            </g>
+                        </g>
+                    </g>
+                    <path d="M988.333,1002.5C988.379,1003.47 988.508,1005.49 988.818,1007.18C989.725,1012.13 991.45,1018.87 993.403,1028.25C994.303,1032.57 991.525,1036.81 987.202,1037.71C982.88,1038.61 978.639,1035.83 977.739,1031.51C974.599,1016.43 972.184,1007.68 972.265,1002.27C972.315,998.949 973.077,996.344 974.363,994.171L977.247,990.719C978.213,989.878 979.348,989.105 980.697,988.415C983.011,987.231 987.42,986.061 992.612,985.228C1002.58,983.629 1015.86,982.795 1017.84,982.672C1022.25,982.398 1026.05,985.753 1026.32,990.16C1026.6,994.567 1023.24,998.367 1018.83,998.641C1016.97,998.757 1004.5,999.525 995.145,1001.03C992.296,1001.48 989.786,1001.89 988.333,1002.5Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1195.95,1039.37C1195.02,1043.68 1190.77,1046.44 1186.45,1045.51C1182.13,1044.59 1179.38,1040.33 1180.3,1036.02C1180.85,1033.44 1184.24,1017.62 1186.73,1003.7C1187.37,1000.08 1190.41,997.365 1194.08,997.125C1204.16,996.469 1204.01,996.191 1214,997.195C1218.39,997.636 1221.6,1001.56 1221.16,1005.96C1220.71,1010.35 1216.79,1013.56 1212.4,1013.11C1206.5,1012.52 1204.67,1012.46 1201.35,1012.66C1199.02,1024.99 1196.43,1037.12 1195.95,1039.37Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1289.49,1196.2C1285.4,1197.87 1280.73,1195.9 1279.06,1191.81C1277.39,1187.73 1279.36,1183.05 1283.45,1181.38C1291.16,1178.24 1295.88,1176.49 1299.86,1172.93C1303.92,1169.3 1307.14,1163.9 1312.33,1154.03C1314.38,1150.12 1319.22,1148.61 1323.13,1150.66C1327.04,1152.72 1328.54,1157.56 1326.49,1161.47C1320.01,1173.81 1315.6,1180.32 1310.53,1184.86C1305.38,1189.46 1299.47,1192.13 1289.49,1196.2Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1463.37,993.495C1463.11,995.117 1462.65,998.235 1462.56,1000.72C1462.29,1008.23 1462.8,1016.95 1462.83,1021.2C1462.85,1025.62 1459.29,1029.22 1454.87,1029.25C1450.45,1029.27 1446.85,1025.7 1446.83,1021.29C1446.79,1014.44 1445.8,996.976 1447.92,988.886C1448.48,986.742 1449.26,985.008 1450.11,983.729L1452.06,981.477L1454.04,980.104C1457.58,978.226 1457.62,978.465 1473.31,975.976C1477.67,975.284 1481.77,978.263 1482.46,982.624C1483.15,986.985 1480.18,991.086 1475.82,991.778C1467.37,993.118 1465.03,993.073 1463.37,993.495Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1585.5,1098.21C1585.07,1102.6 1581.16,1105.82 1576.76,1105.4C1572.37,1104.97 1569.15,1101.05 1569.58,1096.66C1572.43,1067.37 1598.83,1046.25 1614.85,1037.04C1618.67,1034.84 1623.57,1036.16 1625.77,1039.99C1627.97,1043.82 1626.64,1048.72 1622.82,1050.91C1609.93,1058.32 1587.8,1074.63 1585.5,1098.21Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1740.17,1170.75C1743.74,1168.16 1748.75,1168.95 1751.34,1172.53C1753.93,1176.1 1753.14,1181.11 1749.56,1183.7C1735.58,1193.84 1735.59,1194.13 1721.98,1197.65C1717.71,1198.76 1713.34,1196.19 1712.23,1191.91C1711.12,1187.64 1713.7,1183.27 1717.97,1182.16C1728.96,1179.32 1728.88,1178.94 1740.17,1170.75Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1822.12,1050.48C1820.66,1054.65 1816.09,1056.85 1811.93,1055.39C1807.76,1053.93 1805.56,1049.36 1807.02,1045.19C1812.53,1029.48 1820.56,1007.67 1857.96,995.197C1862.15,993.8 1866.68,996.067 1868.08,1000.25C1869.48,1004.44 1867.21,1008.98 1863.02,1010.38C1833.01,1020.38 1826.54,1037.87 1822.12,1050.48Z" style="fill:rgb(233,213,255);"/>
+                    <path d="M1930.13,1172.93C1925.81,1173.86 1921.55,1171.1 1920.63,1166.78C1919.7,1162.46 1922.46,1158.21 1926.78,1157.29C1941.59,1154.11 1941.14,1153.31 1950.54,1149.02C1954.55,1147.19 1959.3,1148.96 1961.14,1152.97C1962.97,1156.99 1961.2,1161.74 1957.18,1163.57C1946.5,1168.46 1946.99,1169.32 1930.13,1172.93Z" style="fill:rgb(233,213,255);"/>
+                </g>
+            </g>
+        </g>
+    </g>
+</svg>

From c32ae6946d2664e511bf70e3558978c1db645eda Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 13:31:20 -0400
Subject: [PATCH 079/458] README: use 512x variant of the logo

---
 README.md               |   2 +-
 art/OpenEUICCBG_512.png | Bin 0 -> 97218 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 art/OpenEUICCBG_512.png

diff --git a/README.md b/README.md
index dc0fe56d5..251e356ae 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![](art/OpenEUICCBG.png)
+![](art/OpenEUICCBG_512.png)
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 
diff --git a/art/OpenEUICCBG_512.png b/art/OpenEUICCBG_512.png
new file mode 100644
index 0000000000000000000000000000000000000000..6a667540ed645a736b24306134a22a53eec7e7cb
GIT binary patch
literal 97218
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
MODalKiWvs{A10h6O#lD@

literal 0
HcmV?d00001


From 9f6df17a1dc0406dc6073b0607d25d8a1cb9dae3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 13:34:25 -0400
Subject: [PATCH 080/458] README: Use 768 variant instead

---
 README.md               |   2 +-
 art/OpenEUICCBG_512.png | Bin 97218 -> 0 bytes
 art/OpenEUICCBG_768.png | Bin 0 -> 111798 bytes
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 art/OpenEUICCBG_512.png
 create mode 100644 art/OpenEUICCBG_768.png

diff --git a/README.md b/README.md
index 251e356ae..fff71b7d3 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![](art/OpenEUICCBG_512.png)
+![](art/OpenEUICCBG_768.png)
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 
diff --git a/art/OpenEUICCBG_512.png b/art/OpenEUICCBG_512.png
deleted file mode 100644
index 6a667540ed645a736b24306134a22a53eec7e7cb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 97218
zcmX6^1yoy26AkX(;_mJgcPZ{#+={zXEI7rA1}GGV;_ecx&_Z!7f#UA&<WIl<<m4rJ
zIp^){&W_wWvvHd0@3GKH(E$JemXe~JHUIz*`wGX7iVXW`dBtFb{qS^<mDO~xwgv#0
zQ+!goR1l<bV<ZU}Hp!ananXwOS$UMFhH0gX3kZ3_wZ3j&;$I4#;?pmox56P!4;vJQ
z0$amdsF^=gFI2pB(Vgg^|3dvSGw<cLjc@Rj-S8QWp<+>#I(yV!q7KrFZ`cAsU;190
zXf_=2xt5cC{Jz2=KN+9RSJHW*lH#sTAcn3J-Y0QD=X0fPq+QgWAYbLLPXngPV#I{K
zxRf*7;R85jl&l{8+lFyqwS{L197B=FlLl67y$1Zn)PYOS$F#U=?cU^v)J#Rk0Hp<q
zZ1Mg3^UdK2@>zd(p3xG2qCp{&6bgY$iXYGNGpSXv2EPg$q!WZlqUFYwZ(^&prs;U`
zw|~DvPpT*>yfQ1>+6y=4x&NZ{wPHvH4Bm_IB;@PV_xAZzrshjT$Kgz0y{&<wF1Kx5
zmK8<aZaAWJ=Fb-pvMcLnXWGB{J5eYA$n%?O);~0Q$ZcXecl%|qI?zvpsT}n5$Q5*C
zca9KH$q!QkwY8$Q8UPT;2mpjd0sxP&TVeYEfDbnSaA*Mlh-3i(MDDqrT4Jz2kgZhS
z%K@POUIjhnX|OwJ?utfU000KTzc(BpCzlv@6UAFeO&(<*1rCprSDb^37N+CYKwU#`
zZA(9DcTcyE4$ijJ-U05m)c+}6C^1jRxRH(q^~LXP6XJHo*ug@p<1H8{-N2{BdPfIh
z9lgfe05Bc6IUP*$SL9fbqC4r#xFV`z%+!J!3aQEH!rxSQQiqxTs2dmWG7o7dU>a9e
zKwgP5jM^Z2*X_8R4e}XywYV)U<=WElSymv8;!O`bQ2t9y{GmBLz}%hh3avkJan<wV
zo^cR4nWV2+>-Lt3bwd0rv>ziR1I2an-d<3Gpuvst`=&T2V(2*ultx0WGJ1LI=^IZY
zS5fx<)6^MAO`Z$y&t2@Nr9UhaYH=7p-XkP5ea@dZwTO$KTP4t11+Pw{O(pbbn{dK~
z^si%oMO;Fvpp)OpmU@r6&|M__J){!hFyb3zkg$QV-^>;~Pm&LBC;_QT1`njE?F@W%
zH&s!VOYYP3-2#-DTay-6yH!=iOtY~+i(QI5)yf6efPrQQ1PBx~1gv!Uk3o_@XcqC(
zG3sjamiMh?s#{NMs`)^tVIM&%A?U?j0=jt!S3~}Wn9_%ViZon8+d<Qiqr>$A*Z7qB
zysPa6eTy2Oo9He8ro#bM7(BGp`sR;5Y)=4`<fL`|mydh=f^7a6?Lx)x^lMX<S$Eid
zuxEwUC-^Ask_m<x{dp`52RQ3h4Er#SIT@e(-VtLC4=?$<w_f;@GX=;@dQTXw*5sC^
zvKp+qhlJ*`w#X>eq|R9m-vpJFb+N5{n&{BG3!WhRW}qpDC;z4av;Ohbb5{qh;O!Fj
z3R*LqSs&ld<jR^_0nt7pCmaaKSs?oK%uIciXHW;t7yNW6|K=hmvi%PNb5Sg<86?Z{
zUcdtBoca8t1)U~VJBB#>7eEm+tvj+1dafK^q$RcZm8?83Y$S~LDS$Uxa(MAFl!IW5
zd*Sp8x2?w&b1NxHcS`@a_dM>TsFOj~DVT4xhMt-6!)QM<7g_w~eys{KN0tE0{ar6q
z1=s<J!t8+7ee1sk-~N)qlmD&o|3_jBV-B9d|HXOMuvi_ZBxALi!WKgbA`n6xD(@{+
zMEuOW$@&?wAeQ#CA?`<FDCzng&>S&H@RM@@H(WP-5Y{~&YqABtJng^bfd6-42k<38
zk=NaT?_F=(33<KO;m;}7tNJYaCVC9%;pLy{ixmMd@nQpb2JhVvUrE}xJ|;Wi5d(TL
zgGe)kgyLxNm^YdJ|ExNK?TSHjeoy2JADid$A_RGO38aMaTrWKN=aPbdPuUbm5Kib#
z8Xb0nBh|DLOJts=;CPBHM)VB~lhAbumbCcoQ7N*H(H9~3X<`hK%pd*UT6ZVxLpv=R
zYz)-@<gJt5=6P1vWqdv9TkTU%pT;gg?Kk=I{rEv*U5M4=RDK=NAj)^8&l~~l+q4%<
z;f{Atx6bybg*i2hHpEJk9spA)=^*A7mDI1}SN?Nu$35`e+70Tt7^~T<*tyU-PrA+7
z5uSD58GJs&S879gIM@RG6a7AJpk;Hr?J_ZRcq#8Y`?ER1sSF-)M}ahh-C&Xz_1T`3
z8c{JW-2!qbOw%}tKs_J&X9R0V=o}mtDx-(JGP4#1Qwa7OG%36~V|Hp5_4hvpT^a>n
zy4^aFF#8ias*yqnT8?o39ygd`<Y1S<1@|BmO_V!;vn=hW=rbBUgb;0QMSQT-9i1q2
z^$#Oi$<s3(?-59II013ZZm2Y|05Eot#NAMh`$;_WW?&&qVE<K`<PE=qNGJUw$0dj+
zmZRAByym#hhr0r+0Z?P|bT&%oG_vKe33=ZqO`aoT=>Rt~ds5=)?WL4A8sa27eN|}4
zC~CY8am_n6PLec;o!HnheP@fPi2Rj~<kcoSR;z)6Rr+1__MX~iWm}iAM<+D<G8JUK
z>7R-e;XnKL6#XXxb@GNABBhi-`5&OCEy!ex`<=4<DepP&IlVjg(+a(7q*fMBzUO)y
zaLurf+*O1h>oHL6^`yzN_b!jw+L}=Y^(}H1if4`oXunf4vfu+=I7L^tGvu_iV?J)J
z4!9oZk76brU?B2OLH;lQ4LMGiykU;;{N|i<F3FthI!gyvwqoQ(^qfOCoZLMaYcN5$
z2H}<K+*kMKW@dC*f1EYT>mygRurEE5D%u4Xynzys7P0Wl#9@o8@5ybWS6lMDlPRJy
z|IgjG>;$ja_Z;bd-~Y|e^uNK>tfLF7Wm<|~7%Xmh^GD@QFrn!85;})FAc)ZKtXZ<K
zWO(Du0EtDU9ORMY()%<?^6h~K{?6X#HsTB^=4pOu2hFWkHA>1r{=O5x`-&>Rf&&X<
z6^U`;bF+1ae{R7n|G#V6&!!_V)mt(!=%`C2sQ}SK;`1m8AahbmH5-H-gnF-|+dII4
zqZaYaHDV2#2bV;tG~x7Y`wl_{fU`<zD<UUx7eN~5;5_YJoQz0DTxy?A9OKA5#Ji_F
zmuTF`|7Tn`(X?<d>x>~8mW(}=hZ=vE1CvD&g{?{Npa4_^admcg6l@=$c#GxTZhvSH
zOJ-A(U;l8MLl1{?8$yhi_hm-5Za1g&Y#6Oci4~A%TNxuBWKiXR9uc_>TsQ|ScVYSY
zfuSTvg6%;0J=79lzI+_w+kd7Y`kz6tz&zhqAQY=Rqx8oEQ9NH?9lYd(c!MDwkF8nA
zI*w-KuouB@GqXKu&>lqV^*9+tiE*bo3!IK`I&1W&J=(>ob=G7td}K#KS&2P`nw-K~
zjFgcajZaKs==>gc+CQ>6MMl|2jD~P`>6Zg0zkujNsX5w3SzG41_vas}VQxkE@H(0>
zL+|eW=N`Hlxd+d?v@ZTg+B{glL={oo%comWYPP3j@wV}<Pln+XE5BwU$%HlL$-Hbf
zk=%}Dh}Stx{joeZ2LGLmx;ilG3T0uS1c73F#Yascr-egQKM!9_R!^z~S#f}tq;i{D
z3Il`J*mpC0OY)PNM05mnHVOQwQ|W<I-CK<==T8C>*BiK!S68;}Ch@dz)_uld!T*WX
zTkkBGP5ZgsEX(rwD{xJg;pxHkb}3Bnd%^`yLGv|{Xq$5S-`B}T%pnt!V4#EIfMtB4
zblOFIl%=9KMYyfV{5-bITM^E-vcpRvX=Kk@Xy}u(P~8QJ`#v`1@(VKM-z(J4TFXh)
z-(w_9z9PB0nR=RfX1^X=Z?ZDw`6&xO)qlk>-RqcxOiUR{{!+#7UnzuFi;x@G&4*gP
zsWUj&IpZ=`6_AN#`4@W3G?)VcpWAJD2G22c#i99tF1OpI%XNo!J5BLDqGp|3Ua<DM
zTbQ|F640JhH332{_GLY4Z!1?g<D>r)J!KP9(_W86qNbwVNuZ$L+L7Jai9}_k4}E2A
z?-#F^^)4QX%a{oI&0BT^CzY>xN4Mv_?<K=VPQKY56MZ&O4|9PGrFjG*e-aA0Ahr`#
z=M&)x=iq1-mO*UA%E%Cbp4B;ayr{2P;Uk#C|3#GhObIhHjeln5ss!7IH0ir9b;Z7;
zZLAW=&l-&k;a4Q_ELT^Bj?bYH4EkKCSP2Q+J4E<F7Z{f6<SHqOOGaD5J%pi-E<KQ%
z2FJwsw(gqr7%D7Hog>39GiIDe(6*4`{HF4&u2;6P%7-aPNOoBc<FQQEkD#mHsc>VB
z#3WQ3zjye^yWArufNaDcMcit`Y?V&C$0p66T`2ks^uM=RqsmJpOY>lA4jrMuLf{Zb
zl-N$Ns8(D^vd2;U`jF-Wz<g9ZWztYJyBK3WZ1+wpbtoR@+J46V0EYx7xP@@Y&|4Kd
zvELK9LJCAJPCf{_1;1y(5%+YVwa7_@o^dJMCx=o^9(`C8$QwBe<+^hQ+f9o?oupBL
zQn(t!!XXzzljQd_2-d*?gYeif>l&|aSZ*PolnO=Q-W_&^5dKRx7I8ic1LRkDVSBUZ
zd;8;Aaq|-hOD48T$)iKE#KfCC2pztU3V})UE&SEE*82edSClb}=gDtMS8-qx%QY3W
z62zXq98@)(S}0%ntcj51?>6w;4HqL?O;f%+RD03_46`7{;WQ}8uTNse%g#m(d8=e~
zZp{kHadMkikL}i16mtdw=R<dr8fWfz?D${QA<ySeT9iRTVGy?3LtJ)?fUuiIA6of0
z9t4`#fHxj07SR{xz-1CB|Ck|qxdS{TGa;FtWIu~qES);7@jRpbyECdL#3UR%Cw@R`
z4&NKO%rm@xnB*}`E*XnXlFoTcFB4|l?=?Ae|CF5Q`Jla<^Wh02$|YhD&S|kD0J2po
zcCQ$A=!lY?VB<Zsx$=h}dhb`9E1tG?L&aLNE$jAV`{D3I=J*X5*FI<X;C43Xv|{p$
z;z$`9rV^UoJhsG5HnM)5$J-o?a|Yd{7$ca-7lG2#2%1A`KQN2G7pK;|3f8-HOr$_i
zeZNs{J=B@6FJXvd`o33WQY+CN>N7tq^3W6Z>vlkDlUz{vKAh~rm4nz#u$0VuZWtUY
zJnIsKqrBm!G%T5sDs~a&@p@xEoJHKW$N#FWEN@>n6D$l~N-AT)cYoB)x!Q{kxHQ)C
zJ-L`!baH<+$pMC>=_>Dvm)DB6hmJ(>FTPvT+`_SdymR`nQ19`B5j*#fpi791l>hId
z7nz)Sr`0!`@KOS)o^ZQ!XU?#6_u_-XfAf%~q<})B@fTQ(YrX7qs42(Ke}g73RzpSA
zLSq~cK`IGj(#m>7b)o_bu5}ybp>{-McXJ#&bHU6t;h>LVYv|7?^?ny#;f8a&v-zZ3
z@%dCtX(?WrZGUDM*I5c{LKxHp#_zk$X0kDRWW`Mmx`zDO#X2ajXxfbRi^QzVO2Ol7
zZ5MoQj{!lHXFl;SlVAyvCym}wa46K=E^n=M1N`F406yQqZPlAvnm|Y{7C|fnb{iqe
z%V-Wcp~>S&;R%ul;J>)O&$tsG@=TejHdNi~;OV`L8$5<eqbLl^%wAHNp#rC*ms9zk
zo*wQ)Lo>~v)4G;k?Abg$zJ&$OaYBRpEN(lbZaWxApzceXXOizm1;Out4!dW~Or>(O
z{O{_PhJ!^Z3u-KpILk5AP)pKnR3l)}9y?F?XNngJNn(O(?V!nCp2?Chbt%2Bc0b)G
zs=>31)$>(odJ4>OM~&<-q$EwEA}A^-{FX_S{9ZpN2n;E}5W>h+Xh}Skxrr^<r(oV}
ziToG#qphMZ?uxB8z!?0Ti^7qN+%trAL3h07FI{xr=9tB3JmnYpXlg{5cSHA!&@1%P
zx0DNKm8J>(fcb*`HqDvdcdQ3z!SQ*Zvi_-pUu(}hsB2KyH;`{*_Yi**iPP0v0M2np
zY}jP73q;W&?Q68`qC>T7NpIyhQ?fhv^|>l?;n3IyCtTn|fs@FcYiQWQBN^FUzIbTd
z<jKg%^%un-b{>SKF;ayO`0Bb}4+M0+jTNNBLx3P46Oc{{zcyqsUalb4`0Wo|m|8Gl
zSmuLn(^tP@tEw^he=-l>FGy1C{i(}k!W&~>I-iVmQF^yF-xmrUibywjB0NINl1d>b
zxF=VhEjSNw;O2F{fWCUimWL95UEDE$TfLF!*BeD~<X3R?D6o1?d-Qgn>eLQ;@Io#g
z`laFL{<hPVw9if2QtNhWhVgxeU??tl5zM>@#vP+mV~@1(4oUz&jjr+XO7Od2XEFp_
zCo%+G*E!X_uiE6%P5aJO{6QgEBe(&E+S=#;MR^my-`vmG>nDBh!yuVQ<T9uw9KsEC
zAg-4anh6Th-xB%I7vFc8HFVsz`s{W|*5DUV+xaWBfz0IsxtJouqxE|)lCUip{CKq?
zJa#H|5@f(%y?gQWSKdk1sb9g6<wWW6{iCq^p<a@iP&x>8I~83(ZSdq0_Zp-{P`Q)R
zlRT}z*7<!E?C`;cm(jJ2AVxOdw^oKGk{Un${DSKRE5bT>HWJ9L;(6B-B60gGFn8j}
z_h}3;SvW_LFP|b=0LzTqTQo7@-gub8z~W-jhy7Ptm7ih%Hjmt(L&*7=-Tj1}20o?o
zZ-;7z&o{N_p!&9=R8LTRl7BAfeRLLgq7l86^8E&Zol#Fqj_BWZtA-4?Dnd~~8fwb6
zhZr!~j_BIAwR<;v$WRw$5RO1$jy%bR$zo6RVc=iiHPNMD2<2^lU`FvC4na~9ZRyZ~
zJ05FIL5nL=&5g^P!GeyKzI2~KxQ-wD@=fTYD$yR-H6G^Uchn3`JtJj#Tb7V~GPPNB
zM)=O!EpH*Fx;x#HRQxf-z0^6P-6)Jw@^%z|_<N{k2mAx83=GPa{X<#poIlg{{kT}C
z&;IU+#5kfdwR?L;)&(7N$9y{(;yn>g1amN$t@exS33PY#eq&80gIi%?GkS}9UPl3n
zo1li1k#eRTH;@R)+HIjBHOS;B6{}x=D4k86eAdaT3vsZT$dc^4ZRzqKc{!ukCH>&}
zEdCymw2G{v>&(N~ZDp*V?@7sSrrO0w#mj}wmO+{vdu02`D_ksUQfo>QcXzIW)9T{Q
z))tS5XpFm%H#{8Iyq@&(vZK9grHQ|pOzTbk$j-Q*!i<9wqxII!!5F@07K-in%FI0G
zxP2<w6vQ_kNB^Lep)V{kV(8<717opQ)Vi|rt9?<=?!G_q?R~v_f6&DXEE_jnbX8G`
zSR8?n<t*uF0d)wLbWUGCv9j%Jl->twEV9d%IfN(i6$hQ1C7q8!?_9+sMsD7bhh0hp
zZB-EjZLAGseSFoH1X@fEiv}F^xRno487^##8dvU0Bnn{h>w@X3xWB8B27SUa^(jj<
zm151<SZWv>BB*faAkDPplc2PAW>*&bR@5sIIorS;AREVu<Si=x+Z&Eq+cu5I)jnX;
zbv^!j{USJJ9{(Q`;QG$h$K{6B%o>)kxFJX&1f}orzjj*GvkllmZK(2Ji$P3@p%RL^
z!s~xOvxaz$i=5V04iv^2ebR#yGcg`pXuNb7vbgl2@qZ8n1)Mq&x&9P!B<;TR4A%&C
zOwjc_6@i+P-Co{4QNbqC?kaHCv4t+(nqv_#LC25_o>I{`vp3shY|J1lbFegyO2JaI
zZ#O;dt}C6zx28OaJc>k4=bj6dM>E^GN`0#}geCtkWHwq1kN=JuJ%!Tgwn7`FP=PLg
z$OCKRxk8V*iIQ>Pyg+w<wDCPV0<29D?iO{o{Ddw^{WRqYhYr^B64kEh2{6mj>}Ok(
zEK1aRA1bV?+iOyNM4bqYN&VIANliL(HwZ%c27cCOw3(<W|H_<)1VDPu`p#}v-}L8|
zN}=|zPYIQ)`&mM6yHA5>8|z(+G&91=9NKf$KUTh=!5yU2r**I#Wy}J(!!+Q0rwKHN
z#^wGAoeFaUf<>v{UgK=}UvoHPBXxpy2;SchxrvWN70WiwJ$wFKT^3Bwyl|>oxEy{I
z3F?$6znJXLOl=LzZ<`m~Bz$z{0x}XGCSC4;#fR?QJ+)dc7sGK`x1j$bX0{lIuQUnN
zhl4EO8R(}&${ajS5*p^cy#8-*SS^~ppKZp#7PQalJMi8eS5_=%i0&V+1hUGvgocEk
z#uYIY#D0w`LMe!qw;oPZ0pJw*3bk=93a7i^nh5a@fh2unizQF{TlX}suSCgL%=N~|
zj*ieeOqUw#ubV}yD(#bh_`CXBEI8$G3cYIMXuKRL{e4>V<NRQ4!KsL59%z+om!GsF
z@Y>q!P+`;$^H*FM{hz<Gwl}>oX<vHpH~AA@F&!PwuvM+qWh*?13%5Pb^&_DlI$T56
zxC+;hQNv7BEm!ib6p&e#VdxtY_Ud^Pk(M0czvLr+0CUSc+7a@EIA;GW05is%=k<8I
z`y=Qh9k%$aK!tohPHQ^<6a2Fk#PKg=MW$o0=CK!o;r7A`2jcWMmPK&sl`^XXx~TNt
zMe&gb)H<;&0|It2?9@x|mq8grXVnc#N=DQ}kkeokpNy6|r7f;V3mf`@Upf?q7zsy^
z)**h3{Hn#Bu_sd=wO`;M#{{lm5AreX67|`+M+}b}kG$z<^pp&lX$;sl_?NcIN&oaJ
zUXDKed&k)LOKl8Jjo{ied)+BCG!oPs9H%;(Ti$BE`G&NMt<wL!ECH4o)l9yO6S3_5
z%+Gd|E~ZG;PAQYGXo_e8W;kcg&bvAwPTZ#7B&EP`d!ZjNEoGI>(;R+K0hRJkanqZ>
zTq3>%Gd?C{q$`?W6S*xtF)lP$2dj~WhN%v3FI}+76=Pr&ZsX&q&3@>cE)T(7;pBRF
zeir8HlMJ#-_x|8Hk|&YN353*8a<)a!dSnpq3x|JsdR5AHA?exP@yEOeoZ~Ep?!+@&
zz5A>jCeKdHmjFg7b%KJ!GRAzc3(?pIcc=LBf*!VFIy@Z_cVllNmTwF?#k)IdfuE`>
zFGK`}azb)(^5xtp;9?Sg?=R(L5U)YPeJVam(*x$PUXNB+pY6>3%uvFc8E|^s#Hk+B
zL_I!b>g&`xxL1e|)&+eB0VN1hMg;vP7f}44g3q$5!RG9|Bm|%_9u~MDI*&tdq9>eO
zu2^p2JdtFv=EUge&q&Dz1f)bFT$c}LA<+%{%pblXW#E%zOH&tYcw(5;R^cSSU%zs?
z4<a?oSD-GKo;xmaDUFXtW||kk4hjJ_gH#chwMMhb3%|cH97_Dp6$zx+Ev|j`e1KxE
zb6op-NzWo}6e4Pb?9xl#Z<1JT9R!R$A=V2UPKbWZF*@OrMx5FA%Nq$;Gm>*qZdrqi
zTvS+_N@i9|eO(b>>e(qUeX6ZN^KY(AQn?@=85x=S*oaHxzhO*d)YOs_v)1+v{%LGd
zh>%?5i;X>u^lvLwGhSt-{QLA>+1WV!M@LXV*sNWbgJZSL{OAW|<vGrWKztzibbFBP
z7wZvDYoiC{^IC<YopfjfIvjDCp61&y4i|lay6qkuaDJWSlWp`cid_nTCY}HMzWtJO
zJ1O{vd{(3EXjE3ythUK9@oUT)?)tZ<=SUe5l`nFJNYA8|TIn78#W3EUw%(Z&0%Pc4
zAw*z3kr}jOtVuDGnPBq!=D1&4;wlC7a3RRW3WCDGI$TWJ$RVk}xfffa1Xq#6o4YL(
zkG}zM8$5OpD>T|H8AR=+y~F+~qHXA<h_~Y^rMjBxm-^ohO13g#4ok2UyvfyoBg5xa
z{tUS^vM!Wipdzip=*kyH+;nZ#R6CgU*voR1ZV&vBFk1};HZ%~wyjWk~CRq|QhJeZ1
zARX*_Se3kV200a&q5L`9*V(SvR1Qqpzqf^xscjSaEUzsJ2RL%3rl)?ImSpa-vdS<Z
z)w!w3V<qa1Ut{_b#A*C46y$zM8AF-k=Q)A1Fv5*n@;3Q(J`<0oPN{*1E^P1UOSo+6
z&bk~%1UyZCz8!o%fZi1|n8&~fZ`6O}fG{iw7!)kuz6y`+UoP@X^SYi#aDCe`haSJ>
z%qPv}r{$w*f*Nmd?bv;Q_!o2{*BKO@^+rCKqD<*yPlocMeegldcDMA?<+2aL|L)%9
zj+!@1K(N$wII2e#ey$l_bH~4NOE?i183tpc#xxRUA=avN0BvQN(hM=*k+0_gM0?ID
z_!HlbHv0N8O0*5S=or%+9v_GIPsj$j*`Gr+`sJiZ)NVp%n`3|IM2-|)<3t`DlI}h~
zP$uQK4`d`sW7388fElnJ@kfZ&%xSHzc~TDOT$3!8SP<c9$ea1~bo7imnZxyr^p$kf
zF!Ej~REI`Ds@`vuG*6+YoM{H;>IDb&ArUAs)><RCaA>+H{r_RELSlGkE5gh6XTRdn
zOiJ61ONB`7{i9yu-Ku<{0k*ZSgp}4@wQDc5JT(DIN(Xl9;wH=<+UTp4G$CIzWRSqY
zWj;~o&_f@|ajkMSMhgZy5@1C~PyQ48X#AjT)5;<&C|w2#u01_F{Jn945M@Za+R!)b
zJ0q}^mUQ#W^|kqzf^Tmnuqhmw^4^tENZ#EwG%%xJo2^@YqH@w-Y_gK)V1PT@ez-F0
ztu~gV)ZpXAFASyry>Fkc2vcBof8%kr<GNld_hM({EX5Ee!=a5zd;&~lYq^9F?+yBW
zXZjSAF8j0394;S@j05f>B!3Wrp#d;syWB-&NAASl;EC4=2}-xozBCVMAP1?if2>Z1
zV+&J}_b8xsee;i#E3<@wQaCUmh<tv^#wa0_bJ}f92lQ}F1^#^j`jpZdC_&}SQsMC_
z;Jugld{x&0PP0x2uk6kzjpDThgidzmXU=ZMBHC!5T1xF&XSVf+^4&QB(r$?fdD;ZB
zrq!jHOz%9L*;X34m(Pvim|?hIRF!*Q#+i%h7WidhYgAbsok!+dcog+w5{2vSgVl64
z??tbZE$r9Zv6uFXzbDxG`X<RLhfo5H0&~3w6N`-!o`dzo<d|NUx=inr%yy3-C?B6j
zV&w=*W{2M#Sn!k!qUg>^Iz%66d>cw7sSW9=HNznzpz$G<VRLY)HT4eoCZ`R9C${yU
z$HYO3rD=-W^9l-lRNFaZzgE8NJ}05Vm7$eulzn${Z*=YX#DiEs-i}HhSwvJ2OBMmk
zVNj{hYC{EB2chKvzkZZlgd9%dljN&>Xi#oB*gMIepAVcQS>IC~?kDh02d~+G7>{O4
zwQ$W3eVVnf?~ohdJY|5r8F<cL!PLgf%H*!hRC>EY@!5r?;w~VdyCE*LcjenSN;^6Y
zA_1LJ?{!;@gNdHHo;6xyn5y3|@-7#+3UA~=ZjUY#q)%}8zxXTC8~Rd3Z@x`8FhAj#
ztv~;e$RTB`sKwsAY3EjrcNbF7IAb0h{I@dOdxTs1g0|6xa{;`*R+R9JUk0o!xK;Uc
z=!s3bj~mic6WIhWy=u)1+)6;Yj7r0bX*`&`*_bSJ@~mmJ8A=w!$Yr)x9|+4FzKqf<
zk+7(a{fuV#h=Iv~pBnn4n#Ez<)7&bIp@#XUPZY=nNcnHIfH3Q`D!W(&wiSthT#RbH
zwoQha%uaVyLO;bep&)-r4Ip??&f}!4so2_B776EM3N8gHjlFSgD=1kp%Nh&iwExmk
zlSdG<WrB%AkY2h%048e7{d%;d-AJc95z+9WcXo~M=}YJOz%)(oMe@i!SE#qB`rQm<
z9Gx0pja!7Ubm)w&enM(y#$>$Xss|H`L+rMuHUk|i0Tx?*u+(%+0UTrB-dKNdWDgdb
zm7gQdT6`*MhB`AcTIGta4c6vWWd{A7AFnc8ZDehet86MvS9GvedD~g<BI@+4hB-!^
zt<H^4x#2uQqHZdp&Q6jifUOpB8&A@E|G*91x~n2g!>Pwu!gzL9B496yMS_*FLI(a}
zbpVv&o*UQXKQ@j~>1vQ^;&L0DYvD`{ESs#`0*h#lijsX@dc*$yig>>*zrRu};wB*x
z!sPKpD4bQDbKLi~f5T4gk#<#)Kd6=KtB-`FH;sRFZPHi+b2;r+lL`WG4;%s%fK+xs
zO`Slsgmj1s!zIPmU&^8@!xQq;*RMK^y2^klDT@7~dn+Bz##WGp>OCTH21GQr--?wK
zO6r?_u1hlm!@I{Fl*-E8)y9y5)bq?Q1l(y#75mX;y$BufDHRX+s4#Eyr_+~>sLS^%
zpDQTuw11-8>EfllNbJ!NP4v#c0pm&&Nz*K>+=#S?12+9aW~65V^r|y1J5s2qmUb_A
zjF%*oM%M&7nyn@AAQ|$T2zm+F=pX79d39CWDm)Yk3BLKzni)0a#N^&{r<Z#s6uFT|
z$Kl@D*N_D-2d6-)eo7#AWt;dd9v+0!TFquzz7js`YkGx?&+OObZ>Piemh<j7S{gpp
zBckqQRZC<dfm5XpK!Zq;H;9=mM`#(uP{YxI`AEj}$S3g4Ri#2v?shFY?<2QIQuEub
zWd{cMxTy4Z*$Mrx2t-1G$LQG!0j4=Trlu{~UYcfbYO{u5D~hwwYrBd%XQ>HIn>X;o
zgYPt;+|e!Vm9L+Gk4NtsXg_C#Tj8&3P{RUGDB(SQy-&vk4L>lYA>cw1@&HQi{(XS(
za`+J7{d^=Q@po}$^y}dv%Z;PGv4}^Ho#bO@$P`0yaQMU(yc<B@B}J&#rLG(kbs!?#
z09@zs_%=}&zmk-}uUo5e;}kQ=AJEn0DIJq4RSHRrURSlD#X-ZB8`f4$VEhxPLBKir
zoYZQ9zn-@CnOnqh{4$~a1|V@b6{(=3W7{7+x#LNla($h^DPL*-D)4K;9-Rh8U_6K5
z*h*8q%_!B?L$0Vq*VZzVsh>;s9#&L*3*X32FxL9zXFw{F&*(~GJ3m*MZB<a1Ve05-
zZLx1My@+E121-UsB(CM4CIj`!RNG7`n}JPOW|y8pM2^e~cMG@oIR{3-xjhd>0y3AK
zw{B9u@L5xsFoU2_nN|Nxq@3F2-H<Dt5g6RxQyNZ$c?oZtB_p%`twgnE|KM0w_mxnR
zk-yfc8bLE8hggb{UzP~j4bjcRTm~{`!|5iS60lft1|IWLYwniQ^#O)LRAN!{6a%hx
zMw$)<fYYjqLUBUtwf(7T&9E{wY>CxhIAH(iwow10)J0v?{bO>glN@A6$5Hf^aW<~L
z2aFy}Z1n;(9u*h2hMzkKi14nJmEm)`AT1*;W$N|*Esw&ZWgE1DO;r5ZWhvfZqLh0?
z1UdxoYx51yGkN3@<X>3_MoPZ;WX2!Tj;KpZdV2Ex#m4j6>dK3Xwxd-@Rp`I!yX?;E
zunDgPAiI1<|57Hc(bnG!!sl-zJXZBWzyYjv780;-GU3;;!PleG<)@K$u?m;{PQ=o2
z3fq;ubxJ4q4}->~Uf-~fz(wK0*wLR}t3eOeF+!m>s9BQJb-xcb8#<9Gt7~c2XYe4a
z?IE4`F18$5Z9pF6Vbm<TxoY&LlR{#KQnVEbSr<{SoW6$w=^%3T?(ZI_vD9gi77Wfk
zBfW>xKlK8l@Z10T=U#(X6BGRF{%}dbOT<iUB_?_^ZF)0pH7SPKE(JaDF&TA~=5Y84
zSQy6(YQsy@X78><QL?hBV4!m-qM6lw^>HFSpdzJBCF$Qo-I()?dlQwcq8wLyq^p<N
z2+M@9uxON3f`!V`Sts~MJK8%{X5G6?(n0Cd+KU6ViCwWn#oo7m?#It~6W+PBIkBoN
zlj%#Iosy=g(xFgd$&igVeybhd4i9CNre~;2hxRTSea3y4KTS-Ev^fmSN+!Tc(doF%
z)95$wD@eL<gGj-Zv9#zzPMHAqzNIeBu4U><Qx^eEP;h!N|8WoV7U)x!6n^Pw#&3yX
zphN)?G2%cUF)rPwy<Fi;;|yF?l5&E#N6_HRiXn~J49L?{zT~)0zUU7acS5N}WsA9x
zff!(*!$+p9JRJ`IGF~dQ_8}29@C}leZWS9ngCc>3ZFHUsPdy_wAN(+L7M(?8|L5?$
zNS5fLyQ1~;rf{Ho3xbO&*Pn~9l18nG0>AGweF85+XQHyZ6)u%g=K>ZgO2v~SqNHE%
zL1QQME>3|C1&pXTjQ5vo<VBY9Up{wANtXg=sR1moE&cH%2hGuG6yp}YxmmZ6f~v6T
z3SjpBi>Du-w4JQ9oRprcl$ww5(W2n=oMGJJ(P%Ftkyx2YP4H=YzZ8q{g0rP81i2Hr
z%YSER>|gm*P9*8)F5K@A_%y_n+3TgCNzXHJvWoBR{Q=mD@0wi-cnyDO`n%^W(k?DP
zz)Esmw}B~93<$N-dh24Q>?rJ;ftv#IfL)$P&UB!g!hBsF$^x946s+f{`_CN*<Ha;G
zFS8YQG%dVc7(pM)IyyI?<SOw>{~k_*Bn=Qk((+{9cwulSCjE3_+56lu2xC<+#v1q3
zuCETTPpc|7)NXEc+fC|+fk!WT`=X=sd0sP$>Uj5fBB)gM67KV1e&h5!Qf2)~KpyN}
z=4^K&yKj<%6`+|RSnm>^bN8y%mTMeja>Z9YY^xT-Fi+2LB!}n?dVR`qCF(R~&Bjwi
zaFf}hcmJOVgy%h2wZjf-!PTi_+`MPHgI*#W+6$^2wdgkk<Sz~`V37$yydp~k)LD6?
z4bO^JR#O?^g)1zDM|kK%z%hwrIj}fPnLmlZzOp|lDIt8IXZWW*bvNf@YxUpZWbEg#
zu^ys^<7W~dVf^z;w!QYVZxCh<({A-Xt6_3<{rW-|f{2ZSodg*ven+o!sc_Rz=$Y=f
z2zSMma4^Qab0d=p;6)rvq1V`ottZ-rvJ|$wiemVBh@4nu7LHpPv6%N~ag%u~l+>Tn
zA592H?&HLUJ~jLw4=7jq=-LdSJV8k+BUi`~tvPgC>rs^U&t-2%f+T<7OLuWYig=-N
zZV1+i1l5F}0i9#80Roqom44SdT<n<(Ooh=zuIA|TDL@SPulgb$0VI66h2z*Cf=#Ob
z5qCHClH731;zz$au(`IAo*va4dC_`A@diW_qf9g>vP6UE=4ij}DK^}(KLqp6h~HjE
z1N7ahHomph3{2P+5IQ#@=9#h*6|}Z;bA`!yLPph^=j+yG?t~*X)%+g`@CE{zX#6lr
zuW*5#%bvcchH9p!4>s(tfqktm-llf5hid!_{FlWqk|jsl&aQtmu~5iGRwhjSY7LZ<
z1%Kid9FcxCaI=ISfRsL_&MJnbR}Nb9I})J2AxB<Hq=mmA<4dCr!S_(X4}&$<A=tyY
zqEIT3yndWZ-u^g{?3mPq&rrY@O^YCj+>1dj8--ssex#5JWZA=l2cyh!-el!4?w=)`
z-)K<oM7f#L=kf3PJcveG_{j^C8PHFwEO+#A3*5D7KKxaX%aHuKZ?JA^9G0Sbb-CC3
z<GhrzQvV%~XKBnuuce6uSJm0y@yxarl>*jup9csvmhJsGYSvcT0}^X4H=I6ZjRX85
z-N>&XTQ1(MKEm5>Qn-$2=`%;i-Lw;;blvkgOLRp!zMva|7zb0Lq5v0EQ4MB`i9dFJ
zBOR_jzigtt_C9^DWSzsHM!QEiHUY<s^_=`U_W2Q{y&x1Er?@~@AcKHCE-GA^!FIIN
z<0QZU=jPkiJLfjlVhMR?%V696((C75)|zJhzDseO#(_O@eP#zPTv`&++G@Ip-=FQY
ztT`{G_C1O11@tirZkg-jetWLvtiDE}W!U_8wTT@v-W1vpS`QVxFk#G4f>DZF=Fxk>
zRmZJwKwNjf+l#8cu|B~tyRg%2ubzH0U|aFe*&>?AzD8#l9sBDaMXACREgcI>8CXqR
z|C%iRJk0?-Dd(3Oki92@Urd=z$00BB*;CN}+Z!dN7qBrPtZh}otBRR`drGD-%O6=b
z-TL&-x91M49bRI7(8m*Aeaf@|rGGZP#m&gdf<c!PC>*_&f|eTLFwyJ&t=>8TGSjBz
z8rArC{;=0UV>oKvauZZq?zO;aK8t8dH1Hn-KcD<JLU29z^e1k?WJ|Q6QGc#UcwRx1
zQ&!91*4%tF`W3w5uftt|^o(>^`wZ_73l`ch^#k-xg+N{dK50J+<9F4zdr5l!Vo@r1
zTyM3N$vY#)$qY8H?)`nB0r+v=W(aPOR01Z^^T6C{<3*tgGyk5Ey{ku~`Sxho5|{Oq
z@x!rWQz<t(sPqT4&VM%v8~Y&^Mq5kdiber|W#bP&-87n1%+fKA1;ZqfBx036v+T7n
zm~A61z`H5<JXK0Fyh+;qd!Diul67QsCK{zX4<8zFnZu5rQ+s_1en=h(*sQ}=_js5L
zahs^>ZD`KTcQfw)rit`dnF#n)b<vzr=pd497!KRGfg0vTXTNQ`8A3)6(RI3J^RN#W
zS~u!YQ<cgT-)}8t$~)WS-tP;Q&eL@F10LQBwfu?4&LPURU9YsZ(X@k38?<x#MtcP3
zvQ~ZeWaB?GM4Z~bn$B09NmKp35dVJ4&o(^O6UV7_-Xz$Jd2h&Ta`@oj+g~zi8z`0c
z!q${n+L@pl1{%MBJ|X+N?I|DiRw_Go-b}v)K(s2pU`&V0D(flOnv3!-QSg-y4?P10
zlMbj*t#fXx&+>3BjNTzcY?bgKGr-|+f(X=Rr}#ZuDlL@LimH--_;t?kV~sTmO@{>K
zSkW?TZ(i81Ks5oTT>F^nx*^kJn$Fm|LpS|ut4e!+E<nY;kCKU>^<vP)cRA2eSl@3X
z1MiC8-1WwezRfa;Kl*)1_1@>2jktsCq(e3$=)n!g<GGa5*?8jX{+^#uKz(QC$l)Qg
zpD^B0o{*&G_#sDIgR(O31-<oZgvp=K)Fjz*l8%`{4Cp0Rf=!OV-6^wu(CaAgJMaUg
z{#r-k=@wD@{R|%Rgz3gH-xEpa(vK6#CqmM9HNCBV(g=JRWiO@0<WIL(FoRgX3^2?v
zk`FGkoLCLT#y=OO5c|6%=f^8;&dVcCB^8$4a6cI;(VycoUkx#ecVY4C9I2XK$~xO)
z=02w9@ghz(6LCQd?kOI!QW_macY0gxK#KiB3NM1+TD>|^>?aWk+37wQmW<J3J5nsq
zpe?W+Cyc;_#~j?={-rKbi>YNwK~H?Wbs^*-LN1gmqF$afTe#(ZxZjyni{Y&%yEs3%
zF@=$ClF6?xsHLZ`HtD|DtUoA&T5B?aOWE|j#*f_uEMv)b__skwtsmCOhwO?D_tW~G
z4JcUX`}oOd_|&V7S|2_%k`_K6Ng_g-*5tOnFCA7?P}J-HOF)B|o&Jl@TzFDY(kG$t
zbiX?;L|Z1Fs}BZ0j+xm;@NoBWK<hzv0!5=3ts-SzLmI2Y8FMvGwm0Gs;q%h7S+7mn
znBH4Dnei6gTIXDCEO#uM8$h=$Lv@E6Q;q0?*FgpW`KQYO1<|KJcO7n5>u%5dg$tb>
z$rWg{FLdNjlY0(pewcI_jB~mpw<Ble4Q=p87z7xfH<q<$j_<B+9~mVe)9TBub{WV?
z*FXF(`IsDx%z=<209vPPy+akqEtrlszFd)hE1NRBR)Ku8a^v=4rF}Ju#Eu3r+A>w$
zZg=H!d8VwQGox+g#aB6qp(*{;_1!{^i%pQ&M0V5aRWBF58g3jT<DPiOEKy}k!<5{@
z{*jP3)@tF#l+Qai*V3AnvVzoM{Lrwn9Kyip&a#>+Tv#*5^s24q;(9k@TrLpn``YQ$
zxY-qqvTrXuy%u}Cvh53n>%|HpEsb~yeD|u;0DsS?8`9U6MLXQ2J3k<{G(aozghr#t
zfZ2O_F&K0T?H<t7@ct$z87FHG<66hvYK_LeX`;TbLfES_*m{gokSlcy{6xUg-ztq-
zsW0fYh_a?2uR<|h$TK0)L<KRF%U?U@F@>W#qWUwoN)?zpv#dNEh%EH*0;=Z=c&9Bx
z?ecXZqCDVnOT+!P13_`@<4qpKe;?eFpW){^@>2HUy5}1b0e+l~n=R6v?!tDksXYu=
z`gy%ht?S+Oq{G^x3tK06suHWEzVMI4etayq&0d_3B4mgn!ybtnF0-pPH<gK7BUo31
zHMHbt-f-AG!;xd>)fg|=vb^%m|H%LP)uk#aI@%%SR~9`!NzpXo#sx7Q9p2;PNc#*=
ztf>W;x#_>go!m0i@56w&$nhT-2R~F>DDB&SjhPM|5ep^&wo?j%G4JuuS#&+utd_gF
z7ib#2pycP1eZwml0Y7K7-BBvVJU0*sz9<t19k}6K<mXFBGrEk!@`{7Yb71B>iKWi)
zM|_;+9<!CusmQHf$Ell#)w4{s`oicNoKtD9{p;LzDQ|mB!mqzL7?x6pIh_7Hmvv23
zV0R|xF|CLq>g*Lb&@)+)KOQFgzv`IV-fIg2KlA!RudP>J;*)j$>J}@0UW>Xacbdu}
z$2gtdokMbSu(!wn+vv*_;C_j<5xTXSEaCp*BI^|&-*tMi$AMDcKr-fS@iSedcUC$$
z`1`uE9}9!&>YxqpZZ2h5-qBsX<&S7vf!7Z7=$)|iRH?qP%<-Cb6BRG3T`~BMm@>5J
z7^c{fS)@9bU_Auaz2ld7TcwG7HEU9&7%gSycgU=pBAcBAVPetFY@_?3Xm8J;O8n1!
z8z>>j_oU|%W!1lUzW|st4K*ozbb=0ksRZ45m2+c#`YQ*nv84&IzWG2|Tk%6@r|+U)
zc?CTEc|p6ATE1sxI;XXoM$<^$**UyWWpy_3#)_JuMpO{Dx{j8I()Qe{oYcdYH)5~$
ze1!=-)Ziwm!T7Dj<BF8>`R1<SprOk>u>APmC2m1K{3`gZvbZJOod-+d=+>?aR^q+)
zNOiIzJxC+*i?WHp5H?fyj!UVo{<tf3aW}w{HanywG8LceZDDE@*2htS#2?z;K6?gP
z8QR)<W`p98Q~5<uCRHxq_g0rQb+REV2mCn9G6&P(U?q_L%$%W;td6_>=BoAxMSLkS
zN#dJpVHSoATfOv0yH5;=;VLI2n;u=7_}j>&8=d}0utN@yyMW*KGnoKMoM*zRz$T`U
zcq@ugf_k!hHr*e6+60JfT03$W(YUPYFE3oVjA@ORoi8pdEFMAuC1pwPj}DoAL{fU`
zC+<x8Jv2~{SrwzDxZqaHN6)4hk^DY7TrA^<2C(d4>8V~Pb1#V3pOc4mP&4#4;<Fkb
zk(}(?bsI!!C&IcTC#g1v{LH9D_@m2*CLd#N>tPFco(ZZvxmU$-j@YV2KlVaPU@B&(
zw=+@x^*E#b;Tdj1VYvK+S#P9|z9JGhQf@Uk6AgLysr@cQ(j4k&li5(;fMzGc;xVUf
zrvH^=jLlgIR;r4X!}m%G+3Q@L)1TuMInY1_Iv6D+$nBru@Cos&^QH`Qb9k!_?)Yls
zp=%nD6}7fv)-CqzdkIru>(^E6{@&5?w>fFv?ker$pTCEEa3XvrVPRnC1?cU}V<z2b
z+)<(uQ}B@B7$Zg?VZgVrkCl98rp2knfcrV9?*|A4bVq${-<tfjfZk7jccygYtrw+l
zCi$aD7#HwL#`+N|+J|R|k7i#WC0I1I-Zz_PA}pS|c&}nn3Xb%9C(u+{jj6``^<Zfs
z%6d>*Z=2a0mvahX9W}fOJ~w0iJHSp+yzW6t=qDb+>dt_<7P6F$`x^%%R2K(9pAC21
z>KXtX0Rmlu$?3+n4wq*D6zz9{(#~fEU$Iwe4$%cVZ;IXc7ZD1fHN6NQp2XmV_A;m{
zyt>+8{s;oVBKy`Rg1WRCg-N4i|CIOg^bJ!FKtb~D+pkkM1BWXdV`b%j{BF11>8Y9y
zNRY*otXn?jH?p!@xe~K#26x;Qy2vbcU9V4%3c{b%1q7DsYvUFc9COv*_k;P2m-!bK
z2rB0fI%m{d`~>2;cE2V~PcxS}6dqwfUxmrlE6428qI22Lm$KwlAnDk;7_xkaUww}l
ztYN3gMj8piNQT!UMvtMUuGDGcwojE%CHC22eivSrG@Ai>JSBp!ifKy5ORaLttinHA
z89HSLsoXa(+RqVl{kyTnB$!;2w<>wkxAi=YKdvORzI~=xuc&Y`rpB``l4_BgtrrgU
z$DOU8rf6~t>l$VA4^?4<bxySY-WBLlB_|8aXpB_Tw-T%%y|#%4`ueyLirAl4+fjd4
z1U6~oA^M?)W~=N_$q{5lC(dqVHIkVR!Mcz$P^KwF20?-TyIbZq-JysvkYAlozKu60
zI54lG`#0K&gqj6Uz%18|g(=v<Uiybo8HZA~uUS*c=oF$%%z5k&!Cul0$zGv}^{`(i
z-6O+{Rz5l(c5~^mFg_sD#Ezt4;%ICqx~Q-iK^nj1e2%gMYmk9B9Kdsv8-piu)=KM+
z3&9eGnd5y@St%)~2(nwpORf0%b?$CqV+U4ahvT{J_W>&;lF|lrDlT5^405z++71z6
zYdz}%3;fbXN`IVPkl=om*x2}M%?I6l@6&NsN@FdG6*JU_=Y~~2;6h_ZFU>Q3o4lk^
zGmNlC{pCl}60n9z_LF8H5)&30kqxgx7jc*u_Bn<^YK*pOq#oHEbZLLA4?3d<OE=hj
zHn7^6S-fWJD-(t@Z27C%i#rP=H4~}oCeh$af>%ql77LY;B;lVijM8)p1PfB(yE$c~
z#8S)dX6~!WvgNeTE-rd^GnKX^AB0WAN3ymGba1R}-`?R<qX04fME}Mf7&JrHz?kAs
zSYqD&IVL3AQUHoLMHw#^LpJz2rjg{Vu6Pat6^T-mSfQn+2$c%ZwD#Ue=&$uq#Ej?}
zewRjX)?+}0GJCG%_zkjzHKVcUOoW)XUgOXRHB0uFLp>4@>KM7zcKKgBP6IOD+D6I%
z!@*wG8^jlKtY=P~<?&c9ZG}gH{Uqnw1KCZcFls`b(V9~zfU}%6;MQ62mrYLB>5?Wl
z+86Da4{HkFs}o+Qb=tipC3?E2Ji8o5*f?$)ErWGhhZ^fAK_K1rsl28fqU^E~u$vZQ
z0k-^lJghyycBByxW)Pt$=UVH9M*{9Nh%!2&$%;bqXBlXm`INhx4VIk~i9E|xOeAAp
zl#J2@-;~0?V|c?o(!lp;p?G?F&Svaki|e}JfYh}vBK6DHviTk7C7qE+Qy=~s*5Z=i
z5oK`<H$nLb^L^&U-p^3N`HXs8`~t05b6r$zkF+I!M_<ejGVzldEhBtvO{SzGyxJCv
zP0q~2?=~(y;$dVa8jf8H$|gY;f(CE{aRcr>i_mCa$`x_s9M}gOXu9u(kKo1~Hn=l1
zO3d$SG+28lraWI+R+Ywzitp`WNty#clYO8(WB@WsRdop3o!t_<(M>IsCNRy1+(TxD
zk1iXWUMMM-Zg62N1=3k&hOsF43EW*0p4pihp3D-tt~>&Om6JJt-cQQCAHkKV`zrov
zVUxM<gtN4SUvu>Hquw>9`1{aJ`ovd?c7af7dMO{;IeUj%%cIP9{|N5<$jHW2YV{Zd
zK5Nyk!KKy`@T6ga-w#<Ht<Kn^NL!kJXFnlYXwFrc!Ob!qf1Hi+DV5wGu2Gq8Z#+MS
zO1^-Y6y<mgGZUraf?|)KFcLA;dp~_BYkV|jwB*GXBtHG@aoyqiEG_867Vg~H1Qbth
zo@rH&>r(t=<c0Fg%oRp<uR@(+e24TU40DtPT;ElR7^5?|<DvTTK_kkR?W-`GK;Im9
za&ytzLc}>S#?^o$F3#Wuh<}2L&}L@+B0L4Cs%%m6>)jbox<Y8>-C<ZHhBwZB={j>h
zrSepSQ8MuG^%(o!<DuIIpJidCE26T6!-A97%LH{>6CNMqzB|%}G2c(o>M$hfX6|BU
zuUOGo4|aG#?sjloz(uTa56k&O3tCL^xqpZ4pM<F5?JjO@<wMpZmKzWuJL{W7Mq$tE
z%UrcU^nO^uWo{v}$<fxde>A$rhi%F4QhsxnJ2=jIF3@eT7^S>~?{}~m3q!v))z^0|
zje&X;weqY~%Jd<1RBf}eym`5|TPgTfJY*2oc5=^4WMA=l86sm_&10?e<>6G+z67pB
z<Y)GCqVJ|hjWlf#jbSX2iA2xy1N9_{HMO-JG;N+8-wBdunN(jw!K?!YRhT;>!ol&l
z_=!9DJR<z=uh|HN+lT%#2pMzLIj5a}U%YaOHyjk?9Mg|PEen*^D%^29r9)ILai&#L
zVx}&eR7o?mBjq+Xin{7;S~QWRzczbA9-_cK#W2Nh4`DX)_-X^i;h#ZM9FB4vVJi>f
zM9GHZEAD(O4Q#AKo62SF(Bwk06Bep+AH(lv2#<q{-(P25B223-2zra=m1Hb6+86Xc
z0FXg%zCMgh$ZM7<+7c3JX6;1NT96UvYSIK%Uco$yd_K3IJsa=f{+$m}Syq89?L`?U
z)3k`iuDbuHj!6hXV|61=hqIvCe<@Yme{3weEZz4^)8g#eZW<dZaJviG^h&6!ti$W}
z5l_X48Uv)QIOXmp0*-2&nioyz2sDIH4l#i;$_|H4YfCj-x3p1FQKCG4OZdSGkvm8J
zaW3YNQ~$AC9YwEU@O6~uA&@=4oqeQ%1Ypf|oFXB3ZDF}W08Ze)0{<K3s$Lf4l8DAf
zlN^1ao0q<Gi3^7ZiHxQ|s@=U-Sc8pahY%pLV~C6<+4t?s9QsiwE4Nhf$WO0l_d~4&
zf^L;>uyi8e2L1=i1MpG6T;Q&turtpyRMUdKQAxlpaL)Ypm^#KY8_}9a(N_)S&s!Fd
zPQaN1f>W<(BqHD|f!pq|*|<j;!&Cbt@o_<T2pU!|<RVNNxSdfCa~x7imenZ*Wn~)u
zQZUwj5W8;}%~P2TCxjGP(0qzKpyw}D)C4k`#{9-0=8qE#(kQTOh-EC2(#Q@`lGcI@
zxz=L{|D2aawf+^f)ve-@y^pbR#Re6dU!*XP5Q22tAeG9Ho1DCQ4@cJ=RF%~fl>IM&
zWGcgzj={<CE)_xuhK45?92%#kxq9JJyhus|LHr&+@nj5yAY(@vOrB*#w4)0*x^O5G
zAapcz1P&T1TeyAaU94W&xTq?G*=r)mWHOj${#gGaj~+smPCt)o4%EvO4`2=pHN0~e
z{t!x;bUUyfRXJ3HQfkc+01IXOdw@%*HpRz*3qW+{@ry*@wSh$wfGJ-jH!92j_fWgk
zB_n6}hX-OD_)!NheDflgPK>CUbWIf8{Y=WM`<=;r03pyP>jAI+G-dWZ_LTQcj%gv|
z*1=5MoPBkGOUH+K;r4dk@G~3OdRG%3uVXo?2VB{;4g>!H$ZL=Qf%@?-_*zRTCl%`Q
zA(DiFFf>-qaAyjM4Er&@yA|!{UO<$lrr-4hjPwbPJS*rrFR*Q>ZI$eJK+?EUf~LCS
zg=%4-6S~d|)@+x!JS^_+nH`(ZCAG~q7mjEQb&M0~JVIGDAT<>x(EZtpgb+BZR2acA
zMZ-YTu`k9jo*2SBm;~$Et>Xk>m=Mlnh}nt&Si;SybLG6o-<CE3PYJhgx{G^v+)t>q
ze9^o9sYoQ#q|=7Vudq@Wc4~484qYc$QXp>^f^ay_#6)6QjDHTMY0=*wrn#wV;UALV
zb$clFmoXR~$nNjem@H{v$;_1Bzm41JVaK}NJh<y2YAb7&yz9TZCNMZOPC8@G?o_z=
zqvpzje--El&Hz6Gz6)F=OS7+Kc=H(k5|rM^+fe;iR-&4*EnK-v75tt7UPQG!KS(xN
zak)GdMO<GjiU3TxxDFIM{R5Um!#^9dpBPKA?|YZ|(GzFrI6a1C*l4;~P&>_>0hdyu
zX&O#Vqr~IE?{-n<^%C@Y@VQ+CeO@YjJ{+2^L|CM9)!RrSsT8BJIMHO9(RiFlDn%rj
zB54>{wmnG(=DhI<)jHQq+Z=tin{$T-*!#v6JpSP=G_4AOTyj{zkLn{Zjw%(LFFxpG
zipy>x*TBeFq!LEnJApuX<%h;4evhD{WQHlzB-VvmjORAsdh=1xR0h0dK>KmQ(I0C}
zjDX7n8@5Zf+->78CtEtGa`{@<NiLlb^mhm@92VSmhg?!^I#Lmhl5&WQ2`(Jf*!8fD
z5H{E;^)N;udHHIoqHuxJ4@MQn(M=dn`H_95+W9Z!7AYWY2u6(*8EFE7h+a=hE6Y0(
zi9{e+)v%UF_ddqjwsq*5wrp~|V`DLuq=z73jbhj-Kp>^W>2%|Ddkb1$As{>+!!VY&
zQJs{kTEVjH1&8w_5?y!T^Z2jIQ_i>;%H=PqD6QsAcfOVF>$l@{EMJ#HRc4vu@|D54
zkGZr{xlpClEhriF-voXD{0FLKumQ7)Kpw+igEIQ>2KJzcz@ny%sxZ1I`}lR>72qq`
zarNfjSo8|qx+s_cO!-1-C|3HvSO(*-X@Ydh<nWKX`0nRUaqhq%Mp~)RUCYg%Gu}cI
z_+2il0)AR5LbO#@P*+w;O|XO#j|aEYfm7FTXxfyW{nX=3Kc;Efq)n4##$YHKqholK
z_Ms8FCMFn(Cx}L4NSM_CWD;2-kcyc+_vQ1n9~<Hwzp|A(-?##|*E#PldjTj%g#mg|
z?!mc8fRn2(yanmIs?bXQIT_g4NGw~>J1X(H1zy*Tdz%FF<+bRoBk0?@h>pOqA8TAZ
zt`hsoYhe3*HY;wEXbz@_3T&ufDQVpxxo}i)_&E)U&AOcur-#MKp-2c;z?yB6L(d4#
z9u$OX1go}Q6@AKGFZFK=NMd(6FuotcJmvtyDomPKLNYBGF_T!>n8HugQAa)|Bc;US
z@^a6%`?+_={gefQ%d+dwA(Jua$hzunEFzgcB=%&Mx>I-H&<pESCncnknQOTJ^Lx$a
zOUe@h(rKe$5gttloDL`Rg;mN+LcH&h53qj4`pHegazF^MEQ?d8yBHkIme0<0=)44F
zQD^~v31!H?41A0k?Zs!n2fP_Y9QLyOGVrA+Y4?YKv%t4djm}On2RSL?=A$42Fy%`n
zQ1$(PMu8$TGm#VQ>1rS2TmO85ec!o6GGbiQ@aJ~=x)7B6{j8|0;I@W3R@YWh8!V;7
z>z*|9lOcfYpSjOY9%v5ex`tnO;rF<yDh;r)p%zoqNUm*VKocB0c#NY5j?vNHNivbj
zCL-ofo)bdQeLl=T{lSZzIoQv8eticu4JAtr2{fXr0^Wy;%jF{hDb$bMU?BuRO59!t
zfuIsVndad~Fl5FUv|=<mf+W+D-cd<gjhJ4(CP2pBq`$w3;p8YsjwTuI7HAGwxmmK~
zeo1+)oHO^%;ewqH+9YEdJr@NBexT9cA=$7?Qr9Zc-4sp)1gzU>Gti~ceO~bD_cStT
zo7G!q5DNiV8s_n4jPGy8?kiU=j{<L(HV{ioMy&)OiR+b^Vs<P;N{P?o=Ph@?gF80g
zv7}i4T)1$tkN$x$LTDt-G2-UfG}A1Ewg?$rMUdxQY-|iWMcRsD$|ROF5okCxH*PI}
zOY@-#M_$rlS$39K6ee_}&!ZZtYdR0?dSuf0FBgOmq*57<pSZ&5)7|rqH}`d4=B%Z1
z;KQg+s(%iAm28f{6l_I#Y2VB;g=y!34&0V~{30q;@oC@ySx;n<2;4eYFaemsDBleH
zKNRa*G&D_+Oc=cIWINyfr{nZoRP1?P!=E+cC2lvXs;k)9*2Hb~byNpS@MN>nrp57>
z_+y_W4pM^4iDT<}f@|9d>KbdeZRCybc?%a#oaN<bUgpSwV}!@Xr?nuRIp0ju;+ZGT
z(SK!vpZkN`S+k{jsh)scsH%Vuqe22RG0N3#=QYa#r38P_P0P9v7mf`w^>!tIq%=5~
z>Luj&;uB8Bq7d*vP5JcWWb_p0MtZsMlts#dKoB<FX|q1Jlb>(O5=ugF?>lUcJg;%-
zgy8ZiLEmLT<0{Fz9g^BsiK7rAAi-A(cf3*Zq6vMM1+RQpqvxVz<6cQkbM|;)ADL%2
zVD4LuOuAGEV-c_|m`IyU*ePrrB=r#acK<?X+_mLi?%Z-GT9&LX2ZRt<woUuRK8_x}
zjA^RSRn!>7lIdyJ)wXRc+bS^1BJyVHOC(8ijBuulxH*DhC$XiKy-;G31bFlyWv)g_
zoVDm;x;(DS<;cn$FMPhzo|}-^(x#!RiS28*FU#7h^;N%>fq^hbk6)&zXLORZ+$5|A
z{t37bb#K0e`mH~Xx<3@u4`i88gHnQhGw^j35jaZrVi$?P&BuZWzzpNR1y$--K$gyI
zXqsTKH_BK3?l3QWqn%9BoHx18&bk__OH0_@+QQzIEwolu;Bz@AU$>W$*-t~(_-k9%
zBi6KLzrE^aQ&LvSj{9zB>+RdQbhe$RpM0AAFCJh#JdrmvkP{&~{c=Aa`)|+if#2Q3
z-iO-|8cT^0z8g3V{2yi~1@-`ORJ?9M=F;KR*m73`KmO)LtQo>F0zsEC&au=0d%aBv
z3H@U#AE3mW+u;bhon4%ApG4YFU+HD%+Y{8a6%fmp;4gza-el9VUU2#qMF1|H6!f$U
z8dgZw@0QfJWy1&yJZ4$7<i5uxN1xZYbV_jfw8}N8ZILuKI;c9e1^<QB>UfJZ{?iix
z(^$fdA!fG`l+vcQqJcZN+>NFcrt3fN`Gp`BOLFp5C+E)hObYZ^GDF-PnZ64ZD)CNb
zt}mPd2myhBXUez*rc5!My2yCC3q$6T48_$G0TLU-PLQz^#Ec;V&MK-s>+m@$02Rvf
z``kDjg>@serOf6d<ZoNqTDOAIKw&xu^Q~_(nc>{|9!{U>A|6j=3I8>$|MhPv;zfC8
zHvxYFYy*B9mCb)MQH9!|ycN|2_Oqz_6>xp^4T_i_h2{X%pp5_eC7o5kiC261;$I!)
z{J{ZW?#%vNjIpV_jJsB^;PzE*G?WF=G%+n(|GFV({I@FOKa=81DZ#SP91hlO*}%#T
ztGWM;_w&@3p5(wQhe@Y1d5M6g3;Nn8_|)&cKx{nCL+@UjoztR5sR6$Myo$;Yo=V#K
zQF#KDEYOiHZON8<8d<lqmXj~{&hp4e;6!?WT1S8t&Jbx+g#uRA33B)C61#+Ivzkh?
ziuI93%Jl=FjTGj(m!LbLd5t6)gP|UQWkDv1@(5fJtlT8oe3wmW1q&ttB_X);EjBId
z1gBmV40Z{woP~~aCROHT?h%dn@GV+Sc4h*gt@*I?L|>$YRgG&XFD+j-!(>@DUEM<*
zJ9dTPk%`IY1%iwfBV|RIDQ{(37KvoKphQb4p(0d*&*vr{OOdvt^e0aeH3lG?&^X@$
zsZ-fRi~-VCj9TwTg02QMO;A%)RuCZ)SrU^-rt;cgAp|uQHE5bvu*~ty^GK<h867=#
zg}(kV>}*o-ErwmF<iJ}^MX(-~H2zLh*VBIihM?#TxLLR+0hm$l_eZEik3~Tx%Se9w
z?Tb9|mj@Z?iOuQm&$-^KOG>zR?JDkDw~E@bQWagi5r#i|{`rjmthd`Xny#~c$0pj=
zuH=<xUg8`7{!O|%dh(M1O%NST@%jJvDyC`i=ud4x*B4C!Dp5KNXPA<Kiz*kqi1OSl
zc-p}VFK_vUO<X=TLL!=;-pUq8NrU~#ZYp#yLCwoVTrv=bhDvqys?8eiweG_q9f+h(
z`l+qBfA&R0AieONkOs*JoZP2z_Mjk@fRb`pahqhg7X~^7r}qm+`ZV@FrosXXB>}n<
zT5gk6JIm?*>Pouf6O1^A@!>;9TfFhlu3t1M88wrbDn~u<cSi_8ZAC4*zBI#>J60r;
z;N+=JE?n#*lQCu)rld82B{Q==Yuh%l*g|!sa&wfFlz6GBF5_(EGJT0-M9raTC3p)O
zH-fYsqc3?J(5NqKqpr4m!Jp3^C6&r3HNrfvIvq|zrIkxw-$WwKnX}!TJ=;wpnVvJ$
zH|Lt&02ja%EH=CUMxX`dt$YNP$owOw<OdW<z>UMa1Ym~i|2-)8(xM=QAd@!v?!TYr
zYac&CY&<=u@wcVK=W=n^sx}_myn*J5^6ANZHv$D3|7jn!Y&<?M_rLWKR&QLx*FX1F
zUV82o3}d!dy3hpiaGEcE^Z=GAdE*B*s&!f1MDGCpJ4%-!SNdlFF9Gi=<UqD1*?wOW
z55I36-~RN8S+5HOgI1h_sb22&w&4&OgJBg42nDjOaAkJ$q1jmH>M?%29@k^XRZ`u2
z$nHc3t_Ti4E9kqVO7EIhNp?J_;`OOGTs$T?xld!TOYqXS1^2zvrm|rHBtQU$hIyn7
zez=Lop&<3xq|<41^sD1u1OzaVfZ>Q_)K&?AQfSCIjG{w#u#~hgAq1vn(b+M?u@hGq
z8Hr9Nolb>BlCmZy%MGW!W=q21c)<y&4u{T~HFfO2@C;F7Xwf@ifxxg+3?xspbIWa%
zmzNYMNeq!_l62ab?V&^Bbhroxf{SY=DFn7{)7v}B(PNkC9|&h#9N%)g{?{4=DsgcO
z@HyZUz!fNZ18yW1n)<tzB?$cpp_2W+^mm8(kH0!dd_0}k<)8a~uBoo#*B-c=U%2OX
zS}Q~9wHvYHpB%{IjsMj{NThAkxU!WG|K5M){lEA=N=pNIcX~n-BqlO^>8}s+>^IIY
zHCFgRR4d`Bc#*8Dtq?d|I&b^M&1~FLm$%800M2DbIG-6&u4Ef}M<l6yO#y9z`NBG^
zGY#{9>jW5SIQ5F)nXjlS0GAiG-XppHJvKG1Y8;*bY`RNw@8dRQRWRBQhn^Os6U=W<
zHIQR|(%;xc`YU^|2ZNJF(JQ@6GXA!Np$WJ$Ac<yF0w92#ryo-$V=g*TRS3cOM4Wy5
z&hg_HPct$SnMYRGB5g(II1r4EMag6g3W1c8`nnLSR@N_i&88l!qP&C+>zWoJ^aUd$
z5zKu39i*hxA0!wE7Q6$`)%G7c+|D!4ouIFOEc^VtqanY}1GroQ?K&%!zXnl;5<2=O
zs+!4_dttHt35r-a=KMNNS$q%hKY<O4Ie`#@bjskX|8RsS|LFvoq&3;PcPgZmxOJU3
zY+T3hyx{?EU)733*KUlffBHa{Z2YGk&bD#;yu9rLkMpa)`zzGd*UU=-p7_gy9C)@f
z?;0%-A(UM3R6puz;KzlJT@tGG^HaaIlZrZj-f9I?S{zLEFlfcm5G2w{DtOjgg+#{O
zWWKuvIULAu4+VsW;Kgrg?Ek(-Y#gc@CHFmUv-3e4Z-A>g1ljv+!)nQ{hi%+G=(!~5
zI4kBnHd0`nt|#@`dof>J3u(tRZ^UB#O9Dt6&^ajS9F$}XK|&ft?ex5{a48`gOD<a5
z|H8#Se)RM)&YtVWG_84erM5INWqOXK5llo9i&FJ-I2=5B`x{u-vSHC-3|rci`hvXm
zo_A1FQB&}G7>3E<(0JafCnZ#u*HGdM6nxy?-cg=@<~YZWUm=w;7PK}>zd=<zOkZR0
z`m`bem>XMARRVv`lwLAL5^#O7kgwxAQOvAh2mzV2$=Cns7~lEl6POu0uRXP;q^cyq
zFWkMCpS^20m8F3jZ}?%^jsMldN)Up*58cIY{K2oWqP1yG5)d9t@NfU;70w+QD0n9{
z1rGopLM3emQB6FaVBrmfCShBW4ZG`j>o0D`;nHVqZUlk}JH`HFHz}!hkfRaxm<3H@
zcU6-4(I&{~QxAe|!KD*|r~gCe;&CMfy>6%Ep`Ws8*&yexlCYt5y`*)$#5B|~jG434
zlrDksgH5DAe>e7(Dhdo$&x>#j+WREK6Uqx9fN?uT+P=0*UOb+}vI;kxr%reA;!CF&
z*oa49$~30T^#YjnGU-%?-oDX-$04PptfY*0J@{TWv~4O_V8^y?DoU$(=L7F$<I39>
z)sA?4Jg&SSdFCdBpsA(>hodmhj%ivPKXHZrfrae)Czlb!PGB+nx(iL<^J%k|KUemw
z>DpvNvzgD`NQkU>ndZ>YCdZQ%2g^RU+(HIZ;7271egV}|9#ABpNCd7A^5y_cS?qdL
zOnFhRf6J0Q_4!l$=RY3DNY8EjS5;N=^LOoGLqqM=n)@4#>ty_=ox+xE*u9ls{k>o1
zAOGr8T)NabD>+cpRCU0={rRi>*2f>Ds=j0~Ispz;!sZ82Nq{}TFsf-s!Pim<c=&zm
zxp-`dm!7<YHZzX_L5C6MczS@{o<?k`yZ}D8AmEu*{DygO1$xUcjyu{xKztldyrgmN
zuppCEs(oAUv01fM;+S3{o)?-ER&9}7IV~9J6O4}ts+z9m0@xiDWWKi*>r6e^+M>(*
zrq5Z40}g~GL*wf2lR|<>2FxfX_WaQf0f|Hg!?f@?90iHqSeA9oUH`PP+6gQ>Gv|Ax
zgzoMU)~{<UtP>xK1k_g6@`1;GmLKi^0SC|SCzgoLnIxAZ2~LNTHBIYy?2b3Hs(IC-
zfA`%zBP5fVSwC5cQdnHsxUyhTp=2_{M5Hi}h(r=K2C=0%i;QR*R8;EZ5?nN0U|W*#
zaDtwTVR|o*Guj^~lQPjA8f8^J>RL-_UK66CK7iAu<qg9v7jpeqVv#ic9TB?Ek1^aA
zBR-KvXo5h{O-)k?O>08bwv^%xI8_gYrS~?;heuGo2|j{SIW(b|Ab34+ttx;IpgKeq
z450~L`Q9bI{`W`8B+NP8{@a=w_~2c8XsRf`IlF!}kn3*zCr@SDtloYbzxw<Cm4Ep2
zPv$29y5QXYLB96Mqx_dYyaTsKUrd;|gr$~iPFWs*iHrCA#tu5qjnREEJj**_1IJVS
z)aU_Po#mtqN$-ec#gx)OK;8c`4vZgdMl^&Ov_?7fw8lWEx&gJWmu!DPQq?%OQsC?X
zLS>yKSRond7Yz48RWp#*F%PUH^P}64BPH3s1k3XsizcCWR5B62IxY35pwEnOAv3~4
z>gtlI4C%Ci$K$-_dncDrKxIX#QVm>y+g&2F_5T)gZQq1YarC~vF;=XoE!Y@KDG8PY
zdHenEWXqcE960p~mwMX?N5?QNBbzv<gpW#mB{WnuvVGl7Hm}-@-{)VH@fQN(@f26C
z4CW2rNGYia)ly$oU-0oG(L|P1EbLw&5X8)3CXC+MNtO~yN;KB3_kb=i5++y9jPT0$
zu5jX|UIscNB;&?3V=4r=JPtxNJ~r&B<L<Yu;<ml@I9&Sj8eO4el!yCb?En51Uj0D_
zUFXM$ji;4oYKly@!=X_c^3b}WlD%(eW!t??RMrP3$;>iiCGaVfqTok?2`G|)<;E-m
zFlG0@8u$ek;qcKk!Pz4N{QF-VAQqk@;ZI6-wYKn~d-hUwvt0gaAUDkTPo4X!#(MtC
zy?5|;!(j%Z(OJ7{fakw<fwqkmyy1O|O21fE*tVo)U5I!8`gT6`2QQF}Pw#jpfP^&I
zpXw&0dnwi2jK^Vc92zQS985@3qi#-rrJQqCnD~UiR{|UN+HBk_ar-G)FTm}C$_5zf
zQF;Mu`vaIyZ^As(28LtVcKwzO!x88om88w-GB*~I_RI*crh1sL)7Sjr<aF;Nkp#h@
zZ{gFG5G?cK^}2|~QuBUg1%jkC!9=ES{sjb#Y+gZQV<k>!VM07=ToPT=Skt_k6%B1n
z#3tw;>1QG~K{A!Z>2wkB`KbxjP+3-q$K{!9#I@Kf($P7@SU8q7)H75T5v*(7NWfco
z{C{jLmOrU*&NUuqAbAQi+hl3x^;*5wO=Y>o%in6}r6(_OdVfC?qbgRF+kJ}}RZ&L9
zVxTiZU&jRdf7rnT?_SGWeql4!4T0t8DvA&SBV)1esmnb1nG;+&J%VMbaGMabwOMRi
zc`Qbs>*B;qJ=CuVvg@H%_CD4|>-q{@9(}oqKme70R-OHG6pAEZIWd<9K%k6&!Sazp
z6O0VT`NCi9XW()qZ>gV@lAW#1eCXc2RF(W>8GnR8j*Vl#dYtt>AMd|?C;$AyK4PgE
zwe|wi36pRB!!cHGsb<y2s%81nF9o)g-2TQDTsStwQ~!Eu_S6vcn=uZj`ncQIijH6~
zED3l7W&W$TXG0hq_8#QQcn4BsTLRxNX;_tw^)DiqOz2QnDG@qMTnv!7a2Hx{mD=$y
z!>(Td$&A|dk42f*CqW>H*=Y`^`Z%2#B9q4jJl9bT(`0lkMpM(m>(r%`1pFS#%LCc^
z{W*5^+48!<<QXz{Y>xNk%4?ONO>f^Qon1q$URC(6IR{(XXqrYS7^0#q%l;<i2bC}0
zmiCf*9^`Zn&YtU0UJxOtc>$!9l=y;dUbT6$gm|H_EK4O7&fDlHyLQ+_j6MdFXGvKT
zdDmFez?JCdlfQL{E2l?ECryOLf^vL>CeRVYC(=CmFDE&FXpr~(=61H<-@K#_nYpg3
z-}vNFe(=RJBxBd^zmi*bT~}nF>q3~W3t^u5>N&RD*~o+MUB~)ewaZNeG_IDP|2A2<
z^CAgY9!#V8Q+EFwP;QrCp$D`r$=CkjC@+2MQeL;eEhSqT8~Ek>?xgxBZ0Dad{_@r1
z$dNDzL1U;49gQ>n16Xo;wYU(1*m#;`++f?iO*ox5KZRI#YBaA6aq-v?!#%NC*H{3f
zc7mYhrb_o?Nl0a&)UQGT0zpbkan^kXQ<$u>S8)3S4yw1tmS(3lhz#j;UI0DmrD=2>
zF0ni!Xi~yh3_6A+6N%|_1?V;=cs_ZBi^eGSj5>P(WHdi<y_$T+p~O*3C{RsnOI1Pf
zW?k2b$5Zt6jm_~6LCPAZFL@%X&Nuh5h0rK-H{sH}Shh_po}#I-vfx~R{A-tOwLRH#
zTQ0iVV&-v=pSVItM^=A8N+vShr0p0YOKLW>-NxP9?kOmdP7#YF$4^|Dlu*vUx`K=y
zXDE4&!PHp{d#?IZf!mHCdrmRhJ3iU9w9smcoR?svFUE<Nd-0dLXj@--O@o~enkE?P
zjq=$)*~imgK8I=8i%K}o<#?nL1|4U|IP^>xeU~Q)hP;Go{OFFt`Z-(!TTs1cUH~!x
zfBOIZXxR?_lZt5s;3L2NaPF_a47{VzgK3)J;B%e)$6p^LlbZeGv8AN7BE*O9yOV}c
z@F(8*gNnbkRfQPO7+fA4&X>o`Kxc&NmQq%1sJsz+;@4O^2n5|!)(1HLVh^eK?D8lJ
zn=va%gEL4#bCD}`5BgOGu|qltSs|LuCRQca;*OS~ujxbh3adlUE{_`4r5a+-uc9M5
zh6^WcW*aW)D*Sje4sDpwJ0|HJVTQ|JkdhY1(*3-g>}1qV<j+Fq8U(;ui{BZdt+fW1
zYvFG9+|9S6a|qL%S{n(bZ7`O;LSOs@adR~Lik$Y@na2vc8gXfU5Rgcuv2961edv}H
zyb(gs*)`1JBbTyGj=;ubEYpEuCsoTKp>gl_2UyX#qCin0L08u>7u);idIu7liA*2;
ziQ`0!ek8NY{&LWyNria{kBlI$Q3IG$KSeO72T5pxRNUb7{(dw~uyS)1jsn6pnl9+N
z5ayr%@I?+j-8o4t<{VRY?dJO)2q6%fAd|AVa(aYA&vr7@9VJxbr@Y#?T;Cyqstgb)
zVKeI^zx{BL1S}Dg-<&DC|2kCnsM<mfB!pmWD9)$<_+|PpP0V7HQc5cPK7Q$*+gVp%
zQ#Afl#^bE5V#T9(bK&9@hKELGg#yg9&2Vp&?e{ek2)b`N36K(MnoF@P$?5(5vsk`B
zkdy{V+n~i+hAuRcX>dCQK973cF9Vd=CCWV;_JO6Nujwx=R<8jm2gb{5Nq=J}uAVyl
zcxf;jsjw;*ew;ZFO{iV}SY)QlABL?sFC;oRnI0sAHLuIx(*4BdAONMVI@}^iQ&R<j
zKw$+MZnu+Ad4T%5a_Z|t)YOzwSy76oG>s#WBve*TWoZ>be>nkf0JqDHuIU(-i7l^I
z5J<r9tiY?6O&&WOj^X!vsH$92!_Q@h5Q1<x#>@N85{>4v^aYkoGn&4Pos~LvJ3ZXH
z<3TFQDheV1Qc6yp?qYa2lE-ifGIo@~<XMJN=gG`L`mVm)rrhkL)asx6d|WLP_BoxD
zdOWyv2Zm)~WuKolifruu?4d!@af8)ct8sZ9*RGb)1m}(n@~Pi{VUj@1wFVOKIGvPw
zJ$Rf>Oxwn^Z57Fx%PS(X1SMh6etejtFLYy>HVrF+lT`ytgoYvky{N8&6iL9+kS_<|
zQB>w-fsj1^tqZgt9m?yLa_Bm5+q#J@%?(B4KV>|kDg?VXQ&m~cdp`JXKK7@dAR3KL
z`;lq7p!3Wa&wcX(@A<XmYiYW)X$c;E{{}7|8{*aPUzv3?5eP0DVNRw8+2N_bS{mpP
z_}#NbcZ~fj(OQRb?7qA(f+N803u63WGv=`tFm)V4vMRG$E$tFSeM}pM$Duzg$;?Rf
zGqJgl8RbB-hw<!gbG~np%dK~c^71oUOncO_WZo@cI%6;}5T<r!PvvXC;m~Pqt(ozx
zM9OulQI;*SZ3`>=Fin$aB1UI_2Zzrc;8JgUwpFhrZN;Xom|>V4I^2%W>!!K6>gJT@
z&b&545R0dHb^m!rN3R-aRpyw=_BjwpB$^O7^=li&eCP0ZT{CVC0x2yfj9!LQ7bau<
zb6<IZCJoBX4ob~ln4>~L0)Cf^b+y&(XlbIQGDMlzOUg9q93A7(m2Qr9_mDJ<*`>Ea
zV5BXc{On1h;S?YE-Q9$0{B!0B2_ZQATo<4H(|z<@9G_Q)y*?OZ@5&Z7HPllP@B@;*
z@d)P!hB(~OP4C16R<;R}nB!bRhvA+m|NfT;IQC)>kN?V6Zo9o+g$0(D%j83;(!Pr7
zds4&_FzErvy8r#apHg7*pQZ_VE|2qX|MyiQqp7^E|Jzrz@}Aw>a2D9+bJ>tH{@ZRX
z<1hAXL4<-}+tfDH5gQ-p+^Gw*wcKsVa9@lqcQ;aA>08d&+M?m{I%rr?#>suXM8dPL
zyF}#!R6G0xH7|w@rU}7-U>aW#fT<$~%FtI0B7&*8Z`=Z~G|ZzdWWKr=>p~sK<r61K
zrlD(CGB~a>{&RXk8iENs%`3@n4yAfY$jmhp{YpZf(c0F)Uya!Hm*WZTQCkY34AfQQ
zQR1w|tCyo`8m%qWd7DNp2DvP5UDt6soVZ*rJZ=wVfgmmQEo@w|2~Fs94|ZZ%CJxO_
z&{aP<E+GV&jLGmwgiv{a($a-jDO?Zan(@4{|2&<Y)B6sn61+hsGQE@k7D8v!itSWa
zR2Ccp@Os^J_l%HEt1xETiZGBo!*KcnhCO%EWo|SMnWDmIr_}00%xVFxcJ);y0q$PC
zf}h&6oi}g2jSY>pRFwoM@p>rt`&dz3$&R)r>Pk!L9t#smrSgPs02{8H8Kv*a1go}G
zQ5y10yEo+Y4_^FsJOA>(_c72pM`AXh3&9;L+xVq>@8IsWE2%FprPS*o==0K4QO@SZ
zI(D`;(^ytU#<YkelVmI_ua_dXmPi=rh;a1zZekN@npT(NFLf>T{#AkU2K)f9i(Y`m
zLx*YZ|81y7G6ne}ZCmn<e>%?LA9dz+{nwS2@}YZgr@FM{<`^ysxLs&FHlnR<yP6av
zB~uEN5xTZ~G0#Gbe|AwchfZBXEhi71AUrlcBNQNrh10lw4mRJ>ctiNhHJ4RFd5s^h
z-^KBldNGaZVow6dNQ;P_ro~x?Tj-=RpzBcLohgY1GU`FbJm~9t5zagr;u^?tAIA5#
zV0>>2GVEWL^1j?$#-hsQA5G@=cLEzp!ZzqI#(6Q>!DS<yx1mlx*p}^#jHY*s=<t1>
z%&6CAjpDZBI7sLAskj{>N}RPAhDmc%B|e|$`d+haGM?MzW@W=l4AbID|7E1KD0S7N
z3-{GaB2<^X!J!FCO1uPv{_8rnxgdlf8cne8m2+I_7|i>gv2+IsD}433*n-B;YT6nb
z3qGIM>mr#<(>FN6M5dd*<OyPCPHSN9T|Y>C)+iOmMSS*jRmB_$sS5^q^X3h_|Ms2S
zyKWVAWu-VY4SS00MJ_C$YZ|RpAy!pa(K#~4Xgogq{*+bf>$x;e$C*)DH&ha;_D?=<
zWNd!$?`QbJpYJC;oS3sD+o|ikY4b*Y=8j!dl?Jj2o72Yw;P<#$SzXEQwr1AWR%2Q=
zBe6IcYi?00p$XDSgL8)lxqNDvy4E07^(9Nahpj|;0Xm?V5V%<AFfIA-1HfAfIY4gr
z|HNM%AU-}@I71VHw{6?Z?W@{ubURESYj>Rv?A2|gyaB?;IvL%6fuR@AG5E}BhF?6-
z$bohuXSzxDjA5lRXu5{(b0IW+agADpK#q<h_s?Ve_f9wdxz_?^rRY*}?BMa)I~NJz
z;UwGdZ=$TidrNo$1kkXmjPOu`ODBhC?@|y%?F<rVat2j?KpOlWfyX)fU~*W+ob}cb
za8B8ROR&z@lKJW$%%iPf>I-jWb&c_74AsP_Z%kmC0z+C1+i@-$qZ~{3b2#0{ne;Fb
zJGH>_J_Xy7x@}1xmgUuD3YSdaw#V^XBLwVWymlC;jN{V$Shkx`sDhg6;0<%P>$*;J
zZ40C0qjV2<;&X)X>eCB<awMRCAdJiDpu9YQuHU$76d_=6Xo8pbou#{HG>_2`n0AWc
z)OjqKCTE}p8b0b-+1gxiHG>cWpV!Tii!akTaSTh&uI-;W28T>hZgvtfFXNO~D*|%H
zv$`a}W4Ep6XYSm^-jyu`ecs8}=Ys?)OZ=>>t!7{%!oWl%ub~w}Fw_&}?7@DnoEhct
zGhG~hwu=|O+0GB2I7>V-w;qev>EzuzxAFMS&3Ij|YkvPE;M8^M%7g4^X<}tnB}v0z
zG#1Cmh6eJDPY4+7jB;{cFW!KQrZpjSr?%LfCNHWg;5&d(^a3mnQwe|{_yb@?K}QgR
zAO6Q#Uj1H2Uf2KXnkwFZ`wqPBrDbFn3L(HWEW-V9`YuQ5Ioe0hlSdhP{w!lhI*FX`
zC*CnaymN%u<sl}{_Az$o3d8#@F#766l6_%xw~jj$Ky&B||B^1$_?HLsk_&;Lrmlwb
zC(bg^KQzk=5RYUiuko>Acil}-2F$_f)M;KD;{1_8M*8A;%dST4BxRb1O5KksRr8#n
zUogv-*aEw&64_s_T>D8U_COitOKUK`yA8X)Y*}^uC*sgG1fwy@h?(GQW|%|iUXG;t
zxMYkmVkJmPBfIxo%1H%N2QIL2$P~IcfR#Fdk-CUwrKoRc#p5ZxVICf*(@A4h6CHh5
zh{U3ly6R@lGZzl%?HePROjBMKz~i~Tzh@!DWW%F<ubg9aG=I;7oC4oi`pS&Y>v&}?
zL4O&wwPgjL-|KZT8ttdO=luK`@JM{t2$jY~{MHa+N=1MzB_(b*4{un@&)>P5JJ+lr
z==CgE;4%jZl=-}DY^Wm~PtYA6&+Cg2LNGCsr2WM3<fHpSSXD~QQIcKe_40w+ck+hK
z>v3vYVdIjZYZ?vZL3Xw_(^3&)B9USw7MoK;L1=>5M4FTPdWnvwSh2AZZ@{(Kds!23
z2)GDEFTi3jl>lr3eg~Cgu^<Q`7#)i9#9tjGJUCl7+o9|H)UIu8Y^b|oyBZ<DGHr&s
zB6J)drtf^1NPmp<NDMn|OpZHOx-$95h5@8ulNnDCIoHp~tL>!v$M95_;tB;8baFYG
zb^DJNZv1m_`@HA~4!?S2R#K0&C9&}oJ0EJnADH5<)r5*4XT#ySh9W}KvctHJ^2QQM
z%H34d_&N4Mw-P$ZQyLhylQcSl_;aO!K+rd%3`qdChTUI=b*d5TXe;L7HtdUakajMg
zqMrqWVdxmPxtxe_IMv6isczbhF~W8V6PY#F*GltS>PQ4&fIZ5@=ux^lUd6Ueg5^!P
zTt03D%k%pJ)K%1TvF98ZUYy$O2w+Z3XJjNoU;h}Ircqkr!{N}Em8|5>GcXut|G^8K
zKHWtsHMb<M#AY~ko}@KC?K){fC+KX#OldSVRpKdd10sYV7%1cHmD9vi@x15Pr9ruQ
znUL8reb+Bl65?(3b$sxyJv_R3Jt4oZV8cIsp5S-8*w|1<GHuW~GMcyeFqiw0d*m7n
z&4eu_H6<l{=<dDTy>{i2LZ8YbpwU!O&i0l@d@dKg;}H^>%$(i;)3CXCbco^J7#nui
z;R`G(FCf<`<VnCT5`e;?Pl^A(mjY}5HC=Gv=}w-0;@qrnwk;(qt15ZVu5Gwo%Ol8g
zO$dmMrMPlzh@P`!B%>LSR}KC`TYBZ*Z>LS7?L&l*T*2XW;%}`&=yN17E|c-k4uOj5
z3eFro#n8Yo`EmhTHdL@;Lq#?LN6_Cj!Tuk0@Zyv0y!yi{9N*VN=Y=riBMCBT3yDP6
zHFT%8XksA54DysccTR=1rlk}kZE@z{K;Eu_32Bg)=GD@`40xOZpF7{lP#yq7R}FlY
zao3+nLC3J<<Y<h2@ox5~dgwJHWTZXC=-)_OjdR4KLv&r<M}OZ5e1S@WWsS?07&td1
zp<sy0vPwGpx)GLlUW1TGr0MAyWoURDBzV1UoKF3kHRW^8KKq?AO{Kth^!R0t9KFo&
z@I*F6XKpc`gc)Wybv|2*e-)b0DR(zvXB>FFF6tKH1@L?Q#F7cxdoJb;Jvc}aGOnOc
z2|d_SQt9{ej%}NH{~bGNtE$MZ@N!%wa66rBY^YULHp3&B*1{S>O@%EbEunHgeBYgH
zYinADkzF01$K_;weGThsYlx-N3`C;XdBOtO>P@;Yh8Z78vVM0R9`B;;L@o?4RwMw0
zL(lI1b>P>4O@(~eG;O~9FDJNkVq|t1m=L^W%SN`gG~BS=|7dTN_5*`V3?(MVuq0$}
zOhz=t_=!%WX;HGK4$bM9^*%YO<b7G9@z25S^I|5`96fMs*3H8*Y;>1k_d~6W4=4D+
z6KDARpYP|{FP-Des{>p-I>d!TLmYphhy6e3VBdEx^Xm66bM%EC&L175zazrLm?8!U
z&>b2M$8=(#JR{2RN?T$WHmRgZJena9O_PXbNJKKEQU<1FBW-n@whfi4yV<32^5p}B
ztrT9(Nv%UAgeEgk>Jzx;6Qy1z*iyAAJ~fc$`SD&}PIl5~MzXv8g&X}`370*kb7kIM
z^fTV0zAD$2T184CV_kG!dI`f!QB|`Rr}O%I1FFias0@`eG7=*_OUUbL2t)1CAreW^
z-7`vW?-<c&Dk~GKqdPP-E!R%=>SuBfb+1sz&SXr+C*oYbGQhE8S2%gHlYzmk+xi-7
zC9xSwo+Dw6GV_a~37s-m6HehJkxbLnSXFS?V$uuHahiBCHfub#aH2~Ck3BKzlHb%&
z&oAA32Y0Pqfyd>%F84mCLuXxGH365K3xmU?O>@EbI$KIM)YkCf`|o63ea&^dH&>Me
z*xu4eiQ7%*Xqbdy%sIx+b7Po>&89o*7o$j63LFED74rZJNA9*80yY-%L7@podSaYE
zJjl#zCZ(jdw3J<K%{MGeJ=7K9^5H=;$-)`&Lgs2E4LZNFA8FaN{PbODu569*buj)p
zY~Qnu+L}sw`iG{~0SgVz9~$Jv@3iyum(FqSzyP)-mD^9BzE!p|Hj&XJ6C+7F&yFcW
zr>Rb3z7iL~Dlb(H0cu)Hsc#KZ+fqt-m5+Ed!$4<*{>}-8JEO#-8RD@F@kkmoV<Sz8
zv?WfT1AnOtug^)K%uU0pGOC(O@c5jh6Xq-fZXr3G>Z4ls)8Gh_%t(4iC2h5N@&T6X
z`T;3J>G&TW4YNPd%YYSKa9lrU#5EysI~@4kE=s*#LOw4gUJqqHFJ6Zem&1We*O5|^
zGEEYh43Tt-SSrJ4EY4^wPCSz#ZK{6pbJbC+Ypjz@ggNlyKQK1Z&Rq}w4&~)7$R+6K
zUkg&g%9d9Ao-$r}^?Y`RZ-X?EG6T{8Y^1aRr5|8gIzxjxLqlDhKJB5Tq?GbdIpt*~
zl$3b!dR;hlMJ}Z+u`HW(+8`EBF)<NmEF2>;ksz7MOva5D*5X(YHHL{8eay=eg<yO<
z&ZSHJY};B`dXtor>QFU1*YDwb`<~1@ikM!5-yFcNn>@IF4Ug~GLMY&yMf{fcI!PRw
z#v3-T$M1IWg;x%#3V{WDc2`R?AG~`Hb!Da3RgcA%60h6Io3?JGxuTpWUOmjkq2avO
zR!YfpU%$Z42V2;3cSE6l1T^4&;Pa?2Wf27+M*!MT2^9;55OD6uAj3V;SqUb#gmrZ_
z*|NXuO96y{(Y_d0jtpgu|MfeOG$q~NJdCr%L*qO4fTm@Q|1lUHUq0h61TvkWynlp^
z6&3XK4Nbep2_YCCO7hwNy)RpNF@Ix`tFGCr?=jLA<EaGUp#)b>j%39<1a7YbkI#XT
zu}H=YY)eiGcc?JR^xLhR{Ga+E3r(OqvX(s0kOUC3)4ZDO;SB*Ve&Hk>gTMsT7N&!<
zAV^?523JN*_Du|MB-KYs8rR(M=gOd54xQ?f04)_ER#a8cQW2siSVF+##_M$A&~>%b
zo#Wh6N-WzZkuiuQk_<+oTpS$XRBu0BV`1Xy^wqV^bKQ`Vi>JRwJT}4uk9~ydnso~#
z0eM`mdEcYH8@9ADG6~|b5mNDPs)Cmo?m0~=F^III*+&ATnVp$ENq|8^2q$UbCOYV+
zPb)!lRG>RTINi1At}1jrfW(O{C6;Mr+ZbQ%HJb}BEery~PBNUjFe&~s-zwNra<RRi
z6)Woqmih|R1%O=}c5(RZ0fxc@GsY-M3m?AHMt)&i4fm{Djnkpu5TUc&8SYuTl7QRI
z7hgTZSR#q8iD{b!Rq3q0gWFr0_`vNuCke`RA7l0uTbdiF36}EZ{YQBD(iKeGp4Iat
zI+o(8&z)rTma4_525tb#$aV`XV&TXUfZI?DxL{b8<m|x#jI=eYEXd{1+1lKI!=YW*
z4t7F7B9fuw_%P{&vFtnl*(U@$W77H61Nd93DPK`}U5r1O4EE8pXqUR!+0w`h=i4WD
zjgzOa<)ran{Q6~y!4&e4NtmP)2DzKErU}sIzroJ@*R_<s1cDxOf}^QE?(jAvq@aIH
z;`azjz02e17C^>=p)gz;OY>r^i}RTgtZUTp+u5CdZLpM$^|fqmYG8G3HRXOUPF<fA
zR+(BGoeK%f1zpo9^|}dqJv3LAv!kt<cq&cTXqZDCUF^Hm!B8YRc}-?tCyl<&gFOAz
zAMx;;|BR~Y*(5*+rD0*)7M7L4wymp;cch&qH1^ept#<N>#2BN)?F<c^WpwB~<D;D<
z6JuCrDm%ZaGn;$eW(GoR1SW#C@F4Ucnxh)c*@W&|iRP?FXns`WvGCM5iOq2OB5`wM
z-Z4#9TnNGV#NxdGRpr&}T)&&|y)xYkU`wbAIQg|Zc5qjdf700ANJwCNYa@-JGLmTn
zr$e7i0F+W`v{<%<Y1vc<OYpf}H(ZI;mXg|F3BPpT9hCXJJayu<k~y9NO%t4Wv6s^a
z`q}kR3$idTKoihFkpL8o90Ax$0nt_=ARfukd2Vdh&D55X+CYG{wbj?XPTjU7J?F-V
zjis-@@t-pJ%y^QHfBP}syBl$)lGnxf%Zr^LC97(xs4ok0X?P@$9BBT-ETn<Q++$d3
zx!b}Zfs^S$YV-hWT$LE6q-R93s!rf^Ecx(6lh8K`UC|UjPF&%#5uP`X(9XJ5+bS!#
zb5$FAR<uwPEWx2?MOvg(H_k<Vr`1QVe%|kPv7w=sb@eseziu@@K7Wbl&$lxgkI%Z!
zpbY##_fekx-k<S?w|$hd@@B~9f!k6tKHg1t$9{(TPZ6Ey$28MOX=B?KwrwgxV4Ldi
zmWgc{*tUgXBuFPC*p@M=^PY>_7oK^U=e;tCG?Q3nzbbbW9yCV{x_cG6dp(+~6(PLL
zMFeEl#gzLQ2?60u2V?1u`PVz=rI<X9@&c?}QA;rBFW3vPeceu8J++Uqi1L=H{t1HL
z*jdh9O@3}>r)~*U2TLYbf96mopTCY_iEF`@5|7KtyLWA6G@jtai<hQ<&jlpo21lRo
zX2*Tah35X0qrBKBZp!3d!*HMk6;>AVAt3}K12KlWBC3D;6i5k8p)$(-g}K@ag%A)P
zN-*3Nx#6mKLK9514>RDGG;NsD$9<WNzXVFX9@f-UacOAenm-B&I5mxc$Bk`E5}6E!
zWli3kCbRf&>~iIwE|8WMFD1LkV6oB}LL{6FgrTu=aZ1esCEq(d0Rv+&luq$n@)DiK
z#GG@^bzo~OE924I)^W$GHbMd46!-mgisN#Xs5MoT^V7HQU`J~cUp;t~6Fq%%lz3_M
zb{yc@@Bbz1w){FScPS3tW@O+wP9FXO<D(r|*42)RvlG|ztwOG<L%&Yn3o-pqnZ`Cc
zu#FCk_{-?7Rvg~#=<f9hJr@I#llcHXpPRCv54XpOZAk{gy^Qv^V_NBKb;R6PR`of^
zO<gcC5vTo9Kijtzbh|@JNo9E@D;icZIx#$%1i81t%l$34hAj7dUZ`7Oc#~uFd0f0{
z^9D}#^f8f4&f270Iyp={njsJ@s4UP4RNd_Py%ymBf++XN!XX4b?O`H$cHTn3ipmOH
z*EtquS(1Uv<Cy8?Px@O3q=bP>6I3*o;19Zy_VOD49CS^vp}v-<&tAZ?=Z^hKAmDQG
zQ@gjbwYh<`VKNwvGBgpRcYK_oNQ~iFjA$xN(l9VAYw|QIDSPfXc8-kXc4PUcko|lC
z1VaE5c8X`?mpShoVY9myIbKG<qZ2AA?8YTf6$QPcl5iAamcfh34myqTIXxP-l=xjP
z?pwQx$2M)CJ`|jM{zf8qzV-Dr{N}^=^6jIi`0mLwd9%BP5L~(NLwW~XxO{hDCY~V^
zdjZ=@A%upe-K1U{1tGg@kZG*+S*-L$G-oXi-yR&^9k|>TghByYTdHVmsGy|8HyKWh
zCs(nhw~+&<U*$sAIZ~PAw5o!uYig0UW0Y{US(0r_`Uk=ohKaL4H<Q!hpthoJ^4|^(
z9&GXBb85>&60^BAw*r~SJ3O&GW3z2ZYn95UIo#R9)V2gdz}R4dXgEcn%w6aSZ>_eK
zuMs$aY6@mglD>`!EMvCubvqoiRaH#ZhF=c|0r7B(iGjpTG5)zRB%=mHoe^3$RbCh4
z59*(7*)CxtvDlpRwQb3cmL?wAv<^qMZhS>e<)rI6W0=I!X(kdW1|m_0B2jw6<BUY(
z498-`vc$l&?aAGjCIo(`6OYSD(Bo09N}UcBW6YIEnihs>kuVI#;&BoggQQ_hl9ik&
z(VWu<Y$RRAI0I&s)tO2%S_8Y>UOWpF2$K@VV#@d@(_l!8S5jSEHpb>P{tab8-n(lX
zdsnsM)Nf4k)_ky~q}1o-y?eG(;&JoU!^cVH5mOP^n6c-v)910$7Xcd~mcN8zF7hX4
zylLv*b7~g<!hV|?U}GCSWG4Etl1FLX{BCZ)>zxFH71^8xb$neH1WQWUzJ5C!R&3yW
z$9eXhc!`VM=SXEz)ASM~l9(|_$kl=nsxqUr)XSF5Z3P?u96T-$now$aKBq=gsbg8J
zq7aZym>6jbf0=v9$6HPap%R8uF#}(j8(r6y?AdiW9IU9U;7C``jFTx5HzQ-Q2=j4+
z#AaS!aG(+>N(%XqZAnJDW7w8NcTCMVm3Upw>)Z54N^rZGNTo4SR>5`RIU&}WAIl{%
z6*}y2Z;XaJR^qvRE0mQktMSjRX_?<gRf(VBSZvPe>Y89>btO(+zv?NNay*yQL50gn
zWl4ZlwN;bu?Tl#>O{E!+CmD!D7>Y#c9iJfJcGDaxr=dJZx!;G^<;3G~;?T7zo@6nZ
zVVtonVyQF}i6s3K5iSppa(Q@^zVQhnsT6ju#B0v$A~2-Q>C6y=V=>~6MjmLYz@>>f
zuZaLMCiIU<h9{K!A5?C^+4S(7%Pys4b7MU}cgJp4R99f<;`_G%RAUy6H*dWSUDJ4C
z|6$UWH7nUt+7YaDgymF7Qe;tmEp<)9>u}(5=#+RolzY8+-A>#N2PMt*l+;%vB&1D)
z@ko?pG=Z5h2#<|3HX0_KOp!<=ueOc7W_h0mNUY3dE*$?jnZyZp-}Nih)UJmq<{%fx
zb~#;aS-XWbEo(X7c`i!?&Xdj(0f8WHjuN-V2<TP#d~R;vyN;&DibdU<q=ZB=J=qY*
zA;3A$cXJ^S0x~I!(e5by?c*3}lh!TORJYz5n^_?soiyn<Hq2OGjPg1^b*suLsq{=H
z87}I$fXA8NUQ1gRS_YWI_3fhdI)wwMp}_8cM#f@%G&$?OBY|?Smr}3$`fUEC1h)&h
zaW&DiN0GLTSU~Z3&g@v&q@+p0Hb}|;pS}MMlO#LOJJH_>lirng?S1!5caQhL3<elr
z;6VdJiXufyBt?m`6e+XXU1=|`c13A*MP1%YBZ)E;y%QmTfC$3OU@#bO+S}^x@;0;5
zXSj3rkBH35s>(81T{#Be_dL~AohIVMi4*5@@ArN#wsQS8m<YncAf}nbgo!D1M9{Bo
z!{Y{32&GIf(e5<LYokVc3(CJfrxDX+S63J3r)JhojvJcBU^>M{c5@?7*Z>Ja*ffZQ
zO!`v^jt=)X3<F;Yhz8=l{{6L=A<#6PkfD=^gc-`DI6gAS<5E(!9cJ@I&QDJB`q(7b
z=NJ68rfkIS1`A%9-<`eA0wq2*vWui?wp7shir>ViSY5u)x11$jtxW}J|JL&0{=NK_
z#~x%LoqWeA{uTELf9^kY@;Hm-GGBP}e2crf0V013DVyfwXu^-&Wnxi=GXO3@(Y|T+
z_x7->J40V0K`I(177h~&nV7nUwrddmfm4W7qOp#YQYcR%U6)F=N;zL*X)(*#=r}j7
z-r&~tTTF~iQY@DJRGGGsF`(f(7FW-IiMi<u-1q2@bK>MDFwNMS$_FVW;ZTUXj^4%5
zy+@ZL0u#O=poGO@ZIr&gAs%_?IQ#Z)ADHaeF7pfd#>`h;McI|xGQEWGov6hmruDM`
z0Du5VL_t*PGLsh<DJ;|))l%1Aox!y{h7M<1^7p@0Qjc(6e{GiRWC;|^-pG@iF4MOs
z#qiNCV%u!%s}xw4+wwgr6|&xkyUiiLZIksb76TX}=n1eD5dy55OLn%r#*bEtMt$^-
z0{{c%uibM3JDH|3p4|{BR`>L6<udP8m~soudu6g-m8x=Zl*CiA(c0A%8X;kj*1`-L
zN%oj&2J{3WVQgp!c#cQz!W6xa-?{Z`*`o5Vi>?WVGAXom!n{f;;^7cIiR}TBS{VjF
zTe;2VaB=-Ov5?7u{vHnW_wa!`j&gG$%eStM^774b=8GGYy&<rq$Csz4$l4Y^uxB6r
zk%%8f09*-kOE8mD*zU3qTvj$O*CwbayJhHKDaFGF_VHKW`|w*<3%y-Y_>6Dgd+%u`
zb9r95HQus1V9neK!B9FycPxe`mQyuaGktRa1~oK|h-omCO0loEhv7_$Ogu)|G|&Q0
z{`y#yQi$Pxv<FT>GLBk>M-jS)u7^lP!lb&p7&@?<<M-c%a$PFLGLttaxcKG;-gxN^
zu3o%Gu~gn5D&W7K&)(vhFaJFAvzK`Iy+2Jn-rJG`!8ZiL+;!|Oj_y0krJKtUfoK9A
zdGs&`_YQ8m8>uD)Q`1@I=kks5x>7M)-X8BvrC>98Da+i=0&b8-txtn%Np8G3hhw?y
zKGB1={cd^N79pUNv$*z(&#GE43K0k#%VY9Nj-|N@yN-3!w>OE_CWDvsB!xni4ZAD1
zFV(kpmcBE@zy|<s{Wb_erD#)Jv|8%l?nE5J*kK@2UHRXA0`15?YH!}e%9c0qA_Wy?
zbKTBz&B-$BmZ&K=Q1<mtG#ws=r95iNqabUHyLrx7GYlI^?g$UC&&Xg1eVq+NP`osS
zTc}{9<C~`d>dODMi>PaxEC2dedgE~nO~Y%k0V*IJiIR!M-Z6;Z`nc*!By1WSA0FVy
zU>_g6^BB)wzRojOuCY*81Z!s1|NaY$ixgakAKJU0z0o)&3#PJ)rIJ5&&EGq3%`)j0
zS}K336n72}@xzZk@QzphjrmiGR5Zf(-FuoF3t6(|@}_z9#}6Om(+}KDDiU7Nt6>?W
z*<1+{a6JSBPxU%>rPRtgZKV(+0}bWB(VA8ML7Hx)Af8Tg<gODOx$6WU`o0e{dhr@B
zeB;}^^xVtLOwTvQv|5DF@LY?tFaH+h!YuE3>gVY0-oGvpl9ZB2D9qi*?&j#eV_dy;
zg=9R*{*m3=c1VN}l*%>EoV|(dEPJiCgsWK_buixcF()tQn7Wc{9SI4d1LGI6IJRWp
zsb0*m{+59Qg@C2m3fEtqrIc&E#|r`FC5zG5W{IXkr2E>a_zExu)snrw*4ZAetMt~)
z(07*9L4aEpA)v5SqgHX&+$bSnAelhdZXYPpkS66X4($OUsLtk*_F9@*0k|k`IE%bd
zn`YWA;UUoim9QB;T{Qh`E00kp$D~`}klDli(Oq<D(KSYZ5Kx^hV9ggWGx3cdR3X3$
zJpU~!|GFf?VKhzPt>bj`B;&+7#67-KQpW-83Ci9cI=GK7ow>lbM{iPfoYwX4!1;Wh
zU%q;ck7f>%bQ9R_%J(I3%~|A4Yo?`BA(diRSB4*b2Z#MPnzJKA{XBKz2*3Br8|!{f
z0r60X51u^6P$sou#Yn4jtY1U6b>+YA*qV%ja6HC|2TpVRo;&%_r=I5PU;aAJ{Mk2|
zo1G8Hj8=c!f8qM2uTZHh^5lpA83ThS)-?hYprj-k3Um6%X%x3t`|h|Nuf2YqnVH<$
zlC_*o%~gc-cKjznByMi1<djlOU(MlK9{ca^BNA_$9dBE*FkWKxwOOhqXTu>1KsR;F
zaGlI)i`S2!R(5cztv9mU0ChXt{o;4CXtZ5EAt>i9YL(UtBpM2_V|e5i${(e$=Zi>p
z<pL5wMY%j*y~S6`*O+t*C=}Xl#F(@In0CRQ<4dJ0OuG5CMuZT!WsCCo;>HhkL-}85
zTlp&mv9O7$>8+d2D8*nZNoc1dFCCJ)0zNd*%TK=V5&rrUkFvMBYu$}nLoik;@yBzc
zOk2yTCqL5T@?v$Iua-wCOQ$8cGiI86`rgwGz~8$~G$DBW=pjZj>Gj92RHIM9P8#20
zWB~2K?JNIQ$5fsKAs9KlkH7Rce}w<#7ydCH{K%7pH(;p~LSuUDRlfG8|2qrwS2nGB
z@EbA7+n$R{mnOJ!b*d$~&P35AZ^^bD)>t~c0zAEu%-<?-<;5Aw`P*at+)R{$+0i^#
zU!LAn`GX%d4aW^aQKRi;QOR3)?)rKDZC<7g;7$EP<L57AbJ2h;G`epR0e02Hb7ZTx
zd?mCKE47vK4_^0b)(WFjASg(Sua>X#dTkm<$sJ|06A0$K5?`&1GSR{akgmj<%dfvd
zu2BAC+uBIu;SjNq+48%3007)ZC#|<tq*55V&U=p@<R5(KNgh3Ppuw`XS~MY;^@@C>
za)TvV^;;mjMgC{`DlgY2s42Jg9aoCSj~?QoL;K&A%D+BO1L+j+Iec(K9Dq`4QyS(i
zOSAG%?2z(beTpDTvG2qYe*A~OpPzX0F?MZW<OrcNJ^ngh{nLL=HhZHZrH{+!5==}i
z@Wz{?xURQ0MI~Ua;xSor+jMvo(WHqH(zoU~3&>5Ex$^BP3JcX8Hv)w4fp?Ra7P<b~
zEKVE!RN|TNa^H`wUcFM3^VYf)@%2um+sI{p5_p^@efAfIz~-U>Z6~o@N4C5{x~35i
zx7TvBrL3p?gSV8sY<$$gU(Zx-a@|?n^sv(NJCaGMR{YdoTTcXntXJV{l~JbF<e3##
zw$ys_-2vtA1HueUy>$e@&@_h9?~Kx+?TA#0T|F6o@`*?I)Lkcu7)I-ggP@1NGnJdX
zQk&#U<tyBBa_eG=q*4r}(|qLAiFZwOWIYiA9yqXv?$|o{Rw4YgyhC1kr<MPTaZgO6
zzj=xG9oWl1c=}21+w1owYl*lK8k09)<k_$MODdIYM|ePl5X{f#dEuoiR4T1$#{EhF
z$;~CZ-KixMF^DA0ErSw;fWl&p%io@6?pDFCq^JW2MH9oPXa;$%dR<%np8x+^+2zLT
zbKE+!fM;(VeJ_L{mI}8$|I(F|mn`Hu*RJVW+eSqop8`G)`~mP|K!c+7FARb8#b6r*
z3a;a|ynVW+5etR3jkX0gRQ}5!Sw6m_BrjCQHza+jcXo@XLJS>9v-?OF{kxOI;voz}
zqgb$*9WQYG%mOnv^4L``Xsf$Y1cF7c!gJMId^moDq!wy)!?UwxkP@26NOnT`H?Bdp
z&Slms0J^tX0q{-{sTA=@n9n|NH{J0Vzx~o{l&uy_lL&4)Ic_<*fG&6a4M-P)51cr{
zNLTt@>-{&+&u~|o6T^c%d-eMI1h}``E%+@~{%UF#`QjNUmQg~mx3`<W@#K5>{g+?o
zs~4}}NZG>s*0^!y>%8*q|Hz|H{2esSWT&9=LI|?C63;z<k!-fOp@MTg#kHK%b{_!U
z)QF|R<mW2>IfK!ANDQ=f3?ILG;OdJrEKZc@*_9xc3Zt7Eo-47dF0SR_+8(YW@mz_}
z1csqugmjFMh8Zz1!#Y9;?5ay)q00PNfl{_cV<78@r{oGCv~Fl^lNQx^4{BwnwE>_&
z)5Vt4BP}Ead<b|y@Wa5r1-=Z_z&8Z+;h)>?vA-k5pxu;<sz(6U-asuVE!y_8xCP}e
z1Zbx3%?aSDv&bcTebN^x6<q@{9{TWp9{%ut_8#jYk@gv_L_mRC?^B+euW;d|Y5wPL
zUf|M8vq(>^8G;sso?o-3cr3cNfiaM_7t}a64Rl4$|MqTFovfx+jyoNV()A9j0N9Qw
zr7(1j51l-Qu4(+Y7hY*;1k|s4qlGJ#Vo!G$j~+g-b3CRkWbN2g$8=`M(7AJDh;LmR
zZGEqAx7kZW`JaYF>@8LP^#@HVMJ68QhabJ4cqq*0-#pvW2tZ2Cy!@N=^dIJqlb_lV
z+=CE;LZQO*&tGJ2ZfSGxRtT=;Y^tszYHXbpNC-hZQ?Js1ytKGr&5@Ti9*pdwOOLg5
zqC~)yH+M77!dTH)=DI+63fJ-c2&QV>%Eou<zjZ@HH#Hx(Wcz7cr8dskD&Uem&#0Z{
zSh$b9Mg|kjk7C5P9>oYoL9J}#)Lf)kF9IMiOzn2}G6O#ya4+!3!2bzcgugHXR*M1c
zV)hiyIuQV+0uN+6G{9R>{s0IKJsR=rgr&u6wJ99swe|!B-2LQkKK-}u;pklh{=$+f
z7-xOy`u}P|&^wUe@lPJ+)T1MO@xPqo3;*FPwNmRg!{@CzMvN4P%$^nHZvJ_9R{0BP
zq$*n64tf)DqVMnufUSzc-ylD5#}Pa!`EM`0Ld|vCMsx_^p#yvAOSaeft(_CNmPe&v
zV^tiar!XTru~axfd9&m7+e*QK{vMK%2>EJl%_FjA9kzLJF)|o<{%?WupPWU$v{Lym
z4@D6+O}_7bAI1OqH_xrDY7he3D)I6+e}%!}Q}py4Shq4@YeN#0N>!eJ;S!Tmi(3k9
z3t+0`lB;>dlI?-vV(BoJ=5eVy&pB(BMX!QFQIHmo$M!RzC)QQ2BH(DStE<XkR!+~V
zIrSYk*On_jzwS1RUr}|YHp5G`398Cr%w1xy*~Lk7fD`dS%!twU8ZR&T0KireIR)tT
z6u{0bzXb4?@w?srBj8Jbs;2|~!VvJ4f7|gE>8)2bv`r6WtI8jLv}Sh<p$jhC3oLq-
zmdalUc;Yih_}l;becW;X5Sk{C-p1aUQa%l3raQ)G|JJ?y&_8~VXsR`;+EOlOtywJP
zKZKg;ht_sl`7h78^yhuermq-GrQY>9?$x3R!Bcl0<zuJrKyNe8sFb2B7URJKdv`oX
zEQFr|o4T6g+%prL`^Gqzo}c2%3)5V9c9OGSALGWGb66F38&B5e*ENtzGL%lOs~ona
z1C>JTdS@vA=4%a`2H$tzY2JVA@H&Um$j)EmjhB7{&ucFizw$VOrF@xZpS!@=*!;R{
zMk$Zx2U-)bSoN4Fwr`+nF~M_kjAzO>Sn$gJI1o&^1^%pjl`(f|^J9vppDkbP=ARe%
zWza8GC-`=4jGA&A6;W611-@9m%v7v|u?+xVC2!*?MOC$~+VfKYI}YwV3H%q}?*fgy
z#b4k8+V=i87Nyt_NVo2n0){_vXz%6~1PbEA-Bdz~E7p9=jZjL(y-)4sNB+@6boa&D
z=9X4UVHg@u|G)`8@#Clbu-Tf4^B>k*&Jvmsgu0@Bi?9wTfAGmOTFtGlX$+*3@45<r
z%|ro)uJehz@8sbF``R)rrGkTfJq&kcb~N`d1XN27S6-Z9^p#l(^A*1urXF^cifX}O
z;zE|IFHK{WogFm-6c7uCIMCO#?g!d7!0XEYfp?DbUmjY$hy2}~8W~>aUJ5Rs{U40o
z{Pwo00)!AOEEag?*>jAKZ_qyig(XXC9_gB^xZXApP!WlS(BnR_SF;0C#~J;3`8rqa
z#kP*S6Cw~)mCJM0TfADE3@WNtzV8T0EFEgwxb_@LC2vtvE_rFKeKZt=qXvfQ_l4MD
z=>`4;@Uy@UAl1J!L?fu5+zC-iwJe$0;0w#j|KQ#&ZI((YqC;IQWF%R)+JcT)(Yq_b
z_y6?WWO}0Q8zfCb({+uH|L95Xd2&xnBf?f57wvg$<q_^lA{@6P${(Owc3O_X)b)3D
z1;9q4lp+xc^O*<kW>0t5mX*1#2~O=EA+pV`Z!INgjB@Rj85YKhLGHA5<Ov`<S!V3Q
z;&vOGY<O+EyD}}y0ozUiD23QH@Qzge%R^LjCu01ihwo!Bm0ELsLI|pr9B;h*o7i@V
z_DD?y(=$1qdG=gOqMxQu;>ZeRcX7?pU8xw&IkbD5!-me@?yhyIunV%r*DIr(vu2SS
z^tISYX+H1Sb<V4RsA;lm1Ky6-bL~GrR@tSbY|3&iUAICpxHm;4)-lqf2=GsUzfS;u
z|89>0Xu$Rety_qa3ajdF?dEMm`PaW^q+^taBe=?IdDurkc7Vet`)_;mRZ5Xahxz1>
zpCZ#AUAy@pm~o3_g+(M2N4{~fBg$U^wUQm2zquq*5eu1gC*mF5yWdWcO0lau!}r{C
ziil}$I<*Rjg+d(a@7>Dbw=7C3CNE{lO_etfQU#rOO4%B&-G0Z)jYZHEkD+TVyj`WX
zo&soi{%;ZBZyU<LE>bBD4)pS|(<d6OuA4>EG$wDp#Kf&v5ZV@+g9-oHxq5AiZ#;9B
zg@wW<-mD^Lk70R5R^LoR6AZ?U_EP|w#y~o?VRy`ma`|TU7O&Q()_CHphS#8Qu2(#*
z{8@gT4bE4OJY3lz@}QKWJ0A1<j<j*T3NTEKaKs?%Rj^y^-I@^WJ=TpG-a*5Ctwe$U
z75MS`3*XH~Kpg|HV>F7k<!-J3x2yc?gASSOJ9QXcZ=Ls^87oq&x;sLeAw9*>y9c=M
zsl96+AOTdR!<1eovM?7k_SvbKTsekXxi!n3UjYz(*H-{+BuXhBI=GJq_wU)%>rhJ3
zn}{=zPVU&8)SIKs-pH?ef9o5pW(eY4VRqfo!{Pe}35DASN^N$1U5Oa6b&R1cd1de5
zu>S^w=JBJ4IJIk}MI=aI)rwp=^T)VObwgz?grHV)c=fgGJol}O6bhA1l)s?p%&=Iy
zzUCcI!Rh`mpFEP-mXQ~agjySNjWgGC@#8@*ei`gsSL~WD2q#Q3{c-yDrP*^wF9+`K
z=it5l9Jr^S{ipjFKHNpmNRmW%#3vvUb$aIdc?8pKU=Ly;(>KQ3iZ($wW-xrBi=3#n
z>}i64Qr@Ogw9qtxri&ff!&_Yf@K1p!8u#+M)Cj2a061)e4`8(@z^=Id!dSOZ`Sz55
zT~0l47ySdh%udg*Xq%}C!JE%a@XFV3@!pRgLhV2Z)(jgQe_)WW|NfOV$CE(btYFki
zsK{+kVN3BGk6N*XjaIJ!2!Cf(0IVkpznRd}cOK`=_!LXk>IOh97|x_gM8Z2ZCrZJ>
zcmcbKC9U3SR|tU-)`_J;r2Au}`(wm2VL}n3Bh`lrNQA;fOp`*bwvr?ZKT@$_1;V>h
z`7d`G{pjfvT$-7s;;b}?HKB3q`tw}9{4$4+K7wg#tJ)#^$oa)=kyl^4#;sfPeuu+N
zlz+|3GgCc}t1MPT-+**j<Ht^C=#S}brvLz4Pi~sl5`c%|joLI7>F`iwH(eorjb#R6
zq<W*o(qYVqj;3n}twpP|pz6tWBv#p>l&i5cTcNm6rBb%JVQ2YP^%gm~Hl^B1ynvIW
z-9i_opl4T-!M$lXKhfe^1z-8Ci`+Q3z^TVZIQj4}yN`4ePlbG=Meb;c?GQdD;B&y(
zjve(~CPwh118(s5wnYGT&BgN+S}QV#9a8>EN{03fbN7RH^QAxjGNQSgv4C3H;SYc5
zb@m?ZX77>i+e!rpAt)`?c;QPo@Eo}YY$t$ygFS>hr2K^teyLd<P}X!Q3dLYLMQ9y{
zz?~B5)k_dngH=q|eK@f~btLMsW(-PkXrPY=5A5a3=PzxrbQJxG1cs(_TZB|i;yNDr
zxr)#8U<izmP9$y;%Y;dGM@aTWh$h1rA;0ZZeNH;1TMb=9)5KaXgv~&>?^5Mo7pWA-
zhX*;eYnX43-dw4?g}|!jc=qdm#Q0Q#ef#?8>q`?3%418V8sifST)j561+O1K;3<pQ
z>IG_Ee)UYF6nykxf`><<+fx20MY(8g!3e4MHBd}xMQXbg#|{sZ?u%lC^*~`aDMm$W
z4gpPIhIK*_on%jxfdgr*lEc_Umgg>wQK(p(ast$)Qn4wQZQ_w|+iS?sH9mOy7_UuE
zFu9apiDeN!*6GZ*COP}<Ns^fedyjQ<^3f4aJ~G0dBVEMPVc)Rc8DrpKd_2I<0N!^a
zM?hWShuH}%fDl+^7rW{bO|1fQ?2z)Wi)I)+{=xV1{MVnSP$;c<h%`-b^ZX*e@h@NG
zumAje=p9Vl1{hHBwLiMd8{e2%qx=<qm%jV<?LiZwLu_-3!a~*0C9j$^zXyO{0pRTv
z2Yi!wu4Me;BBg8%$MPCXUG;kRM0bQ#Z<J8fSe}p$ilJ*fe)JH}U%yGwvRW=7O$aiH
zD4GV|?Xu#5U+-^A%!tA8(Jqob5#pH$k+{$2?yrepGg@c!-Ej%dwf5x=HpQJ#{(<pV
zKVBW{(CTwLt^Df}F%8~#>@aVPPhz?5iuZ(oTJb!iqoa(C&l8P?Fijn$6xFJYZM$1i
zxc*#v%+;<?aHd)P+(`w)NrUe{mc-O(n+cGB5idVe+0^5fN)a_p9y+j>r|vk$!GT_%
z5<Cdux4Yh&BUjN>h$ANk`P=)uc=7s8{_OlEZY*RsGz5G$KbPEeiT<8s+xJf@#YlIC
z4;(+jZ@lnI%j1iHg|)b3arXHs&b=_j|M(AQd}H8|5l%ij!oFkO#M5DvybbOPUw#mu
zKKQxYImo+J43@W&9VsMtESFlzCYlN@AG)FZ??4>fvm>A=B_&5r9p^nyy@xOS!Jn>q
zs5MRS>Q~12RqZ)`?4Lf&(B5=gk$`&m_UnIqh2Q_h*Klob%{i1(+&MhR!47tr^ISz?
zzS45TH+7w%RA(vx>JR$tXdbJyy7jXHN@#{4mI~3kC&l3YG~rnLox$1>sTBMAdN@8f
zz>7C;wcN-JO{Y87evkHbB`8fg`p__jsRid;R<v(N>cw$AJZ~*1OeuwI)dqNnl)sZL
zQoJ$+x=yGoPPjLTnTjEF-6!GkS)4ki{J~dv$A$;k*W1m->Dg7)5CZ8=qufcPevDG7
zM*YF5ua&JSf5k%WTFbn@e-`-2fj9>;X8X$DKLN8h@>Ft`zt61qF{L=z*TeVRbDI12
z?;&L9$lGOmTycE=cPbj@gLfX|p1r&H(=!+O%7x36ENk7yQ$qQj19$K4CYBCuYdJl3
z<N(iJxz3Hn?E2?vG6qU{n{(fu=KKrO{Ez>5mV<Zp^3X>P@Zg8`(K8U=wu1-s0Y44A
z3RJ(_q5wM!w-kQ3xSY4>8V;H=H7ox^dv^46ddTEspZPdvUp>pM8{=p#05vav`4+j^
z3ZMBq_j31pc43C}4Z}zEZd8?$!`J`lGQab0UZJ>9TY)nG8vWOwy5ks;kl7IfKnSRn
zZAv+7Edh{H#6lsulbxyn5Li_g&yj1cy*?P_DN0$3a&DgNREfQJ_R=-DgUYvsL`;MG
z5A5O9vGJC3E`(oVwUbjKG=ZVj!B=lD)<OuVmTjC>)dd3IK=M`_xjPj07eY|JImd;6
z^+i0}!$^b)cg0B^8>082!(>kGL63!z69K(%Y3G%Ha5*F+VeZ;J!lmii)uRMe!?Q=x
z!$*VDw?Brgb%VLuWfUuoDW$+wiv4Mmj~z~+iT1sJAz*2?!sMlF&^&ByCS57N!PjF)
z4)ECr?q(pJY*2xBLR1h*=t(B{!H4hV=wLs;_2R3HWpk~SbC8z2b#8&f_Ybz@N!j>(
zir!>`CyyWDKYi;(pW<9>91CeS2FeASH=mp2+>6tE;}5U!sh>E_10URnZfM(mK0gAy
z7x<qYnc#P@?0CI}Qa;_IlnO!Tls^PmfW0Gp=10DtU;fv>M!CE;w<iQ#eQl0^_xHZe
z10UMU<KJ_HgLm{2Pli^N4EcHPV&3A)n{)j6?_A=wua05Y+!hMZztG1H9pKJgLmh22
zlbbGMS6!4?8SYa+CK@3Vjdm>TTr1iw+di+JUx30~g)1*ibKu^7`gV7gm*Du&06p<I
zbH!qd`z<i_?<`itW>E@?i?tw{wKgxkf--lfbN-s&H$%A+XQ_gnt5Cc?$L!ZH(tZDa
zc0X~H#OzeZlz+3F-aWz>&s=Dc3Q|aC9Fz;9{dJJD$C#~NKq?0i)amsN4f<m`cl3q%
z_@M-QQrqzU1ANlWH|Mb`b&{yn%3l#NO}^*uQ+)KUJBW42xo9OyDKsH?@ZethQwjd_
zb1!jra;jy&3jr*Q6^UoU>^{-c{<(nn963nUc6fbkg7I9AlI2s<Y}FW0QgQj!S$^r~
zp5fz{vwZR=P7#fVwqpb&f$syp0_;TM@LeO@GXOSb>ZO#eVOJd@U2#O6-nT=dl;Yv1
z-oxC?Jiq<xzlY;EEz<#|oW)mv`!X+n=_b36c5(Qweg^laNu|R`sVEgJrmp9?c4nTj
zi&-iK8!c#|xmu)B9O~=kllPp&H1v*ng^uO1FkVCjZC+P&&{ELTr~v4|yrQU<oGs@}
zg%DU3m(f?}Fhe?BgPn;?NTujW#M#@^#Y~}y-pV%X03PBUAp-2GOK!T{@@)mnDS!?D
z{)DEj=q^+Du)Uhg+_P6GzHyU%r~2sI+gSrp1)ULx(kTkFbF0>;K)G`$Sw!evv;$1Z
z*<;L9&f!QKg}~5YC~k0PUx<fCqTD?YVI*k~*2T6$|H@O0U&vCJueK&~Qi^EE<Z}<)
z!-r3uK-aXlrHiFhiv4{({Ea6c<JX>fp4Z1F*6smfnHwY76AhmCt&deHMJgKR`yaTA
z51%^D*kX<|6H}a>m}V@Sqik7?z91XzKAJA56fOSXmtLb*cKF=izmLfFQjs434gy!d
zo6-OV+u#7ub<w)iNP!fJTFIeQk;Fc50uFRe`8UR67<}vpK0$tZp8xUruTbwt)GYNL
z*yX&<#TRC{_`(dDAsWCwDHYNU@`XVSYAcb-N16ZSNA71Rlj_(5Duf_EU!|0-A%sA(
zG6bkl40W&qz^Aosk0eqEuqqC>&Mgp2hkbBh2L=~54Gs<T@$${J)jLWlTu<%<%;X&@
zbGP!8b3r4ZHFK+cFsPy<Xn&z=t&RWS*{T+8uD>>m9@6L;PIL?pQcu6_>FMIq%-otW
zNpA`1Eu!n)Y-IuZIsY5XR4*We!*IgnWPg~4ha=q8r1X6>{x(2=_|L}TbeXxE`Id92
zfRJJE+57L|Bd1QF1r2}RE|E$xkWTXBk3Y;WfBjpWnV4E(v;=Su?3&B?`2`Z0Fh;n&
zh>MR$^xK)A7#ZaF$RHm(Z84r*;_So}XC|f?Tg*|~#264l;JJz~{^xU~d!u~vCr)oC
z0JRU_2)O#TP5Rp)+b{t9W(}?Nf8eP)9;I-S{{6e(l8aD)S*r5sqlXcvr}@(POVnJa
zrIp>BOG2>%7`UF&uZvWQzC?n*`kse4+2PQ?=Sk+r3V5zW6Pj-TG*NRl_W<Zb1%T^F
zKTO%CDiuOdn5!~BUS!viu8tTdLcrecE=*m=m22~~w(V~7$nRVcLXe#)F?lJsF592N
zPXUNs1Bm-h?s%!6(6kLv>wcekj~j2y6G?=Kr?v+W+luJA;9y@bx^`vtC_vdLcL73&
zH#v&Hl`eVbI=XS45AHX4cqGkT17U^}E0zB3(uvqLkBN(mE5O9fhtz<l?>x@aCy)Ee
zzcbU;mPqB78UNU05Alm%`35%@vui+$LI{@TD$L%@GjgnZTLynKg>^g};`s0Y$A<^_
z=;=EcU(9iCa+)&}Q`}t4QmR>v^EQhR;MyL4@@sE$=u{u49vf-5{9EAT0Dg@fWXFA{
zi$S}+0EEwxzaGnp462ituFT>TtC;C{=j)B<v&a|UBwDHRxrgs%FrDHLUwgBWBfi~^
zaP<XxsIQkFdiXw0?H=yv1L}MKWpY!chSlpR53eab<@W$ccWO#;EDyWVewQ<Xxmp}6
zGO#a&VeWiBUMc8F#)*bP6l%4Vv?tPMP5h4GMG7qK#i=5rugz`TU`Q#{U=QMfQ>a*U
zho3v;x4+x0lbnEZ&SK{J5(n<;@95MFW>SO=V@)|Acqp0Q<Z1*0n_Zcke0tYB_YC$h
zw8Kijc}^C_3KSRC5?Ix1{2$o2hwr`jR7X>a+YzZ0dwaY1p@;9|-+lF)<g3-?f!F;g
z2{YH0=-HJdk}z*8>ep-x#6l*=h6gw{JitdzonSn>#EYZ1c>dar*7zSyury!g3%`Dr
zL#O+Q#@kMh-htmVXtu3yy^BR-8!3SG+CZwhm#PU$Hy0>eoM;W8+bL;M{$%rhBtX}A
z>f}*==0oq}J*Vy<9*-eCxvhsvDL<qdH%&fx;wXRbgHLdJ&q&9ubJy{hx{~v2?*l1G
zzl~;nT(MAy?nJC}6#x|n*OA*Q*%U%hUb3hb?T%o<d;nyW)H-Z`wTknu#{r0-ZL3vr
z89Tqgl^3R|<TsvAr4;mab&TZ4@3yxEJP5FGt3Y|l>KGPKDd>ttiG^B&zND9DeLR;y
z*NQxS_&WdO(E{IlG{)YviJ=L+ZHD+anhdMrGIKr83VbF|mbRZ#OeXmB{dbXyM&41%
zzcH6eao65mJblM8G$F8*8?-^MmsUchU^92Ku(Pz+!MSCCjW{~g&ksFvAOG+p@8_=F
zt@mM}3C?_Ll8Z0TY)AL(!N&o7*H8m*s~cb_Vzg{OD^b*>Z;g93hq-4jA*~&2Gq6(X
z%Krsl`O_3uQ%Z5<^l|>y&;JZR_w)aN$3OTUGMN-8h39!lDc3Z|sB>$}K<O)`NJXMN
zc4$9;?}P8-ufF$ThPu)n2jvJM$WE15nl7&h73O6P8Ej~c3V>K=D*&XseL$?|cvOq+
zrx3OzN)a**LPl#0YpoO*FYh9$V^k160aGzoW9<AQ=bstp)|myICK}?6#FJj<2${AJ
z0q`#dtg_4ERH<Y0RmTB@O`~;B1TP0`8qWBGuej5E@Zc3beWF4-qV2rWUvWl3cDhV?
zskY+&Im%<oEusm*M^2vL;6UHb?Ja@vxRb`05P}b#JjT(1eoCIroL62Mc~id8XII_M
zJo3<(pZ$G3{M7p%<IbVMHFH*P+5OU=-Nb8u|4IYLcYgHmTrq%hTi;NMR8NF(+@QR)
z)+4DX2Nf_)WnaHV>G}+*<GXg&BWqUvx%|qNt`uUR7xCaJLYX9|hx#~i&q>Cw-sJon
z=ecm^0uwhT$mQ~Qu7@Z6oSdd<=(<iO5u-m8;rP%1r*;jqr?-o+Y3wKg$NJX=R@Gth
zN)FFejmwfKiqcw+x+&;QCWwYQQ~{vcs{m*vQu>JXPH7`u6NHSl=>;LcDmhpchj=*r
zj!gyB5%da$bR|~BrJT1YE><Zn)~MudoSM7L%C?2upa9SF=$HkdYg^VT3Ppadf_t>f
zPZ{pCC`BY>l8Hu{T3Q?KSF!@Q2+UwK3R{+0tli>{{uw@YIO)?xcX)lcj>r71f?pP0
zCnG{I=@yu9@*M8(<Gn`@-S&Az02=gMiRZ{h{#!RS3{ykXHC9jtw>{m8u6T@(oI1hv
zg#|9!^XxM-M1;`*1Xc<bx#=>42QwXI#FR?WpHA?7_nqd}pXJt;f(p3u`W(fqMY=cI
z?!Nuj0N36jVgQqEeM3Pa9VQYpDd(&;%}6TJ_EGpkVCO2#eC<5R!$YuzHl16NEhvBO
zq0^8~g7hDJBV=;m<WUZsJj&D7M=4~N$mjCZiWREm3c8^ajztLxLF(2NiKP<ZpqG3n
z2{_hFtyD~2&QhGOuDC2$dE~w2T(?3onCe^wfZRp}z-s9v3SZ$je~E@#_g`>qkMfd5
zyeq<6(x_mwxo8m5D5R$v0Lx0zro3cP%GRhBZ0xEVY}|f^x?L}>VE}aMk_$zI+?rP<
z5LA{dY9)t6X6Fqtg-;EgtQ&c&G=S^nnXg_z(=#X}mRF?gF5t={Pwnp|9Wgoro?S5t
zA;`~FR^<K#P?Q!g)h6(S;;B21(iM+xdyf$!U<+NSkeez|%+|1LuJ3Ru-vEdtLSzPG
zbPdLdCPN!Hi`r<;mE!KbyErj4$eHme&KYyu8yRlAFQsDcW}cqiNsKnhf!Y;M`h6je
z4fgZmjWP75h_n!b#px3BQ$@dxdwY<+5w<-;?>;eraaKS&HWsBImI(Q^mMy+iRt^%0
zj)o90|J-E;-gkoZiQTs!1!zb4uX><VuyGltNzY(EJwpS*;DfMc%|^X;9$B$a0p;df
zDMG;FWSN<3ODkVTP?R<~S!>L8rz-$F$7@soh;?w^zM9(j+?rl@T{~1Nsah{tB^67v
z6?*q3ZyNyG)_7Jh&-uhst|PH4F4dB+>??VTYQgqd7Hu!c3$IrA+a0sQb2|WF76LUf
zgL?fU$Soc}0FqXVHi=AU3^843M9eyy`6|ACSz)1e30Fj^M*x(9p@hjDeLL4Fa)T+u
zv0SFE<ZvC?*s2^QdAT;hq*LHPZx46x*>zhplb@?HaVg8vY&qx`!kW1#<!UTW6p6%5
z1`ebdJd`0EZNFAt0f|V6CypNC+|)F$)u!mxW9&1#8d2Z;e3gZ<0z-!~9gnVr44o6h
zgKNrxMbK0zJ6mC$dfAO+7{4>_?Rh}&5~)W3Jhn^<q=>{#(*02;t}Ly1M*t;hQIjqS
zErb#RD_ddm3$K$nIEZH62Jzr+DE~EA;3xbW$HlUdubxL;e|x$@*7H_l=N51*x#H3U
zFz=PA$mRB@eg#0PV<mQW&GXp@QOtNH@}5Oi`B)AeK}<8rXi*Ych_KLUbOmfajxLs)
z1nu+~@s+%_LAhUHzJgV8i6%OeCTSL>e9zvoJglnU3!_@Fsg`VNML!+k+Opx@!*ZYV
z?I?V;j_I`=0odVm+r$j&<+F%#r7d8Uk}5DHJ0rR#2)B#^2?Q=$Q#F@BAo1D!dZL{T
z{R<&*ZI4@L7s$<&m+v)j$)4weH4ngp2lmpHh;0v`EEUt&mKeXVh*fbmsdn;Tua+Ec
zon2sQw!*=C2S{|aADNK~?%XxRu1tm-i;H}_Iz~p1kkNcRlJXQ|=N1S>4Z4RD9chW(
zJkNc}1cs(H0Md1FZAosfvK_m#4@dyn&W!q<B?f-ULj~9peV0-Yju`Zhq&UYE&6}4%
zP?iowX_L^x)VoeCeES-G4_~A2J;%2f1=vC5zxudX7V^~#Z=3Q*fMZK;ot+Oze^$ON
zQB1o<JS1As(>xwj0CdK&_A3B9M^RM{UoDTa=#^KTN=FdUOwwAI{bn}@L)~Pw$g;1m
zzzF%F$BqnA`1S7II_>_15Y);JOLG;XiA-n45J;`;FnujYey)mLb#ZME>B^?&Bw{(x
zbX(s2^2K|rSt0A9z;$<!10hiU@})C~auuZs93gS=(9!%TAG96|zF}mQ-Hzphg%AuR
z6D|2ZG$qm1s**{iNQ5*(`p(zcH&_upNhw=p@=}(?iDF~v2?PsXnOAF5ILad#4s&Yv
z@V4S(N+~8U=eTutKEMiXZB5lbwlrJj@(WWOd0>cSPo%9aQz=DvJjSVA!`xiVGV7Ij
zqc+WZV*C8n5CA~0zBt3kv2ObIrU=IjAEU6tt;1DNK@kmw*5Cl7Qe<b!+cB<s@u`9T
z!T?zJOQy!&<J~Qr@7T&EE2|8X^zXF*w_-E)2QQL5I!vTL-JTJ!nerd(MSJjFs{9G)
zK`$;cf3vW5i1?t&8MoLJScY^oN>>Lf0IEd?<w+{ap(L#}%!(e0lC&vFiz&CrIct_v
z;Q{Ul4-ghQ5=AT(-cB9v7Df1ArwvfP%2UkWD$ut(iEeZ*A6fTwTu0*6{2YEO<-a^I
zZp#J`Kvg-|%3IqF5QXcww|x%(M9a#bQUx>(8;`G7M_DMAi0dJG^*94Yf&o2FM3^nt
zqh0k&GCPrq5kk<LNT6wJo4^PphN`Wc3LzLt8jZ$Iw|{>BOr9sHm23)gRkG7%3iB20
z+RCa87mwF#(=189j(&G{hFx8mwiT2RFn6=a*trE{6HvI_c`IdWjJ`g{u}6jp#oA-+
z)HJ~zBSU=o+$9|8anYV<ubE-L+3l}^fU^3=n{&+G$kR0#Co>o$*&V@*?3^*6fLJ7q
zscWq6VXUNLai+W-hcgXy1GjE(bngx^fEi#B7~J~T1bYs55sK<KwUs$R55=NaS>Y83
zO;ETp%h(^h$f3XXB*N6UcJsf(l|R7r=n_+xv#r~zBbauJWMy?Z6R)5*87I=o3V@;w
z3JTI{sc8JME&sbDt9+|E#*A0uvFKh>T9~epIC@CynDcE{U0iE}e6$c0=Bq5tRp=c_
zb}Z+sX@X3Dj8tz7tKu|J{N=pmkJ0gvt_qZ3(8R>^(cvvQtG6IouZq(G*`y#a09I~>
zZOdxq-xR~n$tvS+9^nbDut-Q~4CqPj2={Z)?8X$@id*hF(!X|n=M4abqAL+2Z0OXS
z)sYWLMCK{#E4Q`&n1La-Px8}H`mV3^^K(^lGi8d4egvpqIkPg2Czx;wTyqxvRD@FO
z@9XueRN8q!gm0XWUszm$E7;z3_yEPp%USlH?r&=yN(Fm+y68>Bn93KhaCyU;Vc19!
zsyAQ?LL22Ji}F&9>1#Qn$q?!O7+phg65SC(J75e%O@mY<!eY6yrV?OjzJg<UnC(#%
zhw%-7?+P*SLmfBpS&+6SN-?-6MXEc(!bE9BUQhsYZV6j?%ZmX(!OU0Ak~%!d;8UkI
z-;loxl>hu#fw8j-NJq7N09_>4?JSP+8U}zuG1SQl08ddX+9+VjtKl`#53f6=_`M3Q
z*b8`4@v)I(^zBY{6iRDV96trHYH$h~l*yhWnYp$^ra#uvC_r7`MiM5`M2NmUsQ~To
zHA=GN3Ijk<Sg102IZLhJw6*y<c#OGAKIp1N48U=2GX=1o^2hHKX9RS>T5xVhNygnJ
zrrjbF;XDsUc9YaX!F?CFjzmh(I?$j|Dd<haNrod-?X}EsVVTEJ7On^(P=s*EggmyB
znD+VRCDoEmey+mOblFGT*Oh()#JTon+REjuHG`#G1b%DjgS|cNgLoCp-pEtgDS{;h
z^S25N>`xPKqf$dDMLHItH<4f}U+~KsodP$U9LGX^D~y`D!6ZFJDQ8j2)tI@y)G!7z
zgK?7G5kgU;?c35IM2p86U07V9BLsp{-omzALXoyGA3DAf@LeGWP^HZV2udk3y)pXt
zq?jKst=fhJi(ZACS7p#hE-wZFZpGo|Z+?sDP=@rKd)5!nbW-`(EaYo%zw)0OD=_-%
zEcQACF9N}m=X+bt8ls~W00EzNt?Y9-EXnFRil((F1+!X-<k2{>M5v>c6qSPA6lz~7
zZa|hV1mtGQEQ}W!Jdo}@CxBY6jL>vJNH-ACrpc{;2tl$ZN+@b@<%Q`@TQ1i{Lonf%
zm~;y3-V@hy1LJyIvEg-;e{g;wTKCsL;2}9@%~6&P?~fhuLBN1#dmUqC^lQ_j?CQ$2
z=nN?^WraTbBAzhOl|xuK3>psr?X|CUZNHX3J6#Ssoo=r5o9AZAEi&#d-?NZm(3?uo
zu6gX#T(Xm;9m((ngTpGjEQ}Y4W!lquA;VyIcZN47CP4^XJT6#s>^HksI)2TkTgMoP
zBtoS7qx9`bk?xPRH4a_V{1iZoYjbRg*Jzu)<+;}QE;0b>Gk1<QX2>rEG&yqj+R%{z
zYRYBOZIRQ~1eNJLSO5LjD333+MihTHDF0g<EC1kPx$a~sNqfZ<cd`Ni<$I{f?g&zc
zoLk-U6icN@ghG7(eRpy4z;I_9CApGPwgxQ%CknM9JT6_ITcKKVI^Cka^^~e*mdQH%
zWc}}CPZV>D-ibg^RyMEJCL0wQt;Dt6?R7L4Y^eNEzM|8Fw$UND>Ew8^Hi4u3j*PA&
zg9bRAncs+Ma_7j<iaPM+@hGA)OVXPqDzikW5;xn6ocSF@Ek<9TV{yEQU2z+)Z$%4x
zNUqom0d=l_?~{=*J@Hsu?1Mu1EzK*1^}YY*$V^kc3EH~Fymi8+YNHeCRz=qY$!Mf;
zT!CQ5D>3aB8)Mk`di-mWo}#>DF?l)1`1!@Q*++$7-O3c#@!D+&1mDF5z*0M36q?}V
zBf~^nG=GpN#@&3&Jf+YCh08Ns`_(_EHoLU)<~5Z68y!;qZ(pgOe+i1|>r0Hjwz2XT
z2$p1xOZNPVa9Zap0Kg3C9J+syqmK-6Y~LVVQQw92q-?MuuB1(tXhLvwu%DlL-(!5_
z)Cr88B7JH#H^K*&Rq|HL4OpTAHp=DCmva{57Z&l_+~hhbf&j;0Z=TB)2&&5A+tqPy
zIZGRC<}_%o+Z~LWm|b7_2cm7UvDQUv&d+xXf#*nUYneB`6LR<75qje5mD34S@S_Rg
z(?_>k`W7e=u~jPM#+m(S=$M;tO5yq5^Liv!8%ecfuTj(@IFGG7Cfx#WSkpXHxxv>e
z*ZErII^V92anYV9w@x%qAgGpn5~_BMv`jR*!tk<{%N2V8w@nMQZVb4Nw+%|>_1ENb
z>1|umNCA8|^aH3DYTp3HfUd26QAyZ;yqCfKX>OcdSP>c&2<F@}i(X}A8le8Z5M*Du
z$<<%^a}NL1Q+{QDqDlD|I;8x^-<C-h!uN#6FD^25DTlWSfJdRYWG|5Osw*B?1!Q8;
zj`jcm&<%~@Jze~@p@(@odz|xAGhCUTW4chFXjwR(M@Z9&hr{gZPIGG4F!$`+O?N!z
z8ws7AO-eZntKzmSKU4UPlbTy61I*pXljx2xbTHG=(Y13Og@x*dKt>VpD=c_rUaU=U
z-Co@Es8Y%{pO396|2p04Rsi&FkPg^qb`f>WhS%H)kxDVro#Da#`}o4y^Bd}CAzIT%
zZ+Z@Idlb47$pvd}O%zYSmJF$8QA$xOIxCd8Ku}W-qfU-X_B^uz_G$$H8_>~6Xd!l+
zY3>XSFkmEB490WhmeWwpl8Q#qG!3u84k@_d<d}Ag>^9QtmWQq<o~yQj&7h^j;YXkR
zzAtTpkpvKGdotdoQa1n=fj5BDTm7O^icC+G<M$78<IKW}_x$oTo2$;^%Eh+gLq0!%
z@+60T^8G|Z;yYCN3u<MXn`al8zmaFN^sGRT^(tJl=GWx<l!Bf_=PCf2MJa`8=o}pA
z<={Xs&MA+IWd{a;3=Dt}@kj_W03^N@?1@rJvQs4=ShvnoU63_AB{7=9)zVdro%IPy
zdPfp(dyfFm^~g<^*7RGb2WvefIj_n!C(C(jmb|pK5?Dnl8RVz8AOh6*4D#i(8!G?C
z$AbvKR@U&0TV%{x;;7k6Id65;U^O(258QE-*T%+~$`{tbDS)SxUoYM!I(0i31_4~L
z7rA6Fw0?6N0g>hihXCfh5-$W%ArILw3|5EWC5pVXSh8lh=`3+7Jjm(rAYoBYhitFU
ziMA@9P%lw^sX9SA9wDWL+cpBW^IV4X)<&J@DLiLe>+ZWI1yDBtB=9xhhwwunTM|td
z-1VMaeD!xO;Z(gfi+a?_axy$XMvJsw212m-(kO1B%Kno*Bu(!-O8EoiX3N|<Gf!c@
zx~0#1NZzn!Sdz6CdxT;r-MI>YR#I2$x~7qeMM%dQsI~^Z>RUydEP^tq{A|T<qSNBM
z0zuxhs3?cD2rti*@Y}MEzBY?tYGnF5)k=A5*HJFml(IEHtR8s!j*=9m#hh1W+|4uL
z<S8^af!cyJA^@8yxi*!5@Rcolt}c>WZk|JC52eK#(v?9&nw=M^6nlER_?~-C@gKkW
z0+!dhbk%YkK7ZyM`}%t5j&GfTPt(PgoXC1O-clY{>;+z^jZ;(Z+OeoD9BlQm1p&Xl
zKbCQ~z&9$REP55zC+uE3wvx1Yp*l`UT09)xLqzzcc-v{)?s;;}Gb9j<yLrA=xz5AU
zJ@n~uw4h38E7!OktccT!{#y8ko0M`p)kuwny4^H@KKygr`rcbDhCcjr^^5#AJ}vN`
zt$tZaICk#<2Tt~K@r9Xy``s5G#a?67$#GA3n00S~5G-As=F;RMdrtP!zbEC_49j<~
z@)ttj*dEi@a!g*zZUXje`W}KCPL|8|e9OnV(>(w-6V-%rf4gLHs)SYcOXpf=e4(st
za$YqsJXe+^RSOQ+UY_CLeS>5MI)|m$NEDEpDq&S!a<a;zS7E`cFz@+kvx;<Z1COp<
zXVH@$N^KI(-G=h_=dYe`-P|M*z^q%Oq8y@mn_Af=o(^@+=u(RJ9zDoRzQ~`vaTc#d
z6hsKYx$$W}|K?eK=%M@3w|L#!2FkInSY0F~X*1;(xMD9d;pQ7a$hAXN>sGLAG^3G3
z2u%p)yb@opjFJtMe|tyqpW(CCEIJyGM)wephJ7$<n<J{!>~)R*8_p7oUX??k9uAmY
z^y)Dp!e|=7npr_Nv~8qDIzlykFYp<B2U*8A2sFR~3c*hqzk;rekDsdm4RmfR!{ME1
z6f~2y-vVBy9Rolq(%n%W{rEwyygJM3eMh0VXw7lR>?Wm!*Ii&j6I6>1*I%BcykxQa
zcsJpFLx=}XLh9Y4{OfhB`GpGO7Z%A)mQZqQ`>Vk3681`MvQaO*T1;JMDAl0~fOonC
z9{gO8MyZD`TZyA2GhUH>W@hbS1eBL-uDm$S!F&4Y8A-n7mr^h1vXsl$Dx=J}MP#rk
z)|LKNkkl=v$Oi$+4N9Nt%KxRaP~N)ouYY%|9~TG;(jq6Tq^e<-X3NCWolC7Mz%&fL
z_uf;up5#mCF5r0H8ik^i;<?MCy!Y@y4)*nKA$p}S!aCu&NwsAAq(%Yo%)^h^OuI$K
zoIKNRk)pI3;rR6kv^-ZfHSXE^6~;4RypZJE+3{^D|JCz#&Yq=Di}QH;pih?5Rt-K>
zYkte{R>KhZL}IVirZ{iS(xb=NWu(|`X6V&pL<3`>5n(hmV(IWUA`u;F)BZ!i4>ny&
z{kO#Lo8#d(3##HP{zZJ}d93N@X7D>lU>Lj;je=$azy`hwd@pS{9ZJD{PwwSQ|K&WB
zSC>{;%Rc{gg$wo^4@Nd_v+TFEluTaCQZ72|yW<3zWTL(B&D*T}t0jl&>r2dz=CLd8
zmixE^xF}w&O)=}1T0Ypz6#((?l17y)MF8{T1<C;l%En+r#kiB_uJ90Hv9=+R5Kt>R
zTzzSV>T#Q)LtPlA_Ligsgb*yvRVgo701eRA=0RLvq*NFo4JBLTriEXvvF?U=JIX&8
zyWU2Hha03clvFHE6dBl`?l2*fA{q|yxrgo{9uD!}-#A0nSs8*CLXaz0c=_fy2l{%q
za7>72!rbxrF7oqLmZr<h&lkB|nCE&e%Zyi|r0f++f5ST|{4R;LvV-W^x^JTt#8Y7w
zk~MD4<Zhc<Spbgmc*B|Islnsun$}h-Z!3+S>Law3$CO)O$}RAQHA9z(u**zyG}gzy
zo-Vrj<79?>LLjY8#z>{Mhtb$X>K=cq*XtWf49En3A6)f02Pgs)z!l(3@N*fz`);}Z
z!Dgf2?Jx#b?~c#m_XgN9EwGY`fsrH+erO+mboGt3?*kXCc@CJ}^y`T&g^+XOMJm7a
z=L}t*Vfe#$6B!IzOK!A4>&pMt^Qh6cNcjg<L3Yh!VWP<N)g0xV71T_(cc_cj9Ov!X
z_2-$lrUKxdDD|BA^wp(CL`5mJ?mW~D&jqi-E+gIYb3%Yq^|<-w0;R0Q?mK#j*U3;i
zIK7@HSr{+)<y>u4l}S&b>4GEo4e;QH_VK0vbe_fO(i%nJ$#sZ#Zd3UOhiD5$uYjVo
zK?sTqHNQpkuFlaigTF4qrq1`=dy0^u^V=`IhU2aDwxxorvvb(4i>YsZJwga#sSvSL
zn1OvM21{LtX_L~JM}EelT(VIf2(h&XUrBtn%{He&H#LS2WY9-7T)7>xht+chneG_f
zgNe46yz59Rg{^hWZQi;KQzO+CWA8{WckbE6zTR#^;eZl&8|%Vn+>~v&tZ#{!_;kYE
zz$xJS@g3|1;5@#b{Z{bzY%oP{i!or-PZpf~D)18UiFOX6X@bW;b(rVBFv{%B!WwGe
zf~@gIZH6af`_aYb9)J*FXUp9By_Z;gX_TQ4o}}+R#|ZcO{fgFlK5wn^uRr5f)n#$A
z#O!FEQnrTlR9jxZKR<$TcWDKAN-L?;o<>9M_wjzWi}ZXlpGw|t%zd5mB%O0qrTy23
zvu)dM;$)s|+n#LOQ%%-nO>SzkZQGh`W5Rnszjv+H`M+~+?C;*!=h~ivzf;D!d=pJ5
z8$T}Kg2Y^T5V0CGB2YZp>sS@&OwYZJzFaRWP&+2(RXdb(%E*MPqs1Jbw-?1q33&uP
z`ERQfmp$KYcPxCtzVarqZFE@ya)=2=P*G>hU&IUPd^Bf@rP+a2q-B1?pNSn|#<rT9
z4@@bqlObjn`RN)aHJm#2av*Tb3~BprrAW>xs>L_t%K_{C_c{Pa)}ls!`ex{vD&5L5
zlQqq`IL}A>Q%4gE*X~1TX{cIR*7<2`Q=lb~b-ROmt$wW_=W9$B4Qcn8V%y$qQ%4{$
z+Tz!?$kUgr_C?vgkB<~PKe^odTSKmRNnq*d$P+ESl28tNw3((t*W>!ObkLlP;vGu`
zg#;_Cv?~P;x<L*WhBkycJSD9mgv{ZF(v$+T?YV+bng=l#r^E<KwRwLY#ow%do*r;9
zijlRPGO>N5ZRObLZuIBU-WZ(qmi_!7ln;Cm2vs5~J1Xdxh-^cP==uiNfjwsQyi8u=
z_+nW$Hj#i$XJsedDhOqlL-)6Jj9GSW%^dw7HrSz_Hu!Zs+U`8f^fn#mWNm(_KGVtX
z4-^JGcbA{{FekHSgdl~}ogTv4>EFC6=GP(-H3hu8zdpUrQ+i8+21hXzt4Y!fw{;gd
zMVFm^ihDlX0r!maX(D>tzdbnQLs~hwYA&ql2TcHBmVQ~5vil=*YNW<Of?xo5+kg$A
z8Av1(9ndyR;pA?6K4&p3_-H!zWvn7ONOJQ~kSA2)nSj7-b=vgz#6jlQE_e5ohUEDL
zqB8eih9dM@{WY!j?t5w?Oy;*I024=%el)bV*Yq7MT=)@n)B8KXGOmKK6Y}e{2Uo#{
zfjEJ1>VFxV7ROJL$457G)Rcfw?1qcP+DuShf4;(Fk7v|CaB}Z-0vK+va6b=>;ovZi
z+Xfn&ZpY(MPj=7y1(7sd@4v1mIM#p{m}SE}qvUbtl;QD4_}A~ekb3gaB0XItSc8=f
zDK*pVFM~YCU5>(ns6<rWUT_@6MO!U!JTxADE(9Bks=EvNF|isrG_rrK#<a1UXQ3?h
zn7^VkjWTTi`VMrbxf_k$6^cIXtH8YYCE!E@y85a)5E<L@;Pa`N&o!wvnF34cn1O5;
zP!o2ByMiO!HfR7(As~nV^stW!VlWlLX55iiNXX^ipBL-<`@Ebb8@e?2({uM`PJ}*&
zfOS&4{x*H+{nJ2hT=m()=8UP$2TBCY7B)4||4(U`yH{b4Rb;YkAtLd##&;uas#Rj@
z*~W)Mj&*c;Y_(+<EF4B+WK_nI>y+uFl|02S88Wv$!JPtu?kU^eCtNtP2V76GWWQ30
zV`8~{%to73eN^c^+^wFYhe;2&h5y-uj&OOZRIRxT4d$PBqKo`qyV}{1JMFLZe3D8s
z$0Ayv{ykmnx}t84Z*8&sA?xVIlnpEaVxsHZ{@47<g*}43(?+me@NYO>EQUc-_z=jD
z`Si$aux~>41YoiZuMrr2&r+8=TCDz<%etBA=y137Lx_vcxiO?vG!u`!t)Y^JnYx9y
zFUuJ(V_!{ueWa18Wm>TJGT9PaS}RhDNetKit^^l4>c^^j)eKa$rPOPrSuz68fQ1<D
zTtYO5Z)!KoM}>6Ex#b)BvsC7k@F#rzIj7*)C|KnAKc9TlmUXY6S!KG_c0q+fv5!QN
zVtT`QQDn@@`oC0ktJv{5080LZASU@d8Z9~#kKBK;w1zvl?3uF+6BkFz&1IcV;^&A2
z-fCViXCs$eX%@}W=DoqRxKDtzY@EVX{;g4-yFKOal*q{2{%FzSgTqYkcmdwyGF=ZJ
zQP>F&Ok7<2?v@r}h826cO*}Y4KBZh<F;1*Kt*#s9n8vl3hr;Wp^uZg7P0Abl-w-5(
zBs-3spPg@8<F$9E)y_=I;`7{!{B-%WBuAK@o1<!;M96T1YgSu~2h0eF8rwbJoO692
z&kt$yyizVDzI~mWgNJ7bC2EF-$=_-h!@Oz|<bd=edPckE3y}Cgy<tS~0B)Qm?{}r3
zJc!3;SGE!?RAK+1WdNaQ{S5F|@RB9_uTNFLH)S^487A>>_uDoanip4k-vK^Cy8j0_
zhbfvucvOkF1SUDfDB5mDu*s=)o5(y@;QY70hVKgNcYXx&%W1r6a*fA#6Iuv3jY*+u
z$j4OZ$Wy25i9X&74XK11PA+;biYclCedKLjatvUASOXCUkPDQs85tC{3t%A{LPxLF
z>DQ1zdjZp+<QvH2ZwB6r(>Cb_IAhQ_v@sc?U$q4=X>x(ziZHB@#!~wUSxJF2EBU!V
zG0<NFksCM&0rMD#mp564ypX0r%nF+`%;uJwJP74|ejt4`r-%&($8@kq$4d9_HZm!P
z$@y*q0!Zpe@iY?a&5Jz;ZDd;=W)e^SyC~d-xe;}YfknMMSUVR8e0$BrcBN49q63O<
z_1nj$LUL95#|QVj`Kv%wR>ST=KzPEz*DbQzl>N*5-D-4!vkk-fa=kr!IDz<ZM#Pa4
zYx}X0UK@|qRLh`4<L9R=eVZw}kn5*`8?D*;4xhCvld8(pvZlUc!*Rqh?^bar1_TKd
z3D^h1^;ypq_<WsfL{H3x1vcJwAXs2~PAEO}jYO2vXSHvuJNr0L8p$agbZ|+jX9%Ee
zHdgyskzMyl?ss?$4p#6oO+J(JDBxO0M3~qDA2oK?L$^a!A*L?Vcd6aDZt=I?-Jyr1
z$V!1$+%tTWR~(DkqH5{PQ;aj%aY@kuM_OQT;Njm=0d>jfbdAP`d)uscb4SU`-3@K*
zdDA=*>O-TjFZd%QwBlrcjSm)X1@a@O0&W+$u`TkTJ`ZmRtuxc~ld7%VXg<?{sv0xF
z0bG=o7#=eZD``||q%NHz`85&h)ghIOgTruYH!zb~<1H?t;yOs85W5Sqsy#w)Gu|Er
zaQ};R<E3#YDWg0K=Z-&bd+T&rXadgXXwwFS7F{j+zsXgk3+fnI8j8I4p6(sbo>l1!
z$&;UQcqc+5AHOvHFmnq?Tops7je?U9r}^jWyD~pNs7$j+_q0Cc_D}vNH=>!OazLh)
zt0M%oKwTgzEUXWI%^Q4$mrFxxTA~Pa@LjVj%;7o}M0e88_RbyV8$m!=0KCIC8W6wE
z5Bfy#BW0VL0xwZN=bxJ_`+O998xwxD9OtegiCM0qr^xC(x!#!~<2@sE_b18~^C5Al
z?h;rkAve{4F&@VHIBl5lp$48?#<sC0pKS}iU=rIQBw&u&aNPp7Km`rZ&01t1T7hgw
zizDM}rTL>fb-ZH-C8xZdJ}KaWqU~5rj8j{Gv{Tf*RCiZhLb+&k_ashBVp28YOy6AL
zKqwY73e^_58pjZn3u_HG6*!mK>Ezg#K@eDa6?-}#e~cgv6H!dDr@yPloG=EMRRJ(?
z)W9056zeoDRs&Z}tr=&R0Y$253*)4qugBfN9WLS1s+#DyEizCa++WEho=1N>Tdk2I
zEG!-Uy$c?nfJ6ofE2V7ZSS-5g&%f(cVtnY6YdZ^q>xMMpI8dh`I-Ko?T|2~DshQZE
zP}8p{kT`S2FJ0oU?cvwv+!5Mg@vF%Vg!T)~e`)4<KwSR<u_Q350PBss4QH)q{sY15
z6P2WBF<{qmEXh%8*t?oLZWt#!{hJh2+>HMjDIWqxg)q@_jwFyXcK1K1<wh8#kC?NW
zKyfbb-lPcYsc6{{;GbT^wc=L(_|TVcdCBi?Q>rj@d_L{2+>J(yPs^`(Qf32<5dLc|
zK)x<(8rGn%D~L1i(PS|$;#zuT#2Cy-c3kCKWaEl>DqBXrvn!lJ+}>+ZrMQ^-vyB~s
zePPs0L6StRWA|Pf(mE@U-Yqydr{Bt+elfPE9xb<>Yb*ES+w=`Tbrmr4#7UuE(W0a9
zq?A-|<csHbU(&KzIJRrJcjBkhrc-82)^65_;XnYzh^6D-_YwLezj^;uRcAk^AaO`N
z6RnP%;OB0fp;&qS35t>dy(2%6v>hVZ3ky1Ax9rtZkP+D9;`WN-HiTK|6V^3pkP-y#
z8eav({K89DUR&%-GzDwG%}~~4)g^I<GU2c$%af!BbVkq>5$^KU{Kai4S3jT!s2I~p
zKVZ#*WA|bkTxmVey4D%?1%o2`%qn$HDYlq=gA2CvH7}C`h$j{OUp3?^wuie|fFWnY
zE$s&$oylG_T20hW3|xHFo-Mk5pI4s*0%Z8Mh$Q$|EZlE{CJHwhyDrMf866MkVx-x|
z9J`0hTL|US$O9|Be<B~UiVzi^TkmiR`QY0^nu^>p2CMY?5XarS+d0(=lJd;2jUx)g
z@hO}eQ08?4iNLj84?($lRycKxmsy&Fg(qb%#$qDX-#A{!kP7&r%RlJa3K~L+0wS%+
z0JNUuc)w<oQoz%mGapTp$(xJq{WnuQZYJS(4mY-UU}-G$c{sp+{Dz27lk&zAsNCHF
zrmR3dgT^$ASSQfEkgW3jOCZPez(G~QwAk)k;fq>+sGC1x7@^%%<ITUTAHEBaZ%Efd
zJ9*$nQ0DFQ!D%oem^j8*&lWq|bD(sQz$7dKLH3U^VebspslAOmHM=VI;5;dxMs7)s
zRspnCNmax^DLn88zt8bT8DQEYno<;gn;v8RWx(q5qZ7-8%b}ySjs_Zi&iy}<j|@sZ
zhC5lS-W+DH_@8Np3F*NW{THI}JSC&7N;Y5r=r{erD;(Oi@*Aujh%}6p;1G<zDaQJJ
z(DtN_b+vDT@+mVa)^P<jTh}%*Y#Qht^w3%tXivu^r0n`hd({Tc5WOjSWLMP+X4247
zmzP#vMn0PY6=;QALLx!5*o_qp`deFl8MZHjldy4S-dJf(ON;d{BLD$X;Syb|_M&EG
zK_uKQ?a($clZdn_4iC&pgICK*<uG^X>6Qc>45!#VMwKX|aK3YrC}WcAqZ>GfBh*QT
z={0cG%c%kXjvF$q^aBWRkwmaW9f$lXH-Y=i-I#iX%Z4HC*vE5>S5mEKN(rh0;-pmq
zO6&m+!Crh46+EwsDs1C-)F!ts@f&WV32x+ca*;{(;K4~TYQB+QJFU#6h@;x(Jed+)
zrYLyyX!vyslZ-6&+>47DmO&j@F<yM%@eTEC=A=it=DZQ6AM%Ko!G{x9nhHh9@W07r
z!4&);!<u75BK>}LXS&G4yjXrHK{zVd69^sv|19~|1*NA5kCz<)5dizldA;Q!MN?vG
z?HEJ)&nn^i^F6cHb$?<n>*x2LCyXhb2J=pa1c@g$Q>yJonjn!Kx`fIp3Se}ob6;^b
z*C|~t?H2yho7b6#>UW6O{ic*F>4UJTt&@a@7<sJdR^ghHuUntlnr8LrldDZ5Z%GDf
z69!T2J4Ss7-jSwE3N&a$8p6QQhyRDqa?8zsgzD?oI~jx{s?XBV_a=o%mLzJ_(Q%~(
z6=JBT^nmNjhi!EfR1RHL2SY%TkzX?_4MTPfJ4JVegMvc;W+e|w)`0gClnx0hU6K=V
z>891uhba3YLW=B!>Xy|UjtmqDjUtT?aM593!!LY=R;M(oDz?3@SpH-^`$T2H0M3&2
z90zICTD!$EOcqJmRaIa3pycX@e(D_ttu}T!llqml08z_1rr#47{_V+bsI*a3^73j$
zrwoQ!6}NBZsd9HXv0o9T2+q>Gz%Aa%nwqlMWZ4sjQtS#_AvEgIc<hZ{BDv%Z(0I5|
z%;iZ|u@4G%>73Qf+Ix9`Y-_|n@B5ix7#!m%W;GQQXOq{1MC!=d<s;tLYqr?|e#A2l
zPs-`PCFcm@-<B9v5>e=YFv@>H3N+-+uBYv)d%0EuISvcptf7wBr1UZ_dtjgjXfu~d
zq(w`4Wa;+)Rc9Rrs>nz-GU#YuYiD?7=6Yn{d1mIgkFfY)-C|VIlrLf#UcW6m3%8-{
z)`2(~q&-i}zYzHQ!}Pby!@wf@_yW>wHw<{<ek4m-dXJz+Z;lg)5BdPy{=o0sp2l*Z
zo;DZ}H7sNB=kDNnk+#i5871dyFV?_|JmI0*k9o&09^~x~hL&@acL%rFmkHmUI2WX}
z@vgG0MFeL!uTp_G<RF(7x|H`>gkVY8@n-4{Y~W=;?(+h=twm&}UU=i?_%$Qg9B~!c
zFKpt#B3R(G3j6^CBR~%Vwv?M1xEr@9r-^~@$3ktIcazq$V)zT#QC9yra}JUegzSFT
zDO-?V)mh8btNswDErW`cRaOq6Fouokddalm&i^x1wej%|;WauhgD@zC<Z0y$ewM3M
zcbuB(wqz=rq7JYlE=Q2!gx8g?*~K+>%)*7re@n-IPAeHhWgCf?^I-XjlvQUvBc2*M
zsC~2qg!l|1JzP~2V<cwumOowYWp@X<$L;RX0oJ>5Lym^>L`~F-bR4^s1}*?OlQtJq
zZ!`0AmbqE{jX+)2#qJm_T15S88Kh#5G@n57t0Ju8oBn(y2aZvP=Apl@+1pAvXJnf=
zr-F)}=_wy+`xy$0yaGp>9?)i=Xt%%!R-uBzI;_wSbWa1Kdl>PZ9CY2dL;lJR9O&th
z<{P6t1Z0BV=WL#r1Zz#VMg{i`TmT7l>xvD8x~6a9nwLa$e@PQYHe#KMVcw$*&&rE7
zQe|ejwRlYK^?i+v#kKvO@RjL+DvjFteDS&R;Wxi+94r-^I2sB(hD_WCcqn9~7?BXh
z;dLUL?_<{e1AZ8#`;OBv1r)?HTma8@H>w{rHxEP;1~^z=?zL91{UU*MdCT1gdB7_!
z$<g+w<M!UEohx%3SRUE%;cAQ#ji-`%203MTgx4?u1jTbRnVo*!5uhkigF`z#16+)}
zZl0upFQmdF<&jb|VfiiUlssBG4cEYE)V$CP8%&nId$L@WQN(Ue0~lhA$>H2J$5=<y
zx=loF{qlW^1D~{d?R#=#l2WPiW?D@O&oVD%$aKZJV__nvW5_`O?M&9@jHkwQ-BASN
z3g)zPjXEgId7Bxq+gg>=Sxuh)K!_LSmHw>x8)2a?7DXoeCk;t^j}ROP*;my3H2HlQ
z*hG_k08$cQ8_29x`jMkE89<BYnx=hQ;pQkd-tnrhxOlLd^cRuGpfvSRN_dULH&!-=
z+0bZG?d{~@3oZ^*z`b<H(^U*`id_e#%a!1r$ljH=E8W;_zj1R7n`}%rG`Ctb2AxYp
z+f6v_Yy~$9Vz3Eo8s9H|t*U4b>8K#Hx7?tRrH@Csze`l3ZHgmxu_YO-x;o)W=~}P4
z=gB>aak<ufDv%=Q%qb+^^$c{4KFXzcy%CGsC>*GV*s0UzX7IC(^|(B$u$l^$l~gJB
znvnPX>0NY~ZVZC%e20-r2ygk<MOUUMwHin!!EkcrKpca#0sm&TlLz*Re9ip@f}0a8
zs}PJOfOzlyIX|>XQWg+rzz~2$80AI$Z3VHGbC~8GqA_=c6vJLm=8B>`e~>GaddsZo
zd)5O26rF2^xZKNX3Ht7$^?uT?J*e;Jkmr0qZg_l<>l-X$R&~b>tXpOwjgM*#WF;F{
z+A5c0l6aJMy-DV7f92Pu=7*5x8mWdrQ;#t8`fX-wK_EJXHAVAuyQ&T|J$JuT6#$!c
z+jf2NE_EF|(DnNp;wK{&(pi`>i0rJ)A2yj}vVmKb;Gmj}h{J0K(wANQH3G>)tj@vT
zwNq;EbZ$v8HYo;Zfjw@o_V=mNgBdYTiyG<z*QPgTo7MR6LJ)k(4Q=iyQAjf+a2}lN
zjq4a^?aC_h(E<8gRK7}2_Tz9~_aopST)?EZdbi=`@)HF$X|9hGmJ)|nmbYm**cV3H
zzCplgeVMVx^?gXe><Cv+UG~}BLC!EPSNkVm6*PQRjc)4v^f@_fOt+$A)d9~7^fk9b
z81Ze)&uL=Kg;QJfp(FHvJK9E6X*_ZwK5%t|d;94h$zX1La8s!<xS|lL$Mdc0)yhKE
zCazzqU*I(t4^@z8zo(aNHse@A-5BrL^I4=f5VqwEA3Pfbmi0YIXD1Lg9){LhuefZ*
z^G{^=3u3|@;peTS;p?qJp03uPco_AR{>n!BnpGW?NFQE;(-OUe0@!c5j*$y-Kd5!~
zvvLmVJ9`SXM7bXzjjq;`1<`Xqb}{|-h7}V}V>rFNLs~~wAx+v%Ke$8#8KO%?X`?3f
z*J&$Oktk?_@u^!_xM)g-zUBXo6&=|!(J+>GQ=VPc1Bcz^EjT&O0#RX+<3uONlpV`F
z%%xtIvT}&fWP%t*?Qo5DQ)5|oM;GP6LY4*V&Q&f^+?`j>scSMnTASE~m@`;mofceH
zP1Ji@^r+T*!hv-?stk|BSNrj>5h~f6M`X}5vVURhllbXnML8{9J^|D3>oTowDFVy-
z9TCdIw{l!*;<6iTB`d|~W+sY1xyKOove)4l_xjWGTtsDdbhAy%b_9HY518J8+43v@
z*GUcEL|@9vCN=PvR)+L0uEAV>-{bXUF&>FwWbnM>VUxE$3Rj-n@lA#FNJ+_6{rY!9
z)@|2mdPN70dmza0dYUwSUmnfO_-^?-bv)&)!H$mtBzaX-{A6YaPeq`vk$=CPtJ-t$
zCp_@uE$MHGqn7u<AVc?T!$5gErQh)h6sizWQS&m~p~bLb9>hn&&fo44K2VRQ8kqYF
z&2{a~8S47GgHv$KZl}%1(B})UZ@kCdppmc~yInOQGFaZz`@tGj`UUi3wgC}aJ3iZ<
zL|89^lP;_T=ewR7i>pI4aMLhbMFZzbHk0bBhkr)GuRUOSAL~y}PiF12?)Dl{TI}wW
z31=f*cQd0TU}DeYyk(~~gj?7mGVooyCmnk)Uwv2a4d0)p=INnYPfKN?4CZIuL%paJ
znJ|hNH^sH;W4q)@1y2mWj3SkLWm!|njv)QZIU^{L>+LFl#A1}3ipv$%6ICv7YNTsG
z@oR8Nj(ru766+*Fa!;P4I1aAZIwyg9Q(pbG;59j)iCjp=MLiRop{(ACMSaH>QO}kV
z7av~p4GN_!cSVW<^G5DVwqR<hey1wgp9gNPz@Luk&Q&RU!DWv(R^9HwXO2u&*FWCp
zq++#fll{m%eq7UV?m+PFpZvVh#pGSi9(R*H6+oFR1jkLClG7Niv6Cx)HMN%lPf>Ln
zH1qrH^mKM*AD3J=vXf!{0{~b+(6&=RJfNv>WY%HNVE2NPbz`ovEq-`UA{q#HrnoNg
zq5jz^Z5a5jw%6s~?tS~bYjLfXeZ)ASrISHdGw%L7(;ALuQ$THw-0{4~8fiC*?g1QL
zU5`+;LHsxQOskD>xzYGiZ955h(0SqT@<-J`b8fZMvvm}zP|i*{D)nmPxI`2&2h?7V
zFe>QX(Z&Son@lv1BskcIpcCx1Rx>{XJ$AHuhSKMxFL3hB-u~dJW%FQfXK|K&FA4eM
zHJ^1@D5z9RVwSf$$U-RzO29w|)v5Gf;6b^E8`UcQqD!yRG8tob8P_r0V&qXSGZoL<
zetN~+G|7FNP!YP(Qkv!YsV&N-kGq^W5s&RxTYeI(EQ^jBd3<UNEmFN#wXUcJhA4aO
zJ^WXpoJ(w+|0M3kwSZuUfSl7!fffq^GhskxAnCr?_e9oXcAHCtW>FHjR=hYxsj!AP
z<^RwGyz&_<6#S5_$!PZCoSN+%<`wqwxabrUkAX{~w(P`kUHo!XrQ?xl^O%JX_{5zj
zCG7Oy$GB*MWT?G{xOi!~Vr)xp?^u<{BoIuB35L<6IS&dD6NF!Ezb`u~a<KiHUpJc(
zww_tGnprGKmOUHTCrFGE;pt)1z3QlEudzR$X!d2Lc0(QV-uoBta_8rvfF(kP*VyoL
z9&-b8l{d;7@~Akzf9;_ZaFHq0d0GqKj4biTI!Ho=#Axg;O(4e{H0JB0^47YMWU|Z)
z>y=tjtp@N2mhcJ*^pq!>bh*F70D`m2geq!%?7nSrOVAzDWZKC#uzJR5Y?#ctS*uj<
z2?!*c0dbOvMrxoZ>{X-di8?h-;J8pa>mK(+%r7s1VVE8n*njp!1@xo?^v><QJ_vrK
zq8NEnHBaoX=*Ap8biIUeN}>6SR4c9^VZuwYPXd71Piv|}exj^+8cr;P@!!96uq!mN
zm)*-(xhgcFm3%$~ei>g54EYoYeYUYU5f8rbFtg+~Jii69-rgwDc)wE0fIt&D4D{dk
z@1RnGjDk~pdYFB06hI>I&qhH3Z#9zZ7$t8V6O>A%#>)jPLZ775*VWTTWl7D;jTL8O
zt12XF4#76f(%Q$xf8gFhA>@>z={VFi;ZX>X;>W?{?V{;Sr`~GeWmp;qswp@C)dp}_
zOU(6DcG_d13LWol(&fOBy(|y!a9`LXNiE^KaYprB8_<q9W#eCJgCN6<b^ik^Qf=N$
zf?M|ss{0~CKXuLC_nEQ(G2ezSq6RZ=AUeFrt)vaO;^wnYN@zEww7!TlBm%D?4DSA8
zA2rx6k=|t<!`1@@>Dla)VNQ8{M=mIpe)PnhwfDQf=BZU02ZdZpx~TKDw8uPq0DlDp
z2I|<@!XqM##SjA4;n_<i<S1?IS54mo336wy;hbM${?1tl7t@FJu=%?=^HwEZE=iZU
zwY9lNfRI4715V$O2rQt+Egal!SDF>D1m1Sv0VM}(Z8Sts!j*Rkw~Q>JEAK)Biuae4
zRAbp1|G5;^VoZFYy9HDizioIogKZstsh|`Rt>Kz$exnzK`j<iM=@PKR6f!HuQWguD
zM+tVyiv)6W0wO|!9ld2or=={D=0wX8>rDb}xVo_#(yZ=G;C&}LT>}+e6E&SWv+(|>
z<cT5eNwNFTK!x$2zZx(P0j6L8gG%pukiEp&;1HcCp9T58ZuW-RXXT*(ldiG)?ft&;
zZ>hT9EPG2Ka?#9c%wDb3cTNRL5`~%6Q_Fn2px|8c2%iXPS`Oqg3iF5=F2P@4(7|bA
zx><_vodi*b-OCro{>sT=0mGNH!_3Jkw(J~oqp^Px!AHSl)-lZ=jkcodJFnQ;flrP&
zFY~NeFXyPG-mm@isy4{p{2K>d1Aqyx1x#T54WwuCrr{OToq+nq>#qk0=#ESmumtSo
z2@V0s&#qFy1yZ_EZtvYf1ZVt1b+0Okt6{WG?Eti#F+$ESwrD$Y;J3`M#K3_uDZs?w
zqv%1UJMjElpCTvuHKjyBk}oCob6wLAQop|HmPhL?i)JOTJ`(kFBuC)(9y}?t?&_g7
z@)RdzFG<p&$sJn6k%HvUMMsW~1G6lBg=Couc-@}hj<=E{-Dfq4<4g0^q+J$hME_v2
ztnK)UpqMd}JZI!b6m?V>W!U#0q*=HM!*;5V&DASd#hCQ+lwteT<`(Kfj1-*P`>*~_
zKLAJ&rvoAVTVUK^xQzVWvX1uE9y0sHv;9HEA_1ohM;mYUgK|auA2e%ST+m-ml}yTu
zc+52DPku*C7~>aUmq+OTB$Y3zf%i;}_3bnX`Wh(PRa<>neE%lo$7eNzb;tV|<1hGo
zM?=d(PLq+vI&BAQnIS3NH~$U<^S9jf(C2zz*xBXARbZ&2118`JeIwJS=v;dR4K1da
z@)LlbjBRul!V~@zkbQ3qr@3nJsvF;$?M(rn$2)SRh(Gil53lslRbnBJyqsWD(axf~
z0%*~c{4qDt+9*BEi+frFDiUZrk`k;@=?n?pg^xSBx5rKZgVRdEc6h_ywgym=LaUq7
z1#cCa5mV00j<Z;G41@Vms`k~*?rib)1SjLaWSyCYg}ZbS4pkeDA>vIw5pD|NXtsV`
z{ELG%!3J?xyt(2fy5xEzUmAEPC(8*pvRZrl<^(h<Ps<*;k4p+{KAdax|GcCNclU4@
zG2ZnHFAe%X4bJ>okB33pmx2&NoLDXbTOZqpbwPgSe}0FE-<}%z595l96l%$%^hCaX
z5N_+^`M5^F)N&b7Kmym^`h_jjSyv+9Qcuv){8nzE(d6f=<(Tdsj{2=t%_OJ8>gvW}
z>#kh9;|Vhof8`(&hUZL*MM4?;hn)d9+y7@|>{P(Xf}G25>YIgL%o@a&IFS|Rqa%t2
z`q;mWvb3pg-k18GOy19@-eUVRVbBsGn0@;@S&OiKRZNF9svRT2BvaCqGy?*w!Rd8m
z>)<Y&A$oF7ky30mx4@psKz&e~L*|?H?obI>#5=pq7nF~A1xrgSUT&3L(7WcJbhmuf
zoLG#ws{*FEoq4gWN_WDaXW?AiXrim<08`k()07Zu`INQaF8k-#<>U6btj9m{>qUOk
zoL?Z=NiabuOLgNRzYPg4*v1m(u&B^DK76I74i8*m$>6YZ#;<el>~sDX9M7#Tt=U^Z
zDVkoHEP$~YO8@6UE9v@3$tMN~Gkcfgq=ehXH62HkbGe+&CAXvv{1z0@g88S?BijZ&
z&?&;UkK<j#2U7SdIvEfoS<oq^0ez>TUuFO6Ej_hs7=TST4E9R(_Op)745!IvdGtdc
ztj(yf09B*VrH~J*)FV+5|E9tS9M|P<rR>eEfO(=p{hW|lt{im=NxnqO&yfI<mVNTE
zMGTJEd42r$iIQyGOv8*~TP?!GaLq!SowXRNF3sIHo!IGj<*exsfR$l+_xKI21SX8~
zhIp+8ZchkSc@0*(LkQjtQd0}DkG{oL)pGoP^&Z{sbzTJP{V`r7a3`gO-=6VsBE<Du
zvhue(z2W%vS}FLudjw%!1-?n#dzp{-n=i`UOyuLd@K2<^D7~`r>}<LkJ@A>|Bw!Hw
z!-%$n%RZm(J=<Atj0oZ!$D{Xi>G;>8UIy>?P(dB$0tcbjNW$NnYIwF!efW@;G-T1^
z2Bal0Cz_&sTEcE-*qidjB+-8SY2-~?+Ejf3oEZ4|v;&Vl;)Ds}yHR*|hblg3VHOU<
zaf63omdUTyKf7OYUh{VAddmWCS!z1JPB$(e>9GaDfJD4g#1{6<t-)MlJ4Kd!P5bdh
zUC<~DAUF^}68V{;Q5r#d!I>OMdkZL&31F3bK!#AHf@f{Z6MMn7rdtUr-E}Cd7mE*7
z0>lRNBTma45o`b`!?m}@JMLedU&5(f?NmYC$C_PNwot5Ds#PV=sCOy|TD|d9xq-+u
zaVBk3l{{ayj&L$e6Sbh`-fj#zB_P<DcDhijR3Zxc4h_50Gg-ZO8<rAZ&iSZUZNv56
z@DY`i3@5r;{h2r=^%+8XD7hGe9_8w5ALf(L=<_+AqoH>wBF|JJGgD!TMAbaI(z1Wu
zPVI+kT7#AC+k(=Q(@{?1Iy(f^wOUVl(6ULk^oIthN9(#e#;A`Kz2gEN>UcZ#uUg;*
zXM+Dd8LR&T4Zso66j>e8ANrA4=S5$7OfOxoy#2_UA=|_~IQ9<}crNhYcsOS9f!X`O
zS>bkWG4%;W2r5vopxo*PJI{(GRtMvBWm-V{UcQt}_@&S9xB&HTCkGX%r`eHQy*HR$
z?kf9h#qK&e6l#5KDRx4%TDbUF$oq@=H~Sx=EA1{r;lia$)fNtM{n=8QS_^Az1zRZo
z9J-fa{g(a-JU-D7hv}Bbn6Mkvs~FM@iY&Dfb0ru)r8d%n^PMEas+@lmy9Nwr{a%pz
zp%#*@YNiTb6K!%Rwt3uwH`bSejif^z(&OQGRhK(Yw3fYB`!*l>ToQPV#KD8e>=XQ4
z(lxE+0Kl^?v|r@ANw()6YSQi<M7QCQIl9I;?B}d4iP})$##|9j9CkVNur|@`+xu1N
z8Cp{jx5RIB?J*4CF5|w}EoP{?a-l$&2O*R<*y;vhyY=3m3isYsBMQelfSHg{V3CtC
z<sWN!HMxY^G}rl|fHxheGOzyF8tc^ULT=lYVmN*64w%St0oqmH`MrlW1!4_Lf?Mkw
zv0@KRY;`UBSAWQ2AWOFH_sDFyK4G4dZY7xDftR=+opdgBUY1JR2oM}Se_#@=x~9Br
z{Nr`KK&sXEN<0at4@9-rKp|C!61ZDLFykTmxSW2x9Y}`%bD<S_4iSLyoE_ABfz`u6
zxicM13i<K*oYLDY>>M1q!k@BJ6!@a}U*p`tQ2%dg?dD#b6>SE|q#7f?^a<oqvz}u8
z4H;Y&2uRo!G7gONvRwN3;XZXaqWZ?WVMY_st;P>`tLjUAX>foRX#o;^nyaF1^(O95
zr|gA&1DYX8x@T50^sB;tKWH!gfdw=e0@}6*jmx3|G<fK6)Ng22=;(OppInqsS@bhV
z+i+;lFg<UQjjmg(e1&Ixo8>rP^`Nux_gp`(Rn!C0w7LL|RtZ!1H{@vz=H-mO{6bG?
zlAAGSDKYe}qv)%n4@^{`*v>sNZRh5y1hs0GDo?3Zq>NxU{6+XWw)jPk`m^~$8`<r5
z3Py=vQc7F!%o?vUukQE4tpq}-X-6xXGm(yTfgIdWT|ZbfDp4hFO6-{wD!bM<qff2O
z{$T-+EBN15d85~LqcgqW0Xw8ZBY_`B+Z3cb`dRO4q-F&z-=+cXpBJCx@02nrRM3Qi
zq$nM<|1g)>O^@{UPD2~KDeSm5rvlnlOch&xGez!&3iDUH!wqDSq+HbvOneH839ey#
z&0G>88gf)7>A1mso23wplxsQV%Ah!FPA=Ps2^)ps`7jEIfuLW?+Nx#JJf$Rq>exsc
z;&g;3K7c-BpoTl;2L#7AG?@%_1kL_uezoj_w04Q5N+{;8^ddX1>R9MIxTZAY&i0Cw
zyqd3VN4!cK{{nz=3$%jtFXBN@q;ETZAr71z3Q{msV3A{_bNFiiL9X_uuk|R?@aH#m
znkpQF$ZX*1O89h-&$LOu`jpR7wqD;rBORoLYjfhq3t9yA-1Q^?U2W8hm11b3hu<xu
z#HdKlZ(X87A7*8E?MVk?gs%GD_G!PzbzB-Wh}Ok@CbzIeWnc(Fh-v-voE_Q*%W%WU
zbDb)WL}!Nsq2fgCRzZo7_(_@4#+mlH``glh7<ACYqiUrMR)k5GW(f%2*p7;N$5d$@
zj2~1MH^N1VZ4Nvjv7B%vA0EvlXGFBtXb{Va*-D^Y;f7)KZ96?QUPmliA4qG@c<L)p
zdbeQn;Q&$BnVeJ5{OR%TE1|Itf*{6GQC?>(s^25jJkOoJkA2!5t311pNASis=ysec
zcJN%BKI)A*<u$>&^!9|UeP41wzz$PtgOM<FQsOBoZ@_?07V8gLpjxR+cSNr#`&aI3
zeK^yBY_y+uv}uWSSIV$Q6%JuIS=ob2zk&IPbRkbFQ%%+-S1osiNeE%G2A`3W!jvpB
zs*%c{%YL#SVr7RX9UobfXSFZ;2vShLGeAb&ik~7GvQNZ+8yYeyVhU`J$3SW<0j1l*
zmMXd(%EV?1hE(_jeP&_RSUEJ2P?mm>77Ks#(~o*xxds156z2Cf=4bQGn*XZ4LIl@b
z9Ax;a0Hb2|t3~!!);<YXyHarM0HpSzg3O`SA%-T|OW4VwIYfoyY>kVng-8hB0ta>B
z_#9cF0>u#~<slIipwUS+Ky<N;I*}&hl;{Z7_RV#YHf?0N@X0w0;7+qyN8xL{c9oS_
zX=%Wc9XV<l2@C;`<$VF?tN-40#VL-J!`&L?QqXN`n;oCQs7|jV1_Dn*Jl-d7cYnuU
z(u_qF?$jW<p95KyS>yu#O0_rHL7hY7?s*`CX`4ZH#FN55e}a*&t-{}(ScA9un7KU-
zx17xyEZDNda#+wvrDwFJTHX5OwnjtT?Ni%Yz^*^m*|8{2>anXll$1tt7Q!b3lJ7Kx
z#FK<s;UsgQ76zeM;;rNqwzGnG3EVUh+lnrtWN|`Fw@ht1Nx-6c(HoMn!MN$@MhLKN
z)KYNN9KaRilo4`3Rlr6Ds8n6#<p;LOMmbt`y5nv&G)3mnFN8L`3N@lKZyom9JDPli
z(8n@QrUWqY?W&k9Eb`yi$*_TYq=5e)uUmZrYQQ5eA_sLTC>^gm&FpOqBesE>W=O!&
za*_+TOc`h%z(w{k2HD0jMB_ZHN7R@Ru$w0037(LkwV%O?GlU<t^45q?);OElrmzY;
z(N0)cY2kw-NX1^qbV>}4&tqR-j_2=5?nR291^UXubYo+5qlTy=NQJeS5E(NB^*St?
zIFyRIe;Z6XNF4Xk@3Jnkp%2R}?)A<8hNRK2t|6~MPBk8;j$cA#*+J3FL`=)Mz$d&$
zB^GJjY%TMn2#XH4d$F>FZjzyXx!H){2p4rUEcwWZPKMJGEjrttVo!2r)8YM<C44Wd
zL0VDMi>*F8pdnJm!b#)xBtxe}MWu@D!1lvNYk)6snN|(~QZGZBimvEci$~z2m~;4D
z9GwI|+T|Cc!~$9`f$kBJ7+@%z<%|o_+AkEGmX(MO6q1trHhQ<s-;#hTeCvG4>jaxs
zYJYjt+(Xi_scOUnoXUi5wv=3sdXwK)5smidsu87Ixta5Alq(rN`dO`1WN#>i*A#d=
zm??KcdjebRA;FgLz;S~~!9UQiF`v;(i1RqH1^5f<rbfCrDgSXS^v`NemZ$={7vc(y
zNZZ-cpUs2{%$x>LBkrP9CO^*Oe@KT#)5wdVhdK>d2c?~Qf3Dx$FJqFE@izd*87W^d
zudyqLkuP~oOJQC1qcpVn`V}VYECtH*rDbGE=tw{3;Apww`)hb`33#!?_0F8&vqRJc
zWO%W9J<hRFGm>J;;c=&_mFYgTk<`qr9kX`*@h^Q{SaTVji4)Qd>26$w8-fgUB{LbI
z3`Q?O=?#ajwLKC{-RGYuQ4+fNaBY`QoKc{{`{JuIWtQtmqko$?xW7~+f$vhTa?^nk
zt-Z=SO5peU7NeGjQzfA=_*F2RNuqTMu-iMMUaT*h`egFk*YJW9W00o5rihL1Z#TJJ
z-JM0OT>pQ$pSP)WEUSn=7r0)NY>*l@e})vQ);V>?@e*Pivz1f4<x<Y1$SC5+&5eLo
z0<2hU#`kNsr#dRVoGXUL)wlwV#DeGF(Q`L&_jeQNI#u!xoU2t;2UJbm#P?M#atFb*
zSKhi93z;&c>i%F6RtKp?ULC3>1hPVILP}FF^YlQJIEKAfpe@5p`^eGS+i?&U!=PLV
zO&Cv;O?Q1DO?NzUjV<mGP-?^dTEzOi(Q<KfKk<8Q$h`P@i{)f2h4kMuWdh<8jW>2%
z*!YZCWG(kA#LWCH1e_ES1-h&EoefQ?<Bh*MM{oow%tctA5hE~#+RM_lf%5@#tB2?T
z)^eg?NGdLA;tiX=*P7^{q*h2$pc~wPY@4m=KGTfMB^TNgqwXpBjnn;+g7k`tG~2`y
zqe`TQRI$chQVD;cO-%4=r%@3sYU;<5KET&6i=oA5uH**qS2b>O79=WqRC9ubIZ}nI
z1(2)(F1k38;z}U4Z1L-0p>2RP&Qc1(hr{1GD_;M>BwPf6<2Zj6LjBL^xwdXny-?l9
z{v0QLv({*xiyH>9oScb`jIA!Nv!lbEMgHkQfSs^TmIl@k_JZ7=r<1}WBOb6gaU*pt
zw6u8{UP)H+t5r4RlDaf{VWGR)9PBR}8-ZP^%q^er?pY!xPm2jnYNJk#-PUM?VIMKS
zbLEhyi@15xc`aT@1OT@{Fo|_t+8~J3H~GPVs=U}{UGfH4y-+u9;PSk#Xk~`y&m#V5
z)NxbLi@Io|k%Dnh)G@|{#|Cg7=g_IjVEl$s5`HrQy@H;Ttv;hx&nL1{g3tmQ3O--Y
z<Tl)uQYfYRE;IqVbD75k7@%1T2_`p&>_*Y=tL685W6mCgA?Q2__bh%E1QTeMgbp%c
zOS$|89i(>WbWJB~XZNoNjW=GdT;D7|P-oQ+MuMZdn?i7V?~!Sn(3RQAZf6NA7kchN
zkfZFpd;11oD@K}Ej3P}N69Wsv(n?^AdK+xzS%i&e-&C)n1pLQ$YE2@61}&hj=+_?Q
z`r{{+B8>Z@7t@O9f|=6RSAXGN%^W@TD4{&-dn1vdIsF|i#El}<CSxUDp+s}&VFPsB
z=z#WZo9%j9XUVtj50nd{wO~O5h>-!_a3<I$vVvJ}YVlWkQCgDy-CcWHv2H!#pUDTh
zDB8Z12O-&4va~dbU5@@g<E+2y8B0IgGZ$-wJ`TUuLM{+=DnL})Fg~fm&46q5Wq!>@
zMAQ)qY#caJEcSA7{N7ToQX9b~Mu1sB;a%HgIn9VinQ|YXd$o)p&g1oVN$dT(n}8N4
zp~nzd;-@6cP9}YUG2jE`<MpCyrXspctUTV$r6C0X@SHpMiR~j)9B;eJ0eQ2dc7PtZ
z*@5q^_v-K^^0T;mvylYma$5y5pM|+6SUAYY<9azLxY<i+`!|K4WI)#%&_Ty4WZdc{
z0keRezF`EDowKZDNjjpJEjg7H2tO?P(26vPRg2m9)yKkEe39M&wJ2y;VD4z*Ftvc}
zGw-i|xR=F_g+S6uozN9vwy$77kAu7Ev%Gtdt`a70qI%=DFE)vHPqf5V6kMo%)RG0C
z`5rR&GoQDb`)9K3s&4a!lKuRqMlkLcgGPlNUqWsG>s9NSGsP}ks&4o<lf=OiNz3|q
z^SfB4zqr5D<<ubv7TUC!2F5UktD^wb-Rs5}r}(}Y0e#<8GzHd|DB6B|!6G5Bncj*P
z(JTe>a8ZpjYRB(TccjXF_BTCosvO{LGtp3C`qA1U>P!ku7?k)*=&=KA4`>l4&q!Wy
z0w=pZEWq(s*|1QxQng%T1RIBbc}%?;p~;MAPA%Ky3+FB*#PsC)+gmfv%WE})un)sz
zj=zb~*E53hn&S%S(qE^YO!&S_2JK?j0v@mMLa!^s@R`ioaH)<+G_Ozwu+TR`!KJnS
zTPb16@&KISpyAHB=G9)9V!AyO5O96cJ#iIq(A>i3(OM$<xYx`$F~x_3ntcHRk9QjY
z3*rLxa0=nxqzC6g3n67V&I)w7N><fAyD1nS=O8@O+fox!V^iAzA@j66$P%n@KMU#>
zh1V@R*DXyjMSNL~2N?Xyn)c+ow&>$5MXh=}X8h<NQ^PMjXD)xO!{WG&r$blqc`_og
zalpta<teh@1Q_5-2I_COom~9Q##V|U6zS>GtA|QAP9cSQ<r#~6*TyT1f*FyB&<*q!
z^QnCQJ>Bd|3CVuB<k0t^ZpS-$B3zL!chb+ct(Gm&H)iji*#Q|%uqH8@1K+67lW1p^
zbDUJ0LV0a<Gw+C2*~z8Cz&Z?=<}G*b#cshb8+?SJt^A*Eu^o?4P-+ljpeVP(*n%x`
zm^N7abNtfU$^`i@;#7a<?atbQOSuZp^|TUSgH-691-oYzT6Jmkw9S12vZ7y{OL0rJ
zwX=rn?c$sOy&HU;z+m2Xl@qhoT?4Ae-Ej?`7~G?q72FA5&HZ?k0Xnta`7maId+mGI
zKI(0vlu%pEEoxc*zdDeuc0TNzM72ZgHhAikS)7M-aT3x4(oJjG2S)cz*=Kb2JddUT
zM;444Cd+c|DpEp~aNya9@i6dGOU6*{aqYq1aqZbY;HD4TeyE?Kkc0#3mXmC``yA=~
zY+cN=Wtt0yW*6Oqr+2{4#<an`Sz=lqaWo22@;R9O@)Jk)`6Sp=Un4#!SDrP(vI?G(
zFW%I{(lrflSY=|mF}E3bG*Wd`4faQqsdxI|jlan}nCz+-q;0PNr`uxP2J4a+tRMJM
zv&{SIjJc>ji($23S%HYNWPEd+!43!v3{&^tTboMd=p+7lpeGCw?tUzaNY1mtQ;VA?
z;Xfi>fJ5gdt;9<LjdLSiQ}*r=eTVqg4W`vM3b{cd;1<m?u;&-6J1pEbRgwMOUKwjW
z^6l&%L6XZ+<r*tpf~TPXz4#YlHX&)bA|7_^0N&;LATa+Y!u#6ev<-J6K`_roIA&sD
zgp!7T%ALtd9u~+tiB|3vv)g5IDd2>m)t16&QHoRABIF#$XqKMwlW_aTQd2x;ORDD!
z?zZ9I&-a!g|4<dc`3mU%Zx<QFtg*hMGcm8a7|YUM3V6jRbv^k;Nt!XoRS*2g|3nd`
zV&+zVlMU7g3y;Mp8{=R5=ZI5ICEh76;PNW?eKH=pgKXS%J*IWlo?UN{&lYUKLW46u
zNQw9j&{o{cLq=}JICt!uhr$IV#oQq3{P`+Lg-wx$gf5dMu}3bZ0!dk1aJJ5YR7_ir
zZI4xlr4IJZ{SGirvn)Fi;r7EpYhW0sYv$_iCWD=r@aZmh8vyf2Gd!B61`MyAwwP#V
zD{;?F*d1wv@B<dVxHHWdbpi1eBp!i#CtLf>tfL@<d!y@2bm*Fc^zy|tZWM*K++qL-
zT31%Rxkn{FG9&#uIcJJo@N#a~#xmoc$J+IwHy_f?6^uXUb#lOP6ySiqtSc!%$qDcn
zSu@;KzYRBUR77Shxx|!8BO%*SLLjt!w1Xov84rPZd;HP%8;wT$To?MxH$i)Ku<m|9
zUR!g?*;d*(*g=Q&T{mXiNxtS6oGPc0#2I3WD*6|3q<bW1U^ofX{z-{l=!J>akk)H&
z4Vd+7K{H{8cN?_xMC+d4pB8h?za8RO)pU)%%r-C`;=Y~P{VuS9pot~v{;<pq%|z>r
z=6xT9l3PSbODp|_+DH_tp0vAV;CFj-MV&lRrQ<6WdKns$OG)74<quZx_C|s>NH1vv
zGD-I|kJ(aHp$nXzLnc}_d>~P;NV3=NJJd4;>&dbPd!7vY;CZtY69#*u_6U-FHlVhJ
z6r}Xq3hnbtee0+d<=Whyn2b{7wL}BN-ZbJ8$uzqyMt#;9d|6xH5-U?*e8A%Y&Giqu
zH1o!b+ZEf%Qq6{FkbhkUL{*5`XsIDGgE7Q+_@84Q4Rgd<9zaQ%EYYvR)ZSE&r7X&F
zWS=322{A@3<1lMy(nF6i%Uil@)xz0NE2Vq)t}{467=WV<Wz2Q*lD!C`fC^x}J$)tp
zPA&GG=+g3U&ydOI;U^sA7#HENK|2|jLK*F5^M&$1+reUZQKoZOl6%i5SL<bRPV(ow
z^p7L%_)Q=AoS~EqU`1K3!>52=1}3-{LYGg&#HZuNVcHyz#Qk#r+pP5W{`Q31o@m&w
zEoW$>USp17RGyl<j*?l^xUmBey6a{gN0-Ci4}0SsJ|`B3uC5;sHErN+LAW%PZ>w=%
zwmms}jrj&kTA94fJjZ9c#n6$5y?{c6ZG(S9_2r3Z=~$5F?Rc%i2Ca{$UXCN?Eu%2$
z!C5*k`-UY&wRJA(Oav|pbow*izB=+k4ct*{i5=?0sK*f^4_pZOCs@-6^eanR90i!d
z@#c`7DzHg3{s7nrEV7E)eFD*6MF>NaXr63>c83hPxe$V4`y+=1*oyZEY+@0|*;!#Z
zh>`Tvsy7kPrY7~a=QL^N?4O=Y#ofA$HWa)7caE?nZb~7s>+!Fo&U>Ou)otX&2D%__
z22wKN=r9~KOA=DH-r;r)ea361^e|}$#{8Esd0I0xp5Z^(xGr~A+{N-NX5Dkt1saQ<
z@`IJN5Db>THeEq&`@IutD`uCFRrAsgOwGMF@s$;v4D=N+7kq{X#ZbOD9wEFn-$5g!
znNuFRlv4pD#{R#{onC&@!<`y&iN3@Lh%J_j=XgcY&?TG*pUCH9v%H<H{inOh<-GrR
zIF<6$Wjyevu-Z+AyWir`pJkm-@ySg5XYJib5n~!T{rC5O|9q|Wz}9SM#M06clO7RU
z$@rdb3v9IVSdx(tRX@L88w%P#yYGrvHYPL+ZHW5~4PpL6)SMiP$NKJkLUC&TtA<wB
z$<L<*H4WlZO;2~FWw(T;fIKCIUrzn4Pq{~5m7d=Lo>h$#mM+sj%;P7S*WIS$!B)`|
z7bque$?cfGbY2@-SWEe*#zdYLRz({svb%IMT3C?j@4i)6Gbj@jFyr-XzScPfPcU0J
zXDAj3pj%Juhj?wW18+>q4{YC^4Ucc1y}+(EiGvIJ4N`P#MZmKj?s0|KkQHG+Q}0%b
z!&`w#Y$+iQO^Lgb0bK9DL{zqnVMUO;NPn=Vq!THE2k7jkV`+YiURQ^U@_-Lp*@Cw#
z7gR`SK708o$OCHK3nO@OPtb(JsRsx6HHPKnOL4Lvbmzq^vbrjvxIxK!@BK^DWvVyV
z9b_BZ+vfAWJN@^6rfroZ=p`w#@);Kwm-O2;Eet%w8(-Uhz=^ceB8F2~>I~?@<r6^Q
z5RY~T+61%yoZ6SmBKXYWaQik*+_7Ka>0*9`PT?UjzkbPP_-}C-xvnxWETMZJlW5bI
z(CB&WX!H<Q6Q>H?>PWEW$iGVZX9rh()xHV5stn4d(1fSp8w=CCE!n(m0vwD32V0ef
zaCO8#To$^+DLKC~ne-867<z14B?Ai=7jg;rV!ozqSFcTb*Z+OLrNOKa-LOOuTkrzm
zmMm+7G}uV%K@d(b&jh;Y?5KVulMNdLOD$h5suMgRwJ-2SM9AO4nu(M%YMK7!*1)ky
z<4Qpj=CY-R_;qdknD@9vyE1r@2XXLW)TN%<o#pt(4Jv7s!M4Opm7lB9rHvkq%PUy6
zdR?p?_Lo6emO?P34l($t%qP|cpeeAH?=J=rwq!jStEE(nl^H{HYX;{3A4k_19#^-8
zC$`yGjcwb`G`4NqW@9#H<1}{C7>#Y)_MPwk&HTtSXU<-GtyfF5=Z{Kjjj=KRIT_9F
z4ELyK149lb2WGUHZ;wir_eEcMyqOG|j9L+|8u@nWs(X20?*jzEumRhtHEae0%=<3F
zo$rY+TE$}YGY#mlc)dX=-A-SifYhY!#rc!k%Cg3|&`*RN33p3Vw?|C=UV~(kup@j)
z6~V*uJW=Fi1&8$3!=AT&9<#|OT3(;BWpmK>7`T;xphcJP6!KE`YiueWbvCZgSTJ;n
z^Y-Q|&K}<Q&i&VlAwYY%Oz;k2A$wO&&w3zy0^b5#z)>Kig7oe6UGpI)062jb(-N`6
z71kC2n3ZEZt4Y{E!#TB?aTSL)jLI!a9MvpW0DG-;8m%y`45NmApIUV>vQ4F#ky}^|
zSe^0q;Yt!+lQ&0g3K=X#&C#B!ZuIvEUlIIQ-5U7{)dEddM_rUH1X%FusxqCQS(8I&
z1fi-E|6WJ(Z~9_1-8poL^a0f6Dnt(U{3*e}iUzZ!o~C;GR0@|r{(l9^FpHBjq4h$l
zLxIZlYMdorq<$GfwRITUZb0ukM=h0qzni}Sei@|gACB=J;(&|w`toca<z*iwFkxp8
zaadP=zQqfU_-wsncD%ZYtXGp*&iVR6zPS_jvQ|UGNYV~2RE^8IPy*S3>N4Le!{R*_
zv5d~vIP#zBL>hJ2@xEB)iPHCn=MSOK+;Q(+v_L~42utozxH{4<o1(09Aqd2?jt5jZ
zLXXk&K=i=57V*K@OW`0BfguCP7pBl{Kd~LBhq_^73!0GPA*f~^;OCAPzN~G118gJ#
zsyZ6F@Dl3bZXn~e99o<-e=W=Qeg%AV{wf?QY83s3sG{Q0)EV6-o|=tn{w==24Sc;R
ze@V)-f8gG0$~bbEXqaz-JflXTayjV1P^atiGxa`&SjRhC`D!%GN4drR<-O2EH@Cp!
z0i*!M$ysKj<bOrGx`B}#$4BAslq?Yd6oz8sYJIICrDI}P?_0V~1Z{0hqCN0~fLXfm
zO+3bF@1gw+AY21{E9kb<S_thYa6)%<hu|?vmBt}G!J;qqeO3<P{YFC1d2`~q4Bcw;
zW*Q_4_-sjzq_nsC+e0u*)i?wVw$%yT-4EXS39llX7+VJVoGNWJZb>lIvxnr54m*GD
zY{&@)P%bI}2KV#TYeDQwD;8@|G>+MtBM|@ZKNmonNgEr0jv$!+TJ!;mm*J=69sX6t
z=SE08>b?5cMwodOqNqN?F~KK=cdAg!dDBSJvHI~117A&?(J$D*nV}Aza$Z2C1|`T=
z-Y!2;0BgZmh293{t3|5JSdyf#CRL=3DV@&;wjNBj$#6Qf<k5sXE;%)D=WA~6vVUiG
z8;0Jdn`x|4d#I;z)cauV@70&9X>`5B7HZ?ysZP22gq4i3!xI-tNJ_L&B{T^S_?4sG
zGE(=gc%C6pC+jCpaNA1YdLg2~i99U`tU>x1)(Io|nIe0MWcOEV9<BWJq>)%ud4g9r
zz%SnK3CU1%l^L%02J7o#f!=^$$I_el1iNL!_xUElWw?)zCDhXXeWBs)2AkQjo7mCL
zR=f67gRnN``aL#=*tila+6QH8YDXXfzw%Szn1`fJboB$9k;Zwc#lM~+R1?j~pyo`a
zNUr9rz|P549=30}VY&y^M(8Fx7GN8I)GJvRF1B41_YBS}iwcdP7Xh@%(EVJ!?rwoR
z69)uyN&<ATHo@{S@8bqm0z9JGj_4|Lfg<_*z7<$t<7N@^yedLCJ>V`Dm=GS8hkR2(
zZEV1&4SR|vI>;B%%v!$>$S_f}UkmSxO3yZN?Wo(_(YBnS5CD)urAFP>X3t@jj;kD8
zkFH(|GN@SBsd9+B>dQ`TQY0qh*Tc>FP+gl<#=YBvL&jCN8mz01N!$7Qau_Dp7AI{<
z26qpD^1Q8xnC~}KaknSqR4phJNqI8vt9u8+cZ#nk9fBMtt8#^=ciO7hvRxKERgEt}
z)8-o}%IYv$Uco|4NgvGrxPmsRp2DI1PQ`ZIe&j=nEo;+bkQt8fB2$RzA;VTCTE&4I
z793R2&W#g&Ys4$gx7+;%%rN3sDRxz6Pq<H9bHw?h%}!vhB!2~IAAgl-Fsh4vjjMl6
zV#l^vqix6KV-<Cd$+YfV*wHLH3L%m*ud$cFL1LY#Af5n}fh?U|f3IgKMA>KGWDfQ!
zSaWfdsa0`_w5@QRO`>Hvdllh38)n<S6cFXv@%pNMS2Z<&#E;Zz6f3r{FoD6Yg_U@W
z8n7k{P6!O)``DaXfJlA4R9WP1XVD+xX;6B4L*WpRdnQCRWqAD!;YJ{)(tgVjK4|Y%
zm3Gse`E~QUUJh<aY3j#6AA(Mgz~t|v0X}Yt(Y2zLAE`i)P9Rpvcc~1QkU-C6!GS9O
zC|_iWNKXpGli5R&H9)ax@Y@<~Y{HZZE$>3~!y>Y(%wXR}#0p<$OZ~Nquy=Z|?%=;_
zaLv~8>oJ`_u&AQSw0xk2j7|q*>}-E{WWPuBqIgV)qAoYf&|?>rQH_pB6L*CB9AC;B
zueD1U{cvLdI^E85P*SP8t5k(4NCI+nR>3TxxMs>7tWIR|O?AitUI)9OmH=2%+|BHr
z-ahL3jNXbW{UK^yEpb^H|5R#aBzv%&ti(0b0v&eaMESuH^Om6I%EOGX66UZ)1WjGo
z@pQVRC<^ta#O|aYs?O2kTfp}k?h@CqS4tg#?$oeb6UO3lL)lx<+bidz=D08m$H7@4
zoy*H3NN*A=PdleRu3K@u8mEH|e^_(y&A|0VZOZ&NZYW+r1x18Z!fn^p3*z6dzmsu2
zf%A2S+ngd*QuA~@lhpS_tkm){Id02jEeN?sE)T1=A>wb|b@bV92?Emecs7oJD(d2J
z{NeH>H92i^E`W*}PnWA#^pcXEi92Tm@rbp+<d~(&-V1cAeUxs^z(VDpfnBuMx7qV8
zu95Dp5Q^lif29lMy};uy?Qttng`2L5A3aUv06s)Yd|!&x*~S{9y3n8nN=^(gdT6Z9
zpKv40P#wswERExoxy<FN>dkPpy>N{Xb=sJgFUa<;_6_vOuC(1Jx?XD}kSh|z!*Dui
zxcBC-rzvgz-%9n>?g?fq+s42r7Wz}O#Y=W~ym^r@4vPkMp*I8$!*?HYmpV&H(d3e%
zTcpz3d2@IRcVM#3@z&vBA>TKBd*KY&IX=lhihQ5=1XtFd=@`t`d^D$BrZvYrDodu2
z@T*{L8={J<QAL@1lnvcETM8`HX+|BlsD~dn7Mb&?K}e(s`yX1k8rK^O<>Z0ZAQOFE
z`rBPPoK{yS_$?Inh%snI!!{RX#x`BLNmfqIsfxKJ9%oM+7-Ymm#qW!5;HPR|NCjU_
zM!1GGhvJq<gfNB(Dp>7ygrdqg^IA88yiz^5s>d9=ZnqKDS)o|b5*1=2bi4pe@g(e!
zA}enn2JbidL$PCf0WC>%Woq^7ko@l54O!6Q9@AZ}8tj&en~INb-B&A_fMKgx&}(`u
z>t4-ldf+8tra~Hve<X?uPHToU^>D35ZjuX}-mv>Qn!&L4rH!yXFK&X;4Wf3aqNGgh
z*d{p4#J-(x4?JqaBrwu@>*00cYVLSBlz6QRJ?>MvMs`Hqv?McormHuS7axkkRuk8+
zV9rkVKGbW`VkN|FFb8)aZz_1Scl1far?s-5605C!!Y6aNSBb)wS~T!~OjwncHY}*_
z#l_iHhYQmTp4-N^weed_#koA`y>WXQ;;uDk@q#x^e~Hgc2ize8{;tnErLW0kyhw_n
zZPYBYBK~0R6vFVnA;7w>zQxjar))j7(E4dcaIh5DETX39h5>_@KLULq39V2f?Iv-8
zub3nY4-Gvr4Ku4@R(wl?O~}9GFb>Mr8Y#wLIB2%^1&mh!HSUTX^ipe#%~yvJXtcSI
zl2yr?PQ}Z|zi(aVVx`a`ci-QbeZRkRU8Tsh{iw$VZ&(R@dHGq_6#Q8O#?ZIgT+%j6
z0I*y2?jV_wXa^sm>(lU!snga7BeRwQF{y$R7clk?*6$_)!HE%wtVNT5Ee^Z}=WVQq
zX;;(;($AKTINz%z$XVhq1+cB}F}JbZo_d`*_WFxwjkU80U`Qd^{=|SrW~#HHfJ&9M
z!*$(U2mdq7t>;6T!$X&yu_#eyK^6m)j|kDQ9x6y%Adlcy6u_2{_V{sNv0(c#B4YG@
zcyuyNV;vVf15Vbr+7(VGLp)4oEb=F3;XSTX`y}o+a>=nsR1EB9=1RrBS$NKK{|X75
zEH{8F%E0LTK$JLChvdaH!}IKSW#rUoskYrD>8juVR=}yDDpU#9IGqS;KZ)i&yWBGV
zH6qf_^)|Sg*<WCR*4oiw_pvLOo8#~V_=7L$H4IF~FSBOXLZ*ba@$~GFRyzSqSLHKx
z=y@S$$(4zW=FA-OWaufirvR{h_bF4xoUp&-eOLvwm+}?VEP%hg%Z95Vm7peIzDrg!
z=Ay_mN|WoZOZAC)@b`<g2+cRn3T;v?yL~0)T)@NrWHha%K4g;aL~@^Br-voY$R1}C
z%BvORtJYJhpn%v2Img4b0$Rd^(MUWtkg@%4`*J(zS#>?=K?MzQ19MY3=Jt$RkJLq|
z!6ZL(_=Nh-b#tYNc*Ztog0S+^$Nps%1cVh5&=;z^71Obc%u@0OV1iDvoC-Ozck2SN
zbOpEX5dfvfhuGlLpbVdV&!#1)EVzA!h$;bqD89f_CykHBDj93fCfQOz7*dQzN-1w^
zv`7xMP(#)r5|(2tpG#AMOQ3)uw~8BXI8{#Q&Bo{keoQSKVBn)YkQ7BNAV5Q~L{1cg
z8nryI$9dzK;>j;ck4;K62Q7qNU(bLs$67C6MD(wc@H6pmN2EBtzSjXdco3Z&ByBMQ
zc-=WA8M!d3@?<(!DJ+?LsA-j7N}DW=tOSe!uQZloHXpmKkrsaTG$kd!E>$tqG&_hn
z_$~LZ8KRq5nbA%eU<o5!*m`dEtuDfoF%nfc1cD^hbZT30^QF|oM8|y(cQLL<q>=9Z
z8|@UGxe{IUk8CbaE(lqg8oj(eH$Oz9#!pCU?z%UU6Y+L0%k_|oC5jl0rrW&aj{5bU
zE11svF^S3Q0E{28qOjQ5@V<NawRhKlBY1orA;(!A_44*=^{nw;abRWp_z^DE`VR@$
zum_A4D62T6y7vIK-*va|B?C;Q6gFQ**F0~=LC!H+4kWLoW8d^Ukv7_16)+yH9p1Lz
zCWfeJlq^PxoQ0<Hge=FbMa2@B>4E9Ad#e4s0K~rBA^~x-Rg7=nn(FQB?$g9boy_32
z95&$`i<D&(rNv)rsIK~$A=Au^vnaz!H5Fhw-$&Gs!^=y)vP=7pF9qZCTBYk*r{rJc
z7b0syt>E1gv~k1DIc!@;YE12$Zy>_3C!-`*sf@Mu0N1H<sH+RK$7gIT6W1mVtkb$3
zyE|T>RU))wtPI|)U3PrLq>%P%TCBYiO~1Mw5E2Oc+yWA{S_UxT)U)}+$cUoua;3J0
z4W|rEjtxW_5yG!9#5*igY}D&K)mVIFchjs@YA*!OC{0N7Rh_@#XB+rMpY=D}#-H<q
z8{yiV5|snSTvnU9N!wvbTYcTK5O64)OS+|DMd~$oPRf+nSn7q9l#(hc=$C3HIX>cQ
zbxX%B9L?%UPw2iAbTEu{`z6L<<H+StI{})pryz(7TV5f)QO9qxjaYpC%YHTxdb{BG
z70Ara3k@&zqM9-lOdnD!#DOLrDihd`ga!b@v-+`I2KXwu6-DcjW8Z{|2(~nAD-<|}
zfXm7_x1nD|dm)fYmss1ek0+>cbhZ$sfYTLbxF@jvz_rm9PnX4Cck^gP!vP;NlVHSQ
zS2v&@DQ=HizSx^U0iOgzrKU<rooX;N95E(8xX-P{ML`1tf`-8oQG`Fu=p_vyKPucf
z)_JV}L4}c%Uf;yR2R>7Q>weGrm%P3n<u@(H?b}S){WeT~8GLk^LbX3Pk<WsySn=lA
zv>H~-(0duy*+A1BaO3>j>fEY;d&q`_=<(adKop&}f=f2EdJ7?R4i8)NZkM^HW9`o;
zN-?@_di>3gP0UQjBDXSwzc8}D$a)!iS!;sQgXr)-x=@2Xe9v)(ZrKu8oXh1ZpGWb@
z-^xqitlhxSB_v)v73RN8Nq8QoQDN+_=DhddU*G6wzmeZ_^J|IH$_N@zE(cz|OBT#8
zmf+Z~Q834}vUY+N0eY_O!CiJ!5uGX^fW7$k_IKJ&XKPR=-B2_y5ansZ2Ax51$45}n
zu`_-nMMpzKZ0ru$P|I)ipCqq>Ao-@06kVphxj8f?bC%PQt4OmUiwqDRJs)OEs_Mp;
zrJ0RFbm)3wAtS|u?+@)ZfvzZU)PKud`tD-U82_PO^J-(o@)z|%T6_763!dh?M(yOO
z`adLL8i{}>l1$S>%7s8!g=@CtHO{@BUCV)06GqgO5GZrHBYfwt{G&>~%jnxjDqyx1
z!{f0ypqU^&NC^D%)ZG95nD2?Lm2Xm`+c8|D$N$&MDA_@01mZk8d9I4ymBY?QWeV8>
z;lXGE@%Oa4htELymcHKn!G}sZjYx3El1oVHR094jDm*Km<9fTuWwb)~=Tm)|W0033
zSIG@SDbmqFyLY#+Sk=~dH5Apgtepk1$Syf^uhla*!GI%eTmurmjyyP*C|O<O3$*mi
z7<KhDDtNP|ySWmS3d!1=Y`1W=;Vf<RgB1ogrkNV^iJ&{-gB(Uo<LhK2IQN6Ji6e;f
z^A2Yr4RRr^rI@Eis%;-Mo1~00)*N9#qKn~*lVLa8p+{*Bn4s-OQKPN(mp6=8xqXD8
zV#1qIQl|BP!T%OlJHuf>d_cyiU!!7gB8cB}`s^Qo$C^`!rR9pLGN!pVfY&&gz<uvU
zd0^$Yt%qAUhTFCs23yvq-d+k+0{g)KtPd9Rxc~EY_0(|v_d8|nVXHss_<kzE9u7_>
zAyXZ*R<Y`}qij~2LdEy7l}T=BS=vIG?5me-l-p8|ODSl%od@xCL&x$V=6dJ9-Lqb6
zz?nWLe&d;u_?mrnS))vB6+ZOUUE(-6!H*UD%Pyv7Nos{U=BvH-IKSm^W{`@ox!O<>
zRsnp!m8ct0$-uN7vAunA@rbHG4GHHkWSZH<p%i7UaZP(ZV>}%$h1gq>4+}huZkC%&
zVfj=j`Fxk*sS|6h5fAg?9P*wJJ91%w0Un!?8k=#W^`>?sB+NJrRH*ha?j|M=XfRzH
zzh8%hmuDHl%Fp#SGXN`a_4MGpedZ96U1!#^Yxtgx?D~>_Xx+Y)FqR6pVRoKyKsDV9
zDo8@R*JgihCE2Lkz0FZbRLdtd^;?Aj(Pb1qemre_%fRgySCtc5Xb@_FN4Q)lEeHri
z@uQzyBUZ8>dWP`DXq^XDLZT^%FPP`??3el!?~*O9l)?aw=nkTlI3WBK5;c}C_R-jc
zB4$Qsj>-EiS#mmd<}d1`UyLfWo}O65-yh;S+R^=aQfAc#M=z;~Uv7N7PXBlqY0>@t
zNMl&;m@2(t!5+z?{#kZ6tCzX&p77RQCm-X=iotrw>+u<cVpeBYe+a=LfVB;RIuS^J
z696s{7}CZW{ikyvsprg+WWV7{XTnla`Q^y&z2Jt61Uv!yQIXouK?u<_4Ml~o??I!}
zels?_$jmtvYTTSf+*yFDqtf1~f$-Dkb!ULRJd4lckS1Bd*jb(C{(G1cqh6M|Q@y6f
zq^=yaj%-*8SWRU~Hx<<%STWQ%&HKlaZyOuKn*tE`kHzZZZSN%8V+&Tn!s-imkf|hc
zJes=cB^1VMh>wVlZ22j>uge5AXSF8)SjZ#*7c~$boBB;lS8G6{{Z5i5j1*BGt&bC3
zd=gWITw-1xjRlyo;Ik{4bEv)WWqY8@alfVc>~SQZ(tY*j6DdAmP7ug?EkSb34bXvf
z*)Oy17ZbcT2t+9`i{gSRvCcYtm2997smbNu=yG}_ya*Y_lBLz9%Fpl^{g;;Ujqcd8
z?|?oz-DN@nQ!9tz2cze+Vx2rtb(-Vnb~lxz*KUzi+ue@dvU|}EXh>u=#*n<HN=05<
z6c1W0!EQ-qMhsEq-?;8Z%|hmi-Sk+HFtT5if?{v9l{}};G?nIg!WN;SPNRiv$gEd2
zWre<ZmLvcSHdPYURN}P`D9jc1*!&f#N+X4AUErJ*_9|e=<imo87>4!mv>QLnC4Vwn
zi;H$oWOu#5qAMB!?<AYZRT;s@1y@;!;`XtRO{S_%(xVRo;{Q9VO<Qo+%Zs}4q8vK%
z`k3cHCd55Fo<VEx08(S(Fv>fAyz2T9!%J*ti~b&JPr@=O$BfcUs!{cck+*TwOQ@(g
z*S3fU3PJ^>K|SF~1Yj$vtM6}W{3u-7#K6sv49!@PSjD5Tdcxpf&FEiEA)l5#{(=c8
zPT%Obn5_9U0Ca<CleL6Y58w6Hf(zBB;_F%4=(JayN6IJ#1aAgG!d&43Fj<wk<CUCd
zjEqVr?jHz#EZstOQ((75eYbtw*c|^{dyN#Iw2l*b7W7Ea9@q_bwtApdi2<jf89kEY
z+k6f=JWY_=E67WgO%l~tx9Bxj{lzS>r$Kz0TF9fqCu<$2e~2GZsOfrLqVr1^p9R#@
zN@?evLl{&7PEGW^1VMyijjIR#+^=BS!4lwNG4K}K8mx-&%Ub&Tx08*@oteJ{Pa@Wu
zhE$prmQ+Tc!2?>IEb1M;1p{|XIY+yLqp#M!m8&q;LtUDV+@GsvjQUx|h9n^=(W9eK
z1Qt<9^BTxd4(1!zLeymHp_ce-<{I%znS+Do^s>CxEI)Xp{$*=QHZ0`WxRtQwUzdpK
zE2><Vve2O=sS^v#_!U=y$=BDjueKL_C2T4m8-VAP$!afwDhuj(Apq>!A;<&p)Z)`)
z6feSVjfUTFLagYtpWBC(M+zyuVMVg^ds`zqNF+wQKVMgyM}%(rcc5%T2Hn;1``7JU
z{4hEa9T{ma4V`n04L<4A54C^qlH%kllbKtTkU@pI?r_C&)1i=-hQ0mlRy46yHt?oR
z5QZF>qn@%F7A=*7$=Wc&fwi;+IfyNIkilyx>k=BjD|ft@$$t`|(UF^h=Twn-D9i*8
zB5swTn&Ke%o}K)7NcHTXUALJD5-kuFtmU(cHA`9o7a29^O?+|t`vtE6Mo@pzyflAe
zyfh0hW%iOt-)<tGYET9gxST|*V&X7?88e%~FWXkKks@ixYZQnjT~t4xDfl{2`%)17
z3UHbO)nJ^Ut(p%IE43`B3-$@d+^q+ryf>I0G+!Ool+NT<xz*ki0lK%lgB+bQv#6Ep
zHT%{K5vJWqlP3(rug#%>iBnuc5m|i`44i@)@OsZ!apG&7nNTA6Hh>fi*$flh;BJ2#
zvE%?os?1#5i6~mAjT3w0M9nt>z5+gguTXC?ht-}AJ{sQ`D0Sg<;f{kEs{Ru7w*l0P
zQ&^9TRS$2)1Y4O#=*}7vX?Y8B4Yv}emqWv8ehmcFi8yp+oJ8q^9?i&s98y>~{9ukt
zRQ>EY0}lf}9yufsYQK}FCSBjO>Yg>#&}niDa?GUN7f*vzlD3)p{tEnyC<C&~@B&oh
zV$E^@fPg?nhzZ*#Cp+k@ge_CUUij+I2UDmD{%8r9r3ZVkesqv#7nc+{5Ydoj>AhlB
z;4I0Ov&u{{F}|$6`Z4kl7A)7m1<()YLWb72?RXZt-5*#Xlee;RjU4!S+1K1`vA_#R
zN%Cy)9nTIZ!Q40@3V(|b%S+WvNW0ZT-fCl!;8U>j39{judFG1fO*V`Elpi-|$Br|x
z2afogD5r=Xm;U*OMLABjR4t?;`=<c9d$v}XG(-(JsURi62d?!*s{ud7dZi10aT3u4
z7qA^J_LZ;k+0*tOrwE^qq?ra{IUEvuryzWq-<CO}rN!%fl$PztU{g4y<M&h;JBpK>
z++SrGvExp#R)0%0rl`{RXA^%JgCgSbj<iK+Gy7R5IIGPeYtF2Y18Ge*;gJC)FTHQx
zTx9T!t^OM&x=96u0Fa=`&TeWJEgiT4*1AxTV*J!=&l-ga#D_4}8xL#$t*9rmgUyxx
zh9m0uGKP8dPvJarRt607gJ(V8t*J2EZCy6#?09ilyTi3F&%D9;w^e;1u$_$zeI~J~
zz$m7M@uKP(Y#$q<l+y3kOQxjiM_qWm`bt=DDiq~d?aml_NWIC!YM}OUfO+-w*M^GV
zpO@bOfe5`*`5ZQ<2n+EL)09=t;QknzfKMdHH+SMSNy7|gUOX#Cc#3h)Ttx^_V{>tC
zEL=hu7)jXYL`U~eMpnX|)G}8HC)jpz*sWhC(3|bU4r{VPmHz^=T=w|rCUhAWCJ?CG
zzP;le2P{mpVp(RJPrEBGprrUd!vSdF4K=EBSONpl6P90W@^zxtO27IKO$#}m{KGJ)
zYInUpku^U;#FL&V6Gzg-PPja3G*>fg2}<cKu1$IFHA_Opf!EXIaGMXg>`$9GMP*AA
zL~N&dAn^NTCD3L`SKqsSB4#SR&2^JJFWrV4oEMK-hbMxG5ZXklK9)Ovf=!Dzs73Pl
zi|Nafsi=qx^Yx2o`}q`w7g-p;ehlvU$2ME<6!_KZrHKt;aN-7bVtMbAI$N%lN<N8Y
z9`&?(A>}lB0_6yf3*8h@n3Q<?Ev}Gz!N}0Olm|wbGSLcOCS#Gr@y0hH9}Y&?BSD68
z&Kn{BjHU)e1O2%kLk=|MmvGQ<Sj+iF3K_qr=7yxpueE|!xr{F|A6;kRs5Iw8BJWd_
zr1qe8GDOnqY-c{Kyc*n#1dsXAhGa0DEefFTjn{l|%JryGzBbRs`|^Xa_1_=%@fz*`
zQY1r{OUmAAP87Ec?_bYQEAeNNWg~Gvc!vqSfADX;dq=HU{nAD_FchiZ)-TwfGQxKv
z&?=Yg>zBF;Ay&A1jtlz?fO$4(`l46*;b9F}jaB0SV*=ZPd1u>xbtl%5Q;yc_utmR-
ztajdjQ^tU5=iminCv;?ISIrxj^X(Z8t-@rR6Z9X6o@BKHj<R0_1GNVze)^Z!tI8%S
z;!~hk3;Yumt|w`8AGA4VlT4H`9|=XJwEHgm9cBsX+APfQSMJTP_^i44UvM5-#VBDX
z-%Xeh9b=TURI+((mL6I?of<CAy{bhczAP5mjg5W+H;b7ANirkJP`O3oy^hG(cNT@5
zbwUGP*~EOW|9(SvVyMG#&)}61?h0$~SlefCkh?+o8b$4SzLI)=reZ6e9m<kiOZ2+^
zbp3&Mj<*yLcWsf}3V3%>5BszMHFsQKmC%0hpg2Yp@E(9JxcgA@I;5W;W#%R5TdN9_
zg63jUj9G2V%|miWy@f_TQQ3^_JA6vd|Gc~M_!FG}%(5VQZN|W+xeU?bqSFq4kQ&-E
z8oCcTpmK=z2~R2O@Bu;tbrqAPy?(onw*Y8C4N|Zv{meZd0uClytz7h6^q@`jX!>`>
zT%<S9-V*Ev33H1(e9ey-v!@SqqXb}(KSNQI)<>5*NvhIjwzc;9BH}@V%a21uQj%mD
z!wl${P0u;nw;++^o{u>Q{%gaWxK~P9D~n!MD32|Sy{pd<k<XPWWT&Mrl`Jk@4&pPs
zrYDqU(3B@e1?8ArM@tB}hQFr09`D`j^$CIrGRprr$7K+uk@m<$M9$Q0Yn**PRs<*<
zXw&n6CRnVv^K#Z+?W=~*7DIFUMBjpWb|tOxt!n>g2m=-#v`tFfdUA@wsOBa%85){Y
z0^bw%0{|`_=ieVV3eaZ06DBP9z-em3d<#??j)V_vQ5p&N`p6XCu*MV0=U?DZ0+~%=
z$>2(VJ|^>)=p?ahKU2y|u^kB<Hm=|x;iIVNJR2f0_A5sCgYJJms||xfL=eO@Gx}?0
z*Gi*sW$4icQPqE8^sML;Xys#0M97*Bqp#Aq(N<bX767qYq9s==$qUyqe`qEK4xWo2
zZ<uFYpIn_C&Tvt2(pIhkz8x2?UwLapi$##XpXFsAR0gQq@@#-M_Ur}|zt89s1r!Pt
zeBtpT_bP~AfYZA`Vmj8mzUKAXZ*y)dZsR(lZtzT_6fcLLm0%8-K#PfSW{G;g5YjhN
z|8%BF)y;{P;>YfyG3rVU_dC&i*aCqWA|y9{QAaP_HN)?|K^jUqOUXy4{DL5MISMXs
zQ-89;K}(L#dRT>ig5w|JZ`mvi8#=h3Rjh|?1(jx`t}uZ{v$y+hFAXsmWY(sc*d4F#
zO=|b_upnj?t%O2RxpiSu2mtcO(a)K8iBuZoDdg6rB(1Cv0DprPli`U!w9&uZ?RUaO
ze-d=h7s{RSRDcJO%G0BLH>Q-y@GCwSF*b+(F~2Ih&~PQzmyL{54u0uFJ=8Q#v{ds<
zcU%h9jymt=XZa^K611C-SEOpZgtdDal_wGX@v_D1>TM1en#<Tx!=5Yf<Bk0NZvgAS
zbq!DVa~Q!vgZ3QUPjsMFNYB04hVLue2HjyklJVqpz<=}=e%-q<y$dwKw(-LQ%&`Rp
z*gZITFW5G-W8>?UN<PZRb0bHpiB_FO-bN>eaH^Y{$7n%Ehu`Z>e&quM4cvRa^|Bwq
za1rpPoExN$NaI_$YEz{p%Ej4!1FJdPgHkNVx6g1qEdFcoQoz#gBOgx?bDR5A;(5IT
zS>GyBL7_DP6=#x9l6+2P++=}84iNg8a!LS*`;%<;ce_raQhn_S>u9Qd#L%p-NEEHf
z1VrgKO+F)l#h)cJsVYNmp)mxC!nV(C;D%d98J<aQw+qI!&ElyY3VJyN^Bj>KkjUk~
z^Hx`Xy7*0r{RU`YIhiH~b4}*B1Z8BBVyq~ncj2!^F0~xfL`XOk7I0v>T8x<_P`y;w
zGlLTZ9YLwmUMiq1H!;Ncy+L~(#tPRQTA?ztUEDp?V!zCnb+o81iOU{ealJ(45#<N;
z?hAd~g4>sPogH<dh`)>rt&i($W>KK8G~Rg3*c}Zoy%~eR9CLOjXkj6Y!P7ImYuyJw
z2tuS|F)2jkhJD=g+U}(gccSKK#GJ%L+R5|Z_zjfs`)^=jqHT7C!XWj=`+(Wu(Vg06
zkhMW4@%D>I6K>h#Z({cg$h2eGCC45@DW{LDsfS9z+Ai&#sn6nG6D5k5`zN<#c|21w
zQx`W#k|?vL6BTq&(RAYH*D`Wz)uoAC4*vXHlnx9H6lL6g=ZOek69b{5dah+YYa{<C
z8yWp(NPBCWjXB8Bu^@xUTA{`u8i&MphqxLq{Xxyx55^9oJRlr)W=&4bpPLQX>I-KL
zQe`60%vmTTwb&`E<jO>2gBms;AHIeAxwLSPcG=B0<S;T=H@Wu$7So2_A!XSCldrt)
zbdBtea=A0M|2@`hkV#ayBL5lX%N}_R+xNKWTVeK9i$T4f5$xFa(YY<!+w(ay@Se6C
z4PlLz(N74p!WsP4uP+g)l%T`P0MMPn2S3R;Pdh9O-gbJ1uD$fF7jpL4wU4OL#Ig7l
z4?wnX<+<?0N%6qRYK@@;8y%KPO0R|mmDDhFzSw<}nW4MAy0C&(pcJHeBg~O3WRE3h
zBr76F^)id&lEbaPQ-M-~f0q$Ris(Hn0Be-Ln!@Ihb3h>+cPB+bdwf~1ecKs2jTnfr
z=N|%|4`g2Elc&wKbpSKemx>LhBm~Iz)ofrRxQKZE>PHSi4UQ!2qIq-HMVUguL$vS9
zHZFYE)(iKbv$8W9C8UNyNRf+KmTY7Uo<nr-(h2_buRO7<C^r6&)GCKNW*64@9W#9C
zlXJtAfL3)&9|pDpH9GZmj+oBK>wEa-gZph}J`SH_ARG+V?m3}Hd$*;hZe*z&So~9?
zVC=V?3F6lC9eOeb#{2vh;dY`F2AAmTAM@j$@OTJEgnWr%5@9-iv!J`)JdLfEK+gw<
zqSvkfsP~dI6k!@@XnJ&+5aR-t(ep826PEIwT}u(yN`rj+EL=^C%DE{=C}0j#x9j|d
z?#l~o3h4-NtoYQ-aI3Nha1^M9sKb*zQ4@<RsY*rCZ$ECp6}6%dH3aqP^yBu~Y(<#b
zMVlI}zt@XP!5)blN0~0)Yta2V!Pgobe8m`gpCD3nyQ4ApJDrB)YIjFx+rtAY6eWAC
zOW5Vm8r-I^m2H~eW#Ec@7&gE9*w0u#80j&u-vMjZzlOZ$lpVk7VYvNXFqv}v?Iket
z-7gQ4Kp77vi4H<Khkrr2Z3D?P;T~Gc%__vLk}LNmL3jM41FchZOzAIkLNwR!e-3zk
z%2)bn;K3~PJ)U3ke(hL%9WWvjM%xa-dE!q)(bqf;{`c&PB!+uoZY#T;-O1l79@>x*
zwdIu{Bh|PXu%Tur?7N8#*K`7O;7Fw{c47ApnP9>KWs`RaNyXKSTLp$oQrrQ-BsnZf
zG$W>nNu!`snF7oayx49hMGQ=vJl@W2=3xT>X+UiXCOi{$fhBze7en81`DB#FugQyj
zO0ixA7XUa-`avDk_ki4}*(l|UXFTi1=5SJJ3do8^k<zt!9`g!`8d(X6dTN?<irlh2
z`7@O@&Je4<VZoWfL~@m(p~Xw}k%O@mS>z49ix}R8VK51LyuFGR|G><1Obtq=2wpIN
zg<{)#W!|p?F2R-&Ka>Gb9p{EY7C$DgiyW?m>Id$4MeFLb^6j~N=KPIXB2Xj%g)naX
zb#rAmEOLe^rQ!Z)A7}d5rT;q4LrRuuQM^_gv^$2q9`AeZIW7ilT3Yt8w1&DPYPWyN
zim+N)s*tG5rY~rNL6l@}5G+xl*SEYIVS}@ta35mhXw#^sp4e!axk#rJtcY9UnKwb?
z`z31(I>DtxFm2Su8@0D9?A|O=M#*Y9J;q{;0W#vtzMT_VpNXG)3AT0Gf4G>Mzyx+L
zL3T*3F=2G5p^6$dHFU0l;~I}nyfsXizKH+$-myyCQ@OUC`)0!bUJBW=g=XeBqCIo4
z>lH04(ZEdX`0#tU1c7nbpxW`XO3Ynk(d$wt2zcEaQa}5)nHNt}V#bvvz$Xd|(k*3X
zN_e*?aUD3*mEfM@@9teaQ}jFze<hE$-9S?T$~_=-+xDGa3dhsCGnV3i3{l`=4D5nW
zskO!z>MqI_9wcGIql@w>*=(RUd4HdF1Fx*jBi%kTpt(7Ji|#z~`=(k~FmnPy1g@`t
z6+;NK9T!C>3}=~n$$*X)dx?Ytl{8ix4gLa>f1apzE=)Ef+TreMHb<S=cCuCxy{5EF
zDAR=5tt_jDx{@hSu1I*a<4--cGP~#cI{9U(h4nYH!wB=CLBbofOZW2tK*vOL@f8jB
zZ{UkpUS)b0Dx9H&frdeO+K0LbtVkP3Ag%iQ<0KBzQuc(Cx>|T;(P)E}x|PPu7BI(N
z>HHTA;SwwQ)Aq+6aTGjJ0BhfqZ+mvfReYi}UZ5r3&}IPOGJqMhVn9^H`6Ow4sYiP|
z!M~?>VO(D>J`mOMB-rAks7L6#dz|L^ip>uiuF5@S$RJZ&+judU2nTIzC7Qv488P2O
zzpbe&-v<QUPXF$c?uQp^DVi2)t%<SKf+ga?gOlWkR_+uKiVBKpeZ1lgJo3>c=n!6^
zspb#={r;@+RW*`)CEaxI`)7Bl6YIIQN{khR-E9hMN=mXrP1J+I2;<iIcu+JxaVrbv
z((iZ)f+V#CeUG6(F>YY%LA!2mvIOhAd&Vs_!g?DKZO6$HBT-{?&f^6oX|YOrd;%|B
zQ8G=#J?TXTW)owUn11aqeeDM%($Uul(9mpf5!aL3=~c_pR1yGocIH3*Hwx<QYm{OC
z<$==hZ{fy^V-aJ~V;U2tg!AvdQX4dIlHm77i1C__t^4`g$O|yL16)?I3RUpOS+(dV
zS*~;`W5s1;jxRZ$3y9ASOtv;8Sk0`5xdP3(PG>dG0*ZmqPwV)5mmMa)+acdRpA&B1
zPl&Nv9XG2N`y)&L^}g$(X8xjq_-)_X&vWw~HY4jFkX~K741+69QI}@0FEPaTv7%=n
zz5Au3)AtYxL|er{&rip$^(=hQlzbz<61W981Z=~BD4C+-{ewSDcWVKk*_g6)D}-UF
zowvZuD7XZ_H%?uIYe4(6k99SZ8$lo!<zbKvd!BF%>N(MZ>z|sASJH)8`-ZqeVOg3&
zm26LbSxz031f8r;#J{}_v8Ntn6v-^CnUE){Ij)q7tZ3xeAcK;v{9JiW;XO1vgEa>M
z6{H72XH1cg!`@5sRC68e%4_u5LZpP9??EW*U1n*%LvPhTc^j0@E1K@dRPci&>x@o?
zIa3g4qVqivi&-d->KelLKs5#rUl$M_4x;yvjs!p(%1_doAFrequCC4}K#8c$6|sF=
z&!hf=w=;~P)0j=!JXC4|B_A+k@7D>BH#-ULHy0Liy50NE@17;MyDkTjDRBf8a!?L7
zPxW-)(S!vJ%$<4VcsD-P#}0nV&Tef?QEfeR5v=+}I&{Cf4Ot9<LSau}ZEXo2qJ_T6
zIh#(gY&uV^akpP_lBq378)fjjzKP}ZxTiUEy*^;w#ToV9yY^<zA-_FJt!&ep2x)t{
zTUYZ2#zR~WiGxitTpy+d6kv+|1+n!YkAD@(QlYQ}MYL|sJSWp8=n`*72W?W7rXc^n
zO7(e`4vPvc0X=SIIW5cx9+6bN%HH}*e|$tMd{p_$QO?azwxanq^K3N&64)B507#59
z^jy|{(nR`kz5Yj{`?hRQk`bb0grZ})#U?<9{F?|#=CAPr&BCAd{04p9ADnjO<aYR&
z@L!bN0KiP71g(i$+Y>%hhfy!pmnaVLtE2gNG>=Wo)AY~5i0+P<6Q=|OoKhqjhl#sX
zX;ls+$D3V>w<n~{M(t?4lv((KgpDt552DT(hn`OYrd;pb%rGndEre<qZ5N-W!BFt=
z1`vVi?7C&g@4EK)oR~*=KAtSKiti3S%qk0HPl-KJ6b#XoI5<(otnJp_(YxBLTh_$$
zgnT~LHfRqc`h(nz3f8XCXhsdy)rGy$1&u%&%AHGJkfI0%88pD&lAEIp+t>9(upPhl
zlq4;#UUitR<n9I|KGXZUuo}<aRB4rA!^b9CYrI-9Rw^Nat~mopO^;Ng!`Ra3e6$Xe
zB2qwAI##}NCM#Zb<NdVGG<bf|Iy4XY`57=6lqiPyh}<0aWuV%&^=E|)yqb(gt!Rc_
z0hh3;rDV<Ik1|lDrj@J267;9`HzZv(OI7C-=Ek+%5aKbzmECZj3k@+`$CsSHJ@0K=
z-Jhw(`;sj<(kNjAsFWBO2on?ZtPPb{rIpc(@IgKuubxvyS9=N`f@3B12s!Qdyg0**
zb(#~q-k0rDZB|(W<Zz(Q_ne5}V7Z%*yY-EvORq~ays7`XcDV-_i+oA?OFDUyiJhB(
zO26{wl-w--6|^TCs>Gj(@WMSnr;}3@((k(BIp~lOY@DgKP!I5D%or@)DJmn0RrLM~
zElCdDY-&|$mASY=uDJ+13CFI(YD@5qw1YR1wbnZu{zLK(?^gD?j1WZd=Y_A_gIBkN
z1b@)!9xen`vT(56G8)C6#|7}buXQpFCZ7T?owbIxqmeH0b7{3gx0SehGk49OQ|Tb}
zpx!p-KK`*uYOv{;;Z(Oy83f?I02|&+z}@aqCk1#;xT2sz``6dr-t6CU;7ePega4nA
zPY5pCy!2)rx0*b!_5r5PaV<pxkF3M5lG&#OcfqBRGO@0jK}<A);l2JaneYg2du<lO
z<z?`DbMKS0)4gsJl%JCpnR*#U&i+X+gI@3l{4c<GlIzNM6twmq0>#PSK#vvi>8g-v
zPQwCb0l7^y>i151D5@i^H><$;DZUXY*Va$yR_D>ZSGRP&%Sb!d+zuE8@_>pJ91t*q
zkCQ%gD#-ACGbLDa!q8L0lS-IG5Bxxx(FXZb-1jd}Wt!s;br|^BQA`!S=soqtjGvG}
z#LDy<oQ*GW{j3U?Js1A^f^VW?O?9Ze^3O0mI@|aL4D}v)la~UVGvy@NNUg4YX3p!w
zPk-rJOOn>RpA<nRV=h_RP_UWU-ss>T%ASMOd<idM{55AbH81(o+~@G1K|eggu3<$d
z5TX_S*Ko}?4EnfrZGSs3Iw%*+el37%i}$lBoI3D~`tvM6*U+$cSKvy{rpGloA-1$3
zY-J_z>myssf6pamLLNpT4y5Uu3F-np%S^2dBX1+;xFa<W6sR$BaB4`6ntzVx%l6PP
z?GE0Uh7Y)OCCs5B1{%a48z1ZL+wOYOT5-<{<qct|8Q~Q+(7$5>SFcJ^#DO5XYrqFG
z2w{aT`qp=^O@dtIF@a!v{va7?iKGMd`c)=^?=tpJACDX41*EREIt)l5wP~oi2<J$s
zK(+3C5NFlDNm(c?qK8SHuUR#{l-!+)?L?>i<5`Z1jUM}t4fcyniAI3k1-Nn&xljD<
zh+e|&0#48DwHL#@!HArqdX#jUAcn%I^#2o%yU%t!tX>UBPxxq$1xyV!x3P^*TZ_3%
z>^;pYQ;gj?6M)_aWl=VGJ!}nYg&k|AMmvj60AZW8j+z9!7OLAOf;6ie(0_1ze;+4J
z-D4KQ2Q5hIVVjtO@!c=V^u`gc95z$!fO3gRa_}!2arpF3)6oA-5<>Ze1}~P;`EuEE
zyU8UaL78b(UpGSRdnU*4aeGqw1~>hRePfMe0}_($pJ|-<>EO8(o%7iB-}?Irbc3@M
zD~j+zy|SQT56lKnl#_rGRFXNGg(IK(9xSlzbD`nyK+>70WflH_lEsiKI(@&k2`RzV
zCKX@-^)+@Qr!e*Z-&&Vr?8Ke408&VDa?Z4cW#`hj_VH(b;cjKC${gE{f)q0BsKn^9
zMTI2l66$?AJA-=7v_X(b(4NwqipS-^)Y8+9=BTH;NgWjJDeiSubagbcStLy(lK}e~
zkBh6Owx)@5Pl%OrgmnvjQGfPIPk*e|qli;2PrguRQLDi3f42W6qO_SBEmxsRnrW-F
zZ^KiZbiU;l$hC1}-hJDj$L?#7%PfR(UHdgi&&02>i;;J_o9nX&sx{*=X6nat8XeNQ
zQY<_>cjtd3KJOFYK|M{Ftc+1cXv-~)-oWFspVIYbi~mng`Wl|^?Qfo2I$KjsCzZN+
z-FVt+wFmikhA2zJH@B(Zkco0kwsQOI;=mgbq52`|;1g3w7LlU-LE3-A!L;t8luy1a
zY>HPXMgJ1a7GSjAM+fL8W9ATAnMU?JE&kgd+*8^tioqYu2s;tsw+wnwTQwnvf_%7c
zi}X6|cHu%q^=nQcm0Lx?N-$r1-+007vFYb#8(PnV0d2l;Q&07)BNqDO82-0<dAnRa
z@Ax@2;qY9^OsTTy2?JhFMM^i#Z^UzzS+Ms+=oyc)-JX1m%=ACwvIH2!U`4u>Dbwdp
z5Hzr1MM1htF~@6VNO`Amo`m>4Hm*Di!~C<-^C@<PT+eG6Mg`sd-Q_k(Ssk%5i0=1c
ziCmx3iC-R4UdIYf_C4f7({&Q86`245B^6qk(lTF0J!hUz*{~%gZuwX*&)m`&&aCyt
z)u`B;0f?(@y@bvPO?LHw%aRlj9C)|vmvE;O@c0sb>OSov`CYS0R`)D>+>Ku`r?r1t
zn5#acYfndH&o6jWELgLpH~NQ1iZ!&*elc8yU$y(L>9PR#*#5e>n5xBj`_zFPBSgrf
zq!yTiSc^}DEQANBC1oU7q(+7d1KvOB6wgA3>6-K<)5%F={TxqC1lsAaOsV&>%X_o>
zo#6|Rjxb`=U=n(_uZ>&Oq!`zEMD|>7UhR!feZg%B-q4rG)*q;sXe-^;bfazF9hS9z
zEkkIAmr&(x1bcpsb=!fdVq=Ls8~cf6WNDX=EyL&J2a0kQs~58LZGI#+<IFZe0BK9h
zaCp2;_e<BGI1Yyr_&-@bkBHyl*;Xo)_20Cuk24+8ye>~z6U#}GSt6+r<ssgMRVt`&
zW6+oEevPTi$~b5cD|H=&@cSNR*U8g?^dRd2=V1DRcVuO?okVz0j;6W7FCbi>=#QbV
zZ_tvG!QQ72O0ypUR{$7EQn22W&0f#?c7!6>LZqdUwn`4%5>~xJHUxQu=gUM4T>x#q
z=Fd*|&i=m%wi$Fr00nqg{wm~r(7j(@zoXt;V;|Bdl6-R}Sa}qo?ch<b+IQDT*~<`v
ztpf(7Ow&P6zkhNe)9g10jDhsMj{=$3KKZ;J2j+4*+|xvPYSngs!>CR5s&26=B!6Cl
zUGg{!C2T&JyFXn0KH|EdxF^7b4Z*6!-U>SZUZO$IWjGg1V(4qEpHTEuHF(I<RAJuo
z$=-+XcJ^1yN*h7^8Crs*y(~bCcJ#k#aral=ZcF$3*@S7CSlqeucit(riGPsgX5-Tb
z7lqZzD|q33c5hePehx2y2q~0Wl3DGK4ORZZHDb@Cag21w&N28hB@)MAGJ9nbqlZO=
zvtrd8Zl~0~AVx`#r>hamLU3b&U`uTTS`IM=yzPC=wzKGStgs%*$?NW&kAWg5*?+Q5
zR5Vz%-M|8%iugH_KrD1S@^%0!dNK&jbg<Qh*3B=;B`qOIWX8p9BoW6P(ZHf0Dk+TF
zdloNBBz(DUj#k$O6Tw)QS2W|P3pg$%NC(2tF}IyfZxC#F#MYm%FvkBn8r#P@#5rno
zt-A;PVwMzRHJ@mYNLNSG$41cJ(5RyHEW}yUKFcIoT3GHlKRaruCpR_0@==3D3;HMI
zkx?PX29x8ep=A3(h`d3b*Lc|1gO{~rhi$X8FZZe-&!8G;ar{vqUsU(g+sp2ffA%;A
zPUZ02d!b$UY%{jN>E!**f5q_7XH%9kQGaDge=>qjqH9BecJ$)S;iyLJ>AJt-2rr&a
znNcDjK6IgD_j$}L0>_|T*h3>pmA0Gw2<@cycTphLzn0sAoFDr&G`AS=wUUObrsr7E
zeVZb$9WZUIUKIt%+w0%bGp+Ije9q%$!MEblVE)y7{{Q`R!lIrnga8=oh(1|ytq&Id
zhEpB_4KE-I;^86C$Nqatuq*3^C|$nb)6I<+2&^$>^`5&;1Ip0P?e>m<A;%K*qWJ1g
z4c-ZWe>2R)ZZ^ZHFUlxYF}PvMlka$hZ-1)h<pQ$@!)BE2YH#a{e0(0@A1n+(1!pQ(
z<p8KBF6S=`Sf7bD>HLFGrUoY%J_0G_K&CbO%gxkX(2eyzi1KOndA=4f7E_j2rpaiV
zG05n<*52O5xA3=1>hfsPqbGHyKqVAaZpa|$ThIiNh_f)N=Yo3+j~`)?drHgJ7o<gP
zu084skUIL4-j6_>-UJI<l$j&-;00&uE{$tTlD*;2KtX8WZ4Q}G&71`;ZwqnjHa6CQ
z7xm<6T2Fqnf4Mt&l^Y>OJ%vxilatx*Z1fc#w7k+w4&NE*qO{Lh2Rs5oTnPe^^F=T%
zu`RuZ(8CR%>^o$X+U%k3y8=ZEVsS55R8TI4@<9<Grb&8d&EW80F)L)rKM)86TPumi
zI<?9b2EvU{V}>G!)8=v0am*OH%3@O6AK{^|bbr4Ztdf{A$>gY2%Vr0idFytvN2O#L
zY`{4~k`_ve!XgvK8?LqJgOTKGA*JrFK4@LGn=svYzO8|2TpHZ12D}sIZG+nD>-DHI
z9=8*UHXu=ob(f;)x72F86~y~k$KfD8ukGdtT*B25vkd9)8g+I<?NA>r2(y0|*pmW1
zYYora090k5G~-x;?Si$ffxMpU1FSa;kU;@l@h6qJ`=8g{JRu<wR<wgY7-WVMk8@N=
zBKdAw8u`=cfEHML{hd?|2^h|6#LUvZpu`Y<m-lR>svt!Pr}tENrEc<tS7;9JK)>FV
z1!B+><l@8*gxemG^k;8aqr}GHK3Lc>3d6@tZ15`-=0cFG4jgsU26MBVN1;e(RH_fy
z+HO`-o$N2+;91g4$Uh3a{J}}DKG7yBY$Tc3<-Lca1lu?7ns#DU{kvQ_C4`=}3cyUu
z?akg^sBobkBx<DxL8_@q&CCHBUb;foZIwzFlRVbC*SOieBW->xaXWo-;|wz~3kXTn
z>-HjaUjIdJhh;F90*xycSJ#3dhrw9E%wN~C4wle*aWfsWXm-1i*we)s=`6Ji`*y;b
zq#theH7%QWxKxatLlgb;@D>B<Sk9ZK3t*P~WgvmcPigVCz4$J^8bNkPt(z+PtNsnu
zYl*(xg05n8D{O?7)EV>=ZkJV1%^NT_CQpzFrtEk454ns(=S7<4O)<6{AxmT~PYFrw
zs#28*O0lh^o}LUg)4q3qs1+cfuC}IxG%>jYxp7;<rhI>e3`7bSD&c?Z8#YOKxm6}j
zS7u}`VfBrnCn%7@QXDb;ud1^QiYw^4H5xQnaQEO47(#HDU?I4>Yp?*p-Q6L0fZ*;9
z!96&G>)@^d<{sYn-tVjXi<&BWW@`HM?%jK@XSF;)-*TIhDxo+<hZg6yE$npn46#}~
z*~G~TqjeH|d$`2)l=}Cfu>?(uDcmZJl$3YKKOSE7C+by;2mL;M+W3T$Ba`Y1YRr+L
z)<<l9F{W(OT#L9hc?$1UZ(5Vj@-w=|4Jx&#A{mY{*Ql+xhn}C)Kzw)+c-jcEfW1_R
z$Ecvg_Fd--KXbn6t6(#i{RfN+$ec#-%VlrmK6c2)tw{lYWt$~4rZm%MhoaQHwaqtr
zFjNR83xZCOur-Sz3U{Z~Jp8~xk0e3C1@8Jf<N7vzY&;|!E;$|n7ZszEqP~HrbCu(5
z;+p)~vIl?1%gibaUMiQx03q@5+ATx36D<<p3XO1~?{CF@@D(3R)$lQBR<)4lQwa)H
z+Ru#r!?~qHYlDq4R7EAr#rh;*)%SPj&S|Q;qKV|4tF}mCj5gTRjZLs|f)?v4VhmY>
zNTVf)h!)3BMeX2IqFVK{(2OiC3Z=|Oagy!ch9H(00m{q7Rfz<+K3gAlykflmgJe@4
zWcT|RY4_b@Io<4L%`;6b<dGL@M2C#iq3jUc46F=`P4Hxnxa@FN)7czT4)|m3i6jWe
z?5>-^qVlITVdzS}sr{OTrF$PY_HZ?i+XTy8&-YCn63cdFRAt7%p1gt1bwF0FnvIX>
z^sHmgY2Ym;NVJN&=p|sPH?NM|lWfBk^@Z&?N=>#w!{c6G)cV^}P{$(((Ooi4fNeP1
zZoK}`L+HIhmssJ}Jaa)-u1GE^aR*xeX2I8l;kRX3Cxq^`QDXdm3KRO4oVV@N!dDoq
zOOut^cF&@J=yl@^K1V$H;Pv|XgWpP#gCJ|nVdgHC2El|rbVe5u##?yd2Il>R>ax>`
zr+X)N!lHk)TmGgZjJ0V1^blbX%)*7oX7E+}<FZ*h<s#9fCW#?(peC))Hi>q)lHCv>
z9P7bzVahd=D0tH*l@SKVh-tv9%9NcVv+AhT7EOh%U_?9)Z<Yb)QBt!|;@<w_31>H=
z?qnhs&R8!%Mi#{VBrE14_Tjdj*3H|d++iHM^}BbWwjPis^UIAIX$62CVvW<9PCJxo
zdP-wpQrW+7@u#-kL?`{lZAuq3F6poO{MKJ10HC}Qt7O{Y@?txcBRnzIN2fcQD!#=b
z1OScRo=kh~Z_EhI_T7=}+51ZtlS(X=3t7%bqR9T+KjbG_gJN>5^3cq9Vy1Wj#;aYl
zCJNgcT>)(cpg^4)Lj}ERmr)@alK%E{`*rio!rXNtSmku(mFK1<Lhn(j(g<_*uhWnC
zjk!sh)mB6BdTIECb$+VLw*z*AqVqb9jm9egX*3vX(0i9Mpg_%tv^1bv6W}tiaXx+P
z3~55s#$PTuBALyHsmf_BD$I8<VsJqa339bie?U;p<)s<OPGr$l<-6;Ws`8{x*|<Q;
zrp1=4M81>T<=WTn)v%HIhNckVe0c5J`FOLCmag{{;|LdorAnHbs^8Lmf3FMiK*?jQ
z<ME#o1$3NbWAKS2|H2JTo1)3Yu8Wb+O;LmwAF^OFuq0JWzDRmIIqKyAb^r^Cx|?I^
zM>h821VSmA*^==%irMWWnu($J=Gg`w`Zey7d0yVt{%Da4HxbZf=Y)Rd!w~lujlMg0
zeV-d@E-q$`E`OJA0bXHnl;|h5ghVw9rmEm2tosqIyl)Ia8(W2d4lc8^@NE*-20m^f
zleb-#gp9vI<(eG34849r9%qx$?-HH0MraJ(t!yc){|gJ6qK)hDLe=Djg@H%1N^#ZZ
zLzBI%2(o`t#6>u7=k3kA_S<E=0LmRBrH1<PqVL<m9ZQUG$CRNlZ~}{uUvS%`UOU1o
zTh?DGS5b14X7fe(4b?O<2@lcrWU&!&7OqMFXBWv(uRIAM4SEBH#7PZ?R5DpQjp7gU
zN*`xiP6RqHt4s05w3laJLjYZJ)bwiBa-%T^QTO$5p}yJs;)iFm>I?GSn?a%pJ;ME`
z2Q_1QWF}4n*Ccgp7@!Xkh~3)yF%G)!|E@z7*38$xo?Fv*(%CzPqHAnQ<Sxdn&gNjn
zD~*rJG4jnc$ldHjQym|4Fm8TYC_~#@<K1*IvXtC@hdTVzIX+2HX60Dh`2|a?x><AU
zz(SGhqtKxD9eHjQd!Wb)j)`6*=foJB)8REYn_hO2^7jQZ#}!j=M@vV^L0CvPJexg)
z0QK<^K)V9_%WczQU6~C<*fd1nSl3aNy)CeZlvV5~%RY&0eInnj6|d2xN@Y*1>Wt_|
zO^zsH#rRcjQ?xKKh$ZFSP&c3t0E=JnYsM|TdvU}#xDvNp_9rhF!Kbv?vGzIdHpG2u
z)e95_UE1bMeC=#QQuSN?x~#d2{PKAsRipFX^kJ<yx}oz^$5lv-;;E7r2eYqH;x=bD
z`ByQ^zQ85qPFQNRAt|=|B!^P))!Nzl>%dm!@=FBe9Z4m%UU&|3QUlTk^&p>m?H&1D
zmbQ0yCSeV2VL@03{yRWz)7;#Nl)o{PCiHu};(M3|8k#unzOFddZ+pjt0F|J`0O<rb
zM0FWEgC^8msA0%J{UM|<tSiQxpG+N3Mn>}409m6bQ;xD4E(7tZ_Sf9q5Pha#bXvf`
z!ckY2E>%qJhkDiCD1cQZM?~%;A}HtWIB{1N#$_y;y0a>=nfb;CEwycVQvr3qF|6>P
zo72+vG~{3*yP)sO<WvX%+?VaKhaN0uVw9pvF6rCo|K&5|kPFd@r-3c}zknkXuCej`
zgCm8elXm=C#DT$m9sM~}m-qs9=0&N5UH$D6l?BL=g5%ElPz*?hHHUI`2E@a8Duz5_
zmKvG*-UT(+NGCwjEvk7=-1k~(6g;*o+kW2b!KV9jr?H@o*WED9RC!$oOool6<}iHa
zZEoQVB(wc<Wn4R#W)*o;TYmF@Q!+)~!%c~*=t>cUOXxfRvH%=(jCso)^-`nzQZc`e
z19*cpjVOH@o`%-Yc_Yu@vwuk=Y!6;m{nnj;VNYfAC%jn7-wpgVz0C`a42_?t^OSI(
ztbXKsYMiGpd^`P#5ia~#WRgi7nT1Y;;C$tg?Xw3$LkkWW{><FDTY}IMa%j)Exv`0i
zgej#x2}SGKG6p=WPPlJR58mV3Xbt3>eTo@uIC37F*yZ6^LKV;|A~g*s9L5u+S-A1o
z>_;=@{2cP8t*f9CDn%7k`Of2}K`ttK{K$fT$1}n&eMD=^oPg0Lw@}siM0<R4*W<RO
z4zMDd@P7_G2J^_cX`s%`PVS8pLzgdrf?f(KJ^fzGH^&5kxM0F_IN;A~O0%vVS15+z
z!}i0-*kV%3l|+JZIhtR49_NSkD)E4kEks?_8!iG{A%mGEu@IUozZ4!Tv+(|)%VADr
zPh!AjN|J3I=Rh{i8vE7SK%zhH@CJ_I;i_3Q{&zan@ur}sJ?T28`%Ito@UM64*is?@
zq3)96Amkm9o_=m^8%({g5OfPggT)lWeV_P&r=2r9Yn+Q8oc)o%Q1v%W6FDs`uUkTW
zhfU$JovZ8P39ugjY`Z0P1|PxNBZwjEPVOgbusdDu%()JTY>aZgD|~nSS!nUP#k!HA
z5Vx+5cW>{q-RF?6&F!w%VVx5GnFuGG(0n|iw4zM8lvO)uiY2YzI5>TYbbH%bUY;#Z
zj|E$G#w4@TfrqDx5fDuymDR}OS{6MX+B^&b%+g<ZT!twRM|MM?^R3s{;ks9uT;@U6
z$evne^v^3@jN8_Li8qOvJo{+jt>CN)-00;sKUGz!hA*OTMp`;bjuNhJGsowWopT7y
zAR%e<jYh!2pt;B6(hSQOL592~+?SLgk9X01d6e<E0@p>Kda-^RUSa1~gkTx3vW9-Z
zN6m#yZVXdn7s$qR*=BCPLld|<wpx2k0e_}9ZhE>|M+SCCCN}nVml&1eK_#4d3NumO
zG>iNv;(~Cb>Zng7R(KVwiT(L~OLg12&7UOs@JtLT`-Up@AOCUDzWYFpO)>)#Gi8{K
z&<@=lY^cY4CJ{#d#zYQy0@*fp?<CE45ABcMs83ZWS(F#Te01M`J(|u-;1eR*gNI_J
zq=1sAXvuGN`4H4#=19NOg$CP5y*|O_Yy-@th2Gobk-yeL$UCLsuEj);drAzor>?Ek
zo`<V2WmG|i#>W0tPY;f#U1yY`7^l6pV>%;P$W-UvIb8b#9=pkrdA!g^H~)5?;CG-A
zR3;SZ7^#-$n8gV7Y8}`Rl<*)?sxCeUs&8iL0X*UcAhP+7le?ocX+=FcYhEN5i??_o
zYx2lc06HdccT)FLSokYh<h%;AheJg8C5jZzonb`umE`PCNg|orC2F)KY9N~80CqwD
zX>bd!er|0`{9}v_^!CAx)pm74XAD!*aD`fIWP=4;?nxsU4_@iP!Elk0uTt;Ht9Yjp
zLU-l@RWZLBdm|@!+Ko_epo75&!%%PpqaCV@jsa2cR<5b>0w+u2M#%PW2NO)p1xpfZ
zT#e4a@UYu<%}sgjX`!y+3dVORIHxqs7di-f1DD-No_2T&>*)=%zLjh|Aq}QXWxp6H
zBj9zj&(B--<@VZ*bFB(4g%Z(wEwm+G-)0<B4y>eLMH9B~+M#q_?oxL)U6wM^MxGMt
z#ebE@)_?l3*-Kkwbw1Q59qwS_HZ<;s6#z7m)_q=BG^!@-fADMF5ySO-+hSw+s#3cQ
zn73b-cIe(Rq^>eq1gC6qqx%~H(5)I$H^<>4a;}G%z^nOA{KEAJGmYRVbnWq?Jb}{=
z9X1PD1j$CE2IXt+DS6_HPhxrr(6|{H#BIcgXEl)kACx_ei{WqpQVBcE;L?n_T#e}j
zAO+&$Zs;a!I@_G;(c^CvsZMF@@B-X)6m^a4*$jMrqYY{xF<&qD#Ui0nciI9MJ0Y&)
zZs==I^9aRXcy&7=6*7S+2>phYOtxIhv)BTj-${Y^xuYO`Fhc9L<JyHiE7MS^o3-~q
zFu^6<6(2D2jip)RtIYTQv$b!0xl13|VmYk?D`CR7?`>>-cg1$iaj;Mp$Eb&qn2ab~
z(qQ<1Z*nRi(Ddfw0x&{g;3l9AEyw!J`YWvsF*ki|4*=F1T-M;ya@fzW>n!dsHS~9T
z`%!ckz#rnVs1W><qP~n>%vE&^@N_=#)z!7A`-H!j8{<ulqvBJM?E$Z4o1S$Ju{J#-
z*)d2-(+E7KoEs~a!0oM$&i(7+1$fad8w24BGD!<GZXwScjTnR1*DZ7dT_NS3Sx1Gb
z-^5yF8*fQddhepEZeuqSD*qgA<78@ycz}TC4+!km&2YH>@@2wdQiwDKMn)5*3~}XH
zdUH6gHlkR+8`R;Vm1Opq2tMlsvZ}G6Q2|a@A3qMxs;2bxu*HxQ8M(L#hfCD!PkYTw
zH1oB%XHV|T!o9lAJU@~qN3{8S6&bI!$kS=sru|9|=!8wY^QMfpnkIgj#0WC$^IS{a
z!|Y0OFzhSm4e)TV9%m5gpx-GQ^f>qLBVFVPvLbG>1?8%<@bKj9?`p7pJNOGyE>$3c
zHkjsJt<iRtS2H{Ee6}%c`{F4_g{2xmD(U-irDKT{J1$o7>f>vfv8Sf|ogtha`eH3S
zCHi9BAcooFOuh)+$G@7@T-Bzv!18b&{93L&Q$p>PfYZ!5>9UIsBv(dZ^W-(e1xxq$
z0xBw6t*wd2L?<R^*|3j4W+bTPSW|WED6PS7f6?YJbAA+>OlF>uS72p}l&P0dRc2kz
zaATVu!p<8!UOkg@yj!i&nZFNIGy&3`D4s6X9*P%zSZ6$=ELEYp36BKz^^8qxDuktA
z>h=2ppvO|T;&}&~FsxH0o=b1)eERh1{TF>R$C~<sxmv6#VM9(~0#G;>%7|!+O+Nu)
z7+K-_T1@f9l~QBn24^_Q=^T?<uK?LNn&YJd3XbrB*QsqJzp{L9=x`*AeY|XEA}wM0
zA!*NNJzTSeO^pG!cEn&~>$Si@d8QC|SA^_|g%l!>K^A_#(ln9>HgKtW$J2HYOSZNc
zuNEx2w|_Y{xy$SQBPu(aR$P1)9rI=ioJda|Yp6vZQX{+P7A@9`_eT~|qAUw2`GM@p
z+#Emsr?#OJlU$xsNiCgyeSp>s^%ph8%@Wy}73h1RrC_^A9nL3%P&j`3^Y~b^`}qYq
z+{-e?npdf$#~o*2O+%(l5SF`sclbMv^sI5mGeM-qjyBBEl?O8FN1x<Z3$mw%Q6Sl&
zDO|zw|7+dHiU3^Vv8vm?aaqW|m&v!RpZq>|XOatxUux`lYu*{|I=rQ}JHR;^@lMut
zbM})@2uiGAHf=KJ$H!w(1uRh6C!1A*sf3NKe?luHTr-Q8N3BIG(}7LpgKfl&4$&|5
z6Y)S8=}9yL2<o@8&9%SHqLNcwlV$V8N*BtC$H6%=m+6zY=PJH70d>WzZ-fwnO^cjT
z!qTZt&WyJ!<mSSAZqk2_aq_0`{&J0$pqAw$D{kVEbaMmh>59~qI;ku(e>kG)65hGg
zi!hG2Y<K{AdKDHm%`yC8HvD1p$Q>s-CcG-e()y)&x)LvQCJV-gtGsP<!t>2ovrk^M
ztuF|Ti7H#%n<OZh0%;o+v2^!+?A%hYA|Lj3sm<Od)IVzfz^A9jPs?QgW(cKpTdPTZ
z=^Rt|0^a~aQ0o)sY8wKoD8SaQMNn&Xvo^gw?XEA|GgaO1=KF=9i1EH-eHa^IQ_)W>
z!L{luM(wpE=3la<K)QUez*#*gKyCS&Q|pfJ>U7t-&DLZV-MT#eW2|uc3M58E8b%Be
z^qMVk-`k44%dMKEo-qStn)IluVx@+9qOl}{2`$qq5&GjuBmJou*|TrflId1*!-|>i
z|B5nE1nYj#3d8daA%ULi2V#1C>dQ0v+6hJaaqs(b0ZOj5)`Wd5?UgwAWd4`l?8f1T
za%m_89<Vi~PGtsyR44~RkrD8CPNzlNr31|YI}6T3mmy_YFM~SfRyAX~b<9I%X8$6Z
zj`&mbVB>k-$#!SnYiGvIP9zhr9TPo5xOtoBSgE(=^mU2M4I`%fk==l)FpkbmXMm<W
z))&h+Y3{oJp=SE`M}g*4^qn6Immcr9<z-LG@&fSSR!*jKnE;Qc^Ue^UN+vBT<_|Wq
zb@2AXpg!oGT1sbm4U!L+puz-mkCm{Q-vr3PQ`Z?*sLG!cEA=B^@g<<5`1A-JQ)Viq
z2Q_Ed|H!{4=5-6`T%=N-_d69?c8u|had)qkU&}OI>yTfX6!RwS-T$endrsh69s2x_
zN9|K);X7DJE~2eG9+ph;+mH}eHUnL)3*9UG!pp`fSWSC~>!OenxxY(U*+WKNRpp);
zqCpD-p6c7@zcm$xSJu;U422psXHcb#w$q3_ul}~R#H}R@*{8L$9dQkY7#0rwAIZ}@
z@PEe1?b}_g%+d;_a#c%Mth~#sv5n`_8^f7AdRltrcWqt897vnid=e?1%R108b&eDb
zWe@%_C4WrQpEG8{!fhw2JyqkpmC^YrS4hk2kkHOUr2QvtBF)7$J-6P(d9uS%=(+|S
zdLqmgWUH_sF{V1fN!nFs7GXpMm{F#u8nparao#=#^LOWow?WP(4K)M{GDoed7*h3$
zEbv<Z$32?`a~`w%n=oWq(Ufv$R?}mubewC<3`)F%`kvV5IiZkH)|YK|;ABB&n6{~-
z#&G!pD%=wIY~!~E5lWbcNeNTUX+3dzBf)J*>lh%3zv}3;_DM0$U?3h_C`4I|$?klK
z0<!1*r9n5lftWo%%kRx=_M5Ve+Nup&8%a$La9=UBWYEQBh-2$?s#%now0HLrQWEla
zIafvGVF2piYT^bx8W_qRGI$`pafcw!@}-sxdat|U*86FSGa4N1n=5D!#lh|qZ>q}s
zpCNb=m51X_9rrji;hvwhpGgQK=WD!hI$OxhA^=wbmEFWVr><P*)b)SqY~<dcrN4)g
zjF8ihyx%>O(DqkC?B0x+wY&V}y}~gkDdGtKLN`RCM&ps891$2weSM?lDm@C?Z0jnH
zEbh`m?LdOr%aW6b26aq7vr<T(WZ<J>0QJ~`;7Aqpx2_-fmM4J&0wDEN7d)$W{oBM{
zOIiXHal{(Cfy%UQo6u;l80;k4V$^1pJ()Cq8cRnA4G9r-VUYJfn&UOQ1+!3^#tl!Q
zxp9borojsjz;c|b#&X#niOI!#zQY9$W9IDXL&#R1abfWihAXrdxw4;B^-fX)5uHvy
zdH50=sQ(^MwHcQcg#l_^FC*)a-Dip+LoH*jg+<sGEM)J?*O)WP4_gWAq3r@A^2NvV
zHaHRvailL<a?4y}XuFZq7PB@x=T42=mLln}>_=C24kp(%iNSaiD&x(soQX8AEfpdk
z$l#+4J9BS54hDJDd7^J|j_<u2aDm}oC?SkqgMhkMxL$bMXK<g+k0>x=Fp%gBsXpNP
zTZ3jBE<7&V61*-w+diOcXLnP7?crZb-vTf?^v_k0AAt$N>y6GfDKFsz=-FNt3GTY(
z%}7$xc0Lek&xb)@-v}?o5b`sZT~K2@r5$F?2SrbB3B~^Hkz}Gu{VcllC{B*4{wXD%
zXKx}v9157*pwCRTlDy3{z{A&Wcy7f?1%zbkX_=E;f^|b<W7KG9{Xc>Z27cQiCL6|I
z{4K+M))LE-geUi;{`_SUN8I#8ckQ+jkZnrevqK%Th3`8A0L^V_l!h|`un-V^L&D-|
z%`oF?--PR|E=rNYJ1-5b{1#W@y4N0_O2iv^fddY(3Bs{7kutmNI!Pc3amJqdjhBBW
zPsv?tgEX=9>QQ}f9C7aPAs#;5|Cy5yX!5XutWe;(ljE8i7Gia`2)}YqwI(q&G-q{n
zutwkQ4Rt$Cr%NgGBa9>#rycj?qyxSzYlrnae=`&Sr0<UFU%iuf=nmx+c#;W_`Bn2n
zPu3l>iQxO}aC0#U9Y${{x6M7mMJ7$(|8YV0W=r}Yn)G)g@@YM(88ep5F6Yrtiz27W
zR%HyHm%9~$U56(LXaq_J9s`PlFLl3XHq&K4`%Y%%tv!9x--)rdwJiIzsKTK4+47ec
zU(D|*pmZdB=GiQ2Gop7I{}y=MPx}Az5};xP_u>NWK@%|juxZliDXm^QZHZ}=DxVZJ
zd0(S~d|x+*WJidI>}TLYbo+%H23%%WZwx&X<s#kh$Z+00jUkizZjw={`gx=*)$`An
zvq*pQbbj+{3qRkz@i@=>1l{gp|8}c7{=uqop^)hxue8Q8SPH0kDXbjRnVW|ZqOj0}
zFtW_+Brlu=ALg`HFIE*%x|-G=vjZ5ID{7MAQdGn3_rh6>sm%gxp~qFCwSTG^Jv}!n
z=0_Wm-7a;Q{I4seCJZ03wQbjcp+C!QkdVBl*~j(fP$SOyJ#x~Q-s1{s1Q+{GWxerH
zJdf=PbZ{u?VM3k;su3#7J3!4;$riXKlo<at6X2w8PwSSrjq4n`#y4^$X_?|go!NC6
z-S0fP0M+2r->!5ty@q*I`1f+}OYV8!7)ys|Fsp5U=d+feQ%P1)iwW9O8%4rc0uU&Q
zjg6jY0yaj(@a7F9pX$`a_oNfqP8{PWHgA#P`d<REea@vlKNt6bt66l;z1P?KN)j<9
zeac9QQJhS(YyL7v(UV)Ya8aU<g897JDch7xjq-q7>VM+}YNz;H9d0T0&Bpsv#v%Cl
zQOKB59{IBCeg10E3noTJeF1G3YLtMC&Q+A}nxV<ivYhF!Z3oZPg>1b~8=+h)cOpM0
zec49Op!V4<=`cp+$uFf9Q*@OqTg{UAMAFFb<Q5mD0>a||a2jh;2QX4=N+I|UqdHgN
z`u~l@HBdh{Mf{?6ZW=D~<3>`hOsea<B20lNi_m#II>n<*$h6@1j)9#w->~m18mi=x
z$V6BXVa_T1D3*pC3RRzGd_nyVP;)ky1ob==ze3?AVp(-@M>QL}47gEzK*F2OrdQu=
z^T+(|cYn4ZHo$~jV`>7M=%051VI5KSawRDgVpQF(cwM(GEYO40J;oig87w*mV{?M%
z8XA|SwhzG#@XRS1KglBee)9JK(FX_@4XCNW`vBZ3-w>F>f%U9wK27M(Hr(K8q3)-9
zgU4x;-fv#7!PBsF4QQ3m+Kao>xKg=M_i!TK%i0%3r;GN5oyQ}aDjTtn*eHwV7om1g
zbEV}7Yus~SpHfly2Tq0q<3BazK(_1F*Jm#0-@<ztI6k=tvp)?`8~l@v@3-|cvb|m*
z&JnO{jW+w+Rw@)##vf|EzRqBpdt@T@U8j9pk5TBd20au*`a=}S$ERH9SCXF>854T6
zeVPle{t3nx@!pN(p~9#az*csOq4Tu;0qu<Mt`Dm_^lwB!^g}M`fMZS6aU;>1*{iyC
z$UYPBmFN_TR2`wj=i*@fEexktGD*Vv3kU8=<O1B)Fx2%gn70<qh95ShS_a$)<iQEm
zj~pD|(`b|`U@&XP)F%?J=ri#D`DZuZ9@pKMbn$d=fBDt;i({O_&}(H|!`IB8-TT9&
zvATLz+bv<u?wu;1$@v=Qulq>hsnNBL?{e?zjJg*(wKpiBfmV7AYkyF}2tS8xyUpMc
zEj=bKnj<4*mvgA_j<$Q2SY^mChDjjgyx0;5Uv7KT;tYhG5%mShN?vTC(fQoDISKr$
z;Jk9qF#o$~WX;pcs(~F#LfRoX!oQxlbMapJ7);OuYWj1&a6Z^=0J8_2mR+hbQg~r7
z;e8RV?RW07i|;YJ1O}^~_Jiqvk!6b4J$X@ES#tNnCdRLRq@lt0ygfL7-iVWQYx+!W
zg%yn)RP%Rep%KhxNe8+QT%Wu^6BZtwmB13isXHe9s!1)YVH%V@q`#$(`DU+?4=#UM
zeHX!__LLicrA$HN8}|?l21Vq#+e;5jtU$)1a*=S~)O50j0pr!!3?17~xAaUDhUCU<
zMGkU;>zho{Pq@3&O|;F>mrpf|1L<hcI|tUws+ay_V#S)y)4&VxLG-BswtZ&<6~JuD
zr+iU9&nU|Iii5-0WAL~M$f}<O{}^YMIxTpXkL>W_^_QsNy+H1+ysnPu1}Z(>E0-ly
z4Uckvu~mZ<L>+R5pE3JACjTkF(q<hUKa3ZR)yIyy-}@KmwOoY0c7i!ov;5dL<hsEh
zFLkIW4dR|wgmd=XeBT?eTUz1Ch3HShgiuwp$k4v!)T8%)rl+CdbLq0k8DI0pmXc!O
zBudnjH>^ShJM>%oFrUB5R#(}_8VEbp)2L-f$aDE?Lxbib>GEAoR(xicyS$h<rRO^o
zC&;Rl`9k*}jjVp2c~cI2dC7u3ZQ+^!m|@U2`>u4GNmm*hK}VRas02-<;OmJ1Q_BT@
zn>H=vDrfXk4r(5w{FU1kE~pw3er!bfy__k#0p5N^K}1!u8<-Dsru}cGc~+LXvXIjc
z_cg#C{(1tu-P2wXGfKm{=d-@<y`t-U*_YJk*Eh1K@4iyaf-lg+=(%heYjmZ$IB}Em
zn4v)dfU$v|z^}%RCMtJoXbiBv@b{AqJg?h7tC1G&#u+U1Ov={*kn&QT>vYBMx^>2x
z9A}&s==bQ=8FN=fx07N2$H`7UM4AQ2&To(BjQ(u`>(a*#vVD<d16d$WJX#QZx$>Q=
zkV~%BUihFqH!CtGlUN%n0}hlJcUdL+?Y%!xQ|mgMOc$}n;^B}0WGGckH)q^|N!oaq
z05bfrNpYlC=VwzkJ%P8XzM>)qA-&o6;U4XRHaREBmFDrAE|G_4cA)n=lr^FdukcO#
z(NSeCjc8r2fg=2htnx){te(bmj`vG2O+U_(w_+2%p+rco-C5>NO{`LLzX;~6%K4U-
zeaW~(*ID(}wPK^jY*1wGFsc+<Vc*wCHDmYMdjqbz3th+E2lUH801EF9e$o54SB`rA
z>cYZSZugY;x+2j>N&Ws!S^4Ef+lxaye>z)``TRqRY(LjcZ)x%CUI<~22LYVtqMFY5
zS;JDpsPVU<{Nh3Cbl_T7$>fux`487NJsi2Z>QAQx1P{s3*6y1!AGvqYMQw=UixSbe
zj%A_0=HzDOO(KDl@{w5KTcH7<uq@KjTq`qd0Mt%YQ1BhiT1wvZmPTXA5H6ctrutNe
z#(KLEg#QVVl<nN63Q~-H-rKKx3N^^EaE#7~(`NepzBYAj5jKB7@eHd(R(h2BYQhYt
zRJzyJ?sd@6k#?~58bEcP1#WK@E|wioxh=ZyaM93&-fatMR5t$<-gi34AH69f?+5Ua
zlq6Zy^|A?G=85`82k`|~pt5?=Y+g=E)bPpWQ!l{A-k!#CfK20u2{jvQ^2D}Cx~YFm
z-#S=M-&YA$VXSRv?!id-8A$HOe?-*FLt84Jl;^%S&zPDst8B@rdb#4qXqXXj9@u<c
z6vY7V;3!(DMN&=LfY;^kPi1RMBlSndm;}X^CdTd$ha`eHU{hGmna!x$FwUt&-sysz
z6v!<1Ni>hm=NC7&>Sz{`@}co)Q-@&B9aIDpFz2aC9Cn!s(^eRwcs7aw$RS?(fhX6>
zHfrmlgXq^)jimFZF@2<QGYTe{Sq`x0GF>fGdsuFmktjm>(#bU(3%&8dpjg8#ex4`w
zZqSFhR?u<84Q~IXiOzsa8>uyH{4rN)%IQ!32$&{FQK3lrji4aC-YR`b(pNWx{I6dv
z)LMtpQbr-aPaKrYo^1N>HKcO`F;c3>P~1_y#S86CJ#UijlfSf&Q&p42YJUJX<uG5g
z7>r*&)tNEjk&!Lg9wlVwpa*dv9|`K8B7=%$^(h)!V`v7cUkhyQ{{*d+t>B4l?|!cl
zW5H$nv<`K>v}jGVpH?QKD*K7{9_9g2E2;wx9Jc=FM_k-?)hW=^z+XLLX<nFDtuD(;
zIfGtXv^`u~v>qHT6Ee;!@bc7{LUerSOA{AAPFhUD3X3M6U~2QckbIiKSYrU@k#_2<
zU#!F32k-a298^sV56c>8PcLVC9=nCISv-bqrOBD1vK>G8-9PpI6G{V);)O&2hvm7|
zMrTC$?IM4a9SY{{ynK)770Z1HXKh6pn3i6|T$@?n5&1j5^im4qQ2%ZjBA!bMbmD<f
z(asaij8<-OZ*w;|4W@otG&tH0f3K2ezMs8Bt?FkW9{PMlZBO#y<+Xc*+{5{P0~VAx
z+jAmRbS5z?79ZTclbkyG)RTHCa5awOTqo+?(4jXWq5w}t&hyEI7Wjg3ds%0SA2^K{
z#FxozF+yNle(v!22#!`gTc@NS<OZuMHCU=kgzE_YI-yEX7sjU1Qg{es{f3-!<SgU0
zyY&VUwUZ6K0wEHC`TjVQ257)QU&9&jWAZSYfJJF=wO7vw{MmE+!G6&sujUJ6L5At@
zFy~sJ4@y6rb&d=LEu}>^_!59fk_}K(&XY->JeSRkghXWZjBLv*sGP(#S6e|K+lwh0
z$82}$h<~TC)9Y1QeNFB-Iq)we=d|Za{Dbbrd3zEa*T&({+Z+P-(*vCB1?{8q7*u3n
z+04oVW#jNn!B&+&Va5^jk>VO?jvlpQbVJIQ`;17D8C&WeH{O*<j6Jm*J<?lVP|WLd
zNCAqi=Qb%SS<n_vYsZ;yE+g1~oahBGm=QtB)7(SQw3Ho&l2kYSYi`6Q=Yany^3Ki+
zi*WHUYZhH3kFv#OcsJM~)qN9e#-?|jmU+XNn)DsHo^!0|F<m2(IlYKpeOb`jaZnHN
zMdldjxa(i48ytwKuQ2eyzXwBxkCD$Y{m)?Ybvld5(EEap#k$XYJ`6g%JiY>Jx$}x>
zEJh{7-Q9mc)Qi*+W`9aoZc)&U4hUL5)z8CHtNHzTAIDb7vN?>CU5>@jWPhIL8Ufa>
zSy_Ajm~*d6K=Je~WKGDK`AA&XWs%>Rt7;OXhucMP-WN&V;H4*;@IMn&?r)|jf-}wt
z+@G+&&c)VRXijbismgV>E%sM|M1WDx;}6s7=>(OlRMlI9zu8ahAF9Oy(>L+cso81C
z%!e&kH3=6rqFaL*z3o&kgwBZIxt1nCqL(t6bCKJ+#;s~RuMZo8BHHQPFesZGZ502+
zUXNIs1ZrS#s}FY%I-lv@Y&`Km%HQkOYu&l*U!S-LH5lRIt>guLlr;lu?vz03tk?2O
zy`?K2Z}+ZwtxHM)@2$0eFQ79|-weRj=25e8!iohBN^$;ngB^|nPMhFuv#TQ>*&Y<{
zy0<_mpU3*%=3X&pjK3MSTo&;f1`2mSy7G7zEyiVTHm#hlF&**(x4ak&n<!HG*kP^$
z@M*qp+e@;L+FBEP?{NF`^W!izhu#1cR#O5m**Wq(W6`Zvz9fopOQ!_)-rTm)U&Rag
zZG*XO;9qTET5_JlpJ;a42UP<oE_0VTpob^64Tt>5FKx>{piF6uPciBfD+${m^eld1
z=c3-T7sZ$=@4}(QwAf|JGV`{t+jUL0Jw4*s*^h=9Ze2X%*@AW@n8W!6u~72!Y1R=3
zSRZ6}%&Df;?VA2Lh}sK5Y1M*N;AYjPdd?8PC6_uc>}t0#j8B?Q0X?P2msvE3+P<0#
z`H8^tMr?ujG-9`wgGocE!(1Ban-`RG6no<c+IG9o756p=qh&8O-Y0SfQY6sr2A+&4
zD+C3}=g%8$e%{CE2Tl}Zc#p*A9veg(DiGOYRxSx{=?y^tBK*(EA1K-QNABy5n3dRw
zHuexH$*ORmi4)wddVGl*%#jE5Nr@*c=w$FOZ0Ed&H}eG$>fJL@X$1Qlv0X_QxpfD4
zUq6h03pH~guQnr7J*}GDyx{K8Y0N!%u(z#Rvn7pisL!{Qs=X@McaUTW>=Rs&WEtji
z>4(pG8nnVF$IGWZi~bCGk<UIMt`Vu~(Pe-ib1Y0OoEsd{6!R&<@>k1H-Xw@;Y1DU0
z_B;*a$^7>Rqm~vh*QAf1H}?Hkbv&>_^1NG?hyV+E_4|Q^i1vH0bO1+*DL7oWk}D2_
z(^8-#3ZYEr`~*aH9SXVg`N0HIUL2};P@`B~Cy~A+f26OvXCLW9$=n?h<U$y|okB15
z3g$<i6LT)yPsA78d%X?1YvW%r-~VqgVWryXAwl%XeOz`+#OM?C9C3yuFREQzzqnr0
z3PxvFj~>}sGLx6beei(0m+l5z#TvEZIl|ssK)kwiJe@l(Fo|@gq`JBu4=Z1~$l_rs
zyfMwDvGcX+ubT0*#b&DQJ)XrX<o?{@CMJ?s<&>X~jN$=i8{ckf2e*v<&eV>CQV2qO
zTe+T`ZpU}UbT5K_UoEY>eu?5givV)Lq-=eaRGgtksn{2+6ZxF-j+#dwD<|Jy{+@n!
zaAyeiCi}eb9@o7)M-b2=8pLHAwH|!F@VW;rVu_KrdrrB+QXt;i_OQ_|qfO*fMD0F2
zj6$jn$EQ-~!HeVWaq7{-Fw2aOj)o3kw@&A;u$^ISYd;Ea_slD$6Ni0ts$-~rkes7+
z2c9hZM$hPfmSlTRL~+&ZrFFGrAaKShbXvplzC@L_FyW7DisQ1z+wZL2rb}W3!2^h^
zg7kfDEFmF4<)?|)i?-K45c~0wRl(8I*;*o^+gD<p%av?XfiF_9`@_a~w+Y0<I*i2h
z<0^tI#N*htUf_&t&X)&5yUtS3MM{R08>m1<tLn+WeB=YCH^d!uN^aSRQ(3WRGk2>o
zoqZ8}2pufT!JB4vw=w1?&*mP0cVW1EKlL!2DR^MZ69W&$(fgz7_P6mLaRV9^Hx-mH
zE7RUaVJKotsqmYiWC;T!KHWpRsgV$6PGWQApR4QrBC4={gz4X+0#q)JmJO63AaRyR
zL2+Cq#m*#VgM;FZ+iUo)@%)$s45FwZvn#OmD&Khc_`boADYQ<@B#22zM?h3}T(1Sb
z!)1+pLXywR+QM5rwE)0smuf4J$6|gr<>TfuVpJ{#CrL*udw$2d4P@>Kmye}UKg<<O
zk)jawnH0bh3%dDBp-{yEHIVnUuXwTPVKZLkYBc39`W@+MqvM`T4^n1#szVQ$lwg=r
zhgp|gqqez^-Wzfd(6n3w4>&1bCx-TiK5@m1pr3v{x*BwSRJPc#rGlk^;5`@Q!G<`C
zK0|zgWIV4REsv%(F+2EmrKcD&_to<sz%HSS4NxPtW3CEb;9o~<^P{}$hQ4`ucfNdy
zX@6tWf*quL=a$EhK)!Zr0?um=QA~f*Z~<Xio(axu37GxWG;Cc_e}o{L%dyQU`n-AF
zugU6Bs1g<4=uzHVxwM*&rXx6TP85Jse8}wXkI3-(J^tG8sO#OqTj~c+o)1t~Ss@~B
zxJ^kWva>-A`Oh-P*^KRXJv)HkZ%Q;1o3lp3&vV+8=S*~;#suvBla)FaWA24w<8De(
zgskb(v^iPRb)2<+t!G`TIN&>6anE;3n9gwe$w!(LM+cYF%o9;S1DYF{8HQzHh`hT0
z;<MrCBDbsP{3Zh8vs+aV{es4Vwj^c&hbcbPa4IV8`$F7GcoH2{*Uet=+1otTcdEs$
z5%cw-#At-28t4&uH@pJhj<?$B!rw}1rB}1a8WPK9%NJ>{^XTlteHCM=*E)ygR1pg+
z9A+Ndu0=`=4!&Z!Sjy3Q5#3)~@_FqF@hzH{i&{IuoFJ@3+gAt#R5E?3b1n5C&rmT!
zU2SzC&Po-GVf)Ke{vv9zwMMG0XW_5-?8Tn(`5f|{VqHC(sg-``3bHk&m|+?E`jAca
zVDu6P%V4|MC|5K%Vg9)J6o$cim)rK1+Hya4{yR~w#x<VHi%-pCsTEBWt0(J}#JfB$
zD+e;M$_r5!(1xc!f3vGu(<tP63M$rg8_f=_cE&sr`0p3(v8>@-l3IAX2yyWbS7e-Z
zF|dj83oP1pT>u+e)Y=P+Rh}TX%I&~g-nI%JKk+V0R-Jc66rFn$uhJMu@9QtOEFSP^
zAd$IDA?WmUOr`&9qM%xshQr9?M-qY&2(l+yWqiaT&&d8qV!7LDF;(`A=Y5goX|rGO
zpSedOJB9%{Lbf1}e*dOdsqYH10`={)#W!+oBqm_k;n$^_0`$$2Tg?X{>)Nk5F7UV@
z@uS;Fxc%^Z?)J9q2#1H9#>0Z9RRhM|qMIT4lalp46yjG)UC2MhsxC<on)#%l^REhF
zU~c&qH#PgH!V2C(VYIz3VOoDzBdxL~h+VC{FI`Wzq|x`po6@6Pm<|wV=$%4znYOg-
zkQs#dT5Ld(=JM#64omF0VPIhBTqHGJOpRR3_)MJ4fIl#t9GoCl4jxvH52_z{_&7m)
zATDMO4n7W!YEH!E|8IbugQ=Cd$NvuCR0VGL;N;{3ar}3{b<*iAFo5BIKEcJx&dk}x
z$nM+!j``1raB=W~c>g=*(V<-d7(@R$#>&Km&&1)Ihm)0sr3;Lr1Lgm`V4-w%Hls9m
zGBdOFD9$(!07g*#zY(Tp&L&P)-(0L5>|vahrNt;eONxK|!29tdD<|6rjf!Py;GbbW
MODalKiWvs{A10h6O#lD@

diff --git a/art/OpenEUICCBG_768.png b/art/OpenEUICCBG_768.png
new file mode 100644
index 0000000000000000000000000000000000000000..0137b489075b39d9a56f4ce4c40c0908f623516a
GIT binary patch
literal 111798
zcmYJa1yEdFur-PW3Bldnf_rdx3vR*P-QC>@?i$?PJ-EBO4GzJXfB5db?^Qv~K%MG+
zPVesCy;iRi@l##`;VbS}FfcF#DM?W!Ffd5aSMUK?XwXNJp-&g+1I}Jj(+La=#`5zQ
z9RE6@8}v^cXE6<DWjj-6Hv>l#FgG_h1`As&CnE!U69zj+v&>6gTre<VFey<X756N_
zrklHp>Pzp<RonbLd|5C#vKB0{9G!-S4*WmerKZZu_Kxb827enJ47X+B-g;YyMID#T
zCWEWrh|-KoB5*}=xThwRtWMKcNGgF4ZLDocQaj!`VG>f8S$C9zN1cz|$9%%l5e3wd
z1^2iVapW&Hh6R*^lFle$l=zbA;e!lNv&2U6{Ul#*{L$>eGlCt#JCF;|jmsETZ5IbI
z=d|4V-aUhRzKba)>x%q=5>!MNi>N$R^HaTt(-M>yV)}v&4vR)*4%3FyhgqaiA=5T@
zwyYlSquv$a^tmF=ckrL+Vv3{#IzQwkbP@KHi0L6v0D`snG%4obM+uAVx_mT0(GTtO
zP{G6$(Tic^mLV=roP@T%?>tFL+(Ehs*Gft=t0%pT7;n{4%z@KH76b=LgMln2=MY0+
zuuh{0f1qGvoa%pD3qU41Rq{1|Xr3f{^i?Q=R6-YH{@+Wlzh`oB>nHeOG11KBJBzSh
zcPH<;$Yk!LL2n<#I15G=Q0FVb`GY)!O2|{n<KneIgt7slK}HZ8fh*KmD)UZZW%`<G
zxedC)C+5G!(eG6Gwen;xdV13&!%$5RVQ=*0lBN^6ZM=$tKn`LSrT_yOjVy!s&03AA
z#5<Wo_#OtY)0^6kuAs@HEuf<C1zqfPQUxLp<f1g=W-+%bIw;#1XL6Kgf~U-*1)$ts
zc1!}IxFY&t*#BJQyghvC%GdXRD*Oxe^rt7%Y+$m26{e!(+QONnL?LzLEx~UvkS*#>
z<$tX*S`c<J2Nns4#i^EJ;XRgW@6-1kg<NxepbN|s5I=YDbUdd{Y7*G4^+u$^rnFV|
zx`Jvy-HM8wfGDY$Jdo-6-;D)JpIr8*`qPpUNa~Ts6Tu7g821ujB*cPzKaljF8(!My
zaMFD%u&bmzpfWgQC0Qs~;3dHd{6+IHPQcduzk~l)Qi>jiM&KYF{5n_C49!|~$<T@Q
zRJf`)Wl$h5?NCMGbk>o8C<-zd_df<RGESKT1n+T#&q_%f(GnbM;R;_UDp8as7K5Ms
zqX9$q4m*NaFyBqH$b#MRRHfGlP!B}3#9w{NZT=Kc^GW^ZcAtJ{tKJK48IfOPyKMd2
zMt+=$>g@S^3d0w)kI%BJ`|mDMegyI8N7#t)5L=jA&AAC)Jydgb)RB(vKR=^D+D`4C
zd!jAE2Gp%5d3pkzaCM3jx)#g2>A*YqDZ`seKTSf!;S6~KJe}@q+ricx@~H;87}tH-
zXKoa8e)k|(Y|*|F9mDfqkqo=5GDMCN)Wta!L=;0!(ZZinmTE7f`EN0E<^L9|Vc9HK
zZ}kmAMgkj6h!sE8M8(uH=gE$KT_+`oDxeNy_-|wHF;!V5pq-yP{oz3S+G1`#quEsu
zb2z@XTGthn@m*k%-Ionq7<Lbh?d72%F~@?8Z&TQ`BqmG9_4XD(PN_*s;42B$Nzbyz
zpoABMAqI!_X%*FXJ;xDwlb@QHt_^|@OZ59+<2-_3(dF~vnX`Bm?O^JG<8`5bIu8km
z9mlfE&Tb1jz3={fbF-ougz<E`E5m?gJk8Ep1U}@oR~7Hhkj_5WTllPK>{H^NULpBd
zf-1XvdQZ{uG*`ExAW(|W6n&=ng!-+dVXq~Z4y-&3C4`8-zU_##K76g@SN?{lD!oJ(
zE1e(0F|8T>&Zox|Z~`&T)LngZHEU@P<_OwR-2E)RD#`i_C=9XOl#$H)zoPLEdri-O
z!`w;J3_YJ^fz0;{eTG0<p{uxcFC)VOIhJ2X8vC8Rt6)DWxSgdrkZk{-7TQQGw%^c1
zuBGq?mSmJOU4mK*Pp{9TN}apGPqPFUZR^UALaMeOmrv%D1VnO<J-VtKDy356*erIm
zG0w!11^8N@IVt_9f^~EX?!jrE8W?>VfU_Qu$|kd;sC2b93wamP=PXwf-cHol^(UxN
zqp3c-!?vQRWSD67M=)|U{>4tRveEPDDYLP$1{p4rzdxhsaHI0-or<g?`VjhO!K7eQ
zWmR_3`9NvK3?Gyp4cnoJ=_Qitu`+`?LXx|P);L9Dl={Irmwyipf7HbE0Q`RQ?78ff
zfE+kmNRZ|0if@*MA@l3k!7Uq2>sliJg#Ze?pklH}>}QU_&9QQH)$d{!J@J7Gra2g6
zAQijJI+0Xc55-&`zRD_DkW17dK_2m^@h+Depa^1z{_QApmYWbhT3kfrAmyIcq!nHP
zBAhb%5Z&j!4z-Tqpt;cGK#GfTCljF<W>P+JStzH9b0@#ws88}r%^zA5gChPOdcDQv
z`c6jr+Wlq8YsTLi?^q9gIwW=Q5uglCLby0ry0z$p_C3;(`oFw@mTfuvJ=-HO<`p5^
z7N^LspOM0RF)9f&r`gN5|25!=vwVmO%*G~>mXXF_B=*|*<rHp~8TVKZdxX(9T~x_2
z&Klo#*_kW(!!7w?&=|C7YoD7o)~7m&k3I8TBS?sM`tuvwt*TtJ-ZGxN^5SNQ8#oep
zSN*av`J06&yIuDZ_9>Gr3I;{%%NlugI|oWBE5L6s&I)JV7XFbOWbfrad*ENb!`GlD
zmio6!j-b-Pjnk`5k(g+i7?Y;i%x?1JLipmPKYNv8$gH=0tT_hyT%BTN4m%Y3N$V~V
zqweq5uG+YF@oTNESy<Z^<+tT*#x$ucB>&XXmUZ%)ro@JXS@Sr!aSlav33kAoEqH!g
z4O=Gh_`ehIxh`9Q{A4QDk9f!gR1-2eEHct$LFYkEwrjhpn?x7vTcz3Y#pc?&3j<e8
zaJ^FQ?($$8YODS2Z~TPZxDuS6fvu&>{Bl#yL)Ak-`9|MTeau4BQZQ<>0b<xrfIz9k
z3r^i`rs&@?trvoZe$D_;ErR^48ug5im1xfQsr~@TFvCRl47nV^9-a&@<K~$83l`=V
zjEK%WiKBB7Q(lz;S|Iz@UrJ6J>K<<3^5C#&I*Xr=2y4gK_=;L{NYfClx%H~eSZlTg
z?#81&?y)X%bC@Y!Q?x~SR5Iu!EBGuI-4D@nZk+sJ8*umK`#(EmdZ|bYFRWVyI;rF?
zvM!Tj|8P=dp)7g4<gr(*w_T30IB%{zXud-`-kG%QIER{THzp^RXLvTF+ZjA8nE?K5
zSg)-J!+!9R#n70A9!vR`L=<{iwa|(wzCeFI8pL570)lw}@aqqjx%}YSd9C5b>&1OL
zuQ8Ist}E#S3xmu7{|sCK8O)|SpUl)b9pCbbe+Rr5Hrx&lxTonHFJ_uJJX=GpaEhX0
zA%1rC%d~B8fvAyDF)r_QtAGuk!=QVavo<42TwHC99v8H6PR5c}N12upC+;tdor#mR
z1_qM)Mbrx{rCSCcy`T_d_zbbIHa<L`p>4roQSKD`B&D~xM6L(Dqd4Am(oG({1pB&Y
zBe$w1vEvKQ%%`1A%E)GC>@9t(Cb(GMv7w<<O8dP7YBm}7#DE@Nweh=Yob49R(E}?k
zTj2x8+4dL8C2QT0jiy}Z3R!c(=9uN}QRW_=c;xlQ`!bOU0u|7)904jBhxV!;_Vo+a
z)A*)MXBQbWapdn)2uBE9>jmnUZ$ybQlX&xKOKRE2In_r0Dq<R&aVx91{G(;@)b%oZ
zpRtCFS~6SoH*2@X7X@fZ^lP6if4<n;eymOk**qbn3JRKy#~L10J_Q%tK9I!RRBTf^
z49JaAN<e3X^cBgk+rE4{0`osdko-^4?gqP$bEe}{s9e+{kYIkIticI7#Rvh4+sD8e
zeKEPjqUU`%#w{<O*j$RwvE5%gN8`Hc|6$#HN#F0oKRV6GQ2gibO3RvMlf&b0q{PIm
znJSNgKAon_XWHYN#S$(_3*J@7l`nR_@ghLF%(5HFK1RCJd0i%#pJIxLcquT1?!<G<
z)RA*WId!KPdRtUb(-3^>`kNg^GMU>nhEzUVn*q*ly92PcY-H4how}n&td{8y<~A)?
zFINgOQB(cTRh>Y2)(mKoFrHd15gDi)pZ1(-e&#Lj(@vwBJbm-4O6!Q22*ZPTlxPC)
zZ$pPeY)v@lrs%MMRdjEF!;v$~ORT>Z3eTyJGK?zvVQqd681>k0Kc7{r{Ei8-5gCCr
zW8Qf?@8TLTmQjR&cqiwXHo$v$BClQP*G6A<OZ%#pu{CQI4hu`=+gpYxLpxjRTwVbw
zqd-q9dhYa!m#piUzU}*Sl?I*GpZtGmh`G7P+a3W39csAk{FG|@^KC&BTlQVj<7pgQ
z6W|zPT;BH|xs8zp&f0nP*WU?zLbTre6z17(NDq<1RI&*EWO<Ybery8r5RVFxGM-mM
zDEQi+VC*~I(fNN3d@;M&%jU$p!PA(5dAr`}QVqod3O8Ke(e#|4MfrhsOpY;5b%X+Z
zgAjDK=PFsRWai`Yu@UEAhdE_INJN4U{AaR==Hi43PCPI%uz{3d%&lBHqwKp)L3?Aw
zKQ)0mI7CBKd}AaTO7;pfJQO&0Wn<Y6>OWX*@FS<SVBv@gDz9^piBv?}lYSpIol){X
zOb}{s#<$5GmR21!Dqnr&rAJdHb+_ERA~^M|*m#dtM}7^{B+0XJ&0SZlZuaKtc4C#m
zw0HiSa58+JCp#^fs)^_ooV!}HILrJ00+!luC|a3KuG62Kb*@eYos$W8QAPKhmlnAP
zxh!vnD62map_%320*=$h*B~Y&?NLQ>7kiAL^9z)1)taf0kOO#&gp-rtmz`aSHJD8g
zgU&)Y@izPFJyNCscPiS{mb=A0jud*E!tUzxA$zm;B&W8Ev9gs)pF2Psr+`=P^Ev<7
zZM!dx8h@_cr5+xFJh9Q5@c)F(C)(m#0AyV*WX~cIAF`4DI$Bn_+HD$9zka68gnfzu
zR@P~J8Odc0ma)s8K~wmm#lFcB`_Y0y@K$eT4eqvo4B>g8=Hk+no9U-Bl|s*_eLJ5-
zCv5*ZU6S-W0fbP5kE+)u2N*Z4PS&`hpcB%JbqmNsI#&{XNAOAz{!ot@46Hp+e8NK$
zR*Cc2KdA}zpoW9a+YE1-uQn}Zc&Eb#`YqAJ4x{cZN@wG3#h5ZH3oR732a5nX0E=E$
zfbdd4UqNnj^T}9&{-Xuc#eTkKykl|C>B*lAJDW4-g9b-bLZa|Iu_T4kRSjVHoFb;O
zn3|65U@nj2CzPxE23b@}iE=ERSJri2EqG|cuZ#v3AjxXO1j=#RGf-QOj~fg^Dqq~O
z?L}GQn@bQsp2I@uJg2i*BZHBD`L4S&bUI|w>=VQv2+=#Oy}!Py<T(y63P)n~<Mk4b
z_t@?)Wo|Y$2QTe88Be)Sy^e|%{o}D`^eK~RzM$I;qOeo`)kd-Kvx9=2B#NiH8?B@2
zYCFu+^q*5D=M2iptmbJJH^tIKSp|hP#?Nnn<irQeY*k~qb?85wZlD{K1a-J`%ZvO8
zBtG3(<XO0<KO@!D?+&V*{%kB7zpV6lUjLBqaST4)cSW5k@`XruV^}>dyu^9tHss=~
zJ$1Y3SF`O|jakNfn>NW@oGMQ8>r0S`7QzN_&`?;@ZVkOgZ5x`YVqyHGL>1m|mbs#!
zqAeUb`c}G{+d1C<kn8NR$@f_7cw@p>-%>2qZwX#egsi7slqNEK(Zt7G2SUgq+dU7U
zUZGBKXu>HZej5Cp6gN!axT&Xd@4~NA2r13)2S#rX(JxtXTYL%pT#S?(@F<2xprwmK
z49RH;9}WnhF>I3R7Q$cxKYQDY6lremK)tt83gg?T20s~7EqgzNV1JSz$5xk}D)iLk
zn~(mMRoyn`ljk6p+q4G6^dSNN@m&^Y9hq<i7h&W_o3^zGVQJ^0*baMk;qDU6L75`i
z3P7142n1)VAQ_0AMwOe2pI`R-eI?l@>5l@Q)ni_Eyg_cgotM|re;7=6`%~Gbi-^c+
z@a%nC=*lVWevPrc5de?=dK?Uv>$5Ro!`UIC^`?OB$U9%%PJ1%sXC~a6mqlmWy(ez_
z;|j4}Ir^amNz74}yOanxUmHUNrzme!`qs<_vrIB7ipxYuV|wB%UEFa^|DBMJLkWb@
zQ9a6`Bo$w9A1iOTUx5Aw35X_J+G4z3+oZfz`F3guOKE8Jt&brzu!SxRB=L#k$OR(A
z+h5now=+0PLo8a<aJlu*!=|#_;YtZPaq`n&yW*9U8jY~7=)HsHw4DAqdLJJ}U7Fh4
zHkTQRukHOF_prI_>FB(i%cZbi?&>m|ZxE$R3>46qFP#EmBT$OcsX`P{`wW8sjlG;m
zI1IQKIT^E8p&io_9rgZvDu?5X>aLYDITR4=6n-6QTkAy?&utU)ZExGw!EsZQGf{w?
zk<I~*1Un^ld?BEv!QvH>U*nC#WK$A~Eh=OqnFOEfEltGs25E;)17cxg!-zsK6!ySD
zm_@za%$vGamSX?kWJ0VIi0;V;)vQza?}T{B$cjLez)_H2-V+@^9A9}|)tf_kL+1?-
zp9Y=h01TGgymXar^O#H@=({0d-IRWY&|Cva!m;`A5xclgJXTBYt%q(H?m={~5iUbc
z17BL^dtlbgzREEfN)kSMv@|%ZyKd>dQDStsxjwfSouG%BVlXjT!9vc##BVXeRnT|B
z_;_^kZ}}cu6%<|+m5?W<<Opg>^C~Lt+C?5V@*wD7^`YhkC5E$7yp*X-dCOWkY)tQD
z23~DeP)p|)Nc*D~r^2gX>e7(|i(oK|VPXbK?}oS4Szj3|;yq6UIOWed{iB@f?brUL
zR5?FU)Lhc-H>@cQ?1RoS!{Lr&Bd7Z=G-DYV?_W-0G%g)M+Q=o8#ts8woC(RuSS5cE
z<(Db&T5R{<hwS#M*PEt~S(2R6e|V#k-HOMjBpSD(C1@ToYADPuMH2b&GH^r!0O*eO
z%97KPqVOX6>u$eq4*+59owof63^_i`)|o4lw=tBB<B~mmZykLYViDM&Hd)$Em4{62
z3fWJ{Uam-lW_zm_t!2Vs<Yk5jPF%BcgWH_^dGvLgsSHxVZmTa5dLKc0>ixmIy8Zkl
z-Y7CS^aV^ESecxt)2E7U@-V(18s#S;+gRtAWIyLJ8d^Y_V)LuN7W~V>F#;7A4T}_<
zpoIl}u6J|!_<0s09%Q{THb<iX&gs$N{2|67@5`-kT>Q#N?JlCOPlZCVV3QP$U8C{V
zjdu~GB02@H3S4}_z4-5j*oERJqCk@W&7{{bG50m$?GtU}q`?@GP}K7u_WR5TtqgX^
znahjH$E<1r*INzSO#gzxqq&>?{?<K^*Qh(*Az%nGel)xy9JQpr#hy?b6;tk(SOh8#
zgfUyX4?gD4@7^_-*VSb%64u03Y13Z2J;}*|0T7L}9X)Fi%-zJ`NIt4M;NzB9)_mP+
z(dse8PBT^Teu|x{nrh#VrTfhkcSDhOJlU1sUH`4&KP+264(WVa_P1&XbujCz4PyA{
z*{|(e=p#djV{{o+Zka4>%ePCW6L=f3?AAPoJ7W);3w7Ez;e5y#^0RBO)<mJN>hn?P
z;&)nZaLt^YajBy3azg4A`o&0FuvG%M`77Y6gg&GKLhs32{d}}kI}ABN$w;WXrB3IV
zsZOuSoEjfP)zysr{>~jyIA0_jmDC)6x-75WATr3}nLoX3s#d-2Uq0stuN3Nfb_cj^
zf4vMosPu(w`zX-ccNT9vRjyH0R2(^?HxcToE*#i^>NVg@0b_g2rUKhe3T%MD+@@NX
z3Xl1$E@={<rx`rd2CH9nVGTw&8YxcLG~P~69K&H>1%E*`_dR6Gl=S3b0@-jPp_R44
zy~wd~DeH_$XNmVI6;JxBxT2)fL$HZn%iW++-$m|8Zr1n}Lt8p^YWrP}fUlo_NE8R^
z7zao0^ajt3YY?1ZFVe+@4<j6MI2r{11=+@YOtyOowRBA>sJ28DwU_QWKTZH)4`c+r
z$wg>3wWc?*ItSJjY7pAS6_SU>HiP1J>V?uZI%cy*3{f_?$%&$vKFH46Ua@w!R<U1-
z43t1b($!U^C=xa>hf=K6en6}oaIBwFvm&nSWG+>{ssP3&x6_DQk!W!dqyVlzoeqw=
ze9okEL7<W>;txVv6iOQ*Bj>u)-0|w-EZ=A-a(n6{c&2?a_hLFk2+f4OzbfE6kbikE
zkc*(D8SAfU2*c~%nm;;@&^|)Fe#rTfQau1#y{LKkDRADx<t7u}j)X&P)0!{->`a`)
z`a9h70|CKN?hWQ)IJ2`3(HiU<8LC5xF3N*w(f&{L;@3}*#b?{DT9bC;kLVPTB`H4F
z+L0aR`%I&--GFT8^~mwEl_d~N-O<Lk6ep#y^XExrVA)Pvdot5c+s5+S=FOXvi+9)H
zlaA%2;cg4ohP<cc3gVCRI|%UXXZU5ebGk@DK`LY>HxfdVT4Nh+#jvuwe?R)JKrB9E
zlruI6MSOC=#Z<rfSbprpYDFVILZa~XSxyGB*k;~RRvZQUQn8QVj2jikt~Jaq53Y2R
zLA|js#{H<ck*l?Pv%%0-Qx74@*g?necs|}f3-p}CpwgS}1$58Ou_>ulZOMy>oRt3b
z8#(4|`3CAgE1^!1+|=ve&SxH%@1ceN`u)6F@s}LQr<OkX&ky83HQj&P)>UINF(*1W
zyT83zy`X+LPmZuH1a~8IQPHQK7D~)9a(8+}k2AD-%)kyT!@MO@0qqcNCKI~mU#=k+
zpS*{!lyZN(e2c~B<Bmpo@M-GE)O?(jR~}~ZBJ!U_C5|(j)<mXFc{n8}7WxVlAR`C{
z%^^O?uVC%>!khMvYZDR=l%hIS;k0Dyvi<72?cGAGCA2e|9S1d@M?``F3P{#E%cGPx
z{J+;l)KgO9?A|`A7OX&Dd#NXgv;Iyl`btfsPR{q4%GoTp+jN8IKUeT4-0+y*L0d6%
zxl<GJV87(|z4UkqN9B4>*QNYLW#Lq&I?3l8KrIMvQ>LC`|6e`!J94>YU8s6cRwgIL
z>8|wp5q{wMadM0jV&sl7-rd@}ls{m}6D>)JX^5v3P&AS9RGt)%KJ^gF=234(UxWV;
z;7P)GSX6Pw)@GaZDGaZpLe!tr^e7q9U#I}GZpBa!<BX`9>4ppyT#n#RtThb*s;!u9
zIuUC|;r#hp<<_?;z>js1C1fi@(y(LFG-6scVoo&RXX|j8XK`nl16Q!&XPLXMuEOGP
zrKAa;vj81uWS^vYpW>$%hd@MU!R})QvLA83!WypSn!Dwi_tFF-g2%T^|8wXARvNN|
zDKk&auVePVJ}^kD-(Tb41ZAuSxeZ`GRNLJ3_%XTLfrZ1S0c9c*EH3XX(Irg4w|COe
zSQ#>khGW7`6}1<Q?uDo9O}#7+NQb&3XL)Xw#U+k9Q@Oe_qZe6z1owp<MY>-=8vdS}
zIo3Fd+q3cEq@mUyF(=sYb<AF<K_8HSgE)I8@8BSV0RmBp$EUaq=S@=&(ICCY`@zqA
zfNlB);%y=Ar~fYR`VkL<DAnRzzyXolbZJ{3-Ys@pwT3MoOJLC-`KAw7fq!>uhMA2f
z(~&@8i0yB^cQvDVnaT`orPiE4hIPZIm%s=d-s{_Rb3W&=_cp(!n-;2=CS^XG{x4Zv
z&&f;@jUz7z9e<pcSzR~u6O%}_A~2JeI2f-wTaugA_9;}wv)ub7LlH;WTqbl(Y(GAh
z=+=1Jd!)EDGN4zvT!-cC9cGJfKu>eOu%I+Q$Xq0+v!)DUbLV{ik1`n}Ap@lpM!1`h
zu>=dET}Lh!(Mtx_#~TJg&Wr*dA1I@?5piT2jjr}I$IW}6*BR?DlU>@LU}okrdW}RF
zIku+m^c@X#tnKc9n$)8IDe3&8-WapHKS?XWoz}yzC{x^V-Z4H}SN6;2a*<EzrNMB~
z6;yboMT}@OTap#kmxT=tzcHlVTuLX*%*>3H=2n$(4MO%HmiU>XmeCyLbfqF=jsFQi
z)9A3F*VXe{W@Ji8o|!?`pBHDe>)!f1H)QkeZ(UM4&YH!B5ORC6NYjcGW3U$~XrNID
zqF^F%z7xqOXaFfF%p|yzZLBIh_EOq5xiL7mj`S^c!6DJOvqfopUH2#f$CVIP@lqk%
z!mpJyCx=J(Ep|6&8_l*~Y`~37@G&!oMH;3Ju2GK2Nni@j?fVtiEo?5@B~K%hYL5TZ
z?fOWP7aNZzPFiog?cXwzKtaNkFxyTLqoR2&qXm3YX-keN^y|2yWwAx|K4fZ>Ldg_3
zsT70`@kvEg(bGnNv}*v8g}L=nO#@KaMMP6$m{S_I@6>G2{xzG1{1M)+g@K?%gSEs5
zbx8^|#QYp}7H7U;u=<r-+=`JOEule4oq?(V;6r@7aDTql^;)pN+6zm8w3=W9L#Fm1
zHH^1f7e~QsS96EejHJH0Bm`%D8K;}y${vDss{<^I)>}K*71PcBBfX=&Qywia%+@`c
zI<;ZkN~Bn3wDWnp*2n8ms0K}#$y^_Ie;ARJgv2pIu%k3+ErarV1@4NHioBPXy@{0z
z!BBEb_4CIg1VSo%g1HroL$mX*r2`*AjTpl0aYYG4cA6I=D;t|*yN29?%B77i_<TvJ
zI+p#>Z^O}W+uNKZPfA4!uNEtmpwY#DEznO8ll*@?Nat)zNkK@dZT5Jm$z}XVE!>lw
zJUH6?-s9?t6<-0=tBD>-fylPRHNke^u5+is7BehxRc*|yX_%8U*H;z1Cxd^q@!8M3
zuM_j*DzqB-tzP*q&2w>~c8G+6PNOxapb8^Yk1SaKI?s7HmO#|o`-x*AI?nz7v;Y(>
zUfh4GZHr1u5{64SGH}<;Ep1B+2e59_2t0Y#GrEb1k=`16zXJx><{sbbOBI=TQ}-!x
z1oTMJCns%qKW=3$Gev-I7MPiG*S)z)T>I8WRG4AH^Y^nwo6mCpJuq82e0)K0f#VYF
zCdz|A5kA`K&+Zp{7zLm&34KgH;|xrPVOu+KHd_bA&BXxZ?!AG48wIGkQ;L0U-sePH
zNtV(N;?hxM94F|_7}hFBSkm@;nG+w*X7azG3NwoeUEbkeydS(KENFMuRQws`x1!9@
z=+cpCGxYl#VRGL}9b`n@xi9I?BMf!TpF(4G_RDf;T)fF`V(r=Xvpf*%*8|AwE)0H&
zMcwn!JZKE{Q;@W_M(^o(!X)%MB*|D8VH{-*nx=Xl;9G>1V>+Bzsh!9_Uqirs<Dd(o
zjWjIZTGr4|^yJL%fUj9D?#2&4+3Trl3o5<R{5yfybF#DtOuXlv%EsQQIGA>4JmRyY
zZ!+g<`cdj*ezr#h1|CbB0+{D$<N>I)+WeIqSeBuAJ}0<qcY(O=gZf6ObXXf!BQl=R
z#PekOJ{7MA>cf|8FgkCBQIF^~6qJ>(w`p}!(XT4^?iiPE=f>}z0C$Vl4BwH)_j;x}
zqD=i<e%8QA5<O7n(AYDLN;$k;_Lu#rtR_sq(!cjV==LhtXd|`8ORgyZI5=^<fR13b
z&)Hg`<=6RQucMJ(fq)(PcV^AmGs}|fcT7-UNOQo9YJ>Q}=FNM2P*OMFT`I4M#l1MN
zywiS&)|gD$(7zcLezVhR7?F=CEN(os+DhtFyL+B_#>>lY<NKG2geba?Z`8eOld*Iy
zcWzEgt#ZS3Ort&7dQ+<pz=_G~mtQBES6rNpLECb3TLJ&HH{Jx;&<xqe^292yeku+d
z`?o_Y@4P8tl^J$)lyka}l)e?Wo#jWHLD7ll5Oe)X?$=p^Tf<3r*rV7!<Y)2&S`B^Z
z*C(&>?Ye`APfo-O+<5vvk=Nf}?{;`w?PgfHViq#r?mjzfA(s}$biWp^vtOj6+07x<
zJ{ga0cN5QelyQW^0=`>p0L*+TqgI9o5oe8ZNV!2tb5>&@Ma{?r)9NVob`{9sur@te
z1-^{%k+8sq%|k`3@vgL2t3hAF(C$J*^SxaEeCg}lJSt9ds=SggokN}c8+f*>0t`F5
z9O&`HOk5!6c9fA>RT`^Fh=aCykmLD_f+w}demM5WGl~8)^5BAOy~0A8-I$9UIUhQI
z*g3rh{mfn3jLgr9ceG@4D8SonVXk#nH8x#6`^9Z<h?*=<A$~l_5^!!LTc5RVzffEo
z|K|(dPwW*$<F!$&?Hy-s&S|j5cRr(%+H`$D@3hi+yQ8CnIBZepC?d~qq-@j!G(2kx
z^{JLR%SRva{rI}pOmXXShbdh}p;7!>SxbR}IUf670~5iPkT*+viGGACrm8;|IIn&{
zlrI0THm648kJX<-&}OD#JB<tflIQvIyjrPa=6j4o)2E{u*HOQ9UneqqLR&bCwRWWS
zzFuT-cf=x&X}s_FFp;k*1?NCc0o4PizDz+tz~8z3advXOcY3X~tT7#XYg4)U!EUp)
zBb}k^UY#>vGMLD@a^FBKzL&!s5Y3~O##dWFeWXYs80kn1(l4B00+o<C(RPP`oh^~A
zHe&!=`j5Lpv~+e$h<$GQkC1tZ^}33l9`SkNe7)(7K6=L4XUW$@B`Y{E-`&y;OwY_&
z_tcQ>L+qZyt2=1-vwt3&mg#E*nNfl3MOF)c6uDL^6ByayO8qa3J15=YSBScD_?omp
zc>Ecjb7nnr*CM0$v=NO6OU|+fs-9&YJ1cW?kSunmo|WOCZ<}}Gkm@~=I_!p{nm^b0
zg{b_SK-1Syh9<o<f${=s(@%NO+g}g|M%^j0d?>B2LQZC3b+!XSUe^m3cjk6*RdNN;
zZ@f;hZZQ*7TdSv{+X3vYmrwq&MO}x~Q|7h7&u#j>NHPMmPbXqFxsVOkb5me?kL~->
z3UT|vgWm?0uU3AJ(>A2ISxx=4*-$|pBvBu3%X0ntmDCg2W#xBE6<J<bcbsr42sD=W
zG&ZKxbg$v3@R9Hh*)}*%wBBquO+tQ?CbE5U*{*!3weNn$Ye2a*17s0)i@<=0PL5C3
z#*97WbdKPGBv1l;J~sx&=v^IS!*R_Tvm5WFWJ*OF9SIA6^mLU*qr2mxMhc+3v<Ipr
zqCKW-JYB#J!~PCf%Rd2bxw9HA8s04*5X7svBd7GGC`92`OHUB3mOmM!IQA(BuJ}7*
zA7q66Zjry&jEscFP#EBNE&Rc^ZWd|iZx}r;nO)vQb3Np@5#hA{zB|r!e*HSoV$eo4
zI3(^gK*7n>=ohfN-1(-YA>ED&5qm<ji>;xE?(``->&5`-lLQ|dg!)fWVg?vJE=GUL
z_S}-Ws)zczT^=0J5po%RdpEM#_LC)V+39>nvsPXTTxo!KbZJkpL|W$Kfx}Dvy7kc!
zvU%CHsFDG_Pbo9iwJMV(<+385xsxI^j3ua)`gYjt(a08D$~xWWeK*O#-G7bVds?f^
zv^V4R6*<1!NB;E!@f{{JEXqyoX6sc(#L{ambLE1gn(LT*uORxOSo5C?kC@mIa1-lq
zlpK+YBKrL2oeQ2|uwJ5vuL_EKX{6fO?SOFH(F2uQ=*Hm)D8V0h$exDctpVA#5ZY9>
zBQDEc8qkXXr>>>4UmNCl<NA#)y;Q(Ojkkc%p82P`2>T@$?tO)&I`U?N9)Q*S5q|Q?
zL4RXFXwA0H;+VjtrvBQSIEb6%uwKDPsgsBUXe)pNTxq4GKuQzx#O%d5A;@`bHl`SG
z$d`n4kV-=7o17=Juf=s^69b^eYv!^YbIaF_rbF8D-(6%k8RgoL7}dwd^+Qb$YKq9%
zRKBI@Q*5#tda?G)R7X%j@W9lm{Au_LlCbET?II|n-Txs)T{nhwe`O4p+8ZVjiEsf-
zUWhefjU39<Ml)<)Sru?!;8~Y(y45&ICFu8Quko9RgNY1F#`4LO-g#&&k-4IzwGsg9
zd6kd&sd%z~%QXS4?Kqs@mx-`guc}BX^_UitpJTLox`P7)@d1>KO9b+GU&!h;8(hQ6
z_A~kp9pe)cB*nELM&I|sqoVo`*_0gI=m_m#9v&uDE~|~TPdPX)v}A0Yt~dP=7x)_s
z2S$$dDv$m|h~TiZaGp4LMa@1x7txItmDHV29uf6y58BKtg-5bHZ2LJ2E-N(jYMUaK
zQ%7=v=mGrhjrqbNvNHm>Qc(~r^hEOOaRMI~*v7fV#<iDQVxoLh5JvL?88CCNm0Jy{
z_3W+b^VKpgF_!AKay$rUF+=hPuE%uarCw;C+qw1M9G`u|Z3B7$uo%S{<%MeCx>fg(
zH0c7@L!)<=>{8H}R&eiEUon}jf8pY^ZLUWle~Vil34Q3m=2^-bENxIMbX;kzBd0SF
z?~9C!Gqu;{hIE>jlx5qhItt4|<iR-|H7=rJZO#Mxks3N|x`bt8dO92eC||WS$JZfz
z@*<`1?rMaM8<`Hi2|_`+0LR3YL(Af|{aQ2iuAaKw+$7cgRvFST9mUQL9ncE<SxIV)
zJ$3?MNC|=p?mNrVXO&vI7{3U_7-NIT!@Ch$0mE0${8ap+b)Ah=ft1;IL*(r$m0#S|
zFl?1(L;;fca5qWByHv=m(7!zN6(D84!AeS65A7z34)rpdowc?<&-l6(@9bmIC1YN6
zSdL*+bM0GZHwGn_z*od_=yQG)2Qe4km5-MsSVkC#71mwVY?n6dXKML6&i)L>e0vki
z<VkxqS$<#1PWiES@!kV`2SxR57*ekxbIbR6%O+6o`KPjS1kJo)Q7>o!b=io|hCX9B
zzArt?-Wyy(9$Q#k9F-yU+3P%89%l9Z)d`Shl*R=3fv-hZ%+53O0BLs?(`2&Kh|fD)
zSy^6MH7WDY-`5Lh^FTr)^`6#a$q*3aP1HTVfxeS<*OBWE6if+!H^h{Um95eF9NqDO
zpU`}2?ha+dUJ_?2Z@_8xQ3m0S(ZPhZW>=kF#n9*_y}?jt1LF}eb?gKiIPyH)k~|eu
z54z(;1UHo(z_a5*c2*=qc0kA9MFd9Y-9)=>c9y4_B?H!>@m$+Qhe;OFF+n<VQuEbN
zf4$kRokGx5lsAt4fxp&uiiiZoQ~BfDvfea*%T))d!TWNcNv_2!fMSLX+o`~KL%~_Z
zO^H6pvNrn#p<6)$FZY!=R!%`*Rph%2UIl_qkB2IT-G>VT7I6EA@)2kM`9q!W0K;&|
zK27gm{FG{)$$v*7Cv#x~4IymD_IrT$ffU%4O3d3k7^ZUK%s(eN7tra6S-q=N*~6nF
zS$~(U)NY^0+$<j6TE79pGX0T^?^0OUqK1o%qFa^$^jY#eBQd<cxvaLXZr6U(@+SX&
z`HQQ6e!E6YzUN9P2OTwm4^pRGg2*yW%aW0uC<4@(HxFSdB%vI^1L?m|bKxaKV8W39
z8juqWuMno?tr!BJ;M$*>y~*?;-3(xMQhrkEV+o^6>0oLGtBDG(OD<I%<>2{Ium0F%
zKr7rr7qz|7Yj4V-vP&1a8Q#><^9EDIqy=);`Um=EtKDYw-mD{5mc~HQhjZRcMF^R-
z!+1B%C~nd)Q$zaA$Ay~P1w7kX3ACRRWx@)yNm9}Cw33hTo6rXoe7oOE&eLrX5bgzW
zXDhYUv6ww|N@=TpI-@6OFRa$qTFY3O2bm8Y)Yu6z0|sXh-@*ol{|3@E(`_{DJV0kq
zTj+!iph=WFQQ!OnFQJ6sTBX7FvgT*z>%0c$Q>P{+#ikF|8O0fY)DL-g?jhXEm+BIj
zBlUh*Z)gOLTfoZ%V%kc?WSLWg$1B~gQqli<t=Li6<Hsf#$HDz?6d-<oIG{jU;w*03
zOF0ZXiVbc=9u0nbLZI^-q8C%2JzO<oO8q`g8+<v;HF6<e?0?n4%x%eujJlf>cYbeQ
z?YvIdSJC#ATlwvn6#vOzu)V_A^J9m>7Tn4Gy>~tN1EGiEtWxK6h=@5=Jv`rhHJwOe
zM4mLYR2QOgLt<rQk?VjtXEYV)?xcg~_nl=+n1!AvMUzN3n0EN-?W$*f!spT1N6V?R
zOJH>t&F}u^X8*Ro{_nk~5AQXgtI^Xp3q*Q46mf^4*-aPmn5audFw17J1>QFX+lu1y
zt1h~9{(A<l9Bsi0mOEivFzi!FK;pYu^FKdt@>DXQn(_)H)o-qMblSRiC#i3-y`H04
zHAR;h$r6G>%~lCcFtx-=Wsor6>LV%mfC|-tJRbM-Pv8QjK|1opVtj7=RyV|@0Kk&v
zVXS|f^x2F2$aZ6MYWp&4dW=y-;OX==rdxCL)i|TsscWSM=PQR3=e5hw_O8)$MQ;7a
z{LriS29D8juuQ`!&gB=oFMnfaj-Nc4wo)g(H15X!vG7+if0)_N4GlbPMx!C<ZEr&L
z+O{}67mpaUWWJ(<>G#zach>EMK>BW3L{LrsR>-2y)<+8ne6x<_w)}JIg*|~e<8s8H
zIS3=8M={GEKk<hw(6g%qZi;vRuWsf6{$KS9wcD|*<8L~zOJQ8!@XgQo5y~{Zamt-l
z6+N+3AsPjKH;A8{2%soskw<W&ph${G>X+wxWm1DDCCDzJ%sWUd3h$aJ{cWMIe<x$P
zyjrK)##X#p0fUMYH9TX7AA34)^jJ_2`>>gE9d=xgN4bx>Q~?l?Ic%B<;V~n!a!e4)
zs?IXt(prrY^5C0Uvn{U6q`$T-o0qS(MAKN^Bg?-%h>21-ugRX+y?j{oZBfA-=DEH9
z9P_;AfXHOMsTpHGJa47uj9LT<D4nri8`4<4;Em+}8qR6*DZk9l?(SzkP(%}%eRxa6
z;fzp?ZxxsbD1d|U28g>hdB=<=3T9aSsDnlY2c;X_2u6J7I_G7C23t%np&Nw9sz>L|
zDUVQ(?lOhbQRU&=UF@*QT%QY{!NH98;4cJ=JiMh1MlGBtT9AeWWyXd|L%%sa2t<7H
zox$}I2HvJioM&_*w<7<IvFGJ0lj|Mf-t$X|UV7a9`1=U|4N_C{DJMB=Gs)?t6a3@u
zuM)qn1LWqjo2$GQ!+xkcwWDo6O*T2qO9Iy)BFIae7z&bs!SKf#ODni5IX~Q@!L!-~
zc1u`_3eGF1pXo!kCVLd6%(wSa*lVY>F0gC>W$DIab&9t<zC!Dk`Hz#;zuZn!=;f9-
z%r@_i(fklmu})0q`|whufOeNdFFQ^L;8jQWERNkcDbLa0ci$=77RObJk<4x^u$_jG
zyJ!8=iqPtqddm2-2_Of`Q(YQ1ma;sajIi(tJs(+FSy@b+fTozT({+T0xHzd<7C$(B
zu)Jcz?c;Kesnh8iLk%9!)MyXT$`L0X+3!>CYkUckN;!`hY(P7=hkBiocRifr8Q<-d
z7VG1BafJS>GV9nhgA|8tRcT(SPOZ`_4sZU#6V6}FKNpZbq{rn{AJ4mx<dgy$jVLU8
zPed{b3mmdfS(>fwDB^Dm1TY#36zW)&idp3kYfZ);WqaQZeJ^kMt>3gBE+ZpuzDv_X
zt=$olsG12j1Idkm!Tw6l76Cbz=6LLK5KUxYeS_pxJ^xEz2HcE6G%mQckl5fhPV4tq
zZ7})<bl|NJRFQmLSDLsCB%CJ%X)qNLvn#xVXkE$Z3Z-=}r{GPf7N}Wm99N6a<n&7C
zEPcpZ2K!M}_u2@4L5DmuONYtAIw6qE%|My(#j2ahxk}-2W=2uGp$9i}C`4qvV@5$T
ze0PGC5*Z82#50<2Xty?jlRD<B8-a~Y-|w=fMt5@yTPiB5s_85gVi&yg=9-h+_Ommv
z)DJrF()k6(2?|51_kmA&-f7MNBlsVNiTTXb4T{VvM(M`PfPJvLZHw0u?42JpO_}DJ
zEK+uwbJat(E71F|*S-O#xRcGRfYV`gS0!nFPXovX-^VX5s`;sJ_&B*^e9vEu2Uk#F
zT~}J>N&e{+oq%T#k7>Djcg5O7E$>7}kU9vqpT3Xn&n1;@X$i~N4EPEVtuqEJ^sNpS
zXIxK9ntM%A)s|jJK^TgQY}A<t4bKBs#<13p>NdM$ShR7}EJ!GjwN9mME2A!A2+O~v
zKrAM=AY)jWt+WQYefiG#aI;FKlMAVjf|-a9vsJ6p(viM9&`|4od1V=RLQOT^qbZ~<
zu`D&__U6fhKv3NHL@Oi+T=>XxIT9^+`3W}>uwt!td&>gq{z{t`(H5-E&$O>SeeSPv
zH>jpy!{Z{%rpBgE%bRMFnRvJRc1TJ-o=d_@zW9+{x-aI-D|$u@kb}DqW7<!1={3@M
zC`spl#X`<D@KC;Df*-)OiZ*-JBu&ad6gaGM@5P=v9SVUz*5|?v#_%z#i^$<M*k%ok
zFjh+-1*_c}q1pSm@?#+Z;wIbO6q&E1(eVpeYukRg<7&gb<z<^lSn=?vTjx1CF>4lv
z={sdS9@*4s;&}GEvq&85TG$rfz_@_=%}HyW#*9rK+P~P$GYf6t@re()^d?i<xw8z9
z3@b(tKVDuR{jj=dg<)gE6%L{@q~D+w;I?WPCZCd=BxSj-b*^F&vpMy){bGE~d{>3)
zjhHf4fXbQv)kd>yEUc3~oONyPJnS(TLOoNZUg0rL_J_|{dyW}?Y3fB9bhvF?Wy#44
zJ2z0vbX6d(y1rg(ZVt8Iu{S*(;EI>&hCVwp_mEWchq_Neo};Nz<|M-<2h$0_!3vVB
zQaFdXLhR)HE^ML8pw#9CqJ*EX%$GMjZkM0x7zWH2W45X_)7?B)iR!oi#(dTGZ;PpV
zGy;wKpXb?$>a3h}{u&*$8@37f(G4UObTiV<phEm0YDRMzgJO|DG`KEej^@9Esvr3_
zf`KLHB*)k7di7|;w!F|_bCYq!d7eSTL6Oim5=(M*qIl8`_HelPSKen4Z?nl-r#A94
zPD|46=<Te`kH$-NO$W^MNO&%|!e@=rSNKsnzWL0Ww0w2ExS^}&T*?wflH{PTIVg$>
zGpM`t+r4zO;011c<R$}T_G$<B>IaFgBilD850F@aG`&kYJk%95h%YX1%<rwwbL$Zi
zuIac6cKS_Pe@EqtTU#R$_3Q<<*48?$*M3EI)cY!!WFr5-Z`OTQ$*WQ|lR0f?sIjtG
zYTNtn<Y)c04->@+0P(5fq%aOUqTD&_=jH1q=xzEVFJW3CG^Uwh?pNO8hV)ehU6%oh
zG0X{3p(58$pf#9LZ+oN40W>8(3<UTn+&AUy3_08h+7mu8)Dpt}Y_!LqHS-hF9@yfU
zu6sx2GJCQ6cQI^K|8E#`$)`2`A(uh?5vCj1I%Im7tX*T=iz3p&{!y)(sc{X+bkF!l
zua3iQ%4CEYJ@S3>x%7RnS&6@fp56Ohj5Fr&cKu&Z0M^djoiz3LTf*zRZ3it>Y*fy4
z$ju~V2!^gFcSEB|9edz;6|mNIL|v$B*tE&%7y~KZQps>xdvUqtddf@Y#_i=5|7$)R
zJ_oI97(&Nn;G`{x__}<rnT*`D1=UA`t9!0Y(09|-JLZnb`}Z%0m$-!Q+diSy?<Y~e
zSXd_4!x?sT5|}S|=b=?V`~_mwkb}oAc3H%>OsoHv1NCw~^%oMtS+Rx5Ilg^FnPCFP
zc~wP=VA#F|``8{E8+L^)?zl)pGB@u>#{YkymthHh+z6H;W%Ms=&I>tXsQ-FYB9X@z
z>h9x)yVxoU%)GkFY`4MAX|1tBB({pS`UyMsWfeVCj&OPpYpc+3ASWmkf?vQX$1}u<
z=#3sOy>I#CwTr*|<0{NLqro{hj;EmT$4BZhtGyvO!Dz)zm&sUapGli$rDdf-%d`f<
zlh?HGfC3|dyfpA#9fi>6S8_g7FPeGYsJc{^4KO<^G08|y?+ucTofGCgV_d%dG9L67
zIpwhZ#O#1ZtGQ9ja6<dw{=@D~sP9KX30!rjVSSmIuyN7DfJIdQ{`t$+WH|=m6z@o9
z8-?tN&$KA|;kAo7UE;VIA=xG?{|vjD)PWfOcRh7G%2D)iAoNCvQ<--o@!am4<Y6UB
zZ>v2*&q>$ChSQDLCg>$Yf?V<4le$;Bk0uh|0$tf&#|;!6h7TU6VR5H1diBJF9ycS4
z(TvID8YI6_8)4J$W*a^PWD1%0?<3r6eBKXpFhX&v+Q0hNA3q)>qJR^DybRt4rqJ^E
zaIgS%1d(x;Qq)NU3|TyuvFir{LV=nIZhOw(XnuyB_vPh2tT1D_PELs3yFbw7<ZKq$
zp_g~8-r}WXvDw$|H9RYJ2kNo2us;5^>&&`HS)|v=tBPA>=s$rO`K45-XLjqg2(X8|
zUeSQGdvWLM@Q3vh&@yhj=k1iKl7s1gUOot^c0_e7t(+gDsmi>*dp}SL&CO23F0a6E
zZw~9(=8E)UX*rQ+`e!=AKW$#~g65?_xV0KUFS`{sDG6<n1HCIP)yE5Iqr8jgIX@sh
zQJVy6<d+9!Q0!JmE46mZ@7srUgf3m_(Y43pyGuyF()@y#*ElORcnKZ;5Z24?*pnjp
zhubCdEF?;QDW8>wJ?mdN%q!OqGW=^oUgIBEm$7(Ph9^Ib@bdWrpmBX(1-O22j=T*t
zxuV0kVOv={qo(HgO66L(Sfoge96d$`b-P}aU%nI&BaBaRI&YRd=m-pbP0_<5lLgV4
z$?^A-P<bD-?p+17KU*|7BwK&X?NVz9ZB%;k;enb{EKzQ3uzXeu{C(e>Gs>J!8wPMc
zb5#Y8Y7NsE{>Z|){YTq-xv$6%oG{HYBNwMJ+X!_uQU|$gH?Q03)+@24#bM2suzf{V
zQ+=0fucC$KzRNx%+HRcJySceWs};F`hE!q_*57v}+r1|Z@+()N(g_(+`=L88EkqNi
zkV-hXHUMnoT+ZH%XP7Nc`_V&~t&LZa#f!|RU1k5LCv#M^Nj`lU>6Lc+)=L4bT>CHb
z5?7bDXo#*IzYAmWQBRqu>8mJ^nOfkTY)z~4&zmtlPEVLx+Lhr?KB2L0K^z6xe3PKb
zu4=o)dVkK#<-k>TncF!dvfbHbIxyeV6DkfS+xB;0;RK<}W`Sc)w;75O(uLej<OInE
zrzN^nb(h;o6_v}5CkIS|(Uu_@@Sv~<=*O4m=NGQ7U_UI*dOvux4fH)8i+SQf`~}ms
zf9}%h@u+8Sw^sKUB+RszT*w8S=1k1;y57gDER7vxp}gllpQ6LvU~|Xj2y*LCpP=X3
zIiBKXj9pMM(yjy{n+)!MI%!A~>^*NII+_w9K{p>jkJD%T1UrE3O}_c{j_lkV**bmu
z!12fhVpqe;M^Oo-0rR!w$Z?YOrs1tJm>izzr9bFhv+^r)FpQ9-`>{WZ!ndUQA035;
zq#nhWaati>!@=RQdW7t#OieH)3lxle^~pcmO^a8uczF#Wl<SpiLFIDlYc))t!@7oj
zn%9%Fq1tx`i_vXh_giL;O;<Ln?N!0-)kR)&>zl-~bE8)paC+7Id4bkl`*8`kW6$u%
z#lMO)=gBsW7;E1J>mOGWV5MAc-_dk18K&8my8e{h_hwoUAoej<b8Zdvj5T=Vnt{C!
z%mDr7kLvTPd#;OQP$++Ed>J^tYv`yBDL;cQFUMWcSw?lXl4pelmmuKE!qk(Co8Ht+
zAAJS0R-=7Sy8EWnVbahB=RZ^Y`37{C=+za33g~_6mM38J4lv$_+CVY%B%DHJ;wdO)
zRTuX0amAv)eR#0C=Ic~vOLM)Eh|Nq54-HKcE%f2eiSr*U2>fMw2|Q%@m<N3Y7;RjQ
z$#vm`bb;^^J0w6ktxG0HHOlFLV;wi(smp83sk|j6{)e!P!T)Ii_~{;Br`2uf4KBC!
z3fnxlc`_k~zwHm6GxlQ;9Sjt%IRAQFn)9`DBil9-?h*aC+s`_bu%t!u-MjjNHFVS8
z;G&}H(&hdDm0^DNhj=R|Vg`z)Y*;2d`r4gmrET8*-Ou+Qc0G&N5x)#^p0b*n%*~YL
z#_xy5Mu6X)g=}L|^u4H~qw*+WeBco3M@vxSf+*^IUcM*i?9xHC9y0Xr#e7cOAMpX{
zA~a<eFT;WkbzBO|-DF<|5F0MYBj>ChE}`=FW{q5;+zCY=aU*FH3`N2vjKvnpguR|v
z=B_T&wJkuoVlBJ2dvkYYq_bS_cGRfR#^nZ8sO;OB)<mcs+@z28b`4#B1fk8cGT*xe
zTnCl}Q9Q8(4_0>JN#boZodkeo3~fLbBZ@X?Ndj_(Cu8|4PTK4F;1&4t8eX#7Dm~l~
zJxkk7D>jD*$4h_OkIe?RudCoG``e6JdK0<zd}n$A3-f;e=`_%H75l<Xz6yB}iVEic
zeVTF)kWNk|YQ*|{U6YuIdrvIAET4{@LeKVk{R-jTV1R|kkutZn^^kp(qK2g1(y`jU
z88dHCnx_v&CUK<S67pyR_<sQIKoP&BBTweBSN}|I>@h@J`-OF`{i)mCjNczH^+33+
z6l0ABinp7$$L3oZY@BXq#QmlZtSCxwdS?Q#bGlP^Mn8birUE^)YEi;Q3Qm&Jx>T!t
z^lZ}a+z|HpbViujwPfS6N^0E)zuVi{i0DLa95ReJ=YAHF0_>-Lv;P<B?cgoj^NW>x
zKW>TLlL*+;_a+6lRM4FJ9|wrfNZC8AKR|0;Be5ywmz5lF{`9>GKvQKc&DC|x{rhWF
zZQZwSJ~=0ypWJZyJ_$=`1omGJ!nbG_G<WYuhBshrp&S)`;AG>gMQ!}?{wmyV<E1O!
zKod<J<>aTBzI}zAyNu`F{gZRa%NbyL44v&NsbTTrO|-TdJA2`WJl+mguG-GVO=TQ=
z%y0$`4Byj=?5uPKrVpXG>MQc%Cgaq4c3(h1*Qu>-COzG}Qo)p@l&&uVb{3nyPS;3|
z?hgci6t$u#rs{nOfV*&<?udFBDG%ArLM@G6S{plPZ}k!I2WV~j@ef&Nw2kOkJ5jNA
zqT}q?oxSgmDo6u$sV$L}g_m2>r+pO8iG;vdfvZ79tBjXUT$nzPb8|8d*qu_#s7E9k
z--ro7pc&emp?&MVAGam$DIKzXml&k&`MqW%DskU(qPB*X9!&sZQ}@obyTr|#cmD;S
zr_)_tAsBteaZI@Q|Jgh5@HncoZ{IUpB&~Xv)!pUZFs@)5S9-@ldihczqyXt5q`ir4
z5)u*;64EOj?9knfd+)Y-Uv+7v?YlGQ`$IOCtTwwlE6GInb?E|2vvZDCGdoZHJ*zP2
z6~T>2Ao7b9xPKbjX*%56s?`j}o`2+y4uuUrZDQjq?Y+EWU>e-#NK0E4)NA{~?^md)
z(OyTsc>3~QRhRTYsDgb53ORkI0zHP%yIdZ&Y&}kGK{g8)OhOJ*&%(m#ODTEhES2{C
zjEh~0EDi4Gab10@t`0zQg0^#6YkhdV0<&4a_th`RGmba_BaATQ3@fWrsa^L8Ns^uh
z`VMUlbA&3Wt8AyHq>cK@4(ck~sjq6MxyC_ziwj$;J1G75$Y>*}nXx2gM3XWqhRiYX
z<cv!sdwe2k*)c=XtQQ1vl3=51UH^zY>XBcBWrfaJ1lqz|8Yw)kEqb~*aTK@ZkLq_A
zg_IDW@!uc5*3K`^bzK3BNqDNe*O0qfZThXNf#{@54v7D<X{gaj@hti5U1UwwuDh=l
z!>mz2Xxi!R9&MKC<;LcFJ01M!u?Ed0KfU2r+DT2-cbrCTT`T@B@~ZtINitK%he!EG
zRRvqNod~EGK`Up^RbzL!S-E^>Sb77djGKVG#fV4gpvrNGyqI|m*4P=d*+gQ3u9^nK
z#YST?neqAhkMOH1)YtjR$<=Qnu!P9f?PMd2FhbA_4+o(5sR%XN{VPe5J~Px?2?WKb
zQgXV9@-xkpo$35<<@pxePW=@t+zvlgMXgj7^_=1v6=P!Tv{WX}PG`cbG$zf>AUba7
zhuHLi0r<IUU0)!N%Krk~t<5sgiq{^Y=VdK~pyaqVgYwSooPkXOuYM2G-Vj1?Vp|J`
zwsdbCbXWWfGE*)!9A7LYGA4thzrkcl>fMOVpF4$XK79v~F&5p|>|8h*4E3M{Z=Bg(
z+8lJ*(78r?yUMSA-o#7KhvsBSvVj|~zMI4ZeHC;Y>a{nKPRyA~e4M_<CUjnxJ9nN6
zi}8Pvs;VZoY&*fq>t^U45V2SynU;4I$4mFo?z7V1K2KU?fv#)xMqX|zixy2L+M@60
zxg<-Z#br{{Tt48j^;Vr70F{wxz$1(>3>bO`pk`gRVv$~uVE(`d4=svcP;#=7)B9>U
zxwn?{hwH*(><5a=?&H+nT2Afl)Do8sGUKPGGGj?LbC%{Xc6w^qQu-nA8MU@7LC*aB
zhv75&Nlgf|0R04qgevH;4cwq81If_?-%e^xBKT!6>Mx4q?0}uG$W#^e{9C)7DtPNV
zzq%qBz?9O(DY#HZWKJWL2xm-E_Ywo6*~HwntC_lHQPAhqh6F<9^1)hK5d!QQGXRn-
z@$Or8{_jT(w6=ui$L6Mt<3rbfoKfleE6vmg-~h}Tr@Md_0LM?1Q&bXuHL8k=1`Z!9
z<*M1bRsjMqW85r`m+k{Phqpz@vBaCRbYBM`BGSad`2~y{J1Q*a2S|xe)8qiu*7|_Z
z1{8Kf8U}X92qTOzv^S!^cEbu;mi{fl;7coL#BTF&XiEkA-!A9mo*G<sePz+YfvTvS
zKU&ZEqxC%h<Y7{?Vwr#aXcpc$h6yu6ZMM`ANxDZ^Z4r{=skMxIP#?i*kHJrbe#W(I
zkco*i52*MeG#bmoWyXIz591ttOJK`ROYC}0#?!lkA|9tiuST&@E;$BWtCJ-21&3f%
zXTx#CsDPwOV^X?101H2MGZUB2)%MGTg1ZHR9MlHj_JL2s>s4gVx8<|*tDzaSvcbSD
z3+`jd+y!ANT~URgu~B<wLhF>+Kxl66;P8>bn?-T#cqutqDWs?CE2WyBo%jC#3!ut*
z2!muM#-wY-A*1utS+uZ#sHpH}ag*Y-JqubwbZ&bfNh87@BaAQ%7%~SysayYXS>g{v
zxre@JZE$knopScQUB>DC)}U(khZBu89c+5`1e=~cLC*L@mftgxC3j39E@|jnEd<<3
zwEI=5`WJVQ{gpn<*8s@3wPUrY=s4sqD#oP20T6UJ1o6=WI|AN~voTDmMv4sGne=&J
z&l@s@N4l>Y84X4g*e?Ws?SV>(3om%8I={LiM_r~ybWy6bd)Y`tbQI>ONW892l@~{A
za80p+qMor5O6J1pX29lDMKV%vo`%~IT2toejEQ_`&BsYg(RUDBSK4h(d>ZTjBaKm{
zr|I7)zGv^*fFwvmMW}*3d(U#)t@Cuvd?qKx5o<}L!`WGeDTGS7V-M+(lSqvmPpCZs
zQBe^rURXeW7^Xn?MqIQu2T6}+?QW>*hyyUf2*ZFOF}~H>^^ZytKV`7Gs5Br{!O6X~
zyz}p~9C)YviZ}ZEqN=Eszx;R~|5$f`MK_J**3Zl!uVC=hVR}Qr8Vvr|rTPswlm2js
zU9yj<uwFq&2S5mImuXG2HU~hoM&o_)Y9c<oJEVOzR7q@mQKr57JT0=v36|WUa%i*6
z`3sIgN6*%g;80!QF6;d2iXo<lRB2Lf8g=J8Wj|Z1Lu<^{gwKxWX_ZivgB|WpXRgmB
zq)6(`Gw{m6_b`}@W^P+_Ka1vE9X8dPi*$5o_o>I{OwoNmHMK3&1yF*d7fsFWR8}^U
zm#1IGQ<5YmW>4i%;jZ_;Cxl9!>ojfNYLX+ykPwlL9K>UF+_+IJoL4|ZWO#dox*~_6
z_eT@b$Ux5#Mi>qZwgVuk*7Z*y@s&Ydw@>P;I@t33dA2=&j+O@JP;Y0@@cUGDyi&x@
zSBsf(Z8mEkn!|)yLsuRoU>S<oC>1|-gAV0D`dTp>LSQmrcS$s~L7IkuuK&PT3{z?_
z&MFUTJ4bg&9Ni|PcJWgUCb)W~%GCJ+BuGdVTzo598YKLFFox@nSM1;_?)<tya-vM#
zh4t&tod^4&PRY^>Ql+}0y6`+zh*}@oATWnp;1Inlqj;n^>LRD35d7XJWKHG1)gK|b
zk0xoov9<U7OzZ1v&PvYf<0rv$>Qsg9=hVFRnMz$90D#Qo-sdB@6&p3qqtv>NW0s<c
zG{#}Tj6pVGkW9#u5rbsB@c$+Zk`Y-l5g(JlwTq{co1<?TkrrGoZO)<Y830L6gx{NV
z?fuf5s&$!uvs@qxF%gvvBvQMSD#rpI0d}ArNwNw=g+a*Wcnl}V|MK8_yd#Vd1cT@R
z{NAKmZGQ$nG<a+FP4S6FUVY{m``#)?3}SkExFLk#*p4cW?Wkh*vRv-{${fZ{8~le6
zTo@Q;as5r^@%uU>`9aY~v3m&n(r`8v2?10#2x6lkDndgk&~x)K<TnO17oejRw!J7*
zU)lZqN$G;??iM7bU)pS17h6T~L0!2-_PD{j)>E@CIUtTU53Q%4CovT+N|kmiB{HXX
z_8J6J9&E42{nJ{MW1&w0c6ucm{5}63ekmd(<KJwE<j$oZVcv{cVUPNErK6*#1K?A8
zH~dl)^}X-i9xv53O}d^l5Ukc#oDMgZX#GkZQxf`bR}(_TBRcSSFCX*W9Z8Z|KJzBl
zT(cOndGMnCU8!pxgsfa|2=RbwwS7vk;jo0*FC=-3!EN70{$s&Sg$o^t+Mmx<C1tfF
zu|NpsW0cb5i*~_<+qKV6PSM!`rlLZG3fA@INbE<jRW`7Nv`0z?;ddBegn$_w2cY^F
zQNrMV8CWwY>-EFgLv_6JyJH;LT7}R(v~gu~WLqUiw^uR$hS7ZNoAXG`8r+GO07%k3
zYMrHC&frTyy}sqCSilD%glR8B+jSyPgo=bru@$D|(dRI*_g~>O<N4b)M1JXQkOp3(
z=$OQw|H^o~=0_x$x<GLC3Khd;zj11oz#IwQ3y;;a2M5;y$ek#VW!}$H6d#qDyGjKF
z_?tVwoLvS(OEMS|E=@W%XLPC&nKPi*!Ak=5%voHI`N0+XpWE#PMG-VA-5mgdM1y%s
z(8mAdoSEFa=6(|52mgL*Y3)A2S``W&fA3Af$qD+F0@l{F3~KHF<p?3Du4!SygiPJe
znVcB<dz7A-&4*WilDzEjDf|qC%k9P5pv?gY({nOPLM#RrOG5pc8ewrt*7fhI68|)~
zotp;58K~bdPgTT6khl$rEYL06k&hrBSgR_4b^R$M>3La^pCjw5g}SUT!U#Gr2oAvS
zO~T-RQ4F#1f8xCw{;}==B`38FbqY7pCNn8f(HLZz2!oMmb7%C@=U3_Qx$*dX*!^B?
zp1}=@2qD<}dMQV@RdUw@v$^Hd(=nI^xnxuDplV%bl}A1Le*wSN=Sim10nleFLJZgd
zd=bA;F-kHn57ab)maM)~l7?@~WK1hg_j!!h4exD~DLL8Qqp-xlk~`Htje3I-#!M5O
zJJ|WU^0N~4l@jT>gJYCML_y{lL3MHG`ezSGOj`_*eU;A(75puoU!1x0eaYDA2$;HL
z3rN8Gj~aX%qtL6}!{P3HUm7lR0Bpt_+;ZTGGLa?=cQ5-GS52EXBr?202$~wZH(%R*
zb*S{-6dW6)uY*z_fcj9lsBdV~)d7f&4!-w8l4MrTxt*1ZmtqQAEuJ>cpRYz$hgF}O
zMZm3+;8r!l(u#H6Uu9YT73mM_E0<<{+@eZRA4f<J0tJKAg*X)<rmC{?xUjC<1@a#Z
z9><GAnDH241R(4Vz~i!7XZbsDLwMKeo9f~={`2G^_P$;^sO#p(B{4B2jqLb%(&J)D
zj*BKfCX$E<6Xpox`$L2VLRC~eZa+?!mv*~{hPHO9T3ab?YvE*L9d3Vk$|&7VKmS;F
zfL$Al`P~0qI|TBf(vOweb#;c!NB<nq%Y1$V217K^L1(RINO)WdUbmK64-ygbrQ4~l
zMG$X+I4!C`ug}6Tp&mK6XSsy6Tw?o6at{@syh(y<Z&Uj=rY|sUflA?FLuV9Tz~+C;
z-2DF(;s&Yjd*Yl+4uHo62j7*s=GFiW58($-ZRZ!@Kc0*CKMN2J9ks~;rw6=3p-s8;
zTvjmCW(>SGe%k1{+_Q3RScYn8rJ=!w*Vp~pZShw2dA#06sm-S2)azlg2a_rI60lF+
z^Z=8`>p!0$P+Tq#$4?AhZ-xdELHe?)iU+A%_kt|R-wN3gXj&Jm`lYXc<x2?kAGV<l
zNkY07#I<UK<(F93|6NuMPmg2;Mi?r>=>SNo)$&_lZ5Y?+la>Z2|9RpN+g>U}Rl*zT
z7#*L)ysSLNrlv3|IgX^nXiO3MD4od$nW$(pQPF0SQ(_oRGV>S>fT{}GTAb80wsEGe
zj_qY7G`aPC;8mP!;oEm@<o3_aVC_S51~VHVNs{zCYBroB>*2lHUl!p4zY%bvg98w0
zF=C1^;PVV5r6_O<A5oI&!oQ%j4yNXVaiB{<k@5Uv5m67n4(3jSO;zFW7MbI_q;6?x
zqZt;gQ7M?KEsCFz3X|sxPVMP5!ku<_<1YqQ+^dq38U9Sb=qZBa3_){U=lbUkNhD`T
zOr96S+CBr`O|$WBpQQ6HJ8`(VQ2ujiZ*8Vr)LzSvdMDCk;l350V&>$@4E5~26Q|0%
z{oAWLu>0!zJl<r|_i^BK>NDCSv_16R&>bwnyhpOZz(aR`ot*5UAAl=V!S)@e@Orfe
zj)t&O)_{=iRfV_>>xN&*IDW*a#{yL9c-*MgT0V~?eHR#-=C<BR0v=Lj<w2=#{p$+S
z&y5)mZy)MSjqtxk*c<@0Zv9Vz&xGszeIZoAn}0jaKQ|n}?Fi45-kjJ3uE`t2l&o~J
zGm@}Ghu(Y`46-bdloCx+N;K0ZWpU5a*|^eDX;B2Py!H+|PoB_a9aT|z={H9?zN?yt
zo?J%e=<w;5Uxrzg#S3!d`m0ENq;JcmD-rEB{1)icg4CrKAU-LICaZnG<BGj4OpCar
z;qCQ9d7WTf*1(paS{IM^wK<sY-jA&rw!I+JSkwJ=sab+$cd5h&I5uzIDwUQxncC7z
zlAy0WBQtxM%JfB|NAG~1ND^FoyI|uVB$Nxc<DS=LkW?mLt=+OvD^u|NbunsV_|$Wp
zZfNY%04yW}9R}@2+o+^mK6}R(NlF+Tg`fVYueVWA(Y@TU#Z%sIcf4spPc<<7{-G~1
z@%i<A2AB+izej7Ad}3G_|Een3x$_j&HO)i4l|YFE@l92VzFW5b>=TUo`g@vQRk!YH
zRal-uVrH247Yecv+$<w*R;}xg2*CzJX8!YVx6aeoMi`+dVQ~Od>$-1(^k_KF-5=J9
zc7FSfot)lRtNXbpC#Q4WxbaNO%Ookq!Y~?P@IHodxx~(&NvtIC<r^09Kw}$~`%m(x
zf4sz*%Ft83#U~nh<mQ+8(i6*=w|cY=JJv*&;^%n-zhACNHZJusJJ$6sIwjkh&|%7S
zdQPk+2VkG8igD(o_p<;1Ep}+KL5hYFa^J3r6h{=X|F{i*m%ybY!HmU%IV)7;AQCXL
z0ao6p^3FeHtmU28t*XMIEiz{h!JO+<#?KT%om&ejnVoY9w!R>P=!_`t-XzmpCz!ul
z#nj)xQ&qyZs{rq7bHE?I?33Fk@T=YH|Lt-rs-(?3N{UJ2fqNbzHYWHQalLSRylmZe
zyj%085Gt+S{yzg0oom7k0jM1bRP4S69R6n9{x-a-3l%>Ifh?Oa$rd6Fu|ykFh%u!h
zYn=6<_jF|?z-)4M%2?*lnyu>|g28Tgv32`N>buNjkhD%OA1+!MLX1<9cVJ!jq^y{}
z)A!)W-<wox`{N*e9UbSv3<9$yiGQiq^2Y=leq<Px_wNx$V1#gD`2P35uj>hwy7hNU
zNWWzeEo8+nc<uKmc;btjsjJX$;%H860w0?-m(MR<#OgVd$j?kB%3@|X8vpXx9HjX(
z=~{OnM@N!4A&=|sSjCNt7LcII94jpD=PU!`_o?i8y$rA0&$NYEgVNk6L7uR?<E7X|
zZ)rJR*!O$}h^I3HAQ7UY+t%#n#O|5_kMpC_thktHPU&`qv^ya=7L5J$eRw1fd!u)A
zs;&{W%SV1p0<5}UW#UyLq>>VY5ys6F_`DJg)t64>^FYNpiQ;22vH=n^2#X_-l-}7C
zTvL2$?WS6ZqT@1AF_4%>kKa$UMB{mO8UEc9Kn?T2ET=?E2kdoM;u4)v<2KW1d>RIR
zNs`QicRfOC@}OnL`o!*V^VZu(u-Up-N;v$Dw0Qb2qh305B@q$&rGrY#>ag4U?{oAh
z9n`zeP~|vGtG5!TzZtLUKoMS4;YY=fBD{E22Tp$rHg7e}o)WyOg9teqquihO2yt;1
zCKY7s_B(mJJ~kiJ^f3g$-Ag}0M%vI-o(KVF&Q-E`^KsfQ8w%&}H{$RQoDH~ozJ=LW
z>DzA;0uo3Igsk2rIrknUW?}aa=DMHeD;?f9B)FI1_@LHCiUfBEd+WWbeYZ`HtvwA>
zhKn0E!UqU_9e}!@O+m<;fc`&~b)>$sgCBkT4Yt2rh^mBsj~FBa%k#$axkZavd(ABJ
zvyw4K4y|ItK=fw(cSDjerzSA*nmOEc>uU1kC=Q%Hhbn@P_?<gcPgO}9vzO*#9F)EQ
zX`X7|TO`LWJUP&js(tU>6664pfR_-<fMVh!c<b+H20jq5scvFqGik<{_rE6uINTB`
z@xA|v{F0xyV&0<3(7g$G%v8aekEkT*WIsp}<ct?&kA=n>a5*k*#_NWvLW#m7oqx;Z
zjLyt~o}^_%QU+9>m)>`Bd>$x2BT;fvM)5;zBA6n;e>4xz@0X+22d=&o49y+T>Qva}
zy4WNu(QKN4&@e4^(Uj#ZoIN+Z8`OZ++R9sRAECXM;a`oOB3w%U^NFsRu>wn!ejnZS
zb!{{?_pXQU7hbHclhinm;8NNUX#Xq{sJImy&7N|6suPPb3Av9xjZvc#8J(Zr>(7G0
z<@U1m@H?80l_Z(_ufHEd5M@Jp(BAH3^Oj?rJzL$Y9II9bVD3B%bB2!taFG-t_?WQo
zX_sOb?FYd6v&AZg%@Rx);=SpFlq@0LF6?c$tB!r;a?HZeqIV;Va2fhpw&hPIs1foj
zAYukSSRW3&Q_im+*@2@y^k%b!$S6KEeKzwak0#PGG=o`!VL;>mG7Kq+Ed1hH=H0u7
zUH^WQr~dtX&^ph1UoXX4+Qv8juzFBt21tmfu|BbzQD5t~mO+9NVBv*-hFp`8Gd_`V
z(^Dxvp-n<|r>lZ2V;qTwOAk%ETTt69k=08<l1*;ME?+W~Ov1$cX-O2U)xVStAU#)b
z`xgX7$0Uwy>#i{5?124m$(+~)S1k`c^Kd!&lLWVaPGRS(-G`aknqdFiG6&v)w5T|;
zo6{NZH4R$+-r*KBs!qg(DtVt2g`%<fcggIfVcglk_<Vj294O-K`Kmt3H3S`A>wxER
zyY+3DO-YG^!k(Ekhrfv``$2pnR24))tG9v<e;qlNtB5i6R4PkN(YGJN?b6;no0U9z
zNQQg~RdDJ|1&0oo;P>lLK{9+}&nDnW)w+J35YiS&l7GV>1|J8JX_8Ri5Z3jZC6!0W
zdgRzpZ)k)M20A@oAD4yM_jh2tKIiKn#V>g7mxo#R`FBG${`2Az`R29D`RzyUVd+&9
zt}Nq!Okl=;R}9JVEPdc!{{8$j+_YeR(0eF9+rl^Rc#W!})}YT30PzayU*YlouUkpz
z)BW6qkA6%0d*l}iZ#j!lFSEvKTLc}wRIMf|iKHl<Vg6KqD%aa@Am_j`)Y`<5_S_$`
z+^Nvh*GvGH19okcdFAPz&B&pWkP0_{TIHHsRH84l&xC+_XFG?Z4pS6yUe|T|!*N*y
zu&OaOk`k9eM*2{x3PN>tGcUfpmow-3GXBBow`nrA+uQY35X;Q$sWsc?t)k4nTL<I+
z5`NV~nSBo}p7I_)%gPM71*jXgUa~8Fk)J;JlAmpDb~e6#fPMQ5^)de8N+_hcPm;v5
zd@zmw_Ytr{l{u_h*FB5%34Jf@5&kF9#Q{*QQQsF5H|cS%foN-T@x8ShdH%`6h!Cbs
zrbI^b=;G^GcmFNSo;p}%Eczjj$w68Woblfkb5<&!-0&!W{@ptA(}GKtw>CI={KKzP
zUEF_(fgVV(M6I)YwZCIz<Q;miJ7wM|=C07L2jA#-u-9GH?R!E%nH4VYBb1R?WnabZ
z9k;X6v5FWq27CrQf4v5L;VB=euatQCHwH>hbiaNspDWN@C$aGlGN<?HYXwLW6wDQ@
z{j$Qfw+hl?dnRhU`pt9e7mpA83N-jHHF_(Ow)cH})|7B<t6#icA3JuQ=FPVcW4HIw
z3wZ&jzvq03-q2e!KR!O1l;lg9L7TUlYR4f&2&IR8BdBp6qt$aMIT#-wO;VD+3F+R-
ztNJ1}QNPlofl!6u*zr<cesv!W4LT2C8@?HU|3zewKBb}-s@C-n!3#rEUpB%Af{?9V
zrEbHGAbnep%?w0cMLXZQdn4zL)CYZz7_*r#&A*1HK5`dxr{^JuOZp^?=w<xBk0cR4
zeLPS6>q$O;=WRiqqP4-v_wL<9`PmkI_S7GOA5s6aX?^}Y!+sRdeIuWIY!Q|??UJvD
z-L+KvyFZNGK0!r&?@!bywYw3lS`+ZTp|677#rXo8o|Wn7lC&`zVbM)0AO42Ivb$Ac
zyCfe}rBk|d`%AL!iXd`(40*d&v7-7q&_v$=03ZNKL_t(`ZtA#+X`X4M`_swu<uTDa
zQQyV-pyfjKRaXTdp|SiYDRz)1s&%2FvXK{G+CyQ{z>VnuPDR_T(57<+0HB~Cr*jYf
zW~!Wr!)!|mYFx*#`x*e4RFI|n3V}FDDG7s<8ES5^^V-IJ96VGUuu9PgS1gIZlZv%`
z54As^HPo9K;mRa5>$iSGnk2-ZLOzcM3XeAM%{yMjS{{6KW9_6F{O&_*xn}mbD=y-H
z5#5ddE=ZP0R(|bc{OPyrNR1D?cGlMH;<5WSQFKgOt$YYXsH)-b@cTaMwI1^WZ|J>f
zT6PSd{{Er>ULknLQH)3Ju0`I|4lNzpOd;R4$tZ=R0$8(e+FM}Lvoc4vcONd6JW6oe
z7ZfJX>#X-5H(hYog9_6Zcd!31IwtYnCjIUk|G_c1etHW^S!eBboEpzG_jHy!R<Ovq
z7_$ifd=0l3YMTX$P-#&vMbcG`GLwUe+v8>1_LIEx?ok{84B2w}wK)I{4Q;wRcoW8F
z5@|6~<v1Ls$bWZ)P^oep!5kq`Fi}7CpNrHtYJdJD#)sEAR8*BCM@xA1wY@Yo_1<i)
z2g61Nbc7yAaJ4Ea2UP3&A9CjLp&3Xt!WBzMPjjJ)r-7cGS30xr%`(1s-zM5yf~y-H
zn~=mWZ@Znlmdz$2YIrO9^hY?2|E?s=7|(D2{To)y30%M0Zu9V?PrN}*Nw~{_#0<68
z_LV+=DoLBdvFeiB$Fukr?X|sj)yo!FNssTB)pZUE8xU2(^Y=vvM`-1(g-0Y_e%e4o
zRhMf=g6WF{w|+(?@iL_$qY37%R#|y}cb)!o2PKM*g?9Z3ml@AruEq2B#R$*P-H$d0
zoT(HjDl{uj)GqO9t<!&<9{p<B`=hk1o)=%-LvhK#&AeUl3l~1M{}Q2#xLh9H%YY09
znYmYu#;fX|UFZwHa4~yMp6-*4?RFO(y*2Ulf+WeLB!*AHs;Q}+S6|)7;UguzD*Wh)
z$vpg<0RG1@0^d;+Ek~$(V(8__Mz~@K+5u2%*L_03oqBGjH@3c5$c6_t<MRaG&}5P&
zK7Z9he!TV;GBbx>qdOD^%lLnPy@VLP@bho-@JH?o__g*n4?q6Io3u4)dsqgI#P_KE
zc}{OXG8ol2fdI$GYvZ#&ye1&kqhfCh=e*ssB8mznwL(*LP1r1W|Fa;_Z35u+bWRoC
z@rsPEOVBtf2G)F7W!@SULqB#>UV&ishr1uM|1BABkiGXx;V4``xds1`{NPTY1FC?k
zMkuTnT<nvqS1vbDwcTg74*lki^oGmjVe^*bY}tAoR}d;a9%bMGc3r8f*T0#+VEkwn
zPg$w^dHZ7axP?qD&|i<Du1<SUBP%(N$VmMIvWlW|_(%z_ZQ4&uYhZudV2O#jGPC9X
zgG^C{x<|FH`vE+D<wiP37&L;rvm1VrE=kf8I`5?id*3MIci-F*RI_hxYy!W!<1Vhd
zdLo8?1~6R-NP}$rzmLht!q45qQ$PMLh5$w3>#I8W$tT~!?bH(H4w`5oDZl9TCn=A1
zAc>9PSkw|{=1ad=h8)0@(QVFB+SKmR;tm(oX|%We$8+)T4@_00wp8N9Ul}OAtkE}r
za%YK8&IE1u)u?>If*UWDZ@3(Ad}n|k9g2+a%^A3#UV*R;-Lzbn7tT}&tSzEjJ$hpg
z2S6L`_V5{DMa8we_|hKA%7gED@+yJ(z|~dS8ioVq*6VI2Cv{v{&fS&Fq&(KHxhE_G
z3ae_gzc&-IChNX_eM1{Bzq*$rNA-#Nt7r?V#l(&{09O!3kiM%}ExT!0Kln0KBV17g
zb!V%p@ku(HP{PK6cgp$2Lz_|jfq&55ICc_0U3&{DX@fSBAZ$qaS;z}!4ZiXJ{stgx
z*=+v&>=VRC2ljrJoNVNY2REaJu`x}+ol4yk*Z1}_Sr~pBu5~BR&EVG0OxJw8PpG`>
zC_!A-23g%Cu)DQg<DM7hp*9ZOo1v<3c&p4Cf01!?2~Zo2u;2!jmG`MV)P4qH(wy#+
zp=S?D_%#Nk)w+0GPuzg_%^6{z=-VF+Ho=*4L2u>rJskjTf0Oo(j-cmg^o7Ie=B;;*
zuzklV+@8>skOD2esjP0otEo0EFd`yMeD2QAla`==UH(OqV$%5BoevNdslOVe->*<n
zp}n^$FLR8p>wCR^Hobn3wl@7rskCN?Vn;FnR~!;tttuQ+>Nean)O#6W_!97)?YFL9
zgOKhG$7U{aWNRf)JP^3?Z;}msYsm^ezIq-e^YClp3lu3o3whC;VWGnuQ;^5+{<xl$
z_`pi3j%=;uFF)QFrd@R+3H2%JH%z5!U1qmNs8L_rDG)ouweEdioy+){+Q;--{p}od
zbysc?0!po*X^6Ggi07}1LFxOpZEJ*Ae<yQfTlYra)GWar4=7As5Tvmx!BxvIz1HJ`
z(o+Lmm;(H}C*ay}BWm^FtL0q8r*zJvDzEGPeO3`P1sEy6h@vW*>%z5CSXfJyPLX(z
z8d!!xQB=yy8+2Lwa$;jFeC58cGCD(lb*G$^v3%`AUne0xJVBqT>Lz?X?T*oy>|9;f
zZ)|E0N%s13givv6m;wx78F2uvR1zd1o>Q&spP~4v5A=+L5rQMYI<eoIWaz!*LMP52
zt!LdA-o@_=ENUDd5y=nMTu)}!m0jz95ot^g@`9Pe!uY>PL~aJZ`SW@n{L~{fv}&)1
zef`g;m^3GY1vly&73;!SRTU>ON|0z#u&%F=;GB>+B_W*!t_{bc2BXA7PcG--8(+lj
z&}JMQa95FQP9Vc@$xv~7p{hZUpFZ#(TdhpN_s%p-*B|fx0|93aO6-42#@{7qEJ-l)
zTEXn=R6<p}%^WRAOc%7)ckZ+Fw8Vtjy&EN>BNETQ7NVREU&L1nHiw|J4*Ij*>J>Xm
z2nsbeo0GUW{mPos)AjodbNU0X=`Sj&Wx|9^-S*Ix=;$aOy!S!g+O>sukG!UfGSIS_
zH*wR_)tHRoD|;>~*4})bpFW;=ogI;e27P-o+I?0Op)I?Vk~;AF+ScTvs<4IHQX7r6
zb`S!W(@#vinbfRU(z0V2KO>E(m@8+{CV;A_l%H*(rnrs9T07144kDwBND@THN0K=@
zj_h%XWR8gsOWB!Dd`5|O&otDmyOXR(tA~0sBMct``ovVNwg-TMFztob1}9H^KJbR$
zoY({&yJ<D?i9=UgtS6VseujD{JuzjZ@YJ*G`Qj%ZrpcyV67T76?PScfRMK;`H_rx%
z0T?4-41ycNz1XO{I6n5x1w8YeU7C(pfp_dh+!r?klXS@<Z)k(~Xh_sxH+bKkj-j9y
zd30w<g3AFrUy-Ri-~ED#O@O6$sbu8o6gj*g5qj|5&UI=_C462mUDoTUoXf=Xk41>~
zD1Fuqf{Ts5T6$WKx&u?z>57D)wardWj(&qVQ&Z!SC8@_G=|J(RPJC+MnGLJ8h2|DJ
z$vO|wx`@$e;HG7(m_2zmukCo5vz14KI?sgc>D+$pon&Q(SBTEm?x3<td->1o@xe9h
z_eZ_1!@UHJZf#Sx)6$IO=Jsy1R~NUj=f5Q!+FD8Jsipx-;S5HJvC~qy>bhL6yQhG}
zwBh-@_WM-!y;;V4n~FJoz>2ed;9AGTGz)XC%VXZEJZ4^-9Z-MRU?9QOsw^E<Yu4Rs
z%zAXoQ154i;ep}%-~Yb0Bdt%Q2*gW3WH>hB^C<lA<8M$MpnT-av@E`R>uO@+!m_PF
zM;eoZym0ogH2yDQh_$e4=|VQYu^o?3TOqj5qj3I6J<INzh<t@NWna$N>8X^RZlbnS
z+e6wd{5Vw~W6a&lV%nXM5+^a>vqMNIMWZmzFQ&Rw@aEqPG+VpBr{iV_R)0h#Ugudv
z5m6Fn4s@<1RLC3yaTk9Lp8@Y{SK)ne9(aZ>(&uo)`D%d{Max6(T8?{qIshIy4wqrz
zH_u{BBt0RI{5<`PP=hQ}QQ3gg8Mx|CR~p@gn#()@(jq4yU6_FE_xZ`s5AP(~*cc0Q
zr_5o-*!e^m<7jPf#_j9hVTp@QV)4`!+;iQBSg~L!ak0^1-6O!EL&Y>UUTUUkaG&e<
z_&cv#OSDBl=T`{Wx9>cDC2%FY-e_<a(&p6`2wt`#hU->bas<6@KkscS;g65)=I=k<
z&*}YES{t-EnL>r;ItM5B*7EvaPf=Ca%D9<nM8^&f`Fgk0&&$6#$}b+;%J!EFsV%i>
z4o12iK1xqDvFo*BwmyFzhuuqhZrrf>-7a8}B<X%(-%~HeE;>Ban;Bu~(VPKLh5B_Q
z!d74No3HN(c!1Qxtb884VaXLc)a!DFbL9VWO!f}GzhWg1Z`_C?w0%expJ?PCKikj8
zzoUPIY^eFdx+Q#d&5N2JhG)DD<e3r}Z@y$?`V}ax11<B5d@WHNemaeFZFSxHRm~Bw
z=oXc6)5D_;o|r0#w1E4<uUTIOSz|k=7JL474QfqTwE+gCzEx1w(3xrJ53f+z<}BsB
zH}qQjrbhjxK+{tbLmKX+2rn(3vVdOG^@=Getz*udam2=kKZ}!@o<e5&8g5#)hSs)r
z8k(E2b+qAdcY1J^2nz{u38W^akdzoVsCo!ar-#C#+V}r04G`tdPajWOioW+idxrzJ
zCp2g9A~tUg^{%s;kH7xL&Wvr7)y^A#J;j#)oX2hpQUkaPice+te@i&Jql%Axdp^tW
znK+~+G`n6c=I=k<Pjh|fP1enI4qo`>5nlTBG3G4G;igYbW9t0yl+*=*5qL(e+b~AX
zc=#Jby_pe)7Ht`TrYA=URs9DLmayJyzdz2VXHN$7n%NoIeEEi@ABbjOxY+PJd+5}D
z0zf@if;e=VxVT8hL?!TEg?2-u=vX5YW~PymAHE?uLqSB8k=zN1?0T)|(67FzR%}c#
zrx4L)=#<9?CZj}jKM5_HY-3x@7HT}*qq`Y-f*U@rl93ni_O&BHO{qjjOXqcJiG}Q@
z0z7|OGNkgJUVmq!Z$sO_`aRWt8?V^UVD<NHU<Z-`FssQ-pO%jtYLi756h)!5ELizZ
zL8ap$ZY40sBsFq8@`Vh50NidLqr;p9=!zskR8#~hNr_~S8pY_GTt?^Ql09k^DM^V~
zq9O+U<8j}<^E5VHdLLCuq0wE~=kd2LzK_gweM^!m${VPt40XD?pvhfAjq4a%6|S;#
zOx$rZ{Ou?Ec;?&harQtR-XP}j^oP%@aA<P{g~uA1IzJOj%-}}MJuW}Ld2|QQ{qis_
zM`(&$mm`Frw$#S<mkK$wrGhAniR^KS$nvmw#xEB3y?!Znp|;x95k8P;dSa=5|F?j!
zgo4V?w(zeF2LpP|?2K$4zUewl5hKR`V56QZK^#8){=a8W&Eq4}=4gJs5Q5)*`#sG~
zvsV%`m*jB$N2h2$-mUuC;wa(r2XbYDz~$-vA+1U(TVu9hlP{GU$ueBELgl7Usl*II
z4}4sg0B75|IJ_^-1^>|9i>)1Ss!Y(~?BB3a5$tzW^K!>o>}vlJRjqfT08}ApZV5hG
z-y2!kDHwvPBNkX)r|9t21^&v*qT3~<)_{gzeb8uZYUg~H=s(bJ({iNA!nBF{D;$+o
zgr>^mQ=OFA_h5CMMAPKK3nUw?eB;(vcyD6~N`RsqfpTm|6<=BXB75HmENc}CjWr#7
z>yFph`D#(v*D5{L#FJmy%7e@Q!`2thhyDH3hWL?Mx9)30y^9fsj)9*r4L?aoh);)O
zamA<d^w)O;r1&#6C4+}=yly1&KLosQ{9pDAxoOc<7G~vZK2Kv!2haWTkiMH6CVcc;
z^T;pIUU*;WxAka3RRxq-doN>AQSfjn1s|)%u_pd%W?egYmr!itr3;`Vi0QO?p{kwI
zo<+3+{{SB$t%{51I!?0RU4_;NXdu+<Y$%(I1~M}PlTKCfQ|UNBle;*mH7{3%5dwDa
zJ)^7q<duRDg57)0_Hc?sKf|*YOt}uTS>GhN&*!J6wk4?73ZU6jN@4pJ?7qO92$OKp
ze)jah2kMBU-NO?PZf4UT1FHrIhVrv5eCv+aC_ksYM@A3oD?9kjqdRzT`EzW2;e1$U
z<Y+=j>lN$zu-JDa41Wf6093{N5MgTkeePFBC^@M;wV4(b&7(Ig|KLRa^R9g3A3&C6
zzOecl^5V4DzW(=5rvm!hUn!W(1|IzRvVa`aJ?^R=I`mEt)HL>dvyH;URqnYYDv3<=
z6mY%$dJ@XV<J+qL<k4R78Zn(8ed(XF2UQyUhnU?BCo2REwt<b)bKXY&({X}EzxMjx
zKuun&){)Ku5J+RO-PcHwZ7Vi!?Z5~3fnW4==2}|p96M1O^f|9oPM)fuv9V`UzfbME
z{(a8G*}Cteva%^CBhjlkDC^ist@Ajl2t3=G>?=YVu#-lAgev&UkM{D%$M=NI@jSJ+
zmhaxXkrs{pTH&C+s?!np^6D4a`}&aHUy=mBQ>^Rm7|KnIFf{b<05q+O1@ZZCEL?i3
ziC3RFrulf2Y~Xv>uOVuXYXrlEG&&o3@tiBf_%H3#_`gU*q>*pkb~9$9wg{N2bY_2s
zM=Dfb@+T#6|HE@NAFl|Nw;YA|FDoyoYw1)5x}0&|aa?b|fjRCu7)59QfcL+%P%HJ5
zqU;T|G6mPqZX)LNC1)dAjYbxO*Mu(wSX%^VD+L4fMY@EK|Ju*-j-wc#4tn$bQCHul
zyTOu|n>t`)q$>Q>IFC_g-yQJO-^=l<y$>`ya-@{H`v09$pvI<l4jt+}i_({@swE<Z
z?5qsk_fk<AX!(zz$z4og`(_*gC_r^3-d~MH8QjSD<-GBiQ~ct~+wghy?KyaFV+lX}
z*c+OpJqLrDk~TIxu$jj`^g88dgUj^jfI&j~C-ocV4b=ul7#jL*0#<E%J`dcc_o9kl
z@S~5tL0hBt37U^BU(M*e@ESOS#T6C#FRDNsIyrDiG%|wdTbD2^H=lQR?bUSdwk8+x
zDN&4{5ndhdp<u$SG|nBar@l&CZMaML@d|}}Q}--NyAx6pBnIpo6B24^8m4(AV9?pv
z6%xM9Q}O(LF~S~+MMROHCJ?1snC+fJq!=6tUXKq7YXnUi)K;tfHeT&GLxU2WQS6ap
zH8%mrnlexnmAt$(EEfF+ZkkL+($W&h$x0zBE18V+1kzIDNlc6(KF)&0V!$C+A(^~H
zm?DuS39mnRg_bB|0@22vzq0^pYnmB9J`<zygOPph3$M@5n{OWOQ+21qSC8G_(<skP
z9m|3l^L5>eqNwb8?+mJ{?SA&C9aMDeqt#nMuw`zMs*N=7nPDMBS5?@;xx@9$TbZv*
z*8lZCpW=7l-i4}Z?E2u+P}RYf=g!jJ>Y-px`cPCk7zNxQId}Y%=xaikLK@+Upg$Q<
z3HV$%7Tx@xvs4ypPnmyo`c+JxFe)5d8FZw)Eab&kknw-uxF+LYUbzq{K9+GeEMnD`
z_jqUDeobpU|I5QHxqUpA;iZ=xGLkIu;Ln%w)zvT1(WcEPJK?D#&y+~M=~5@J*AHb@
z!T2l<Q-bT_@ot=h`7Ukmy%t1kG@idNMk(&D29x8<CC8Vm+d2c$(g9_4f`O_b6rr-;
zUBw}{l~8K^$IVFdG@l_LYrd+gk(89Upx5k;?5u&Dke)$1ug{Oy>%;5y;qm%#xn0z^
zG*Ht}$-(pQ;qvzWeD^4QJF9kwn=M<9vu4%oAe)niKdLI&y6pt*9etOEcvO3@-;ayd
zU;ftZ@uB!NM8Jih!Ba?s`&>wqm7~;F(!HmUg1m2J*}!d+r!qZz6iG4B2vw!o;pAXN
z6>k@wM^yul=AYVI%Ximq;@f|{o}?fLhY3~immlxrzkdq8w_r+I2CF9(keL{d*=WS&
z^-<B(%*!WEP-oXi06_5z-uTNY_P$ZdC%!YEMK_Pr<-D2^WU7ASuVh#|xC@UkR7ibI
z@AKDfSSky#P45L=b{`L1_Z)4F+UoDdBqa0WyKnkHX#IcCjsJ@%EjB)W&*yPCwPkqj
z`SKjrKBQeq=t^SWn`Ny3!n>M}kCIG$D1HVOse38am{Ag%Y)c6u|KC;&Q$wHl?mwD`
z_qhcK=g>K4iXtelmuT)7*eGdMoV@KQ>d{XT2oX_67TqxBZ}pJ{(VJfGxO1T6lOx8E
zX_)~)T3S4}-aNds=w7dn<7dzC($0V2^mI37BMfm&h+E$8>&J{v=elLnhg7pY90&nB
zcb)2{`QIBw?b~oGJ<Fk{<Xy#Q@BWnT``WqdH0KLz`uw>|u~FkVf~%K31wxEcN2>Q+
zP{#j)+<fkzH=Fd7xIV87p$g7bH1Lym-^J|@Ty8Td&BC|;dVN3w3(z^$_o;`s@!m%5
z^2}Yicls=Do;wY5KM{GS%gfHwCH(o&!JwR+zL>o%m(Ts*H6*8pf7o4Dgv`x`^hf?X
zsEdv;B=lVZWPk7fK$@!eg3mp9m}5JtG#zV@4E*Hg8;FV3FReaQNTain7hNee|7D0n
zCk8hDEs@A87j-lK0pzGi=452?_V(SH)+;&L$ntv%h_npd^w@BbJwB19nhwg&XsfC9
zqtdLnm}pMvmWH=EAvqR|8m1^K=SN|jTZ$ABoYbmtoACZ?A-*?efp6$aKH8mdzPhvF
zw?71M+EdRPj-mnOJ^LefLZV~wEd{rH_Ssi9Y<=~ey9&>F2h?<pGR6^S>da0$U0x<n
z&KcHaG6sWztc(n<p1g?K`g)q$FU=ZIg@=^L@kmnN!IsuG2OhVdoSY9vIp#$U9WLVZ
znf{+kD*jF>&0a7{QCu^7q3-)iOpM{|xvC!OokFNIxX)4TJdCf8-VM!b_{vG~6$MoG
zW0Flguy`R~TD645lg1Jg9oer_C`l5ji80(Za~gF`ZB*I<b68vsAA4RerQoUzQZr))
zegWWY_wtiZzr~>~l>w~<5E~K6uh-te><PITjQs~6O(p~5GE=#8&UCKM&Y{TKNSkMX
z4=oK?%WZ6Xv5@49Xz~Jdd_qAI%$2G(KSSzLeH$=F7<TmT0F*zOAPnlW1TZOB3yrmQ
ze)W}YC<AHsUEsm_izyhVe`D2PbLG|iYcT#JBal}t>|y+0Bq4tk#e0rpZ64V0_4`!(
zUX|HPbAs6M@MrqsZ1%lbMn{{rhk{LY6D^xbH(q+s2>}kbL`uAd%gAd)wI*P^sx08C
z(rQ^M?%%FJEgri2P6()N5tP?6V9AeD_;|}v#8HnGHH4BMQ-lFol8n~!)_ZpT<8NQJ
z*EJP%G}_E2;X*<|!3ez=#zrZUgoq2*t$_IWXi}2(EdvS%5fNr)Oq@w+RV6JQm(;kT
zjmbn9`Zur|n`}6p9&)o&uJ}xV5Q2RN3ORAIe86L!{uWw26}|pUQq5dFc^(lF`UWu~
zB1|~!Zkn1em6^Ewt&}_VV)NAyN|~FCk2LRD;*`EK440E?vG9!*EBWm51>|KU2V4#&
z$rAG>jK=JfI9V6itO~DNVb^QLWR8v}XF~rHxvdROe(;gkDLfkZ427J81b%t{9YjY5
z7I>5-iNsh7tELyQV%!9p+Z|K~=;&OI*R8Ps?Q$y4H#1{#Hs(lOO|rg77Ez{VDRz;5
zwWK2qOL}zx6z6*%k|cDOh5GA{_ECIX+YMQel*&h!&%5FuFj8LTm813(LfKCbWSQBM
z#`DT+Z)sY)>`W8a-7|5}CqWJdMw85hS!ry0sZg_0OtrtAai%1q<VyyH*WY;=#aRZv
zmPAt=Qmh+8o<=nfRl@hy3_Sl>1kRz$xVgPhSS@Jox2#ss=y$TuRmEmU39TVUKmk-m
z;BxpRhs|qjsdq%RH`vUPY8w`%nOLQcM1LhQN&``<4Wsa)N+wjvge)0Iju><4JgUn0
zahW0SXD~1rWTuas!HJ?%INY7nZVi%|Sku7HUsH2C&8>Fw^U{XPWYd6ARF&;JPI3Oc
zHUqfXQ;O5yyHbl;jwT~^45LN`HoHL!NlCGsIa`IID%88rQ0+R3zaKeLEm)LhMtP4D
zp=zsNPqkS1=E{|Pbjj7ECdP#HT$X@>oD6a-3GA&X59qb3BG~^<1#t-xjO#-@qPn<^
z$L`%kO{oU8fXkSYmcftjx-sM|UR0Es1rtVd<K!u{v^%M23r!}trnrsWn@SinJ(bif
zZ5fadnJ2aHe3rOtLjQ0bVc62E10Z$m-hjmDo`(ldTa%05Ji0@32mZHKt|B2mEW?Kf
zjrYrbRDsgig6n)W_T#0rymywSZKtSv>ljVjPt&^VG;Ie<a2H$gTbse-#b7cZMGc-I
zrn&4VDiV2B&$6H1FsCG7u50H+(ZGX=R8?R!%1mFJt#QX!7D?&Rpu(wr+H~4g1XiVk
zDdx0p4_mvd(*e*DXjF<uVVF>loY=ppgJ_Py{fFiF4~`+=l!1;kwL?*jz|%|Rl1+6}
z>}}?dr<U!`GLCwzG%5~67>0WFg#jOC;lQG{5bv)hR;fc)ZA2MUk&Q`!gx&6D%B0+3
zT?W(@lgY@$oT=<P{T`~S;1?cJBFCcTI<VOs)LL7}$x6m#9+b$WZn#_?-raJX%1Z6C
zNNSzOdJIduh}jU0!IR45$vMb62YVtSOgJ2F_Lja%yU#lC3;Mx;mo)ELlKf@J{R}m`
zNMckJKfLiq?!R^}sR^MO{+E-JmdNzfOtuvTHi=gV!IAA%R2H^ya(69<wp4ce`s+{j
z1*9-|krm^{^R=6n>*~;&%?9R;&*S>ZlWAz}2q`1r?C`Sll|qar0|i&5hdVeLB_!D-
z#V&d~oQsSwwDfEOZhCT*>ho2jWlC@WJon4PJpbfjO~+oBH=fVmxLD8S2OSqCyveCF
z>@T75cr{88dd6|T6X4eX03ZNKL_t(JNn|dWK=R^=n6lHtmPJs{muZvwjEd}x{KsjJ
zK=_;5xcBz|hpG%*j~*Qt!85z>Co1NH*9!ohjc||M|6fk;*ZvT{Dl&_OQQg&cB25xg
z@<B`XU5fN!zI#8$t4e#?bgG2!y@_}?&Ia$$8E}3D%Icui-u(jXP(2iRn<?})(Gb88
zuc1ITBx1B&jWKE-*DSe~Nd;GyBYW)3IsWv<F98@Edo7k;<Uso(GQ!M~B~!@FNe$Qb
zbfu=InQc2x;c{t@qPzTU6nFHki4kK;V|2_S7B89{mcM;Rhm-IB@tgSk!S}etC=H}|
z3y~SP30Ia4Jh*rf3#W|H-J!XhrWOZZeEua}8)yUNLo;V_>%y5~4}Y}ToNRb=E9YB6
z8-jV&@;n~;`7$hVVa=GkWxp6p&ZEIk7aU<&(<1|*+IHO!+@j|qKCi+rzq}Q<b6_LT
zAQ|}f4J(L<yz-1dpGTqkYzsvP>!>_zrT#z}_F5YvNZnyiyNjk1)l~iWIPHguiB5{d
zoRP%9qVU=Y%=ljvkns;7TO!Hv%IrBlumqdWqY$4G#e`Yu10H)NB1saH=Vh|(#X`*k
zZfgB@vP`kW$(OYD{VMnsi9{`b3cms6L@vtlJcK<G(H4zbn~4ALXuQwQ$A4%HC_|^P
z)$ZtQ^mVv9FF-}8obxrZ-C53iu5v2<HXLf;sv(1o5N;H22|mY8>T1uDlUqP^?3G~<
z17xJ8;B^`)t2>V*$;4?W1G<P`Q7A2~!{hOhk&%c&9-fMAe!s%O!^Q00a}J*`um<@i
zPf?%cKhT*0NHpit(rOP|7QpM0DYc#p__apiA<cJ&1b>C5>Aq`c%;Y<_t|C7pc~DAl
zEm3CH6aY0r%Dxov?zwaLf|z<7Dqp#F2`lGJ8kF2;WTc7frc7W~MmD=k%kXQQ@o+h{
zWi}3OE@%4UY~m8bHiyM1WF#qe(L3Q<V1%KiX9<vF&tt$uJr~*WN-?`$8@LPv;Qpzz
zm@)Cnik^9#ekx8jQn<I4wt6Riou?N9xSAc*?l@1|p<)upr(sMQxCCb))S?Q+L5&T+
zD;FZg2UmNTIX0J9{<9Ia56RiC)Rwk!{YR%>v311*5fdLlQo4l$@04qPO_krqWOEwE
zE={OT4@5;sXsr?x_DIy?j813ZL@sJ+8e#}*{Z#?gO;AzasqOC)K90DpyzMCBytfH^
zh&9ebiO*fj$s^BUtvOC=+C(fdSB7HFg#58IHrps~I74#e7-T81GNy(`8-+!+L`9iN
zN{k&=ZBLa|jlBKtQL3t%0)DL`{8Tv(Bl<C(FFF8Tub*g31gWX<p=`HTGE+0zb!>Y;
zk@6U&j&$!yA~Z~i&W}%I{av>*dwlMofBr_8jodhOGJA{5v3myZ-v7Z3*E4&<Ad62(
zkQ^V)?X#v4EsPwq1{Yv&Z*jBxza`9Fkw;uoxSRlan&f`>DWaDSkI~5^=t_47p!ye4
zLQ;PR=o)_i%_G}2)#S-Ye0jxEA_k|^J!FJ{`qDPe?5w7}(bYq$EgZO898|w~0=dIZ
z+|(Q-V{q@4dcI7X@gEh5ylQdK#y@}@WhTuF`;VU*@K{H?moZaQ$Qql_?{SJx#cB8A
z^(c5f3PzKRbcHw#`IC~VDYa2msBQGSS17a#597_<%Q9>ZNRF2nK&5Wj;qr7&^lk0v
zRPovEs^lGKF;#vWJ`EAdD+OC?B`1%*fWzL%sO%Y-OvAgUNs=U{j-5i4)k<r73l?MG
z4Xr+(LU~04wbo{0W21<T9opa7TGz_XU8gyAtPHO=I9c2lZy6l})ZSlo003HA>`b1N
zqq`9uVK(7&87R@11+Xa1q<c>zYq+PrxqKxbU3N85LzsCt7-UvWDd0?nl}2ZHOa2VV
z{Q90d$j=-+dCkj_B#8;x>8vg&;9z-WP>zqs<>$aV<;+_%hUoB=1DRD}Ixoj8Iv$Rb
zk1(`!>jCgv*RPS`O+6Q=ENtZ~t6$J`?3%F!d}{RqJ(mv~t`0Bf_tw(U9J=0bu*761
zF!Kj@VN4I~L9MIWk4F4WHrC$y3Hlm5*OjYR<@5DtR`vM4t=Yw<Kc3|DzFNx8G~@GJ
zii8<WGTGx2$R3|a-o#{b#wU<7A&K;y*kS1yINCjY?S_|WtkFJ2a#i#=3e4ThN@Am+
zAXgf~*4@BpunDT_!L6zsb=Pv(Q-d#r>7`c+kx}tnx8{3Hn0n(-Z)HF{9v^>x<?qOj
zOr#K7!BSJ=m@#8C`MGI>b{`5MsH|+{_{lQr>jPJU>3%Mi!uHL02Z*3w>;bsQqD7OK
zT%dnsxx;>;7r-}gKvqJK<vEDCpS@2`N#h$guOupJ_^7X`s^Hge?_yV3aKpO>!V+QP
z*K6-4HfH$D7ZO6S{df^i@6k3p=W<5n#qq=EZy_<rY03Q|!DeaHBP(@3@d!gsHwQqi
zTmLfzkLtNVAkDwOzT-~PGlsv0wyn|0*<Cf=4A7y%7-3@04{jrBsy5N4p)me0^3vnK
z<)3d4Tux{-$^2pehu^PlblH7u{No8WJ$nL|J+ON4h$tgD;}gl5kVwwBB=QOp$r_)i
zd6-N%Idia%$L{+ts>Zrkvt;1@xEaLB-5*@JX%ZQU;n<;m`20{-CunoPd2bW%Im>bM
zp{VjfreNyLEW7@@L_`kn&pDsp&!)F_(_F7lIYvaJi81-<j31XtT3SL_%7a>4?Ua_)
zQ(R)Dy*>D8&|PWrlwft981T5u9e`*{1ozy%I4o*VuWx^sw-3Fn>DXwcfpqWbUVrxR
z(q+t>ls}ZhUwtBg=XV|9#gqC5o-<-%d1CEtm?MT~l|fs(i$`C2jaFCSDn_FxC-c)+
zZ^vlTJtgdueM&mH-v~|1bcA6?HwQqmu0J5bTs;@~@~Ri8DjN8@nVFWwx9{p1^&M{1
zm)ib6dv6_H$9d;{e`XE~ju<UjmStv+DGsL&bJ`@`wAoGD?H0ET&o+f^H%(#p**<-{
z*zT6wG;N&3;n+d5W0Gxw#mv%Sn3?<iLzXSef;mTXz>YrG<*SV}aO<3bAAWz-9_-Yu
z=N=CvSz`Tn?j~hb#iZM5XPOZE6Jz`X_-dQ^;D<h=YumqhY%@21cp0z!?liys;Xz#e
z#%5YloK|Mf%c5jKHf0OXItUB0$;_R)WTCIiOK-aeS6_g^9v_3<eunz}DB)p4-scIU
zoo()Nq*zGLvY-8DBR$hbZgCn#Wf`P6t^Dfo{XG5e`d@NIW+(TiFJW}dUzT7=nM6wR
z1hg(-z%y+8yOa>SeGSxw^p!qcu4H7Da{K##Mo!+mL@#AhR8`}(-N$KaihP*TWTd4z
zC@#*Ts4$zN!mOyvgghQU9UTL7bPoSB%IF_K6(OpJUO^R8N886b005geFJkH9*%Ry$
zJsz*0$NuXpy0ZW!!Gl;vWdRD(()q_bZYDFs_-L`wyj@wx|9$gKLyom5w}5Zny?x5b
zzKKR?f?vFTfETJxMZE8a|Ia3F`<vy)uSxKrsrZY(GyK3aB$V?Gz`*x2w1C_P7#6aK
zr2OZxYv0GRMaextr>Dt9_1^Zl)cQw?Y%y`gk3N8{V%E67kEPV7Zh}ERd-o@49+<ij
zuVQ%~*WR~~|NO?=#;;=%oLP2C7iLqsAd9jE+2j_d($(Uosj8orngN<?`|-Jq>4$P=
z+bOBYq`h${BHiju_EOe6E^L&yTVdH8$w+~yX`=~f>4B~RK~1QS-Tr!lT6A^Tddan?
zQl6DfNk%5cPAB>4X=J9QV6&Pr$r4tp1=%EFGRc@M5^8w(hENoZa9G9X590BM==XSO
z9T=pczn|m19r$z@TajS3r*q5QKc=kWN<)upG@20X-(N%J$?+%P3e5+?j}RJY0faRC
zzlgKnvt&V%93b0}BnwD3B-z2}u(Q=_#_3EUBO`_Mv=l5B6E>?Ev&DpjL|9P?2E!<d
zirejHXvmAp?I#$FZ3d~scbwj!zA}{Y9DtNmJ0G}jYsAxX_3*;$ukym7r*v(buC|jG
zss@I&?mv3NmP=~D=83v?zWvhl<mj&~ui%sKyYi9}m#D1o;9D>18>BfxT854P_xcA&
z&on$5^fS5Wi+^YIL1#!T=Ntf~{fQf7NitOKNpJa&Niy-jk35*v&A$VkUQWKznpBbh
zv6xdVZ2Z@UF&ACf*re4oAPy$j_z#8AUfsiMFCFA(2ldrCO0tyHpLe2=fqR|HDKuU9
zJr!h0l#M?eGwyf;P}d>w1qE;V8#x~AH2fSE*~Hp{5>^x!F|Qz>qI@Uz6yuv1g(esr
z@YCGY&w-|9-fXQW5T3sADaj_TyZJGet-jxYRmKLtub+Xw2C7dVrTX+y!r^X&;zDSH
z2+ai|nleZk$&`s~%0V*c4F9hw7ulSPY$<^V)rVq%PwAu1{T5R{G=~|_0RY&tX%S17
z7@r03`usfh?_VXPPF<oU36<HwJ$&)1Eo@pccgpRPk=}kUpZxuwP@@nDxNFG@9=LjK
zGFCcGiOU_}3x9e#qLQFn9$Cg;e`B+u>kx3rRP;qdt3zf;Jm(w$t>cNWg7iHj5B`N)
zo}%GY-;~=W`{1vjKg^LA8k3^te=5>TvRL!4A40MXH+3bt><1V&{&(#~^bX=44Di>#
zoyjClmkim?1I`s##~4csW=UiwxV@okK+w_+ZV~2rPYoT4%dlhTI#PIF#UeITlu=md
zM2<mpbt+U<(AeC|>os+}QeT4_l@UCQBuQL%%eRuk2?+QH>1aJlS9>MhohRw;IEBaE
z72icjW=xh+Wa}Jc%UopJ9Aw#eNzKX7M3@@aF2b7rlA?(mfYcNl@4x@b*kl3Tc#Rhh
z{%OkXWMrPaHJdqkiSK)w4lb9U<IU|jEEcS0GpTkfHnSOvNycQ7357NM;Sj;FLNKi0
z2?ohZNoDC={WC3+5mnLn&eJb(vRhve#blBBzpva+QJJBAMqxSVb28_##HpUlU^wSO
z?h?{kBV(;TSBS<ceYL(<&6~V-J&_0@sD7v8k}&=O+^qvN|6(^~fBU|qGyVb6Gwp0B
zp3Q;wX5-KG9%4uf@V2j!Yf~@0cN#hc%jQT}5|B&_Dp21caQmQF^|8Z!%8*9iREw3{
z7cS$9iZY6eG7_%pWHL!ql;=@Vp2vf}HM~<<&+kthVJH~+yHN<iYdgOQNGw}@pW$mA
zK8Hpya9(XH6!aj3h7cOPUDdQU9i+8sKYcy5x>UMiicnBP4XB|8V0iMbWX{EGUxC@a
z0@+$lth-j*d`BZP{wKrh3v#-um1Rqf&jM^)x0%=8eU6Yi@pUI7^VB^>%ywRSgEhzE
zbUN6&EO~8(SYa~DJa+eXzWwJHsnp>Fs9}xWPge8b7Yq&9TX3YV1oj(w&>0fTIWs}P
zS|bl!bF^Dm`G!T7n3pVd3**pHJIGLvvCU<%rs3IRWaOui?jJ~svLDfZp%mW@^B2xI
z00vMQ>Za6^dBJ>uunP5^5bs%f1MXqxL(!m9_3(`6GyyTadjG<dG#*^JmbFXDu-Xz|
z7BU`=6f4(nSj1JU=JWRPI(~lSK*Z%iLTJ49{5MHW%cFe$)st?kDnS~~yh(TGDSA3j
z;~H#5QHIMv!l3|~Hr%VAsv*Lm$dyEr5ux-F_Ut0;*@YxKG2548a;(H;TL9CPDIH5s
zpoYOvYZQA<?35fk-oT=TvkX@RN=<ce&FY&cRRsFc^|_aY@&8^&k|n-==Z!q_^IsEC
zrY?he``I%*@cDIy_IhYStdVCNfXj+u2cYYRsX&>L2d;WoU%F~lK`B;ya=zTdA&uq}
zkx!0H22TCvAZu?a$84SCv$flhuiq3q<A2xQi;RDO`K5W|>@Y(#yzD(gifmz)`Fy%}
z$Sdd?lqi^dmYN}`8nko|>-z(=DnmT$shXCy|J=+RKD=%{3o8ndO_xUHuElENnsp1f
zV&NQq_2zzFZPGXSd<3DXyzrOL^ZpP2o}B#o7yUlqAL8)d|Dy8UKjHVkch&fW<|6ES
zhp_J*WK$OAl&zRkHzUcZ(?0f4sEscF_>!4ZAx)Aw@%e&ORkyNisiCh}05-1JFrfpm
zGT+X&(&ShAnL!_Bvx%?YxSfA^{`o1l?P_+@+2o>Vj)CQKg5*|dnIU3^9RN)%#NfPY
z)j@r=qpOON_nK;{>>(VwG)jNQ5(+4^oa&=|)dbm<IF|j4CDmzTepVi}13l9|RgNQt
z0lyzjXS3erhKk0Y-6vUO&10jZl=QPR0$RESPKSgehSH!OKh$*!f@cMC+7uT%JXNSs
z8vm(Q8y{b{nf1%dE*ZmrEGg+$K6cAiuB@5I_utqRk$O-l=;imnc!W7izlS{~1FO}7
z)oLajXyxRg@8I`NK8^OhhNcb>az9JR^CD))S}dvChMR~dL6Rkk3bQE4&%|!GVlv5i
zJOTO!`l&hjQq)foMNHm|d+c~4ix!p`o(0Is&LBT?7Ttqw7ya(5n<Jm(JVSD`u&jU-
zs~Mk;sn%zX^%&~_K=PJq%n%i309CNiNL4UZ5!4>j=Kw4yO3rAo5>n}`o8A=3MAKd~
zNb!O!Y-5#CVr~4twhz%azVSc8RdXt)<pA8fcqMmjUV+tSMpZOiLw>pk+_d%&QP<Z;
zRc{w9?#b71xgdbkp&n|(eXO<@vCdY41(~`I!IC-Co#i^t`2=(h2wHnNCyCpq`q=5M
zj@tOYXVG%*xMC%a)XSk<L1M{*B7Ty858r+MW$Fi~7D5;y9O|W^>Sx%p9sxl0A0sgI
zYtW1t$aPsF!YICdD87A|YzwhE@3_bj$jVG*@#0b{DhjdN#-Dn7?NzI(tf}FJ{ZG?1
z5Lp>eKy#y^ATxgRjn5aPzM+!^^T(HIo(^RN6&E=GW*I6nlV`f`48|ZyaNqLP{O{p|
zQ*PUMx{oXGFm%>P3=D=D5{Vf=LM${g0nmD8fPhzD{cmAjd=(z_(os8zs-xB}nbA~@
zw(5T7t}ZzL!?+m#Q<o?#pIrn;qC3s{qEha^diA;bMw3}4D<_q#oKzN4$aQD83x_m@
z27Po7xM=Plq^_@z(>+~u`P~yA{1QeH8VCJtoDTM|%~8%gvT5r9BP*_g;bD1C&#3Zp
zw-#iF=QM#RH2yQ~4!(BH4V0JXOug|XhBMR7x9_@%AMV`E(e8^Qv=gEDk09HZB9uYG
z?w#nBqMQNLU^V`pA7FN@BPHv0%I7U&@uE@+b=1RItrpfSTgs{>OE`YIis$zJneIV-
zj(`vvo=_J~>-YwKVL>Ky%VVQPlaX@q-?pvPkyJB5W-yL5<t4ftfS}*lnJW^^c$AkJ
z!{G{<g+{((+Uxa2&MPvrW1`zVeFPnKmq+xtvu=p8WqFt^a?%+800jk3Op+-o3B_9$
zFVWT9WU<QR=BJUHpT?3=<%^+!%D|wPt^pTKeFMXeL0>2R0sT#r`Hoa(IWs9vb5fA*
zBs;}{EX$ZpGPV&39wG1qLwJHA+<^eDK!B#fL8=G32`I4}V&u_6JnyZhBAm@NVlEk}
zR-6Wu0{6P0u}h$h@{3iWvC~_PM~i$=)`r4TK5^rfq@*S32x9}VIV^nX_UrlS3vcpH
zTZ8WXLPJl27GlQuj|PF_KZrMc9CO(R$;$XxM0?A!#Hyu>S-$wIoH$*@vwNPRXQ+M3
z{d$A-<2nG@*=fA*#?^+G|BRrH(|@ou*B+B|O@*t+k1frD&5^t_eT+b8g5DMnxut1w
zS0&3x)i*hNWHP;BNHY$=<%StR2x*>?mvDQ%J|l2>esb3TdsQ<*Z)~Sb#tSv9(bMFj
za9IKJjay>Z@cY`{Da(FFV=~Ju%E{woZ{!1_3UjBYZ)~-jC@6GNQ0Qa@=Su|wzA*iR
zUOM}SXzm}RrmvT(zD|nMGg+Bm#Js#bO7b(w%1Xs-iN3H#2!YQNqJPjwTi+l@+S=IH
z-i$A7Y?()0sGnBFMNi{g?pl<KIm#ugs-UqO`o@v-f79Pcx8jZXm>*fQksCHFO1PwF
zJg``0K6UF=NIT)}R-I13B~<d0ZFi7jwqiA#DK01=D=(8&vz34nCZwqh`F!;C4bnR_
zNUzJdnGjQ<DnSnK{cmbcKF<xee~;Pan<CoZB+IN?x`gG67IEzKX`b8j6uqvA`!Kvp
zFFvJ@6!ZCPmeZNS&D+;vwZ<;c<#J#AnWmWIdtdooA*%MY;TZ@b%QCCCmywcjc{=t&
z6P$RpnV~*Ek_>ZK<x@02D{jv+z0-^h?_boIey9BmNyXU`APf~LZq->kKPw~o%73J?
zS%e0RO`Rp0?iLTlpSwG0jQ<gq=NCon0LVyWIQ2z9BE_C!p*SUz;^Iu!7%Pf(0g@z<
znr<UC-9~9?78_TU^D#}(*W;nKy@%J%)N;IM>WHHrf||k(R}Br71AJ!LTx@b=QAn2$
z>N{Y(p0k=zFDHVL4T_SH_`=p}Sid56pKmf^GD&=V`;~M&<)Uste@{R%kYTg4AUmIm
ztQ<<SGs(+H!<k|yCB=%(VMdmRJxeLmiG2NLuul>w3@d2<AfW*l-mU@q+q-F~Yi9Ss
zLsU1n#AN+$R|kLj&0n)@_5EzS;mcU8k)^{-CYd$Mma=m3Vve3V#m+r{qIZG;X<dQS
zl&1|3wM<L3bMyAKIAYj|uW5qzakSz41Mw+e^?O3p?(1Nv=X~~5(=-l0-@vkKO35m`
zylh4_ta0SUdi<W@2cpoR?%i&hj`uQuQ!zOuX)&KT99H!i_Da}T2SAgsB&S~E4AEkS
z|F8hLMjo`IQJ*nb;7qQb5~*w!^42wUeC0QWA6pd~{i+|g2;$a)__Qz~p`9CTo+4XF
zku0RiR&q_LIA!Br8bh5PkYX?~bsEM$!2J9?I2GAGCFvQHOPgMz$g)IUK{|N_>1<v-
z7x!R*6OHXWclwkeYDvd^Jv?^8#}^kbBF8%QwIu|!_Y2y4$1g&0X+d7|)kU-hlVsu>
z*WJL91w|3<ce!A-n)v!nH}bhZKh0nS<!153B1^0-EM-|?5p(l%D9XtoEyKoCJz~0y
ze*lXa*<!}-OvPSSL=H=s58TMZ2#+66ODFB88+iS#1H81~ILUD#1Sj7811*jF*?#Bu
zDV()3;$xUhGHaJFW7U!+964FZb9<hm-_w1;HlA<~UZt1foHB0SzJ|24*aRy^Xl?H!
z5V|;9bhs<F86=?z>fi0Ay>{Ykf938L=5HvZup$n6#Bm_#S9tgNdX&(`&XuBQoPMj7
z)C?<2t}4YILooxdM_+Y<X1ou0X*WgAa1mxY28uv7)H>{H(${2}osm4F$)&Pl<gIHE
zp)mcYrZ2Y_5-Kg>AzG9n+7%c5sxP9u$01oLGN)5v&7$0#ja{BzO{KfC3FoH8(>lfl
zgcV(CKa)|M8+it3QEtK18(jvZXWH4kYA%~smDAbj=DDMlyi#8?ExFTHzn6bFew@!P
zT*!j-iOZ-0A*gE?cqg$TcKhlh()yPqneT4DnTm2lV-1%a>6v!EcHQ-SY3H*EIls+h
zBJHdLC?Szyvy*9eux?f<i%JS8%+H9pyiK?9Kh<&49HcKUXW`;<7T$d=AMyC;J6X@(
zUHkaM%P->(PQNU3u)mQ%{_jIvd($^qw)+04j$ty%tXr{yRZEs~<YXl~_dG?v_q>yC
z&j@hat?O}2^YhTdiQ|pq{`_cX5J7BaCcAt6RPJs;(IJvid!Q4)J52ei<W&39OTZQ6
z@Jmf-Q~b@|p%4e3siSydHgi|y#iT5#t4m*ng^@$R0A#p48Y5>ohZ$KaHqx&Phg95y
z`l1icBx(K|HvZRwBoS`w)iuF*d;|^QK~9CbX$%iWEr|%=7h&qd{nUs1k)?X(TXI-q
zD<;nzT}rj*of_jDfDxVlX&C<iY3Y$Ss+H%w*R-uA3JaY)x_vVbxYzRL$vS>>{4hZ!
zx-vDF66SlSPV%=E^Vyhtu`%8~C}`;hb&^}4D%3+$II{2ltJ|)9&l~?El$Ygl*TUue
zrTWCQj&pt4JZ@UC6laPJNtUpTO3<6FW~8&<p~)iat{aXNDI*>E`c2a|{>MX3OCj%y
zW!!$nGH(0ahv+$0!|#6i6mPs6rF_^~G*#i%=e|L2cP&@l_*JARv!iCSiS;X2vTErv
zj#QrDxqVMDE4PeC?syohCH76Q^$lILcl3|@I}Ht2P$k2_3ED!y$v0aVXpgMtr}cCn
zp@71ID~d4KCXEXNon9(;M^>KJUfoYm!ys#JnTyqK?6uI;sBbu_BpE9pAdp;_;MX_9
zB$!n}iIHFGK(`+;$yCG<tR{0(C;*K%{s98*kx$vwfK#Dv-u1UJs09pOA!tHS9qOez
z)JwS~iz`#+kSRxIJh$(uqe9idG|gns6hpou!R|0&HJb@VV9b_eT^{M=Xh==Banr^n
zT(x{2&+I?WU#cpj$_OYz@Y6H3cvOY!3x=f$g9<ct2?jlr?;Fq*-taX>biPMcZeaD&
z(umi2IdjkEmAu(pN1xvp)&AF&&EumtZ#6v17YRm1{&k(pW+8vWQa-a`DSzAA%{x!M
z!oNNFG)ffGvm+cm@GIPdZEU~mhY|M$jK*R%v0>FJRxewQEJ>KA`;66r$K&UncP6i&
zY#3BnRbZS0AW7ivj;?gAyJ3icH^ho-W?xc`|D6p()b5L}A|M>n&?bwdM1dv*1B3dW
z8OA>wL~_<G&JZ=SB#f>9@9&zzf;h`;XJ*151Y?bV0DpUAhHX=LkY5iSVVAcqCdU6*
z8o~qo#&wMS{?>>RH)>Ep=^8&;q??hl9|Mg4VI)e^BP#>S%Sx`kkwlP^YUKmhuH$F-
z-^b=zH`Ws>001BWNkl<Z<xw3&Ao!n#dVX2mN>!`iMBUWJKL}p%)esc=jjmfN7IV|)
zrBSW%a>nMc@Y$_bMZN!>t5+n}_>W=ae=2Mx`CR*%hxpwy|IOzf`76v3HnxwZu4Wfc
z{_jKh{gDTL#$qv>;$r-3La^)g69lFxi8|6{{QD@oB>J*lSGS+TJL@i)`8v%f`l2@e
zN3f+B8~qRaRbo@vr31m`A&of0Ib;NeO7RSI>hn&EQWI;)jc5D=cw6-u$zh@Kinop(
zp3`wL{70h-js1ZZ{^C9vk^Z{BNnh%4T*3<4t9y0p{OhGSRllU?umVtG^sSST?A%m7
zd;8UV>-zWMv_)4=_wqn9ulKc2=}fw{Ab)h9q$R9>I(A7~1`l4d{*p}l$Ag9Q3Rs+z
zAJx7Y8L@3HoeU|{iG0HruqU>J)0FLG>qqY9w@?2!f3<yk)W_-WJk4Kz^EU(o@slW>
z4hIj`($zI}5ayMJ$mMybB5T(4-rIhU!oeM92nCW?X-^2K-q%4><@CfC?5P&RopkSD
zK=<?1@Bo1%W*mUa3>it9o~Zg5JT86p|C#m#zQ86h{sBB~QyaJgYJlInk8?WIJ>|Bs
zq)l=02iI|WRecY7cWso>j2IdJ0NE+}Q}3nD%TobpI!F>MSy0SRK5#Erl~hD^jJN$w
z91Bi-ZJY`9@jLf%Iu-pBlw~BoaNRXnXTGlqktB(~TDLyBof9-4Ome0rEb>1Q=G+YK
z`o_oj^)LUGWpksu2f8~>@$~OLN;ni<NmjgQXzb!dWuvZbtNTN!QTMZrk27ofPG2~r
zad1aH{-NZXbs;ptiPu}`ZqOg-n26lj#s@hEJG|)402p5ZB+obiml=jT06v$#Yb0HV
z6k#lw%=icJ_e@>~(W$z5(tUyfH95-Rydum~o>O!vQ%A3c&P1l!4xE+x+!GVyA0Rb?
z>tJEddqV*z8d6fNeB!n%`Qp}VqAH1a!`H-_(1qErkWks>tLJ%d4S@)2t^az>70jBI
z74bUWYs{OQ$KoiiYt3N8P7hK>I`WNM6CU}Wh?I&_{^4&Q;-M95quRft^(fE$;qOqw
z@y+P!rLWJ;>u*$|qs8tV13_cUZEObh?P;3Eq30Xu?=U_~5iP2!apc7YhB}Q|Q)Uci
zAoRAlb@f;RhL>0iNo=O$`&&s^4bluoBO`>N4uIdMuOubK7XJv+RK`Dm5}er3=~cb#
z@Kh0qpawb~1T}>no+^6P$)i`^_6VaIVFhiMkv0DplVa2VLV52g07Zr*No-g#hkw2M
zF7i?$t<@F0?5m|i9ggyMsvdslI!<MTgT4TYQ_{I^?ZSxndoLnM68EiG5%GTUb^s)2
z8uAVCY50u_0pj2Z<i-~6+`57v-*yN2j>rwLmd1U&@aNAVrlH^#3w*vHFTZ*eMTu;<
zQ{ABc5>Y)!Cdp7$o0G4%&}BfheY%7KDu<q_$2(-)=VkOHWT6Rye&yWkps6rNJNkVB
zB-o-Mzom8j;EdMsgRjv1_)LW75=WN6&^(pi8z_><uMtRP#mHMGH~xVMb$(r1kR9&R
z1gD`o5lccsWrzC|Zf)YUs<+DxdJTuLGCbs~H#U*~5lj(`pm;AU07XJxemXzA=MI+T
z6h^e4A~bfot9i@U#FMT{hNA3k`S{kY5o^i6mswO%OsXX^!#aAY;>eMlX~;JwzUF^I
z&Kmz(O~bh#m6m4n!~5@Ib-}EN4_8;Si-T|fyOArL7U8hMOE15R#}j$h`Cz;8Wj48`
z#+J6!?CYR<Z+l#?>2nC^@9=V9N3G#~30AwY<&OdHaCL>Mv;NN%yJzrR;GZ;$xmoM@
z!N1V`y_wYfC5nuMp;xKio5*2}p9H8h`)uT2M@men7drqUq4KonG~Q|Uz(|rrad{?J
zysw;F9$Ch{pIXfazkCIEd~_w-?wrrurMZ~Q(P!7ZBFqb(8ng*gghJC0ejP?#C_G&A
zA7kSmhA%+9<Ygt#;J9QbCEd!`?z)kyW=B>N?Gs^+1lti&7MZWgpT)w8nfE~?SgbO)
z&0iAHJ`>&JMsq0||06h3EqwWo>$!b?<SJBq-~4~HH0(8Eh0{XQ1h4KoMsJ_~{+rRf
z+MrLBFA_3~j4y5JZgjElFST^myCzi$5&~33Bj{7`dqenLA>4fd+`WE$Lm>jLAVHsk
z64EAhD1-o4kDueOG;#9v7K~2#q-NNRZvY+`cII?D00w6OE=HsQpV3t78Li`qZ`1Rw
znHTgWh8Zm)8*EDSrlxI{_%sJfvx||hoI3J9f^3q}#@PAq_?sAvvgSX<X=TIpbJ%oq
zIg8g9lIooNMe210d3SdUul}Km%DwFopRZH(@OGeyZH_tP{$7NY$-nMU`0Rw=*c<=D
z3(~jQumVux8pkh1ELIbLck`9lUN-Y`eRW*U`N*dA36-b3RM|AYoZp{1s(X8*^~J~I
zQa1iaFqvgOc>M-uWn}QPLwoceT2p!9&tKrdkN%mo^u#!{LI~b?tCH5%zNnAU;#M$X
z{L5%kGbg?t8p8vm%QkXMk<V37LK?OE+o|0TR=b(3!Za)nnQ%xW<PGEQ_oIX&v(zOS
z(lYHhGHh7wW;9LU>h|Ipm|kW?6&lsyUgleJv5YfFF1O6k%4%SEAQ_;$2Oxe~Sdj+O
zKWJ*o--ym9K4U8U(x2jV;u)ri83{wL61^8^JOWtfBL5K>B#xX^+->K}n3|QLsOq3I
z^HR9;qbs=K!6n!u&;m|%+PLzLd0ctNJWlLs<G;VThnCvNjPav^PUc&4C^C(cs-4V1
z8>#t^m+_DO>!sA0Iimm+1+pyhH#clVdr{-nrrMaEYiVu)#j|G0w4$M~$cfWt!xhwL
zn8dnV;&L$lN021AcEdtslgv-|zpeWeK3^X@pZa_5d-zw#)0j074MM;>d#gBeW_mjG
z0Ns9tqEzGR_HB-fkJX{L*yC@ZO>tq9&D@&0kXh#Fjo?r~p{sHFy=OuLcYgqPzj2M-
z0Zn12x0*J^#XC|HtL?K`Wh=leoxesh@}nOtHxa!p!`U2FXSyQx8GtbeiY25cwe~0e
zC@b3EGW#p>GbCn+3K=9rpKN+lX|Zl%i=^ylG>*da4=q(_?DEz{R16_W5;r`sn4i3M
zKes))A|m5|EXy~~;zv90;RAoaF2bm);5BdExMczp8r*TJ`5#L#q_3%MQEqg4=`##x
zwI1ERg>5BsV|t$ZSFI))1tNx<=fZdggM|D_T!IggBFi#Y&z`4y`&d3dFDK)FG*_>k
z&&StqiD;jWmUlUJ@YfOTV+8vT)NuNAi_WblzZPox4Q>RMB^+tPJu7{xk3YLl@ud4C
zZD*C}f||n9p3~HZqR(6;D{d{wQ=apGt6wPW@i+0mLr16z^_=@AQk=$?IBTjv2@RK5
z>z)3dus$qFx?i)Hj?(^v$Zob7;*J?aLNWj`eSzsv`<aN;g7Z=HQ=uMQlQh+i#cDV6
z=^tIgrkkUi&N?0@i_CqWUPJNR41V(Y*9q%1nEO>fm7y+H*e+}Y9rq)Nq0awQ1Vj4z
zD&}O*C;&|dlS$&^+qcsF7Y|i^#?P<Fb)>SeBC@9ASQ2oD=x%b+)9l9Y3SMCJo6Itq
z1*znhJIO6gBUzl5HKipyQ+ra^wy}DCo>%+1yo~=5u3bN$U^vXrj~>vy&%QT)!u+K-
zk(L(wAcPRGe}6S6PBulb)8xP2*B0QaQez|1nWd?`c({fW!H#h?X;h){g0~i*2(!|b
zJkN#c(5L#?;W<6-@J+7>^Ro90#{*qll`;pj&DaURLC^VfDmtUAj+BHdcFoo#c8iW5
ze!^7rh5t<CLS~qlgh_R1T5M$2^s4<#gri`1FtR2DhXQT7_p_&%dF<CW8*2QIX3MP=
zeEk>OBkJtm?{6g}E_4{Au`l+K$bSNie}F(pU(<L=_DpHXbTL~^eC4L=$*~!qp1xzz
zGEAn#8`4Txqwa7Qhjup5bfOpEQ1GINzp7~TwYfR{b{j`tY{Ks{HbNRLrG@%c_4Ec>
zBH^6z??}>V+tW1uhmqL6X(>09>zAnw20gs_%J-*nPJIX=c>A4Gks1GhA|?+~y<BH}
zBd{gk!m$aA|MLjm@HOy`zbR33>kOk!aq%b5$#ISU(R8YA&SVT29#R<UKmQ%~YWjxN
zInv@Mv@!t}3Gp9V#}hvyS)wd6T!2i1W=a}8p%BiN{cMT6>}ND7b8-PV9qyS_Qgbx2
zN#^rExt>L9V;kvMzIhgpep7!|%`d_i_Af{>l4Fzukf5@k(YSs3KI6Ph<EJXV7fE&6
zc<kow$i`Owv9_Yr(BnmecQDA|o%OWW4CpqHJp%!bywu20cj70&rf1m6u<0|tjgFtZ
zH;n&bBnck5?h48?^=B1pDtFQxLscME)7bs`3971FBi=WlPCf*3Fr*POxM@5;0!6mN
zfp%W>*66NXPd4g8eeCe)mjK@u<uvNa7-&1M0@bDHbLf)50XU2FIj!Rdzl3iYn--a2
z+Q=X!#sM(+ffQ}c|5zL)XB~iGkM4c${MZWCTswPO=he%N4=(102Nvtz{#dZ{T+Lu=
zZp!)0ND>(TLV!z$wzZ5zM#hW+kWmyBW$>wu#+7Flr#i{aORR(D>h*K{)h0sz$hEvx
zMdQ?)tpwbO%>+o2#IoEXUE2x+J%CHX_&;Qf@jrsaYU1lR-9SnN^A~o%_#HGYvO!#W
z2!#}0eCb{4>N_LeH=qs?))5iz@*1mgZ?{KgT-JvA*x{+VC?lQh91C`^(_5>%>;|Bs
zFvsw9j7&`Si?Hs%<m`n>RW|!Uts~`s;9D~TVv-0Mgz@=79Rz~Y)6^f0QN}-jDK87Z
zMbM#49#t8kWL_rk|LnSHpEnX7{^}KE=~NkTYeDKl{Q#tw4Ldi<VEn_d(t|qA+=a1}
zIx}YmOBu|Tm2+8FWK7il#`%k)t++FUpiklC8?7ke=#63}ta0X0<Z53=Q<kZ(3`iIh
zK)Ga$|7zom{}D2>QuxBwt95Tb&|6Pc<uit^!Q&0^>~jZbZ|{$4|Nda3uI&tO1ePS0
z6-1WtZdHc(le==tGMZ#SFkC|WhOd!GizKq0#>(NVigs>5sov<n&0(fwUeXQfeMoCh
z`PW1*Vutg`XaB|BE%$njnNVn?@ehDW#&JcF?pyxB&u@skahj5D<-=d!q<j0*q2Z>_
z%q7K1WBdcUYp-V%fQ(0yB|d)57ObY}XJwbpN?enl5Q6Hx?I=2%<0oUF(>pCE!U&2o
z^hqZgQ9=1$HvUIgwrCccipz9wzyHmj8I}d;>K^3j9sB7Yh%N>f)ZFxk8g*?uC(U>n
z(=FwZ_q+9~KAv({GN2kK%V{*45WMWIWq&}g3e$yH43?{wWf`+|_&MFJcy;Ylv21!n
zMPr7<C$x?yzMAM|%rJ}$qycfy0(gAWe*j3ci;Ok?&$4Lia^2fntci(CZ@s;Oxyy2O
zZQC3k#3#a}mSiT4@ek)G8&1WH0#IylW;*!z`pwfmPEme_0jr6Q?gp13_4`(bnR)99
z6P{_x%g|R!HQfxrjPXB=B*CLsZ^k0)``(8JnmKd&<!PU{s=Ae(I}hRaM;8baLZj7t
z1fioe<+`#|Dsqkgp7ma<V;Rzd{LyoQcAZ)FcoG&G&w8t<4)sR0e@?3L0t=E1ORt&*
z3^y6;VfJF<%aDvi`bV|%hqokp6*Is{_|F5x^)2r8O)m{-c;tT+`77olOVYSH`eXU^
z4-T;U>QbZ_tYa!}e{==^^4VQeZl?ha;Q_XuszW%ECo13_)aL}2WX&i5#fr_V%Gps>
zN#kI2B?xmfv&S6_6c2=emebK|jY|?Za~%{^WRh3rL{7jxJeI6<eZ4N)G#V;rjQ<O9
zX4-jl%|_jmf{z~fB@33`6xF#DMP={aDynMqE6j~YyZ<;oW$J6+YKCubi;XepOo{&b
z32F*|@to$ylzGgzPQ5;x!%S9j8qPciX_+=mHZvv@m`pN~ES(#SCm1f73HucSUIpJ!
zfSx8d-l3@-EuRRn!&60%&M5nM6lKMx?8cevAh$G~?i2cg9fx0S;(@<kN7^J)n-hpE
z3Gr*XA74xUSLzeJnD;UxZ|*c82*mAb3568YuojW5<p{Bg{Er}Kq;c2PSMt>EH>cdT
zsj8p1o;ky|JLkt_Et9eNmI{9Utv$E~rZ%K|O<q#$i8pXYqjx%EUe=5PP^^$;nU8MR
z#MfTl8P)!43rh@Mk$(EyJrPTI%Cba8K?*q~>Ex88VYMfhFoi>BbEOt#24KecAD^q%
z%;(9<WAp~5HvZaMkI-2EE_3FtiRc_dLtb9nb&S6L=_T9;LoM_N^?g1+xTXMmj3&bR
z{L|~>Q-#Kh-daLJVX3X)g5Q~~GKCeH<jr=HnqfnlLSlGy0M2BVvD(d~W<gF#8l_8f
z(S#u6R~c;g(sH_wfak*J#()~&8P6$(BAEL#9)s@aorkGdxUmTJB)ST=d)hrbvhG(b
zSe4J_TjsL$_6jm`l1fM;Q&r8sGV$a#xbM>H48M#RdHZDmeZ<iL00{cRq+~>P%3<Sw
zUCfOC5pKTcCS48y!2kT?K9+5sMRp9ve@{l;i5}d8`W{%z%Vs6CQFAQekc!_m_1a}5
zGMq_jtXw9{tH@(TZXw5eBUd3QjZwr)4}ER=3@LlMg{;C<vWwElC`iE+BZJ5Y^aezt
znFBCm{7;O@Ec5W{b^Lhm8@jfCe#g&PyXA|lSTP5OeR3rsO$bh%YUa?PGlZ4t**XDr
zh&JyLUE8iJwzIV)c1B;HYx<SL0>Nv(dfF8?SEtOSq#~QrCD}OAjU8eoOA_`JGllaq
zD4dr;IH=Ow=BDvTH`ShAUh~%x&?)md8Qm`Ta2g^8?^@X`^Ua%X<g3p;r)zsn)u=k$
zN!8&_{^z^<&N%~HZmS?OH}TGZgxIWgG=5Po;_*bU<-N-2@RuD3191_L6@cFznFA0n
z;~yYv<pLHImr&C_wJ!5epPzsE^lLo!>s#a2c%!KrzxehZ-G;#Wx$%)H)yq(q@1g-s
z<5B9&#B6X=)eILRNfHljSkLk2pN)9mT!R%aB4Ma&{B*cI-9koQ3K<0{WaOt{Pe~R%
z?5Q#9bWS3j1UzH>PtE$JWn><4Fc_FxnmFt`%<<#3oI2gYyt##xmlsk{kb%WA{7Th?
zU~te&OG^)@t6Fipr#|LXs3J_0cR!j=&5p;f%A58%C!?}9@|gwWVKtk$ecMXbRFojc
zX_%nJW};|rCWUh|DeKOs@y#Jlc1Ion8H)*-P*90kW^vx^JXRDIa=bILwI;DM@C~{j
z|Km(4P+}N;m8Jp#;^Y7Tc!z@Il;|@c;%WQ?V3PUd#~<d?|L{Fso1fg@!LOg#&xgLY
zF~$oU=IMVwPR-G7UE7v9vnVP~T%+cA40h>Dl_r}4P<wSh?*0HluR_2dMhj_}&N?V&
ztBgI>LTaWBXI=`<Tu0nqXwzlxoE+w7=TY0QfBpqPwllt2uMvX&@VPX;J>5!1ehQiS
zDP$BlusJRrgMTb~OM65F4#14@uMe};#6v6A@Y4hDOu4Ple5ip_Ag!dTrtMr!ztw6+
zk|e@mC1NLS((?f=-a~{`eb3GN7N?VCk6qv-=vNqWPp@1?mQ8$m>lQXInVXOvIv5Vr
z7w2d4&3kWRV93Y!pMRCQf#~~+Op-)*y^E41u@kQN)U{Xfk>CCy>is8l25y~8W?tN%
z=MJHn{#k-M;(g*7E_483I13Ord^(#z<8J()rDWS`mX(!J*`#kY`!oM}97&S+tFLT8
ziebIYk=L8~{XZYnz5Tt*R>pKa(J(UDWGa$P0jRmMmvHF92F&m%2})0YfZmp2r3SOr
zL{3RM#S1b?%Suw?>l_mIEnC6&-h3^hy;4&X(_|(gv1m&%&Rhq!ODMuW6^f#-xmVFK
zKLcir|47-ibT0pPa389UfmKT2I3~x+3w{;~89Q)mgiikn++qDu-%qZMZE0S^k#0;<
z^rdvSE?&w9uUwZ@<#<^cDg4s|w^P&H#kZe-nNSoZK_(=cPWDo~AQL%8e_Li|3Y$vj
zu(zdg+Q%B}3@p8(h;4VyW6P}-aT9kCg4@;3C$2FUerb1HPB_Ck5_<Q!`=^c|B+B>)
zz+&dJU-(!=yX^RnWBk`+@1QEN8L)ivKnFkk<g2=mpJjKjX0b5?pNzsY5FqH$*FaX9
zojeLaL0|YH<9{-gkV;qmAV*$or1JGvd^(gU63Nnev#^;Xd*~ajd94?#!%W_6=VfL5
z1B3(mj1E=DBw#5c9r?yBF*p80jU9A7`3}9$9bjPBQT&ySr~~e)=O+me2b0J6hhepu
zYv;_<wXGUF32~Tg+aGM8H*iMx_J6%1gR~gR*}8lE^fbAmG9I!W4u1Ond-%{b8<NWS
zA3*{Z&Mx48AAOL`v*$#yzl5e}R3C`#P{Bv9);|YGFPf@xVow`C{n8tJWaDr6`M38l
z*gO5wH9bf|{>QkSXod?&*c~VV0Z)jKf8rNjLXH2kWUpDogE!s~(LOK!>J<Oy{vC8Q
z4jH<Zw|1Q2I}blkAcC>(A6~Tqt1Y>dPWoE(X&D3LW+smUkZ&k@>Dqw~5AVL%NXyCI
zs2Vuqfz@u}ri#V7x0jKSP09BXzm(BC8$+F<R7lE5ACCOnW1pc3v=4Clf8L?;XRmYY
zM=!Jg%YWpp5B`ijANapC|NBb>YFjU!TsC6-*CdbeKf=}XD|BrqG#_fXF{W!73boPh
zJF0to8JR~{#je~_Q#2}fM>inr`iceo+lSsyevZCjcZtMoHu3kjUc)!HZ;xvK-liel
zS?*|XrrWu?T;FvX4PIA}oxiB$Q`i219sh9*HO2!HCB$Z>{fWp7tr@0G!rtB^uY;kU
z@jc9BF#d-ZB60WUK180*37sR<9O>o@w>-tO|8<<;Bu<VV27CSd_|v=im(T7Z9Mm6i
zDo)K{!!rF-F5`osyV*7Bza~aTA|oU5Y6T<sbf^|hhR_6!$9p;TRvW6$Qjd6Z<$}4o
zw{=)7Nu?}xIpFHo7jaW3nMNB=;~$u?)FI>vQvb{`_I>uZ9Qw$A;5l47JiH-^jemf-
zWqH^wI^|e{H8ER<C)`bo?~v}P^Z=h;<HQytr(6J)Z?v5&Q;TF>pV+j8kKMQ>VYU9z
zvUF|{|MgcNAk`MRD$&W;+a?WgPL~gFyCP=C9>M1h@ymbO&sXo+L3e9x=f#>N>9a9C
z!3-CX@bI0h=VB!fsWeH9|Fg)>RKEZC*CXC9;8XaY@9yJoxBix={@=T}bn4!Z(AnhT
zm;bb%zuWdZ-g#Dk3V4LiUvqWRDd-G!`w6(um;XqUyhci$nF*iFIvTG|$<?XoZ}V{S
z^;R^Ub=>h}R#7Gnon=4{Q*vdNE_H+ux}{AgDglbO@ed&BDCO{U4sqxkf8q2upCs_w
zfuuG50n8Se?Q<9C+ExkH#$*kia1V{1y}Bm-rdwq`wKj`q?<?i6R>rPmvh`FiL*0=@
zwI$%6@4kzxS1*W(G-f==NO$m`4}XAi9g@cvzRfg_zuFwLjBjeHjo*IcVZMFyO)M)Y
zjLA7hs5{ZaSMK}^Rfngqlr#|nw$u89_zzTi50mgWcz=hN(TOanv<Ugi<T3t7$XvOA
z?|$wReEr8ijd)*Ie}Lcq=n%jA=flijk;j^=XH&5vm)znsvI|qOSWS4{A-qFDx|`ip
zAMNJE+pW4)e#Ya0C99b|JGmNY0lMlgEQ^}#(U@!sK+`D!8p}|RkLo?`EWUCU$@FG4
znPoQ5D(AJPsSTTO5;`!KGJ{<{-4R1|9EBOlnTCA*rnnma0Ftaf$k27Dk=~=tEZkH?
zPD%2V_l;$BNeNF^pPX_#5pD*d!896T$Kq9bY4YqtF!BB6w8}iPB9rUqrc#t@iun`7
zKNO_#SnmZt6I0{>OvwD?{(H#FO`KG)QCKV{9)JHG{KJ#aQqwoFO3>KP#P12w@NPGA
z*A`5$$Mn~=cupaY&AACBtkTfY$CHPTa-?H=lcvXGsL#)L9)6y${o*E;ZYVPR_<*dL
z_^=F-M_Xrzii9};+S!L&z#Sss4q;EXBF!p@>4e|uviP3s`BY~QKl$w+quO6+f|{e<
z(=zP!uq>~LJGQQf={cey6j14Dab57U$zCDJr2r%hZ{qE3_0V2DNb$nN4bvKrwX;if
zIRGI=K?sp_3R9ORg60#wQ*U+_WlRPjk!nABG617d6^+wxx3g$VF}bD5=>(J(>U;JG
z5kgZskS((eIj=k1Nt0*)xW>QJD)Z1%C)+DhnU!vdTi8GdLFJp{8I%*Rz=X_CKX4B@
z*_XcYKY}bveCOWV_{Nhvsh&VCdAv`gt!9AY1zFe)9&R=kv&F>x+4+2J_Kj$&Mr+Ry
ze>il61I_wW4D}H3DLnq@OMK@Kw=-vPOy18A0sn`{D$Hhx5*Z{z!+3g)0c})TtgqdR
zR9c99)dooBra}p>`S|<!;MLb8dL<K5l;Y%zH(#5S3JaZQ1}@S$4^5(?kyHvm9wjDq
z`;EtY2>SIYBE^e}V!Z=|q?oB)z1QezcH`>x>wfKxmH|z))Tb21Gg}Bj_1<<o5tc>9
zi!`U59EUzlbTw?uK&+uq8%^E|jsI-Bna^*?=K1?e+5OOL9$l45NgR!TfcENvb2B$C
zV3N|7f4=w5%gXp4K{iQz>%N;Qc8=d@J<%sp`FgXi!IwrMn`CAeX7R;aujO|ieVE5@
zy_I#v#;5`M+#!DW@t5(rjmwCSqKvL5V&B{_1CYQT0BzK*;__(7SFTUmAVkjR001BW
zNkl<Z$p2`x#x`zSJcm0MEKBrKE}|eMjql!h3n{6wjWk4qrV2W02QK>gWDY=HR`R?+
zJTa2+R27Zp%IF8r#DdJM6s#saWgP-liM<Ts<&NJK;>>}wwY54Qfr>i(xhLBA2awFs
z^%-fZ;PjsMm@AA#gCxNf#rgykgfjiQ=)Pbb&EA6up^;;k`O+2Hyl{UhuRKt~gG-$h
zq$Z}9D;!j*KN4BS`m5JoPf>ny4W2X-lS$_L_uhtCzSw-4$j0}36uRmze*eV-v)M$&
z>^#1F=k@&lqaWh&+iqiB$?Rzzv!ltye|}@?fqBuOsnSg`Iq(b@Ay4YYM{_`(E`>Vk
zw7oUGXs*~vW*LQ6--6h86j_1?uUpTjHf}{qlKSnk^i2NguG>h@OwNHnoo5CK1uixg
zgJS%eXBi1+f~L%lM=Uk`yBmfgQg@0qvMez_Q(qP!=!u=m#e0FEFHGf|ttcZ#u-*)S
zCX&MVhv+f@BLv(bnosI4eTpYbi}W>C3S~Maor3PbX%s5?%El~Se19n~KQNp3FL9Ee
zAftaYXAVWCXMgvy6|7m9Tytk)f!%K5hj(2(ymm5c;LPDJ-IKm!g~=>aQJTw_Z@-S;
zf9yj%ar^CToLwH(vEF>TmQx3fZweN0qu~dgVO(UuP|HT|U>@~?$|Hg6U~JSBj6$n#
zLF_$x&R>!w*tTXqKe**K@*SxOUE9^A6@2&JTS?DIPUBxy1udt?k8*pp@zaR2omokx
z0OT`B0cbolRnXh4e>OrqsL<Je5r|D1_&tGlAi%Mgo1^*+P3exf4EfT7q$^uAG40g@
zx(5TslRT%s45S*R1E2|o!puYb$ITvIxPLbHEq0QZl6a$kgn&<>x7jt}@5knCik%sJ
z;L5ehq-hXSW))=e@y(kr_}OIUz0jboDtWTKCX-BgNe-XC^=f|i(TDlWwr!XqEDHJM
z_x2jDawJKtr{`PAlm5Sqkp&nk?rKlb*H^5Kxo8@8ylZqa!Z5}f|D!1@%i+fl+|3;c
zC<(He&3tC#HvaCGE3r9}cOq&>P5*@ICN6D!!+K$^-a7R7;C02;(Cu$aE(f4grvu;{
zuQqswNfDZ$t*W16uQo^B|6$2+#9i%YLZ(@|scC}N>VAV3V;q@jI%klmk(YL;`1s7m
zBRqb!nG&ZtDUIfu{T-A3en`7;X2o~zxamDN7v!3i3z(g8Uc|wpg-|9bYi&H<o0KJQ
zX0wT{%PRQg-#o+sT|uJ0qFnuoMYTtJII*YQ=;fGD($*M#&>1d9#&8EfU;TM-%uO=X
z&_}2_w&Sy-VKU=?1e@K=2XEQRul~O$xM^d2`d8jpzL0-=|9xy-Q<2oeRl-4)mXqU0
zJp!6CVGlquDF6vg;E!Pm5P+*MKr#s*<frS)YRzN-^dkiHwYoX{LId?jx~J7t9ttN<
z>D6>ffJW%5A39$Kl_aF5>vOP#2!W<=fE$2M?c(w4PO-Kq;VRq{67Yr@>YThRw@W$y
z`@h?~1!sEl3~h`Tk|goiZRaai1cGjL^3Sckb}-h<iW;lU%(w2li8aOgRjpqAL$%@S
z&=BhkKj;h>VYma3mZ|TdIbP{U`;J3KE@j&2G5!It*^sZ_MCz*feB?)8=2t)eXFhPl
zb%w9Ugv8Br7xB}3@8!{(Hj|d5B|oESJk~Sei+xZ`tN@Zs3P1r*7;PNgbt6$iDj|RJ
z^Z_`m`W$(8Z*r=*BoiUOLhGqM4n9}Mskhqj8<0&32QM!NKvgvQT9YdaX0@3~*Lfdk
z+Qg+Y=NYc||N7PjW~C=jsn2+{PEfKrLYv~keKvdRblACS<$HI2lhc{Pht{6ASF1yl
z_p~&h=)I@{BAJjSi7(%N16dAz4&8y58t}Rd4v<M=sj&x~VLW6c^gOwAlbNgUqVb4}
zUxH1qoJQ+6bU9HYA~gP`Ea&ilOA@Jz=5YVFKFO2M{DL2R_3zobeEGE2vLe5jFKoG*
zpMUTH9@)N${QTt9&K`?rAV63B(1gG5Qznj-<Yp$%-{_5T^nZk)FL{hQt3_XQGT;jn
z@FrjVb|Mj)z}4fY>39!EUTWmPjx#hI>oK&>JseJ=%!@(N&Alzj<p2Q8cIwPTYLl-$
zq<N`#zs=fNt*k6alG3dS&{U0%DWcRz0_V#<zJ9|E$nUk<pE2CDZYeUuPF+=~2cMYu
zUe`2@!46-%mKGJVEb*ONZ`QSKIHXc_(Aeq?AtZgHxM!FaW`yWAvH;Pk*8xy3HmZas
z=z8H@iXOV!u=PZPsBb}w#`qtDDL0df+qUt!+qUspmlt<KJ8e~s)SPLcx~`tOjt+W<
z&O1Cg&U6-+&0%h73G>QJus3&8n4OLzHF@j%Cqig~ntdIUHVE~o<39vtBr=@Ilii4=
z0?=r*B$}*i(IxFT{M>N$`mtYv*Qimbs=zxCz}4-;)$3=d+ZXe4mS7-xoGv3W002W>
zK7=Ncs-!Vjr@(`lpzI^0dFcz*(-){mpz-(XlV2gHdkR5<GogO!!^3?KWto|j&&rL*
zvd$sIaInPh4ia#M2>OQy5}K_t4yTRObSw5WE0QUG*OAF2^XV(M@-J__L0D+)_SJJs
z>cR=PuRq*HcJbV}tuGo1@|?`e$>Gc-laEI@b+CiA*G*4abTkrTo?!=@VM5FTI*q(d
zvhwvwHwJ`)Dl|-EMyQ|p)4LShwjSA;7-b!!jQ_F7&Qvm1&L?B#e3o2rLNWYrw0^3h
zpuM&aF@Z$pr9jK+KD<*X=X5LMSD(#xW?{A_Pl|l1zvFVmYSI7s4|Vy-FVlA)T<Qo-
z;B$rW^apVF`EmCL@D2tMF)k4sOE8oq82|yw$$CQ$r79Zkz5vd=<f$dk)L916?%ju~
zc(Iu5fQ%}_1eGBIqcQ_aa;#+AljpfM9zuiqNu)nLT8Q1g^WXPpue~O2jlThRh}Nop
zI_n1!I{fSOycEio<&asB8kaS0T3XJ(zVkMkrcxK`=ai*~CD!r9Ec~9~XGmIh@&vlZ
z<B^RU`TEYCQ*Kv#bUISF<5EcP6Y1oBDf!ZZml0-@CU<GFaWAj@;xuHFJY_Uf0B#W?
zQ@Zd5P(uoxPwk`l5#wv<r$RKgq3t~~buXsXf_&XZ-Nyf<ND>!3ofH*q_kKiA@~L9z
z#XA_JWs2ceicsm+#*dmModQstG62aWdm4$fTYtL;A%yNJ;Fk^pzdMY(KY*vtkGn5`
zcOZb8U@dQeP%=0G0>q(8!l&vCJEW&Sxf}qeUFTXfKW?Q9CW+bHF+cg04LchLCu~mF
zfET^B_|KNNq}i;@Dv15SFTW>5?Vb*X`t&zi1Gsy9RPOd6n`9PlDkP`W8B?((S(f<t
z#!dWm&)WdJ?rR|5luE8?{Ge#fzIN8!G&d;~phlQokTvy2Ku5#GrM^)UGS35!7=Pdy
zMv$>6h8Ay`EHb%8`mz8nb^Hdx+CRUG+7sVSdC}O0_Re8_#{c!3k+Ng(;2SaiyOKvM
zI8szqP_?Ih%BI;))iYruRC#tzES44(nkERuNu%7FL=&9DA^jyRA-}><cVsW;WJ3rD
zxWn|ex@kPt!-?H3?EO<Mhn}madQUrT)dRSC{Yhc`0|XN70Gu`cwd#69>%ZgWZ0p6T
zQ)<;TndN_$#kt8{`yX(JIJ1A^!A^VqO|&cLOIAOzd239aexV5(j&yP8+4_i$|Iuiw
z#_6})Ir?HF;XrJ&>Khl$Irsk+q4I*ahVTUG3hz*erV~9eUC(r}S@rdT4fOc&8~mPB
zB_+BEWi#l;On!C?9YZQ$SZ*?Zb_U(8Q;Q4rsy=30E>?RHnxOHQZ&301izn^Hg7alR
zQ*0Pv*-u1_l>J=7k$)JjZPZgU-=a+1>|GKI=PFA4uFwVL9WBZbeX1X~7Q~|k2@4Ig
zBqJkXlT0{eJ2@r?#bzf~N&hWnbC|JMlP3cZ4o9X))YIf5vmkjUH%~?=px_$};T;O%
z9SY(b2;y@ErzOj26v{>8mBz;(OrQfW%J>K4dH^7P{Wf~h?Ep-oXf{GYTJp+%h5`yl
zUTmE3_s!u!-VI!+_r7voNzB%xsv5^%X~HvL-1XoY2(W+08CG0Zrn^@$QtWmMs|t!a
z+BN)H4XA$J@YQpD>i8w?%_sY?rCBJPn>?y_qmg8Zyp$Are3LgV3nA!gaWiMJaq``g
zpxCg3%`h%z_-Gh@&;rac>Y%e1WKp@NZOZNXCTIc$XxUXw@%Ba>OATArxFn?PXDo_}
zw)?;(Z~S*Ry6CLam$_*OP5ig!WhGCld~8JW74I256HG52jSLi;(^+KAV}UhyN@pM?
zGr4L(l?WYxz7{tX>k5#QsDTq87*rT&^$Z*OgF(E5LBhf0ky{<hL~}95qA1F6+9KX%
zS7VHSnD!j73kW5V5*9#4sy?UIqQe2mNFoP+H2v)!PQKC3#j|~fQH07aU;PEI$mIpa
zSR&{XiUc*Rad>Av!3l;(P6wgEu~(W{eoZNvg|X=~d}!l(j_%lT?!QlkdRS=7qtrZp
zV5@e2C$63V^Vb(7RRjD8Yf4Iasb*@e|Bi+sLmdDlsmQp4%`hG^fFv-ci|Z_9i}YOt
z6RE(AaPr45B7(6izeujKpUJg@lO0cgfZ79-PmUbHtp(|wL;=X@OrA)xZ&U+tKvQ%X
z|1kV2ZCBjv^40ST*SqWwv`m-^2FNT-p1Nm%P$;sOZ#bmV+n5{@zN4|(%vc>}2D^L=
zcKMRp_=jO}1U;w-(Bho27{~aB;V9v$P!ILt0ooN8{i+`=%At0_fD%#vNvv_E>dOF_
zrx*lgmcbH7Rhp>~0)~409Dc5zlW(*#k?{|(FVK3?#P)mEtc=aNG&u5NV@!<y(VW=b
z60_lsCFAr(?DE#5O!EBisvl&}leM(h3?xM+ax{wy^i2lt@0xr7TExs`0Ah|AKuDqv
zq-%{j=p3C6K%eR(B-9C`qn=I|oloth=)rA9E$tk`Wj{J1|2FHe@gIxGe^^1=wI9)Q
z>DK(ia1HpWw_4G3)<@S(68)d;%u1?e*wGn)el0rf=Afpq-`~oqU=P=(%%yCcvbUUB
z$usu=!0V3u<=9fyPySpd$=21DU7SXCaVi6yKH94X80hrIUA0FqeTu$oOpK_9#R~!A
z@WsYI3_Ad?de2<&Gg*?zms6Qz$zr}Wmn@UM442RZN=U<EOAfW1G@TBBi7+x@G{%?1
zos*IH{vIK~I}oI^Za}w^POs|Y=$O(UfO*BSk^ZdO*MZ*?pYpaNFE_FAu6f92W8XJs
zvx)MI92$nszt@Mf00#oCY<5g6m8oeOb%(pCJKTjc$4<$TTrvw%FeUhXn3th1BR|k>
ztOFoPGY&wkIa`z{pPJed)=%kzY)obeRhj&l0zrr39@iimq58M`$zDGf+kE5d4I?Z2
ziB-+NiuU?}OWycbRl%vZS|b`_RUMu<+mXx)K>h0U8eQF5kR6^XHrh*A?<hHECZ}cF
zaik~SKp2h775U%l8wxVe;U%jmc}lp>Bau~@N>*Vi;gCjutBZjSFRq>dL4WdS>i0~b
zj5QV&flxK1c$Afo82?q{CyFHr%#wUTgi{lOPSr!F>S2GNg%WcH8&gUtGEMF1DnT`A
z8~{hEg)Ezcf#B5lgF_v}Ya0LgRgsmL`&($ks%#x+2I#DFF<GR4Jl^p)U9^Y8V#Q`N
z{=ysT_R-rE12vfmP!)~p{hch{V!WMs_v+>R==Ikx_}P(Q2P<raq{&lX3$Fj4z4H!_
z<F51nYi71-)qAzvdrj>0;&ccJfeS5xqa1hia+D<S<L=<@xJDef!ZkR!!T})!$dM2T
z>BTLMyDiD8R`1ek`|h;w?+>}iwxpfiot0L`ujk3*C#z{%&3xxm-=DD<jj#0rkYAib
z-G)+%=gAo;@>+A=$A|14ZYH22yFy799}WOh=BR9A*2$gYVClLt+KwjfaPK!}cK{HA
zBY*uQSN!vbkn++m4Vf(aIcVMZzf|@!Bf=D%c&(S<SmOHE)A)=iLo?|ALv|?u8M;Y4
zbk?z%scb1Z1bbsWM1;n6?@}b7ZcX<5&Zh}kN{?Uo5cM>UXQ=~l7N<+5a#<0TryB3#
zQH_XSB_7g<hBfrKfuWh0rim~Fic>~*Do9LbyMklUjFl3d)U5RZ8JI8^gX0ny|EF;|
z9OyGlCl*XL&-VuWtZ|jI-Me(wo)}Fv$ew~YiS^}G?Cd?6a7(W-HlqWuv}o=I<(Xn~
zFx^0_pP`QAjsDa0>jAp73wye5U1tA`CL!R&t_w2_nP#**Ky*`??E#q8H5Zo67{X*<
zte0E7$qfJt`l2+Qb_Pmws9RG)QFZQ|Wy-x48{zGC0D#|(;WG1x1HhqcM@-pXkABUz
zDoYMPw>H5wp4q1(Mn*!k|I4$ic<60uHNA<BUd%lfjDNQ)bH=}>W4^Q(F}$!FeuWUU
zygtDAKyqon26gs<A=#t=6!EJ}y;;U>aR4Sc8XqJ_c5qAeO3D^xm%*&72GL03H2idm
zHU8lUW4$3t>$2;2nhkf36L*ev1I^G)`kQ@p9Urx|lxRc`<C{Sm`FzYd>H!dk8xtD;
z04_x#k|2>HfF^Z>K0UzO^485*7L;kJ#$;JvWz7M|HAfj02I4&DMnbUIo7r+LVG2UN
z82v3ihHdJ_*&Xef_VX*2+Bfm_G!uhi)Oq^5x9l5W^R0_*J!YPFdZW29KFn564TW-Q
zq7T8bC{4R21y=Hk-PEluqqrus&Vbu#%{B}NZ11VK<N#!t$-AcZ|BWGGtNXoXYn7$#
zhV(EIkvIk4`)Uj0zuuqn^(0mHbIaA4i~PU5Z{ZvNrr^Y`{-j?tx-b(u0NJDfbiO3v
zY^qhMa8T`M#g*Bo{1EZ0mI?wVOFk~#vg7bj!Z{EN8O0&9XniS5w^Z1A-2L&y%4w%D
z#AFFjCJ~1kF&o+vZwR;~>jp@`jPrQ#*o+x9UCpjW?RB-*-et1Ts8WwnqP0`1wNt4!
zP#1rLC9&67>bAekOqhbeXq4u?1MGaPnZwU^*=GFr>i%;y|EE%0X1`=*$HAHB4`iCa
za1<?Wuk+z>DJWd{OqdAvN3B2Svk~&eIkCHsJwI#V;IB_I+#N(uVt$KN6pPL4(V*?U
z8`%>Lyhu57hf0E@b{=@`l~ooE8$p-mvvka(|N1hKL#;_)i|9IC_LIOUIbHTsngLDT
zi>d5qS0AH2$xrBR(ME}zGcUB+rT`S4q5u>TDp89HEmryRjki%yl0C%^r|}O*5EdR?
z0cg`aQ?Z~%|A~d|<XWM6Ws&8VV<HBP5N)dUejpQ((Gs9!jDG-^l3WHkCUl+*HBGCk
zrDj+GCRr-03dwO=D-p>teH7{46zbjN8pF8E5Rx$Py6r6iiiI_HKGw{U=eiiqz!cUa
z@tNm?=D6)Gm(f*|NML^ZaK`%V4em(5hU)3nbDFhL%W7X%3H#$T@9JaE&s*qju(z*J
zmaRGW5&H*bI_drU?0Z38M4b7{3Q5{)=YfmLa#+5>no>a9EUGZ)A~^V0Poei)pPnZ=
zdNFq%NNoI{R{P0>@vrHaFYa0J#=mI_ns)UwYGKIRg@_9V$(&ENDF9V2E2OYu(jgg3
zvjKQ2G7=A6e>0ob*4lPVJMoWLe;H~sOhD~!7$atXL@29}WyzMNytt|JY^XIU83scL
zM21R$k~RJToJ#UdyCGBM*>Ef8XOW`e>~a7UMdGd%YtuT0$Kpg)tC$G{Hqs$z#yL5Q
zGwQT?jSi$S<<~9-TdV~klVN4)^bUY7Od8{}XTsA#wOiD{V%c>h6Y5P)BfI4BE;7zM
z$)?FJyAOWZO|#ebpQcNnm^Csy6+Nc2|G}SNj3gd7CAuz^{n&+}n>4-F$5?Ojk$-?z
zbv&VpPPQok<rcZwbZb3pZ>YmnY)=HQ+>^`0cfFM>HZ8H`cy?o&g21qK2Owljzvvsf
zNz?BBi@Fpj8dOnZ>6NP(!sO|23lpaGMtYdc0A!*BC>7%$z#*rm+S98CIC@^RIUdd)
zRi@KyUz1+rt0M&mX*M#c6@NTFG-KPajErRS@VSZp<O526Ge)~Q&Y@U8d!pU!j&|`z
zw2vlrgke3DblY>#7qwkgw>*F5L1RbbgV?FOI2A3;HR*h;{<*cdfob=eq&Tue4(uZ3
zOjyF9u*Wpfr+$_$m)}&+<NtIp;dZ7Fv}t3kcUv1c5u1o|@Jo-f^^x}>mrUO$BD(r8
zcU~&{v4dDdqw&=~!oK8;l(Ps+_08F&05p}dx;)-lcRAaKSMp**3%_Y^Cafmc@Z@zm
zxqrju+;Z7!T%PP*(}JT>3_~C+zMLk^I2BCaw-FkT(S2-`C7ZL$v9k+*nyMF3q4RX8
zdB$4n*)WA^dlPV~#y?Cp0jJ8|Xb-ELWq3{rQN-*oB}kjfssh%RRnah-Vy(K(Z9cXe
zTBnGcI>*$R%YX86+_wKNA&V+<qeg_r_z>-ykDxjG`s<Wr7CVbr?JQ@Rs~E|`MH{+l
zYX-W=J99Z}z>L$Pj<d>T|2t3D=5LUgFabMXZ>l*LLdU<eoc(eu9|((q9fu{@X4k=2
zZYig{CXW#d9)3f7*s=ov5FQG0@c;dU%O8F(@_B<Q#K~UF-4@k;Zo3Al_>$VsOaw=x
zH16z6t1h=$9b-gKtQM3_3P96QUXjmxDz@^j8!xA~e}dyZ{Tv$_pmB7F$TSj&l{tA_
zQCrWp`bDf<T8S%5w9RK@tZy>IV>KE!kszzn+cZW|WiCZk+0)x$7pe5YoTg6?@Lag<
zf(ffuF(rF50O=V2ke&k&6FSG@gItj_IqM}J(J)PcoJGy?k^~>R>PjAb`pJ~`mu-%k
zCz`R7Du>hoVzXr9a~1pLOcO~Cj~WqnN4w~pMv`<UG-1-Fj?<=&lOJ_+Rn8*TxyqQ$
zd$HRA$Vo6O;q_P#D_td)oRefQ;`TcLGBT!xyozC%_RcDh)$D(1E?~~NLnU|(8yx^i
zlDPUU%XsR0iTjHOjSwSxm~zL=X|wYQ^-l1{XMe!9NA5={F9uFU{&y!)_LB+Y{~{^-
z8R-ttvUf18Xp<pK_C&iaZJSLBK(iq$67`FUsb5sgTUd_}f>>B39@h~}PJ;C2x=?JM
zFqvtDDH!RRG-^$Y832ER(iI_~X=g8+ZmlP`I5p|JY($M2Oe9e%b()|VXIHeF7B#)B
zpdkc8w<pz~uJI44mjIpSXnc^Zo?2u{nv}F0k5N#TUHyMc7ME~kO+EYit*vKMiEAcy
z7Bgp}w60$dus=3?rq-Qgv$qvyDrYi*{n1|b#d<BTN7E5B<2)a3qai-b9l6VAl;E^`
zI=Dy>Me!L?c1F9nA!muL=QRxbduSXE3Dv@3O}hoWbo(k&E^#5}SSTjuZ|y$8^><qz
zdU1S~)Z<J<M?>uU;~%2+j$A7Hu?b-cI**KSV%I?0spiA+0ZUQNY*PSA21%00$#YXw
znoDtMF8PI?1!w#N_y)sgGCfvHfQF64nH^m-X?V4dSR$eL1;l7qz_P(`dJxvH!_EAU
z|6tn2KTJ*n#z@~_vBUTWaHi=1goQ?zem26JZh2K^kofq`*I8Bsn#w=F@@hhZFd1Z<
z)Td4}ZbW%H)PkAd8l4XNvoa3Xg==L@==>~joV~H0w2c3$4CnzK4IG_zxEWx(9J66z
zeK-^wIMokeA4&$CG~Hs)iDB660mx}CESH#-bDlg$*!wa_sYtxc$coJs)GW1TXg8@N
zL@mq&IG?yb%Ilx~A%j19*@E%!LcTpiYCpO$S@yGljsI9s<;e5h^fZo<Zj;i45#{w*
zucd9XO#$e4k*ONuR*jW$BVtL?E*{Znc%?V%G~QEXxO?`xeO(xw)O@@gIm!R{5AsB?
zkv4Ta#hI)ZVhR&8&6llR#y^0|2IHx9it^0FaB>3%=ZgG751+f{hNSmv=pW#TgZ3$H
z+a*5>(5{a2)8H{n@7}SH{f?RUyeYg9q4A4gBZEfjC3Z8R3WFy@C#H469X1DTtSU9V
z968Bz;Wl((&)TTCGw~jsCou=fW>5DL=Wwp8xZ*Q$sei}ILgH>aPjcIRtNFp-zMgP9
zU6>q>4<?)pJng=5jpki__y>zvzO8cl`can?`PK}U{k-%#V#r<%-nnF`(@*;wL$)YP
z2;hZC$EjgaiCJA{?@*;nB!?O^7@H#RYBd8Om@FMw<}69LZDb<Ou@`$-f77C@ZiG%m
zG^i3BJ-75p6$XPwh#@UVzY(NY4`5il_fx?{AkuhF?KJ)YoR0Ks!@INz1d~<T!I5az
z^#Ppb@(qi4@7U%1xFNB?#Z-R!#v#_#RIz3TefVUM(~iUoy0i)Q$NK3@q6s}_r4A%X
z3afGnoN5Htgvk@ZM%#xjPDLPiHr$3+c2eg!YYWIWI{@LB_5PkFb%Y+>&lYzz8{Cz+
zq}12P%mmUT=En&zPTlB#A=B-?&~P*3QI>oyRdtfzc`nEm30eFGA=&Bx-2AT9Jo?T3
zXcnS>$Kr!*b=Rc)01UQI5c0)XcU>*+yeTiGOJzSZqH88?ZwxZhWzQ5zfQI-`QZJTe
zC5a8lOJt6|=J9jNy^=94`}LqD2LK@Ci*e++E;im&hbQ0OfkJb|K%0-#FT+=(o%Cq_
zQ*$Eb?gg37Bw)LZe*mWqhI&+Jj2jV36)%P%80!sDUZ0IJ;1X}YVH3mQ5YKnESl-Jp
z1^@Q)F8<;E-%GpkQ%R}mTF|ctX;a5&)5fPA!e$8*rWtaZGKCdhdQJ_mdNI<TQRDwK
zCW7CDTDZSpGkLO$!irqWa+g*a9#1ZV5i(VFM!VP>>tV68h<3$K^Z)=L07*naR29xr
zmO6`*wuPKF2Uq4($k{|Xz`%|i@WQk)1}_Zk5WoZw0TC8RBQlH#7(_6PM4yS-<-pN}
zA$L*t`S~9_ktJN<0LZ4}DN{1Ojg60ZL9vIc?_A1jzfAnniJ3YFVtrhbQ=jtrLgO(G
z{q`iQuCAe^Ht$r!?<M2^LIlH|K~5eXwsrbuSZM5wb|tk>ZI&wlUCd~z$w2G5gK(^7
z002&EKCaJMY<c@wNag5@J#5%shquUWdB1GHGzG&a&pNj4>Ucs)!c1UbLJCd5;!u<A
z#y{Anb3dpDDODzWfrdLKveW^XtQY^to3A17B^UqKeBAPW{XRd(dIs3Es3xuRD=ryX
zmN64b!3z5H;3-9%QNk&d*q)EB8#r9{8JYPdlTEoT>KM&7^v75wDs*0obnw=^HB_y%
z-!>Q+OD&+L3zK$roOX2_MUq+UC}f4Jlx5BmOU{5d-{v*d?g0tOVMPf*0*WX9laOGQ
znEDf@s2C|G4D9HY;DnH*6CfI8AvfT59j4?n_C-J!2p4vX)O?{w3_P-1LR@d>iQfLP
zE$n=<-BNAw;rIZXJk{h%si&1Sb+YlWW_2+uzVv%YWtpt`UwCCd;fXly`v>ul*zF7p
zUI@3NCRxu|UX-0L`rifmPmE!lryXszbPFccERt35ibpgKJ=?|dtrb))&%m>pAx67{
zXz}^)V=w_T$r7MR<G(c{*W*;|i5HDdiT?TqBg7**Zf|x9fylDVdvDoBQI41YKD^KJ
ze$O0lO4|W&=Qz0b-K&TN;|z5M=xg?!xgW$CqkoKcb<7r{e=2HJx77h~xD;}W-0bd3
zE@)&2Cp90PnvZL$SJ``D0TY4rGZ}_3>Ck+1Xg(B4rv9`u;3&o|pM5Tht8%GbS3+S~
z4zf+p;%P3zVUBeI>JZ{KVA3&&#{>fpw<2*6*e^@$qO#}!eDvZ`u9${tS5`?9KS5xt
z1F&Rm2^+7g;poo91EDlwvNzJrt+~t7JgcC;d7Qvkf6ls3--dUibw#3tEYO;NT{G!A
zHp)P&&vw}}fPK+EI<@4+s>?_e6lRy?-|q_Xh(>?wg{l~Ol8N6IZ7eAV049eSweA}v
zFcM|?w#o&eoHW>$+`XMF6?J(G_a@e1Fols+2~Z}De*kA1HOo_(IxSoX!C?CYi#L|p
za_meXNfLKmyPmqDLjLCE=PfDL9PH{r)pcBs^c)*Wf}8?3OE#6WcvCs?K%B<5A-;2P
z594a)%4kA<6>p)vQRbS<O9-5t`%D^uQ6<@4H=l`NT!t_?srfjm`H&@vcdXdR?Hkun
zRPN1audLN(<^_%f(kcY2fcs1V4EUph9s4B2tFjQ!P_yiHc-Q<#e{5vhyIw~BDPViI
z&%K}6VtLyJb%a5~9zmi|?*#k4{4?4g`9I7F8<YhWVA+pp2>M%m9Qai`{mtVUG5))>
z3HDl4{h7+*!b=K3^F_zO;c1n5%p@CF+tksNYek1n`Z@I5PD10^-OCjXsQ5=RbBzwC
z%)Ou7!oyF!!_xL9AS~*AXWIA&P-J_a-}B3<`dfTx>ikVMwaVsob$sF4?UuGROhNCs
z^`TZ)kN{7Co69e+=imS6J$(Q7-@`|)yc)0D{=r>=A^R1YDk}@AE1I87;5)Co%=TkO
z5)3y>m7ABX;9K{;oku_VLEe4)R*I`~GcJ^)>jv}N2{3QuNU$BGKQkqHmpRZmECzP`
z)EwCHQF{NrcD^sp4yF%5RQ<mZX<)}o0&chSWE-!oW$m^qn)X}Ky%oF^>EOQnjkZn7
z>v^e#{#_lce(x2OzhxUzZVFN7(?h-%i1BY2g26T)y-nk`*7=`Lz>M=uq?J?_idChT
z6oBS~@qzG+(`>aQ9RR->r(2s~u`{)ocr>7L_}NY>mK3sNOGQ?y1P!!JaQ^+B?#d*|
z64&0focBF&1(o&r7nEYnhG}8jxiJ0#oHq3Ugv7axsk&;=+c?J3E#<ZxKa*U!X$eak
zN;v6HJOHxWH^H)s%w#qsprF9Z9oyD&`_{DtLQ&pm?c&FW4iSu}@4yas23T=LRr(h?
z1qt}mJ8$RXk3MeeaT9Ux#!ckq+TVxdAGWWw_O=x(xqI^ls>=)KMHNerUQ|KvbSM$<
zF5q3JqMKr1$3aPwo|I+rV=5kOpYMxHg&A{@rX+n&62evo0N{OJx{^PAm$h-~BYK#F
zv3|CC>~ppZRj2X4_uzPJKdat%4drjX3@OLr0<eH0|AuZd)b6LJX)L3LKTM`3pAI(@
zpJjynY%IN`05s<qno0W`GdtoDk-S34p;&*)4ggH{nhl-wGu9hq@y2qhR~FemoF`RG
zQ!w1=x9xa2c}{M4+Y0XaqfJyVIoklQIAtVBveYY;Xb!+!8UJ8k20#}kF;mAgrM|hp
z#YfHRV%#~|*$Z$QNtU>(w%(Eh5Z5xhCZ9%<pfEp&+b&<jZI`Vf5RS6Ht%n~TIFPb4
zVCW`l%&^@_FD=gFzD<|$lcR@hJ?>1D<al|{wU=k)*h3xZWq9sbwT8Pktfji5aNgIz
zcw}zw)dhwu!8U~0W*Yn@13L}?|0~PVqf|aHJl_{*l^Iu5Wjy?UX0dk&NME#g3TwAj
zvGvw^4!mG(oci8aFH4-oXOtoALXT=Re(zP3|J}{<doQQz&0COXYZP7}k^hKaWuSe6
zk&_d1k~$X%ej90HL{B{}Tz5$UXpRxI?i(N$p1HqiYAv=^x^;ij&A`*4YbNanhv;kZ
zQM;;`$`wVn4n9hS(Vpp>f0MZ?hf`+#)ivDswiR4`=Q2DqG`A`a30+I<0L(TAU@nb+
z0Edl@hcR?KQ(jG`G3l(XyRpu;b7YE%U>29LNl=iN!!27@am$ufjQhfTf7f32bz6HE
zPsKkJp?tCZ!VULcx0&NZ0~{Z+cRKF*D9C*CUB74hL}dUyZV(M6A3!P2$>EQ;-^98l
zmGf@&PbC_>sQX~;Vk@xKG{wWx;ErcZ#Q!Se(I;8=wG_2>=Z2YA?R8&Mk);35#7W=(
zrK?aZ)_fbn<k?7D#)j$`ah;Y&_wninzf1F9|AI(E7n~niJ01BS9LdNvq>E_?M!JI>
zd#RfPzdlKS^Y|PY|L|huByDPXjnJ1AfaaFo#&JfvXYYkc#Q^{~81GMMzv+mDRN4;?
zvH!_7x*NtU%@N5Af`OLln}4kqy#3*yU(0{({{Ub8!CScL9jj(E{s9~=i)-TyQRKNc
z{sEk_ebM0QCQFa?g&69vF9VYahC2N84rjJW+)hf0b9wOYTlx08?!}X21O7mB;w(oh
zNRq^#z5UIsC@sy%@d0EM{^h=Rke8R4IV8RmdL%x4#Z`RgL-(<MSyfgU{{VrpOS1V%
z;1Ys+Bq2R+7JIwR!AJg%o`=(u{K_D+KJ~J!f0yKD0$F0w%3|*N&<4xfkLY1uiFVq3
z85c0HyN!JhJ;u)We4F0yJ&W4W2db8pk$*!s8SM?x^7<gJKhesGU42XpMwrWHo!!wc
z8sbA~9pjP$(A+XH6ruCj?Dw)EOadut+c&FY4D0qZ@1I7E8FU>TVc-9?)3mdXk?tUd
zF?aX*(8&OS(ez$|o35+FTVT!La5$_P(}s4TLnIE*z3~sA*l4uG%;_VJ9S4VI&05VT
zgY6Tv?#pb{I#X1Y7xJGU`h7~h*0b#Xv1rB|a#@l1>vz7DtLm57er&JX$#;MMos^d3
z*?#QP^fpcg#H_ARe|z^`+<C=1+Xs=^MIZ^O@cA7Xkabid#FtEm)NT&!_z#92v2OIv
z5wpAf6<_X<Bz~2N6TkbjTPdxyUMg@rK16eTZj5j}s?zqvVRnD!N9?@s+Z=uL0KJW4
zr&LPj?+%ZJH3r)!XneJoy+3cI>9t;lIwmqAIhKe6v3?H3(vS9DQUIDe!V_^$?Cedb
z05xtzlNtneE`nF1T^V^wOv7ZfC&-CieZ2mQR!;2hXS64X8p~W}AR1ITd2nVY*Q!8)
znS^AgRXNo2djQ1YCd}h=Z~Ox|GMoW`$<nZfS9|AWy_=1mhA~?A4O;5k$X1*#g>Sw4
zUgQLS$Em;Ja0W9nvLf-tyKm+TH(66wvck3X%lQ5W@29Z9-g4rp#3MQ(-(>K_${PBG
zo3^u}K6^zlgb?Vebx~-=<{1PR2_E2&Oj8^c13RA6`yaV&zAxxB3A?H!N%|Wh#65PO
zI494^hrf0$J3jfG<$Yd=wo~ZvP^Dzfdp{pNt}`*HPe#{|jNs03QdH$7uh@;Z(1W+o
zg)0NiX}V?-8jBJfj}aP+5gLyXi)2Ui>u7wC-APXRory~dKyyRb7vtEAJ(fzt28{Hi
za{KiFt?DSNT$$5vH*}Mct^gxllfxTx@?8{^dnqjUP*Cp0lj}@7mF^o1)3T?3*6+;f
z84?a`or2Tikfo^^fcZ53!M-M7fXECP0D#CuoD)0ySiik)-b*Ef5VRi{zF>;>LdENK
z^3^-;;Lo4=jiv3oj*U{Yx+G(fYYDh!-7@}n*&_b)<-NSrk=g|7>Vg6uy!93qRTtZP
zfz#02cs59x$RXTRS<N-;Y@AJ$0kqhp1gKR9AQL?m7ZH+x+hj@HW(@4urAYh<RS&*0
zpBI$aa;<#ebusYBPP-=q16+OQQm%XJ3U)nZ?ZMWC$<x6Tyt`l{`Lg}eT~>%kHHJ?5
z89I6PGp9?&TjU|9z=g}>!0A$Ocodv28HZar`$8Az4hS(#fg06OBO0-YjuzF4MKt0O
zop@L$8?|@$MSIyB>#^;4%PuJZWt_9dzqLqtubzHnZ&$RN#g3wLrd4K=Xiy~@R2k}+
z{C`Q7aOXP6$#db(bx!{4bs#%r6h+42l96Qz*&(606ePe<P1M+A1aG7}fPXmgFeSs{
zGn$N%q&Tf@Y-p2)@_ZZrU~dy}qVhA}V3?LS23d7w71BJ_P3W4*iJg7;2JP3xpHJ2;
zt)eK$%S3egd*7H+5p3utzWxv;wV4gbc|1-&`Q{t=aO`UKwRG{r1N-qsXD>@pkhx>c
z8t&P$p3>sHIVrC(4ROv;#YA!QPu+4urY|XN{3DU1YQPu5Fvn~_g6mAd%hJG(=Oy?O
z)ejz=kL$4Zb{0I0Wbb6)(|qJFucKjaKNBO?CKrZ<#uLFt-dV5#uVnv_lT^@D6aR3;
zlEJW05x~x97l&*p`<Y5z$@~m|`CY*`80N&zz9h;f1btc{?ehlBI4?#!xHETE+Q&)-
zVG3eFjaUX1EW$#&U~tuR$cjw$k^;-eby$3f>YAPv#y^0=#teX!{*&PjKf*9seRa*8
zX9D6;oraft2v5w<<l0OkN$~lbZscpfd1l(5Yr?=30{N6h-LkiztL|MjCkD31<K)Io
zE4Xpf3N+1NA`oRP7$zK#6W4U|b3Byfc`3^G;>~f+xpUapd~PNvE@obP)|6FJQk<Sz
z+Fa0iWE3-r(zf|>$QLRCZWHhZgAe~ymZd+P>v;l}R&Ax`fnR~hh&XS4k(<x#*q+oP
zK4HfAWvD4--T6x-hbaWV4Y%5E`~#E~&0RUy?;8EhJ{n$5u4Z~fj}V=q20K|=)iD~?
z>{QOOgI>*ArlfjtJ}!^-Oo+o`3DD@_wyZGz!QR^6fN4!ibEGRs)2@DuS>#adCO97D
z@NYXWO5^`DYwD{|W-tu|5asOpps6Nfed(19rh?O{P+pqHnkAKNU0u($8<w$gc@4Fd
zMdW&2b8d+0nn~x8bLHQov)Csex#5~jUsBpk3`K~AR5Yw*jvY=J#c|02NC6ok-Desc
zHwPd2GupmAXXPzcS8X9A<xeto5nHw|;_V;XoYX!edYE5^PF!*VGEB_Wc{0>Qi)w!Z
z_9X?N%%H0V&Aa<)KRA?hV`8VC-T<5Pc_q@pghhjHp>a~PR{OnpU2?q;4yQE-ARf&g
ziD^4kfC6URa`EF>Z;(U3?Iaq={C6?h6Xe+Q-5DROIN!*M#P4sNc|g|rS+CYT0||u%
zE_OPm5ek?oljU(ZSX7zanQuckX?Ud<099CX0K6HJRs9{pgAjjd=EaZe1K)VlT%6Ey
z*hZ=P;%@}JoT&@B{|i^JF3IuYgGP|YL&pi3+4Ca2m>AK+JQh4gw+%Jn({V`w$bQEA
zLmd3gNrt;pE8{tlLd0GmqsqC2m2!N}C5*V%Fzi~-uxmZN&b53u8swNEh$l5RE4$Hz
z$w|$c7W(2<$@RHdEder;P!`HGij68jx-c0ttd~<p11g7~?PRnkQ;}#vPs12ZJNs>u
zpN(gUpu<euvT4nXKbtsjMu@JPv>!-M4tgOI@v9fis4#>{a0a{N6W3lh?+xs;Aq>Hh
zXFJa*m&HwM4nR(Rc9di<c!XFXBR?bhcRWSk!x^1^n3VOU2>vuv7os>MzWA@VQ(lu?
zNyxYn<!8a;7j2YrzBr+d@OY>Je+u7gev!2d*6K?NK(?Vqbx!Q=qv4g_lt;G@=^=cx
z3;;7FCviESkWz)uwVYwsdV1Vfax&*edfitt<l2DGv6P@vO-QLAq*M@AD(F`h@qI0a
zKaab3UU#5f1dc$vHil+#IN_RY$qiGt>J)1hU(9oXY_mbrmt@dE*G!sr_R;uiudT+l
zX$o5Q4$^sa1Up3;dK$-4cGBkpZ;q4OS4{5&OgAKOpl#x!E{mE8VG54Dc;O`F$?xdG
z`$d)&u3Eb!^B0yPv9Qh?Pqh>FpLJeTizPspG641>B<?n4>8LUI$h$Ljj^x6xH4pBR
zkbaS&YoVwthp+tCop|$;yO9EBoSy}bGooKyiVX9CAxvJ4oaEVX8@k2R-&Ef6!3}KL
zzR1$HOS4D;NSK270!-~|af6eGhS~pAJ0o4`ML?U>5kNwdJVfPU{Ej+CU8@;zZ=uU`
z9i5)*>2q&m*tHg)Qcp;!K$CN^Dux*q62H<N{B_*LZe77#z>YwR#p%~26<*d|nOtVm
z>XdYC4r|{Np{w>jJH2{p_wra@h(o{Wq`$?Nc3FxRH#qh}H$x{glL2ks-Ou4?y9kY2
zFL|0v-hac^X+IyDVbI_4mwJBZN`X2K4xz>_y!Qu<>A$1T-FSUgYUQgjosI)Tyzyk)
z1@FPI#R>~=!TcyQUgQ)@LOf;;?)W}KkJ#Qdp0q}vgz<TS{3akHE$sEHiuvrfZsy^S
zKbO?-oQTl)d8mO~yvteT%G?<7i<vPa!gG=Klqb2q_lw(j$EPpn!M9rT5o=2dQ#wy3
zhz3;-KGR8QO)ga{iz%wi&DzO~Fd6ahZ=ImOc|4^i$T$+iro@nt7&`TDGmBAk)*v!$
zm`@0apXyFtH%&g_Qt@Q;Z1xio8r_<;UWx19wgNfH7rxad;Bj9FVT!CMC+O(3w?}AF
zidJBK(!yCZ)u8>r5dAGa>Nl2Az9>KG?<nF|IsR%7@la+<b%JA24*m8dvMf`%ynyQE
z#dwR{S+Vxy<hZzZ!zO-l{OCEK4;di@;({S~YD}l$m0mX7v?!H7+k(S47(Pe#b1FmA
zIIu3+!Bwl5X8N)$W9TNn!3aIaM+y06&h$qtIshe=nH#Y7JCESQrVuyFeUH44+6VU7
zb=c%Zx~sp`&A^Vo1HNw8MV!wSw=L!qe|rP}`lVNsYGPD{!873&y0mg`_AbRC*;ki(
zF=GM;WBt4y>%p*C)-V-GlK8_vzm_{cupVIw`r54-N99HNNuMiIg#9YQ6pZ$U80`(=
z$#YS@IG@tGJn~CCWWyUxn1b>CFhd;^j1PnpM%x6F#`dr&F^t5ZDKRW$hD?dTbia>0
zw+nceDf6GIlaDzy7SjBfruZ<X#hC34_pC_z_*S*FW2#P1;~4cDGB<E-b_CIYMt8#~
z{R7sb<hccI!hyu4B5_lvR}WI>ur8l^KGC2`^X`5+^PJSKDxqR&Ax_uK-)(O|=f$ot
z2YMp(jYjdAGAhYMH8puPhG%8M?S3Q_eiA?LravB?{Ex|!Dp`>!%~2@xD%9jVxvn;c
zYwJAZ%%Rr$JFnToFOMHTNB>_H217=OD&@lU+cy}dr)iW$NjAPOG@@aZ<1fuT4`;f*
zxi8;->%0%j(o}=7z7V~~$B2fk8TR2><V>ehQkB~KV|>h@qeG?Zq{{HHPGG{o?>Cw7
z8wC6&{t1JCf97h0q9TRDVuiv&g~B44q9O-{MKWb&4(jS0)Gu{WSvfcJXfn)FQx-2X
z`0!Wcs)xRX4K;}=eJgU<v%}1dz8|EFiG1JkuGIv6F@Es3uP424lRCnf8R5;jt0<Be
zT6}SC88ae0A8DU4t(yqNA@Rv?Z0DwXCvSzJo}i^tnru@5iulhpN@5|Eo`x}c8pd$v
zI4G&hr?@JYg7O@k?zwX;b<JdAD1vVw#CTt5S_KkKz%Vi+QzH7qNDP}Y+1?)CVk-Pd
zgZH}@MrVKk8sftVw*#nKQN*$ojC02<M(R`yNzip{l+bvLlG;2Jr-EsiXB<OA6NpnI
zh;{9h%VLT%varGwXR@q@E-+7RYiK4yaL(XDVVW5F<Z(^I#7wancE#p$S`QBs2`0WX
z8{@-iIRK}Lhcr444$*mJn9|xjifi&HsmVL@9Cu7;e0}FAM@Ocv0jV0<3Rnm{#bNf>
zw*eR?0oCNBUxR@dzibKORwUlDu7HnkDZ)Jml8a8K!b7*-%HO{5+&Q0jY7^5s05GW?
z?=AFDn&AOq^M#?A9R79Zj6WYUA{PjgtSPHx!?KzTU)l6%af7kGAiWKvL_^7!>RA<8
zDK4MAC`8u;4UKV*9Ej51uF~0|(s@!P5J<0-F%U4Jdv+(q<B?dr*h&3T7xncnR;_li
zakGc&ng!Rm>_SM7h=E70mI!~4>aV3Wd@41!XvJsZX8$9fk|psh84QiS?W3E~Rf8XY
zbAQtN4(nll5;)3s?^4#d$`^!jF_-AVV1K-y{jt8J27OE=C(p?r|NSjoaogfEpY^m_
zlt#=l1)%dCfT_fzIs>gf22TBMIr%Q~%X26w&B0sXA}8O4D<}O3gAjsPNF(Hn6P}0>
z7>*Daiy=%gC7LfYh|I7F<6<(RKQ5%KtRc3_K~tev7rfPx{XH1Hy5F+kzzz2#js#DK
zWfh=P*}Ad55MzC*Iq-9h;*{BNO%3~=?M%3Bn>Nl(!oX!yCf76sBi%tpx`Rj(c#A!}
zs5|)Cs7?~2GUk=IA^5>DKRbIO{N)X0tS!rY-SuUw>sWEPl(w<6eJ>rVkE=a1_j)zH
z+RM5d>n=Jcz|>6+KGTUlOW9?cdZ9Ylm+!iDPRqJZm-lp8bhc;1su0NeB|!1G;MkEU
z2lvM~us_1FBXOe9`FYS{F+p>)N^|qM-$hxO!iG&bY~1W&(`Gm8Hss*-X1}#45brec
zE>cEzyq)p~2U9&x%2tb`=7HzUfgRrkK9=e+tniLcUyj4+;0J%VH|c#<VenkIjmG#e
zH+z>+qGV6RdHxVIsiW+PcBdtuTD_!@hrV+M^{a}{`MlSn1F$N~6oA6BH~{Ap4XQ+g
zD#KHx-yAN5oV-a#z~NDFxfPsl1*c0vI?tdJLZHVC)VPis)zRVxYD6azP|*yN2_Z2k
zBnC{GaU2YoG6SZ>#jJDnvf<!nMJF%I*WTlCYjTH@Byq#rk}v-O>ncEEfx3NLZ>hKB
z0O-P?Ssi7gJ2@34D~y^FKOQt`U!ZejIwmwe@T&ptUzNwFuPnut!EAs8eC6&p@!|jZ
z@tMy?jWDA|gfeC3vX91Bd)atPJw+EuZMdPC?EiHKY66wD7VTUq<&Rx`ExEawchuCF
z!FXSgp5vp$QdEMQj@gvqrczm7Ks+vZeNUKYp9%5ebK!Y2_^mQJYVh)lAzprQGJqm0
z5^L7Dx#6Z<ZoJ9M+I8-%oo+0_Ri@5<d0@vqR6lqym1Cq8wv?UXK~t071T0DCIEi@M
z$2Q^0QTYB}>`qB#pid9*<G>Lv^Hg)CXAw>*dm_(sNuM6zwP;t$O}?kO{N{Q-_YXId
zJ5ASrcZ)R#U|DJQG-{jXWaK>^bk!g@Zf&6ihzb}MGJ`^5L`V#oGK0dwn2;8<I!>w>
z0`}?>w>h)dsEr7f_GzMf)3Itx1(o%w^|)9a1eQv_PBw7$o0syvukJ!q6RV6Ji1o3~
zRgPlgnjJvmo2r{g_TFliFa`XmIYe8#pD(V>rE0~g2I35yD?iuGmv6n5zkA_@GoLl7
z!`zUwWY+zTz1Yp_Yip=joPH_Se4@p44*sTdTE(BK3>rav#@SHK`id%Uy=-;Hu1k&T
zjQ0iUK0cNa6}za=5)J|rl0rl-;orWevU_JcvDm_WuuMbH*bt+!A;x$9WsI_N2iIQj
z<@P)BxcXWz4rkWAn`=#YSqwgMzf$$U)5-3fUfn|3LqW6e;XjgP={YjoC3)uu)>B;W
z<sUx(B3e9oc}f$(fmlB+>KNDN)U(P}dVz|;#mbN#Vt>5Pvhgw#k|c5Or!M3E&u^Vk
zRin4fngdW*oIMIav4EN}`8wYzLw{IUXu|y+=Q+)wN{q6>RZccEU7t^5e8h6|?``+b
zJV+@KR%Jk~UQ4!-SLkNjZT0N=^~r?W2Fy6e)nPWflao@N2?0E+Iv2e0Kb6;Yg=d?C
zY-pWe(YjKWY%b5pdA6>u=jM|uc&VcefJSwMt3CAz18U8?`w5IhSiY?)3!m!51V^JB
zd7%p{{`QgB*=h`z?BFYJy**>4Ke3?78^7wv%)w7F+dw`|&c(0P5>zS?l7pe=(<(>L
zN=8R?o_r#}lTQRFDpt7T&3W8;cRri9c(N%okS_`Gf5zaB_bOEnKAy~uX%{X#Y9D&R
z9Ne)3!9(dDD-l=Uxs<P!-^IfpeU`v1vdi70?*ITG07*naR8_MPG~@g>+{)|G9=7Gw
zvBp(~ydamQ#PsNX_DB2Zv0;+0H{ZplzOkLF@0?l2Oqhb+Hj4^C#o1FE8cL%4XC`z3
zy~uPK5<RC3{$W$TsLOVyA}b2j#fzvdT|#wf4dulZfS|Rfm7T|agJGf1BrbdTb##=5
z_z>H@OQ}+_=N<uJx%?-$z|D1cFHiYQPKyqJmG3lLx#b<JEja)H`=Y(9b5+=qx!r3x
zXfiLp4De4?2TR>1J&j}3tt-t~f7QqDxSpdw=w~bvA#Un4szYpcS0~(Wpml;sP-Xq~
zb(S66`9=VJjpLj=Vy)>vWU91kXZs{}+<Ol$cjnY*TJ~jr`f`tc;jp@hQp$v55iz-V
znmsOFCVU1zebmoSAN5mH>)`G87IN>q3Mnni3bjdxBzV*qc-W;>KlCHZJK1q&xhnD}
z#(?)a39hr_c(bu~TNRJ|`W-y{@#ko>_+U=Qgc;-caNDFK;HkAe%{*V22-?+g_Q(5d
z8;rJQYZagQ=1o*3NaGIn1QVu6VNwAozaV@1F=lH3PDGz6@si=-u&JOgTzkwixt;=Q
z%a%}Ax`@isYRZbsC@U_Zupn>RX|S8tuHo|4m+_Ck_&ZD^apo@MsA5QM=JCKWR=7&p
z>aL-}k$Fcz1tv_1AQFBgf+o0t5=l@Z34*$xfNAYM*?#Xz+-Wq0Ta^Jdq=i`m1aR5S
zi>O;sWGP?}6&ibE-3iN05-~0$eyLp)a)1{QK;m)T!H1k0okxaQvCW>0$@$2##NWLA
zE<X0-$w1@5*Z><`m6qO}{=o=)e$m33>*^@0%O>akLbSL+<10M`#;k{MrV47jbHf&D
zDl(Vlj`&sl!<ij?DiAcs&-OEfl`<wAONh(aBi}t=^!Mrf>$k`F-gm~i<Ia5UdtVXj
zH_ZDWG(|%CA7kKQtU3WUt%hII74zZyOj$YvWLyBav?`ac|Kx7|{VT8W$`h?=9V=+Y
zc`4Gt-e?bN+-0nFRm|Ghl&y>!5t`ItPQ*uvTGZ`LggeK<?|<n^?)<=dOX)7F4ZvBa
z05p+&Gqf(?G2O`<Mpk(LwjxV1<wZ5rl-5&IT1RC`C8b5Bl$I3Y%}HKXcj@9f?zrsj
zJhT7j3Aa_HNhvu2w5nsYs$<kS3fbzZrrud>YpzZJ4W_~~x<YTlsBk5Urx>S*;xJ=4
zh~p4393qDE)W6cHTG`w0Uz^r-S(O1zRlRFoId#dBByratY~(wC@|vaH4#fsp>MTi1
z7W7HoaZzXF4jT$>iUF+?EZ$g#GegnmlA=7`vv~`T9XU+UjB_MD$mJeu5|_e+rq_BY
zsm*28)ipRR4!xTzgn)t8aoP_g7hDXQaT?Ugee!cWy!-ksnYg@31hniK$lUQy(Ws6P
zFyqAJV#b`yFB$&RpsIpj{W8F>ei>lP77ri#NC`LI<eks*pi@r3Ba%}6zz-8`Y~Kn|
z`%teK-0?w4@D!<wC|kzmaq!u1-OQ%zYx&;Sb`edpi8CrR4#fsI6dRyS@v_!c!D@FI
zUMYKZVk1JOO&zCE9Z9>f_k31gR>`Noxt*G&MV9yJvDg5-y3Br6k94pynCP7Cg~azY
zCmjpCl)&xqP*=8;>as;tmDEsCQbAd9F-3*>I2`uAm^ZK5WXS>0rWr=otNZB<`6*Sr
ztag>N(llLDbewG$o!E97x3TTUwr$(CZCj1g*tTtFk~B?YTmO6)|5|4au4c`7pX0rs
zqb6OH>)lMwJ@iEv{%0^zmqdYhLuGz^YT@OvZ=|9Yuc&NPO73^aDLxK6JF@d#P2SY0
zN1vh(K;C7khxTPdfY8)-T>6K~wQqae6Sl3q6t=2J@eP^l>fCXCQN1w72^ZJ&sSQgx
zZ@}6r5}*4YCMLWW{j*vUiAH<**r%|Kw>$OI)$~SBlZ|eaadcznNUf>MpKR<e)0;L6
zwXAY4#67oFvGT{ra>KB%H3;&*gy&=LlwBi*)+orNA7R~1StC%!p0~?iwfYu@D1Yh=
zx^Yhb#32o#LO<w>{gil@o`F!9X)XFq3SN3TV2~4n5`ag_Z+q-yaaiV~(E#!|U(YW%
zR@|xHQuC_faj<n_yc<{-zc!TwdrBh3YK3Xiw!Q2Luo3Z%c-V>cHX(<+$K5gd^A3S}
z1v`^lKO51sq-OhDcpwa|q@-vv($Qo^P!$Hf2++~LiaK$z5Xv2Xk(7s49q?FB;i#x-
z%UK!0nURlR;vCIs{VM)7tj)9C9~FcVhVVsUA|47F7J@*$6{@$ICp2at5Y_vSTrj!*
zCpMfJJjY$c+~*Sc{I84qSx=!L*$2FG!`r=VZJZT$_!V|}cmzr$)rgUbf5MlbVHe44
zmq1@yz}szgdMiq%Q$A9gv&Qb}ueJTZKf({ZcD%YTUf;Cz+c4X<(w4o>MTMC-&<y7m
z^v?Njic9_C@ma1M2OTW}$#ZBOeOObV#&5W^w6w*~)~T3_?zDfU@H(et^jz5Cm$Xet
ze7vGttK-a_B#LF8>)auUTl)F+E5Dq&x}N!OE;qG&>8MZh5tG`1Oz328`z9#S>iTMd
z<fC>9jbjEV89KE8tGh5e`Q2Iic8YqEv6!kZGPqmVc{@eRB4f&}Y<l^~(U440EzXlq
zo{oqTH2P925j9pC{U||{yJzKEl_RnK%?O&W#*aMTkG*a*jto%>=uBd1%*lvFi6jq~
zAo{v|TQT5cJ`{H^P^<N}jNq;}!Mc`kC-$MJ!p6B?OV}G)0^QFh(buxa!A+MUbuta2
zB<16_o58rn3uAM`Q+fPRrtz`+rp!uM#e~ZtjCf`g9*f$e-QRkfe+OC|b9SXQ`_|`+
zRjO9$RSUuoH%ftavZ$hABULh!-Xv7TNMhrEAxET425ZwqpH<LTmo_#>Cl4A=O2>@f
zO#9f8aT9TR<%0`1AmmKWN~E|bPG?=YfFa_OLYI*0$G9gkc2zq4Q8}b4+)Pr)N*;2h
z5e9z_%Evq0gAWRnB0(*G8NSCW-`36A)TZ=e;4~`DC0L4}GuNNOHiibiOI)OT)E-n`
z5w_3~%@@6R(r=E$Nj*Z`=d9*yl`oAzTz#laN;jFr(NK+>SbcO+(Ni6s_zB3h`vIaN
z6UWma<?0?9kK)PkFqS**9;~%J62KjW360{qa=j&J_Hv{^t)LyG5=`}@MpF~K7xMgA
z@dXp3xFB_6znR1IWj}LaENI5?t#V(oeJ6`rYr}S4!S#ZUm&-A?IAUvLV`;t7*?mVY
zE#21SQg&J`RV@WOG4|5ZFe+#B)gw>cA!1nO%Ywpy=7Psw^Ub%M$YEAqzMJcPT;dN$
z;<oMlF$e>O@=ovBw*+Uo>4M3;04H*pUJknl6Y*L}WS^gQe@0hl#Z<1dTxeJvK1$?t
zo!-!U-z<2!Z?)?#jzJuVi&NYSmF^GU4Y{afk;;Qo&4~e8?wfIBzT8(0=jry(Y}mmv
z>G4<$7Ix6P;xJq`jfr?B+;<Mjx@W8$+UJlu{h{nB6~-B~vcfjMeQE$XE8yH}hWTnV
zK+2xG1xu!ap|YgvzekNO4Ua&bSp>(KQ$ejGEOWIGx^<F_BY94hOJO-`rGCg(oiZ9J
zqfDjjOqI-!IcX1%i2~J_lOe`D7JE*=1s@@&t$h#(UW+6Nd;8!Y{UDF&v@f%#Tj&A+
z<&-SMFH>hPcTfCw8)yOq-wFktn?_PJ{r<9HU>9uZaQ3m=fS~2u-WPFv0oPIo-UkfO
z0*MHaV<w0mFf3&Q1|ItAS7DC4Pgu6nRha*L-$RVz5#`fE)0Y1#H&vx}li?t@eW&M^
zGlCuTPg}?bK-l@auH=*K+a%4p41=j#IQGWXX0ct#d;L4Bfs~DtICRSXrF_0hpJp1i
z!v0OO&lRB>yRNXf8<KqDG}zU#D^E2QM@310IvY!-BkT-SnCTK>k&{hu&5)9^Gk$?}
zGymC;`uf0y)V&Y;@Am?#qYq-5LGHFDNRDiVt2HxE$4+ANQF5)DtoDPqQ9W~6FR0<a
zvAHJD|C#X$ad#MJ{?$PMsMQOhw~7>{3Y+Z|Y@W+t=Y6PQ%;MsRzrxl?;jE#%f8>Xv
zKOy&2E6cm-+&~L(%VCL_?vPfHQN>hMQE3hBycJVTS5;P471okM<L162o>53UP3Dn7
z4x}jc2&fn|)I?#P-hfS*YrrgE?ebPYCryOqvWBBkOSPK$^X+)@6Hlu#{?}BvjdlA=
zUbW}Vjrr7DH}=J_sHXkT7W}j7x~eu`B$ue6qWX60w9;crL+NFzlqd12U4Ln7XL^(j
z8R)h{-8&Fx%Zp=sbn8~#L}JsZn{nE6Z{ss@uu3<Y)@7X9@$jb8vE9s6OgJB%o5K}C
zgnfZ6L{o5x6LXXkRal{@RsfB1If*r{uY6)|X1+_VA2dXkT_s-^QMGKYJ|tKJCrCew
zns_{ElWZI;BiC?zIi=NX^7T?TEh-0H8(c~b1xn!RtuCy0Cv#w-zc;&iEG|36mgK$J
z&7ck&2RnRyP$~RG16CW<0dIf1SVBno<_9@^hMqDKaeYZ-O-W$}OfWw2y<;ztUXTr?
z1eYI1Z(%nbjq>Eb?1}r|)J4F?&Lw<?0F1Rb?0cJ8GTQu2G1~U}uoL9ii`AzBP7!1p
zWx&Rbc^;&8jJi6GT-z%cw5E%1M^bUrl(n?Qyrif{#GttB><4F{X`*TA>^SwlJM#QX
z{#M}9@Ovy*CiEB6sWw8DaIaJA=aaD$0PyoUt(v>DDPaN3hEWd;gsv_!c1*KS5_Vat
z60KWG@_q^b709bFn1*uc3pavv6WG5;Uw?=Nbk|k^vXuGafzrgh58H05q>EC)qVX^r
zi;TaA51Nb`UgvcoPblFxDCX*~i!?*tnK<8ZkoWO%r)2vVI0;5AKzj-||2e3Q{ab+u
zJt7O=Ib&`px2^214?pABp2qsdNGaf8R7w5!*r&txgNH$<FaB-DV`)iXIH>I7+|E0z
z!g|hcZKd)y3FYAiCO~s~OhAoABP9$A<Hj$mZynlz*MfY~R%x*~;`ON4p=TmBZVh1L
z5b({Z6La@9;#<c@ZwueY-k9gDj|80DFM)fjBITC$z`eI;^VYqtN%t4_YIs4L$-nO$
znQ8R`4JMw0iB>Wt_I!IfvTh4x*0k6vYRY0(Mkl$P`{ocwVyhIX*2z7L@rfnTwz+h<
zh~QCZYu2(eLPfhsbc%TMc;mFrcO3zpVRbuSnBwRV?2lqTAo`B|U2VOYVx}4a(RI3v
zCp`J~3ve>S(JSjOM+%hz1iz15@!{RwQ#LN*A#s$VrqPuPJ6f)Ol(|832H(bvw}$)g
z2X_!!KOdR1L_sAOCvp^ZaF+((2p-?yM8@kYbN*!67gR~OT47kwpn|4uqq(&8CU)EH
z_we>R?l3ZEXDl2qo(!PdIbJ(yPR}m?Ugqq{o=q@35^YT+rM#h9rR!&h1K;)tEw1um
z13u!Uu^F=viohB+2*y8t>COnqeX!l>!L=AzCczN(PK4qJHtIK9eb3j0xq4nU+kPmD
z<NMOY=zE<zjJ=0CK2-i2Hew_F+>_w2-`SNx{`=e{Evy1ys;LUFmMp#>JDWYMYT<0?
zcIP%DH%rCD0%l2&C)pM+AMEMNH9`LK4VE?!C!2vWnVo<e3iEyno(4>-ANPT3=BI#t
zc>m|?-e2(>Rq@Oq4w1|yO?29H*(xEoVv7((pL(M$C$)V=k8;@uH$;*rw!Zkh>YKv$
zB7e_mK0qJ7?JzBu&P`u;$+$%LFiH_(Kr0*^KikSHJpxNs#Sni2FVCoG!QVPwx_~Iu
zWfeY3=~x;(ezUpmB6@}Mw#;T%R%~PB!6QF<Y2R>X@~B3qgJ5sC=bXPWK_mWWihGpe
zPy_B$Ur9ure@`%HpBaNWU8F$y(^Y`v&heN+01Kzx#0m=gM95zI4(1|4e>c{Fw=?1P
z$9~-QOAykzUs;Gnz_#enF4)wJ1p=HxZHUcYW3JAXPKvrqof`Hp@I(RsAesqRS9qHk
zFEb^i0`KEvDw^z)AZm0f2FG@a@7OnqnVb+q@M2+JlF7MD!DK(6mXbnh%In++Q(}@Q
zscN*Evr5xw6_MhUzEDd(Ny9%rEWQ7xaweN?H>C3Ukz7cs@>mL{6wMn>BIclfFOF7}
zM`}bJx1=JAR}pp0BGoPbbc^&H6n|(7@MYbh|Ed4c_XnCU9uLi*fNxSQU(EJF)k3s(
zLyx54Ssaf%%o@%D`Hz}3<lFJFUW!KQJD_g^6yaEYx^%?A@e$hpmD^3Lah>Uj?~W3M
zg@uPxfh8-ygu!AeV+-Xa4+@bI84v46!W<7i>HQt4=tZ_3I+w|9L&v<Kp{{6O@V$!5
zlmHn|ui(QAC5r~c7f8uYV3^^wYYP-KUvG)8H>Ur_i;<I|H=?(;C!!|y2zmcE_@LPL
za@(J_O}{IzL@w^#dyWwo37LG?3A$J*rH+qFR3c}R@~2AjNpzsG%0e&6P(l8u;iYR-
zRqry%lR)=Q>MxwYd%Za}MFRA-ou1sYOMUsT2{?Vvnyfs9R-Iab8S_=!-v_HtHGenT
z=*CibIRo^Um~gtm6AhI;d^+oQ3&r3DJoawEwqgTD;A;8c%5ic#fUYuB+$p6n$Zeqq
z*=(QX#-~iH)-0QJ<D<a(rTs#-y6wf_mx+M(n1#RYpkKn<bNq4S0!_G@YoMj{Jj{<$
z@BNaD;7<W5TFeX{gxXtJ5EYnk)6Z3cArku>fqVN<G;55x9+znP9xsL)JG;THPy)_)
zhOD1!R8>nYmD#>P&gleiD19r7%~ON{{XW7(tI?s=yEqb^R?B*aV%W%im9p2K)bNRl
z^p>3CZVj6Ps>C*%neA^GiliIn&@wPJUFEDtzpMxzH-S<{PkaD&>mRO-vZT*;?NE6~
zH7y+kk`SP=DjF$hyeb|#9U7RJ2uq44?egIQ4wYOe7%V*TgE;T<8MRZ<QHo^|akdQ-
zQk<-n2LK?CxyAc=(g(aN#1l|i5-<$SwA;r?o=&vEK;wR}^z#y;ziL16U;V9}f6L4O
ztt$_+#bI~Qi1dwX)iv1Q(l@uk&>CJ&820mUZ|vls;!Aa3_2A(Ih*9Gg+v*UIhgA?Y
zqzn2Lb`<uhA>P)UvU^0~9|G(@AeQOq4?YZfqxZfR({j0(hG)w+H@<Y&f}NmE#mraI
z;ahjK=h7Usr7s#g66#SN!m%sB=Qk?sL4|jWA;j5ET8&4>VcM+rn)=%lHly@Ro!T~#
zK5d*j`5H5%T(Yyjy)F1W@V14ekq*~>T0Uz0bkSP|xnERq|C3R7pi7`D?$GCT{Y91c
zE&oimGlG&qD@D+Es?|f@=6%SN-=TI*1SD=N_tJPtma&3N!2-ZBoa=prSXOjgb5G;M
zq$vNb>~Z-+k7X8o;@knV8N@NUu!1UNaO(VpR02c=uICMtV|*4YEaddxt_{{LIY(1^
zHJV2UE?>Sdd(Yzzmb}UDj$=mr!-qkKHI8Y{E#>*f<bG3Ko+rOp^N~;a)bhNY^IC0A
zb<z|#f{uqSV!tWX&QvN;vto!8PbL1tWYH^|4ou8MRTeiPz)x{87=@JeZh+@f&u_>C
zwXL=g511*hGyQeVK{u%Y#Jfb6e>ZWSDe30<1VPMKzk%%A^27%<c`(ohgSmsM^lmD8
zkbiA^?vb`OO9gJuRwBu)wZ>p<ls#ZH$VB30WL6?dGt-Tgkdg13abaCXz^6RY2&gIp
zqh{^C*;4^hGOZy41V=(HoUir_%&1;dT(~Jo(2{@r*L4NK<8PAs+T&--oRE8$XOi-I
znhEgby`&8(#^1iqdpvS=J-n{IUh-Lcu57R5dbApk!jHmvIShI4(V0k_fspmKBpJg_
z;QPTrQ%IbDK1n#?q+rS6NJ+~!+GWy{?4;BUez#uDUdms&oIX8`S$bHsnDtsbPM>RC
zbQ>`C^jEWrHMz`sO&-7S>C-ZF6%lImHb8VaSVwHNbz<w7_$3{{3`8Oex^OnsCkqK<
zT`RjoGFnJ1nB15&bzl>k6W_&!FRl09HKTj-!0N_{t_@Isi3eYE3sTR`wqq^mZiOF;
zM8ptr@}&mcbw>dk&$b*l9_*egT>0gRvilcsMz3EH4sm~eqo&zQf!pe6u(@L>J4_!m
zY8x<W)3c27V0?bdB_T_a{hlvNk{wBkj`E$LK%6N(1Gj-rk~S0_gF+68i!!`^qPW0s
zPnqv~&g4NT6kutIrL5eHfQM=AWS^_B^oT_g2@N(0mW~YxL2jVfd|+|6czg~z7vuZC
zmSsUEyOD19Q1R{yT3#U+r)b#<7Q2ob8nEr{zLr|OuUZ>lmJxzU6+qoz3RGp5_MHwe
z_eS4u<Z^JcipUmN$V1k>gAUE%WwN%3URyP(;fhck*`o0jjvQn_mOPjs{?9O}^P+Pq
zmums54K3&Ey_I&jtFE(<jON*Z(rdnmYWJ(r*%_UiYKXo8*0Fplsba5FQ)J?gdEC#d
zFPo6QRz4}f*us<H3OWE_`Q{pm!spIg8c(bg?4y3fk6C0>O{}N$(f)<eMH&VFYJhSu
zy)Tt3fHw$?LM;<d#>ygO((!b)yDRaq;P>`mFZ7Tg+~ime<ixXB_P-~{c^~rxJy<wF
z(JX|Ys*3k9Mj*K!hFq_;@b2~G3)$Q}XoP4YwCv0csV?H{6Bz_kXROrhFADP}-tsW?
zv@H6&Yx>tb1q=`w*2wkY3^<NgID9`NMa)GcP094hmG-O<3y#BkH_P9u*P;grj(sr#
zy_A^Jpet86ghatuP>KRGzeW7rLFKg5a4JFP412vZMTKgZrxB_sDdu8WPNHm@)><J!
z>PA|32f|pDYFO<1S4IU7uOXc>-mw(_tW(;9gQA+Dtt>PUY}!SS035z4J6ug}NLJ-#
zSWs?AG$YwiDHrE^rYJg4rh4-Budha}s<Tscg9y!1cM{Qkl+ii+OrFIq#Ro><eB`71
zXg%i8)8W{)xCM&$w96(a63LQt{l4WYb;RW`>^DG^_B4$`(R#jC1A9IW_%?(@=)S#v
zIlOCL{r6ygM3eBY&cwu-0E1=fD$sDUn{Wf&Ou*y3huA|uK&It%E^^0yq^GSHZtc7i
zU*LU3z{K!0_U|#*8s))vl-PaV0E7G=fy&!L;-3~sJU?;t@*n|#Y~mTz_p=^0rh6;^
z%J0oL!+u*3nhb)~6rF4o<{*<G+QgSB{AA(BpbFk_2%cyNo_Qs>1KIWS#r5mO_3D<=
z-hr@4*SEL}qUL+gg^mrBT|u?G5nQ8l0PZB1q&n%Z<4ztUvzwr$k(%9fGHe+vIe;hY
zd~ZTT%XA6qG8a;{*Ya9Dl+pK?9{`-g>ZZfZE+5B>9e%*A_T)(eW?48!CT{HEpEGJi
zex>&o0uB^9Y(L+6nGs{=lHVOfSGJ#oT(%5+FQ*DIKgGkbSk#=TIHN^678<+j=rlqC
zSGX9YF(Jv0gU34*|4|B6Aa>zL=*9IHg&LL75|b1RoSGr-QjwT}QOl8*ficS^#ekg{
znprrH{^2^P!qI2g`*8MtxIk4&Bg;sV(YDMgLjUA-!_J{=S+_hJfwLa5flqj*anM}L
ziAs$n&X+!jC{MO@&2*d-r`+va2vhg4TEiQ}(6lYnA|IUEU@jYjqR&aBCcSaf)O!Xs
zjQi7(5W2F|qL-ExV_^2)Nb-GNNIvgMiG!;)x4CDZVxB)x;`h706w`n77iV_(cmfO5
z8NmR6ZoU2N27|2UP1?};J~980m+b!i2E)TkZ`<vjdp17`YO<Vk>>c5M*P8uzkjPJ)
zZIJ|57H5Fw*SJGK>e|=bPXD0wNk|#%@WF`N?u<`IBg~gFg@GFz*(ZK0$Nh6Cq*QVC
zY8i&`{Q9N1N!Pco$CkkdU;MB4VbO&#_SaYpAb9`pwcXJ2`1hKBaw2A_oN3Y0p0YY^
zM)c>3g~OqU1~DLs^nxIeM)kK6%n&Wid^Ctui6sUdg`(r))np~18<2DN;Nb)Z&~f-V
z+zE3Kho(112nRt?t3c#a%siJio7+Fp8q<6~{347wyox8UZ`+7|<Lq#<X%lhLC~Vyc
z>+isYE~OehI!GSK?7)!9w^MN^b<4;0J^zGRP}Imatw0?-g88QgF{w0#H0R`b*z#82
z;)C$Hf4nC~!cu&4192?&o-ikO;Luy$XMqgXflyrl__MF`_=SqG$5oAfwAYXs=pJ|A
zsKXEi2;gq!0<b^Ff|Qrl28bo=6onB)xFLfJ><RDRQQb9+rs*H9PD}Y_IdbS8#F<q%
zKGjBriHG|wWqwER^#vo-&?aQrdmRHXc-+O+4F{ZtjFv5u4x|%q1J2nu4O-NRvGu$I
zYJ_DAfr68mZWPbzRGL0(jPSv1dx2~Q3EmA3yN`dAsagXyB*B6QRwwVHNY9%&j8*Ii
z?{^c@qyKhoX+J8$=E6AjB7xMmDlDvpOhttZ<IF`czP}|g?P*vJ<8bOWFx})w#4g7W
z`y_TF?B4#b0k0QZDdkboTIS8n6ZjjY-=4OoUC^_CM;2&D>6JyBK^%zkR2_+gcR#8s
zo}F`gJ^%K22qW-?rhg$&c+wDoY<hiHKz?1u*_5Sa3FH6_qrw3Ig-5Is?c;6k)xwus
zfZeW5hjRFDDkT%_CxBE2M?iFCFh%8@^04s~uY}juecz1|d<9uyq#%Vf+NFxdj9n;H
z{CCUyRwFV#)%*1YBd0JpfX+tcZj&p{+$m|rmayRyMyBl)%3~#bA*>*WFdAQ}G5M$f
z{Gl*RmZqV;@|QkO>UCt!mRrE?Bug8=7rCR@-`}p98cNvu<H-A)?jL7X3sLWG@ud)n
z`!;B-ZmE2M-jyubiPy(4gU^=>T)TZsF>jn$3Xr+}-{N7xhNCg7e;o9ON|XNmKNg_b
z>s!UBsEx%_+A~lm0LNU#>NsXa1b9V$-Hh&tL!C!wU+9GbGy98dvF|e(5Hk|H=QriE
z@ac@>?+tv*CVFeB3%w3M)4P6go%wTy`s^Ly1PZp-0-3<TC+d_00Wqo<Y{57cmfA+D
z8ialxq+<YE1|ak(Z7Kjjf;|_g-1&zErD>E~MQr>mvJ{b|6pUMf^a#KWLj@j2hQD-D
zj!WNiAq&@kU5L1?`g$e{z0L#pd3Df4?Jgj6{6OFWm39a=3zkU;ISWlx0;6VHvgzPn
z{Np=iJ=8;L=43JBoO3U`)`vlCeFx4qJjb6TGIU*Po9RGvZTTVPy00rHHl7p!ogSN1
z7Czcx7l||Ny?oCw+%GfV2Sr?gpLzX58gEW=XNzJi)p29{+qauv-G_6?75Fw?Yqq^`
zSH4SIGWd^f9H`6oKO9*ywU-@^P`|0Kmi~xzgmmb3CqA_~y?N?;w;5;Iia?E{dd>)l
zJ-`U4sB5Va{)cQr4!{BC5PibL^7{+!Pwb)1`&EDVSJBPf<8Jka(znoV@l|k!p%)6n
z6sD0(!7rW==+=%f9$=5%;*7f{lCdWd6JRF0%0WNTv8~jfC`U-BxB6wMfvX;Bck^s?
zN2Jmf0O<t}%^*eQtWl6vs2`*KJGSRr+QW5MUD)kAZr#~dj~x^jJkeE(tRRKKVqqef
z`F0XS!+$F(GAtV_y|ZAxAzS8NRa3G5^n-9zQzwmixwB@5Q;feOGrkmy*ZJ^bY?=Vi
zSb@k{0b{iY8ZizVF$D?O+>N3t6ei}0?k7<?+F~R{NaxkLp%E3sK8ino*x44L=O1eU
z?QH}R)<LvpPd?meMn8ryxt>HWyC$rRC;bSI-4FNc+}4=9lK4XZZ$TyLJxl#rfUXP@
zJHd!f=?0f6b3V%e$gkt_1d-(ROQ*h1GwCPDz>4Ov#Q!YyV&8?&F$CZ9{Rzw$Nzlvh
zwJH^|8p~QD&WSJ7Oe!oftII}0^~3wQ!P9&KQcx}3U<>o4L{iS+6=&32K!=5kt-TR3
zvIPQoL$|D<t@o1tC|$qy$4sPAJWQTu<kOFCtu0Kgv7y9<k*NI%0tk;Sw_&H=%(iNT
z(mL}=moh<$8)Zzx7bj>*P_h()n?)ojzexGQK#6}yCSufbdS*{<`ggW+5K{0@Ze*sn
zjB_qEmM|CFN^?n<)pzTjhYF`RpxYbJsRQWFW7xJOeS45$2DOnJ=t>czNfu=2il4GC
z1xZ$di-MHKF63#%7BYmP<!fX>czLRYJHFTK1o63_Hu6+q`mFs!b`x6M!`&e2sqctC
zJ2)VP&~kHRU`P2tSP%knvW{aX&+a+ojcCB&YfK|6IdGp8&0;Qky<2N6o=B+N2_uj%
z)yDss7uNSf1M{?v`nqhzUqtQiP|i97L9%f!ixvliVLn8nJRtxOIkISJqxVixfyq55
zH;R`;MeC+7PCGxa$P0)@l!e(q2h`c@$E~WD%yo-X6GGY%2HujOw@%&=YV5HyJ{!PC
z428=}u<~qWgXuz(81P9_EM>-vGT~(piaH{G9}toi4bR*<#3~xUny>i&JEN`nv@;eS
zaIoL;N41QGY9E#Pfy~}oj9UOsn9CJJqg1$~Xl8FNsjP*2aAU8}d_Xahr697;fB=ac
zQp>tBP)3+q>__(S`X4T63g~$Ocl?r~yUt#J`J(5g<B-T>)oz=u_s-+TRcv5dSb~zF
z_<W<-(%C(m-2lw)ZP$4tG5E6&+-aLrn9pCfB3MBN_Y<5B&3`ABBV&87sJ#zY21eTW
z?tfNlYT*E2%)a1><u64>;M>1teJ|AG=f99JQ`4(zXc~vpXNmFfhb}bi%;a$=rS_o>
zu>@817=VlJ4cfDC6`Bo8=VaLi4)n?@Llh{W#lF9mXmaH*_OdFeUxdfZyksd@3F5;z
z7-_ZM*+O#ZKY0yeUA4c8^y#UF!6!+wNJB+zR7@5Q)BX8^#twtW4hO?)kpUWi4Gh%K
z;waE!Ls4NBjQO~N7fwiJM@FSLYde%<Pb<`7&wPB`0%rdWZ$H>YW;2=h;G<I;r>K(s
z)Sz$m&<~=|(`hJbLXfxc(w9I8MO}X7uXylr+-Us`xD=<LG<5XDtt$`+H~C=vULq19
zSlWNc7(q%!^RwRN(t87F;7iA1yHRLmK6X_z7IF0k>jG}p3NfSM=(w8UulEZxldsAc
zOWtUxv8Wothx1}+ziAGK-`!VsuQ(E3yNv@q5Fu0hQ6Nku;X=vpQ6VHz0J^Y?QyI&y
zUOiJ1nd|19s*|BQqI?y3P?4PuCk$E8i5y03j8>Vh^?pR)YNqeLZ_9`vO;yW@=e$0P
zQ0#~}RXG+>X1!Cci(HSS{}iy?{cpb2uC$CC6PAGf!Y6H+1g!JygEtXY*65!qY}PNx
zrnHEWbd=o-<f(IXp@=PT;aeW#2ufnAOj!b39FAD+3yMto7ZVXF-rlE_gSrb3j(*eC
z02T5%r;6%_;@Z`i-`{+|bYVyeaEA}1WaW>^@ecRVVxeJ}vGCSD_@_<cC;;EGPw)MN
z;YCMP#)E*A=n?*R?tTTtf)XFlx?P9RwwIfc+I<R7$l~0N>ox1WUKp(oyP<7UPbQA8
zh>U~+k!!QWft`c1Pi+P<`$%@~wlxz4P3~KRBmzS#BqL2acsicnem?RBKxU-;K02=;
zx9rM>=nHQ7o`ouQ&Bp%6{dL7$VveB<($H9U4>B;&drcJ_09b#l7zZ;Lc+U7zKbk=a
zS%d*o{SB=SXAXy|mI!Np^Q!Wlgdk|eD16B#Xv!gE$0Q8&VaMe6I8<LfMBy6X8ga@E
z5K4B2Zp#iCTC)@Voi-FO^NEbeQX@r7h%F-xpumF(JmZVesE@G=NNdbQLiEDu$J)*)
zWn=PF7PD?_HZY}`*ad4p{Loog^3js2Yr+(GvqFEKFkLvr|Jckx{0*6ZsHk%&W*3LE
z)!_7a+~5h%*zF!@<>O3^`5Oh7P4dC#fqkI_P>jUj>mn%%_g7u!!0FX#r&Y&sq?O;Y
z!eC1cH6?0n^itmT{Bn4U<!S$cwfuT|!QeY8_2o_<Zlm<g2!zr5$BrCO^7FI4rwER+
z{O*_%Dx%)3sqEPI>VjBY1tJG=X-jCnF@lyRL<f-?VmMrNSi(vwZ~h^8Xq2OwUgi}V
z8dFr?2d*FScL9n^|1s0+N}saVWkBHk9)#lVN~Rh%NsKL4JV749c!hM5Ow@R(Xz19n
zZYWoL|6h)wla|5#mO(X>kRh9(8ME+wj}6)4esI-eNRm7>66xFG-z&Po!HcC`6uEHq
zp0JQ1_BSgj>75*9kR;<3hkdxK$bxxoMgw!x@$ZdwN4UP?K`a>(!Ki;|O-+w_ueHqq
zlLP;#w$8;=<Xp1$;J*E=LvZMQLDrPT=DWE~cnAmrl>%th%Y0m!^snv~{=O7ZU+iQ;
z30$G5$QriY$ZHp!L_36bvMxVtkU(DChM|u@<7zi#=@{mEO5`i7sPgB`oC_HhaI9RV
z=?=hY`!7!pa8Sk}8S3YG-bvVIH0RzrD<_8{v}CsV{Yy5I%sHP7uh6E|M_uYbs&#~4
z-|q<k5VXIb0I)U-und5KRL0p?F}YYSc%uZUz7lGcH%z<rY(MD8s!}#RIDks{>_{0j
z-Dms(h0W#n@~eNpDcv<>s+1fys{^R008@x(+<=IGic__uiie8fx^ddr1C4sn*+)L4
zbZDMJX}VatBcw?f_?{n@#^jR(W=I|9H6W09wQ1@0riG|hI{qj00A^M(yxqz+l-cW+
zUN&DnC8u^Xg3{naA+j-iE+NQxPq2sc;&fmoFR#;&-5Gu)LmzSf7=m`K6(fGE*RE~<
zFRg>H-o<OX97eq1)~LSi&b1X{Z0vzR{s*&o@JDw3q0g9!=a@Pt7r3qUWLE`sJ&E<H
zsek-vHpjNdlul+mJ^Aw-qu?(|m}(^f+Ej3hw~g@eJY+vcHUd=rH_!odD}Z<Gw?KPY
z%}`~2Q&PNz0j$r((~u9)fK67GsyPSwW{?t1lMv+^{BB#911ZR6h7$HCEdkM4&7~K!
zxI)<RN89dy0ews*h5`Ucj00aayYz|2Z)8|4EoZTP`!1a((qIo(>%^E!upT`g&}in`
zAX)BGczXKzIfffCW9^sL<ZC)$&0f+_hEyWtr>7OYfn94jBDk@>J6sEA5P$P4G{PTa
zxZ~fXyK|--_W73oH~ZdG@#pTdrG*^S!nP*D0<SNN>&>Xc=eFa%1X+fG`}LF9V3Q^8
zbF1b7p8<0o>&sb2a8qwP<g2bj5m}MGT8iLNz4L)G8gLcL6*s57#hl(=W?AT=5fn(D
zhBPdAQ-(Z9!|->G{js32UIqma#}?xi4SpL2xcJtF50ElU0Z7g7L90$rqBgM@r-TXd
z1+7>GFJ)w)ar>#S>zR)yN1p_7l|>vgw9`-(o1Fsa#3-cq&$M4fTj_gKACt*a&>Y<p
z=_O5eSe=+_SONNTgSOM!rU0(;a=<HD^JKszsQ{kYIbhi{u6*rpWN+^i0QZOBsLRzY
z9SdDmnu`)z!TSoP@Wx`@4j*Z|*Hezu6g%g@1edFK<&YDkkH^K}V_eQnO8F-QV}W1%
ziIW0ySwr~(G{&3|1;-D$bM)>lhJZ6Dgx#Zt&Y;z5uD@r}#=*w7k=n}#os+_gcwmgg
zKgWE#FW0<<LuI(A{8iaofYbnmq?@|dN`hUKL=TAdj?F9Ev`C0Q<)Mq((vAuG3X?as
zd(xa5)CipLr1V0PGLf;224?Zp+!bOFvKJP5e69Cqf61l<R!=E_Gwr5rfO2K6_t(mj
z#9z0c5D>BGBy~Rfg{BS2g0<sJPtx;^kcjgJV5#zzkzyO*z4!^eB4xB;$|ULY0f$WV
zjs0_xrbmmswE#z&AHV?v1yYLC%f!~EGwE%QyN`-$y~@(n(kM{Vuj|U6vbd7zbyNY9
z|I?F+*o>A&Y<U}M@;UFm3*YgrmlIncaZ1Op(eqseUY1A&?Hil=L07ux{zwWc<l`HO
zP0a{m=>d5z0CWCz92dqHuRnwNp@pz2`U!AvCm57ATq+d~P^cgg0EXQ&&OcbnBk_Hj
z3HCt-s)45}#c7Zkx&RjagJS59Aya=Tk_YNkDN5bi3!carey^vRj2vN&98(6p!b+gy
z5~GOFHw}|xt0m4fLNY+gANxWur_g^{a8GuOQ>3k?1O9!;Yr+H)s&m%xsAfI<$iX5>
zHww~hl^o2VH<74N4X6Ch`nJmEV#yctp#YPVCWG+F?@qkyHU$BS_$j0?zv3Xr(7I1H
z+X}DtqA39?C%(!a_B<sMk9T&QeF;*pOZ92AJYSH1VpL2bma9sS;kmXr;};fC0d&?P
zdT6k#Qs9b`ho2Y(*JFTB+{3-~U$?h8aO55;hQxs^_X)JK0N9rf=@SeJ(mT3NqL~?)
zf7JUz_q<M8<bvWqYOoam<6#1H1-Rriuv|aTwJK7Bb<T&&UI2>?)52I?AR0GoccIX@
zDWs^0)em&MVPh-N5~&|5+&@yX%-G&-arjqhG)QY!0t%Y2&6nPtH5$GZW->T<P^2w#
z^jAIoHn9!8XtH^1JA0p`m6-a3r2kcZ_jwfG8CKv<A)A!VqEE8SiLbrtWJ{foHw(O*
zg91$;7j$B6+IE9|9K2Z1TdPQkX$kG<NkVBm|1c!0k<ws(J$uK#bhej%u-NXYcF&$v
zkXP(zzH_TV;qq3HVKDD{`2S9vh4p-CgR)mlz3`YgvEvY2GXd%7%;J>`cn0W|4^HSX
z-Eb#_`4orWmK3ZT-jswL1@NH+<8V*%hy0D01x&3!qSw@L`l8hk0$?m^tVsc)nCXE*
zgT_Uu!v~a=g};oBdlXf%DowG8<_^xNS(N&f`tI-kgeaQm8DfcvktJmz+#gzrey1Kr
zw;E4wNbZ*!1p|8T4H5!I&;y-MzrZfgNqX=I&EC$lX}Tc-!%T~P3wG8?vE;hAJ+&un
z#SF#2Z0l990ENP0G`V42@p>L#py5Y=uJN@)8`sV5*3Vcyoi<DVbMG<J1EYOA)IVe~
zXhO`WDUS7#vCWBZ4*t9<=%6Jom~|8t{m)Y?z<|>3=U|SLIYcwZ$(~dT0Gslc<s{@g
z{EL7fkQqkx*o;Pj5yp|5iUFn`tGdg^FgcK*1X7|>I^iaiH}Y=;n?0_PEGM2(OTSE2
z^_g8SZVj^FCq6P*I88yt52NEdk<tcF?+HkfZ(8~)y0XE_@{mHpbm`(hvO(ZuF}7@B
zwsdipEP5}Jw#9mPz$qWX*1uLVm)}RJUjRXxo=%belJB<Yg**j68CboOWz!wD63M_0
zBh+MxAn4@5nMH6k2k_%QHOlIbXBo;&<|M?<1HAE#;RXUgNwn|tZbFTYM?qS$v>7RD
zD^_0s7h+b!YoEswk}N_WA3dadz|Ap%j~csan+^Sfhdse}lcE^^$;UUkA=GQ0D*&Cu
zT?rn5(Wzg?Mc`e7NM(qyvC8(K-vN4AAG}r!N*mUaHjpAUpQHj13<wT2&IbPuWRj#N
z{6mcgpnNJixf3!BvkS;07i=6a!(boK)c2w(jik06Q1__A3#vQ_N-CU1`WiL1a&2bR
z|2rqnKqsknfJ0roZSSLnsU`+0!Db5J?uYh&{ODj=@l_rzl3s-@Ty1j137XLu23P&U
zTk^7$1KgY2#$Gg4KjBY-V*=3eIjAzC$-uRo>>!0IEs;|~oY>qLuiA(ur=I`Rl_yde
z0iRB1IQK6+wozit=-H;?CV=ypcMS^A>y7flT-#0;gotBc4_h%BHwPk^6AdjlJ)AUI
zv4J9tjJl9x`0Ho+0L7MUfaT!@JU+7}I5hJTHQ;YVtBQe3FsBzuG!bgM*(80lU?B~=
zlP_W}UGO|x1$EfyhY%)P$`m%y?_|jF-apG{r>JU8ig?~n-BE^T?v%(xrjmfvU`Uc)
zS9WEz+gmV&vxB}POT1jHc%pBjB&b4k`9eH-^cx0!i>ZrlnWo#|x`$Z?mu*~Ny^+el
zb9J(txRsi6rLVwPR>=*;n*nlVlWSm_)w#TwflDS~UG6un#=43(z`8P~yoLPdJ(q_r
z$F1IP)gisKzrK6}wZukg2s)gXkSuE$FR3rA$?Gwh@6ea}|J*F@6juH5+8<Ggkq*#w
zaC${Sa8ZLxykxsnfRKcM1wiZm6zo5#)G~WS;K+oGRQp_7-WQsKZhe6g%G%N=NMLjj
z!sn_Qv_1aYrcce}r!7{7n1dNo1UWjofgNAt1|G``@Xdee=xA97I97E-^q&Nu_6?q9
zmmcy9VN#cs;R^6VO!6mV{R7m9#eaIkZaLUS^o?*|9b;k!y!yh1IN2Fk58ikJ;}r~_
z9_`5cD4Q_qec)8d`@W3?QaE9eV#|ETloq}cO4h0E4m;rrP`E*m1V%<<o!=}YRVjy-
zP>Y&S4;NegQqh79h7?LIs-UUC#(*WQ=dE$<I(O`_z4pqh`0X}is;vh#*x`bKi-*K;
z(`Gx7_9@c8g53Wq0#$A?Pa<P$p#SY~bWj@2NEfi$yOA(!&!MK#3z4|?IGmvc4gIH$
z5}Chza6=GS^IZ`$S`~nbepJb{_MD4LGsT)A{X%mB@}PA-pRMM1G@Ak7g13X{OktCX
zR3_xT;(c9%!|jl1LJ;;GIzVS!o63|b<zK8TkcQOqKRKh*XZ-KatupC1-<NJ6^$C_%
z*_m_bo}YVAj6^gfq^?4m0C8K~&pgNB@@i0--hO`e$rr?#%OBjFZ5JSTq_EfF$a*(q
z{N_<e&@v{yj8HU|m=ZG=TUb&O$tcAjs&gsg9QyMI0~^P3;qM-7dO82h=`<Nw7Ep54
z<Lf@rS04K$yy_)mUd0MHLj~D41?yJZqI4`fME@q3<(_IttvxF&sn`(}jcKGcGWKk|
zt$b)=ieU>qqo1_GQncsioA2xa3?AxlcoLz)$k2^s<u;qo#8y?)M=}hCt1IffY06TT
z5Po_9mma~k{l{!Ivp7tlxI@>a&54FIO&%2eoqtrz?C=I`auR|2&T=@05?sJXc59qF
zEz)NXA!Hmc*EP<H3Kx;(?vT)AMaJ+a20dc#ngCe4+f|<I*h^<j!O%cT_1zmNY<K(n
z;`)6Yl0$ujRiu((%7f(K&j}i6!k&&T!135x*woZ}z7vFlLdWp25WR~|B5kP#-h5fO
zTw?(f$SxRzFAF~03W;dBrwCD=BI3uNaB_0ckpgo2AcES0CSRO*4s)yF>T_&MON;I-
zObS?(m3_Z;<A8Y{an!Fes$o}uY@jhFm}G4F7C2i#d}J(~piE3}h6BjaRgMN?7plFW
zU`!Z7_q|Mb`Kq)CuO>1%@g*p1w-NW`Z9WNP)(GC|BiDu>DVTqa%9wzW(GD0A+=%v`
z7Ov5699IpE=GPv;IBPmX+l4P<iq*!lD#VaZz{eAQ8@@>yGHc3E$HXcrA&rd>H*CnP
zFDl35b$9JQTj`Tr-6QV59#>v0;7e5kH(m9KRsQV`SS1e4zQ;t4;cg8NPQkT62^3Zv
z#^rzC<UE3@?DU?Ng$pdC*cXNfM1T`4VFtB7*9MkHDhO<^M9#MIOkDxi6;^tQx{6r1
zeo{hX-#jxBvLT$2ak&fA)xJ;w69}vTbhDIlc8)V230yM*K&^oVc3}qo-rP;5>UsnZ
z-2QbDuYi{F^_BGx%iiFSC?PQ`C*104Rr}co81t__eT}1U?z_nGMZCxMWMW7t#Sm#d
z8nSXD*XMVXiIS?9y4YfP<+HH|_Z!U3Z7W7|mqcuAbXVCU(iGo;r6Ly5L}T6wtU0bf
z1*!-G-C*}+y|w$PShieF=nZt>l-S39bsf$SXftU3b9>Uf*%AS5WfrC^d}fgsOdB;l
z*mvGYl&!riuH?pLG{^6&0vjbabjuGH3t*rKx>KNWWJlA?4NQenPH83+ab%V07ahG+
zb!qC&xJoh_ovSTt?`>aH<ptOhXmAr~H0#Cfc`ZR?<M^V1vz-Hhd;LVs<H1VN7)KJN
zm=Gc7j|DZly&o)PhkW!?U;4k;Xii@O{`~Xm_BJ(KG4%zt_hO-$S@1<IB={dMcVGi%
zCOiK!67j_mq})d|Ko~A?g8~2hgOR=DhD~8|0-Q9I^))YkP(~|XZLVGx76d$9>s7yl
zd5$45W9Y9SRjqt~mIt8+-u8pMbJsnMc@_9X)Z|{|BF+y%^us`JmzZ9{zyUB0+H`FP
zC!Yanl@>r=f>jcTFaRu1ZoQgr(Qz1Q$+%j%$K6G2)*l(r61{a{j&l3MD!@!6&Y?3O
zwz^-?TWN>${!`%wBB*$^;D%W{32CiL`sN@=1(d_<f8v;!dj5z^YCvtZvl`o_^_JOm
zS_t?VxW8{zW}+1lIAfk?0T5&nr<qo-MC=p~B+S|P!C*ulvS$iSx;ROft&Oby5wKOp
zU3YhBFHWo2K?2642m@d`APD>fC0f`z;H}x?jlsEzDE%84fR9toV8M+P$^vFnyRaYV
z8Sci_SY}C82aMzxgZS73PaJk5TbJz`O9b&7aIQP!HYlGG)W&A(0miD>onJNYd;Uj%
zZ88(ElBd4>e1E<7eyNsvzGkf<VZF}@szs-ii(elG@M@|K1u$>a1co3k76faU@JL@l
z_KQk2Zh~og%qQlnJ<r;m2Q5n(!CMTISbM>oa>KlL6S`4QzIQ{&D|d()8HLen{#$3t
z0JuKZlLOGP3KjAAm`St71(j5<yP0p#TTUT=L9LRko^hz7=ExtL`?w@ew!(KxNx;p|
zqn1EbOn|p-dG3`glkaXUN*|D!d`L-O*Gzu;IcerT_w%Fl*9?%3TvA&0nHNpXIgf)g
z`RR&vPeVM43#VftqRiAGt28!7^O6#@+O1Ff`WnX$ZZ&ukBxe6Yo!ag$V`EHOXoT`&
zA2)}3f1UWg-ra%Z&~DC}Vlp2CqhRCApo|w&+=&9FLartUSj9_C2IIez3<!bnu|Mrk
zvXID(*QkiL;tsQ#?i<wP#^}yPYRM%;qQJ5C<URF-Auy9f)Fc-q%sKvrEGNfz?vA`+
z+b{_mR`?6Z^irrCElL)Wjb#n@AUua0xMLr-V;{a`6|!U>wqzCp`Z{D3wqyiRN>f&5
z!sTsi>0j-G-P)D6Q$+8TZ7d7$wQp7TD$R5PfS00D=j7|nK^l4n+EMkkw5C{%*C&rB
z2iw}`*(YlUCnkqWVreq0Gk%G(1d;aT9DR8BWBw$5Yvk-IC_Lmr&JC|Kbqyr*ta=}M
z5I6DUf>rAL$0Mep?zFewh-Kea@*IRCDW?RfP+hUd^Yxk?qXHS9+V>jpK8!k>OGx{6
z_HSgP$pkjyp#5TX$FU=QH^|xF5M4yXcCi2t-MH{sh-wJ6-dJ80BhU?6p?&ETo{<CR
z?s85ysAMj#cHBr@(M-1bWf<7ZwdU-C&idYcC|uqj?>!rYzYFFPrNa!VCN6B|2FN}G
zpbF1#m<?ntjfAi&$@K^MhJjdW^5DQbtUe)4Its2l4z6=-u3Qc-LJls1m#?dO9iZ!`
zVVh1rYYll#-BWQ%3DMU>(-1;3AZh`7b-2mkUNvn8YW#v_^vX0G4~8V^Z|110ta)&_
z_Xoos1ca@Uri@*=eO)Eaglfxc05eVLzYMZ<^Gb=n$sz@_x<6N-Zdj|s=D2V7jKusW
z^drz<_NZ;DjABh;r7!Ug0td#ohUU6-qi3IHCIK$5NK&rKkrTtwoa9@PWV}jVIV27`
z;;7Sen#+-25(_Fk<;~L9EB$5X9sKeu&aObC78neQb<!t5$q5pVe9*OKqsj#wh*=GC
zff6cXT9A5$8pHp`0)(>w)~BGv{_SWb@N>2uwv=yl0<<Mn;H<dgmAHStv4ZyxY3&~q
zzWfRFC`|Y0pW7I~LaWKgEYD(SqhO6Fn|*ON)Y~yHgDjkfqrz4I)7*9{Thyd8cXj`R
zQ^0ku&b7m_Zin5T>%LBC4pQw-MzQBM^7-aMR0hh^%%`k6)Q=ynRS_Z~?1o%)BFVVh
zd9Yfo(M|Z%NPwn^0DOE;NBrax<9cKO=Ni5Pj9^VaM`G1kO>Q@$gfqsvb>&c<>El-S
z*yT`;Luby5XHG()2{BB5gHjG|c_v@uXVoX`A4oV8ll>QgWm4eod`D696Gn;Io}+#w
z9j)i<#-ZZczr|i#^?r;#u2^1&K5(Q57rj5O6pUEeS%=0#Wm=Fdb*zL_PJ&m^NSmDp
zip%$)WB4$(g%v%PfC04TFL=lcaD|HJYieWw&|(VeVxek4AxbZ76u1C<yZH++9a$%W
z2=#ZNh149y5f2R0>7`C~^$|Xc({(gBt1%Rfzzu7JfLjh*DmQC2)j3^?lWZ~j_oNl6
zzm@y^aNfimjDs(@ZFG@j31g*MOu#020Nce)5cBh1t=}|y_HZX`NpG~;=;4EygS1gX
z(-8gBVh#w_Q(8TCZvp4-tuC{t&^)y!2%pqY!R4x<Z>#3Oa-0x|6vgEiLQl6ayuh(b
z5feSR8wjNS1(Oi0hZjZ|Vfn$i{AYS^pKRa*SE8gT6BirOiLsUj+UTN0kz%XtGtyhG
z<<<N{b^+LK?SB>tOX`WNx(8`ERO{XS#;O5?+4FQ;NtdexkV#{sk;nLl#t`)paPIUu
z7FI<#p=v6^{}!wUi<+??aJ@uqbS9AULQho+Hg9uTZ(kUF=TV787DVbb|9f16S=ro5
z-yg?w`lW`2OJptwuy*s&>xmq@lS+|=`ujWkEbLhA+Z}qk-9=Y}$sI+R2{*#LJCcEG
z7ABwqo$0eGTGh}G=1WljdoQ4|@#=hbmsSXoBcloTMihT69_9Dr);yG&lGEk3=tM$7
zREeZ?j4w_)Fz;&Bf?Eqrs$cUht4b9%?I6pU@9N6;*4g*ghBKJ6?xHSj#C-6<;X?2F
zE}p1$QWI3}^lgkBu0ZzNbDGfj;KNx3b3elbwrwAS)sfDcT>zeYMyrj>n=b+LP6*e}
znUFz7a2TWnzWOFJ@&K3P%zm!zK7CX!P8Nc#S!iLd?uXGmqo(&Cf?I03N{n8B#HN0r
zi!}SQ#LtO>+-Umu7%YFboXw4$0QHo$ctpXK`k+^3u`+I1Cg}h`Vb4%3r*2)>oi;m|
zW?g2Y7m;B1zaVnQrH`EJu)Zz?ca0-k{s;3tett)9Z0I*VJ@a}h2`V*<wvOoH?ofo;
z*8%gEz{8dqY%T&w;?K<1FclTBQMuMBIxrn1s!|tLK&((rEwW%p>`H(G!ZgJpdz=M_
zebcN$4bFit%w5BpT_4troNfB7TMk_A!w4%BH3DK^g&^Glcc1>hD-^m-LW2`nM<11~
zXd(kR^e9B=*(Qx{Mzhf+(6M^d3QF+Zp2PI83@Hn=2Cx5V<<ABIB%XY@2jTS&8Ui|C
zcx%~r`$-VmdM(b11=_UXT!8EW->+Y5WzmI!EmkS<-Ctk=r>D*2NT8asU`x|`LsmU^
z1uCZbmK6XI`})<Y{TSG&3>(bG>q)7O5vZkVESzn@dki~v_-Nx`#<O}!S+S+eXPda#
ze~lo$@$qL3{dkVi-nWqDv>#{4$f>w>R5N`v#_4^SX<029`dd^c*Q9MA7~sv`^&r13
zeg8>j91Xyv&s{Dp2BiA<mX;_Gny)he|DQu0`#d7b<;5Rv5&$i$tCKbU#c2MF4df@@
zjGFPm&v<{UwMU>Bje*GyP7Zz(j>V2Co!_>tDQsF?Znr^|YkK+qX6@Pi1+j_aCdWbv
z=scs=5T)ThrXz2f1^jD=@^nn32UykGtX;4_km)m-&hZE|5J}#|6^7CW_1d4&Uwg&)
z{Ewz<;I6Cdx+gXpyA2xKZknXAZQE93+qRv?HXEa{ZQI{{-Z8!(aL>4BpS{+ab1r>+
zK{jj6q@n(zK&H2s3vQlt%k(1_6>$g+kvvw)Bu>gWP6h#01h>3g2!kAe#EO7}gk*1r
zLjJXJvb5XOue&QG9fd#?10g)dy(bbXsu(JaJr%rTaIA5IRJDp!^9d?ed6y&;IE4#?
zPcIap=LlhVQ+MAh$5`tI1JU*O*_#n{^rsacx#`!jXJ&lYMZ?{Tj=gUQs7!9$kuzPC
z!BfFZ3)q8Vx)^0GOk~W>9fk<}PeJ>OWv-8E_E&>DenTC|J$SBs(-1KU(vyab=x>9%
z?0v_x8=0AzMhHfoHV;t0l1P#!Ro^kGh4h_%Su8jrFcv_W1%MIy8bGnI=PR58<FR|o
z(CZ)?HB_-N;$*dsg`E7Y1i1*Lex8&ofn1}|HY7Am2_uL*&?XyPHI$$RzB!YA4-KXJ
zHq)#&Zf13tUselEcz%Dyumh$W>G&=Q)5BDD7o>KMv`#M2q=1Md{S%{+Yfmd2a`qRi
zxX*)6HBnTQG2BdnSHde*ZaPqD2^;dOEZkH6D^+U0VedmlM(z8_Ge?P%R?kr@<<R8*
z7k|IquZUT2UsI~rM0QVj+OK99v~?S1=O!$mG+GdHPaq*{5~?6>Jc;iOH=|ZyvS+C<
z!yq+X|DMlULj}{DH3Ij~oJ;2~S#>`Htl-=_H`VID00-*uDm;L@@FbL<p`?SWvu;@1
z$_^n@Jz?p(T*oZ$eOtKGpE?B;@p$_tTksN@sBhWRpBgmb=%T-V;t(QjU(p<HIV{i2
z&-+T_YshJ8zBv{<!95c1U4BvLYCGDjoz`l0YF?qtoU47wQA`;5%M@w>ogeQnK~5=`
zTh7cm37MVRgT_Le`2}kdndUG!>d`;3g;R;aV25%CuTWr7`*J|@k|v|!l-MsuOc3O-
zHd!wOet_$~!a@CBwdg`hSq!i8%=qJMJ9jokS(Hj7tzXE%yvW3fJ*eh`SXY=6397Yw
z-B^o&A?`N!yZkh8Vx|CE{gDOd;b5;gm+4K?oXopdfnDHF|4HzmK_%F|5;w7LJ@lUm
zP&^^khpNR{HMJ40x|VW~E`txV_uf$mX?#HeIL`DdKWz8qq~tM(i$al==$}+EFu%(n
z?;h3mhO4A1meI;&;tYj-=`XEtHXMGCxqDy_&=d-1VaH0BzG0xCkE%ZE{I`h1K*b=O
zi~$L5m0^P&pnxgv4sUNyU~Z0wu3fB_NBdzY#JR*pOkg6gRxHXX<-A3miaJu>({Y6`
zBI)z7H#N3kT|`ji!*WXuGN7!Vp*N<94v+nM5Zi&MtS&7xOWQ+9%`TH4T5(iDU#KFp
zBlPaH5DR{zA!fqrdy!O|cl8(@*sb$*wp{ME&veCU=WNbTG$9DeLs2S0%F>DzIm8-^
zJkqsW!leXMeZvi-wZ~)tulU#u<pE~v34KR-03>E^!2OJW$-2!Z|6kBRP<V}Sz23BE
zB?4Jr(|+5`qCZmB;34-oa?fh5m%Z>PxZ*H1$0i#)R-a$WWaW!OnH*=BX^w!Os?PZ^
zW{PdkP}Ib2+en!b7K{#e=iY9?&L}#Nyc{)e#Ea^u(6^Q&B@*cP9ts-}3!+b0pwq%7
z_m4#X0sFqC=RdaQi)YERR$N@?3Nutc%=(W1;L~I^ON_cD-oWeNa?o7?*W*!gT>l--
z?G5ICHM&7i8>}ffXPw6MOtFwq1@G8K!ltA+7ZC=P4E|ffcrwjUGBHrd%}~fGP#KTx
zI~OPyzBM}S7=_gvkj)vtnALgZCa9=5rM=}O;>3(3XQOqfTX4Vl+Lbmy`p$!uPOd7w
z<-#XqN&^le(c=Xm5zHCF&a(5mVJJ~y;LG!rOeHAHk2~|&=;M*xKVlKTWpU>TQLT>$
z<BBNTKiLV$WD+ndb)`rgUacW~w>!CmZMr-PoU<8pVhr9L4vG7M^{H3q;3VQmqmqEc
z4neUW6d7fyIZ~#8`85xvca7`7`dUN&E9qBhlCRP|!n9ZFJaU%jenE5Vmc;hvh;a6q
z&rcOK&RcYkNepF*RL?H@xOM4(5*W;VjI!M$gdPncE^2+!uc-&_J1f)MIvqG|J`(}~
z6<#^aB(lunw<}B5WQ|2Q-?3g7`=~(4_9NN43*ZW;#yDGILd<u`AB+#iSDnyT!!qg+
zNR%@9I`(|~r~GqqvU-9ioam=p&tj|BT~3r7+3+ZFR78HD?)%Hg&R7GY5MyFb{S=WY
zH#<c#{~N+y1TGEhcWRzIlGjUW(h#O(ck7Ket=71*P`PU2yft?>x{1<e>)@=#3&G|i
z#|rQvmf_SG*EUYxm%$-S9vQlR`!4eL`aWVDi3fS(B(sk*Sl_9dhgCHir&?ri)kDC<
zerdUlF3!%J&=)X-$sIDJ<xvrjXIMf5kMAqix19xnuq|K}uq)Vf%StfowfpT1m&)#e
z*W5G3IJa#<u@&yME>to`{AOAY{_z^tAB_Cb_ybM1>}}Y%(sFr_vOHWakS-Mk?wvEo
zBQL-A(~ELv2lD01lmXfMsymBU5px_Lw1{!a2k)I&XZ2uKL|)<>+|>~;p9&jTDLAl|
zPW(Xw{xV?E9n&bN%AvX1cx9k+q}oMfzp~6<Zzrtoq-nxL@qLMUSyU2GDC1g2c}4x>
z%@Ov&uYw@A>nvkX+j?8E0yaIgLAS_EcxbKNg_jngSXexk0ffd!=6v2L2jT|&Z4^|1
zrx%zW^_?^6$a@posg;^(<%QSdy~P7h+l5Zs&I^s$J(300t3Ghn)7=gZ4B8K{iTPBw
z4MltUlz7b&!*`4~pMBOu_~=Lj<>P{3^B+Wj)%%#Ulq$9*Ol}W6tM~C*heWSUGZT{L
zUvv@XvUgEb*gx8(d^U#btO>_n;JFHz@WvTn(-jb?5oM{_Ca-H2mUre6r{elBxor@F
z_!(^+n0&#gJ<ET*z)^|mZKsPB!b`jz5#uB&LD2aLeqR9Cs>46kaAEpOo*843hhccE
zii#FYa~sSmSQZYtCx<(-->B;8{$&1;hl(_96!-Z!la$_1{21ZgCKBe~O#cNsZRU{A
zUdZ7%O?heX<f4j@2{<u1#avchu&_avAxgVSbb?=7CY5SIY?ELk=pwQ9ZcC@LKGT-u
z<4X{u7B1WK?r4=*;67FSDd&!+OX$cUgK*8OYB~6TFoM5OoXQtK<*gd}-y)Xm5vbB_
zjd_AX!p|+O@$*+SqMp_+N!d)E99qg!MZcsz8@?yNnW5d)&lLBYuoiPPcQi`a5l4b(
zK==ShY1AbKcZw(=zs}W_|JF`hy+{CXCy+)V)H$;)hZ9VCX1&Nc2=zjM@&<Ju43;*y
zruNon)+7qGpr(SP87Gh5uZgdjRuC&1S-!=^Mx_$hf&)g({rb)39v2P?5(fcxDsYmD
z5$eq#Hd=3WlT$quwO=Wd1X<+h$VP26g4fV=nl;9*HOR_)QmXxN8H5w0FhqVa*9#d<
zL`b=bP>Bx5lpE2HG=;ya!kwZ0l8K0Lh=#Q=dYSx<7EzDn{@dQScF_h2pX!bwzt;_w
z1(``Idh6d-W!;r+fU>$6sI=B=t2Tqm`7IQEt$xLJ*erDd(%Kpe5d{;48<HGqHK;1{
z+6|h1F`Z3AgNaBL36<Jgi?#6lV1)X!%#nj-nMfu64hk+-n5G+ION&_ZZee4oVAb+O
zggPn6sTWL4fmyAvUE3JWLz9D%(A1vJr@An}qa$N5FL9@*H$je}x9M0S#K&|itz52R
z1iiaGlHezaXZ~Kvy&I>NODo}O)9Un^f&XxS|2D~piSmFUwdgOhOg@^eHC!-7#TWH3
zlYQ99!JMDXhi%KA9$&+$4TK`@hW~EYGO#Dsx8yru5cdYdq;yQ<zu_wx&zpI({=BMr
zob8#`g?Ku$=q4<fnYT8P0EEfmQg6pf46a!<G$Rt{>GeD4*$Le_%dPFlF+f!Zm)8I8
zI+FBkV1NpUSnrgxE*2~0+vFFObsa?p1E`nJKJ^UhL33LheeOwxfkrj4L<Y{wOB50e
zjn*#_GjgSYfxJayj<{7c&AuWV+3-*xGchTu)o8i!_`dPZ&rsbp1eTC?zDX2O#`&gz
zC(D;K<aanHmeOMG4V`Afl<EbxUd_>?qK8dg0UoRvLSh;F;pO3zRn4P~wOwK6{?y|D
z1LF78V^=OgmP5nyJ-dbg(NAS&c1hJ3s3|^0EmvAfD3#pW`*Wq8+In&TEsD?=4wS0m
zwq0JRNRi@ZBLy>%1ny?TN6`m++?z6#9XqelOU#_;k97G?dm2NA<@-DMlAGy>jo^%5
zmdYfqPvUO(-EWjB=%Z6G-spqBrI@5?QMuXV37d0!nq>2_BM=gr@V*p@YIz4eT(nLN
zZ#T8CwVcy)K>F=8GZ<fO3P|p7$Wr7bE)m2kgT03x${C&q2002Uv4ln#%2B>jbW~K=
z?tZu?D!(|Ue_@uC@G&Wcc2W-i(RvWlU5f5O1N@f2P65`}BLjM%dc~cxc);8<ts<uT
z@La*9q?s=OJN$~*e1-74pdVb~{fNFqh)7|mgFBd7*`UJc&bE%?Y+;bN7Jp>D(bvH%
zA;EC_E(caCMd-U7M-u;6(ox5vXsjDPPBKc5Ca|B&M@(IT1@^Fk+{LwfFpBuSp}uhI
z)1Xqt|J2rDhep@7&*!59;nE`pyXl+wg@Rlu2p^@6XA2AC{KI(TA%Kke5K-6mQHtJq
zoVhoXPYJOAmkWYZoFkpG3qOVjJ|oMwu(HNw1Rdw2m$)~fwjBN_6E)I97@h+-)-ZzH
zNf64nCFqvm)A@=pxiR)Y%giQR{a?4J9ka?6Fv_5&V3`BMf&fX~gMyzJ7HRO)C6hR-
zxW!6jY!Q)_n_GcowJ=!~esf%#cKXboc+^YXte0-h*gn_$L-7H3`)1ZGyY;$eJq+G+
zQIEfShD}cLzT~Xv#w0H=caaQogo}fYodQr^GJn0}TztEF<(jU5z1p+r&YCZ*h@b<L
zD`joJBG35yBQa9Dk?K1;f+ptojCoFoo))O3Lnak+Pa8O#pi)o<Ad1@=c$uvG>(iF8
z1T9JfSA<b31Si)B(Ie%k&2n2?28diGw&kuRq!*`hSI0!|8-N7SFJI#7cpojkU=KT0
zWg0tJv3FGjO>vkK(w5;4kUb1sM7OU!tzn;x@gHtgY+p~Co?gEbyXp;B-|!4*yGKFT
zdYXb<v?<s8T}dU3D#$ce%)R$8XWy>Q30gWKpHzV%dXYr1oS2_cITOLs9gHxs&GcH`
z+P+5V6BXL06nYEDzQcnQKguy2c>rNK43tvXuVxmr6%akiK*K`w>5Yd+yqJjzp)Urt
z`OTWnrP=xs0k@?62M2tyY&mRJ9w=XEaOVr3WpsvsgA1430Ov)AIxqhL0i;#dUXr_H
zKoK>A_K}a@v)I0zUo>sWe&*Na|D4QdR=e)>F(3Y!Q)NoTxDdWNu{$HcP;na5Cx8Fb
z?3K0Nd(y3Qo!T<wAVi0}hezxvW1^hQJ67QaOURBKFvQ0=6;@5boe{fEF3u&}X5Htz
z+O1_hIgRY>ttF6y&pck-eB=UEzm3(dsll$vgk02gqbt-S3tDm9tZ)-yMeuXPfC8xh
zL9z$?aH<44a*gWq)F_0ZEF8l602!)`g0@aKPCx03xDf{RSDIh3it(ubAj!xP!Vc)k
z*5D~A0dR2N?^t#NkSwMlY4yE*T>86wf3AsATa$D-Albq)(G9s5EXYv<cXFJ$E#J7p
zf<+k&{*vW?TW!)6f+cz#6XhgGa^>9N-1<#?rT;2}&wn3gPlo<t-0H#;(*5$OF}<Rq
zvY2C=zh4j2$P1$CO6pwyE2&KZ^TOTLtyT_wMhYx=r5tpITtez`vlMpDtr+$vt--YI
z$AYG+eR^3{lTZ!^ZFcEbimhst#lDTv1YbDmUfd7)YgO67S_I+@A~|EuoP{I<Eml=|
zlWGBT0BYFy#Jrg^hWgYJoy?Mz)$HKBuY#UKI-QtKcqRHzp-e%cbRn6r05<b9+?{a&
z6Ml+Gco<!Tl2$AmN7Bj&w;pU#ia&pKVZXL)M}b;}BX%}Vg{k3^6zrgzAkHtWdMZj#
zSQz-*Z>8zaI;@;i*e+Vvf-k*l2z~Bq?X@3Z)#xBUPd`}=A1@p}+RcbdQa^=H3qWWC
z^SAlCS1OEm@LLXVfv$C&yAA%YBNtySuxV?c2~2HHv$m~$S)~?R!w;)1Ma$wp074NW
zB`Qpv@ROaCByQZmiIr9J+~g~o;?<2LZYmvQ2D|#U14EUP(K^`lmbroVyF}c-C9r8r
zm>w?C=a{hrzd8L5MOK1ro}2;ac`!9xB(|Z`1B`enW0Jjw3UOs>QtD`uOngd7A<7DH
z^b<(*Sx9hBWQ5DW#WnbxM#GsPIfT6N3jrP%^_iJT6>=42%wr{Fo964u8QhiC)3~C!
z@!?IodM1mY3=Yk!0H4dA!v~nF)t^PK8oWfvx^FqsEiWr|pwWrQd;J=q&7l89y8V*(
zIJhs2U|VIa#QY|G4UIqJq*vkoS(B`}`09Y^u`GlJmR4k(3u$u};^+nt0wT&^_sERu
zz(JKE$4(zU^-!N#6YyfDcQXb#e56~3-6^^yGO#~>mEgK|{0-WC*F(yze*O#GV(Haf
zqx&jZ41p&$LgdQ6J`KP%ZTDUjPmCwWB^i0cfUe;mh11#M&l=V|J)ya4YGqV3XePSM
zp!~X4jbp#kLNuipkeT=PzRH`P1})Bpi*V?IiAnqjrCxRZtZrY2WpOzKNU}$8xWTsE
zkyETUqDpiO6M*0Ql0VMYjA@#cg2V6xV!EGgXu9qv7`q-_nWXEf2w*zyy-|qXln8Gt
z^^T`)^Pl6eCESfbK)OzXm%0E9f|t>^&jzf^aLC9h0o(>({@6umgdN@r<_{D!zJ_Td
zc+x*sN+ndg(C^H-)KJ@zXzF3{k;1$IPNIU`|J{&pNuys=Fk>YSV<*B#4yaunJ8>ka
zf<uJ84p-6Mo?z^~j{3bjcKLMFs-CA}*ubtlPez~F*?v-iegWYVR|{$`LI0C5yo}x$
z9c-hmBP;9RAE@L(?^osmEZOr!?fW}3g^|6=S!y5~&^kiq*R??<MWXkLaf3@<V5D2E
zVv&KPPw0R1OgwIN`(pQ+WdjO4XUwHyWMS+9wkh4);ip%3aXCMXQwd^3Ful$mhpyKz
z8}rM|?-P7y<l%OA(P3fakeZq~*7o`iyQXtj#}}9p?Ffd?UL2X`A#=lfpF#sEGWYxv
zMtBhS8A{@8-D5GEXb4<TOL<_wu2K!k02NIejaBoI5kVN*rNVJ3V9Ra{N+Kf6Sy|4%
z)U1bw`kp4{hE-mz8POuBpN4jSczqHVEPb|mta*eWfGrRLI-t-!vJXiq@excpGb-UL
zL-1b<JO}<17$rJ=qMO_v2K(P%+JsZQk9K7{4Y*@arv?XB_9=b}QU@|$Q+Z%Ws|wJP
zSVd<;wo#$wOwWVD>Pcxr&@d){m^hWSo#4S(oHi&&kfQB=@8Pe(U$p6jf|04^3W<r5
zc-m?ozM8P*FdSQ$PlFL72W^`C48HF7iT)Yi;4_u|n>z?*gD055rwWcRYhThxNl0Lv
zjbF<FOAACDE0Nw%D1eRu2!@HbP(X0&)S3C0t9^JIQs7x3$tvs-1#LDCXjg!X$hMpR
z12W6xBX&(Jf&@G}zph`zFmtdt0N<Iu2(PHf%>QTye6G&;iw_|SMy;wIxE4kA>4iAM
zs>ML+SxAUdjy$9_{^O{Ay1z5Ye)}cPvRvXoFuiOjLTO~RI^eMT2lrJ=7F!&^pw{Pf
zhBfC>%5yEuiX<2cC7?g9b=@pjC#1(%pvcgm+i>d7a%;Q<9GF+RIN8W|11^dBiTRa6
zTss$Gs)af~wW4=Q1jM&^Hj!Dl-spzQ61X}Jtx2E8hVkwDrHv)JsI+I4eEzeTCUb8}
zBk*j|4_UBHCPQj@h@{e3GAOFANPtBYDH37#qc$H_6J)Mn1wmBN^o9+hc=+Njusw1n
zy3*+X4I<}#oUERH?vy$C-hw#|<wcot{Kc5h1d!>PRC#w@=DqT0Y|l!}uxro*Qth|u
zTL%%_*Ky+8=Lbx*wOx}8V8>|16P3XN${-@z?zG^YoKo#ywO0ZL)M%096ZL8<yR=NW
z*63j_IzRZHwpo0}-f(^ty1kA4csuO=eswKyw>y-PWqdmw6NveC1jF>7Z4TtWIK$7G
zW9DoMg!#P4!+3byyKe3DtfOqH7V&q1f@Z7mb7-I_Z38i^moq?;ap#eAVbheLA$LH{
zCaM8FbW5-%(@ybTB`;R8{5yS}-q1<QBz30tkkB{$I}<XD-(vfXKC{a6)X>8D5CK3R
z3)GJKwBedM(>uFuEN#Gtcerg8Dd7Gr3rMlLLIHg4<Os*fX>;=v4IH?mquC8X4VJqr
zd?~yCu9Dn-Z~ZAAzQ2ciy88~XR67>@_)(1lvf5c=SwZ%SooCazr~NNf1YS(qN~4<8
zX^4X#0*G5V-fPGuijOKo87enhAS7+9{R5UulFCUEXiNP9>~e#-|Bhx$1OD{c6IiJj
zLiv^L1wjgyRYFY1sp1m)rgNNtfE$Pxi1|fT_oM=MR)6%i-cFF}@S(DCc)((lg5da|
z7&AZU>LMi@7QU&THSR_=C()y&Aqp=Fg9~!{yKX)cMSkqU=9f`T#0Xq_AcKw>t|Dm*
zX_3c%tcu=h)m+51BuM;Q;+T9UcUpg(YCY$T1#%71BqM#C7FR&PH=@@$bFcf;w)UCE
zuUGeUX5L3qR4COTjJ<%VL~bg0lyUFDZ>^I1JdwZ@a1LI2-O9+V;jMjcftjd{6{D|}
zVlo{vXZrpBYXLx=k^eewAO%rxI0Ug)GFDXHJUqTc6y;$-hWU>c`&=AXff|MMnB8FX
znB0Fcx?)j@d;U=qbF7C`)!7wvje%O{!}`Z@W!LJybPidENR|K}4~JP+7_O%DV^baM
zw<%;MAL+L=+RLq$v5D<ChVf?8`4xA3yzC)mRXhfLUBr_9V3^Hob1%>UuRy2jhAbq1
z!Rv8FD&AYAu2N8v_~@9epm+f?CnjV}oaC>2Nu#jP4>O6OrPPKK3PASbTNuP+oBjIz
z%j8a}QfCyze<}*~U~aDI9U_!E4?vytwM;#g3#N_>O-ROn-UM;Ic*>I2J#wRk@MGQ^
z0U@<k#aIWtxF2h4x8^W)Wi8Oo%v^)bv5FjS3g4}8<gXPnr81lxQ2}``wjuij!>&mZ
zPO(FYqzAnZ-REb$>&CXd*8a!mxRt7Ul}BT`XHD&#_;)fgvOq!l6u~3EHK)FqY{?L^
zI~PB#Er;zsazRQsbB^_}^Om9YWMg#|b!Y2Kmcz#ot8c6EE-tPr8sfL^L;~IhS!rDA
z=i`}=9ha}~4*gLgTJFyJvn!`zd(J%3!|wb0BvT){zJ#maO2fT*hU&z37FH!t*x5C(
zjU9+;I7Y7Qe0O%%RNT46L4#k3eO^1?w&HBj!%A%Hoa61(j5jwZb7N4X*`H4f_}3u-
z@dJk~m}3G<NC3JX{tLmZ4p(;O8+h7{1Is&JqVhKhAcD7U>EX#=X~pqpTJcB{4+FC5
z58TEgB;kDhXcVHaL{naeO(YDD>FNbDahDM$Ul<87d|hl7U8=Z>q&d%4w5q=+^!9RK
zz1g!xO5AwL#FHJE<UQMP=SRvLBuJ)C6m;+US5HsIS+8N(aU1h{|Dsy#E)c^;df>Xp
zvUyR(=6J6_nEKPlA`A7D^Z8&`Nq2h~Uk*$3BKnzcD=;l95){-1&61+6<GY#iB6DB+
zuwniM0LIJ8_AXq1Clm9((7p9;mu1V0j!=BLEyqHO7Cpi-oA+9an1Z_Yz|?+emH7sV
zE&etRPAtAGx(W**nqZed0~FTGp&I6ymh%{Z@H`Oo{hv5rHc1j@D;m(Em5>1zD@|b$
zep*Ilo!izBe6s^jEipz(?_f~h8HafdBlNa?EO7NQLx-!)ka9oODB*iD1M$Z&qsfxa
zN-g`kvF?Y@C%*F*nuz8z=-(eBJ{~QHmmjzQTXr32rS1lVfnUnz-*vsr`ExqEnT_dw
zSG9youem9radgy&`n;_Vqjd9#+1eglqALewXLIuL**96wbdgp^I}}^+EDWD0JF;Yt
z87XKhkN&>=U={crn>s$SO*=U@6Jk$mF}Qcu>evP+h>nwv&+hvA@k-o1jR6Z9g<JB0
zww3jnUqPk&^<o=Ish(*bA`0lybCGv_M7@B40oL1!)6;3K)-%1dtd!;q=&8U!0};;H
zY2r$|oM%-c((?0pwFaSD!f))bs&bc{`D9GND3G)@gP`2kye2%4K9phJH!d0u^_vf}
z-|~)yxq=VSa}im9p8@czO%|G3tc&cXPE}U9@Vz}-W+*@uyx?u*`ey>AgbjWkCT13G
z6zZJ_a*@*+9Wm{}L;Dzo2!l@Yc9pH8!@hFR+a?Q`_pL6`gSpb;Y{Co?PC$USR~M?x
z;T`p%6DFp^WBcXabxQWZa+XiV$+6VPN$cTNQ$%$^;ggd1ad|kpjpt(bb&t>Qth}DI
zzJQYY>;2pfFrYk^A%zJXfCwmrEet^4@#>r`QHL{2v}qkq&_s@=S0&=>Jca_GprYe~
zyyf}n7e{jP^Sy3vnHflHHO4bL_k=#Wjvvi)NC&C?#X<Wme<H$!M*O7$^VqQ`hKq_$
zzGrL1)uzEmM1m5Fj1P-6y93PFPd-1zS(8_zrbWJE)oi#;QI(tjb^8nnZ{5xQtJ=$?
zNmkua9!pb0Z8ZGASYwSmH;;Sh<|$>)hn^4s##SMXEtH8jO=x|pKR>#Lu#uqOl<Kxx
zWUD{evH$k5ytzeWk#j<o)wfnouI2dQ%*qjc8JT_f=l0-!@uvMS{*~Zt36BB|J9RGh
zHz5ksER3B``7kb+Z*S#KAp%Gz1fanatm9hYc25o(5PbnWJceak$LfTC_yriK@(&Jz
z=74ZgQqkuY76K9E?J;rbH|delvSfF3&$AGwc>#f;B*Hg!hzYpV)Uym=H_uAm*N)cC
zO>E>yT!(4E^rlZav=?h06TtZ25m3gjO2-=;lXi0doGD0;X?>~#|2VHMOX<<7U+7J5
zL<U^WBL{3g%~TiWqEF1Hq9I_~)oSzMxUi9US*QQW4S(N!6xUg8Oc-u{gVQxT@qi!`
zH#vX1ZFM^*A1|8+HE8}3&p=mXEUoi&-OJg;=8J_iwLfd8$Gem$vzh$Q0T82yu(~mr
z7yl^0Fw=_44TYrm8@Y)sB(E%8#F)@4PEL|BA*AmYuoDliCGyOf<&M#QV~@Enn-(rs
zM#F-cBaEEPpO}P=wpu|4TS>`bIJzbNUS<2h!diOHqSk)3cE^w?A_@ceV~`0R?(4AJ
zDxpP7d8bKGw`f5vouT_}drR+T$)rtvdJYyQzMC1pHZi(-SFXl|i|e<+%5;`M_%RNz
zc$nKPXj^*EGNu_#s<$UQ)2P-NP7!6VKa=tO9R7a(QUs-JrRD&JuaYTJOT%^@8gKC3
zI4BA6DPe5E#+$9s5&%*$HFpfY@TSlH@R;oB(c>l|Lzdu%29)Pb&RoO;%0fwsA?;GN
zONF)`gY5Q0!KeD58fn$!5*&lo0eVvtYW{2C(H&UzlH&5zz-cT15rxKTonWW3UU4(+
z^P?H&X|-SlYYZ4WWRQHuOXxiUK#!9PY^sd@3ibl+r)TpV6DeX}1h=+AG<o@H2RBIG
zx@&#4bNhqexyEyLyl6-Pb+!HSsR0>~F<{DA{^P-Rs#=v_(4JED+FVy}4BBN54tkx;
z#v>sWS~VGI<>gdw3=Q>}j_5-jAKv2@x|-mpr}H9nT~k`Jfqfh>U%%dg)Sb~E%D)r|
z#N*AZ>g=xsZwQ-8PlkI#Ut$(Bc))th?z6P|ZJHI1DEo*XD2REXTT{X8xNj-x=(bvd
z6%NIO?Ov<a*IZ0-FT0kDsPMP0OTC^ybh14~J?ZW{PRNy%_p(hvO>TN_iJna^P$Vq$
zs>s$TvP>U>7cfA?;lys5_R0|dt&wlWrfR0Vixf&A>f7CL|J&K{&roqI&hV&Ozv<P(
zyqe8lBCU>*q{YPXWb(S2BEQesI^JiSXV-ZIHBIr)`G(C-t@Ebl(q^A4DR>-5@zZph
z6Nl18Ps+>fxbHn-7|gUPseq++j_}PIIki$lfJQu}#3K|9z!~R1IcVDE$AWUIKru6G
zFhc-D%TnAre&F4u_aK(E6%zR@W;aAf?U^0-r<0E@FMo6t*UqGFt)e{K4hy)oY!7{-
zZ)@;<304eXR}M-}#`%0|j}Z{qA>Wd%Lfo#a--w@m`kUXp7$CQ)rY3@6ZCs6jg}*OQ
za1G;MDzxVm<>vTKp!Hnj<{uzFe6fkWT_QlVx9fV;o{$c&Q`3jdzdk0(AmwdWRLZ1;
zVI-q1e6hMHGbqwZwVweOPb;sfEo1G>by!d2E5;fufcgyw9t|-BHW-}pWF$DI{{SGn
zAwbTAlF1Bm-{Y!VO`lOx4I%q0?%A#+^2gaRRg!+u9zrhE{f_^i@c#Fe1|oz1kWMT<
zrrQ<lAEg==b~ek^A2H<x_<oK)zvxv<smr$Q(!qQgwtmVhNfocHAn7!jeKoF8V%c)E
z<Uerp%)I1f?Qtc-%PssT?A)0429BGfIz5j&d@0MYI-}JZI(R$v4=qJXugMP&#yFh1
zY>ls^_`N^8Nou+;NEBeiQ&xt1>gS@vq#8rVuJ&T_@x1q8jq-Ua=}%NmZM~-WZH(D?
zHJ$+0_1wr04Kv$*2u~=YCXF2I|2usE82VNm{Aa8rS*)q){*Qz47xK9g99nG|3AL1z
zlfyDYdqMkpDgDMkqu{IDT-zK8t)GL%{rUxE4*b77<Hwe4JlG0t0f3S^C2i|aV;KKG
z?=I{gAhZYwR-jLtQOS`4(-N&T?`<l|ux}r0RL$IBf5{wo2R}z;KVIZChEb5H(=$B3
zXNHj3?;2n77d<F93C_dg9umNb<Haf5yTE$rs>**?S1LPf07%NY{`2Otre>6}b6`M^
zd&T1Ion;KVI9bXFrqESX%^g})X~$vmj(94elgq&K1H?P;r<KRl<<1-PhUfgR)K$iB
zG{?74ZYT4fyZfE8MPAi`=>BuyKps51HUG%Gt$NDBn+XkjiSV&kSUxwL=sBkP2^oBa
zG{I&mI-Z2iPGf_4R5748M)95m?8or~6JUZi)?v6fQs@T4@JbwbtP*}hi6oh^BsXpj
zlJKl4R5X*c6PLG^u1lFxSW`J;!6MkQ#{?U7+uHwBQgUu=o$-yrPkv#20`ZX59${@r
z39qAKWEjxU8>P>x!dms7H*X@M&|6N>Aq{^^WXO?2qG%@DbZ*_0gKYU2d%j<u_nuDZ
zbj#}M`qy~Z#++`hWIyb5kE>6tUw-TfV1EK2yu_j7PMA{F#lC+Vm4bA7L6l$bNK(Z$
zNkIm8Ge&-pNjm3sJi=mIsa$L1Up~JgaftPAYL2yf*DbSJ=J#AVIDNn`Rt_wXvjcrp
zK?{`xagd!`#1|;ahi2LNL=El)_P16|WYHK=L!I32+x)qY9;+#-cCtY9Qem$-taD`G
z-QUb~Mt|Nn>^{4pA-fr+s0r?<nTp8ok|)Y*{Mg)%Ewg2021;01Ghad9Gw5_GuTn1K
z<3&8%y>Du@+UoGJ`yMsocrmiw&@*+)r!B>@hI5GcbFpGs?$U`m;?V9;`f-OEPjmik
z6oI~glA-ZX%gz5)e=fPdwDriJb1>CPPK{K)Q^Vv#Q|ez1gQ8s0TbhZZgc>W^ltl$i
zZCc|!o|U)q<D&x8Mbo?n%>OR$0NF7<uyl^DjJK{KO9wH!9%N20pP7eYR*hQ|HDpqM
zRf}(1Fq@RNtzJ%Bsy#Yk`y1uP%m)T{G)3x7<BzOCtF!Fo@%`rthVKExG*;{syNBnT
z;%vHAB^C=u_kKSW@!>tS*KNhSmb*Cq=H~+tf;_08av+cX$MIJnvA1h1{>I8AjP1o<
zZTCy4398b+BsTj)X;;O)abnlVd5i5f1RIItj=X`Vx>O=r-=86E3f!Ag14e%N9$_bJ
z%o8bTYIaGWo5Wl#3a1z@E+pR1GHAtKTk2g@d}}=^gc}Q=KJObz1OzOH&D+PC2?K4`
zrtGZh#}^VhB!tS~7}-a-4{iZUs<JZYCr(4jpx2J^6g$K{mel`2<oYr8{b@PJXS7yF
z+i;Faec?~C=Eehm<$_|yqGUQ*<!+5UfSN%0ZEo4w0{5q|;d{6I2MhbQ9Y&5oU_E2=
zD`=?diDj$Bd(_)*<1Yn%7dNr(6cm)(v5*id8kX9FO5THs=GlKnMWtdC-EyMIUop@j
z->HB9hSP`{Fyliv{_HXvh1d8}+hNXk+4{21dG@zEp(2HTclq4$n80k_>7oTsNWLI-
zuXd`_dKC>1f7G7S<nUdOA-PoGmyCO!0M<3*0IP~Oow?TJ>91xo!e(bj9A&f-ig%)N
z^x6HM#l}cBaL~Dk|2^mTAaWv|wq9*4`#V}3^_TQzMnX`h08Nc$p4{=uwFnyk1-ZUB
z9AwXn<RFYao|fI>Rrj;O5;vPg!`u?>dpI)jgYtV0hi7+NZs)_CxU9Ompf9%ea9}^8
zM5WWvqXv#o1)PTk;-?>8b&Vi_-PyU_G%V2d$2`=P`t`~5&|oe7N&o=?FDtNpc>LWd
zGgY*j>yUz;@34>MqVYP`I1HcO8++4p&oaFRO(B>naTrTHRM@cNYDcHq>sG@-?VXJ#
z)q2{lI<j((wA;10{5g)d`9n&ivG&RX6ZtHr&Z*V=rVxBG;iX$m@cCU_S}&5UthZ7`
zVWttSMc$Cq&PfS3VAvEA&?uuWlYUkE+H=0JDWYIIj`d|x+XeG+;|}U%tdT9jyr|2I
z=&|#4)BP3-JF1n0N;BT8WZYBBYy)a6F}m7M@$NH7F06D#!WZN~dRm;E$rqQVFpboA
zelM<#`>z}qS=zGjJRPw;M&p`&H?-*|P+_;7=H-t)%DFns(heZt{1-P%U;-|3A5S0g
z>4wAIT>jMFXzP`jf+eq%E8X%9!B|j5gsMewOpp{{Ol^cE(}wV+r~>ObLKH+^EI!0b
z6Y~RaaqK`eV?}aSUVGi}Y<<njF;u>Ni99>T{zt#N(EQuqbJG*Wxuonpb3lhoevS2-
zEf5?6=8h&xY^b(rL-B*B9GdmGXpDJ0!xr?N>^=07PSvWg_#OH~)a5w%{CzQ{PoLLb
zy9Z{2j$y7AwcH3Pq8>X0HWHl1lj%aPCz&^KC3Q@wV$@LAc$77ARIXf$UAo2M2X2BJ
z(}!$4lzoD@#g!Rmm?tU0m{U8C)?n9iXAo)gMCFAE5{!B;Q4+)`Qzy7J{HNqVn;V(A
zyDBVSAOXg2@{3Bkl8W!I*KW3ZBi984HUd2#586+CyA?i5bnfF->f?3An6wr;!scO)
zJEtRZohlL<-x!y^h04aKTkz&h+powpszBv(-K*R%dp%D{iSj3yk;!cOri{YBk0;bc
zfxJw?<r8HL|E((fg{Mh*2@8cxNQA471Hu?K-FVAdasK#VhKkmpV~s$zla&%^rq|n&
z)Gh)!89MwFUw25ecKg@;$N?vEBAJ>&23|58?r&GF2+U~m8vj}Xqh7ORxNROM8S`SN
z@6*W1j<x7^BSD(LLVi9$yt9;lQc4CDWg;6}tcbFJdog+-s@rdU2}y^sLTYR(XX6Fh
z^Lwb{%SQzr{^#nvv>j?{z4aT+O3g0tuNxv{c;p1p=!ijZB7JI76jtm!Ae{i?;P7kF
zReX&awIM^gTL*ejZ?gE>yX_@u9H;V}b_K+hzewxqAyX3U_0Zw6OM|Nh6aZk=hvC<F
z@gONr@ZRjygpxb_6jBGN97colTHY7r>FL(eSR*tku@k67SOY`yCY@(%lJ3r%j_HUq
zZ`T`e5P+}W58|2*4_|~y-S|5%7BJnATr0E@yoZGyeb^SL4dfqc0m~^^>8Gb`Q4zyX
zJWWBIpM7K}2vj6rReG_FTYUOLn*IaV8sn)b<wxzM=2mr}x-PQg7BK@d&}38(a8V%F
zPpU`|47u4!b_~#CjfX^TM+#XN6~7*6fBj2olT4YG!mD<)&eMwA6N2oVeQmoP*o4^Q
zA0+xbr4}kr82M|}WBHH%578oHML)9M;Q0!*r8nb`$Ffi3&FgbT4(#Otk+GV+_<L-5
zrNZ;)bBowgHF`t5B-#fT*fky{nHn3K5m&o=E{>a$6rZfSj;@vrX3v}Wf`AZiDk>_y
zV|43?xnn6_MD3cgf7#@uIZd<5JE(XV!q8BD-l2%6y6CF0m$}ta8ToSus{L)yfFMy;
zlgSAu^9;#<cHF77=}GVy@I$bfN7fQR<takZbD1|OmTXhVEpYCMAv)haLqcFmi+m{A
zF$pWj{3{S5*WKgkbz?E~`vaAauY}DCA&(1CGlK*S^KV3<NpQla=T7t5EIcGo+r#0X
zN1}-H@0a%9?)L>|H#oMrf2rP_$xP~cP#xBAnQAH4fWlg?N0OBOdK#GO3;`TD{oLzI
zT88{#HD3g_3xBVk-j3*|oPlo(Uf;Lxs;(;y`>0S*$ap8i7clAKkRFg#vNW8hWKu3+
zZeplJ{-v@;KaI{2lR2suZ~#cZaS1KiUrc{#q@)M{9NQlO%aMS++SC_zcJosR9BXJ3
zR&dLbHY1r681aHkqXK(wZVK<TNhc}xQa;IIi=xa1VU^NpmZ3hfjI-5Ed(m@iwfnq$
zI;dKsH1Bv17P$Qej7cYsuz0f6#eY3~9Gm^x9Nxifw^MU#oEa~TM#&smgP;M`W2!dq
zc($ES@DmZA9q3`jl2V5BAF>LwlwV`6PyVD%X!&fnC+PeHe$Kc^-=dXoJ!3yGvL-5#
zJBY@H_Q_S``s9R{NTc4%Ozsft{n!PU-i>Y=!o^dHN09;(k54AYH#7oi9USN(sAf%*
zGNOhBDpb=PL|y&C*uEy^5+|H%jT}XW|K=P{Js*inYHJmy%%u^euqbWfDb?*P;QEB`
z&K1L=6$>(v3~HZJ5$3KSqe}|Ps_Nx5Oj!TL1X0UWrP=Z<j4hio4A{&)8IQ=5iRZWK
zBTpb*ensu@`)OTuX0zPu_n@7AayVSjkQ<J9yHNW_A5Gfvgca94N|gQQvqD-t1(iEP
zIpP9uSm@(;((#Q5g85pPuVLqxOJ$_tl`<z<A<11!-t4Wi5?8wk&8hs{o;atDA08m_
zcgU(KR&3xq!S}$et6oaeoRR{85Rx)nzyGY&MhW@&5DGDBVg=kc74}<TIN4t}uOESW
z3%HGiKU-<;gW9+LWnngZ;xv1@EpRewBJ|8t?ph?WGQ8=N{pNQva@ha&NPI*_B;Z&g
zPzYkucdY-?%*h7IB4UMw@`{Qg_Q&u_OoY^PNj7^|jK|d4t#HddSOWTWxINbpJzjr(
zJiUYs2?_6z_QtNC^yp6v>pRQs&=%AchL6s|ON47<U==pwu&DpCc#k+7RZ~#Y{GM;P
zX&Fyz-#^H4UA5_B-nYAJf#cJWA{4>ix+lokw@JJ?1mZ&xb6k9p+r{`GG4`2ljML7`
zbhef*#1Le);PLDp|KkOsB!ttB>)M-oy++XF;*I{O)J$jt6qxa$G>|{h;BTS^C7EaA
z!1?$ffIo(+G^(mKbA}RJl0TA!|7wN3h5zf`o&lU}GuCEv+=TQmH)_Xl`rxe5tH)CC
z?>~3ZRHx3QSLzQrB~w_(#mvRjlPMXT<#kTLu}tqZl6gmJ5-Ce#DN7S$6{LiqJfOnh
zG=}j`%GFsOd0iU1n77@b3#`*Y4q1?7+%U#=_oQM$L8;L4OL;FG*1RPmpb`IwT<i}i
zp27PcAXbkOKRSids}=jVU~vw?h}f$@&PO%PVoB599#R~{V#h5;k?L4Ip6R&Pfc1He
z3JQF36q6dKli7U3u)hpU-`c6sg)yw1#Uxd6_7Qi{6sKs}5QD!F@TISbjp|utHlk0Y
zjE;NOn-~6Vrnn#Up#}JO5@1$s+n+Ry<_5k$4ts`~C64ilGqT3RF-pkS|Fjl~Dz?9%
zUpHQeFSh-kY)%@29MGkai=;v5_lpDE)8yArmEuBDC_L3EEhTWP)tUIX8OdseF16xZ
z=1#)(RN@s~6^e<gQ?hNbNWNXr5cs4Y4Nm82<A2Pqr5=D0s}z3vzR3Ha&Bpd~j3QbH
zYYYy_f7L0qTyvkDPu!5!3})?{;o36vn$Fho^8Q_7C(w`Ec8SBpo1;Cs4Eu&i6hnoB
zp@7}qX$L_{e2wLQLEJ_0w+}35^&wRT>jPNiB;dv?3N47h-k!v(X^{;FO4Z;LAeNR4
z_ira3R|PU-O~U;XrRdwF<9x^$@`CRQ*KBS=jfm=mz=}jM;~su{b|HvPdy^Qmi=&5R
zx*ylQ0HvT*ND*SuDaJzmblOU<<Ivlyt*I^G)0!lw+!bdJb2tuUxDWu+A5WXas}hnG
zJfMF$G<-Uj+&Mn?yi5)$-VMp}Y;LZX3kN5@$V_rBA!y5s!>dCIkqh-zP+n1bDYEkl
zZ0Tl2zi)fZ4r3nTudqZ^2oUxqm@7;3pE$!S*wN*qLran8T22T$$js+0O+8Sg51e20
zozDn2tXE?S?R6(~&IV_34-_=uP~f8ZOSaC%_;MYWthF33coHJf??h%ji^$PIqelOP
zOk|+s;i>0Eij!gJY}QDd^NKsGj*f_lH#__f4w0gk9ZG!%NhoqkgqQ#hE+E~q{*zMT
z#N+R^J-DwK>tscS)BC+Fm5_d)N#6{m{LyNS!yYb_?&80WGfa{F!IZ}+P5*Cla8xUZ
zJqwjtAVQk<8J)j-hWPrfk9>AH^7ID1TQHR8+AQ%ZX(6iKRIgf9G^@<BjbmG>S?_eA
zcDB4Y`9;?1J33*z*DMKFc=^p+geUHU8EwU^CbS&7xR1Lipr=Q2yb4>{2q}hUkA5<8
z;Ydk<tN1a!g_Ix1nbB0(tQHe?jlUM%bnkGcX4^J5$`!2nedBLbNUmwjXj};fGzwf`
z*9Qw#t>K}3aLDkKcM$qd!(`j6XfpB2>}xQ=gTSO~Y|>TNrpZz(HFnT}Dpkc;Vs;Sv
z7fewjHik#OMoUqoSx&Yy{iXcj>V};L8MS`#mFRs8YptZ+0iSGe7w%@su%_rvCyp$O
zLq9O_&V(Jr@6=<;9ie;n<Lz4;)-~jvjjl-p^B`HV!poV@;Obm$d3>H<lN;7)`oqG;
zzUsP}Zw4aF91jRa=(U`Wr-=WNoo*E=x;GEnCIxqf$Nm5=vh`gqZ8Gen81p6?TWe<+
zfjJ>ce$I<2gIdTMYwNUuWhvc%karjI-?emy-=>>Y_pcJ**H@La@lR9ev;@=YJ^GmP
z0z-O_1|C(J!TlIxJ`HK`b(d|e<jhI1BI=zr5qw_8C|+J<Ay?y@8htBoEwo~JA@rU=
z5yxZP9=VKr6D~@c-Q`^BV<3i_|7M~HK=ceqOyauF8e#p46|s98a{b(ghyruv2L9xw
zAIuA;M1H%nCui^$gc8YV$bWlws^xkPUAbWXp@uPCFKPT#Dy)MGiz)Q(uZCRqCX#Qj
z<7RI=%WddWDLePPkjaMc^2x%0CKd|I#1^Vdq<Q;pC&}TMQBhhUxo&INw9Q2!mrrdR
zL4GEJ&cQEg{QtE85{Ui~{(3byGxt;Z@yWE3w6+@kw>1L%+b!8w{Na^ssYQ3MhJn5i
zFg(Xc1bhCsDRQcs=?|?Y)a9rIyi0!{&Z|rlrN!|S`Qtap1;Ifmkx^_kQ`TkIdl~`b
z*m-owq@oEB%+l5Y^5hcrWl?h&0*AjCxh=&Apn^!0v2r|1{*$~gVgjqTd-5XwUQo(|
z!*fxENg$2mzwe<3x#c<e<-D(Fr;y-ZHi^SS&0PSUdYK%6BxRp5NJhFXZva*0^r={u
zq1(Y1f5RJDC8CyBEO?Xds=efZNAXOGsIcstA5TLH*K=A15j41dwwDFZ?csc#_q!Lt
zLmF*s1yUZoM$E$>&@J!ix^_`(=#+BuITZWPd~)HyLdeu=7N678XBi<fzUlzs<>-jQ
zS8f5I6do+3sLMSJ%=^F>MP=7-u;kEG4N{rxwzijss}ER{8XP|H2W;)A;5y#s#OoJ(
zlU;to#2OZ<<l+YF9>2kTzuKPMge8c4#<H^&8a?fHwp2O}y}Og39we!v*j;BNpE~db
zoG~&MP7tnsInA9`;M%^_q7mxZPNrX3@lfmPh}$2-H!;qo4BRr)WZ-cj8cewB<P&KZ
zj|T}B(9jyOTO{1jK-7c=gfB=N;ZiEd^D|?O7O<-`GBr~5apUwI#uh4VZBD?GLL^55
z0GG~<VA`=tZ5CH_6SnrHwknbO$rcXwF4iNngQ;c(`MjwLtIIsn%ti;UWCG294MgW(
zQ5Q@DdUB3_GG5p1ji7NPVbUklPI}Fl<qGiYhLWBSv&LM)pMRUuVzxO}Eg$#-&*Rcm
z=ksZw%wTJ@JnJ!jkhU36KuHavI!pH+83&Jz3$sL>o&f4Dr(X28=4=OOXvL5&9YC60
zde^`LR+(}n9_}(MsGjUl<^8XkF;9OsN#69G0^;>hd#MBMkFn_S=&Y)dx`7kriRGLn
z+U=fR86DZ#J5O|Fva8{SG{r1eeI1H9Zm688sRY^ctv-Ylg}r~KwTW=$s0~eR?)S>?
zPVg9P5^A{Lrj(esTckCS<yBOKMV`;jBuAAol=q8L9*f9AD#Ia%16ETt?ZD!Pik0Yu
z^GT&^ULRfmSQwMu9xRTJMEY(LA8h5(BNLpE;QftO53hXn+#CULaLjgu;bLw6Eol5v
zBip$);@S33#T&43$fu<K(8Dp!^F~Nl0$~)yyVs-h+pT-(Yd3#4udmwac8-3j=wzTy
zRQ+tXZO3>}2-Ax<R;e@_zZft93(;(IGoAyR*!^wKLA`>-d6->tDb!iA*iTI49^~)E
z^FUSUhy~lxg&NlKVeGh}hV335b_t;@@BYxb*!t0iv}7&X=}J$c)EmKYAuXBCl8KYg
z;owU>tgwEFi6{bk^beiYmA(%5d0HLTkl9(G^%|Bm%5sU}Yj4o&6;@bMmb?ZG4VZzm
zGfoGKE1;AMb!VX^;2!+b<XizkD)RED+6+;bW!?=r6$n5X7W{+pL(nL3MJ6<Fd#iF9
zcpPYFg#iG~CZeH36#I+Th&WRr(<_WWuABDkwp@v`2u_>})#h6EVdAFmpB&!9etLm|
zas?GDg}IxLQ~0OFE48%8T%fGzlt6a~O^sTDW7^;4;QaEAt3IOWrlL#rSz_~E6Y9bx
zjhfx@4U%j*PP;z|ApccXNo#PO&&A5FVvt6$58Bw~)E>g=(Gb$~z@I-e?)uvJlq$%c
z?i+>Z>*vQF{EZIdkbL?&+svxT0+c-C0)KpPD_#8I&wv-UdkytV!nNZo?{}BG_YYJH
z<b^|7tZXxE<>-AXx*}wPvw=$#$76Dul5XK6vTp-oRP&$<N=1mR3=X-of~UjK*#RU}
zcgJgWaolBSY9XOXAjX->&>t@?vyDjNKiY3YN#3VWvrY%*m-4>8*{rNK{@sa=$)#!d
z60w)tqfkAzHdN5OC}~@RJva3J?_c6HV@c*qu*1#mYzo-~bgf!u^yCk2ZkVGp91?<=
z)pxZD#L~%>BoK^-fUu@*6$pOqWf$alPAR6aHopZqh!AAgS}XNViZHhSl0c|LvamJZ
zITf0Ak#?>F5fL8k#X=eV+)#p&%M+td&+zsxV>*X0Q)-I;*s+^Un*Mj}H=|(4gclOe
zOL=Pe8oKGWT@D^8xKiZ*u~aZ1@(BW@%1v^4>L;5T+i};b`I~01i?}wk&*vDy<~i`T
z1hr0b=qJ?sd{Tx>{2B%b2_eKXkmWQq#D4yUnpY-IOyOeEq~PE|jT$;Wznz}j%_}iY
z{qVL`5QvvT#mg}^so&rSM4@|n1X<#@Vq@<R0K7&CzvxjQuwVW^Z*SYC$3;#KMJf<8
zbnWret-~*Fu<LTbri&pmKY{(pDxblDb01XeX2#i*L%crla*v?aQA&@%l7R~eiWZ*w
z9G#tIk{0FPCgtu@i))pYu@)-Fs@4az1T`<w+zhjn4(W!;%spk!*B7G)EljfVqS^kh
zrK=2Ut82CtDelGHDWy={3B|Q&kV1=laW7un-Q6KjC|2Cvi@UqKL--Ewz4@2t$;nA(
z&t9|k%$hmo@M6lDKYt?n`9Zh*R7J4u7M?2DXYc8miIV*bLa{!5S~Jya$E=~2!=Woc
zh)=**)=5{Cv7;)_6(n{08(yst;{R)vLRfi&pIS_acdw74zkFA|F}Zd*aDmMO1`Vx-
zMlxSy6*7BIOsqNp(@ZtY^J#5YF{(9m#QL-3ps1|9Gp;NejyzgSmMCkxjKMiPz*rPr
zZYg&&>foCcPK$1?3R_yD2y|DHoR5$6YS6*7oDnT2fucrn%CYwR1m9A}I27rV(7?)s
zkz_@~g`S_=985o$#0^6d6jJ2JMc~A`-emr?keYc=+OP=bei`D#OAnIBBwj}b2P?nn
zAW1d?>Z1bpZrn%QsOn94X(Qn>iHb2KU@$O#QHEA6cbpeE@YwRoGQJy1$>jb`1QRw&
z1d~Hd1o-9%AiIf;box8uP>TQqk;c-X(cDs%ldGcRF@b@L>DnSl&$u}UV#faAtzCzk
zTyg27x+Gg1K+*p;J10LQ@=pi{$^P=)!&WdfCMs_cCb@`jAXPF;Tin)oS9PE8$;;dR
zI@`A&d$4TeJszda;tDL1`fpBJ;Gy%ChAlvTex;0rK{5g6H#EtdMNpR~3PuPR@C&e&
zF@n^C5~FbSbGR_DDGf|W$nTjqEx!@b&<a1&%ZyK>QnrZ{mg#7R3oT#`Q$F5p2>IhF
zO70@TcM6_QIYZC8xzVkoIg&QXo}bRgDokqb5D9~8VwGx-7c#u{g{QgZfqAKVR_&m1
zZk{x<^5#a7$vGf@l_vdLQ4DFW@fZmJ3mbJ*6eGACl)tBD+b@}mLgwZBc3j=cFOmia
zSM0gz!e+;B{ykP%OeDnu$qvGFad0haf~9yhjqQc|w1@`$a>wkrVaM#WP<Iyja(CfK
zP;gIeLd7t=2NX+DsMfD2b0uUo%dy&A^c`2PNWR47-K|$PZ{FdEV|mkOcjtVN2k-Bu
zwSVg@nLkY!&b6*G#^`}1WXM|S06;CSoR307tmff6eSH59)owks{P#?6*a!aOPbmwE
zn6Q37Gpm#hDMW_*Vay~eGz_JQ40sdg%dchBz<*qH1-$RNB%MzzrX@i98puI;KjwcX
zOF^%g`UGkRoaplysxT$Y9)}ZIsw<r{a=JOO<q{XPYBaSSOf}Cp!kh}7GDb(=KyPkm
zk>J@;VN3;Hj~JegxEbGo2fwILQ+3wd>vodJeQOxf^VlG+PQ@>6ed9C#8j|ySLnQT<
z%`9f{VZ_7HeCXk6WZ8a><F1q*-UFqh#lLkIO{;CMrb60|k5MxLpa3XAcb~reiCJ!n
z+TXz<lXWGWDSm=GgJKq}Gz*d3&)(vjlP{9+i8M|y0y_lya64P*c+US#SuNqCHs)m%
z!(Uu91)ydd+IhaF{y>e`e{5gB@5}TqklHG>_kaa1^!<Kr=W9464DjbgnsED>!Aiyo
z<9Cis_rN9a!GbDB(k|#$DXmVj&Y?4yW@p9o_y{!jSyc=H6@N-aTb2D|MEp<p7N9Eg
z*|JpoHr0kotx;5fla&jfwbE{2yJ4~{d8m2Yf&uh=j+H?+0Jl_(qenR-newrvcSXre
zyw!EQlYeyO&)K^Ie7{N}(yPmfA$OvGS{ob=@Ga|p;_pDUZlzp9-NfmEglykPK3)o8
zt6RwhyerT8^s1MOkLJza?UnNDg`q4DRF;6%Vz(YRR}v?6F{?P)B@6wls#l)f4{7_`
z1}O%}W6rf1Cc?e*&RB&$wAmsw)ZQJN1j*l=Z=-NKn52ToeZ<!@2Ds(1*PFU!E&h*w
z#U<@Vfw$hp$*ijtBSL>!o3jk$KGM%8&RqKw+KrqXUfQ1be0cA?edFQ*0qXOAt!#`>
zq0Zg3oXV`4dU?M;77maYZ~_cyy&KEv-g1D)be7At5L?yH5xx#r)@&$LCbnCP#4*tT
zT=wd<(I}z`n6kua&NWJ4t6uA*VDZ=tRV*+ZuRP0gxey0dcRUur<>AI@QaR{KXXp4F
zKglxYAG^#GEd+Gwq=Vl#1L?WZZ&LFOhl~;u_fxY8%DTE=j1y4f1Z$_0MZ@Fm9i7ns
zjq~{|3Z-95b}Jb~x9;hWY|fUCZ8oEZOBgfhIAp|Sy%;5DW^QT0NOapt-KZwj@#k4$
zU?AKL>GD)tFAFBJluIQ>_#D%|mI^Kw)@6=UH0wG#j&I{HLIjq?4NI0M*|_A>ylISY
z?$s8OC}kw4@5C9YJ4CiVJ;&g~FK|p-j@m0}7daI6>~g%WpW3IAjckbF&DTUJv<?h1
z`R}VlU=tgd>{v<&d@vI<24tbP)du$dN(Z92lScmik*)Rdqm=>#66_#YAJKq7AU`NK
zdWc@tM`ASA>dcJK0S2=$4Tcpnx+s4?=}t8EV*?{KuVBGFe{XCI+B+gnSKCbY54IDm
zS8!Nv7(mN<lGjQ!<+=pe@yczELF+x9m6p%CnE;C%8A9T)vj;A60FaKcJJTcB{h`Tw
z*uwrc2=>Q<2Mmy_l`Z#%2HZcbfh_7Txp~%YEyh&eTuFUB>w7F7(Ur&?*z4dU>*#Np
zBv_Hs$%m4*oIC&=`JLgwb0BuI?`PSmfCbxK3E!)WHN$`Z^0{En_MHaO=~!~R-+`2;
z6=~TnT!8YKM%Ui7<6pDNj7ygO%_D~kK<6eLNj|-kPx=K7=tApAf2x%)q*4>i%+53P
ziHwZVlZb8KA1<n|hXGWOqD63~pUDHh2;5@`n1uaB0)r9OrQ`J|WqC<^PBA$IN%i#l
z$IfhFB#P)))UZVhXzCN{A<J94y)O8bdY>Qa@@F7azsoZk!W|b}ZXZa}pT;VJ_Ib+-
z<~{SR-C8ekz71jvWx^;5)@CfE;*9c{o|k<<y?E?uZf%P23u<y?y&bpy#C74xdw3-1
z^<;})x4NLvp7qc|q1+5WcJAC)MdK9}=2+{Be)I5lfLHT)h&cRy*=PQ4usK-jhzY}4
zFbL!}+t=QmD7O3kZpUdEEe0c-6}rAb%E3_;6IXlbH_!zNjGp2NJ|-o7@^}BF!eVHV
zs}Y1RPw_mq62GWLoC+wG!BzjrTc{Llic5!~l4OV9oL-Tu@}D*U)EdB0UTDLbDmbA#
zM8Z?BT>c=k)fxU<&NqN1JLkU{92)U>8Xb0y{>EaZm7$5T>i4zaS6HYbI+hi8h@uB1
zTmW=3<4ndS?c&Pg#LwO9;uO`d!}6UyC}D`We`uCong84Q!>=Q+XF}k#q+G2gO8~CD
z9#vCstsK^_UFh(B9wR+z{H<*$;>!PPT~lDil_24!Cw?K-)LbjNo#Zr!)q}Etyl}Ge
zD_!eT1k*77GEX|^F+K6Cw$NN!8WBOX4@M-9XpU1ARz>1h@diz9Ci61Uy#W2MMyBh0
zQHSb;Fjn_21gB$u#M6d?WZf50_XAH#d-$-U>|t(J64hbC9F*MgyP7NFJ#-2^-kHn^
zwyZ}3zJP#~>Foqd$1U<mCnb}#EQgW170tSxiC>|E9H3HER;IOP)C;$5V=MIKu5srJ
z`GWX4VwKcgaYo4CO3U%ls&{&WL#b9nbIgW;Rb<a(fbVCJ`)%#y&+d%c08lug%e`Ss
zYOgvt>j7$>X}LYyme%Fz(lGy*tK~a9nASGv_7kCyY=fsTizVCzGZMU7&PIsSCqi?o
z*qz81vy=Lw_=d}?#FsbltY$=s+KPN|exxFlj@PheW>ds4ci8eK=ONqxFAT<^guInZ
zIE9xEUSfY47)!ceN@C(`$-4O~AUj{fCOxEYRUiT*lq1xi%vi~_FE}(mq*Rm9+Mg32
z*>FJ2K=3{Oo?6+`@0&cbJ@cOszI)5ce*RMX`~bj7b3fF`O`4@C<Tn2}dYOF`{?==m
zCYCy_x0Ew$mmKDJDyIVeEGNhF@#C@@xKXpAD&&E0Qo~qMS#2Te*5OPK@!PVPR$C?(
zQ$`M1F=J})Z20-I3trmYc~`B+^N^?DL*JF0qM=1}`9GG2PQ>>P%-P*D!NbFGJ`rI^
zUE|z9&4QMb*j>TDhx$B)HQr$veW8V4<ufJuH2as-A4BGFemYY7Zf7mAYi(Ejy0p~1
zHp|!w#*C<8<^2$x5%FT`FN|#R(nP}J!2(sK6`|en!wh(#q4G~>MO@6<Y|iE#F^P<)
zk4YFK5D^+_HNHe8Yu)TIT2r>nIXiw)0TuQ%$nWa2N6@sYQu6(%0iZ4Wz$%;=TNN`M
z585W)Q>IIfRbG}zdUuvVp&s>kdFt)%qbpn{L}HR~nX=o=dzd8_!;uB}NAjXh$WX$g
z)*C8#>)TIKi;}cnhLr<uk|^09>ND2o>=ZT+cQo%7<Ir(scZDCMC@?*KEBdK?vmdUC
zFtCK{nR)x8aOp+pOL#lQsWIbEG~H&zmY-9yvI>G%EyU^-17C^KrPPPHrj|1tgGOKZ
zR(haJEXICHYwaQ((}$7z<pEtBWv=LH7!epdE@?G%9I%HtuCF)C6|TY0#+k&#h$9n)
zDO!G;)`$v^yioVkBN=^c#y#XyF>E#nsoX%z((skurv+ITGt81^krDim3SrHHp$&@c
z+|J<(JZ|T<@@D~Z)v8_Z=#MN42C+Bei?VL_Jy=p-YmN;f_fl-~a@NwzydGOxDPQwa
zhNd5Y^Wm^nxrwy{UO+%3^LH+;cM?6v<U6iXAgjKg$O?ZQDzF>_|E`BPSqN_(SZ2t0
za+G@q#Z6ltdpzK_kP1f63sB}r?t`fOQfycXx@V+gYVkw%mC0!dV;F9F`GGW*<NPtj
z$S(x$*2_F%3ybRdEBq&Q;0FWL)3+l9?YX@~l4jrKCcL9hc&TScBepbCZH_=?zrXoe
z1e>NRm5u9D)jtqbDUm8{s%qb)Zz27M)n_~OYxD(Y#<piY(95%&;^3^E)?vwrE*H(@
z;(R_&GibYt!UxzLqfIt5byr&j1hA<j`b9L?==jjv@wZ1eAp{<XH&I4iDr|vFm0Zec
zb+H2&zcK>c)WCSE-@eH^fzR{b!b6w{3D3qS1?218k?P!&#SJVnGayR)Xsv-f<<E~F
zhR*gt#3dE8noxXPk5g^9rxTv<--JYr27sa{PEkQDtQ?-ndsMDdqU=z3s5l5nBD8AS
zsLN{8$!w$^qTEmI0wS;~610K-!{Sz#rb0KM`2a9S@d;w%XJSxNCN<!7S*y?V_nni>
ze41;`@Ns3^RPTdJ*S!z6rQW@SAiT(EjikselcG|z*7}!L*cr&`b4Y;UZ&&8KP{#^Z
zY>z+TDQC64DK&SNAu0^OatzQlWn4(S$eCSM>VDQO@9)fCgO1%?)Jd6UE|vd?y&HQe
zH=Jg&GDc|ga7{k-)=rb^l^Hy~EU{;nGyT~ZlVw^2S&#rW5YYJ&8hT-e&(D4_f(0wO
z&gi9^ysi)O>v|Iy_=JY>Q1qh%L@YtOhh*K6^~)Z=9TB9`*|wa}_;cp(tf<Fz*fXi+
z<O)XtS%{zm@)tS0`$YDmD$9wqAaD$2G9h(5A#E}tZ9bX_xW?d`Sl|}gW}nD1)_RfP
z^SkiiamJDiP&>VSYe>0-Da^2D&@y@pi0EJA*raAqgFgV3e+Fn4+8Gq83@q0CouSCJ
z8AN~6K-kmMCd9j6wOrK6cQa4*)~U58rfyut^L}ZA{`Hh+lpxB`4|JwKIlcP|nP|NE
zL0K5MkJKzFEz?3}55zCf{n%ILhoOx(SZAe6cYili)9s3I>pcD>3!F|{#}`7*#&2B;
z%V1UaHRS_5l_8Tu{LX23rZI3~^Zp|y9Y5Igxl{gp9RY?f`(x4K(1bNh(|(~PrXdc&
zjqE;q>{8tci3#^dn%r59ubSFA;BxkYmh!!~iVUa6$9>w^?RvV{73)@U#QcH)j4|wI
zAvGazj>Byl2vJ~}s(-`HCR$8GVni)XyH1tsip<c=u=TgP?c{fw;d*4#Q2o>3z+nJZ
z>=ldZGy^o-srmJQ9PWGIb=KG32LLoROZ~+J_glmomN~lNSTdPd6?Xa5QO(~t=n?qD
zsb!p8TIQ*i1v%rQs@34znv&VlvyL<YbD`K#mL&0z-!V*m?DBl{1bowX8`k`O0!rcs
zS%*&u>g3RC()7`z6C|MVqPq{Y^xHC}ON|{svsGbs#8R%>?1AGiXD2SCeH`fv^r8wY
zD6&=#s{Fl_PSl}MH|?d}D#JUCI_zza4nkmX3Xe5~W!U*O>+Si%&cF!cQ1YLCH%)nr
z;aGG)g+{B@8@~&dfc2%M%4M_&_a~-fp>9l-D-;DM1YmmBBwMbY3@=Fb@*X9XihYo3
z4zJPw&v&vLDVlNb$}@N6>!2Qm>-Gbj-19)1b7G3Ks@=xyuZo7HB)7r}oP(Lt`V6LX
zAuT39ap_Suw+$CUqHKmK_p?%fsErW_E=GOAZGUD)>u%fTkn`}`bnpcl6?7`dE5ga&
zvg(bBKX=#b0x`3Ywdr#NT3RR`^)zIkVJMZ4H6>Gocs$unU;%Mb<l0UAyKKGunWrWY
zWI}@9g)>bT`TY45%~sEwB^7n&?e?~b@Yy)d3KYY1u%n*5xXQ7l;R1K8z&`xHwfvm>
zm@{M~Bbc|#rybSp+E-hWLaCr(L}X#{k(2YQd8TPj<+!X^T*8jY2cYF-Qu>fcz5W_5
zgOoqstHrXiHWSiJmt3%<%$y?sbWYyb)ikL-Qc_-dR;@du!eeSr$FsO#;ITg0a<nY;
zJXK*7*Zq;g*6y$^!K8WUZjZv#V;^-vzCcpd#Ilgz1|g6?(F-Y?)niS3)8oLh`quML
za+3-pf*b-B{Foron$#-Amh0m%Q_hfo!)00Xt|v=*qlpDRl;Q5Tj_0boicmk$iiFl{
zAdYN?bd}(FfA%Oa|JQhjb8q1o2dE<w6My6!Bby(uu=zVaXVzhoMve+sp|O6l*f`%n
z^Bj;J9>V@8ICzX|KPthk-93%9oU?qVqD0S^(a1*=_HvL~GQOyRa~2j9ba$^9sIr8R
z#ZR18=5cPBP^MX;tGX_>O1M_nHgke$3qW@&AHrcYy2N?7OfX?a$MM~!kU7~)rgmt<
zZtFyidtOa!Flwe7f4hy>w*E`&K7rt&FHjZ+Eq095)$`syHJ5qs;3@`M^XY&8vb_AB
z=i7h4&I<s09h~Kr;O?4F=LnC}+DRt40AnmImH%sB#iR~NgaSU$aLCECXl7QW^35=H
zAt>t$fKX%Jg-NEF{lhEEw2Q?xtog2i{06XqvjdsFx71SX7NS`^tG$@s>SD&*Q>^4s
z6j7JMabB73^vQ8y#6e;^&8V04R~N7>tu-RIYhS_eE*?uGA6Sbrdj>d~idlIH!Z=$o
zgF3q5ai4*NK+*4&oAs!Kv-3q&ji-TlEA6f)KnB<RWS|r`zU^3)Kh<43%hv!UlSnNn
zst(7(vEc$Q-$prN0JUp4KRcymOfQVPs+C<UKGMzS(|t<9{uYM9WtK{_n277$ol4*k
zd0~%x9WhhJW3mGaK><CTz_dLmD)yr1nheN>{0>oB)ET}Q)+Fqa@b{HQ6^k(}HrnxM
zwD$9}@or1)>|8>P-LUHr@&2{40<TQAq|DI)HYjW!7MC%<0ToG$1CIuCu70kal0amx
z^5eTd?B_8pdNL}c_LtS&qV$aE%2&Ohk->3UQXK?(Drday-`hU9ruRV)HqYDc_f7^q
zckk5xXwi+fP)3!m9Be5hZ7Dh%+OW6MXso&@HonU5eLGwog?V+k?1Gu!HMCyXM+*p_
zNP-J@prw$ifB%e#l;=|fRH`Qb85KY*Opf+UI~~U0?>bH0osj?0%JdrlE}B~qX>AY>
znpY6U?&;FIV(hBK_;yuQ(XujNdRmb@_*2Wz4k-Y>&XZRtL<gC%nl*c(mC!u4cDaZ~
zzemi}R%#F@ivehg6n;6y({XQ6-AyTo!umzFNF#Wo0eZQu$?^f+ayQiIRm+xvc%pc8
zwfZHJw&HZ7-B(SKGm{`<8u_^o4!wMUgri;0<K3+ot6cD9wcW|_VyDL;$+MQK`k#4P
zVv^P30h>(Ag4PaE!?=iMLBn${>^=YlF05S^P(B;#bKtF2jdmDk_<={QI4b>v*Fv1x
zNi7+2_YBjGE2Woi_wB8lOQe%7iHw5uM79knP7KBl_Y*|7Q@%}YX9SFJx;^YpB7+%$
z=GF-cD<V58Ilo_`DM78;BY_SVj+q%=v>U%N7Q22d5gKfUeUAKV(xoX6vN&W;clk_C
zpp!h-i0&psR$G)TR25$z4^g}|wa0laxhKOEJmz4^#=7!q?`nYW9(6sR_L}^zZi@)|
zlaiv6jkq|&r7gI*A{bB9z-ciKHk$?uSYgOsSI?ilke+|^!NA}a$%ubeyDZhuIMk*i
zEu=>InDFi^(*Q>jFs*}0xhD!Vu1LAlo3$sUh<@D2hu?Z5f;Z&!Lx-!M+^em#Pk3si
zRcIgK4Z8{CB2mS{lA54(vEdi%NiW%gn7o1_8>(bg-Rese@eXVM60;>c(9rP5+%WoE
z6ZO#wUZx5il~&+R1GoC`%IcpH8DPtc;*yMq@3av=l42_IA6BNyn)}*cp^@HT%~zC*
zrNOt%dOlF}*XqkmS1Bvvd=rCxpzys}Tv@N=2Za$DoU{mqnRI!@QQE&YsF$Z%#|70i
z0<6q&Mmg;&UouPJgBsw2O3ZNL{o&c@#5Kw2u}-@vPRCN$m!@a&FZRd4gsYS0l8m%>
z-naGhcPbBI;GmM=gXZn6v>~VT`74^-2fH9=+~8Yd$4o9uGLK7v>G*{0@2Bz*G|cy;
zOB4m$w(&DFgug#3^9$g(wmdW}rVT4;nHLt0imJvX1cd!y)-*F*fqfpKV}L_G_cw9?
zM$;cR<{Q7}StyY$ZvEQCHxdULzf-g9?Gp{W?KXf763eZ!w^yh_`$9*IC-_7m_Vkd{
z)on2EWg<JL5HP3krOY1MPoYYV-vCqkL+UXSLdjx4JB5VIC9i{ytL)*A$Ew^DMqRa7
zrlD=RuA236_lalQxgoCOjuH88A?fk%l4gIpBrCuFt5|}e)@V}ezJd<=IEiq-?GbN^
z$rN;3h~=cA0?omiE9c+~Bdx7VpPftJxf`A!IbMYZ)jKuhps^>kV`rjLyo(Ft&@hGg
z_+&;VZe?ZtLdc+?gD`7{n7zVg(VFBkHSK@e5XrH+#A4B9IQh1ZaB$!FX7D$CD{iaJ
z4V|5bYAFpR6Ni(HhWb}yiMIU>i?LwAv{=Qo;%Z5S%W6O#X5|rTAna&4P;>t4Q*v_F
zOCJ{KzC%g!K$D$b_SoTl^++1qpeCS86a$iggrQ_ZcjPsTbiyw^DCLdxE~%dA^uUOg
z`e`+%)ru?O%2)beCQ?uF6y{T>a4m>t@AolH^z|5{Wx1AF{u<4SK)Rm|C$Aui+|r|}
zig))DyY9#V?AjdCvEf51QYnUSoEwyi=C|Ks_Y8?_A$6Tc){uBeRRbtrA*3b~X9pTl
z@z+jt6G+HfN{^_1#ZO=SpRG=bOj92T$*kToV2QqV{Xs8_x=4iuo8WvCJ{)`O&EVuM
znFdY*W_j7qkEDBpkjTVzgxb%c*cy`Xy;!t|!iD3VfFxzP;$<_f%+ukc&XSi#300DS
zTugLkEc4E-s<Xy}`r$zNe?)Hqh)5oY`AvmC$=@~vVEu|<4ZQ0a3!JO{aI0ffJ+N@?
z=CL({Gm~|kd{6?k$&DAUk?8L4vU(4evFdR;$Hh@wlCfAWbME6}`QwPW8hmp#AY&8-
zg$x}Kqw3zNAed&QHQ{8v)uMy<kSuRKecXHB!~OQZ(oX^n=ugT0_(w|hFV|{l_Hmx>
zd4d=2n2N$DAh7}SLdrDS(KgDcTkra0aA`!q%a3g!1l{jwJf1&Zt6IIWO_sCOvV31P
zqaR~0#jTE%5Y6t-y5h$=BO|Y{%xpz%M6`0x%3|HtG<;^Bl7WN_Wt16YD0!Hw9H`HJ
zUDbTiQ?Vg6@DKW-s_eIuBw32v6jAqX7pKC`r;#R8f+-(3d9)jLellq2YD>GhS(};2
zoe|)L(z#BmjTv*Z|I1oC1gy|t3aiE2<gdU&xvC@CS`ZH_M`U8o4)^7=_&K&b8kRH~
zPVjB6i433RiU&#7vjIY>`u3N0!%uEV`4RLojX@Cix-UCU|Ltmt_>-U&dYO$eLWsy)
z;yqsS-4ft|M`u5Lo*xY+nFww1(&~>wVappv2SS%P&L4j3kToKRIPH4E)g$Ifnaa9C
z=P7kxRCE_i0>4(Kp!9Pj=yBi~B%uCDy#U@u56BaMs0_LjD6xBZE~Kt;WYJ8mI=o|Z
zsd4L8z7Iy6GIz$4u+?@LQOiidZ*UYs9--2SL!Q0OPmVu{hzPe(EXLq&sq=$gT?EFJ
zF5eXFiZk^Yd4E@AKuytt`QZ__`N|_&gFA4p;iG>a$31%nu0DI$U;@S{A1KOUbj0vn
z#l5^y2E?opB#d(VatSA2-*#_8bg!Rnjk3#SiF^n4x@vg?y$g;K_pqPE!=LvBk9N^&
z#e8~JrPk>6XO4hJgvA3hBE?WrZP1Fx`x8?Y23EEH1ChlMtw1BGf#D!TEVJ<|diw3f
zn`s^k{#d%))BZ0cCs|9ZtBkLaoKivU77hfr-=!)PrPZ75<A*~EV;&X$z%;%7tw>P3
zi9)k@@WK#@%?4#R<sB8g)Ypw4tHcJUnMjB?5`50gkr4S6j(PA8gLP_>u%tQ7%85}e
zk_$%0;SszSP|TgLj?-#Jc&(u`FfL#^@lH56jltXCElgij-~IUQTeqEo_L@Owg|}5`
zz##Okyt)J>-PgezM=`h?vONZ0LzLQRI~q$e|1oEOqx76sJAT6RpcR<8c(3<*3^Tvv
z2-~}XYDqUcK}^}Zlza_wHljrqSfepgqA}h)mbAKvOcFJ=euwlIg5;zLOq>e&aZ!*X
zYsB}Df+wf3i>f)kxR|DoM#6h~+D&ody!}!nFHsN>DvN8pZE~=qsafAY_)CHt0x9&s
zjzxjZ9~+v^y0fVA4Sn=Iq|MKQ0mpq}^<$fBW9__c6Y5V?P&G|W`q0m=^HbtY-HN*G
z<x<J)6@fH~g7PI7=gKzUxnk^w*P0d1M3T?8DqkJZpcgRq3O&ecB=+$-E_@K{72NM$
zj+fnSb++C5&QC8hr+Z?J=Px9_4(Q?9$_o11BUAOFankx^pdv@=tH>^Wl2<iBiST1h
zmdBB5iC(Cpjx!RqOU=*FL2`oa7E>`Z&nfVEZ%+AEZec^SipJ7-9w*ZJZ@$p!BxtM9
zy0_NYQe*e%;Qs0T{?Yw$c)rk>`^u#t?)W&Tg5NMM3XeD$9VWVOA(jf|$IzO$`pE`Y
znxO$C3@eJ&4XtxyOsj7ng0%XHQQ@95eLJFaJ{#M%b8v3$pI)jB6KdD8ve?CwQdIG`
zP-i#tD>F{I2E9{97;pj+-(t7uW~@h{dt;0%!j0=XDU@^jA2Z&<#+<OcjAfB+yL;c_
zzdRhRY2p33FUuFN-`^oxf(~feX`UmB_>;xTc%<KF@yU?n{UmTsTxH75>Ot{E#&zut
zd$d=o-g!?wx9QEV4nxSHJaXORr9RK&16Gy_DX|VP@qH&<%J4%bxUhKsPn67E(cYxC
zx*rrzDfZAIC4JBK3_JGF%S&C#g(v+~tcAn~kIj>t*3$o5vBz=?*PRu<4Jn@&!xm!q
znv3@fRGIvK6x&%4dWfuu8`)%Jh0Rlu-Z7~CAqC7;i5Ook*R~%kbxJ(edO6(jaTWoR
zrM@ku*%ijYhV%eO&{*-w`?$QgD?Jnsrq?J$k;eliAKUTglooaLn+0(*WizlM6H-lz
ze%8hkx{U-`q+^#cxhMSAv9c7~W>KeHM{)U9`gI1bSLMya#GibR05J_l<~-Z4_fVW|
zJBA0wfoss?v5m<D`Vgt0q&)e}(JAKqxhuuXnGvXIl`$Q8K|-Rlb~d4U!!SX|4Xm|9
zo_QN=ZOe5?GJ4m45_sv^FVs%f9$v=q0Sl!9=_%sFgj8~ME9gLQQy;;HZ9aa*v3!GE
z?apjU**;&FitZmu4P!p6-N!48qmap!-Z*|W&~nhW?&s^s;=JU^3(7Pd`!iI&{aC=K
zKH?gcI}JXH*Xyj4ZS`Hk=C!jTn5$o{rr((sH`v_nV+=Z4-3t{xz$>LZ25%;vkZzY`
zVVrIDJ<QFLpL$a;Y{IT@gvm8{%{wM~|DiT1eQq1Ch+O=2;H3Cv4~$_`j>J)B%jBJH
zOD6y4)<T~b=ILL+#qauxo2+oa&RZgdmY41sjfH}l#DXXb^wMFF*22*i9DgXm)bG<^
z{yFi040K={i*+9v^pi3;{)|zih0H>S@-ypNTH~v#_(ikOzz{4Z_>dzOU+U03Z18GQ
zI~nz728UU)tsiwG5$J4B$hOw%ekKDavr*@rmtsdAb^tk##Fm^PJ)eS@AU5wp?8{pV
z!|CLP@~k)A_^n0<6x1p_X-X>|N=Isi*M%{l&e3w!4-4lmFjrC-%U>?$!WjNikMaP{
z9LKTf_i5QHs67jJb-L#}p31M94Nutswd@)t0S6n>h4^iGDb<X(>*^93l4Lzktk}-M
zjRJkk#{=mpUD|P8j#n~kRmFMfgKIv!2`_{OyJ1rE*9*!w&3v7Ev}5>p6b?J|^;=ac
zEDbgBa;#as0jI&oKf+(cqKgn3gm%5<_IpuV?l4148&EV<T``y31F}#bYE+-!*Y-K@
zTuQuzl)-$WpT(F~yiK`K^j$%nl8C1ClWuag0-J%U@I+7sYE&Fva*!^%CFiEk-YB=e
zO($?ld|xh?F#Y+sQ7R8Z<qWuXR({?EPZ-B3{(LZ;$^8Z`&VneX_MXsvg*2zyA^zm#
zlciW66BDe(Ar3QdMe=IHAAeMQJiCru6^p|QYjGPSk8!#n^5iSj>8`X7oyxaf9ju5A
zG07`d#6jHA-WpGnzWy(o#aVH$$e?xOQA^8A(yDdFLsJ!g1X6M``r+ML^Gh+}cntIF
zrGd9s{KU0!X4M#+rH|{?K^p(Nxt+i;?(~0gOIw+Dj$O~~SuuU?4J|>LnP?dqM2(X~
z4-cYmAB0kD%M?z|{;&%QI!CDLFvlmNgi!164EqcY`V6K-@;Sg+9EPT_(O@QCE6PoN
zU$P2GtsRrdfcF_?&BDd`PS=SOKnI(I)g%DVo}F6}b|8ns3NO*a%4X`sf1noEfdaJq
z{nODMF01+=^s}~Dr=ar`b~k*pA8U?>n>GwTI-cOZ!k@%kf5jAYhu2B}&_bu|fI_Jr
znK5|hp6xbO^`y{w8C4lE1;V}`NJ8pCkxb@<&%p+(DD&xIz||XLieWDmdh_qmCDgXE
z-5}u77h$WlOR26?SlLQ!%SmDt3DzycP0T8ws$f@M>y4hgPK`~5%z!k`v=-5?s#T9~
zE%Z9J{_Pa{-?yQ^R?;XC5$kkHzQ2gBKPyYUS2_;$5SGU9@`iYw^~yHdeGY!fY@YxC
zqM8b>{cDm=Qv@MK8gX4@A=9tnP9-PdPul6jZ+BoF#7lUgstHdw^03>4oyvIV=M!*O
zlvhj>d3)>r_0L8+ivx&R3Rb|98V(OQax<e#P+)DP7U#VSCRZa_>K{j}X5XJTQf|52
zuX6Vp>9!6FyniXK;y5cafHv~vjT&4;0l+}$fTFLlX<y`3+j%`Vlg+{4xZ(CMArZ<2
zzP*wl>q{4%-EnbGIE4+%jWqZo@zy7TrD5%JJzY3|#DL;|cXoB;WWMlSLAPfJ;E>>U
z5x>cP;NlUy`t$p4Hzu;sd?jKfsQ-Cx*=G)WTL#;OXMpQ57r1rWf48RRPlYs-JkyAu
zz~W1iF_?&c&bl}t$FM;3HgJEsobwHo6Yb-HU%_*F2Pcxo4|VLs^^D*f1w0{~PeAnN
zq)Jp1dVNC4l8o_>+LuL^JntdCLxH?V!zyF<waG^)yd#Ygo>S_32<F^Yr+A!DzeUx+
z>$NF=tR(bJSJ~~L+-laagJ0aGp@$+{$VF8dTdBJPyBM@PQ^4=?puUudZ~CJ}6i4Sb
z$W5T6c)f5^+?CvE2!w%NBUN`#^TPZiV#FaI65k$WslnWL)QY@MhErwU2u*ugUne36
zAa@E74?=fJVU1?WsE~&-<tAY~CqmVF04;ixb!2V$d1&j$b7ns@2c4sPgoSa7XR2N`
zv?GqGxSv+!Vi*}vw%mUUo%-NGdBBK33lCihd6Ba?StJ9#;_kn%7;tp8WG5wR5EU=S
za;@vcYcDG{e6#$k8M0T(bYYQwQRPI;R>aB8d5VfMR4D*!Y6-uET?Cc;yJ15g_iBCI
z+Q`C2d1@WnL2B$4k$4G|U0-#-VFVm4epS{z;m<da!SCIt*Jj$(%wB!~<A^SBNG>TX
zwX2-9<?3hfnJC`e3h`saY@#MNIB5jJd2&hLt8qh`{Iqv+)|b%O6{F2X_?YN^CHj)K
ztxXuhppdW678}9lBd&k4t`Bm{6Z*r3yWaFE;AAb)?fbo<+9^D~I2l8v+I+}nj$Zba
zGE2QF?}4DnK^1H}p<y_imf9(M#`Y|qKHi?J-q)!RYC6Z<2eI92?WyJ4u;NWZxL0os
zXQS7^@G$@D5)y^HlzaA_GMImYmJj}EuIonJejU{HQGd!eoG<3}?;C~>v^Z{(M(I-R
zN#QjlcBUnbV>EV!xeF>+uemkt@z|NXE;OMby~gWO*FRYVtpsnrjSqt%a4O@tN~9cv
z>~XN*LUAv7jzajO**1;;@8h}CtxhJI#4On8Nx_3Ecr1uad67=Am^GBmWrK3Qm#nJK
ze@(QvdF}^ajm6g6tq8yY<4<579&WvKKwZdzXtWW=7(aYXSd|9ZNGLbrpmn-s&d*~#
zj4{jM{Qoz_eI5{#H_TDleM{q_-8LM#rSTxuM2Ea;RM9ZVBBn4j?UX)Den?WE-8-%!
sW~|@c;bJgsA7#q<NVl~)OsbxEOlSO|Jj%IVFu+Sj;){5>sNS#t0RjGJj{pDw

literal 0
HcmV?d00001


From 17aebc2c739ea728c98ba9ea67396cb0101bcf04 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 13:43:13 -0400
Subject: [PATCH 081/458] README: Use HTML and SVG to size the logo properly

---
 README.md               |   2 +-
 art/OpenEUICCBG_768.png | Bin 111798 -> 0 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 art/OpenEUICCBG_768.png

diff --git a/README.md b/README.md
index fff71b7d3..16d2592ae 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-![](art/OpenEUICCBG_768.png)
+<img src="https://gitea.angry.im/PeterCxy/OpenEUICC/media/branch/master/art/OpenEUICCBG.svg" width="384" height="655">
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 
diff --git a/art/OpenEUICCBG_768.png b/art/OpenEUICCBG_768.png
deleted file mode 100644
index 0137b489075b39d9a56f4ce4c40c0908f623516a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 111798
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


From 2bd5f007d910638992cc42d527dee9ffcdcbb64e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 13:44:15 -0400
Subject: [PATCH 082/458] README: Fix logo sizing

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 16d2592ae..17d2cfc31 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-<img src="https://gitea.angry.im/PeterCxy/OpenEUICC/media/branch/master/art/OpenEUICCBG.svg" width="384" height="655">
+<img src="https://gitea.angry.im/PeterCxy/OpenEUICC/media/branch/master/art/OpenEUICCBG.svg" width="512" height="300">
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 

From ec5e5d04167f1a192bc53298e768af7147f88848 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 14:16:03 -0400
Subject: [PATCH 083/458] usb: Cleanup

---
 .../openeuicc/core/usb/UsbApduInterface.kt    |  6 ++---
 .../openeuicc/core/usb/UsbCcidDescription.kt  |  1 +
 .../openeuicc/core/usb/UsbCcidTransceiver.kt  | 26 +++++++------------
 3 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index d181e539d..bc6081755 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -129,7 +129,7 @@ class UsbApduInterface(
         // OR the channel mask into the CLA byte
         realTx[0] = ((realTx[0].toInt() and 0xFC) or channel.toInt()).toByte()
 
-        var resp = transceiver.sendXfrBlock(realTx)!!.data!!
+        var resp = transceiver.sendXfrBlock(realTx).data!!
 
         if (resp.size >= 2) {
             var sw1 = resp[resp.size - 2].toInt() and 0xFF
@@ -137,14 +137,14 @@ class UsbApduInterface(
 
             if (sw1 == 0x6C) {
                 realTx[realTx.size - 1] = resp[resp.size - 1]
-                resp = transceiver.sendXfrBlock(realTx)!!.data!!
+                resp = transceiver.sendXfrBlock(realTx).data!!
             } else if (sw1 == 0x61) {
                 do {
                     val getResponseCmd = byteArrayOf(
                         realTx[0], 0xC0.toByte(), 0x00, 0x00, sw2.toByte()
                     )
 
-                    val tmp = transceiver.sendXfrBlock(getResponseCmd)!!.data!!
+                    val tmp = transceiver.sendXfrBlock(getResponseCmd).data!!
 
                     resp = resp.sliceArray(0 until (resp.size - 2)) + tmp
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
index 8a2ed39a4..5123d530a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.core.usb
 import java.nio.ByteBuffer
 import java.nio.ByteOrder
 
+@Suppress("unused")
 data class UsbCcidDescription(
     private val bMaxSlotIndex: Byte,
     private val bVoltageSupport: Byte,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
index ac2e1dc75..09d324b07 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -13,6 +13,7 @@ import java.nio.ByteOrder
  * Provides raw, APDU-agnostic transmission to the CCID reader
  * Adapted from <https://github.com/open-keychain/open-keychain/blob/master/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/usb/CcidTransceiver.java>
  */
+@Suppress("unused")
 class UsbCcidTransceiver(
     private val usbConnection: UsbDeviceConnection,
     private val usbBulkIn: UsbEndpoint,
@@ -152,7 +153,7 @@ class UsbCcidTransceiver(
         }
     }
 
-    private fun receiveDataBlock(expectedSequenceNumber: Byte): CcidDataBlock? {
+    private fun receiveDataBlock(expectedSequenceNumber: Byte): CcidDataBlock {
         var response: CcidDataBlock?
         do {
             response = receiveDataBlockImmediate(expectedSequenceNumber)
@@ -163,7 +164,7 @@ class UsbCcidTransceiver(
         return response
     }
 
-    private fun receiveDataBlockImmediate(expectedSequenceNumber: Byte): CcidDataBlock? {
+    private fun receiveDataBlockImmediate(expectedSequenceNumber: Byte): CcidDataBlock {
         /*
          * Some USB CCID devices (notably NitroKey 3) may time-out and need a subsequent poke to
          * carry on communications.  No particular reason why the number 3 was chosen.  If we get a
@@ -235,21 +236,11 @@ class UsbCcidTransceiver(
         } while (ignoredBytes > 0)
     }
 
-    /**
-     * Transmits XfrBlock
-     * 6.1.4 PC_to_RDR_XfrBlock
-     *
-     * @param payload payload to transmit
-     */
-    fun sendXfrBlock(payload: ByteArray): CcidDataBlock? {
-        return sendXfrBlock(payload, LEVEL_PARAM_START_SINGLE_CMD_APDU)
-    }
-
     /**
      * Receives a continued XfrBlock. Should be called when a multiblock response is indicated
      * 6.1.4 PC_to_RDR_XfrBlock
      */
-    fun receiveContinuedResponse(): CcidDataBlock? {
+    fun receiveContinuedResponse(): CcidDataBlock {
         return sendXfrBlock(ByteArray(0), LEVEL_PARAM_CONTINUE_RESPONSE)
     }
 
@@ -260,7 +251,10 @@ class UsbCcidTransceiver(
      * @param payload payload to transmit
      * @param levelParam Level parameter
      */
-    private fun sendXfrBlock(payload: ByteArray, levelParam: Short): CcidDataBlock? {
+    fun sendXfrBlock(
+        payload: ByteArray,
+        levelParam: Short = LEVEL_PARAM_START_SINGLE_CMD_APDU
+    ): CcidDataBlock {
         val startTime = SystemClock.elapsedRealtime()
         val l = payload.size
         val sequenceNumber: Byte = currentSequenceNumber++
@@ -279,7 +273,7 @@ class UsbCcidTransceiver(
         val data: ByteArray = headerData + payload
         var sentBytes = 0
         while (sentBytes < data.size) {
-            val bytesToSend = Math.min(usbBulkOut.maxPacketSize, data.size - sentBytes)
+            val bytesToSend = usbBulkOut.maxPacketSize.coerceAtMost(data.size - sentBytes)
             sendRaw(data, sentBytes, bytesToSend)
             sentBytes += bytesToSend
         }
@@ -320,7 +314,7 @@ class UsbCcidTransceiver(
         return response
     }
 
-    private fun iccPowerOnVoltage(voltage: Byte): CcidDataBlock? {
+    private fun iccPowerOnVoltage(voltage: Byte): CcidDataBlock {
         val sequenceNumber = currentSequenceNumber++
         val iccPowerCommand = byteArrayOf(
             MESSAGE_TYPE_PC_TO_RDR_ICC_POWER_ON.toByte(),

From 41f16e03cf51bd0c04e934438ca809cf0d8535fa Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 14:38:25 -0400
Subject: [PATCH 084/458] lpac-jni: Test using euiccInfo2 instead of profiles
 to check validity

---
 .../net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index b5e4b5c60..e56ed9ebb 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -32,10 +32,10 @@ class LocalProfileAssistantImpl(
 
     override val valid: Boolean
         get() = !finalized && apduInterface.valid && try {
-            // If we can read both eID and profiles properly, we are likely looking at
+            // If we can read both eID and euiccInfo2 properly, we are likely looking at
             // a valid LocalProfileAssistant
             eID
-            profiles
+            euiccInfo2
             true
         } catch (e: Exception) {
             false

From fc9f96206154465a2810e37674b21708228c8539 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 14:59:56 -0400
Subject: [PATCH 085/458] UsbApduInterface: cleanup

---
 .../openeuicc/core/usb/UsbApduInterface.kt    | 88 ++++++++++---------
 1 file changed, 47 insertions(+), 41 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index bc6081755..98e738d0c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -46,7 +46,6 @@ class UsbApduInterface(
 
         // OPEN LOGICAL CHANNEL
         val req = manageChannelCmd(true, 0)
-        Log.d(TAG, "OPEN LOGICAL CHANNEL: ${req.encodeHex()}")
 
         val resp = try {
             transmitApduByChannel(req, 0)
@@ -54,24 +53,25 @@ class UsbApduInterface(
             e.printStackTrace()
             return -1
         }
-        Log.d(TAG, "OPEN LOGICAL CHANNEL response: ${resp.encodeHex()}")
 
-        return if (resp.size >= 2 && resp.sliceArray((resp.size - 2) until resp.size).contentEquals(
-                byteArrayOf(0x90.toByte(), 0x00)
-            )
-        ) {
-            channelId = resp[0].toInt()
-            Log.d(TAG, "channelId = $channelId")
-
-            // Then, select AID
-            val selectAid = selectByDfCmd(aid, channelId.toByte())
-            Log.d(TAG, "Select DF command: ${selectAid.encodeHex()}")
-            val selectAidResp = transmitApduByChannel(selectAid, channelId.toByte())
-            Log.d(TAG, "Select DF resp: ${selectAidResp.encodeHex()}")
-            channelId
-        } else {
-            -1
+        if (!isSuccessResponse(resp)) {
+            Log.d(TAG, "OPEN LOGICAL CHANNEL failed: ${resp.encodeHex()}")
+            return -1
         }
+
+        channelId = resp[0].toInt()
+        Log.d(TAG, "channelId = $channelId")
+
+        // Then, select AID
+        val selectAid = selectByDfCmd(aid, channelId.toByte())
+        val selectAidResp = transmitApduByChannel(selectAid, channelId.toByte())
+
+        if (!isSuccessResponse(selectAidResp)) {
+            Log.d(TAG, "Select DF failed : ${selectAidResp.encodeHex()}")
+            return -1
+        }
+
+        return channelId
     }
 
     override fun logicalChannelClose(handle: Int) {
@@ -80,25 +80,26 @@ class UsbApduInterface(
 
         // CLOSE LOGICAL CHANNEL
         val req = manageChannelCmd(false, channelId.toByte())
-        Log.d(TAG, "CLOSE LOGICAL CHANNEL: ${req.encodeHex()}")
-
         val resp = transmitApduByChannel(req, channelId.toByte())
-        Log.d(TAG, "CLOSE LOGICAL CHANNEL response: ${resp.encodeHex()}")
+
+        if (!isSuccessResponse(resp)) {
+            Log.d(TAG, "CLOSE LOGICAL CHANNEL failed: ${resp.encodeHex()}")
+        }
 
         channelId = -1
     }
 
     override fun transmit(tx: ByteArray): ByteArray {
         check(channelId != -1) { "Logical channel is not opened" }
-        Log.d(TAG, "USB APDU command: ${tx.encodeHex()}")
-        val resp = transmitApduByChannel(tx, channelId.toByte())
-        Log.d(TAG, "USB APDU response: ${resp.encodeHex()}")
-        return resp
+        return transmitApduByChannel(tx, channelId.toByte())
     }
 
     override val valid: Boolean
         get() = true
 
+    private fun isSuccessResponse(resp: ByteArray): Boolean =
+        resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
+
     private fun buildCmd(cla: Byte, ins: Byte, p1: Byte, p2: Byte, data: ByteArray?, le: Byte?) =
         byteArrayOf(cla, ins, p1, p2).let {
             if (data != null) {
@@ -131,27 +132,32 @@ class UsbApduInterface(
 
         var resp = transceiver.sendXfrBlock(realTx).data!!
 
-        if (resp.size >= 2) {
-            var sw1 = resp[resp.size - 2].toInt() and 0xFF
-            var sw2 = resp[resp.size - 1].toInt() and 0xFF
+        if (resp.size < 2) throw RuntimeException("APDU response smaller than 2 (sw1 + sw2)!")
 
-            if (sw1 == 0x6C) {
-                realTx[realTx.size - 1] = resp[resp.size - 1]
-                resp = transceiver.sendXfrBlock(realTx).data!!
-            } else if (sw1 == 0x61) {
-                do {
-                    val getResponseCmd = byteArrayOf(
-                        realTx[0], 0xC0.toByte(), 0x00, 0x00, sw2.toByte()
-                    )
+        var sw1 = resp[resp.size - 2].toInt() and 0xFF
+        var sw2 = resp[resp.size - 1].toInt() and 0xFF
 
-                    val tmp = transceiver.sendXfrBlock(getResponseCmd).data!!
+        if (sw1 == 0x6C) {
+            // 0x6C = wrong le
+            // so we fix the le field here
+            realTx[realTx.size - 1] = resp[resp.size - 1]
+            resp = transceiver.sendXfrBlock(realTx).data!!
+        } else if (sw1 == 0x61) {
+            // 0x61 = X bytes available
+            // continue reading by GET RESPONSE
+            do {
+                // GET RESPONSE
+                val getResponseCmd = byteArrayOf(
+                    realTx[0], 0xC0.toByte(), 0x00, 0x00, sw2.toByte()
+                )
 
-                    resp = resp.sliceArray(0 until (resp.size - 2)) + tmp
+                val tmp = transceiver.sendXfrBlock(getResponseCmd).data!!
 
-                    sw1 = resp[resp.size - 2].toInt() and 0xFF
-                    sw2 = resp[resp.size - 1].toInt() and 0xFF
-                } while (sw1 == 0x61)
-            }
+                resp = resp.sliceArray(0 until (resp.size - 2)) + tmp
+
+                sw1 = resp[resp.size - 2].toInt() and 0xFF
+                sw2 = resp[resp.size - 1].toInt() and 0xFF
+            } while (sw1 == 0x61)
         }
 
         return resp

From 576ede455d70bdfed0997ca655a1703178c7902c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 15:04:32 -0400
Subject: [PATCH 086/458] UsbCcidReaderFragment: Fix unregistering receivers

---
 .../im/angry/openeuicc/ui/UsbCcidReaderFragment.kt   | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
index 4660d97d2..35251476d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -116,12 +116,20 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
 
     override fun onDetach() {
         super.onDetach()
-        requireContext().unregisterReceiver(usbPermissionReceiver)
+        try {
+            requireContext().unregisterReceiver(usbPermissionReceiver)
+        } catch (_: Exception) {
+
+        }
     }
 
     override fun onDestroy() {
         super.onDestroy()
-        requireContext().unregisterReceiver(usbPermissionReceiver)
+        try {
+            requireContext().unregisterReceiver(usbPermissionReceiver)
+        } catch (_: Exception) {
+
+        }
     }
 
     private suspend fun tryLoadUsbChannel() {

From 102902386c086babc8de76efbe4f9c011aa65e4f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 15:25:10 -0400
Subject: [PATCH 087/458] lpac-jni: euiccInfo2 needs to be bang'd

---
 .../net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index e56ed9ebb..79a35ec15 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -35,7 +35,7 @@ class LocalProfileAssistantImpl(
             // If we can read both eID and euiccInfo2 properly, we are likely looking at
             // a valid LocalProfileAssistant
             eID
-            euiccInfo2
+            euiccInfo2!!
             true
         } catch (e: Exception) {
             false

From 8210f06098ae8a4f2276a3e31c6109d2a16e5bd5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 15:53:26 -0400
Subject: [PATCH 088/458] ui: Add option to reload all slots

---
 .../im/angry/openeuicc/ui/MainActivity.kt     | 21 +++++++++++++++++++
 .../src/main/res/menu/activity_main.xml       |  5 +++++
 app-common/src/main/res/values/strings.xml    |  1 +
 3 files changed, 27 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index f8a191586..105bad6ca 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -13,6 +13,7 @@ import android.widget.ArrayAdapter
 import android.widget.ProgressBar
 import android.widget.Spinner
 import androidx.fragment.app.Fragment
+import androidx.fragment.app.commit
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
@@ -98,6 +99,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 startActivity(Intent(this, SettingsActivity::class.java));
                 true
             }
+            R.id.reload -> {
+                refresh()
+                true
+            }
             else -> super.onOptionsItemSelected(item)
         }
 
@@ -154,4 +159,20 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
     }
+
+    private fun refresh() {
+        lifecycleScope.launch {
+            loading = true
+
+            supportFragmentManager.commit {
+                fragments.firstOrNull()?.let {
+                    remove(it)
+                }
+            }
+            fragments.clear()
+            spinnerAdapter.clear()
+
+            init()
+        }
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/activity_main.xml b/app-common/src/main/res/menu/activity_main.xml
index e658c4310..509ad7902 100644
--- a/app-common/src/main/res/menu/activity_main.xml
+++ b/app-common/src/main/res/menu/activity_main.xml
@@ -7,6 +7,11 @@
         app:actionViewClass="android.widget.Spinner"
         app:showAsAction="always" />
 
+    <item
+        android:id="@+id/reload"
+        android:title="@string/reload"
+        app:showAsAction="never" />
+
     <item
         android:id="@+id/settings"
         android:title="@string/pref_settings"
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 3e66d381b..bf6606a6f 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -3,6 +3,7 @@
     <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device.</string>
     <string name="unknown">Unknown</string>
     <string name="help">Help</string>
+    <string name="reload">Reload Slots</string>
 
     <string name="channel_name_format">Logical Slot %d</string>
 

From 1a1364f7882e7e5988757be8c28e342f2df13dce Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 16:12:02 -0400
Subject: [PATCH 089/458] MainActivity: Reload when USB devices are attached /
 detached

---
 .../im/angry/openeuicc/ui/MainActivity.kt     | 28 +++++++++++++++++--
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 105bad6ca..161392c6b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -1,7 +1,11 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
+import android.content.BroadcastReceiver
+import android.content.Context
 import android.content.Intent
+import android.content.IntentFilter
+import android.hardware.usb.UsbManager
 import android.os.Bundle
 import android.telephony.TelephonyManager
 import android.util.Log
@@ -13,7 +17,7 @@ import android.widget.ArrayAdapter
 import android.widget.ProgressBar
 import android.widget.Spinner
 import androidx.fragment.app.Fragment
-import androidx.fragment.app.commit
+import androidx.fragment.app.commitNow
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
@@ -45,6 +49,14 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     protected lateinit var tm: TelephonyManager
 
+    private val usbReceiver = object : BroadcastReceiver() {
+        override fun onReceive(context: Context?, intent: Intent?) {
+            if (intent?.action == UsbManager.ACTION_USB_DEVICE_ATTACHED || intent?.action == UsbManager.ACTION_USB_DEVICE_DETACHED) {
+                refresh()
+            }
+        }
+    }
+
     @SuppressLint("WrongConstant", "UnspecifiedRegisterReceiverFlag")
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
@@ -55,6 +67,16 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         tm = telephonyManager
 
         spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
+
+        registerReceiver(usbReceiver, IntentFilter().apply {
+            addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED)
+            addAction(UsbManager.ACTION_USB_DEVICE_DETACHED)
+        })
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        unregisterReceiver(usbReceiver)
     }
 
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
@@ -164,8 +186,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         lifecycleScope.launch {
             loading = true
 
-            supportFragmentManager.commit {
-                fragments.firstOrNull()?.let {
+            supportFragmentManager.commitNow {
+                fragments.forEach {
                     remove(it)
                 }
             }

From 083ee03f8e391678e46f03c55445295ed9ef425b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 18:26:10 -0400
Subject: [PATCH 090/458] OpenEuiccService: Fix ServiceConnection leakage

---
 .../openeuicc/service/OpenEuiccService.kt     | 69 +++++++++++--------
 1 file changed, 40 insertions(+), 29 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 2910590f5..f51a21fad 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -13,7 +13,6 @@ import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.first
-import kotlinx.coroutines.flow.single
 import kotlinx.coroutines.runBlocking
 import java.lang.IllegalStateException
 
@@ -57,8 +56,10 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
      *
      * This ensures that we only spawn and connect to APDU channels when we absolutely need to,
      * instead of keeping them open unnecessarily in the background at all times.
+     *
+     * This function cannot be inline because non-local returns may bypass the unbind
      */
-    private inline fun <T> withEuiccChannelManager(fn: EuiccChannelManagerContext.() -> T): T {
+    private fun <T> withEuiccChannelManager(fn: EuiccChannelManagerContext.() -> T): T {
         val (binder, unbind) = runBlocking {
             bindServiceSuspended(
                 Intent(
@@ -168,15 +169,20 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         Log.i(TAG, "onGetEuiccProfileInfoList slotId=$slotId")
         if (slotId == -1 || shouldIgnoreSlot(slotId)) {
             Log.i(TAG, "ignoring slot $slotId")
-            return GetEuiccProfileInfoListResult(RESULT_FIRST_USER, arrayOf(), true)
+            return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+                RESULT_FIRST_USER,
+                arrayOf(),
+                true
+            )
         }
 
         // TODO: Temporarily enable the slot to access its profiles if it is currently unmapped
-        val channel = findChannel(slotId) ?: return GetEuiccProfileInfoListResult(
-            RESULT_FIRST_USER,
-            arrayOf(),
-            true
-        )
+        val channel =
+            findChannel(slotId) ?: return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+                RESULT_FIRST_USER,
+                arrayOf(),
+                true
+            )
         val profiles = channel.lpa.profiles.operational.map {
             EuiccProfileInfo.Builder(it.iccid).apply {
                 setProfileName(it.name)
@@ -198,7 +204,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             }.build()
         }
 
-        return GetEuiccProfileInfoListResult(RESULT_OK, profiles.toTypedArray(), channel.removable)
+        return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+            RESULT_OK,
+            profiles.toTypedArray(),
+            channel.removable
+        )
     }
 
     override fun onGetEuiccInfo(slotId: Int): EuiccInfo {
@@ -207,30 +217,31 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
 
     override fun onDeleteSubscription(slotId: Int, iccid: String): Int = withEuiccChannelManager {
         Log.i(TAG, "onDeleteSubscription slotId=$slotId iccid=$iccid")
-        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
+        if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
 
         try {
-            val channels = findAllChannels(slotId) ?: return RESULT_FIRST_USER
+            val channels =
+                findAllChannels(slotId) ?: return@withEuiccChannelManager RESULT_FIRST_USER
 
             if (!channels[0].profileExists(iccid)) {
-                return RESULT_FIRST_USER
+                return@withEuiccChannelManager RESULT_FIRST_USER
             }
 
             // If the profile is enabled by ANY channel (port), we cannot delete it
             channels.forEach { channel ->
                 val profile = channel.lpa.profiles.find {
                     it.iccid == iccid
-                } ?: return RESULT_FIRST_USER
+                } ?: return@withEuiccChannelManager RESULT_FIRST_USER
 
                 if (profile.state == LocalProfileInfo.State.Enabled) {
                     // Must disable the profile first
-                    return RESULT_FIRST_USER
+                    return@withEuiccChannelManager RESULT_FIRST_USER
                 }
             }
 
             euiccChannelManager.beginTrackedOperationBlocking(channels[0].slotId, channels[0].portId) {
                 if (channels[0].lpa.deleteProfile(iccid)) {
-                    return RESULT_OK
+                    return@withEuiccChannelManager RESULT_OK
                 }
 
                 runBlocking {
@@ -238,9 +249,9 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 }
             }
 
-            return RESULT_FIRST_USER
+            return@withEuiccChannelManager RESULT_FIRST_USER
         } catch (e: Exception) {
-            return RESULT_FIRST_USER
+            return@withEuiccChannelManager RESULT_FIRST_USER
         }
     }
 
@@ -260,7 +271,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         forceDeactivateSim: Boolean
     ): Int = withEuiccChannelManager {
         Log.i(TAG,"onSwitchToSubscriptionWithPort slotId=$slotId portIndex=$portIndex iccid=$iccid forceDeactivateSim=$forceDeactivateSim")
-        if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
+        if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
 
         try {
             // retryWithTimeout is needed here because this function may be called just after
@@ -272,7 +283,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             } ?: run {
                 if (!forceDeactivateSim) {
                     // The user must select which SIM to deactivate
-                    return@onSwitchToSubscriptionWithPort RESULT_MUST_DEACTIVATE_SIM
+                    return@withEuiccChannelManager RESULT_MUST_DEACTIVATE_SIM
                 } else {
                     try {
                         // If we are allowed to deactivate any SIM we like, try mapping the indicated port first
@@ -282,13 +293,13 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                         // We cannot map the port (or it is already mapped)
                         // but we can also use any port available on the card
                         retryWithTimeout(5000) { findChannel(slotId) }
-                    } ?: return@onSwitchToSubscriptionWithPort RESULT_FIRST_USER
+                    } ?: return@withEuiccChannelManager RESULT_FIRST_USER
                 }
             }
 
             if (iccid != null && !channel.profileExists(iccid)) {
                 Log.i(TAG, "onSwitchToSubscriptionWithPort iccid=$iccid not found")
-                return RESULT_FIRST_USER
+                return@withEuiccChannelManager RESULT_FIRST_USER
             }
 
             euiccChannelManager.beginTrackedOperationBlocking(channel.slotId, channel.portId) {
@@ -296,11 +307,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                     // Disable any active profile first if present
                     channel.lpa.disableActiveProfile(false)
                     if (!channel.lpa.enableProfile(iccid)) {
-                        return RESULT_FIRST_USER
+                        return@withEuiccChannelManager RESULT_FIRST_USER
                     }
                 } else {
                     if (!channel.lpa.disableActiveProfile(true)) {
-                        return RESULT_FIRST_USER
+                        return@withEuiccChannelManager RESULT_FIRST_USER
                     }
                 }
 
@@ -310,9 +321,9 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 }
             }
 
-            return RESULT_OK
+            return@withEuiccChannelManager RESULT_OK
         } catch (e: Exception) {
-            return RESULT_FIRST_USER
+            return@withEuiccChannelManager RESULT_FIRST_USER
         } finally {
             euiccChannelManager.invalidate()
         }
@@ -324,15 +335,15 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 TAG,
                 "onUpdateSubscriptionNickname slotId=$slotId iccid=$iccid nickname=$nickname"
             )
-            if (shouldIgnoreSlot(slotId)) return RESULT_FIRST_USER
-            val channel = findChannel(slotId) ?: return RESULT_FIRST_USER
+            if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
+            val channel = findChannel(slotId) ?: return@withEuiccChannelManager RESULT_FIRST_USER
             if (!channel.profileExists(iccid)) {
-                return RESULT_FIRST_USER
+                return@withEuiccChannelManager RESULT_FIRST_USER
             }
             val success = channel.lpa
                 .setNickname(iccid, nickname!!)
             appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
-            return if (success) {
+            return@withEuiccChannelManager if (success) {
                 RESULT_OK
             } else {
                 RESULT_FIRST_USER

From c7afeea8452c6da6535761be7fd10d14b3a88f3c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 19:48:40 -0400
Subject: [PATCH 091/458] UsbCcidTransceiver: Stop spamming logs

---
 .../java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt  | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
index 09d324b07..85d9e9409 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -172,13 +172,11 @@ class UsbCcidTransceiver(
          * if things really turn sour.
          */
         var attempts = 3
-        Log.d(TAG, "Receive data block immediate seq=$expectedSequenceNumber")
         var readBytes: Int
         do {
             readBytes = usbConnection.bulkTransfer(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
             )
-            Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
         } while (readBytes <= 0 && attempts-- > 0)
         if (readBytes < CCID_HEADER_LENGTH) {
             throw UsbTransportException("USB-CCID error - failed to receive CCID header")
@@ -230,9 +228,6 @@ class UsbCcidTransceiver(
             ignoredBytes = usbConnection.bulkTransfer(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_SKIP_TIMEOUT_MILLIS
             )
-            if (ignoredBytes > 0) {
-                Log.e(TAG, "Skipped $ignoredBytes bytes")
-            }
         } while (ignoredBytes > 0)
     }
 
@@ -279,7 +274,6 @@ class UsbCcidTransceiver(
         }
         val ccidDataBlock = receiveDataBlock(sequenceNumber)
         val elapsedTime = SystemClock.elapsedRealtime() - startTime
-        Log.d(TAG, "USB XferBlock call took " + elapsedTime + "ms")
         return ccidDataBlock
     }
 

From 3f0e789997aaf43e23ee02553537d091caa96dda Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 19:54:44 -0400
Subject: [PATCH 092/458] feat: Unified notification type for enabling /
 disabling

---
 .../im/angry/openeuicc/ui/EuiccManagementFragment.kt  |  6 +-----
 .../java/im/angry/openeuicc/ui/SettingsFragment.kt    |  7 ++-----
 .../java/im/angry/openeuicc/util/PreferenceUtils.kt   |  9 +++------
 app-common/src/main/res/values/strings.xml            |  6 ++----
 app-common/src/main/res/xml/pref_settings.xml         | 11 +++--------
 .../im/angry/openeuicc/service/OpenEuiccService.kt    |  3 +--
 6 files changed, 12 insertions(+), 30 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index b83b241b2..00d7629a4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -204,11 +204,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     }
                 }
 
-                if (enable) {
-                    preferenceRepository.notificationEnableFlow.first()
-                } else {
-                    preferenceRepository.notificationDisableFlow.first()
-                }
+                preferenceRepository.notificationSwitchFlow.first()
             }
             refresh()
             fab.isEnabled = true
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 5de89b218..e3336a00a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -39,11 +39,8 @@ class SettingsFragment: PreferenceFragmentCompat() {
         findPreference<CheckBoxPreference>("pref_notifications_delete")
             ?.bindBooleanFlow(preferenceRepository.notificationDeleteFlow, PreferenceKeys.NOTIFICATION_DELETE)
 
-        findPreference<CheckBoxPreference>("pref_notifications_enable")
-            ?.bindBooleanFlow(preferenceRepository.notificationEnableFlow, PreferenceKeys.NOTIFICATION_ENABLE)
-
-        findPreference<CheckBoxPreference>("pref_notifications_disable")
-            ?.bindBooleanFlow(preferenceRepository.notificationDisableFlow, PreferenceKeys.NOTIFICATION_DISABLE)
+        findPreference<CheckBoxPreference>("pref_notifications_switch")
+            ?.bindBooleanFlow(preferenceRepository.notificationSwitchFlow, PreferenceKeys.NOTIFICATION_SWITCH)
     }
 
     private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index b9a854e32..98d98126c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -24,6 +24,7 @@ object PreferenceKeys {
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
     val NOTIFICATION_ENABLE = booleanPreferencesKey("notification_enable")
     val NOTIFICATION_DISABLE = booleanPreferencesKey("notification_disable")
+    val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
 }
 
 class PreferenceRepository(context: Context) {
@@ -37,12 +38,8 @@ class PreferenceRepository(context: Context) {
     val notificationDeleteFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.NOTIFICATION_DELETE] ?: true }
 
-    // Enabling / disabling notifications are not sent by default
-    val notificationEnableFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_ENABLE] ?: false }
-
-    val notificationDisableFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_DISABLE] ?: false }
+    val notificationSwitchFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_SWITCH] ?: false }
 
     suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
         dataStore.edit {
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bf6606a6f..21b84d608 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -67,10 +67,8 @@
     <string name="pref_notifications_download_desc">Send notifications for <i>downloading</i> profiles</string>
     <string name="pref_notifications_delete">Deletion</string>
     <string name="pref_notifications_delete_desc">Send notifications for <i>deleting</i> profiles</string>
-    <string name="pref_notifications_enable">Enabling</string>
-    <string name="pref_notifications_enable_desc">Send notifications for <i>enabling</i> profiles\nNote that this type of notification is unreliable.</string>
-    <string name="pref_notifications_disable">Disabling</string>
-    <string name="pref_notifications_disable_desc">Send notifications for <i>disabling</i> profiles\nNote that this type of notification is unreliable.</string>
+    <string name="pref_notifications_switch">Switching</string>
+    <string name="pref_notifications_switch_desc">Send notifications for <i>switching</i> profiles\nNote that this type of notification is unreliable.</string>
     <string name="pref_advanced">Advanced</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 39d64f368..34466fd82 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -16,14 +16,9 @@
             app:key="pref_notifications_delete" />
         <CheckBoxPreference
             app:iconSpaceReserved="false"
-            app:title="@string/pref_notifications_enable"
-            app:summary="@string/pref_notifications_enable_desc"
-            app:key="pref_notifications_enable" />
-        <CheckBoxPreference
-            app:iconSpaceReserved="false"
-            app:title="@string/pref_notifications_disable"
-            app:summary="@string/pref_notifications_disable_desc"
-            app:key="pref_notifications_disable" />
+            app:title="@string/pref_notifications_switch"
+            app:summary="@string/pref_notifications_switch_desc"
+            app:key="pref_notifications_switch" />
     </im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory>
 
     <PreferenceCategory
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index f51a21fad..572b02bb6 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -316,8 +316,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 }
 
                 runBlocking {
-                    // TODO: The enable / disable operations should really be one
-                    preferenceRepository.notificationEnableFlow.first()
+                    preferenceRepository.notificationSwitchFlow.first()
                 }
             }
 

From 09a8db330bf7ec1b79a8b19628fea4622fa81805 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 19:55:13 -0400
Subject: [PATCH 093/458] preference: Remove unused keys

---
 .../src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt    | 2 --
 1 file changed, 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 98d98126c..e72301cb9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -22,8 +22,6 @@ val Fragment.preferenceRepository: PreferenceRepository
 object PreferenceKeys {
     val NOTIFICATION_DOWNLOAD = booleanPreferencesKey("notification_download")
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
-    val NOTIFICATION_ENABLE = booleanPreferencesKey("notification_enable")
-    val NOTIFICATION_DISABLE = booleanPreferencesKey("notification_disable")
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
 }
 

From 960fa6743a49829d665b736ee9bc3cc738a7b4cd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 19:59:23 -0400
Subject: [PATCH 094/458] UsbApduInterface: Implement validity check

---
 .../main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 98e738d0c..fb93ff687 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -95,7 +95,7 @@ class UsbApduInterface(
     }
 
     override val valid: Boolean
-        get() = true
+        get() = channelId != -1
 
     private fun isSuccessResponse(resp: ByteArray): Boolean =
         resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()

From 9c7cf2c797b273229a8c49ff44d10cf4ce1286de Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 1 Jul 2024 20:08:05 -0400
Subject: [PATCH 095/458] ui: Fix frame drops by calling isMEP in the IO
 context

For whatever reason, UiccCardInfo.isMultipleEnabledProfilesSupported()
can be slow only on some SIM slots.
---
 .../angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index 744acb8bf..c1d46f047 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -6,6 +6,8 @@ import android.widget.Button
 import android.widget.PopupMenu
 import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileInfo
 
 class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
@@ -15,7 +17,9 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
     }
 
     override suspend fun onCreateFooterViews(parent: ViewGroup): List<View> =
-        if (channel.isMEP) {
+        // isMEP can map to a slow operation (UiccCardInfo.isMultipleEnabledProfilesSupported())
+        // so let's do it in the IO context
+        if (withContext(Dispatchers.IO) { channel.isMEP }) {
             val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
             view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
                 (requireActivity() as PrivilegedMainActivity).showSlotMappingFragment()

From d78985bd724f65d72b686d6ebcfdaa22c7f3f88d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 2 Jul 2024 21:23:32 -0400
Subject: [PATCH 096/458] Revert "UsbCcidTransceiver: Stop spamming logs"

This reverts commit c7afeea8452c6da6535761be7fd10d14b3a88f3c.
---
 .../java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
index 85d9e9409..09d324b07 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -172,11 +172,13 @@ class UsbCcidTransceiver(
          * if things really turn sour.
          */
         var attempts = 3
+        Log.d(TAG, "Receive data block immediate seq=$expectedSequenceNumber")
         var readBytes: Int
         do {
             readBytes = usbConnection.bulkTransfer(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
             )
+            Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
         } while (readBytes <= 0 && attempts-- > 0)
         if (readBytes < CCID_HEADER_LENGTH) {
             throw UsbTransportException("USB-CCID error - failed to receive CCID header")
@@ -228,6 +230,9 @@ class UsbCcidTransceiver(
             ignoredBytes = usbConnection.bulkTransfer(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_SKIP_TIMEOUT_MILLIS
             )
+            if (ignoredBytes > 0) {
+                Log.e(TAG, "Skipped $ignoredBytes bytes")
+            }
         } while (ignoredBytes > 0)
     }
 
@@ -274,6 +279,7 @@ class UsbCcidTransceiver(
         }
         val ccidDataBlock = receiveDataBlock(sequenceNumber)
         val elapsedTime = SystemClock.elapsedRealtime() - startTime
+        Log.d(TAG, "USB XferBlock call took " + elapsedTime + "ms")
         return ccidDataBlock
     }
 

From 3ffd847af76d0f7c3bebaec642fe51447f3d7672 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 6 Jul 2024 18:12:33 -0400
Subject: [PATCH 097/458] ui: refactor: Use ViewPager2 instead of an ad-hoc
 spinner for slot selection

---
 .../im/angry/openeuicc/ui/MainActivity.kt     | 111 ++++++++----------
 .../main/res/drawable/ic_refresh_black.xml    |   5 +
 .../src/main/res/layout/activity_main.xml     |  20 +++-
 .../src/main/res/menu/activity_main.xml       |   9 +-
 app-deps/build.gradle.kts                     |   1 +
 5 files changed, 71 insertions(+), 75 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_refresh_black.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 161392c6b..85af38832 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -12,28 +12,43 @@ import android.util.Log
 import android.view.Menu
 import android.view.MenuItem
 import android.view.View
-import android.widget.AdapterView
-import android.widget.ArrayAdapter
 import android.widget.ProgressBar
-import android.widget.Spinner
 import androidx.fragment.app.Fragment
-import androidx.fragment.app.commitNow
 import androidx.lifecycle.lifecycleScope
+import androidx.viewpager2.adapter.FragmentStateAdapter
+import androidx.viewpager2.widget.ViewPager2
+import com.google.android.material.tabs.TabLayout
+import com.google.android.material.tabs.TabLayoutMediator
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
+@SuppressLint("NotifyDataSetChanged")
 open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         const val TAG = "MainActivity"
     }
 
-    private lateinit var spinnerAdapter: ArrayAdapter<String>
-    private lateinit var spinnerItem: MenuItem
-    private lateinit var spinner: Spinner
     private lateinit var loadingProgress: ProgressBar
+    private lateinit var tabs: TabLayout
+    private lateinit var viewPager: ViewPager2
+
+    private data class Page(
+        val title: String,
+        val createFragment: () -> Fragment
+    )
+
+    private val pages: MutableList<Page> = mutableListOf()
+
+    private val pagerAdapter by lazy {
+        object : FragmentStateAdapter(this) {
+            override fun getItemCount() = pages.size
+
+            override fun createFragment(position: Int): Fragment = pages[position].createFragment()
+        }
+    }
 
     var loading: Boolean
         get() = loadingProgress.visibility == View.VISIBLE
@@ -45,8 +60,6 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
 
-    private val fragments = arrayListOf<Fragment>()
-
     protected lateinit var tm: TelephonyManager
 
     private val usbReceiver = object : BroadcastReceiver() {
@@ -63,11 +76,16 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         setContentView(R.layout.activity_main)
         setSupportActionBar(requireViewById(R.id.toolbar))
         loadingProgress = requireViewById(R.id.loading)
+        tabs = requireViewById(R.id.main_tabs)
+        viewPager = requireViewById(R.id.view_pager)
+
+        viewPager.adapter = pagerAdapter
+        TabLayoutMediator(tabs, viewPager) { tab, pos ->
+            tab.text = pages[pos].title
+        }.attach()
 
         tm = telephonyManager
 
-        spinnerAdapter = ArrayAdapter<String>(this, R.layout.spinner_item)
-
         registerReceiver(usbReceiver, IntentFilter().apply {
             addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED)
             addAction(UsbManager.ACTION_USB_DEVICE_DETACHED)
@@ -81,37 +99,6 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
         menuInflater.inflate(R.menu.activity_main, menu)
-
-        if (!this::spinner.isInitialized) {
-            spinnerItem = menu.findItem(R.id.spinner)
-            spinner = spinnerItem.actionView as Spinner
-            if (spinnerAdapter.isEmpty) {
-                spinnerItem.isVisible = false
-            }
-            spinner.adapter = spinnerAdapter
-            spinner.onItemSelectedListener = object : AdapterView.OnItemSelectedListener {
-                override fun onItemSelected(
-                    parent: AdapterView<*>?,
-                    view: View?,
-                    position: Int,
-                    id: Long
-                ) {
-                    if (position < fragments.size) {
-                        supportFragmentManager.beginTransaction()
-                            .replace(R.id.fragment_root, fragments[position]).commit()
-                    }
-                }
-
-                override fun onNothingSelected(parent: AdapterView<*>?) {
-                }
-
-            }
-        } else {
-            // Fragments may cause this menu to be inflated multiple times.
-            // Simply reuse the action view in that case
-            menu.findItem(R.id.spinner).actionView = spinner
-        }
-
         return true
     }
 
@@ -136,6 +123,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private suspend fun init() {
         loading = true
+        viewPager.visibility = View.GONE
+        tabs.visibility = View.GONE
 
         val knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
@@ -156,28 +145,25 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             loading = false
 
             knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
-                spinnerAdapter.add(getString(R.string.channel_name_format, channel.logicalSlotId))
-                fragments.add(appContainer.uiComponentFactory.createEuiccManagementFragment(channel))
+                pages.add(Page(
+                    getString(R.string.channel_name_format, channel.logicalSlotId)
+                ) { appContainer.uiComponentFactory.createEuiccManagementFragment(channel) })
             }
 
             // If USB readers exist, add them at the very last
             // We use a wrapper fragment to handle logic specific to USB readers
             usbDevice?.let {
-                spinnerAdapter.add(it.productName)
-                fragments.add(UsbCcidReaderFragment())
+                //spinnerAdapter.add(it.productName)
+                pages.add(Page(it.productName ?: "USB") { UsbCcidReaderFragment() })
             }
+            pagerAdapter.notifyDataSetChanged()
+            viewPager.visibility = View.VISIBLE
 
-            if (fragments.isNotEmpty()) {
-                if (this@MainActivity::spinner.isInitialized) {
-                    spinnerItem.isVisible = true
-                }
-                supportFragmentManager.beginTransaction()
-                    .replace(R.id.fragment_root, fragments.first()).commit()
-            } else {
-                supportFragmentManager.beginTransaction().replace(
-                    R.id.fragment_root,
-                    appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
-                ).commit()
+            if (pages.size > 1) {
+                tabs.visibility = View.VISIBLE
+            } else if (pages.isEmpty()) {
+                pages.add(Page("") { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
+                pagerAdapter.notifyDataSetChanged()
             }
         }
     }
@@ -185,14 +171,11 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private fun refresh() {
         lifecycleScope.launch {
             loading = true
+            viewPager.visibility = View.GONE
+            tabs.visibility = View.GONE
 
-            supportFragmentManager.commitNow {
-                fragments.forEach {
-                    remove(it)
-                }
-            }
-            fragments.clear()
-            spinnerAdapter.clear()
+            pages.clear()
+            pagerAdapter.notifyDataSetChanged()
 
             init()
         }
diff --git a/app-common/src/main/res/drawable/ic_refresh_black.xml b/app-common/src/main/res/drawable/ic_refresh_black.xml
new file mode 100644
index 000000000..ccaf34b76
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_refresh_black.xml
@@ -0,0 +1,5 @@
+<vector android:height="24dp" android:tint="?attr/colorControlNormal"
+    android:viewportHeight="24" android:viewportWidth="24"
+    android:width="24dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="@android:color/white" android:pathData="M17.65,6.35C16.2,4.9 14.21,4 12,4c-4.42,0 -7.99,3.58 -7.99,8s3.57,8 7.99,8c3.73,0 6.84,-2.55 7.73,-6h-2.08c-0.82,2.33 -3.04,4 -5.65,4 -3.31,0 -6,-2.69 -6,-6s2.69,-6 6,-6c1.66,0 3.14,0.69 4.22,1.78L13,11h7V4l-2.35,2.35z"/>
+</vector>
diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index 89b9d7ed4..cb5f22464 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -14,6 +14,17 @@
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintWidth_percent="1" />
 
+    <com.google.android.material.tabs.TabLayout
+        android:id="@+id/main_tabs"
+        android:background="?attr/colorSurfaceVariant"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:visibility="gone"
+        app:tabTextColor="?attr/colorOnSurfaceVariant"
+        app:tabSelectedTextColor="?attr/colorOnSurfaceVariant"
+        app:layout_constraintTop_toBottomOf="@id/toolbar"
+        app:layout_constraintStart_toStartOf="parent" />
+
     <ProgressBar
         android:id="@+id/loading"
         android:layout_width="wrap_content"
@@ -21,16 +32,17 @@
         android:indeterminate="true"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"
+        app:layout_constraintTop_toBottomOf="@id/main_tabs"
         app:layout_constraintBottom_toBottomOf="parent" />
 
-    <FrameLayout
-        android:id="@+id/fragment_root"
+    <androidx.viewpager2.widget.ViewPager2
+        android:id="@+id/view_pager"
         android:layout_width="0dp"
         android:layout_height="0dp"
+        android:visibility="gone"
         app:layout_constraintBottom_toBottomOf="parent"
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"/>
+        app:layout_constraintTop_toBottomOf="@id/main_tabs"/>
 
 </androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/activity_main.xml b/app-common/src/main/res/menu/activity_main.xml
index 509ad7902..0e0029286 100644
--- a/app-common/src/main/res/menu/activity_main.xml
+++ b/app-common/src/main/res/menu/activity_main.xml
@@ -1,16 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <menu xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto">
-    <item
-        android:id="@+id/spinner"
-        android:title=""
-        app:actionViewClass="android.widget.Spinner"
-        app:showAsAction="always" />
-
     <item
         android:id="@+id/reload"
         android:title="@string/reload"
-        app:showAsAction="never" />
+        android:icon="@drawable/ic_refresh_black"
+        app:showAsAction="ifRoom" />
 
     <item
         android:id="@+id/settings"
diff --git a/app-deps/build.gradle.kts b/app-deps/build.gradle.kts
index cd851bf3a..21114360d 100644
--- a/app-deps/build.gradle.kts
+++ b/app-deps/build.gradle.kts
@@ -50,6 +50,7 @@ dependencies {
     api("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")
     api("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
     api("androidx.cardview:cardview:1.0.0")
+    api("androidx.viewpager2:viewpager2:1.1.0")
     api("androidx.datastore:datastore-preferences:1.0.0")
     api("com.journeyapps:zxing-android-embedded:4.3.0")
     testImplementation("junit:junit:4.13.2")

From 388f15a531f7293f856061ee40a5cc98d40610db Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 6 Jul 2024 18:29:01 -0400
Subject: [PATCH 098/458] ui: Scroll to USB fragment when inserted while app is
 active

---
 .../java/im/angry/openeuicc/ui/MainActivity.kt  | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 85af38832..f74f955c3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -65,7 +65,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private val usbReceiver = object : BroadcastReceiver() {
         override fun onReceive(context: Context?, intent: Intent?) {
             if (intent?.action == UsbManager.ACTION_USB_DEVICE_ATTACHED || intent?.action == UsbManager.ACTION_USB_DEVICE_DETACHED) {
-                refresh()
+                refresh(true)
             }
         }
     }
@@ -121,7 +121,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
     }
 
-    private suspend fun init() {
+    private suspend fun init(fromUsbEvent: Boolean = false) {
         loading = true
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
@@ -165,10 +165,19 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 pages.add(Page("") { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
                 pagerAdapter.notifyDataSetChanged()
             }
+
+            if (fromUsbEvent && usbDevice != null) {
+                // If this refresh was triggered by a USB insertion while active, scroll to that page
+                viewPager.post {
+                    viewPager.setCurrentItem(pages.size - 1, true)
+                }
+            } else {
+                viewPager.currentItem = 0
+            }
         }
     }
 
-    private fun refresh() {
+    private fun refresh(fromUsbEvent: Boolean = false) {
         lifecycleScope.launch {
             loading = true
             viewPager.visibility = View.GONE
@@ -177,7 +186,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             pages.clear()
             pagerAdapter.notifyDataSetChanged()
 
-            init()
+            init(fromUsbEvent)
         }
     }
 }
\ No newline at end of file

From b2fb3d23cb528eb0ec218ade8b4d7e98e7842089 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 6 Jul 2024 18:36:58 -0400
Subject: [PATCH 099/458] ui: Usb should use its own refresh progress bar

---
 .../java/im/angry/openeuicc/ui/MainActivity.kt   | 16 +++-------------
 .../angry/openeuicc/ui/UsbCcidReaderFragment.kt  |  8 +++++---
 .../main/res/layout/fragment_usb_ccid_reader.xml | 10 ++++++++++
 3 files changed, 18 insertions(+), 16 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index f74f955c3..e9a190ece 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -50,16 +50,6 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
     }
 
-    var loading: Boolean
-        get() = loadingProgress.visibility == View.VISIBLE
-        set(value) {
-            loadingProgress.visibility = if (value) {
-                View.VISIBLE
-            } else {
-                View.GONE
-            }
-        }
-
     protected lateinit var tm: TelephonyManager
 
     private val usbReceiver = object : BroadcastReceiver() {
@@ -122,7 +112,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private suspend fun init(fromUsbEvent: Boolean = false) {
-        loading = true
+        loadingProgress.visibility = View.VISIBLE
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
 
@@ -142,7 +132,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
 
         withContext(Dispatchers.Main) {
-            loading = false
+            loadingProgress.visibility = View.GONE
 
             knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
                 pages.add(Page(
@@ -179,7 +169,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private fun refresh(fromUsbEvent: Boolean = false) {
         lifecycleScope.launch {
-            loading = true
+            loadingProgress.visibility = View.VISIBLE
             viewPager.visibility = View.GONE
             tabs.visibility = View.GONE
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
index 35251476d..3988b09a6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -14,6 +14,7 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.Button
+import android.widget.ProgressBar
 import android.widget.TextView
 import androidx.fragment.app.Fragment
 import androidx.fragment.app.commit
@@ -69,6 +70,7 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
 
     private lateinit var text: TextView
     private lateinit var permissionButton: Button
+    private lateinit var loadingProgress: ProgressBar
 
     private var usbDevice: UsbDevice? = null
     private var usbChannel: EuiccChannel? = null
@@ -82,6 +84,7 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
 
         text = view.requireViewById(R.id.usb_reader_text)
         permissionButton = view.requireViewById(R.id.usb_grant_permission)
+        loadingProgress = view.requireViewById(R.id.loading)
 
         permissionButton.setOnClickListener {
             usbManager.requestPermission(usbDevice, usbPendingIntent)
@@ -135,14 +138,13 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
     private suspend fun tryLoadUsbChannel() {
         text.visibility = View.GONE
         permissionButton.visibility = View.GONE
-
-        (requireActivity() as MainActivity).loading = true
+        loadingProgress.visibility = View.VISIBLE
 
         val (device, channel) = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateUsbEuiccChannel()
         }
 
-        (requireActivity() as MainActivity).loading = false
+        loadingProgress.visibility = View.GONE
 
         usbDevice = device
         usbChannel = channel
diff --git a/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml b/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml
index 1207990d5..287e340fd 100644
--- a/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml
+++ b/app-common/src/main/res/layout/fragment_usb_ccid_reader.xml
@@ -4,6 +4,16 @@
     android:layout_width="match_parent"
     android:layout_height="match_parent">
 
+    <ProgressBar
+        android:id="@+id/loading"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:indeterminate="true"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent" />
+
     <TextView
         android:id="@+id/usb_reader_text"
         android:layout_width="match_parent"

From 293266bb6e27ac64b9c813ee10eea82ce8581841 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 6 Jul 2024 20:46:52 -0400
Subject: [PATCH 100/458] ui: Allow disabling the only remaining profile
 through USB readers

---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt  | 7 +++++++
 .../im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt   | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 00d7629a4..c54720486 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -216,6 +216,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         if (profile.isEnabled) {
             popup.menu.findItem(R.id.enable).isVisible = false
             popup.menu.findItem(R.id.delete).isVisible = false
+
+            // We hide the disable option by default to avoid "bricking" some cards that won't get
+            // recognized again by the phone's modem. However we don't have that worry if we are
+            // accessing it through a USB card reader
+            if (isUsb) {
+                popup.menu.findItem(R.id.disable).isVisible = true
+            }
         }
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 8b2aadbbe..5df1a0a9b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -28,6 +28,9 @@ val <T> T.slotId: Int where T: Fragment, T: EuiccChannelFragmentMarker
 val <T> T.portId: Int where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("portId")
 
+val <T> T.isUsb: Boolean where T: Fragment, T: EuiccChannelFragmentMarker
+    get() = requireArguments().getInt("slotId") == EuiccChannelManager.USB_CHANNEL_ID
+
 val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: EuiccChannelFragmentMarker
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
 val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker

From b16a72f43abdaff08c36fc57afeef5a3b5098ffd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Jul 2024 09:56:06 -0400
Subject: [PATCH 101/458] ui: Add option to skip safeguard for removable eSIMs

---
 .../angry/openeuicc/ui/EuiccManagementFragment.kt | 15 +++++++++++++--
 .../im/angry/openeuicc/ui/SettingsFragment.kt     |  3 +++
 .../im/angry/openeuicc/util/PreferenceUtils.kt    |  5 +++++
 app-common/src/main/res/values/strings.xml        |  2 ++
 app-common/src/main/res/xml/pref_settings.xml     |  6 ++++++
 5 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index c54720486..b2323390b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -29,7 +29,9 @@ import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
+import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
@@ -52,6 +54,10 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     // e.g. after a failed enable / disable operation
     private var invalid = false
 
+    // Subscribe to settings we care about outside of coroutine contexts while initializing
+    // This gives us access to the "latest" state without having to launch coroutines
+    private lateinit var disableSafeguardFlow: StateFlow<Boolean>
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setHasOptionsMenu(true)
@@ -115,6 +121,11 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
+            if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
+                disableSafeguardFlow =
+                    preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
+            }
+
             val profiles = withContext(Dispatchers.IO) {
                 euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
                 channel.lpa.profiles
@@ -219,8 +230,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
             // We hide the disable option by default to avoid "bricking" some cards that won't get
             // recognized again by the phone's modem. However we don't have that worry if we are
-            // accessing it through a USB card reader
-            if (isUsb) {
+            // accessing it through a USB card reader, or when the user explicitly opted in
+            if (isUsb || disableSafeguardFlow.value) {
                 popup.menu.findItem(R.id.disable).isVisible = true
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index e3336a00a..d471efab8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -41,6 +41,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
 
         findPreference<CheckBoxPreference>("pref_notifications_switch")
             ?.bindBooleanFlow(preferenceRepository.notificationSwitchFlow, PreferenceKeys.NOTIFICATION_SWITCH)
+
+        findPreference<CheckBoxPreference>("pref_advanced_disable_safeguard_removable_esim")
+            ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow, PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM)
     }
 
     private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index e72301cb9..53153405e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -23,6 +23,7 @@ object PreferenceKeys {
     val NOTIFICATION_DOWNLOAD = booleanPreferencesKey("notification_download")
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
+    val DISABLE_SAFEGUARD_REMOVABLE_ESIM = booleanPreferencesKey("disable_safeguard_removable_esim")
 }
 
 class PreferenceRepository(context: Context) {
@@ -39,6 +40,10 @@ class PreferenceRepository(context: Context) {
     val notificationSwitchFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.NOTIFICATION_SWITCH] ?: false }
 
+    // ---- Advanced ----
+    val disableSafeguardFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM] ?: false }
+
     suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
         dataStore.edit {
             it[key] = value
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 21b84d608..f859014ed 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -70,6 +70,8 @@
     <string name="pref_notifications_switch">Switching</string>
     <string name="pref_notifications_switch_desc">Send notifications for <i>switching</i> profiles\nNote that this type of notification is unreliable.</string>
     <string name="pref_advanced">Advanced</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">Disable Safeguards for Removable eSIMs</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_info">Info</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 34466fd82..db348fc15 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -24,6 +24,12 @@
     <PreferenceCategory
         app:title="@string/pref_advanced"
         app:iconSpaceReserved="false">
+        <CheckBoxPreference
+            app:key="pref_advanced_disable_safeguard_removable_esim"
+            app:iconSpaceReserved="false"
+            app:title="@string/pref_advanced_disable_safeguard_removable_esim"
+            app:summary="@string/pref_advanced_disable_safeguard_removable_esim_desc" />
+
         <Preference
             app:key="pref_advanced_logs"
             app:iconSpaceReserved="false"

From 0ecf4e9776ef69f4d1201a898c6a9f158d1fb12b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Jul 2024 09:58:12 -0400
Subject: [PATCH 102/458] ui: Better wording

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index f859014ed..07b709087 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -71,7 +71,7 @@
     <string name="pref_notifications_switch_desc">Send notifications for <i>switching</i> profiles\nNote that this type of notification is unreliable.</string>
     <string name="pref_advanced">Advanced</string>
     <string name="pref_advanced_disable_safeguard_removable_esim">Disable Safeguards for Removable eSIMs</string>
-    <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_info">Info</string>

From eac33575cef13eb2fe69647ba04620fbf6fa58bb Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Jul 2024 10:08:45 -0400
Subject: [PATCH 103/458] app-deps: Update Android.bp dependencies

---
 app-deps/Android.bp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-deps/Android.bp b/app-deps/Android.bp
index 663b1ec37..3143e3f6f 100644
--- a/app-deps/Android.bp
+++ b/app-deps/Android.bp
@@ -10,6 +10,7 @@ java_defaults {
         "androidx.lifecycle_lifecycle-runtime-ktx",
         "androidx.swiperefreshlayout_swiperefreshlayout",
         "androidx.cardview_cardview",
+        "androidx.viewpager2_viewpager2",
         "OpenEUICC_androidx.datastore_datastore-preferences",
         "OpenEUICC_com.journeyapps_zxing-android-embedded",
     ],

From f84baa02f02ef1ca247ad99b60a19c3099bd5b5b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Jul 2024 10:16:33 -0400
Subject: [PATCH 104/458] ui: Prevent refresh from being launched multiple
 times

Fixes #35.
---
 .../src/main/java/im/angry/openeuicc/ui/MainActivity.kt  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index e9a190ece..44183fc53 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -35,6 +35,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private lateinit var tabs: TabLayout
     private lateinit var viewPager: ViewPager2
 
+    private var refreshing = false
+
     private data class Page(
         val title: String,
         val createFragment: () -> Fragment
@@ -112,6 +114,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private suspend fun init(fromUsbEvent: Boolean = false) {
+        refreshing = true // We don't check this here -- the check happens in refresh()
         loadingProgress.visibility = View.VISIBLE
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
@@ -164,11 +167,15 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             } else {
                 viewPager.currentItem = 0
             }
+
+            refreshing = false
         }
     }
 
     private fun refresh(fromUsbEvent: Boolean = false) {
+        if (refreshing) return
         lifecycleScope.launch {
+            refreshing = true
             loadingProgress.visibility = View.VISIBLE
             viewPager.visibility = View.GONE
             tabs.visibility = View.GONE
@@ -176,7 +183,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             pages.clear()
             pagerAdapter.notifyDataSetChanged()
 
-            init(fromUsbEvent)
+            init(fromUsbEvent) // will set refreshing = false
         }
     }
 }
\ No newline at end of file

From 829f019aa2dc6850c233452d10480b913aa6f1c2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Jul 2024 20:59:55 -0400
Subject: [PATCH 105/458] ui: Add footer view when no profiles are found

---
 .../openeuicc/ui/EuiccManagementFragment.kt   | 25 ++++++++++++++++---
 .../src/main/res/layout/footer_no_profile.xml | 21 ++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  1 +
 .../ui/PrivilegedEuiccManagementFragment.kt   | 25 +++++++++++--------
 app/src/main/res/layout/footer_mep.xml        |  1 +
 5 files changed, 59 insertions(+), 14 deletions(-)
 create mode 100644 app-common/src/main/res/layout/footer_no_profile.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index b2323390b..5dd633ebf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -110,10 +110,20 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
                 true
             }
+
             else -> super.onOptionsItemSelected(item)
         }
 
-    protected open suspend fun onCreateFooterViews(parent: ViewGroup): List<View> = listOf()
+    protected open suspend fun onCreateFooterViews(
+        parent: ViewGroup,
+        profiles: List<LocalProfileInfo>
+    ): List<View> =
+        if (profiles.isEmpty()) {
+            val view = layoutInflater.inflate(R.layout.footer_no_profile, parent, false)
+            listOf(view)
+        } else {
+            listOf()
+        }
 
     @SuppressLint("NotifyDataSetChanged")
     private fun refresh() {
@@ -128,12 +138,12 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
             val profiles = withContext(Dispatchers.IO) {
                 euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
-                channel.lpa.profiles
+                channel.lpa.profiles.operational
             }
 
             withContext(Dispatchers.Main) {
-                adapter.profiles = profiles.operational
-                adapter.footerViews = onCreateFooterViews(profileList)
+                adapter.profiles = profiles
+                adapter.footerViews = onCreateFooterViews(profileList, profiles)
                 adapter.notifyDataSetChanged()
                 swipeRefresh.isRefreshing = false
             }
@@ -250,6 +260,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     }
 
     inner class FooterViewHolder: ViewHolder(FrameLayout(requireContext())) {
+        init {
+            itemView.layoutParams = ViewGroup.LayoutParams(
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                ViewGroup.LayoutParams.WRAP_CONTENT
+            )
+        }
+
         fun attach(view: View) {
             view.parent?.let { (it as ViewGroup).removeView(view) }
             (itemView as FrameLayout).addView(view)
diff --git a/app-common/src/main/res/layout/footer_no_profile.xml b/app-common/src/main/res/layout/footer_no_profile.xml
new file mode 100644
index 000000000..b02c67c39
--- /dev/null
+++ b/app-common/src/main/res/layout/footer_no_profile.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <TextView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="40dp"
+        android:layout_marginEnd="40dp"
+        android:layout_marginTop="6dp"
+        android:gravity="center"
+        android:text="@string/no_profile"
+        android:textStyle="italic"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 07b709087..caafd5f4e 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device.</string>
+    <string name="no_profile">No profiles (yet) on this eSIM.</string>
     <string name="unknown">Unknown</string>
     <string name="help">Help</string>
     <string name="reload">Reload Slots</string>
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index c1d46f047..7d055f470 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -16,17 +16,22 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
             newInstanceEuicc(PrivilegedEuiccManagementFragment::class.java, slotId, portId)
     }
 
-    override suspend fun onCreateFooterViews(parent: ViewGroup): List<View> =
-        // isMEP can map to a slow operation (UiccCardInfo.isMultipleEnabledProfilesSupported())
-        // so let's do it in the IO context
-        if (withContext(Dispatchers.IO) { channel.isMEP }) {
-            val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
-            view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
-                (requireActivity() as PrivilegedMainActivity).showSlotMappingFragment()
+    override suspend fun onCreateFooterViews(
+        parent: ViewGroup,
+        profiles: List<LocalProfileInfo>
+    ): List<View> =
+        super.onCreateFooterViews(parent, profiles).let { footers ->
+            // isMEP can map to a slow operation (UiccCardInfo.isMultipleEnabledProfilesSupported())
+            // so let's do it in the IO context
+            if (withContext(Dispatchers.IO) { channel.isMEP }) {
+                val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
+                view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
+                    (requireActivity() as PrivilegedMainActivity).showSlotMappingFragment()
+                }
+                footers + view
+            } else {
+                footers
             }
-            listOf(view)
-        } else {
-            listOf()
         }
 
     override fun populatePopupWithProfileActions(popup: PopupMenu, profile: LocalProfileInfo) {
diff --git a/app/src/main/res/layout/footer_mep.xml b/app/src/main/res/layout/footer_mep.xml
index cec2351d3..f894d5a31 100644
--- a/app/src/main/res/layout/footer_mep.xml
+++ b/app/src/main/res/layout/footer_mep.xml
@@ -10,6 +10,7 @@
         android:layout_height="wrap_content"
         android:layout_marginStart="40dp"
         android:layout_marginEnd="40dp"
+        android:layout_marginTop="6dp"
         android:gravity="center"
         android:text="@string/footer_mep"
         android:textStyle="italic"

From 67927cf7ef74817cd4eb75e9acb45b82c5e65d5b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 12 Jul 2024 17:17:32 -0400
Subject: [PATCH 106/458] fix: Do not look for channel in the process of
 switching profiles

Fixes #36
---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt     | 4 ++--
 .../java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 5dd633ebf..d49fa70ee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -180,7 +180,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     return@beginTrackedOperation false
                 }
 
-                if (!refreshed && channel.slotId != EuiccChannelManager.USB_CHANNEL_ID) {
+                if (!refreshed && !isUsb) {
                     withContext(Dispatchers.Main) {
                         AlertDialog.Builder(requireContext()).apply {
                             setMessage(R.string.switch_did_not_refresh)
@@ -197,7 +197,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     return@beginTrackedOperation true
                 }
 
-                if (channel.slotId != EuiccChannelManager.USB_CHANNEL_ID) {
+                if (!isUsb) {
                     try {
                         euiccChannelManager.waitForReconnect(
                             slotId,
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 5df1a0a9b..a324ac3d5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -23,11 +23,13 @@ fun <T> newInstanceEuicc(clazz: Class<T>, slotId: Int, portId: Int, addArguments
     return instance
 }
 
+// Convenient methods to avoid using `channel` for these
+// `channel` requires that the channel actually exists in EuiccChannelManager, which is
+// not always the case during operations such as switching
 val <T> T.slotId: Int where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("slotId")
 val <T> T.portId: Int where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("portId")
-
 val <T> T.isUsb: Boolean where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("slotId") == EuiccChannelManager.USB_CHANNEL_ID
 

From 26abb5cc43018b65e15014f1ea47780c6ffa1b81 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 17:11:43 -0400
Subject: [PATCH 107/458] Add USB compatibility check

---
 .../openeuicc/util/CompatibilityCheck.kt      | 21 +++++++++++++++++++
 app-unpriv/src/main/res/values/strings.xml    | 20 +++++++++++-------
 2 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index d2ee8ccdb..49811bc55 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -17,6 +17,7 @@ fun getCompatibilityChecks(context: Context): List<CompatibilityCheck> =
         OmapiConnCheck(context),
         IsdrChannelAccessCheck(context),
         KnownBrokenCheck(context),
+        UsbCheck(context),
         Verdict(context),
     )
 
@@ -212,6 +213,26 @@ internal class KnownBrokenCheck(private val context: Context): CompatibilityChec
         }
 }
 
+internal class UsbCheck(private val context: Context) : CompatibilityCheck(context) {
+    override val title: String
+        get() = context.getString(R.string.compatibility_check_usb)
+    override val defaultDescription: String
+        get() = context.getString(R.string.compatibility_check_usb_desc)
+
+    init {
+        successDescription = context.getString(R.string.compatibility_check_usb_ok)
+        failureDescription = context.getString(R.string.compatibility_check_usb_fail)
+    }
+
+    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State =
+        if (context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_HOST)) {
+            State.SUCCESS
+        } else {
+            State.FAILURE
+        }
+
+}
+
 internal class Verdict(private val context: Context) : CompatibilityCheck(context) {
     override val title: String
         get() = context.getString(R.string.compatibility_check_verdict)
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 8f1b528c0..43e57e2f0 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -19,12 +19,16 @@
     <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
     <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>
-    <string name="compatibility_check_verdict">Verdict</string>
-    <string name="compatibility_check_verdict_desc">Based on all previous checks, how likely is your device to be compatible with removable eSIMs?</string>
-    <string name="compatibility_check_verdict_ok">You can likely use and manage removable eSIMs on this device.</string>
-    <string name="compatibility_check_verdict_known_broken">Your device is known to be buggy when accessing removable eSIMs.\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_ok">We cannot determine whether removable eSIMs can be managed on your device. Your device does declare support for OMAPI, though, so it is slightly more likely that it will work.\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_fail">We cannot determine whether removable eSIMs can be managed on your device. Since your device does not declare support for OMAPI, it is more likely that managing removable eSIMs on this device is unsupported.\n%s</string>
-    <string name="compatibility_check_verdict_unknown">We cannot determine whether removable eSIMs can be managed on your device.\n%s</string>
-    <string name="compatibility_check_verdict_fail_shared">However, a removable eSIM that has already been loaded with an eSIM profile will still work; this verdict is only for management features via the app, such as switching and downloading profiles.</string>
+    <string name="compatibility_check_usb">USB Card Reader Support</string>
+    <string name="compatibility_check_usb_desc">Does your device support managing eSIMs via USB card readers?</string>
+    <string name="compatibility_check_usb_ok">You can manage eSIMs through USB card readers on this device (even if you had any other check items fail here). Insert the card reader and then open this app to manage eSIMs in this way.</string>
+    <string name="compatibility_check_usb_fail">Your device does not support acting as a USB host.</string>
+    <string name="compatibility_check_verdict">Verdict (non-USB)</string>
+    <string name="compatibility_check_verdict_desc">Based on all previous checks, how likely is your device to be compatible with managing inserted removable eSIMs?</string>
+    <string name="compatibility_check_verdict_ok">You can likely use and manage removable eSIMs inserted into this device.</string>
+    <string name="compatibility_check_verdict_known_broken">Your device is known to be buggy when accessing inserted removable eSIMs.\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_ok">We cannot determine whether inserted removable eSIMs can be managed on your device. Your device does declare support for OMAPI, though, so it is slightly more likely that it will work.\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_fail">We cannot determine whether inserted removable eSIMs can be managed on your device. Since your device does not declare support for OMAPI, it is more likely that managing removable eSIMs on this device is unsupported.\n%s</string>
+    <string name="compatibility_check_verdict_unknown">We cannot determine whether inserted removable eSIMs can be managed on your device.\n%s</string>
+    <string name="compatibility_check_verdict_fail_shared">However, a removable eSIM that has already been loaded with an eSIM profile will still work; you can also most likely use a USB card reader plugged into this device to manage profiles, even if you cannot manage one inserted into your device.</string>
 </resources>
\ No newline at end of file

From 5300178a0ef14f11882f5e7f8743c9db9dc79aeb Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 20:45:46 -0400
Subject: [PATCH 108/458] lpac-jni: Kill profiles cache, and stop crashing when
 null

This is no longer needed because we are using euiccInfo2 to check
validity
---
 .../impl/LocalProfileAssistantImpl.kt         | 32 ++++++++-----------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 79a35ec15..361c594bf 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -41,11 +41,8 @@ class LocalProfileAssistantImpl(
             false
         }
 
-    private var _profiles: List<LocalProfileInfo>? = null
     override val profiles: List<LocalProfileInfo>
-        get() = (_profiles ?: LpacJni.es10cGetProfilesInfo(contextHandle)!!.asList()).also {
-            _profiles = it
-        }
+        get() = LpacJni.es10cGetProfilesInfo(contextHandle)?.asList() ?: listOf()
 
     override val notifications: List<LocalProfileNotification>
         get() =
@@ -59,26 +56,25 @@ class LocalProfileAssistantImpl(
         get() = LpacJni.es10cexGetEuiccInfo2(contextHandle)
 
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
-        (LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0).also {
-            _profiles = null
-        }
+        LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0
 
     override fun disableProfile(iccid: String, refresh: Boolean): Boolean =
-        (LpacJni.es10cDisableProfile(contextHandle, iccid, refresh) == 0).also {
-            _profiles = null
-        }
+        LpacJni.es10cDisableProfile(contextHandle, iccid, refresh) == 0
 
     override fun deleteProfile(iccid: String): Boolean =
-        (LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0).also {
-            _profiles = null
-        }
+        LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
 
     @Synchronized
     override fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
                                  confirmationCode: String?, callback: ProfileDownloadCallback): Boolean {
-        return (LpacJni.downloadProfile(contextHandle, smdp, matchingId, imei, confirmationCode, callback) == 0).also {
-            _profiles = null
-        }
+        return LpacJni.downloadProfile(
+            contextHandle,
+            smdp,
+            matchingId,
+            imei,
+            confirmationCode,
+            callback
+        ) == 0
     }
 
     override fun deleteNotification(seqNumber: Long): Boolean =
@@ -91,9 +87,7 @@ class LocalProfileAssistantImpl(
         } == 0
 
     override fun setNickname(iccid: String, nickname: String): Boolean =
-        (LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0).also {
-            _profiles = null
-        }
+        LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
 
     @Synchronized
     override fun close() {

From 154ac77203ec98d0d6ac8bb995001f3be1bd8bf6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 21:16:42 -0400
Subject: [PATCH 109/458] ui: Fix USB hotplug not getting picked up when no SIM
 is found

---
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt   | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 44183fc53..fd2d51c16 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -119,7 +119,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
 
-        val knownChannels = withContext(Dispatchers.IO) {
+        var knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
                 Log.d(TAG, it.lpa.eID)
@@ -146,19 +146,21 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             // If USB readers exist, add them at the very last
             // We use a wrapper fragment to handle logic specific to USB readers
             usbDevice?.let {
-                //spinnerAdapter.add(it.productName)
                 pages.add(Page(it.productName ?: "USB") { UsbCcidReaderFragment() })
             }
-            pagerAdapter.notifyDataSetChanged()
             viewPager.visibility = View.VISIBLE
 
             if (pages.size > 1) {
                 tabs.visibility = View.VISIBLE
             } else if (pages.isEmpty()) {
                 pages.add(Page("") { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
-                pagerAdapter.notifyDataSetChanged()
             }
 
+            pagerAdapter.notifyDataSetChanged()
+            // Reset the adapter so that the current view actually gets cleared
+            // notifyDataSetChanged() doesn't cause the current view to be removed.
+            viewPager.adapter = pagerAdapter
+
             if (fromUsbEvent && usbDevice != null) {
                 // If this refresh was triggered by a USB insertion while active, scroll to that page
                 viewPager.post {
@@ -182,6 +184,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
             pages.clear()
             pagerAdapter.notifyDataSetChanged()
+            viewPager.adapter = pagerAdapter
 
             init(fromUsbEvent) // will set refreshing = false
         }

From e1877f5d3ada8d8968d9d05a3ed3ef81c77ef4c2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 21:18:00 -0400
Subject: [PATCH 110/458] Update wording to stress "standard CCID readers"

---
 app-unpriv/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 43e57e2f0..124bedf4f 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -21,7 +21,7 @@
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>
     <string name="compatibility_check_usb">USB Card Reader Support</string>
     <string name="compatibility_check_usb_desc">Does your device support managing eSIMs via USB card readers?</string>
-    <string name="compatibility_check_usb_ok">You can manage eSIMs through USB card readers on this device (even if you had any other check items fail here). Insert the card reader and then open this app to manage eSIMs in this way.</string>
+    <string name="compatibility_check_usb_ok">You can manage eSIMs through standard USB CCID readers on this device (even if you had any other check items fail here). Insert the card reader and then open this app to manage eSIMs in this way.</string>
     <string name="compatibility_check_usb_fail">Your device does not support acting as a USB host.</string>
     <string name="compatibility_check_verdict">Verdict (non-USB)</string>
     <string name="compatibility_check_verdict_desc">Based on all previous checks, how likely is your device to be compatible with managing inserted removable eSIMs?</string>

From 323c6a5bc00f5a189cdb95bbde0c7580269a71d7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 21:19:27 -0400
Subject: [PATCH 111/458] Update wording to include USB readers when no card
 found

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index caafd5f4e..4ad6071b3 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device.</string>
+    <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device. Insert a compatible card or a USB reader.</string>
     <string name="no_profile">No profiles (yet) on this eSIM.</string>
     <string name="unknown">Unknown</string>
     <string name="help">Help</string>

From 7b605fd44a570fa3503fe942f09ff9c5241877cc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 21:20:11 -0400
Subject: [PATCH 112/458] Remove unnecessary `var`

---
 app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index fd2d51c16..74fe38598 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -119,7 +119,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
 
-        var knownChannels = withContext(Dispatchers.IO) {
+        val knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
                 Log.d(TAG, it.lpa.eID)

From 27627fdf1579b0d89a0fe9561ef6d755fe994593 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Jul 2024 22:03:03 -0400
Subject: [PATCH 113/458] ui: Minor XML fixes

`tools:context` is unused; fix RTL
---
 app-common/src/main/res/layout/activity_main.xml  | 3 +--
 app-common/src/main/res/layout/fragment_euicc.xml | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index cb5f22464..a61a368f7 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -3,8 +3,7 @@
     xmlns:app="http://schemas.android.com/apk/res-auto"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    tools:context=".ui.MainActivity">
+    android:layout_height="match_parent">
 
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
diff --git a/app-common/src/main/res/layout/fragment_euicc.xml b/app-common/src/main/res/layout/fragment_euicc.xml
index 33cc4d0c6..4ae7523a8 100644
--- a/app-common/src/main/res/layout/fragment_euicc.xml
+++ b/app-common/src/main/res/layout/fragment_euicc.xml
@@ -25,7 +25,7 @@
         android:id="@+id/fab"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
-        android:layout_marginRight="16dp"
+        android:layout_marginEnd="16dp"
         android:layout_marginBottom="16dp"
         android:src="@drawable/ic_add"
         app:layout_constraintRight_toRightOf="parent"

From 47c6bbb864700ee9ac2de2597a108b8fc30f928a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 20 Jul 2024 15:41:08 -0400
Subject: [PATCH 114/458] feat: Copy ICCID to clipboard on long click

---
 .../im/angry/openeuicc/ui/EuiccManagementFragment.kt   | 10 ++++++++++
 app-common/src/main/res/values/strings.xml             |  1 +
 2 files changed, 11 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index d49fa70ee..3374f07b7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -1,6 +1,8 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
+import android.content.ClipData
+import android.content.ClipboardManager
 import android.content.Intent
 import android.os.Bundle
 import android.text.method.PasswordTransformationMethod
@@ -293,6 +295,14 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
             }
 
+            iccid.setOnLongClickListener {
+                requireContext().getSystemService(ClipboardManager::class.java)
+                    .setPrimaryClip(ClipData.newPlainText("iccid", iccid.text))
+                Toast.makeText(requireContext(), R.string.toast_iccid_copied, Toast.LENGTH_SHORT)
+                    .show()
+                true
+            }
+
             profileMenu.setOnClickListener { showOptionsMenu() }
         }
 
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4ad6071b3..a1a002a9b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -23,6 +23,7 @@
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>
+    <string name="toast_iccid_copied">ICCID copied to clipboard</string>
 
     <string name="slot_select">Select Slot</string>
     <string name="slot_select_select">Select</string>

From c84b114de0af0a2436b479cfbb4e2be200b05892 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 20 Jul 2024 16:02:43 -0400
Subject: [PATCH 115/458] README: Update for USB readers

---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 17d2cfc31..5616a327a 100644
--- a/README.md
+++ b/README.md
@@ -8,9 +8,11 @@ There are two variants of this project:
   - Due to its privilege requirement, OpenEUICC must be placed inside `/system/priv-app` and be signed with the platform certificate.
   - The preferred way to including OpenEUICC in a system image is to [build it along with AOSP](#building-aosp).
 - EasyEUICC: Unprivileged version that can run as a user app.
-  - Due to obvious security requirements, EasyEUICC is only able to access eSIM chips whose [ARF/ARA](https://source.android.com/docs/core/connect/uicc#arf) contains the hash of EasyEUICC's signing certificate.
+  - This version supports two modes of operation:
+    1. Inserted, removable eSIMs: Due to obvious security requirements, EasyEUICC is only able to access eSIM chips whose [ARF/ARA](https://source.android.com/docs/core/connect/uicc#arf) contains the hash of EasyEUICC's signing certificate.
+    2. USB CCID Card Readers: Only `T=0` readers that use the standard [USB CCID protocol](https://en.wikipedia.org/wiki/CCID_(protocol)) are supported. In this mode, EasyEUICC can access any eSIM chip loaded in the card reader regardless of their ARF/ARA, as long as they implement the [SGP.22 standard](https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2021/07/SGP.22-v2.3.pdf).
   - Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases)
-  - For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`
+  - For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`
 
 Building (Gradle)
 ===

From b55df25650bd5b3237da4faf1ced6196f10cdc0d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 21 Jul 2024 08:38:31 -0400
Subject: [PATCH 116/458] NotificationsActivity: display channel name in
 toolbar

---
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt   |  2 +-
 .../im/angry/openeuicc/ui/NotificationsActivity.kt    | 11 +++++++++++
 app-common/src/main/res/values/strings.xml            |  4 +++-
 3 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 74fe38598..0f504ebbc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -146,7 +146,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             // If USB readers exist, add them at the very last
             // We use a wrapper fragment to handle logic specific to USB readers
             usbDevice?.let {
-                pages.add(Page(it.productName ?: "USB") { UsbCcidReaderFragment() })
+                pages.add(Page(it.productName ?: getString(R.string.usb)) { UsbCcidReaderFragment() })
             }
             viewPager.visibility = View.VISIBLE
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 9758d18df..59abbc563 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -20,6 +20,7 @@ import androidx.recyclerview.widget.RecyclerView
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
@@ -53,6 +54,16 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         notificationList.adapter = notificationAdapter
         registerForContextMenu(notificationList)
 
+        // This is slightly different from the MainActivity logic
+        // due to the length (we don't want to display the full USB product name)
+        val channelTitle = if (euiccChannel.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+            getString(R.string.usb)
+        } else {
+            getString(R.string.channel_name_format, euiccChannel.logicalSlotId)
+        }
+
+        title = getString(R.string.profile_notifications_detailed_format, channelTitle)
+
         swipeRefresh.setOnRefreshListener {
             refresh()
         }
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a1a002a9b..7647815e2 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -7,6 +7,7 @@
     <string name="reload">Reload Slots</string>
 
     <string name="channel_name_format">Logical Slot %d</string>
+    <string name="usb">USB</string>
 
     <string name="enabled">Enabled</string>
     <string name="disabled">Disabled</string>
@@ -48,7 +49,8 @@
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>
     <string name="profile_delete_confirm_input">Type \'%s\' here to confirm deletion</string>
 
-    <string name="profile_notifications">Profile Notifications</string>
+    <string name="profile_notifications">Notifications</string>
+    <string name="profile_notifications_detailed_format">Notifications (%s)</string>
     <string name="profile_notifications_show">Manage Notifications</string>
     <string name="profile_notifications_help">eSIM profiles can send notifications to the carrier when they are downloaded, deleted, enabled, or disabled. The queue of these notifications to be sent is listed here.\n\nIn Settings, you can specify whether to send each type of notification automatically. Note that even if a notification has been sent, it will not be deleted automatically from the record, unless the queue runs out of space.\n\nHere, you can manually send or delete each pending notification.</string>
     <string name="profile_notification_operation_download">Downloaded</string>

From 01fc07fd78026afbf524bd26c85b529c9be1e3fb Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 11 Aug 2024 20:50:57 -0400
Subject: [PATCH 117/458] EuiccManagementFragment: Add nonnull assertion for
 platform types

Fixes build within AOSP 14 source tree.
---
 .../main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 3374f07b7..ac0a99f8a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -296,7 +296,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             }
 
             iccid.setOnLongClickListener {
-                requireContext().getSystemService(ClipboardManager::class.java)
+                requireContext().getSystemService(ClipboardManager::class.java)!!
                     .setPrimaryClip(ClipData.newPlainText("iccid", iccid.text))
                 Toast.makeText(requireContext(), R.string.toast_iccid_copied, Toast.LENGTH_SHORT)
                     .show()

From 44b85ffdea4b208513a78b86d90f2f90c680201a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 14 Aug 2024 20:15:47 -0400
Subject: [PATCH 118/458] lpac-jni: Log load bpp error reason

---
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
index f8b27ff0b..91676daf2 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
@@ -114,7 +114,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_downloadProfile(JNIEnv *env, jobject thiz, j
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_finalizing);
     // TODO: Expose error code as Java-side exceptions?
     ret = es10b_load_bound_profile_package(ctx, &es10b_load_bound_profile_package_result);
-    syslog(LOG_INFO, "es10b_load_bound_profile_package %d", ret);
+    syslog(LOG_INFO, "es10b_load_bound_profile_package %d, reason %d", ret, es10b_load_bound_profile_package_result.errorReason);
 
     out:
     euicc_http_cleanup(ctx);

From 87ea017b36d7abec34838632dd69d8d0a897dfc4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 14 Aug 2024 20:43:54 -0400
Subject: [PATCH 119/458] OmapiApduInterface: Log all APDU exchanges

---
 .../angry/openeuicc/core/OmapiApduInterface.kt  | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index 227977c90..711658adb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.core
 import android.se.omapi.Channel
 import android.se.omapi.SEService
 import android.se.omapi.Session
+import android.util.Log
 import im.angry.openeuicc.util.*
 import net.typeblog.lpac_jni.ApduInterface
 
@@ -10,6 +11,10 @@ class OmapiApduInterface(
     private val service: SEService,
     private val port: UiccPortInfoCompat
 ): ApduInterface {
+    companion object {
+        const val TAG = "OmapiApduInterface"
+    }
+
     private lateinit var session: Session
     private lateinit var lastChannel: Channel
 
@@ -44,7 +49,17 @@ class OmapiApduInterface(
             "Unknown channel"
         }
 
-        return lastChannel.transmit(tx)
+        Log.d(TAG, "OMAPI APDU: ${tx.encodeHex()}")
+
+        try {
+            return lastChannel.transmit(tx).also {
+                Log.d(TAG, "OMAPI APDU response: ${it.encodeHex()}")
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "OMAPI APDU exception")
+            e.printStackTrace()
+            throw e
+        }
     }
 
 }
\ No newline at end of file

From f073261b603c620f99cc081aba1ed80564591380 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 17 Aug 2024 20:55:03 -0400
Subject: [PATCH 120/458] unpriv: Add Huawei and Honor into the blocklist

---
 .../src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 49811bc55..8424c5507 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -193,7 +193,7 @@ internal class IsdrChannelAccessCheck(private val context: Context): Compatibili
 
 internal class KnownBrokenCheck(private val context: Context): CompatibilityCheck(context) {
     companion object {
-        val BROKEN_MANUFACTURERS = arrayOf("xiaomi")
+        val BROKEN_MANUFACTURERS = arrayOf("xiaomi", "huawei", "honor")
     }
 
     override val title: String

From 7c07db0aab03925bb5e41f5c9602b238601b03f9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 17 Aug 2024 20:57:25 -0400
Subject: [PATCH 121/458] README: Warn about non-standard external eSIMs

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 5616a327a..24f4c9f47 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@ There are two variants of this project:
 - OpenEUICC: The full-fledged privileged variant.
   - Due to its privilege requirement, OpenEUICC must be placed inside `/system/priv-app` and be signed with the platform certificate.
   - The preferred way to including OpenEUICC in a system image is to [build it along with AOSP](#building-aosp).
+  - __Note__: When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
 - EasyEUICC: Unprivileged version that can run as a user app.
   - This version supports two modes of operation:
     1. Inserted, removable eSIMs: Due to obvious security requirements, EasyEUICC is only able to access eSIM chips whose [ARF/ARA](https://source.android.com/docs/core/connect/uicc#arf) contains the hash of EasyEUICC's signing certificate.

From 7f67000074b5146945a7dd822ef8dd64f6f1a681 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 2 Sep 2024 17:03:20 -0400
Subject: [PATCH 122/458] refactor: lpac-jni: Handle notification struct /
 linked list in Kotlin

JNI does not seem to like a ton of local references very much on armv7
(32-bit), even if env->EnsureLocalCapacity is called. Let's just avoid
doing this by moving most of this logic to Kotlin.

This also needs to be done for LocalProfileInfo.
---
 .../java/net/typeblog/lpac_jni/LpacJni.kt     |  11 +-
 .../impl/LocalProfileAssistantImpl.kt         |  19 ++-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.c |   1 -
 .../main/jni/lpac-jni/lpac-notifications.c    | 139 ++++++++----------
 .../main/jni/lpac-jni/lpac-notifications.h    |   2 -
 5 files changed, 89 insertions(+), 83 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 5a706b9a3..884c81a4a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -21,7 +21,7 @@ internal object LpacJni {
     external fun es10cSetNickname(handle: Long, iccid: String, nick: String): Int
 
     // es10b
-    external fun es10bListNotification(handle: Long): Array<LocalProfileNotification>?
+    external fun es10bListNotification(handle: Long): Long // A native pointer to a linked list. Handle with linked list-related methods below. May be 0 (null)
     external fun es10bDeleteNotification(handle: Long, seqNumber: Long): Int
 
     // es9p + es10b
@@ -32,4 +32,13 @@ internal object LpacJni {
 
     // es10cex (actually part of es10b)
     external fun es10cexGetEuiccInfo2(handle: Long): EuiccInfo2?
+
+    // C <-> Java struct / linked list handling
+    // Notifications
+    external fun notificationNext(curr: Long): Long
+    external fun notificationGetSeq(curr: Long): Long
+    external fun notificationGetOperationString(curr: Long): String
+    external fun notificationGetAddress(curr: Long): String
+    external fun notificationGetIccid(curr: Long): String
+    external fun notificationsFree(head: Long)
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 361c594bf..0b6aa1da0 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -45,9 +45,22 @@ class LocalProfileAssistantImpl(
         get() = LpacJni.es10cGetProfilesInfo(contextHandle)?.asList() ?: listOf()
 
     override val notifications: List<LocalProfileNotification>
-        get() =
-            (LpacJni.es10bListNotification(contextHandle) ?: arrayOf())
-                .sortedBy { it.seqNumber }.reversed()
+        get() {
+            val head = LpacJni.es10bListNotification(contextHandle)
+            var curr = head
+            val ret = mutableListOf<LocalProfileNotification>()
+            while (curr != 0L) {
+                ret.add(LocalProfileNotification(
+                    LpacJni.notificationGetSeq(curr),
+                    LocalProfileNotification.Operation.fromString(LpacJni.notificationGetOperationString(curr)),
+                    LpacJni.notificationGetAddress(curr),
+                    LpacJni.notificationGetIccid(curr),
+                ))
+                curr = LpacJni.notificationNext(curr)
+            }
+            LpacJni.notificationsFree(head)
+            return ret.sortedBy { it.seqNumber }.reversed()
+        }
 
     override val eID: String
         get() = LpacJni.es10cGetEid(contextHandle)!!
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 6ba8ebf7e..561e0278a 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -33,7 +33,6 @@ jint JNI_OnLoad(JavaVM *vm, void *reserved) {
     jvm = vm;
     interface_wrapper_init();
     lpac_download_init();
-    lpac_notifications_init();
 
     LPAC_JNI_SETUP_ENV;
     string_class = (*env)->FindClass(env, "java/lang/String");
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
index 1a5ac7c2d..cfb1e5984 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
@@ -4,88 +4,15 @@
 #include <malloc.h>
 #include <syslog.h>
 
-jclass local_profile_notification_class;
-jmethodID local_profile_notification_constructor;
-
-jclass local_profile_notification_operation_class;
-jmethodID local_profile_notification_operation_from_string;
-
-void lpac_notifications_init() {
-    LPAC_JNI_SETUP_ENV;
-
-    local_profile_notification_class =
-            (*env)->FindClass(env, "net/typeblog/lpac_jni/LocalProfileNotification");
-    local_profile_notification_class =
-            (*env)->NewGlobalRef(env, local_profile_notification_class);
-    local_profile_notification_constructor =
-            (*env)->GetMethodID(env, local_profile_notification_class, "<init>",
-                                "(JLnet/typeblog/lpac_jni/LocalProfileNotification$Operation;Ljava/lang/String;Ljava/lang/String;)V");
-
-    local_profile_notification_operation_class =
-            (*env)->FindClass(env, "net/typeblog/lpac_jni/LocalProfileNotification$Operation");
-    local_profile_notification_operation_class =
-            (*env)->NewGlobalRef(env, local_profile_notification_operation_class);
-    local_profile_notification_operation_from_string =
-            (*env)->GetStaticMethodID(env, local_profile_notification_operation_class, "fromString",
-                                      "(Ljava/lang/String;)Lnet/typeblog/lpac_jni/LocalProfileNotification$Operation;");
-}
-
-JNIEXPORT jobject JNICALL
+JNIEXPORT jlong JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10bListNotification(JNIEnv *env, jobject thiz, jlong handle) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     struct es10b_notification_metadata_list *info = NULL;
-    struct es10b_notification_metadata_list *curr = NULL;
-    const char *profileManagementOperationStr = NULL;
-    jobject notification = NULL;
-    jobject operation = NULL;
-    jobjectArray ret = NULL;
-    int count = 0;
 
     if (es10b_list_notification(ctx, &info) < 0)
-        return NULL;
+        return 0;
 
-    count = LPAC_JNI_LINKED_LIST_COUNT(info, curr);
-
-    ret = (*env)->NewObjectArray(env, count, local_profile_notification_class, NULL);
-
-    LPAC_JNI_LINKED_LIST_FOREACH(info, curr, {
-        switch (curr->profileManagementOperation) {
-            case ES10B_PROFILE_MANAGEMENT_OPERATION_INSTALL:
-                profileManagementOperationStr = "install";
-                break;
-            case ES10B_PROFILE_MANAGEMENT_OPERATION_DELETE:
-                profileManagementOperationStr = "delete";
-                break;
-            case ES10B_PROFILE_MANAGEMENT_OPERATION_ENABLE:
-                profileManagementOperationStr = "enable";
-                break;
-            case ES10B_PROFILE_MANAGEMENT_OPERATION_DISABLE:
-                profileManagementOperationStr = "disable";
-                break;
-            default:
-                profileManagementOperationStr = "unknown";
-        }
-
-        operation =
-                (*env)->CallStaticObjectMethod(env, local_profile_notification_operation_class,
-                                               local_profile_notification_operation_from_string,
-                                               toJString(env, profileManagementOperationStr));
-
-        notification =
-                (*env)->NewObject(env, local_profile_notification_class,
-                                  local_profile_notification_constructor, curr->seqNumber,
-                                  operation,
-                                  toJString(env, curr->notificationAddress),
-                                  toJString(env, curr->iccid));
-
-        (*env)->SetObjectArrayElement(env, ret, i, notification);
-
-        (*env)->DeleteLocalRef(env, operation);
-        (*env)->DeleteLocalRef(env, notification);
-    });
-
-    es10b_notification_metadata_list_free_all(info);
-    return ret;
+    return (jlong) info;
 }
 
 JNIEXPORT jint JNICALL
@@ -117,4 +44,64 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10bDeleteNotification(JNIEnv *env, jobject
                                                             jlong seq_number) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     return es10b_remove_notification_from_list(ctx, (unsigned long) seq_number);
+}
+
+JNIEXPORT jlong JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationNext(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
+    if (info == NULL) {
+        return 0;
+    }
+    return (jlong) info->next;
+}
+
+JNIEXPORT jlong JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationGetSeq(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
+    return info->seqNumber;
+}
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationGetOperationString(JNIEnv *env, jobject thiz,
+                                                                   jlong curr) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
+    const char *profileManagementOperationStr = NULL;
+    switch (info->profileManagementOperation) {
+        case ES10B_PROFILE_MANAGEMENT_OPERATION_INSTALL:
+            profileManagementOperationStr = "install";
+            break;
+        case ES10B_PROFILE_MANAGEMENT_OPERATION_DELETE:
+            profileManagementOperationStr = "delete";
+            break;
+        case ES10B_PROFILE_MANAGEMENT_OPERATION_ENABLE:
+            profileManagementOperationStr = "enable";
+            break;
+        case ES10B_PROFILE_MANAGEMENT_OPERATION_DISABLE:
+            profileManagementOperationStr = "disable";
+            break;
+        default:
+            profileManagementOperationStr = "unknown";
+            break;
+    }
+
+    return toJString(env, profileManagementOperationStr);
+}
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationGetAddress(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
+    return toJString(env, info->notificationAddress);
+}
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationGetIccid(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
+    return toJString(env, info->iccid);
+}
+
+JNIEXPORT void JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_notificationsFree(JNIEnv *env, jobject thiz, jlong head) {
+    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) head;
+    if (info == NULL) return;
+    es10b_notification_metadata_list_free_all(info);
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.h
index 0b88555cf..511de2faa 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.h
@@ -2,5 +2,3 @@
 
 #include <jni.h>
 #include "lpac-jni.h"
-
-void lpac_notifications_init();
\ No newline at end of file

From 394cad2eac64eeb8feef50b9e1e2fd71346af1a2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 3 Sep 2024 21:35:41 -0400
Subject: [PATCH 123/458] refactor: lpac-jni: Use C macros to generate
 struct-exposing functions

---
 .../java/net/typeblog/lpac_jni/LpacJni.kt     |  2 +-
 .../impl/LocalProfileAssistantImpl.kt         |  2 +-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.h | 29 +++++++++++++-
 .../main/jni/lpac-jni/lpac-notifications.c    | 38 +++----------------
 4 files changed, 35 insertions(+), 36 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 884c81a4a..37406a74c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -35,7 +35,7 @@ internal object LpacJni {
 
     // C <-> Java struct / linked list handling
     // Notifications
-    external fun notificationNext(curr: Long): Long
+    external fun notificationsNext(curr: Long): Long
     external fun notificationGetSeq(curr: Long): Long
     external fun notificationGetOperationString(curr: Long): String
     external fun notificationGetAddress(curr: Long): String
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 0b6aa1da0..0b03b6470 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -56,7 +56,7 @@ class LocalProfileAssistantImpl(
                     LpacJni.notificationGetAddress(curr),
                     LpacJni.notificationGetIccid(curr),
                 ))
-                curr = LpacJni.notificationNext(curr)
+                curr = LpacJni.notificationsNext(curr)
             }
             LpacJni.notificationsFree(head)
             return ret.sortedBy { it.seqNumber }.reversed()
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
index 1915c5e41..4d537ee50 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
@@ -50,4 +50,31 @@ struct lpac_jni_ctx {
 extern JavaVM *jvm;
 extern jclass string_class;
 
-jstring toJString(JNIEnv *env, const char *pat);
\ No newline at end of file
+jstring toJString(JNIEnv *env, const char *pat);
+
+#define LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(st, st_jname) \
+        JNIEXPORT jlong JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_jname##Next(JNIEnv *env, jobject thiz, jlong raw) { \
+            st *p = (st *) raw;                       \
+            if (p == NULL) return 0;                  \
+            return (jlong) p->next;                   \
+        }
+
+#define LPAC_JNI_STRUCT_LINKED_LIST_FREE(st, st_jname, free_func) \
+        JNIEXPORT void JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_jname##Free(JNIEnv *env, jobject thiz, jlong raw) { \
+            st *p = (st *) raw;                       \
+            if (p == NULL) return;                    \
+            free_func(p);                             \
+        }
+
+#define LPAC_JNI_STRUCT_GETTER_LONG(st, name, jname) \
+        JNIEXPORT jlong JNICALL Java_net_typeblog_lpac_1jni_LpacJni_notificationGet##jname(JNIEnv *env, jobject thiz, jlong raw) { \
+            st *p = (st *) raw;                       \
+            if (p == NULL) return 0;                  \
+            return (jlong) p->name;                   \
+        }
+
+#define LPAC_JNI_STRUCT_GETTER_STRING(st, name, jname) \
+        JNIEXPORT jstring JNICALL Java_net_typeblog_lpac_1jni_LpacJni_notificationGet##jname(JNIEnv *env, jobject thiz, jlong raw) { \
+            st *p = (st *) raw;                       \
+            return toJString(env, p->name);           \
+        }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
index cfb1e5984..bd4dffda1 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
@@ -46,21 +46,6 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10bDeleteNotification(JNIEnv *env, jobject
     return es10b_remove_notification_from_list(ctx, (unsigned long) seq_number);
 }
 
-JNIEXPORT jlong JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_notificationNext(JNIEnv *env, jobject thiz, jlong curr) {
-    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
-    if (info == NULL) {
-        return 0;
-    }
-    return (jlong) info->next;
-}
-
-JNIEXPORT jlong JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_notificationGetSeq(JNIEnv *env, jobject thiz, jlong curr) {
-    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
-    return info->seqNumber;
-}
-
 JNIEXPORT jstring JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_notificationGetOperationString(JNIEnv *env, jobject thiz,
                                                                    jlong curr) {
@@ -87,21 +72,8 @@ Java_net_typeblog_lpac_1jni_LpacJni_notificationGetOperationString(JNIEnv *env,
     return toJString(env, profileManagementOperationStr);
 }
 
-JNIEXPORT jstring JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_notificationGetAddress(JNIEnv *env, jobject thiz, jlong curr) {
-    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
-    return toJString(env, info->notificationAddress);
-}
-
-JNIEXPORT jstring JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_notificationGetIccid(JNIEnv *env, jobject thiz, jlong curr) {
-    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) curr;
-    return toJString(env, info->iccid);
-}
-
-JNIEXPORT void JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_notificationsFree(JNIEnv *env, jobject thiz, jlong head) {
-    struct es10b_notification_metadata_list *info = (struct es10b_notification_metadata_list *) head;
-    if (info == NULL) return;
-    es10b_notification_metadata_list_free_all(info);
-}
\ No newline at end of file
+LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(struct es10b_notification_metadata_list, notifications)
+LPAC_JNI_STRUCT_LINKED_LIST_FREE(struct es10b_notification_metadata_list, notifications, es10b_notification_metadata_list_free_all)
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10b_notification_metadata_list, seqNumber, Seq)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notificationAddress, Address)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, iccid, Iccid)
\ No newline at end of file

From 5ab07d626276e6381e4ce48ad70449d8d2a77b36 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 3 Sep 2024 21:45:50 -0400
Subject: [PATCH 124/458] README: Mention more clearly it's GNU GPL v3

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 24f4c9f47..f8019b2ac 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,10 @@ There are two variants of this project:
   - Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases)
   - For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`
 
+__This project is Free Software licensed under GNU GPL v3, WITHOUT the "or later" clause.__ Any modification and derivative work __MUST__ be released under the SAME license, which means, at the very least, that the source code __MUST__ be available upon request.
+
+__If you are releasing a modification of this app, you are kindly asked to make changes to at least the app name and package name.__  
+
 Building (Gradle)
 ===
 

From b101b01228231714e298e09a293a91b99892a6cd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 15:51:37 -0400
Subject: [PATCH 125/458] chore: Bump all subproject compileSdks

...yes, we'll probably need to bump these again very soon.
---
 app-deps/build.gradle.kts      | 2 +-
 libs/lpac-jni/build.gradle.kts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/app-deps/build.gradle.kts b/app-deps/build.gradle.kts
index 21114360d..6cde72d6d 100644
--- a/app-deps/build.gradle.kts
+++ b/app-deps/build.gradle.kts
@@ -13,7 +13,7 @@ apply {
 
 android {
     namespace = "im.angry.openeuicc_deps"
-    compileSdk = 33
+    compileSdk = 34
 
     defaultConfig {
         minSdk = 28
diff --git a/libs/lpac-jni/build.gradle.kts b/libs/lpac-jni/build.gradle.kts
index b50a9534b..7f451776c 100644
--- a/libs/lpac-jni/build.gradle.kts
+++ b/libs/lpac-jni/build.gradle.kts
@@ -5,7 +5,7 @@ plugins {
 
 android {
     namespace = "net.typeblog.lpac_jni"
-    compileSdk = 33
+    compileSdk = 34
     ndkVersion = "26.1.10909125"
 
     defaultConfig {

From 0afbece3b5b5551fc1735a79c72527ce2b565c33 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 15:53:11 -0400
Subject: [PATCH 126/458] .idea: Whatever updates Android Studio wants

---
 .idea/deploymentTargetSelector.xml | 10 ++++++++++
 .idea/gradle.xml                   | 16 +++++++++++++---
 .idea/migrations.xml               | 10 ++++++++++
 3 files changed, 33 insertions(+), 3 deletions(-)
 create mode 100644 .idea/deploymentTargetSelector.xml
 create mode 100644 .idea/migrations.xml

diff --git a/.idea/deploymentTargetSelector.xml b/.idea/deploymentTargetSelector.xml
new file mode 100644
index 000000000..913d49d95
--- /dev/null
+++ b/.idea/deploymentTargetSelector.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="deploymentTargetSelector">
+    <selectionStates>
+      <SelectionState runConfigName="app-unpriv">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+    </selectionStates>
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/gradle.xml b/.idea/gradle.xml
index 163d6b486..589fc6ca9 100644
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@@ -4,11 +4,20 @@
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>
-        <option name="testRunner" value="GRADLE" />
-        <option name="distributionType" value="DEFAULT_WRAPPED" />
+        <compositeConfiguration>
+          <compositeBuild compositeDefinitionSource="SCRIPT">
+            <builds>
+              <build path="$PROJECT_DIR$/buildSrc" name="buildSrc">
+                <projects>
+                  <project path="$PROJECT_DIR$/buildSrc" />
+                </projects>
+              </build>
+            </builds>
+          </compositeBuild>
+        </compositeConfiguration>
         <option name="externalProjectPath" value="$PROJECT_DIR$" />
         <option name="gradleHome" value="/usr/share/java/gradle" />
-        <option name="gradleJvm" value="jbr-17" />
+        <option name="gradleJvm" value="#GRADLE_LOCAL_JAVA_HOME" />
         <option name="modules">
           <set>
             <option value="$PROJECT_DIR$" />
@@ -23,6 +32,7 @@
             <option value="$PROJECT_DIR$/libs/lpac-jni" />
           </set>
         </option>
+        <option name="resolveExternalAnnotations" value="false" />
       </GradleProjectSettings>
     </option>
   </component>
diff --git a/.idea/migrations.xml b/.idea/migrations.xml
new file mode 100644
index 000000000..f8051a6f9
--- /dev/null
+++ b/.idea/migrations.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectMigrations">
+    <option name="MigrateToGradleLocalJavaHome">
+      <set>
+        <option value="$PROJECT_DIR$" />
+      </set>
+    </option>
+  </component>
+</project>
\ No newline at end of file

From c681e99e4762be890b81fb419b799aca3c935d12 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 16:02:28 -0400
Subject: [PATCH 127/458] refactor: lpac-jni: Move profiles linked list to
 Kotlin handling too

---
 .../java/net/typeblog/lpac_jni/LpacJni.kt     |  12 +-
 .../impl/LocalProfileAssistantImpl.kt         |  23 +++-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.c | 121 +++++-------------
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.h |   8 +-
 .../main/jni/lpac-jni/lpac-notifications.c    |   6 +-
 5 files changed, 70 insertions(+), 100 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 37406a74c..d4ea8b22c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -14,7 +14,7 @@ internal object LpacJni {
     // es10c
     // null returns signify errors
     external fun es10cGetEid(handle: Long): String?
-    external fun es10cGetProfilesInfo(handle: Long): Array<LocalProfileInfo>?
+    external fun es10cGetProfilesInfo(handle: Long): Long
     external fun es10cEnableProfile(handle: Long, iccid: String, refresh: Boolean): Int
     external fun es10cDisableProfile(handle: Long, iccid: String, refresh: Boolean): Int
     external fun es10cDeleteProfile(handle: Long, iccid: String): Int
@@ -34,6 +34,16 @@ internal object LpacJni {
     external fun es10cexGetEuiccInfo2(handle: Long): EuiccInfo2?
 
     // C <-> Java struct / linked list handling
+    // Profiles
+    external fun profilesNext(curr: Long): Long
+    external fun profilesFree(head: Long): Long
+    external fun profileGetIccid(curr: Long): String
+    external fun profileGetIsdpAid(curr: Long): String
+    external fun profileGetName(curr: Long): String
+    external fun profileGetNickname(curr: Long): String
+    external fun profileGetServiceProvider(curr: Long): String
+    external fun profileGetStateString(curr: Long): String
+    external fun profileGetClassString(curr: Long): String
     // Notifications
     external fun notificationsNext(curr: Long): Long
     external fun notificationGetSeq(curr: Long): Long
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 0b03b6470..4515ea600 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -42,7 +42,28 @@ class LocalProfileAssistantImpl(
         }
 
     override val profiles: List<LocalProfileInfo>
-        get() = LpacJni.es10cGetProfilesInfo(contextHandle)?.asList() ?: listOf()
+        get() {
+            val head = LpacJni.es10cGetProfilesInfo(contextHandle)
+            var curr = head
+            val ret = mutableListOf<LocalProfileInfo>()
+            while (curr != 0L) {
+                val state = LocalProfileInfo.State.fromString(LpacJni.profileGetStateString(curr))
+                val clazz = LocalProfileInfo.Clazz.fromString(LpacJni.profileGetClassString(curr))
+                ret.add(LocalProfileInfo(
+                    LpacJni.profileGetIccid(curr),
+                    state,
+                    LpacJni.profileGetName(curr),
+                    LpacJni.profileGetNickname(curr),
+                    LpacJni.profileGetServiceProvider(curr),
+                    LpacJni.profileGetIsdpAid(curr),
+                    clazz
+                ))
+                curr = LpacJni.profilesNext(curr)
+            }
+
+            LpacJni.profilesFree(curr)
+            return ret
+        }
 
     override val notifications: List<LocalProfileNotification>
         get() {
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 561e0278a..5dcddce3f 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -12,15 +12,6 @@
 
 JavaVM *jvm = NULL;
 
-jclass local_profile_info_class;
-jmethodID local_profile_info_constructor;
-
-jclass local_profile_state_class;
-jmethodID local_profile_state_from_string;
-
-jclass local_profile_class_class;
-jmethodID local_profile_class_from_string;
-
 jstring empty_string;
 
 jclass string_class;
@@ -40,25 +31,6 @@ jint JNI_OnLoad(JavaVM *vm, void *reserved) {
     string_constructor = (*env)->GetMethodID(env, string_class, "<init>",
                                              "([BLjava/lang/String;)V");
 
-    local_profile_info_class = (*env)->FindClass(env, "net/typeblog/lpac_jni/LocalProfileInfo");
-    local_profile_info_class = (*env)->NewGlobalRef(env, local_profile_info_class);
-    local_profile_info_constructor = (*env)->GetMethodID(env, local_profile_info_class, "<init>",
-                                                         "(Ljava/lang/String;Lnet/typeblog/lpac_jni/LocalProfileInfo$State;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lnet/typeblog/lpac_jni/LocalProfileInfo$Clazz;)V");
-
-    local_profile_state_class = (*env)->FindClass(env,
-                                                  "net/typeblog/lpac_jni/LocalProfileInfo$State");
-    local_profile_state_class = (*env)->NewGlobalRef(env, local_profile_state_class);
-    local_profile_state_from_string = (*env)->GetStaticMethodID(env, local_profile_state_class,
-                                                                "fromString",
-                                                                "(Ljava/lang/String;)Lnet/typeblog/lpac_jni/LocalProfileInfo$State;");
-
-    local_profile_class_class = (*env)->FindClass(env,
-                                                  "net/typeblog/lpac_jni/LocalProfileInfo$Clazz");
-    local_profile_class_class = (*env)->NewGlobalRef(env, local_profile_class_class);
-    local_profile_class_from_string = (*env)->GetStaticMethodID(env, local_profile_class_class,
-                                                                "fromString",
-                                                                "(Ljava/lang/String;)Lnet/typeblog/lpac_jni/LocalProfileInfo$Clazz;");
-
     euicc_info2_class = (*env)->FindClass(env, "net/typeblog/lpac_jni/EuiccInfo2");
     euicc_info2_class = (*env)->NewGlobalRef(env, euicc_info2_class);
     euicc_info2_constructor = (*env)->GetMethodID(env, euicc_info2_class, "<init>",
@@ -144,25 +116,23 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cGetEid(JNIEnv *env, jobject thiz, jlong
     return ret;
 }
 
-jobject profile_info_native_to_java(JNIEnv *env, struct es10c_profile_info_list *info) {
+JNIEXPORT jlong JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_es10cGetProfilesInfo(JNIEnv *env, jobject thiz, jlong handle) {
+    struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
+    struct es10c_profile_info_list *info = NULL;
+
+    if (es10c_get_profiles_info(ctx, &info) < 0) {
+        return 0;
+    }
+
+    return (jlong) info;
+}
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_profileGetStateString(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10c_profile_info_list *info = (struct es10c_profile_info_list *) curr;
     const char *profileStateStr = NULL;
-    const char *profileClassStr = NULL;
-    jstring serviceProvider = NULL;
-    jstring nickName = NULL;
-    jstring isdpAid = NULL;
-    jstring iccid = NULL;
-    jstring name = NULL;
-    jobject state = NULL;
-    jobject class = NULL;
-    jobject jinfo = NULL;
 
-    iccid = toJString(env, info->iccid);
-    isdpAid = toJString(env, info->isdpAid);
-    name = toJString(env, info->profileName);
-    nickName = toJString(env, info->profileNickname);
-    serviceProvider = toJString(env, info->serviceProviderName);
-
-    // TODO: Maybe we should pass a Java object directly here?
     switch (info->profileState) {
         case ES10C_PROFILE_STATE_ENABLED:
             profileStateStr = "enabled";
@@ -174,9 +144,13 @@ jobject profile_info_native_to_java(JNIEnv *env, struct es10c_profile_info_list
             profileStateStr = "unknown";
     }
 
-    state = (*env)->CallStaticObjectMethod(env, local_profile_state_class,
-                                           local_profile_state_from_string,
-                                           toJString(env, profileStateStr));
+    return toJString(env, profileStateStr);
+}
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_profileGetClassString(JNIEnv *env, jobject thiz, jlong curr) {
+    struct es10c_profile_info_list *info = (struct es10c_profile_info_list *) curr;
+    const char *profileClassStr = NULL;
 
     switch (info->profileClass) {
         case ES10C_PROFILE_CLASS_TEST:
@@ -193,51 +167,16 @@ jobject profile_info_native_to_java(JNIEnv *env, struct es10c_profile_info_list
             break;
     }
 
-    class = (*env)->CallStaticObjectMethod(env, local_profile_class_class,
-                                           local_profile_class_from_string,
-                                           toJString(env, profileClassStr));
-
-    jinfo = (*env)->NewObject(env, local_profile_info_class, local_profile_info_constructor,
-                              iccid, state, name, nickName, serviceProvider, isdpAid, class);
-
-    (*env)->DeleteLocalRef(env, class);
-    (*env)->DeleteLocalRef(env, state);
-    (*env)->DeleteLocalRef(env, serviceProvider);
-    (*env)->DeleteLocalRef(env, nickName);
-    (*env)->DeleteLocalRef(env, name);
-    (*env)->DeleteLocalRef(env, isdpAid);
-    (*env)->DeleteLocalRef(env, iccid);
-
-    return jinfo;
+    return toJString(env, profileClassStr);
 }
 
-JNIEXPORT jobjectArray JNICALL
-Java_net_typeblog_lpac_1jni_LpacJni_es10cGetProfilesInfo(JNIEnv *env, jobject thiz, jlong handle) {
-    struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
-    struct es10c_profile_info_list *info = NULL;
-    struct es10c_profile_info_list *curr = NULL;
-    jobjectArray ret = NULL;
-    jobject jinfo = NULL;
-    int count = 0;
-
-    if (es10c_get_profiles_info(ctx, &info) < 0) {
-        return NULL;
-    }
-
-    count = LPAC_JNI_LINKED_LIST_COUNT(info, curr);
-
-    ret = (*env)->NewObjectArray(env, count, local_profile_info_class, NULL);
-
-    // Convert the native info array to Java
-    LPAC_JNI_LINKED_LIST_FOREACH(info, curr, {
-        jinfo = profile_info_native_to_java(env, curr);
-        (*env)->SetObjectArrayElement(env, ret, i, jinfo);
-        (*env)->DeleteLocalRef(env, jinfo);
-    });
-
-    es10c_profile_info_list_free_all(info);
-    return ret;
-}
+LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(struct es10c_profile_info_list, profiles)
+LPAC_JNI_STRUCT_LINKED_LIST_FREE(struct es10c_profile_info_list, profiles, es10c_profile_info_list_free_all)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, iccid, Iccid)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, isdpAid, IsdpAid)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, profileName, Name)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, profileNickname, Nickname)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, serviceProviderName, ServiceProvider)
 
 JNIEXPORT jint JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10cEnableProfile(JNIEnv *env, jobject thiz, jlong handle,
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
index 4d537ee50..d185551d9 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
@@ -66,15 +66,15 @@ jstring toJString(JNIEnv *env, const char *pat);
             free_func(p);                             \
         }
 
-#define LPAC_JNI_STRUCT_GETTER_LONG(st, name, jname) \
-        JNIEXPORT jlong JNICALL Java_net_typeblog_lpac_1jni_LpacJni_notificationGet##jname(JNIEnv *env, jobject thiz, jlong raw) { \
+#define LPAC_JNI_STRUCT_GETTER_LONG(st, st_name, name, jname) \
+        JNIEXPORT jlong JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_name##Get##jname(JNIEnv *env, jobject thiz, jlong raw) { \
             st *p = (st *) raw;                       \
             if (p == NULL) return 0;                  \
             return (jlong) p->name;                   \
         }
 
-#define LPAC_JNI_STRUCT_GETTER_STRING(st, name, jname) \
-        JNIEXPORT jstring JNICALL Java_net_typeblog_lpac_1jni_LpacJni_notificationGet##jname(JNIEnv *env, jobject thiz, jlong raw) { \
+#define LPAC_JNI_STRUCT_GETTER_STRING(st, st_name, name, jname) \
+        JNIEXPORT jstring JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_name##Get##jname(JNIEnv *env, jobject thiz, jlong raw) { \
             st *p = (st *) raw;                       \
             return toJString(env, p->name);           \
         }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
index bd4dffda1..b2c48258a 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
@@ -74,6 +74,6 @@ Java_net_typeblog_lpac_1jni_LpacJni_notificationGetOperationString(JNIEnv *env,
 
 LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(struct es10b_notification_metadata_list, notifications)
 LPAC_JNI_STRUCT_LINKED_LIST_FREE(struct es10b_notification_metadata_list, notifications, es10b_notification_metadata_list_free_all)
-LPAC_JNI_STRUCT_GETTER_LONG(struct es10b_notification_metadata_list, seqNumber, Seq)
-LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notificationAddress, Address)
-LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, iccid, Iccid)
\ No newline at end of file
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10b_notification_metadata_list, notification, seqNumber, Seq)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notification, notificationAddress, Address)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notification, iccid, Iccid)

From a43ceea39f09867be95d8e0828fff0a25b602197 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 16:26:33 -0400
Subject: [PATCH 128/458] lpac-jni: linked list free -> struct free

---
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c           | 2 +-
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h           | 2 +-
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 5dcddce3f..c4ca95cb1 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -171,7 +171,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_profileGetClassString(JNIEnv *env, jobject t
 }
 
 LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(struct es10c_profile_info_list, profiles)
-LPAC_JNI_STRUCT_LINKED_LIST_FREE(struct es10c_profile_info_list, profiles, es10c_profile_info_list_free_all)
+LPAC_JNI_STRUCT_FREE(struct es10c_profile_info_list, profiles, es10c_profile_info_list_free_all)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, iccid, Iccid)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, isdpAid, IsdpAid)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_profile_info_list, profile, profileName, Name)
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
index d185551d9..87b07169e 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
@@ -59,7 +59,7 @@ jstring toJString(JNIEnv *env, const char *pat);
             return (jlong) p->next;                   \
         }
 
-#define LPAC_JNI_STRUCT_LINKED_LIST_FREE(st, st_jname, free_func) \
+#define LPAC_JNI_STRUCT_FREE(st, st_jname, free_func) \
         JNIEXPORT void JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_jname##Free(JNIEnv *env, jobject thiz, jlong raw) { \
             st *p = (st *) raw;                       \
             if (p == NULL) return;                    \
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
index b2c48258a..cf402cf82 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-notifications.c
@@ -73,7 +73,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_notificationGetOperationString(JNIEnv *env,
 }
 
 LPAC_JNI_STRUCT_GETTER_LINKED_LIST_NEXT(struct es10b_notification_metadata_list, notifications)
-LPAC_JNI_STRUCT_LINKED_LIST_FREE(struct es10b_notification_metadata_list, notifications, es10b_notification_metadata_list_free_all)
+LPAC_JNI_STRUCT_FREE(struct es10b_notification_metadata_list, notifications, es10b_notification_metadata_list_free_all)
 LPAC_JNI_STRUCT_GETTER_LONG(struct es10b_notification_metadata_list, notification, seqNumber, Seq)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notification, notificationAddress, Address)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10b_notification_metadata_list, notification, iccid, Iccid)

From bf361882195d003b1b143d1d65f0f45c3237acbe Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 20:32:27 -0400
Subject: [PATCH 129/458] refactor: lpac-jni: Move EuiccInfo2 handling to
 Kotlin too

---
 .../java/net/typeblog/lpac_jni/LpacJni.kt     | 17 +++-
 .../impl/LocalProfileAssistantImpl.kt         | 31 ++++++-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.c | 82 ++++++-------------
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.h | 38 ++-------
 4 files changed, 81 insertions(+), 87 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index d4ea8b22c..32fbb0aac 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -31,9 +31,12 @@ internal object LpacJni {
     external fun handleNotification(handle: Long, seqNumber: Long): Int
 
     // es10cex (actually part of es10b)
-    external fun es10cexGetEuiccInfo2(handle: Long): EuiccInfo2?
+    external fun es10cexGetEuiccInfo2(handle: Long): Long
 
     // C <-> Java struct / linked list handling
+    // C String arrays
+    external fun stringArrNext(curr: Long): Long
+    external fun stringDeref(curr: Long): String
     // Profiles
     external fun profilesNext(curr: Long): Long
     external fun profilesFree(head: Long): Long
@@ -51,4 +54,16 @@ internal object LpacJni {
     external fun notificationGetAddress(curr: Long): String
     external fun notificationGetIccid(curr: Long): String
     external fun notificationsFree(head: Long)
+    // EuiccInfo2
+    external fun euiccInfo2Free(info: Long)
+    external fun euiccInfo2GetProfileVersion(info: Long): String
+    external fun euiccInfo2GetEuiccFirmwareVersion(info: Long): String
+    external fun euiccInfo2GetGlobalPlatformVersion(info: Long): String
+    external fun euiccInfo2GetSasAcreditationNumber(info: Long): String
+    external fun euiccInfo2GetPpVersion(info: Long): String
+    external fun euiccInfo2GetFreeNonVolatileMemory(info: Long): Long
+    external fun euiccInfo2GetFreeVolatileMemory(info: Long): Long
+    // C String Arrays
+    external fun euiccInfo2GetEuiccCiPKIdListForSigning(info: Long): Long
+    external fun euiccInfo2GetEuiccCiPKIdListForVerification(info: Long): Long
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 4515ea600..08748d39c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -87,7 +87,36 @@ class LocalProfileAssistantImpl(
         get() = LpacJni.es10cGetEid(contextHandle)!!
 
     override val euiccInfo2: EuiccInfo2?
-        get() = LpacJni.es10cexGetEuiccInfo2(contextHandle)
+        get() {
+            val cInfo = LpacJni.es10cexGetEuiccInfo2(contextHandle)
+            if (cInfo == 0L) return null
+
+            val euiccCiPKIdListForSigning = mutableListOf<String>()
+            var curr = LpacJni.euiccInfo2GetEuiccCiPKIdListForSigning(cInfo)
+            while (curr != 0L) {
+                euiccCiPKIdListForSigning.add(LpacJni.stringDeref(curr))
+                curr = LpacJni.stringArrNext(curr)
+            }
+
+            val euiccCiPKIdListForVerification = mutableListOf<String>()
+            curr = LpacJni.euiccInfo2GetEuiccCiPKIdListForVerification(cInfo)
+            while (curr != 0L) {
+                euiccCiPKIdListForVerification.add(LpacJni.stringDeref(curr))
+                curr = LpacJni.stringArrNext(curr)
+            }
+
+            return EuiccInfo2(
+                LpacJni.euiccInfo2GetProfileVersion(cInfo),
+                LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo),
+                LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo),
+                LpacJni.euiccInfo2GetSasAcreditationNumber(cInfo),
+                LpacJni.euiccInfo2GetPpVersion(cInfo),
+                LpacJni.euiccInfo2GetFreeNonVolatileMemory(cInfo).toInt(),
+                LpacJni.euiccInfo2GetFreeVolatileMemory(cInfo).toInt(),
+                euiccCiPKIdListForSigning.toTypedArray(),
+                euiccCiPKIdListForVerification.toTypedArray()
+            )
+        }
 
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
         LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index c4ca95cb1..1721b7728 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -17,9 +17,6 @@ jstring empty_string;
 jclass string_class;
 jmethodID string_constructor;
 
-jclass euicc_info2_class;
-jmethodID euicc_info2_constructor;
-
 jint JNI_OnLoad(JavaVM *vm, void *reserved) {
     jvm = vm;
     interface_wrapper_init();
@@ -31,11 +28,6 @@ jint JNI_OnLoad(JavaVM *vm, void *reserved) {
     string_constructor = (*env)->GetMethodID(env, string_class, "<init>",
                                              "([BLjava/lang/String;)V");
 
-    euicc_info2_class = (*env)->FindClass(env, "net/typeblog/lpac_jni/EuiccInfo2");
-    euicc_info2_class = (*env)->NewGlobalRef(env, euicc_info2_class);
-    euicc_info2_constructor = (*env)->GetMethodID(env, euicc_info2_class, "<init>",
-                                                  "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;II[Ljava/lang/String;[Ljava/lang/String;)V");
-
     const char _unused[1];
     empty_string = (*env)->NewString(env, _unused, 0);
     empty_string = (*env)->NewGlobalRef(env, empty_string);
@@ -233,58 +225,38 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cDeleteProfile(JNIEnv *env, jobject thiz
     return ret;
 }
 
-JNIEXPORT jobject JNICALL
+JNIEXPORT jlong JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10cexGetEuiccInfo2(JNIEnv *env, jobject thiz, jlong handle) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
-    struct es10c_ex_euiccinfo2 info = {0};
-    jobjectArray euiccCiPKIdListForVerification = NULL;
-    jobjectArray euiccCiPKIdListForSigning = NULL;
-    jstring sas_accreditation_number = NULL;
-    jstring global_platform_version = NULL;
-    jstring euicc_firmware_version = NULL;
-    jstring profile_version = NULL;
-    jstring pp_version = NULL;
-    jobject ret = NULL;
-    char **curr = NULL;
-    int count = 0;
+    struct es10c_ex_euiccinfo2 *info = malloc(sizeof(struct es10c_ex_euiccinfo2));
 
-    if (es10c_ex_get_euiccinfo2(ctx, &info) < 0)
-        goto out;
+    if (es10c_ex_get_euiccinfo2(ctx, info) < 0) {
+        free(info);
+        return 0;
+    }
 
-    profile_version = toJString(env, info.profileVersion);
-    euicc_firmware_version = toJString(env, info.euiccFirmwareVer);
-    global_platform_version = toJString(env, info.globalplatformVersion);
-    sas_accreditation_number = toJString(env, info.sasAcreditationNumber);
-    pp_version = toJString(env, info.ppVersion);
+    return (jlong) info;
+}
 
-    count = LPAC_JNI_NULL_TERM_LIST_COUNT(info.euiccCiPKIdListForSigning, curr);
-    euiccCiPKIdListForSigning = (*env)->NewObjectArray(env, count, string_class, NULL);
-    LPAC_JNI_NULL_TERM_LIST_FOREACH(info.euiccCiPKIdListForSigning, curr, {
-        (*env)->SetObjectArrayElement(env, euiccCiPKIdListForSigning, i, toJString(env, *curr));
-    });
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_stringDeref(JNIEnv *env, jobject thiz, jlong curr) {
+    return toJString(env, *((char **) curr));
+}
 
-    count = LPAC_JNI_NULL_TERM_LIST_COUNT(info.euiccCiPKIdListForVerification, curr);
-    euiccCiPKIdListForVerification = (*env)->NewObjectArray(env, count, string_class, NULL);
-    LPAC_JNI_NULL_TERM_LIST_FOREACH(info.euiccCiPKIdListForVerification, curr, {
-        (*env)->SetObjectArrayElement(env, euiccCiPKIdListForVerification, i,
-                                      toJString(env, *curr));
-    });
+void lpac_jni_euiccinfo2_free(struct es10c_ex_euiccinfo2 *info) {
+    es10c_ex_euiccinfo2_free(info);
+    free(info);
+}
 
-    ret = (*env)->NewObject(env, euicc_info2_class, euicc_info2_constructor,
-                            profile_version, euicc_firmware_version,
-                            global_platform_version,
-                            sas_accreditation_number, pp_version,
-                            info.extCardResource.freeNonVolatileMemory,
-                            info.extCardResource.freeVolatileMemory,
-                            euiccCiPKIdListForSigning,
-                            euiccCiPKIdListForVerification);
+LPAC_JNI_STRUCT_GETTER_NULL_TERM_LIST_NEXT(char*, stringArr)
+LPAC_JNI_STRUCT_FREE(struct es10c_ex_euiccinfo2, euiccInfo2, lpac_jni_euiccinfo2_free)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, profileVersion, ProfileVersion)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, euiccFirmwareVer, EuiccFirmwareVersion)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, globalplatformVersion, GlobalPlatformVersion)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, sasAcreditationNumber, SasAcreditationNumber)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, ppVersion, PpVersion)
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10c_ex_euiccinfo2, euiccInfo2, extCardResource.freeNonVolatileMemory, FreeNonVolatileMemory)
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10c_ex_euiccinfo2, euiccInfo2, extCardResource.freeVolatileMemory, FreeVolatileMemory)
 
-    out:
-    (*env)->DeleteLocalRef(env, profile_version);
-    (*env)->DeleteLocalRef(env, euicc_firmware_version);
-    (*env)->DeleteLocalRef(env, global_platform_version);
-    (*env)->DeleteLocalRef(env, sas_accreditation_number);
-    (*env)->DeleteLocalRef(env, pp_version);
-    es10c_ex_euiccinfo2_free(&info);
-    return ret;
-}
\ No newline at end of file
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10c_ex_euiccinfo2, euiccInfo2, euiccCiPKIdListForSigning, EuiccCiPKIdListForSigning)
+LPAC_JNI_STRUCT_GETTER_LONG(struct es10c_ex_euiccinfo2, euiccInfo2, euiccCiPKIdListForVerification, EuiccCiPKIdListForVerification)
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
index 87b07169e..a5d6262d6 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
@@ -17,36 +17,6 @@ struct lpac_jni_ctx {
     JNIEnv *env; \
     (*jvm)->AttachCurrentThread(jvm, &env, NULL)
 
-#define __LPAC_JNI_LINKED_LIST_FOREACH(list, curr, body, after) { \
-    int i = 0;                                                    \
-    curr = list;                                                  \
-    while (curr != NULL) {                                        \
-        body;                                                     \
-        curr = curr->next;                                        \
-        i++;                                                      \
-    };                                                             \
-    after;                                                        \
-}
-#define LPAC_JNI_LINKED_LIST_FOREACH(list, curr, body) \
-    __LPAC_JNI_LINKED_LIST_FOREACH(list, curr, body, {})
-#define LPAC_JNI_LINKED_LIST_COUNT(list, curr) \
-    (__LPAC_JNI_LINKED_LIST_FOREACH(list, curr, {}, i))
-
-#define __LPAC_JNI_NULL_TERM_LIST_FOREACH(list, curr, body, after) { \
-    int i = 0;                                                       \
-    curr = list;                                                     \
-    while (*curr != NULL) {                                           \
-        body;                                                        \
-        curr++;                                                      \
-        i++;                                                         \
-    };                                                               \
-    after;                                                           \
-}
-#define LPAC_JNI_NULL_TERM_LIST_FOREACH(list, curr, body) \
-    __LPAC_JNI_NULL_TERM_LIST_FOREACH(list, curr, body, {})
-#define LPAC_JNI_NULL_TERM_LIST_COUNT(list, curr) \
-    (__LPAC_JNI_NULL_TERM_LIST_FOREACH(list, curr, {}, i))
-
 extern JavaVM *jvm;
 extern jclass string_class;
 
@@ -59,6 +29,14 @@ jstring toJString(JNIEnv *env, const char *pat);
             return (jlong) p->next;                   \
         }
 
+#define LPAC_JNI_STRUCT_GETTER_NULL_TERM_LIST_NEXT(st, st_jname) \
+        JNIEXPORT jlong JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_jname##Next(JNIEnv *env, jobject thiz, jlong raw) { \
+            st *p = (st *) raw;                     \
+            p++;                                      \
+            if (*p == NULL) return 0;                 \
+            return (jlong) p;                         \
+        }
+
 #define LPAC_JNI_STRUCT_FREE(st, st_jname, free_func) \
         JNIEXPORT void JNICALL Java_net_typeblog_lpac_1jni_LpacJni_##st_jname##Free(JNIEnv *env, jobject thiz, jlong raw) { \
             st *p = (st *) raw;                       \

From 68f1e370fc1b277b9a00b0a266374e24d227bb37 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Sep 2024 20:35:13 -0400
Subject: [PATCH 130/458] lpac-jni: Make sure to free EuiccInfo2

---
 .../net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 08748d39c..61491d793 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -105,7 +105,7 @@ class LocalProfileAssistantImpl(
                 curr = LpacJni.stringArrNext(curr)
             }
 
-            return EuiccInfo2(
+            val ret = EuiccInfo2(
                 LpacJni.euiccInfo2GetProfileVersion(cInfo),
                 LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo),
                 LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo),
@@ -116,6 +116,10 @@ class LocalProfileAssistantImpl(
                 euiccCiPKIdListForSigning.toTypedArray(),
                 euiccCiPKIdListForVerification.toTypedArray()
             )
+
+            LpacJni.euiccInfo2Free(cInfo)
+
+            return ret
         }
 
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =

From 97bc0a08273ffdd982e1b292bf98e446521964c3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 24 Sep 2024 22:22:18 -0400
Subject: [PATCH 131/458] chore: uprev to targetSDK 35 and basic edge2edge
 inset fixes

---
 .idea/deploymentTargetSelector.xml            |  3 ++
 app-common/build.gradle.kts                   |  2 +-
 .../im/angry/openeuicc/ui/LogsActivity.kt     |  3 ++
 .../im/angry/openeuicc/ui/MainActivity.kt     |  3 ++
 .../openeuicc/ui/NotificationsActivity.kt     |  3 ++
 .../im/angry/openeuicc/ui/SettingsActivity.kt |  4 +++
 .../java/im/angry/openeuicc/util/UiUtils.kt   | 30 +++++++++++++++++++
 .../src/main/res/layout/activity_logs.xml     |  9 ++++++
 .../src/main/res/layout/activity_main.xml     |  9 ++++++
 .../res/layout/activity_notifications.xml     |  9 ++++++
 .../src/main/res/layout/activity_settings.xml |  9 ++++++
 app-unpriv/build.gradle.kts                   |  4 +--
 .../ui/CompatibilityCheckActivity.kt          |  3 ++
 .../layout/activity_compatibility_check.xml   |  9 ++++++
 app/build.gradle.kts                          |  4 +--
 .../java/im/angry/openeuicc/ui/LuiActivity.kt | 14 +++++++++
 app/src/main/res/layout/activity_lui.xml      |  1 +
 libs/lpac-jni/build.gradle.kts                |  2 +-
 18 files changed, 115 insertions(+), 6 deletions(-)

diff --git a/.idea/deploymentTargetSelector.xml b/.idea/deploymentTargetSelector.xml
index 913d49d95..8096d6c0d 100644
--- a/.idea/deploymentTargetSelector.xml
+++ b/.idea/deploymentTargetSelector.xml
@@ -5,6 +5,9 @@
       <SelectionState runConfigName="app-unpriv">
         <option name="selectionMode" value="DROPDOWN" />
       </SelectionState>
+      <SelectionState runConfigName="app">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
     </selectionStates>
   </component>
 </project>
\ No newline at end of file
diff --git a/app-common/build.gradle.kts b/app-common/build.gradle.kts
index 5af17991f..d74fcecb8 100644
--- a/app-common/build.gradle.kts
+++ b/app-common/build.gradle.kts
@@ -5,7 +5,7 @@ plugins {
 
 android {
     namespace = "im.angry.openeuicc.common"
-    compileSdk = 34
+    compileSdk = 35
 
     defaultConfig {
         minSdk = 28
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 2b3646838..558e69ad1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -7,6 +7,7 @@ import android.view.MenuItem
 import android.view.View
 import android.widget.ScrollView
 import android.widget.TextView
+import androidx.activity.enableEdgeToEdge
 import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
@@ -37,9 +38,11 @@ class LogsActivity : AppCompatActivity() {
         }
 
     override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_logs)
         setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
         swipeRefresh = requireViewById(R.id.swipe_refresh)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 0f504ebbc..183bbbd93 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -13,6 +13,7 @@ import android.view.Menu
 import android.view.MenuItem
 import android.view.View
 import android.widget.ProgressBar
+import androidx.activity.enableEdgeToEdge
 import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
 import androidx.viewpager2.adapter.FragmentStateAdapter
@@ -64,9 +65,11 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     @SuppressLint("WrongConstant", "UnspecifiedRegisterReceiverFlag")
     override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
         setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
         loadingProgress = requireViewById(R.id.loading)
         tabs = requireViewById(R.id.main_tabs)
         viewPager = requireViewById(R.id.view_pager)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 59abbc563..dd14d8e64 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -11,6 +11,7 @@ import android.view.MenuItem.OnMenuItemClickListener
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
+import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AlertDialog
 import androidx.core.view.forEach
 import androidx.lifecycle.lifecycleScope
@@ -35,9 +36,11 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private lateinit var euiccChannel: EuiccChannel
 
     override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_notifications)
         setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
index 426c54677..52e327271 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
@@ -2,14 +2,18 @@ package im.angry.openeuicc.ui
 
 import android.os.Bundle
 import android.view.MenuItem
+import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
 
 class SettingsActivity: AppCompatActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_settings)
         setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
         supportFragmentManager.beginTransaction()
             .replace(R.id.settings_container, SettingsFragment())
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index 24c1ad811..6aa62c2eb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -2,8 +2,16 @@ package im.angry.openeuicc.util
 
 import android.content.res.Resources
 import android.graphics.Rect
+import android.view.View
 import android.view.ViewGroup
+import androidx.appcompat.app.AppCompatActivity
+import androidx.appcompat.widget.Toolbar
+import androidx.core.view.ViewCompat
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.updateLayoutParams
+import androidx.core.view.updatePadding
 import androidx.fragment.app.DialogFragment
+import im.angry.openeuicc.common.R
 
 // Source: <https://stackoverflow.com/questions/12478520/how-to-set-dialogfragments-width-and-height>
 /**
@@ -26,3 +34,25 @@ fun DialogFragment.setWidthPercent(percentage: Int) {
 fun DialogFragment.setFullScreen() {
     dialog?.window?.setLayout(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)
 }
+
+fun AppCompatActivity.setupToolbarInsets() {
+    val spacer = requireViewById<View>(R.id.toolbar_spacer)
+    ViewCompat.setOnApplyWindowInsetsListener(requireViewById(R.id.toolbar)) { v, insets ->
+        val bars = insets.getInsets(
+            WindowInsetsCompat.Type.systemBars()
+                    or WindowInsetsCompat.Type.displayCutout()
+        )
+
+        v.updateLayoutParams<ViewGroup.MarginLayoutParams> {
+            topMargin = bars.top
+        }
+        v.updatePadding(bars.left, v.paddingTop, bars.right, v.paddingBottom)
+
+        spacer.updateLayoutParams {
+            height = v.top
+        }
+
+        android.util.Log.d("aaa",  "${(v as Toolbar).minimumHeight}")
+        WindowInsetsCompat.CONSUMED
+    }
+}
diff --git a/app-common/src/main/res/layout/activity_logs.xml b/app-common/src/main/res/layout/activity_logs.xml
index c305d0a4b..8210d070d 100644
--- a/app-common/src/main/res/layout/activity_logs.xml
+++ b/app-common/src/main/res/layout/activity_logs.xml
@@ -5,6 +5,15 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
         android:layout_width="0dp"
diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index a61a368f7..d226180e4 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -5,6 +5,15 @@
     android:layout_width="match_parent"
     android:layout_height="match_parent">
 
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
         android:layout_width="0dp"
diff --git a/app-common/src/main/res/layout/activity_notifications.xml b/app-common/src/main/res/layout/activity_notifications.xml
index 0fcac24e9..0ad561e63 100644
--- a/app-common/src/main/res/layout/activity_notifications.xml
+++ b/app-common/src/main/res/layout/activity_notifications.xml
@@ -4,6 +4,15 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
         android:layout_width="0dp"
diff --git a/app-common/src/main/res/layout/activity_settings.xml b/app-common/src/main/res/layout/activity_settings.xml
index 8a0bd5f44..0e756ee67 100644
--- a/app-common/src/main/res/layout/activity_settings.xml
+++ b/app-common/src/main/res/layout/activity_settings.xml
@@ -4,6 +4,15 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
         android:layout_width="0dp"
diff --git a/app-unpriv/build.gradle.kts b/app-unpriv/build.gradle.kts
index f1aa79d54..66a60b4ba 100644
--- a/app-unpriv/build.gradle.kts
+++ b/app-unpriv/build.gradle.kts
@@ -17,13 +17,13 @@ apply {
 
 android {
     namespace = "im.angry.easyeuicc"
-    compileSdk = 34
+    compileSdk = 35
     ndkVersion = "26.1.10909125"
 
     defaultConfig {
         applicationId = "im.angry.easyeuicc"
         minSdk = 28
-        targetSdk = 34
+        targetSdk = 35
     }
 
     buildTypes {
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index b747befe3..5ff7b65b9 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -6,6 +6,7 @@ import android.view.MenuItem
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
+import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.children
 import androidx.lifecycle.lifecycleScope
@@ -22,9 +23,11 @@ class CompatibilityCheckActivity: AppCompatActivity() {
     private val adapter = CompatibilityChecksAdapter()
 
     override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_compatibility_check)
         setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
         compatibilityCheckList = requireViewById(R.id.recycler_view)
diff --git a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml b/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
index 2304c862f..c284f93ed 100644
--- a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
+++ b/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
@@ -4,6 +4,15 @@
     android:layout_width="match_parent"
     android:layout_height="match_parent">
 
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
     <com.google.android.material.appbar.MaterialToolbar
         android:id="@+id/toolbar"
         android:layout_width="0dp"
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 1d29729a7..b9c2100f8 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -12,12 +12,12 @@ apply {
 
 android {
     namespace = "im.angry.openeuicc"
-    compileSdk = 34
+    compileSdk = 35
 
     defaultConfig {
         applicationId = "im.angry.openeuicc"
         minSdk = 30
-        targetSdk = 34
+        targetSdk = 35
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
diff --git a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
index f12c9b4eb..d7ac213bd 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
@@ -2,14 +2,28 @@ package im.angry.openeuicc.ui
 
 import android.content.Intent
 import android.view.View
+import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
+import androidx.core.view.ViewCompat
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.updatePadding
 import im.angry.openeuicc.R
 
 class LuiActivity : AppCompatActivity() {
     override fun onStart() {
         super.onStart()
+        enableEdgeToEdge()
         setContentView(R.layout.activity_lui)
 
+        ViewCompat.setOnApplyWindowInsetsListener(requireViewById(R.id.lui_container)) { v, insets ->
+            val bars = insets.getInsets(
+                WindowInsetsCompat.Type.systemBars()
+                        or WindowInsetsCompat.Type.displayCutout()
+            )
+            v.updatePadding(bars.left, bars.top, bars.right, bars.bottom)
+            WindowInsetsCompat.CONSUMED
+        }
+
         requireViewById<View>(R.id.lui_skip).setOnClickListener { finish() }
         // TODO: Deactivate LuiActivity if there is no eSIM found.
         // TODO: Support pre-filled download info (from carrier apps); UX
diff --git a/app/src/main/res/layout/activity_lui.xml b/app/src/main/res/layout/activity_lui.xml
index ff4a3029c..b33115677 100644
--- a/app/src/main/res/layout/activity_lui.xml
+++ b/app/src/main/res/layout/activity_lui.xml
@@ -2,6 +2,7 @@
 <androidx.constraintlayout.widget.ConstraintLayout
     xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:id="@+id/lui_container"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:background="?attr/colorSurfaceVariant">
diff --git a/libs/lpac-jni/build.gradle.kts b/libs/lpac-jni/build.gradle.kts
index 7f451776c..ff34d56e7 100644
--- a/libs/lpac-jni/build.gradle.kts
+++ b/libs/lpac-jni/build.gradle.kts
@@ -5,7 +5,7 @@ plugins {
 
 android {
     namespace = "net.typeblog.lpac_jni"
-    compileSdk = 34
+    compileSdk = 35
     ndkVersion = "26.1.10909125"
 
     defaultConfig {

From 4a32f53c0661c91a86a094cf1b61a2eb64df769e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 10:28:24 -0400
Subject: [PATCH 132/458] Commonize activity toolbar layouts

---
 .../src/main/res/layout/activity_logs.xml     | 17 +-------------
 .../src/main/res/layout/activity_main.xml     | 17 +-------------
 .../res/layout/activity_notifications.xml     | 17 +-------------
 .../src/main/res/layout/activity_settings.xml | 17 +-------------
 .../src/main/res/layout/toolbar_activity.xml  | 22 +++++++++++++++++++
 .../layout/activity_compatibility_check.xml   | 17 +-------------
 6 files changed, 27 insertions(+), 80 deletions(-)
 create mode 100644 app-common/src/main/res/layout/toolbar_activity.xml

diff --git a/app-common/src/main/res/layout/activity_logs.xml b/app-common/src/main/res/layout/activity_logs.xml
index 8210d070d..b37328d9e 100644
--- a/app-common/src/main/res/layout/activity_logs.xml
+++ b/app-common/src/main/res/layout/activity_logs.xml
@@ -5,22 +5,7 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
-    <View
-        android:id="@+id/toolbar_spacer"
-        android:layout_width="match_parent"
-        android:layout_height="0dp"
-        android:background="?attr/colorSurfaceVariant"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/toolbar" />
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1" />
+    <include layout="@layout/toolbar_activity" />
 
     <androidx.swiperefreshlayout.widget.SwipeRefreshLayout
         android:id="@+id/swipe_refresh"
diff --git a/app-common/src/main/res/layout/activity_main.xml b/app-common/src/main/res/layout/activity_main.xml
index d226180e4..145fc0d63 100644
--- a/app-common/src/main/res/layout/activity_main.xml
+++ b/app-common/src/main/res/layout/activity_main.xml
@@ -5,22 +5,7 @@
     android:layout_width="match_parent"
     android:layout_height="match_parent">
 
-    <View
-        android:id="@+id/toolbar_spacer"
-        android:layout_width="match_parent"
-        android:layout_height="0dp"
-        android:background="?attr/colorSurfaceVariant"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/toolbar" />
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1" />
+    <include layout="@layout/toolbar_activity" />
 
     <com.google.android.material.tabs.TabLayout
         android:id="@+id/main_tabs"
diff --git a/app-common/src/main/res/layout/activity_notifications.xml b/app-common/src/main/res/layout/activity_notifications.xml
index 0ad561e63..8a8b00126 100644
--- a/app-common/src/main/res/layout/activity_notifications.xml
+++ b/app-common/src/main/res/layout/activity_notifications.xml
@@ -4,22 +4,7 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
-    <View
-        android:id="@+id/toolbar_spacer"
-        android:layout_width="match_parent"
-        android:layout_height="0dp"
-        android:background="?attr/colorSurfaceVariant"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/toolbar" />
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1" />
+    <include layout="@layout/toolbar_activity" />
 
     <androidx.swiperefreshlayout.widget.SwipeRefreshLayout
         android:id="@+id/swipe_refresh"
diff --git a/app-common/src/main/res/layout/activity_settings.xml b/app-common/src/main/res/layout/activity_settings.xml
index 0e756ee67..7e7c2b714 100644
--- a/app-common/src/main/res/layout/activity_settings.xml
+++ b/app-common/src/main/res/layout/activity_settings.xml
@@ -4,22 +4,7 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
-    <View
-        android:id="@+id/toolbar_spacer"
-        android:layout_width="match_parent"
-        android:layout_height="0dp"
-        android:background="?attr/colorSurfaceVariant"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/toolbar" />
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1" />
+    <include layout="@layout/toolbar_activity" />
 
     <FrameLayout
         android:id="@+id/settings_container"
diff --git a/app-common/src/main/res/layout/toolbar_activity.xml b/app-common/src/main/res/layout/toolbar_activity.xml
new file mode 100644
index 000000000..b5c9cd598
--- /dev/null
+++ b/app-common/src/main/res/layout/toolbar_activity.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merge xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <View
+        android:id="@+id/toolbar_spacer"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:background="?attr/colorSurfaceVariant"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/toolbar" />
+
+    <com.google.android.material.appbar.MaterialToolbar
+        android:id="@+id/toolbar"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintWidth_percent="1" />
+
+</merge>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml b/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
index c284f93ed..4d622e391 100644
--- a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
+++ b/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
@@ -4,22 +4,7 @@
     android:layout_width="match_parent"
     android:layout_height="match_parent">
 
-    <View
-        android:id="@+id/toolbar_spacer"
-        android:layout_width="match_parent"
-        android:layout_height="0dp"
-        android:background="?attr/colorSurfaceVariant"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/toolbar" />
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1" />
+    <include layout="@layout/toolbar_activity" />
 
     <androidx.recyclerview.widget.RecyclerView
         android:id="@+id/recycler_view"

From 77d95e4d0247eabc6d41c57f6a6d82c7f46bc6bc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 10:44:29 -0400
Subject: [PATCH 133/458] Remove unused log

---
 app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index 6aa62c2eb..5810dff7d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -52,7 +52,6 @@ fun AppCompatActivity.setupToolbarInsets() {
             height = v.top
         }
 
-        android.util.Log.d("aaa",  "${(v as Toolbar).minimumHeight}")
         WindowInsetsCompat.CONSUMED
     }
 }

From dc70f7ca4626e02d53908489cc9de1283b180b99 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 10:58:46 -0400
Subject: [PATCH 134/458] Fix toolbar id in app-unpriv

---
 .../java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index 5ff7b65b9..8ac43c1ff 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -26,7 +26,7 @@ class CompatibilityCheckActivity: AppCompatActivity() {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_compatibility_check)
-        setSupportActionBar(requireViewById(R.id.toolbar))
+        setSupportActionBar(requireViewById(im.angry.openeuicc.common.R.id.toolbar))
         setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 

From a6777d1d1780a157cc0d8e31bc5aad5bcc072d93 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 11:05:18 -0400
Subject: [PATCH 135/458] Apply layout insets to more activities

---
 .../openeuicc/ui/EuiccManagementFragment.kt    | 18 ++++++++++++++++++
 .../java/im/angry/openeuicc/ui/LogsActivity.kt |  2 ++
 .../openeuicc/ui/NotificationsActivity.kt      |  8 +++++---
 .../im/angry/openeuicc/ui/SettingsFragment.kt  | 11 +++++++++++
 .../java/im/angry/openeuicc/util/UiUtils.kt    | 14 ++++++++++++++
 .../openeuicc/ui/CompatibilityCheckActivity.kt |  2 ++
 6 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index ac0a99f8a..b9b5e59a5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -19,6 +19,9 @@ import android.widget.PopupMenu
 import android.widget.TextView
 import android.widget.Toast
 import androidx.appcompat.app.AlertDialog
+import androidx.core.view.ViewCompat
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.updateLayoutParams
 import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -76,6 +79,21 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         fab = view.requireViewById(R.id.fab)
         profileList = view.requireViewById(R.id.profile_list)
 
+        val origFabMarginRight = (fab.layoutParams as ViewGroup.MarginLayoutParams).rightMargin
+        val origFabMarginBottom = (fab.layoutParams as ViewGroup.MarginLayoutParams).bottomMargin
+        ViewCompat.setOnApplyWindowInsetsListener(fab) { v, insets ->
+            val bars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
+
+            v.updateLayoutParams<ViewGroup.MarginLayoutParams> {
+                rightMargin = origFabMarginRight + bars.right
+                bottomMargin = origFabMarginBottom + bars.bottom
+            }
+
+            WindowInsetsCompat.CONSUMED
+        }
+
+        setupRootViewInsets(profileList)
+
         return view
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 558e69ad1..e1c9ea1d5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -49,6 +49,8 @@ class LogsActivity : AppCompatActivity() {
         scrollView = requireViewById(R.id.scroll_view)
         logText = requireViewById(R.id.log_text)
 
+        setupRootViewInsets(scrollView)
+
         swipeRefresh.setOnRefreshListener {
             lifecycleScope.launch {
                 reload()
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index dd14d8e64..01de1fcbf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -42,15 +42,17 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         setSupportActionBar(requireViewById(R.id.toolbar))
         setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
+
+        swipeRefresh = requireViewById(R.id.swipe_refresh)
+        notificationList = requireViewById(R.id.recycler_view)
+
+        setupRootViewInsets(notificationList)
     }
 
     override fun onInit() {
         euiccChannel = euiccChannelManager
             .findEuiccChannelBySlotBlocking(intent.getIntExtra("logicalSlotId", 0))!!
 
-        swipeRefresh = requireViewById(R.id.swipe_refresh)
-        notificationList = requireViewById(R.id.recycler_view)
-
         notificationList.layoutManager =
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
         notificationList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index d471efab8..841b8bd07 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -3,6 +3,9 @@ package im.angry.openeuicc.ui
 import android.content.Intent
 import android.net.Uri
 import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
 import androidx.datastore.preferences.core.Preferences
 import androidx.lifecycle.lifecycleScope
 import androidx.preference.CheckBoxPreference
@@ -46,6 +49,14 @@ class SettingsFragment: PreferenceFragmentCompat() {
             ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow, PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM)
     }
 
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View {
+        return super.onCreateView(inflater, container, savedInstanceState).also(::setupRootViewInsets)
+    }
+
     private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
         lifecycleScope.launch {
             flow.collect { isChecked = it }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index 5810dff7d..b54b494fa 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -55,3 +55,17 @@ fun AppCompatActivity.setupToolbarInsets() {
         WindowInsetsCompat.CONSUMED
     }
 }
+
+fun setupRootViewInsets(view: View) {
+    ViewCompat.setOnApplyWindowInsetsListener(view) { v, insets ->
+        val bars = insets.getInsets(
+            WindowInsetsCompat.Type.systemBars()
+                    or WindowInsetsCompat.Type.displayCutout()
+        )
+
+        // Don't set padding bottom because we do want scrolling root views to extend into nav bar
+        v.updatePadding(bars.left, v.paddingTop, bars.right, v.paddingBottom)
+
+        WindowInsetsCompat.CONSUMED
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index 8ac43c1ff..06b46df51 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -35,6 +35,8 @@ class CompatibilityCheckActivity: AppCompatActivity() {
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
         compatibilityCheckList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
         compatibilityCheckList.adapter = adapter
+
+        setupRootViewInsets(compatibilityCheckList)
     }
 
     override fun onStart() {

From b94eedac0a0e2542f275d34832108f676cc50eb4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 11:15:51 -0400
Subject: [PATCH 136/458] All LPA methods should be synchronized

Calling them from multiple threads is undefined
---
 .../typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt  | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 61491d793..6b3055d0d 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -42,6 +42,7 @@ class LocalProfileAssistantImpl(
         }
 
     override val profiles: List<LocalProfileInfo>
+        @Synchronized
         get() {
             val head = LpacJni.es10cGetProfilesInfo(contextHandle)
             var curr = head
@@ -66,6 +67,7 @@ class LocalProfileAssistantImpl(
         }
 
     override val notifications: List<LocalProfileNotification>
+        @Synchronized
         get() {
             val head = LpacJni.es10bListNotification(contextHandle)
             var curr = head
@@ -84,9 +86,11 @@ class LocalProfileAssistantImpl(
         }
 
     override val eID: String
+        @Synchronized
         get() = LpacJni.es10cGetEid(contextHandle)!!
 
     override val euiccInfo2: EuiccInfo2?
+        @Synchronized
         get() {
             val cInfo = LpacJni.es10cexGetEuiccInfo2(contextHandle)
             if (cInfo == 0L) return null
@@ -122,12 +126,15 @@ class LocalProfileAssistantImpl(
             return ret
         }
 
+    @Synchronized
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
         LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0
 
+    @Synchronized
     override fun disableProfile(iccid: String, refresh: Boolean): Boolean =
         LpacJni.es10cDisableProfile(contextHandle, iccid, refresh) == 0
 
+    @Synchronized
     override fun deleteProfile(iccid: String): Boolean =
         LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
 
@@ -144,6 +151,7 @@ class LocalProfileAssistantImpl(
         ) == 0
     }
 
+    @Synchronized
     override fun deleteNotification(seqNumber: Long): Boolean =
         LpacJni.es10bDeleteNotification(contextHandle, seqNumber) == 0
 
@@ -153,6 +161,7 @@ class LocalProfileAssistantImpl(
             Log.d(TAG, "handleNotification $seqNumber = $it")
         } == 0
 
+    @Synchronized
     override fun setNickname(iccid: String, nickname: String): Boolean =
         LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
 

From 324dcdc563ba45e69c8a0423119764202407c96a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 28 Sep 2024 16:15:17 -0400
Subject: [PATCH 137/458] EuiccManagementFragment: prevent crashes on
 configuration change

This is... not supposed to happen. We made too many assumptions about
the Fragment lifecycle.
---
 .../java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt    | 3 +++
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt    | 5 +++++
 .../im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt     | 3 +++
 3 files changed, 11 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
index d760c7670..3c699d7a9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
@@ -9,14 +9,17 @@ import android.os.IBinder
 import androidx.appcompat.app.AppCompatActivity
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService
+import kotlinx.coroutines.CompletableDeferred
 
 abstract class BaseEuiccAccessActivity : AppCompatActivity() {
+    val euiccChannelManagerLoaded = CompletableDeferred<Unit>()
     lateinit var euiccChannelManager: EuiccChannelManager
 
     private val euiccChannelManagerServiceConnection = object : ServiceConnection {
         override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
             euiccChannelManager =
                 (service!! as EuiccChannelManagerService.LocalBinder).service.euiccChannelManager
+            euiccChannelManagerLoaded.complete(Unit)
             onInit()
         }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index b9b5e59a5..fc2aa5c9e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -108,7 +108,10 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             ProfileDownloadFragment.newInstance(slotId, portId)
                 .show(childFragmentManager, ProfileDownloadFragment.TAG)
         }
+    }
 
+    override fun onStart() {
+        super.onStart()
         refresh()
     }
 
@@ -151,6 +154,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
+            ensureEuiccChannelManager()
+
             if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
                 disableSafeguardFlow =
                     preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index a324ac3d5..667ce6e71 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -39,6 +39,9 @@ val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
 
+suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: EuiccChannelFragmentMarker =
+    (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerLoaded.await()
+
 interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()
 }

From 3add3ffa909a4c84dd90c0d34accc516a3751aa5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 14:09:17 -0400
Subject: [PATCH 138/458] refactor: Launch profile download task inside
 EuiccChannelManagerService

This task is too long to run directly inside the fragment lifecycle.
Instead, let's launch it inside the service lifecycle scope and use a
MutableStateFlow to notify the UI of progress.

This interface is designed to be extensible to other use cases.
---
 app-common/src/main/AndroidManifest.xml       |   3 +
 .../service/EuiccChannelManagerService.kt     | 191 +++++++++++++++++-
 .../openeuicc/ui/BaseEuiccAccessActivity.kt   |   5 +-
 .../im/angry/openeuicc/ui/MainActivity.kt     |  17 ++
 .../openeuicc/ui/ProfileDownloadFragment.kt   |  40 ++--
 .../util/EuiccChannelFragmentUtils.kt         |   3 +
 .../drawable/ic_task_sim_card_download.xml    |   5 +
 app-common/src/main/res/values/strings.xml    |   3 +
 app-deps/Android.bp                           |   1 +
 app-deps/build.gradle.kts                     |   1 +
 privapp_whitelist_im.angry.openeuicc.xml      |   2 +
 11 files changed, 242 insertions(+), 29 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_task_sim_card_download.xml

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index 816329904..a59110b44 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -3,8 +3,10 @@
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="im.angry.openeuicc.common">
 
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
     <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
 
     <application>
         <activity
@@ -31,6 +33,7 @@
 
         <service
             android:name="im.angry.openeuicc.service.EuiccChannelManagerService"
+            android:foregroundServiceType="shortService"
             android:exported="false" />
     </application>
 </manifest>
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 75c58dbc9..9a30df31a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -1,11 +1,27 @@
 package im.angry.openeuicc.service
 
-import android.app.Service
 import android.content.Intent
+import android.content.pm.PackageManager
 import android.os.Binder
 import android.os.IBinder
+import androidx.core.app.NotificationChannelCompat
+import androidx.core.app.NotificationCompat
+import androidx.core.app.NotificationManagerCompat
+import androidx.lifecycle.LifecycleService
+import androidx.lifecycle.lifecycleScope
+import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableSharedFlow
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.onCompletion
+import kotlinx.coroutines.flow.transformWhile
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
+import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 /**
  * An Android Service wrapper for EuiccChannelManager.
@@ -17,8 +33,20 @@ import im.angry.openeuicc.util.*
  * instance of EuiccChannelManager. UI components can keep being bound to this service for
  * their entire lifecycles, since the whole purpose of them is to expose the current state
  * to the user.
+ *
+ * Additionally, this service is also responsible for long-running "foreground" tasks that
+ * are not suitable to be managed by UI components. This includes profile downloading, etc.
+ * When a UI component needs to run one of these tasks, they have to bind to this service
+ * and call one of the `launch*` methods, which will run the task inside this service's
+ * lifecycle context and return a Flow instance for the UI component to subscribe to its
+ * progress.
  */
-class EuiccChannelManagerService : Service(), OpenEuiccContextMarker {
+class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
+    companion object {
+        private const val CHANNEL_ID = "tasks"
+        private const val FOREGROUND_ID = 1000
+    }
+
     inner class LocalBinder : Binder() {
         val service = this@EuiccChannelManagerService
     }
@@ -28,14 +56,167 @@ class EuiccChannelManagerService : Service(), OpenEuiccContextMarker {
     }
     val euiccChannelManager: EuiccChannelManager by euiccChannelManagerDelegate
 
-    override fun onBind(intent: Intent?): IBinder = LocalBinder()
+    /**
+     * The state of a "foreground" task (named so due to the need to startForeground())
+     */
+    sealed interface ForegroundTaskState {
+        data object Idle : ForegroundTaskState
+        data class InProgress(val progress: Int) : ForegroundTaskState
+        data class Done(val error: Throwable?) : ForegroundTaskState
+    }
+
+    /**
+     * This flow emits whenever the service has had a start command, from startService()
+     * The service self-starts when foreground is required, because other components
+     * only bind to this service and do not start it per-se.
+     */
+    private val foregroundStarted: MutableSharedFlow<Unit> = MutableSharedFlow()
+
+    /**
+     * This flow is used to emit progress updates when a foreground task is running.
+     */
+    private val foregroundTaskState: MutableStateFlow<ForegroundTaskState> =
+        MutableStateFlow(ForegroundTaskState.Idle)
+
+    override fun onBind(intent: Intent): IBinder {
+        super.onBind(intent)
+        return LocalBinder()
+    }
 
     override fun onDestroy() {
         super.onDestroy()
-        // This is the whole reason of the existence of this service:
-        // we can clean up opened channels when no one is using them
         if (euiccChannelManagerDelegate.isInitialized()) {
             euiccChannelManager.invalidate()
         }
     }
+
+    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+        return super.onStartCommand(intent, flags, startId).also {
+            lifecycleScope.launch {
+                foregroundStarted.emit(Unit)
+            }
+        }
+    }
+
+    private fun updateForegroundNotification(title: String, iconRes: Int) {
+        val channel =
+            NotificationChannelCompat.Builder(CHANNEL_ID, NotificationManagerCompat.IMPORTANCE_LOW)
+                .setName(getString(R.string.task_notification))
+                .setVibrationEnabled(false)
+                .build()
+        NotificationManagerCompat.from(this).createNotificationChannel(channel)
+
+        val state = foregroundTaskState.value
+
+        if (state is ForegroundTaskState.InProgress) {
+            val notification = NotificationCompat.Builder(this, CHANNEL_ID)
+                .setContentTitle(title)
+                .setProgress(100, state.progress, state.progress == 0)
+                .setSmallIcon(iconRes)
+                .setPriority(NotificationCompat.PRIORITY_LOW)
+                .build()
+
+            if (state.progress == 0) {
+                startForeground(FOREGROUND_ID, notification)
+            } else if (checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED) {
+                NotificationManagerCompat.from(this).notify(FOREGROUND_ID, notification)
+            }
+        } else {
+            stopForeground(STOP_FOREGROUND_REMOVE)
+        }
+    }
+
+    /**
+     * Launch a potentially blocking foreground task in this service's lifecycle context.
+     * This function does not block, but returns a Flow that emits ForegroundTaskState
+     * updates associated with this task.
+     * The task closure is expected to update foregroundTaskState whenever appropriate.
+     * If a foreground task is already running, this function returns null.
+     */
+    private fun launchForegroundTask(
+        title: String,
+        iconRes: Int,
+        task: suspend EuiccChannelManagerService.() -> Unit
+    ): Flow<ForegroundTaskState>? {
+        // Atomically set the state to InProgress. If this returns true, we are
+        // the only task currently in progress.
+        if (!foregroundTaskState.compareAndSet(
+                ForegroundTaskState.Idle,
+                ForegroundTaskState.InProgress(0)
+            )
+        ) {
+            return null
+        }
+
+        lifecycleScope.launch(Dispatchers.Main) {
+            // Wait until our self-start command has succeeded.
+            // We can only call startForeground() after that
+            foregroundStarted.first()
+            updateForegroundNotification(title, iconRes)
+
+            try {
+                withContext(Dispatchers.IO) {
+                    this@EuiccChannelManagerService.task()
+                }
+                foregroundTaskState.value = ForegroundTaskState.Done(null)
+            } catch (t: Throwable) {
+                foregroundTaskState.value = ForegroundTaskState.Done(t)
+            } finally {
+                stopSelf()
+            }
+
+            updateForegroundNotification(title, iconRes)
+        }
+
+        // We 've launched the coroutine, now we can self-start
+        // This is required in order to use startForeground()
+        // This will end up calling onStartCommand(), which will emit
+        // into foregroundStarted and unblock the coroutine above
+        startForegroundService(Intent(this, this::class.java))
+
+        // We should be the only task running, so we can subscribe to foregroundTaskState
+        // until we encounter ForegroundTaskState.Done.
+        return foregroundTaskState.transformWhile {
+            // Also update our notification when we see an update
+            updateForegroundNotification(title, iconRes)
+            emit(it)
+            it !is ForegroundTaskState.Done
+        }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
+    }
+
+    fun launchProfileDownloadTask(
+        slotId: Int,
+        portId: Int,
+        smdp: String,
+        matchingId: String?,
+        confirmationCode: String?,
+        imei: String?
+    ): Flow<ForegroundTaskState>? =
+        launchForegroundTask(
+            getString(R.string.task_profile_download),
+            R.drawable.ic_task_sim_card_download
+        ) {
+            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+                val channel = euiccChannelManager.findEuiccChannelByPort(slotId, portId)
+                val res = channel!!.lpa.downloadProfile(
+                    smdp,
+                    matchingId,
+                    imei,
+                    confirmationCode,
+                    object : ProfileDownloadCallback {
+                        override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
+                            if (state.progress == 0) return
+                            foregroundTaskState.value =
+                                ForegroundTaskState.InProgress(state.progress)
+                        }
+                    })
+
+                if (!res) {
+                    // TODO: Provide more details on the error
+                    throw RuntimeException("Failed to download profile; this is typically caused by another error happened before.")
+                }
+
+                preferenceRepository.notificationDownloadFlow.first()
+            }
+        }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
index 3c699d7a9..ae13962e6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/BaseEuiccAccessActivity.kt
@@ -14,11 +14,12 @@ import kotlinx.coroutines.CompletableDeferred
 abstract class BaseEuiccAccessActivity : AppCompatActivity() {
     val euiccChannelManagerLoaded = CompletableDeferred<Unit>()
     lateinit var euiccChannelManager: EuiccChannelManager
+    lateinit var euiccChannelManagerService: EuiccChannelManagerService
 
     private val euiccChannelManagerServiceConnection = object : ServiceConnection {
         override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
-            euiccChannelManager =
-                (service!! as EuiccChannelManagerService.LocalBinder).service.euiccChannelManager
+            euiccChannelManagerService = (service!! as EuiccChannelManagerService.LocalBinder).service
+            euiccChannelManager = euiccChannelManagerService.euiccChannelManager
             euiccChannelManagerLoaded.complete(Unit)
             onInit()
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 183bbbd93..130751304 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -5,7 +5,9 @@ import android.content.BroadcastReceiver
 import android.content.Context
 import android.content.Intent
 import android.content.IntentFilter
+import android.content.pm.PackageManager
 import android.hardware.usb.UsbManager
+import android.os.Build
 import android.os.Bundle
 import android.telephony.TelephonyManager
 import android.util.Log
@@ -30,6 +32,8 @@ import kotlinx.coroutines.withContext
 open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         const val TAG = "MainActivity"
+
+        const val PERMISSION_REQUEST_CODE = 1000
     }
 
     private lateinit var loadingProgress: ProgressBar
@@ -116,6 +120,15 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
     }
 
+    private fun ensureNotificationPermissions() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
+            requestPermissions(
+                arrayOf(android.Manifest.permission.POST_NOTIFICATIONS),
+                PERMISSION_REQUEST_CODE
+            )
+        }
+    }
+
     private suspend fun init(fromUsbEvent: Boolean = false) {
         refreshing = true // We don't check this here -- the check happens in refresh()
         loadingProgress.visibility = View.VISIBLE
@@ -173,6 +186,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 viewPager.currentItem = 0
             }
 
+            if (pages.size > 0) {
+                ensureNotificationPermissions()
+            }
+
             refreshing = false
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index f8399a914..475dd9268 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -18,12 +18,13 @@ import com.google.android.material.textfield.TextInputLayout
 import com.journeyapps.barcodescanner.ScanContract
 import com.journeyapps.barcodescanner.ScanOptions
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.last
+import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
-import net.typeblog.lpac_jni.ProfileDownloadCallback
 import kotlin.Exception
 
 class ProfileDownloadFragment : BaseMaterialDialogFragment(),
@@ -224,30 +225,25 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         code: String?,
         confirmationCode: String?,
         imei: String?
-    ) = beginTrackedOperation {
-        val res = channel.lpa.downloadProfile(
+    ) = withContext(Dispatchers.Main) {
+        // The service is responsible for launching the actual blocking part on the IO context
+        val res = euiccChannelManagerService.launchProfileDownloadTask(
+            slotId,
+            portId,
             server,
             code,
-            imei,
             confirmationCode,
-            object : ProfileDownloadCallback {
-                override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
-                    lifecycleScope.launch(Dispatchers.Main) {
-                        progress.isIndeterminate = false
-                        progress.progress = state.progress
-                    }
-                }
-            })
+            imei
+        )!!.onEach {
+            progress.isIndeterminate = false
+            if (it is EuiccChannelManagerService.ForegroundTaskState.InProgress) {
+                progress.progress = it.progress
+            } else {
+                progress.progress = 100
+            }
+        }.last()
 
-        if (!res) {
-            // TODO: Provide more details on the error
-            throw RuntimeException("Failed to download profile; this is typically caused by another error happened before.")
-        }
-
-        // If we get here, we are successful
-        // This function is wrapped in beginTrackedOperation, so by returning the settings value,
-        // We only send notifications if the user allowed us to
-        preferenceRepository.notificationDownloadFlow.first()
+        (res as? EuiccChannelManagerService.ForegroundTaskState.Done)?.error?.let { throw it }
     }
 
     override fun onDismiss(dialog: DialogInterface) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 667ce6e71..f6f20d456 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -4,6 +4,7 @@ import android.os.Bundle
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
@@ -35,6 +36,8 @@ val <T> T.isUsb: Boolean where T: Fragment, T: EuiccChannelFragmentMarker
 
 val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: EuiccChannelFragmentMarker
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
+val <T> T.euiccChannelManagerService: EuiccChannelManagerService where T: Fragment, T: EuiccChannelFragmentMarker
+    get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerService
 val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
diff --git a/app-common/src/main/res/drawable/ic_task_sim_card_download.xml b/app-common/src/main/res/drawable/ic_task_sim_card_download.xml
new file mode 100644
index 000000000..a2eadb236
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_task_sim_card_download.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M18,2h-8L4,8v12c0,1.1 0.9,2 2,2h12c1.1,0 2,-0.9 2,-2V4C20,2.9 19.1,2 18,2zM12,17l-4,-4h3V9.02L13,9v4h3L12,17z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 7647815e2..647a2c489 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -33,6 +33,9 @@
     <string name="usb_permission_needed">Permission is needed to access the USB smart card reader.</string>
     <string name="usb_failed">Cannot connect to eSIM via a USB smart card reader.</string>
 
+    <string name="task_notification">Long-running Tasks</string>
+    <string name="task_profile_download">Downloading eSIM profile</string>
+
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>
     <string name="profile_download_code">Activation Code</string>
diff --git a/app-deps/Android.bp b/app-deps/Android.bp
index 3143e3f6f..b98d86255 100644
--- a/app-deps/Android.bp
+++ b/app-deps/Android.bp
@@ -8,6 +8,7 @@ java_defaults {
         "androidx-constraintlayout_constraintlayout",
         "androidx.preference_preference",
         "androidx.lifecycle_lifecycle-runtime-ktx",
+        "androidx.lifecycle_lifecycle-service",
         "androidx.swiperefreshlayout_swiperefreshlayout",
         "androidx.cardview_cardview",
         "androidx.viewpager2_viewpager2",
diff --git a/app-deps/build.gradle.kts b/app-deps/build.gradle.kts
index 6cde72d6d..2f4d70e5c 100644
--- a/app-deps/build.gradle.kts
+++ b/app-deps/build.gradle.kts
@@ -48,6 +48,7 @@ dependencies {
     //noinspection KtxExtensionAvailable
     api("androidx.preference:preference:1.2.1")
     api("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")
+    api("androidx.lifecycle:lifecycle-service:2.6.2")
     api("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
     api("androidx.cardview:cardview:1.0.0")
     api("androidx.viewpager2:viewpager2:1.1.0")
diff --git a/privapp_whitelist_im.angry.openeuicc.xml b/privapp_whitelist_im.angry.openeuicc.xml
index 88d35cc15..0f117b6bd 100644
--- a/privapp_whitelist_im.angry.openeuicc.xml
+++ b/privapp_whitelist_im.angry.openeuicc.xml
@@ -5,5 +5,7 @@
         <permission name="android.permission.WRITE_EMBEDDED_SUBSCRIPTIONS" />
         <permission name="android.permission.MODIFY_PHONE_STATE" />
         <permission name="android.permission.SECURE_ELEMENT_PRIVILEGED_OPERATION" />
+        <permission name="android.permission.FOREGROUND_SERVICE" />
+        <permission name="android.permission.POST_NOTIFICATIONS" />
     </privapp-permissions>
 </permissions>

From 9a77824f7943203e80634d9ca573e1343715f69b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 14:40:15 -0400
Subject: [PATCH 139/458] Enforce updateForegroundNotification to run in the
 main thread

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 9a30df31a..c9a252adb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -178,7 +178,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         // until we encounter ForegroundTaskState.Done.
         return foregroundTaskState.transformWhile {
             // Also update our notification when we see an update
-            updateForegroundNotification(title, iconRes)
+            withContext(Dispatchers.Main) {
+                updateForegroundNotification(title, iconRes)
+            }
             emit(it)
             it !is ForegroundTaskState.Done
         }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }

From 64a350d2714a177cb14d1735e2d0656706ad1c6b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 15:12:18 -0400
Subject: [PATCH 140/458] lpac-jni: Force reduce connect/read timeout for
 notification requests

---
 .../java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 356ccb28b..8193ac3b7 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -34,6 +34,12 @@ class HttpInterfaceImpl: HttpInterface {
 
             val conn = parsedUrl.openConnection() as HttpsURLConnection
             conn.connectTimeout = 2000
+
+            if (url.contains("handleNotification")) {
+                conn.connectTimeout = 1000
+                conn.readTimeout = 1000
+            }
+
             conn.sslSocketFactory = sslContext.socketFactory
             conn.requestMethod = "POST"
             conn.doInput = true

From 8de0d868954aada198a8b135947dd1b62b41a678 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 15:14:43 -0400
Subject: [PATCH 141/458] ProfileDownloadFragment: Wait for euiccChannelManager
 to load

---
 .../main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 475dd9268..99ac00372 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -159,6 +159,8 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         )
 
         lifecycleScope.launch(Dispatchers.IO) {
+            ensureEuiccChannelManager()
+
             // Fetch remaining NVRAM
             val str = channel.lpa.euiccInfo2?.freeNvram?.also {
                 freeNvram = it

From fe1319537ace15ab2f323e7fce951c155eeffe73 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 15:30:49 -0400
Subject: [PATCH 142/458] Make foreground tasks block UI reloads

---
 .../openeuicc/service/EuiccChannelManagerService.kt    | 10 ++++++++++
 .../im/angry/openeuicc/ui/EuiccManagementFragment.kt   |  1 +
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt    |  2 ++
 .../im/angry/openeuicc/ui/ProfileDownloadFragment.kt   |  6 ++++++
 4 files changed, 19 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index c9a252adb..97a784146 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -16,8 +16,10 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.onCompletion
+import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -186,6 +188,14 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
     }
 
+    val isForegroundTaskRunning: Boolean
+        get() = foregroundTaskState.value != ForegroundTaskState.Idle
+
+    suspend fun waitForForegroundTask() {
+        foregroundTaskState.takeWhile { it != ForegroundTaskState.Idle }
+            .collect()
+    }
+
     fun launchProfileDownloadTask(
         slotId: Int,
         portId: Int,
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index fc2aa5c9e..14d958d17 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -155,6 +155,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
         lifecycleScope.launch {
             ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
 
             if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
                 disableSafeguardFlow =
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 130751304..17c99ffae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -134,6 +134,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         loadingProgress.visibility = View.VISIBLE
         viewPager.visibility = View.GONE
         tabs.visibility = View.GONE
+        // Prevent concurrent access with any running foreground task
+        euiccChannelManagerService.waitForForegroundTask()
 
         val knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 99ac00372..35825bf2c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -160,6 +160,12 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
 
         lifecycleScope.launch(Dispatchers.IO) {
             ensureEuiccChannelManager()
+            if (euiccChannelManagerService.isForegroundTaskRunning) {
+                withContext(Dispatchers.Main) {
+                    dismiss()
+                }
+                return@launch
+            }
 
             // Fetch remaining NVRAM
             val str = channel.lpa.euiccInfo2?.freeNvram?.also {

From f71da0e4ffefbc74d6b75a843885acb74109b0a4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 15:32:46 -0400
Subject: [PATCH 143/458] Update documentation

---
 .../openeuicc/service/EuiccChannelManagerService.kt      | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 97a784146..f177f1a95 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -131,9 +131,13 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     /**
      * Launch a potentially blocking foreground task in this service's lifecycle context.
      * This function does not block, but returns a Flow that emits ForegroundTaskState
-     * updates associated with this task.
+     * updates associated with this task. The last update the returned flow will emit is
+     * always ForegroundTaskState.Done.
+     *
      * The task closure is expected to update foregroundTaskState whenever appropriate.
      * If a foreground task is already running, this function returns null.
+     *
+     * The function will set the state back to Idle once it sees ForegroundTaskState.Done.
      */
     private fun launchForegroundTask(
         title: String,
@@ -178,6 +182,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
 
         // We should be the only task running, so we can subscribe to foregroundTaskState
         // until we encounter ForegroundTaskState.Done.
+        // Then, we complete the returned flow, but we also set the state back to Idle.
+        // The state update back to Idle won't show up in the returned stream, because
+        // it has been completed by that point.
         return foregroundTaskState.transformWhile {
             // Also update our notification when we see an update
             withContext(Dispatchers.Main) {

From cf5704be4220e11221bdf71c88ddfe4527c8c3a7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 16:32:58 -0400
Subject: [PATCH 144/458] Move profile download to the new foreground flow

...and fix race condition introduced by the new flow
---
 .../service/EuiccChannelManagerService.kt     | 36 +++++++++++++++----
 .../openeuicc/ui/ProfileDownloadFragment.kt   |  2 ++
 .../openeuicc/ui/ProfileRenameFragment.kt     | 35 ++++++++----------
 .../src/main/res/drawable/ic_task_rename.xml  |  5 +++
 app-common/src/main/res/values/strings.xml    |  1 +
 5 files changed, 52 insertions(+), 27 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_task_rename.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index f177f1a95..c004c5fae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -19,6 +19,7 @@ import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.onCompletion
+import kotlinx.coroutines.flow.onStart
 import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.launch
@@ -174,12 +175,6 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             updateForegroundNotification(title, iconRes)
         }
 
-        // We 've launched the coroutine, now we can self-start
-        // This is required in order to use startForeground()
-        // This will end up calling onStartCommand(), which will emit
-        // into foregroundStarted and unblock the coroutine above
-        startForegroundService(Intent(this, this::class.java))
-
         // We should be the only task running, so we can subscribe to foregroundTaskState
         // until we encounter ForegroundTaskState.Done.
         // Then, we complete the returned flow, but we also set the state back to Idle.
@@ -192,6 +187,15 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             }
             emit(it)
             it !is ForegroundTaskState.Done
+        }.onStart {
+            // When this Flow is started, we unblock the coroutine launched above by
+            // self-starting as a foreground service.
+            startForegroundService(
+                Intent(
+                    this@EuiccChannelManagerService,
+                    this@EuiccChannelManagerService::class.java
+                )
+            )
         }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
     }
 
@@ -238,4 +242,24 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 preferenceRepository.notificationDownloadFlow.first()
             }
         }
+
+    fun launchProfileRenameTask(
+        slotId: Int,
+        portId: Int,
+        iccid: String,
+        name: String
+    ): Flow<ForegroundTaskState>? =
+        launchForegroundTask(
+            getString(R.string.task_profile_rename),
+            R.drawable.ic_task_rename
+        ) {
+            val res = euiccChannelManager.findEuiccChannelByPort(slotId, portId)!!.lpa.setNickname(
+                iccid,
+                name
+            )
+
+            if (!res) {
+                throw RuntimeException("Profile not renamed")
+            }
+        }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 35825bf2c..c61fe3a88 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -213,6 +213,8 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         progress.visibility = View.VISIBLE
 
         lifecycleScope.launch {
+            ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
             try {
                 doDownloadProfile(server, code, confirmationCode, imei)
             } catch (e: Exception) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 798711735..84fd0cd15 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -2,7 +2,6 @@ package im.angry.openeuicc.ui
 
 import android.app.Dialog
 import android.os.Bundle
-import android.util.Log
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
@@ -13,11 +12,8 @@ import androidx.lifecycle.lifecycleScope
 import com.google.android.material.textfield.TextInputLayout
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.launch
-import kotlinx.coroutines.withContext
-import java.lang.Exception
-import java.lang.RuntimeException
 
 class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragmentMarker {
     companion object {
@@ -97,23 +93,20 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         progress.visibility = View.VISIBLE
 
         lifecycleScope.launch {
-            try {
-                doRename(name)
-            } catch (e: Exception) {
-                Log.d(TAG, "Failed to rename profile")
-                Log.d(TAG, Log.getStackTraceString(e))
-            } finally {
-                if (parentFragment is EuiccProfilesChangedListener) {
-                    (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
-                }
-                dismiss()
-            }
-        }
-    }
+            ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
+            euiccChannelManagerService.launchProfileRenameTask(
+                slotId,
+                portId,
+                requireArguments().getString("iccid")!!,
+                name
+            )?.collect()
 
-    private suspend fun doRename(name: String) = withContext(Dispatchers.IO) {
-        if (!channel.lpa.setNickname(requireArguments().getString("iccid")!!, name)) {
-            throw RuntimeException("Profile nickname not changed")
+            if (parentFragment is EuiccProfilesChangedListener) {
+                (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
+            }
+
+            dismiss()
         }
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/drawable/ic_task_rename.xml b/app-common/src/main/res/drawable/ic_task_rename.xml
new file mode 100644
index 000000000..3c53db7ec
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_task_rename.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M3,17.25V21h3.75L17.81,9.94l-3.75,-3.75L3,17.25zM20.71,7.04c0.39,-0.39 0.39,-1.02 0,-1.41l-2.34,-2.34c-0.39,-0.39 -1.02,-0.39 -1.41,0l-1.83,1.83 3.75,3.75 1.83,-1.83z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 647a2c489..bedfe2115 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -35,6 +35,7 @@
 
     <string name="task_notification">Long-running Tasks</string>
     <string name="task_profile_download">Downloading eSIM profile</string>
+    <string name="task_profile_rename">Renaming eSIM profile</string>
 
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>

From 31c06470c6e2b1592322d4b30e9988a8c73cd9d8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 16:49:21 -0400
Subject: [PATCH 145/458] Move profile deletion to new flow

---
 .../service/EuiccChannelManagerService.kt     | 24 +++++++++++++-
 .../openeuicc/ui/ProfileDeleteFragment.kt     | 31 +++++++++----------
 .../src/main/res/drawable/ic_task_delete.xml  |  5 +++
 app-common/src/main/res/values/strings.xml    |  1 +
 4 files changed, 44 insertions(+), 17 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_task_delete.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index c004c5fae..6061a94cb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -133,11 +133,14 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
      * Launch a potentially blocking foreground task in this service's lifecycle context.
      * This function does not block, but returns a Flow that emits ForegroundTaskState
      * updates associated with this task. The last update the returned flow will emit is
-     * always ForegroundTaskState.Done.
+     * always ForegroundTaskState.Done. The returned flow MUST be started in order for the
+     * foreground task to run.
      *
      * The task closure is expected to update foregroundTaskState whenever appropriate.
      * If a foreground task is already running, this function returns null.
      *
+     * To wait for foreground tasks to be available, use waitForForegroundTask().
+     *
      * The function will set the state back to Idle once it sees ForegroundTaskState.Done.
      */
     private fun launchForegroundTask(
@@ -262,4 +265,23 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 throw RuntimeException("Profile not renamed")
             }
         }
+
+    fun launchProfileDeleteTask(
+        slotId: Int,
+        portId: Int,
+        iccid: String
+    ): Flow<ForegroundTaskState>? =
+        launchForegroundTask(
+            getString(R.string.task_profile_delete),
+            R.drawable.ic_task_delete
+        ) {
+            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+                euiccChannelManager.findEuiccChannelByPort(
+                    slotId,
+                    portId
+                )!!.lpa.deleteProfile(iccid)
+
+                preferenceRepository.notificationDeleteFlow.first()
+            }
+        }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index 75863541f..467132fa7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -3,16 +3,15 @@ package im.angry.openeuicc.ui
 import android.app.Dialog
 import android.os.Bundle
 import android.text.Editable
-import android.util.Log
 import android.widget.EditText
 import androidx.appcompat.app.AlertDialog
 import androidx.fragment.app.DialogFragment
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.collect
+import kotlinx.coroutines.flow.onStart
 import kotlinx.coroutines.launch
-import java.lang.Exception
 
 class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
     companion object {
@@ -67,23 +66,23 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         alertDialog.getButton(AlertDialog.BUTTON_POSITIVE).isEnabled = false
         alertDialog.getButton(AlertDialog.BUTTON_NEGATIVE).isEnabled = false
 
-        lifecycleScope.launch {
-            try {
-                doDelete()
-            } catch (e: Exception) {
-                Log.d(ProfileDownloadFragment.TAG, "Error deleting profile")
-                Log.d(ProfileDownloadFragment.TAG, Log.getStackTraceString(e))
-            } finally {
+        requireParentFragment().lifecycleScope.launch {
+            ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
+
+            euiccChannelManagerService.launchProfileDeleteTask(
+                slotId,
+                portId,
+                requireArguments().getString("iccid")!!
+            )!!.onStart {
                 if (parentFragment is EuiccProfilesChangedListener) {
+                    // Trigger a refresh in the parent fragment -- it should wait until
+                    // any foreground task is completed before actually doing a refresh
                     (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
                 }
+
                 dismiss()
-            }
+            }.collect()
         }
     }
-
-    private suspend fun doDelete() = beginTrackedOperation {
-        channel.lpa.deleteProfile(requireArguments().getString("iccid")!!)
-        preferenceRepository.notificationDeleteFlow.first()
-    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/drawable/ic_task_delete.xml b/app-common/src/main/res/drawable/ic_task_delete.xml
new file mode 100644
index 000000000..883bcaacc
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_task_delete.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M6,19c0,1.1 0.9,2 2,2h8c1.1,0 2,-0.9 2,-2V7H6v12zM19,4h-3.5l-1,-1h-5l-1,1H5v2h14V4z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bedfe2115..cf7ce5966 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -36,6 +36,7 @@
     <string name="task_notification">Long-running Tasks</string>
     <string name="task_profile_download">Downloading eSIM profile</string>
     <string name="task_profile_rename">Renaming eSIM profile</string>
+    <string name="task_profile_delete">Deleting eSIM profile</string>
 
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>

From 48b5f8ce06ac75f664e81374d2bda002a824c1ba Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 16:54:49 -0400
Subject: [PATCH 146/458] Impose timeout on waiting for foreground start

---
 .../service/EuiccChannelManagerService.kt        | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 6061a94cb..950247ce4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -24,6 +24,8 @@ import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
+import kotlinx.coroutines.withTimeout
+import kotlinx.coroutines.withTimeoutOrNull
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 /**
@@ -161,7 +163,19 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         lifecycleScope.launch(Dispatchers.Main) {
             // Wait until our self-start command has succeeded.
             // We can only call startForeground() after that
-            foregroundStarted.first()
+            val res = withTimeoutOrNull(30 * 1000) {
+                foregroundStarted.first()
+            }
+
+            if (res == null) {
+                // The only case where the wait above could time out is if the subscriber
+                // to the flow is stuck. Or we failed to start foreground.
+                // In that case, we should just set our state back to Idle -- setting it
+                // to Done wouldn't help much because nothing is going to then set it Idle.
+                foregroundTaskState.value = ForegroundTaskState.Idle
+                return@launch
+            }
+
             updateForegroundNotification(title, iconRes)
 
             try {

From 653123939c53e9c9d9261e2073810f4c9c251264 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 17:07:15 -0400
Subject: [PATCH 147/458] Set notifications to ongoing

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 950247ce4..212194f5e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -24,7 +24,6 @@ import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
-import kotlinx.coroutines.withTimeout
 import kotlinx.coroutines.withTimeoutOrNull
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
@@ -119,6 +118,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 .setProgress(100, state.progress, state.progress == 0)
                 .setSmallIcon(iconRes)
                 .setPriority(NotificationCompat.PRIORITY_LOW)
+                .setOngoing(true)
                 .build()
 
             if (state.progress == 0) {

From 2721f9127723d3d123109f452e6cb368243f5283 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 17:36:58 -0400
Subject: [PATCH 148/458] Make foreground notifications much more reliable

---
 .../service/EuiccChannelManagerService.kt     | 30 ++++++++++++-------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 212194f5e..6bef2219c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -25,6 +25,7 @@ import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.withTimeoutOrNull
+import kotlinx.coroutines.yield
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 /**
@@ -102,7 +103,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         }
     }
 
-    private fun updateForegroundNotification(title: String, iconRes: Int) {
+    private suspend fun updateForegroundNotification(title: String, iconRes: Int) {
         val channel =
             NotificationChannelCompat.Builder(CHANNEL_ID, NotificationManagerCompat.IMPORTANCE_LOW)
                 .setName(getString(R.string.task_notification))
@@ -126,6 +127,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             } else if (checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED) {
                 NotificationManagerCompat.from(this).notify(FOREGROUND_ID, notification)
             }
+
+            // Yield out so that the main looper can handle the notification event
+            // Without this yield, the notification sent above will not be shown in time.
+            yield()
         } else {
             stopForeground(STOP_FOREGROUND_REMOVE)
         }
@@ -182,14 +187,13 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 withContext(Dispatchers.IO) {
                     this@EuiccChannelManagerService.task()
                 }
+                // This update will be sent by the subscriber (as shown below)
                 foregroundTaskState.value = ForegroundTaskState.Done(null)
             } catch (t: Throwable) {
                 foregroundTaskState.value = ForegroundTaskState.Done(t)
             } finally {
                 stopSelf()
             }
-
-            updateForegroundNotification(title, iconRes)
         }
 
         // We should be the only task running, so we can subscribe to foregroundTaskState
@@ -199,20 +203,26 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         // it has been completed by that point.
         return foregroundTaskState.transformWhile {
             // Also update our notification when we see an update
-            withContext(Dispatchers.Main) {
-                updateForegroundNotification(title, iconRes)
+            // But ignore the first progress = 0 update -- that is the current value.
+            // we need that to be handled by the main coroutine after it finishes.
+            if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
+                withContext(Dispatchers.Main) {
+                    updateForegroundNotification(title, iconRes)
+                }
             }
             emit(it)
             it !is ForegroundTaskState.Done
         }.onStart {
             // When this Flow is started, we unblock the coroutine launched above by
             // self-starting as a foreground service.
-            startForegroundService(
-                Intent(
-                    this@EuiccChannelManagerService,
-                    this@EuiccChannelManagerService::class.java
+            withContext(Dispatchers.Main) {
+                startForegroundService(
+                    Intent(
+                        this@EuiccChannelManagerService,
+                        this@EuiccChannelManagerService::class.java
+                    )
                 )
-            )
+            }
         }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
     }
 

From 8573834a0349975e87c2328930208f0a55f1523b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 17:39:32 -0400
Subject: [PATCH 149/458] Improve download progress bar UI

---
 .../main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index c61fe3a88..b7ad5eef1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -245,11 +245,12 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
             confirmationCode,
             imei
         )!!.onEach {
-            progress.isIndeterminate = false
             if (it is EuiccChannelManagerService.ForegroundTaskState.InProgress) {
                 progress.progress = it.progress
+                progress.isIndeterminate = it.progress == 0
             } else {
                 progress.progress = 100
+                progress.isIndeterminate = false
             }
         }.last()
 

From 79f43e2fda94b3ebbb463594233c3ff978a752e8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 17:40:58 -0400
Subject: [PATCH 150/458] Set notification to alert only once

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 6bef2219c..98a87221a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -120,6 +120,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 .setSmallIcon(iconRes)
                 .setPriority(NotificationCompat.PRIORITY_LOW)
                 .setOngoing(true)
+                .setOnlyAlertOnce(true)
                 .build()
 
             if (state.progress == 0) {

From 479e0ff34ade33af57204964aa0e6596202de99c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 21:44:32 -0400
Subject: [PATCH 151/458] Move profile switching to use the new foreground task
 flow

---
 .../service/EuiccChannelManagerService.kt     |  54 +++++++++
 .../openeuicc/ui/EuiccManagementFragment.kt   | 107 +++++++++---------
 .../src/main/res/drawable/ic_task_switch.xml  |   5 +
 app-common/src/main/res/values/strings.xml    |   1 +
 4 files changed, 113 insertions(+), 54 deletions(-)
 create mode 100644 app-common/src/main/res/drawable/ic_task_switch.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 98a87221a..788a25176 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -13,6 +13,7 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
@@ -309,4 +310,57 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 preferenceRepository.notificationDeleteFlow.first()
             }
         }
+
+    class SwitchingProfilesRefreshException : Exception()
+
+    fun launchProfileSwitchTask(
+        slotId: Int,
+        portId: Int,
+        iccid: String,
+        enable: Boolean, // Enable or disable the profile indicated in iccid
+        reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect, useful for USB readers
+    ): Flow<ForegroundTaskState>? =
+        launchForegroundTask(
+            getString(R.string.task_profile_switch),
+            R.drawable.ic_task_switch
+        ) {
+            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+                val channel = euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
+                val (res, refreshed) =
+                    if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
+                        // Sometimes, we *can* enable or disable the profile, but we cannot
+                        // send the refresh command to the modem because the profile somehow
+                        // makes the modem "busy". In this case, we can still switch by setting
+                        // refresh to false, but then the switch cannot take effect until the
+                        // user resets the modem manually by toggling airplane mode or rebooting.
+                        Pair(channel.lpa.switchProfile(iccid, enable, refresh = false), false)
+                    } else {
+                        Pair(true, true)
+                    }
+
+                if (!res) {
+                    throw RuntimeException("Could not switch profile")
+                }
+
+                if (!refreshed) {
+                    // We may have switched the profile, but we could not refresh. Tell the caller about this
+                    throw SwitchingProfilesRefreshException()
+                }
+
+                if (reconnectTimeoutMillis > 0) {
+                    // Add an unconditional delay first to account for any race condition between
+                    // the card sending the refresh command and the modem actually refreshing
+                    delay(reconnectTimeoutMillis / 10)
+
+                    // This throws TimeoutCancellationException if timed out
+                    euiccChannelManager.waitForReconnect(
+                        slotId,
+                        portId,
+                        reconnectTimeoutMillis / 10 * 9
+                    )
+                }
+
+                preferenceRepository.notificationSwitchFlow.first()
+            }
+        }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 14d958d17..da2912305 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -30,12 +30,12 @@ import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import com.google.android.material.floatingactionbutton.FloatingActionButton
 import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -176,67 +176,47 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         }
     }
 
+    private suspend fun showSwitchFailureText() = withContext(Dispatchers.Main) {
+        Toast.makeText(
+            context,
+            R.string.toast_profile_enable_failed,
+            Toast.LENGTH_LONG
+        ).show()
+    }
+
     private fun enableOrDisableProfile(iccid: String, enable: Boolean) {
         swipeRefresh.isRefreshing = true
         fab.isEnabled = false
 
         lifecycleScope.launch {
-            beginTrackedOperation {
-                val (res, refreshed) =
-                    if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
-                        // Sometimes, we *can* enable or disable the profile, but we cannot
-                        // send the refresh command to the modem because the profile somehow
-                        // makes the modem "busy". In this case, we can still switch by setting
-                        // refresh to false, but then the switch cannot take effect until the
-                        // user resets the modem manually by toggling airplane mode or rebooting.
-                        Pair(channel.lpa.switchProfile(iccid, enable, refresh = false), false)
-                    } else {
-                        Pair(true, true)
-                    }
+            ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
 
-                if (!res) {
-                    Log.d(TAG, "Failed to enable / disable profile $iccid")
-                    withContext(Dispatchers.Main) {
-                        Toast.makeText(
-                            context,
-                            R.string.toast_profile_enable_failed,
-                            Toast.LENGTH_LONG
-                        ).show()
-                    }
-                    return@beginTrackedOperation false
+            val res = euiccChannelManagerService.launchProfileSwitchTask(
+                slotId,
+                portId,
+                iccid,
+                enable,
+                reconnectTimeoutMillis = if (isUsb) {
+                    0
+                } else {
+                    30 * 1000
                 }
+            )?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done
 
-                if (!refreshed && !isUsb) {
-                    withContext(Dispatchers.Main) {
-                        AlertDialog.Builder(requireContext()).apply {
-                            setMessage(R.string.switch_did_not_refresh)
-                            setPositiveButton(android.R.string.ok) { dialog, _ ->
-                                dialog.dismiss()
-                                requireActivity().finish()
-                            }
-                            setOnDismissListener { _ ->
-                                requireActivity().finish()
-                            }
-                            show()
-                        }
-                    }
-                    return@beginTrackedOperation true
-                }
+            if (res == null) {
+                showSwitchFailureText()
+                return@launch
+            }
 
-                if (!isUsb) {
-                    try {
-                        euiccChannelManager.waitForReconnect(
-                            slotId,
-                            portId,
-                            timeoutMillis = 30 * 1000
-                        )
-                    } catch (e: TimeoutCancellationException) {
+            when (res.error) {
+                null -> {}
+                is EuiccChannelManagerService.SwitchingProfilesRefreshException -> {
+                    // This is only really fatal for internal eSIMs
+                    if (!isUsb) {
                         withContext(Dispatchers.Main) {
-                            // Prevent this Fragment from being used again
-                            invalid = true
-                            // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
                             AlertDialog.Builder(requireContext()).apply {
-                                setMessage(R.string.enable_disable_timeout)
+                                setMessage(R.string.switch_did_not_refresh)
                                 setPositiveButton(android.R.string.ok) { dialog, _ ->
                                     dialog.dismiss()
                                     requireActivity().finish()
@@ -247,12 +227,31 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                                 show()
                             }
                         }
-                        return@beginTrackedOperation false
                     }
                 }
 
-                preferenceRepository.notificationSwitchFlow.first()
+                is TimeoutCancellationException -> {
+                    withContext(Dispatchers.Main) {
+                        // Prevent this Fragment from being used again
+                        invalid = true
+                        // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
+                        AlertDialog.Builder(requireContext()).apply {
+                            setMessage(R.string.enable_disable_timeout)
+                            setPositiveButton(android.R.string.ok) { dialog, _ ->
+                                dialog.dismiss()
+                                requireActivity().finish()
+                            }
+                            setOnDismissListener { _ ->
+                                requireActivity().finish()
+                            }
+                            show()
+                        }
+                    }
+                }
+
+                else -> showSwitchFailureText()
             }
+
             refresh()
             fab.isEnabled = true
         }
diff --git a/app-common/src/main/res/drawable/ic_task_switch.xml b/app-common/src/main/res/drawable/ic_task_switch.xml
new file mode 100644
index 000000000..86504d0ef
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_task_switch.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M17.65,6.35C16.2,4.9 14.21,4 12,4c-4.42,0 -7.99,3.58 -7.99,8s3.57,8 7.99,8c3.73,0 6.84,-2.55 7.73,-6h-2.08c-0.82,2.33 -3.04,4 -5.65,4 -3.31,0 -6,-2.69 -6,-6s2.69,-6 6,-6c1.66,0 3.14,0.69 4.22,1.78L13,11h7V4l-2.35,2.35z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index cf7ce5966..34fda1c12 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -37,6 +37,7 @@
     <string name="task_profile_download">Downloading eSIM profile</string>
     <string name="task_profile_rename">Renaming eSIM profile</string>
     <string name="task_profile_delete">Deleting eSIM profile</string>
+    <string name="task_profile_switch">Switching eSIM profile</string>
 
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>

From 7661b4b84f2c21f52ac13069a31e7e12b687de6b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 21:45:55 -0400
Subject: [PATCH 152/458] Output any foreground task error to Log

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 788a25176..841458d52 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -4,6 +4,7 @@ import android.content.Intent
 import android.content.pm.PackageManager
 import android.os.Binder
 import android.os.IBinder
+import android.util.Log
 import androidx.core.app.NotificationChannelCompat
 import androidx.core.app.NotificationCompat
 import androidx.core.app.NotificationManagerCompat
@@ -49,6 +50,7 @@ import net.typeblog.lpac_jni.ProfileDownloadCallback
  */
 class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     companion object {
+        private const val TAG = "EuiccChannelManagerService"
         private const val CHANNEL_ID = "tasks"
         private const val FOREGROUND_ID = 1000
     }
@@ -192,6 +194,8 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 // This update will be sent by the subscriber (as shown below)
                 foregroundTaskState.value = ForegroundTaskState.Done(null)
             } catch (t: Throwable) {
+                Log.e(TAG, "Foreground task encountered an error")
+                Log.e(TAG, Log.getStackTraceString(t))
                 foregroundTaskState.value = ForegroundTaskState.Done(t)
             } finally {
                 stopSelf()

From 54b4f61fd7e5560bd49578640ea25bd3943fa3a5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 29 Sep 2024 21:50:47 -0400
Subject: [PATCH 153/458] Improve notification channel creation

---
 .../service/EuiccChannelManagerService.kt     | 20 ++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 841458d52..fa22dc1c1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -107,12 +107,18 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     }
 
     private suspend fun updateForegroundNotification(title: String, iconRes: Int) {
-        val channel =
-            NotificationChannelCompat.Builder(CHANNEL_ID, NotificationManagerCompat.IMPORTANCE_LOW)
-                .setName(getString(R.string.task_notification))
-                .setVibrationEnabled(false)
-                .build()
-        NotificationManagerCompat.from(this).createNotificationChannel(channel)
+        val nm = NotificationManagerCompat.from(this)
+        if (nm.getNotificationChannelCompat(CHANNEL_ID) == null) {
+            val channel =
+                NotificationChannelCompat.Builder(
+                    CHANNEL_ID,
+                    NotificationManagerCompat.IMPORTANCE_LOW
+                )
+                    .setName(getString(R.string.task_notification))
+                    .setVibrationEnabled(false)
+                    .build()
+            nm.createNotificationChannel(channel)
+        }
 
         val state = foregroundTaskState.value
 
@@ -129,7 +135,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             if (state.progress == 0) {
                 startForeground(FOREGROUND_ID, notification)
             } else if (checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED) {
-                NotificationManagerCompat.from(this).notify(FOREGROUND_ID, notification)
+                nm.notify(FOREGROUND_ID, notification)
             }
 
             // Yield out so that the main looper can handle the notification event

From 42942c2816225880f797ab0f6435d76a1157f222 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 30 Sep 2024 19:49:24 -0400
Subject: [PATCH 154/458] ui: Handle navbar insets properly

---
 .../main/java/im/angry/openeuicc/ui/SettingsFragment.kt  | 9 +++------
 .../src/main/java/im/angry/openeuicc/util/UiUtils.kt     | 7 ++++---
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 841b8bd07..2c9964125 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -49,12 +49,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
             ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow, PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM)
     }
 
-    override fun onCreateView(
-        inflater: LayoutInflater,
-        container: ViewGroup?,
-        savedInstanceState: Bundle?
-    ): View {
-        return super.onCreateView(inflater, container, savedInstanceState).also(::setupRootViewInsets)
+    override fun onStart() {
+        super.onStart()
+        setupRootViewInsets(requireView().requireViewById(androidx.preference.R.id.recycler_view))
     }
 
     private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index b54b494fa..fbede8781 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -56,15 +56,16 @@ fun AppCompatActivity.setupToolbarInsets() {
     }
 }
 
-fun setupRootViewInsets(view: View) {
+fun setupRootViewInsets(view: ViewGroup) {
+    // Disable clipToPadding to make sure content actually display
+    view.clipToPadding = false
     ViewCompat.setOnApplyWindowInsetsListener(view) { v, insets ->
         val bars = insets.getInsets(
             WindowInsetsCompat.Type.systemBars()
                     or WindowInsetsCompat.Type.displayCutout()
         )
 
-        // Don't set padding bottom because we do want scrolling root views to extend into nav bar
-        v.updatePadding(bars.left, v.paddingTop, bars.right, v.paddingBottom)
+        v.updatePadding(bars.left, v.paddingTop, bars.right, bars.bottom)
 
         WindowInsetsCompat.CONSUMED
     }

From 165f685abb91a861b4ce14cecfaeb498121ab811 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 30 Sep 2024 19:53:25 -0400
Subject: [PATCH 155/458] Remove unused beginTrackedOperation in UI

---
 .../angry/openeuicc/util/EuiccChannelFragmentUtils.kt  | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index f6f20d456..e92be4088 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -6,8 +6,6 @@ import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.withContext
 
 interface EuiccChannelFragmentMarker: OpenEuiccContextMarker
 
@@ -47,12 +45,4 @@ suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: EuiccChannel
 
 interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()
-}
-
-suspend fun <T> T.beginTrackedOperation(op: suspend () -> Boolean) where T: Fragment, T: EuiccChannelFragmentMarker {
-    withContext(Dispatchers.IO) {
-        euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
-            op()
-        }
-    }
 }
\ No newline at end of file

From 6b71a746a4b30ca50221d68887446b839a81f3e3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 18:10:14 -0400
Subject: [PATCH 156/458] Add monochrome icons for v31+

---
 app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher.xml   | 6 ++++++
 .../src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml    | 6 ++++++
 app/src/main/res/mipmap-anydpi-v31/ic_launcher.xml          | 6 ++++++
 app/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml    | 6 ++++++
 4 files changed, 24 insertions(+)
 create mode 100644 app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
 create mode 100644 app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml

diff --git a/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher.xml b/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
new file mode 100644
index 000000000..50ec88623
--- /dev/null
+++ b/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml b/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml
new file mode 100644
index 000000000..50ec88623
--- /dev/null
+++ b/app-unpriv/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>
\ No newline at end of file
diff --git a/app/src/main/res/mipmap-anydpi-v31/ic_launcher.xml b/app/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
new file mode 100644
index 000000000..50ec88623
--- /dev/null
+++ b/app/src/main/res/mipmap-anydpi-v31/ic_launcher.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>
\ No newline at end of file
diff --git a/app/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml b/app/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml
new file mode 100644
index 000000000..50ec88623
--- /dev/null
+++ b/app/src/main/res/mipmap-anydpi-v31/ic_launcher_round.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+    <monochrome android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>
\ No newline at end of file

From ff266a4a9bb041f5a8085e633b53c989a3e1ac6a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 18:13:51 -0400
Subject: [PATCH 157/458] Un-confusing-ify the "safeguards" description

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 34fda1c12..4b3f9aef7 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -80,7 +80,7 @@
     <string name="pref_notifications_switch">Switching</string>
     <string name="pref_notifications_switch_desc">Send notifications for <i>switching</i> profiles\nNote that this type of notification is unreliable.</string>
     <string name="pref_advanced">Advanced</string>
-    <string name="pref_advanced_disable_safeguard_removable_esim">Disable Safeguards for Removable eSIMs</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">Allow Deleting the Last Profile</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>

From 5c8bbeb217e5532ac27ebfd4f191901ca282994d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 18:14:54 -0400
Subject: [PATCH 158/458] Fix removable eSIM safeguards description again

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4b3f9aef7..b3a6eb88b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -80,7 +80,7 @@
     <string name="pref_notifications_switch">Switching</string>
     <string name="pref_notifications_switch_desc">Send notifications for <i>switching</i> profiles\nNote that this type of notification is unreliable.</string>
     <string name="pref_advanced">Advanced</string>
-    <string name="pref_advanced_disable_safeguard_removable_esim">Allow Deleting the Last Profile</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">Allow Disabling / Deleting Active Profile</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>

From 290bdca75a34a0e5f9d4b3123ce9e3ab1d508d3b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 20:20:32 -0400
Subject: [PATCH 159/458] feat: Introduce option for global verbose logging

---
 .../core/DefaultEuiccChannelFactory.kt        | 18 +++++++++++--
 .../im/angry/openeuicc/core/EuiccChannel.kt   |  5 +++-
 .../openeuicc/core/OmapiApduInterface.kt      | 15 ++++++++---
 .../openeuicc/core/usb/UsbApduInterface.kt    |  6 +++--
 .../openeuicc/core/usb/UsbCcidTransceiver.kt  | 10 +++++--
 .../im/angry/openeuicc/ui/MainActivity.kt     |  5 +++-
 .../openeuicc/ui/ProfileDownloadFragment.kt   |  1 -
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  3 +++
 .../angry/openeuicc/util/PreferenceUtils.kt   |  4 +++
 app-common/src/main/res/values/strings.xml    |  2 ++
 app-common/src/main/res/xml/pref_settings.xml |  6 +++++
 .../core/PrivilegedEuiccChannelFactory.kt     | 10 ++++++-
 .../core/TelephonyManagerApduInterface.kt     | 27 +++++++++++++++++--
 .../lpac_jni/impl/HttpInterfaceImpl.kt        | 20 ++++++++++++--
 14 files changed, 115 insertions(+), 17 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index e653a0782..ae984b33c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -33,7 +33,15 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
 
         Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
         try {
-            return EuiccChannel(port, OmapiApduInterface(seService!!, port))
+            return EuiccChannel(
+                port,
+                OmapiApduInterface(
+                    seService!!,
+                    port,
+                    context.preferenceRepository.verboseLoggingFlow
+                ),
+                context.preferenceRepository.verboseLoggingFlow
+            )
         } catch (e: IllegalArgumentException) {
             // Failed
             Log.w(
@@ -52,7 +60,13 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         if (!conn.claimInterface(usbInterface, true)) return null
         return EuiccChannel(
             FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
-            UsbApduInterface(conn, bulkIn, bulkOut)
+            UsbApduInterface(
+                conn,
+                bulkIn,
+                bulkOut,
+                context.preferenceRepository.verboseLoggingFlow
+            ),
+            context.preferenceRepository.verboseLoggingFlow
         )
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 35cf0ad00..e10653501 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
 import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
@@ -9,12 +10,14 @@ import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 class EuiccChannel(
     val port: UiccPortInfoCompat,
     apduInterface: ApduInterface,
+    verboseLoggingFlow: Flow<Boolean>
 ) {
     val slotId = port.card.physicalSlotIndex // PHYSICAL slot
     val logicalSlotId = port.logicalSlotIndex
     val portId = port.portIndex
 
-    val lpa: LocalProfileAssistant = LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl())
+    val lpa: LocalProfileAssistant =
+        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow))
 
     val valid: Boolean
         get() = lpa.valid
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index 711658adb..f71c87657 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -5,11 +5,16 @@ import android.se.omapi.SEService
 import android.se.omapi.Session
 import android.util.Log
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.single
+import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.ApduInterface
 
 class OmapiApduInterface(
     private val service: SEService,
-    private val port: UiccPortInfoCompat
+    private val port: UiccPortInfoCompat,
+    private val verboseLoggingFlow: Flow<Boolean>
 ): ApduInterface {
     companion object {
         const val TAG = "OmapiApduInterface"
@@ -49,11 +54,15 @@ class OmapiApduInterface(
             "Unknown channel"
         }
 
-        Log.d(TAG, "OMAPI APDU: ${tx.encodeHex()}")
+        if (runBlocking { verboseLoggingFlow.first() }) {
+            Log.d(TAG, "OMAPI APDU: ${tx.encodeHex()}")
+        }
 
         try {
             return lastChannel.transmit(tx).also {
-                Log.d(TAG, "OMAPI APDU response: ${it.encodeHex()}")
+                if (runBlocking { verboseLoggingFlow.first() }) {
+                    Log.d(TAG, "OMAPI APDU response: ${it.encodeHex()}")
+                }
             }
         } catch (e: Exception) {
             Log.e(TAG, "OMAPI APDU exception")
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index fb93ff687..9894343d6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -4,12 +4,14 @@ import android.hardware.usb.UsbDeviceConnection
 import android.hardware.usb.UsbEndpoint
 import android.util.Log
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
 import net.typeblog.lpac_jni.ApduInterface
 
 class UsbApduInterface(
     private val conn: UsbDeviceConnection,
     private val bulkIn: UsbEndpoint,
-    private val bulkOut: UsbEndpoint
+    private val bulkOut: UsbEndpoint,
+    private val verboseLoggingFlow: Flow<Boolean>
 ): ApduInterface {
     companion object {
         private const val TAG = "UsbApduInterface"
@@ -27,7 +29,7 @@ class UsbApduInterface(
             throw IllegalArgumentException("Unsupported card reader; T=0 support is required")
         }
 
-        transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription)
+        transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription, verboseLoggingFlow)
 
         try {
             transceiver.iccPowerOn()
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
index 09d324b07..5ef35afa6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -5,6 +5,9 @@ import android.hardware.usb.UsbEndpoint
 import android.os.SystemClock
 import android.util.Log
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.runBlocking
 import java.nio.ByteBuffer
 import java.nio.ByteOrder
 
@@ -18,7 +21,8 @@ class UsbCcidTransceiver(
     private val usbConnection: UsbDeviceConnection,
     private val usbBulkIn: UsbEndpoint,
     private val usbBulkOut: UsbEndpoint,
-    private val usbCcidDescription: UsbCcidDescription
+    private val usbCcidDescription: UsbCcidDescription,
+    private val verboseLoggingFlow: Flow<Boolean>
 ) {
     companion object {
         private const val TAG = "UsbCcidTransceiver"
@@ -178,7 +182,9 @@ class UsbCcidTransceiver(
             readBytes = usbConnection.bulkTransfer(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
             )
-            Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
+            if (runBlocking { verboseLoggingFlow.first() }) {
+                Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
+            }
         } while (readBytes <= 0 && attempts-- > 0)
         if (readBytes < CCID_HEADER_LENGTH) {
             throw UsbTransportException("USB-CCID error - failed to receive CCID header")
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 17c99ffae..e432f6ce8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -25,6 +25,7 @@ import com.google.android.material.tabs.TabLayoutMediator
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
@@ -140,7 +141,9 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         val knownChannels = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateEuiccChannels().onEach {
                 Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
-                Log.d(TAG, it.lpa.eID)
+                if (preferenceRepository.verboseLoggingFlow.first()) {
+                    Log.d(TAG, it.lpa.eID)
+                }
                 // Request the system to refresh the list of profiles every time we start
                 // Note that this is currently supposed to be no-op when unprivileged,
                 // but it could change in the future
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index b7ad5eef1..64d64c493 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -56,7 +56,6 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
 
     private val barcodeScannerLauncher = registerForActivityResult(ScanContract()) { result ->
         result.contents?.let { content ->
-            Log.d(TAG, content)
             onScanResult(content)
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 2c9964125..5ed43480b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -47,6 +47,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
 
         findPreference<CheckBoxPreference>("pref_advanced_disable_safeguard_removable_esim")
             ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow, PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM)
+
+        findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
+            ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow, PreferenceKeys.VERBOSE_LOGGING)
     }
 
     override fun onStart() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 53153405e..262482ade 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -24,6 +24,7 @@ object PreferenceKeys {
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
     val DISABLE_SAFEGUARD_REMOVABLE_ESIM = booleanPreferencesKey("disable_safeguard_removable_esim")
+    val VERBOSE_LOGGING = booleanPreferencesKey("verbose_logging")
 }
 
 class PreferenceRepository(context: Context) {
@@ -44,6 +45,9 @@ class PreferenceRepository(context: Context) {
     val disableSafeguardFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM] ?: false }
 
+    val verboseLoggingFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.VERBOSE_LOGGING] ?: false }
+
     suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
         dataStore.edit {
             it[key] = value
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index b3a6eb88b..30d2fbe1c 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -82,6 +82,8 @@
     <string name="pref_advanced">Advanced</string>
     <string name="pref_advanced_disable_safeguard_removable_esim">Allow Disabling / Deleting Active Profile</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
+    <string name="pref_advanced_verbose_logging">Verbose Logging</string>
+    <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_info">Info</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index db348fc15..53395ed8b 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -30,6 +30,12 @@
             app:title="@string/pref_advanced_disable_safeguard_removable_esim"
             app:summary="@string/pref_advanced_disable_safeguard_removable_esim_desc" />
 
+        <CheckBoxPreference
+            app:key="pref_advanced_verbose_logging"
+            app:iconSpaceReserved="false"
+            app:title="@string/pref_advanced_verbose_logging"
+            app:summary="@string/pref_advanced_verbose_logging_desc" />
+
         <Preference
             app:key="pref_advanced_logs"
             app:iconSpaceReserved="false"
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 317248b8d..ce57fb80a 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -26,7 +26,15 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                 "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
             )
             try {
-                return EuiccChannel(port, TelephonyManagerApduInterface(port, tm))
+                return EuiccChannel(
+                    port,
+                    TelephonyManagerApduInterface(
+                        port,
+                        tm,
+                        context.preferenceRepository.verboseLoggingFlow
+                    ),
+                    context.preferenceRepository.verboseLoggingFlow
+                )
             } catch (e: IllegalArgumentException) {
                 // Failed
                 Log.w(
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index 509d7ee89..ef877b489 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -2,13 +2,22 @@ package im.angry.openeuicc.core
 
 import android.telephony.IccOpenLogicalChannelResponse
 import android.telephony.TelephonyManager
+import android.util.Log
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.ApduInterface
 
 class TelephonyManagerApduInterface(
     private val port: UiccPortInfoCompat,
-    private val tm: TelephonyManager
+    private val tm: TelephonyManager,
+    private val verboseLoggingFlow: Flow<Boolean>
 ): ApduInterface {
+    companion object {
+        const val TAG = "TelephonyManagerApduInterface"
+    }
+
     private var lastChannel: Int = -1
 
     override val valid: Boolean
@@ -45,6 +54,10 @@ class TelephonyManagerApduInterface(
     override fun transmit(tx: ByteArray): ByteArray {
         check(lastChannel != -1) { "Uninitialized" }
 
+        if (runBlocking { verboseLoggingFlow.first() }) {
+            Log.d(TAG, "TelephonyManager APDU: ${tx.encodeHex()}")
+        }
+
         val cla = tx[0].toUByte().toInt()
         val instruction = tx[1].toUByte().toInt()
         val p1 = tx[2].toUByte().toInt()
@@ -53,7 +66,17 @@ class TelephonyManagerApduInterface(
         val p4 = tx.drop(5).toByteArray().encodeHex()
 
         return tm.iccTransmitApduLogicalChannelByPortCompat(port.card.physicalSlotIndex, port.portIndex, lastChannel,
-            cla, instruction, p1, p2, p3, p4)?.decodeHex() ?: byteArrayOf()
+            cla,
+            instruction,
+            p1,
+            p2,
+            p3,
+            p4
+        ).also {
+            if (runBlocking { verboseLoggingFlow.first() }) {
+                Log.d(TAG, "TelephonyManager APDU response: $it")
+            }
+        }?.decodeHex() ?: byteArrayOf()
     }
 
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 8193ac3b7..dd72ab325 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -1,6 +1,9 @@
 package net.typeblog.lpac_jni.impl
 
 import android.util.Log
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.HttpInterface
 import java.net.URL
 import java.security.SecureRandom
@@ -9,7 +12,7 @@ import javax.net.ssl.SSLContext
 import javax.net.ssl.TrustManager
 import javax.net.ssl.TrustManagerFactory
 
-class HttpInterfaceImpl: HttpInterface {
+class HttpInterfaceImpl(private val verboseLoggingFlow: Flow<Boolean>) : HttpInterface {
     companion object {
         private const val TAG = "HttpInterfaceImpl"
     }
@@ -23,6 +26,10 @@ class HttpInterfaceImpl: HttpInterface {
     ): HttpInterface.HttpResponse {
         Log.d(TAG, "transmit(url = $url)")
 
+        if (runBlocking { verboseLoggingFlow.first() }) {
+            Log.d(TAG, "HTTP tx = ${tx.decodeToString(throwOnInvalidSequence = false)}")
+        }
+
         val parsedUrl = URL(url)
         if (parsedUrl.protocol != "https") {
             throw IllegalArgumentException("SM-DP+ servers must use the HTTPS protocol")
@@ -56,7 +63,16 @@ class HttpInterfaceImpl: HttpInterface {
 
             Log.d(TAG, "transmit responseCode = ${conn.responseCode}")
 
-            return HttpInterface.HttpResponse(conn.responseCode, conn.inputStream.readBytes())
+            val bytes = conn.inputStream.readBytes().also {
+                if (runBlocking { verboseLoggingFlow.first() }) {
+                    Log.d(
+                        TAG,
+                        "HTTP response body = ${it.decodeToString(throwOnInvalidSequence = false)}"
+                    )
+                }
+            }
+
+            return HttpInterface.HttpResponse(conn.responseCode, bytes)
         } catch (e: Exception) {
             e.printStackTrace()
             throw e

From 69e63b0a8b97647b34241d4d348beab4dd4ce11f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 21:46:49 -0400
Subject: [PATCH 160/458] Stop using runBlocking inside suspend funs

---
 .../java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index b943820a0..55fb53d5c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -173,7 +173,7 @@ open class DefaultEuiccChannelManager(
                 try {
                     // tryOpenEuiccChannel() will automatically dispose of invalid channels
                     // and recreate when needed
-                    val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)!!
+                    val channel = findEuiccChannelByPort(physicalSlotId, portId)!!
                     check(channel.valid) { "Invalid channel" }
                     break
                 } catch (e: Exception) {

From ddc421dae7ebc5de421e030a854376760d1b672b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 9 Oct 2024 22:45:09 -0400
Subject: [PATCH 161/458] omapi: Retry on 0x6601 checksum errors

Some removable eUICCs don't play nicely with some modems. When they emit
0x6601 checksum errors, retry at least a few times before giving up.

This fixes support for eSTK.me / JMP eSIM Adapters on Pixel 7 Pro.
---
 .../im/angry/openeuicc/core/OmapiApduInterface.kt | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index f71c87657..b63f343d1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -59,16 +59,25 @@ class OmapiApduInterface(
         }
 
         try {
-            return lastChannel.transmit(tx).also {
+            for (i in 0..10) {
+                val res = lastChannel.transmit(tx)
                 if (runBlocking { verboseLoggingFlow.first() }) {
-                    Log.d(TAG, "OMAPI APDU response: ${it.encodeHex()}")
+                    Log.d(TAG, "OMAPI APDU response: ${res.encodeHex()}")
                 }
+
+                if (res.size == 2 && res[0] == 0x66.toByte() && res[1] == 0x01.toByte()) {
+                    Log.d(TAG, "Received checksum error 0x6601, retrying (count = $i)")
+                    continue
+                }
+
+                return res
             }
+
+            throw RuntimeException("Retransmit attempts exhausted; this was likely caused by checksum errors")
         } catch (e: Exception) {
             Log.e(TAG, "OMAPI APDU exception")
             e.printStackTrace()
             throw e
         }
     }
-
 }
\ No newline at end of file

From 19dc215b3f78617172e1d71fad9d44960711ae14 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 10 Oct 2024 21:52:57 -0400
Subject: [PATCH 162/458] lpac-jni: Update lpac

---
 libs/lpac-jni/src/main/jni/lpac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index 0011ea6cc..a5a0516f0 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit 0011ea6cc4c045c84f7aac839c1cce7804422355
+Subproject commit a5a0516f084936e7e87cf7420fb99283fa3052ef

From d3a04b94a97eb2b81a864cc120bba3b100334308 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Thu, 10 Oct 2024 22:08:32 -0400
Subject: [PATCH 163/458] Set MSS on es10x commands to 60 for OMAPI channels

This seems to help a LOT with 6601 checksum errors on phones like Pixel
7 Pro. I am seeing virtually none with MSS = 60.
---
 .../im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt  | 5 ++++-
 .../java/net/typeblog/lpac_jni/LocalProfileAssistant.kt    | 7 +++++++
 .../src/main/java/net/typeblog/lpac_jni/LpacJni.kt         | 1 +
 .../typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt    | 4 ++++
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c             | 7 +++++++
 5 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index ae984b33c..7f3abb0b3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -41,7 +41,10 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                     context.preferenceRepository.verboseLoggingFlow
                 ),
                 context.preferenceRepository.verboseLoggingFlow
-            )
+            ).also {
+                Log.i(DefaultEuiccChannelManager.TAG, "Is OMAPI channel, setting MSS to 60")
+                it.lpa.setEs10xMss(60)
+            }
         } catch (e: IllegalArgumentException) {
             // Failed
             Log.w(
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 7e0a31bf8..f256caf72 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -8,6 +8,13 @@ interface LocalProfileAssistant {
     // Extended EuiccInfo for use with LUIs, containing information such as firmware version
     val euiccInfo2: EuiccInfo2?
 
+    /**
+     * Set the max segment size (mss) for all es10x commands. This can help with removable
+     * eUICCs that may run at a baud rate too fast for the modem.
+     * By default, this is set to 60 by libeuicc.
+     */
+    fun setEs10xMss(mss: Byte)
+
     // All blocking functions in this class assume that they are executed on non-Main threads
     // The IO context in Kotlin's coroutine library is recommended.
     fun enableProfile(iccid: String, refresh: Boolean = true): Boolean
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 32fbb0aac..f9a2f9011 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -9,6 +9,7 @@ internal object LpacJni {
     external fun destroyContext(handle: Long)
 
     external fun euiccInit(handle: Long): Int
+    external fun euiccSetMss(handle: Long, mss: Byte)
     external fun euiccFini(handle: Long)
 
     // es10c
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 6b3055d0d..51039cde0 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -30,6 +30,10 @@ class LocalProfileAssistantImpl(
         httpInterface.usePublicKeyIds(pkids)
     }
 
+    override fun setEs10xMss(mss: Byte) {
+        LpacJni.euiccSetMss(contextHandle, mss)
+    }
+
     override val valid: Boolean
         get() = !finalized && apduInterface.valid && try {
             // If we can read both eID and euiccInfo2 properly, we are likely looking at
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 1721b7728..f081f8ef6 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -75,6 +75,13 @@ Java_net_typeblog_lpac_1jni_LpacJni_euiccFini(JNIEnv *env, jobject thiz, jlong h
     euicc_fini(ctx);
 }
 
+JNIEXPORT void JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_euiccSetMss(JNIEnv *env, jobject thiz, jlong handle,
+                                                jbyte mss) {
+    struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
+    ctx->es10x_mss = (uint8_t) mss;
+}
+
 jstring toJString(JNIEnv *env, const char *pat) {
     jbyteArray bytes = NULL;
     jstring encoding = NULL;

From 84dd16c16923f5cad93d4ec7bb38b9f3d0ff2337 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 12 Oct 2024 10:39:48 -0400
Subject: [PATCH 164/458] Enable predicative back gestures

---
 app-common/src/main/AndroidManifest.xml                       | 4 +++-
 .../src/main/java/im/angry/openeuicc/ui/LogsActivity.kt       | 4 ++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index a59110b44..aa301cdaa 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -8,7 +8,9 @@
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
 
-    <application>
+    <application
+        android:enableOnBackInvokedCallback="true"
+        tools:targetApi="tiramisu">
         <activity
             android:name="im.angry.openeuicc.ui.SettingsActivity"
             android:label="@string/pref_settings" />
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index e1c9ea1d5..49bfa0f32 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -71,6 +71,10 @@ class LogsActivity : AppCompatActivity() {
     }
 
     override fun onOptionsItemSelected(item: MenuItem): Boolean = when (item.itemId) {
+        android.R.id.home -> {
+            finish()
+            true
+        }
         R.id.save -> {
             saveLogs.launch(getString(R.string.logs_filename_template,
                 SimpleDateFormat.getDateTimeInstance().format(Date())

From eab96dde0558ff45d577dfa3c06c1421133a3ac4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 12 Oct 2024 10:49:47 -0400
Subject: [PATCH 165/458] ui: Reduce blocking operations on transition

---
 .../angry/openeuicc/ui/NotificationsActivity.kt   |  7 ++++---
 .../angry/openeuicc/ui/ProfileDownloadFragment.kt | 15 ++++++++-------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 01de1fcbf..d7a7b66f7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -50,8 +50,9 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     override fun onInit() {
+        val logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
         euiccChannel = euiccChannelManager
-            .findEuiccChannelBySlotBlocking(intent.getIntExtra("logicalSlotId", 0))!!
+            .findEuiccChannelBySlotBlocking(logicalSlotId)!!
 
         notificationList.layoutManager =
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
@@ -61,10 +62,10 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
         // This is slightly different from the MainActivity logic
         // due to the length (we don't want to display the full USB product name)
-        val channelTitle = if (euiccChannel.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+        val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
             getString(R.string.usb)
         } else {
-            getString(R.string.channel_name_format, euiccChannel.logicalSlotId)
+            getString(R.string.channel_name_format, logicalSlotId)
         }
 
         title = getString(R.string.profile_notifications_detailed_format, channelTitle)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 64d64c493..8d6f99a9e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -149,13 +149,6 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
     @SuppressLint("MissingPermission")
     override fun onStart() {
         super.onStart()
-        profileDownloadIMEI.editText!!.text = Editable.Factory.getInstance().newEditable(
-            try {
-                telephonyManager.getImei(channel.logicalSlotId) ?: ""
-            } catch (e: Exception) {
-                ""
-            }
-        )
 
         lifecycleScope.launch(Dispatchers.IO) {
             ensureEuiccChannelManager()
@@ -166,6 +159,12 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 return@launch
             }
 
+            val imei = try {
+                telephonyManager.getImei(channel.logicalSlotId) ?: ""
+            } catch (e: Exception) {
+                ""
+            }
+
             // Fetch remaining NVRAM
             val str = channel.lpa.euiccInfo2?.freeNvram?.also {
                 freeNvram = it
@@ -174,6 +173,8 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
             withContext(Dispatchers.Main) {
                 profileDownloadFreeSpace.text = getString(R.string.profile_download_free_space,
                     str ?: getText(R.string.unknown))
+                profileDownloadIMEI.editText!!.text =
+                    Editable.Factory.getInstance().newEditable(imei)
             }
         }
     }

From 16b6aceedf90fecdca944de85ceafda566eef448 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 12 Oct 2024 11:09:16 -0400
Subject: [PATCH 166/458] ui: Remove more blocking operations in
 NotificationsActivity

---
 .../openeuicc/ui/NotificationsActivity.kt      | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index d7a7b66f7..884e2237d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -50,16 +50,14 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     override fun onInit() {
-        val logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
-        euiccChannel = euiccChannelManager
-            .findEuiccChannelBySlotBlocking(logicalSlotId)!!
-
         notificationList.layoutManager =
             LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
         notificationList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
         notificationList.adapter = notificationAdapter
         registerForContextMenu(notificationList)
 
+        val logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
+
         // This is slightly different from the MainActivity logic
         // due to the length (we don't want to display the full USB product name)
         val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
@@ -106,6 +104,18 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
+            if (!this@NotificationsActivity::euiccChannel.isInitialized) {
+                withContext(Dispatchers.IO) {
+                    euiccChannelManagerLoaded.await()
+                    euiccChannel = euiccChannelManager.findEuiccChannelBySlotBlocking(
+                        intent.getIntExtra(
+                            "logicalSlotId",
+                            0
+                        )
+                    )!!
+                }
+            }
+
             task()
 
             swipeRefresh.isRefreshing = false

From 349c8179b0ba83715ce41ad73e13d7376722a699 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 19 Oct 2024 19:09:35 -0400
Subject: [PATCH 167/458] Force foreground tasks to always complete (i.e. not
 cancelled)

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index fa22dc1c1..0dbd4e745 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -14,6 +14,7 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.NonCancellable
 import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
@@ -194,7 +195,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             updateForegroundNotification(title, iconRes)
 
             try {
-                withContext(Dispatchers.IO) {
+                withContext(Dispatchers.IO + NonCancellable) { // Any LPA-related task must always complete
                     this@EuiccChannelManagerService.task()
                 }
                 // This update will be sent by the subscriber (as shown below)

From 4709b6994fa043b6a1981ec5e4c463d0d7ed98b9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 19 Oct 2024 19:14:14 -0400
Subject: [PATCH 168/458] Don't call stopSelf() if the coroutine is cancelled

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 0dbd4e745..73c38969f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -25,6 +25,7 @@ import kotlinx.coroutines.flow.onCompletion
 import kotlinx.coroutines.flow.onStart
 import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
+import kotlinx.coroutines.isActive
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.withTimeoutOrNull
@@ -205,7 +206,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 Log.e(TAG, Log.getStackTraceString(t))
                 foregroundTaskState.value = ForegroundTaskState.Done(t)
             } finally {
-                stopSelf()
+                if (isActive) {
+                    stopSelf()
+                }
             }
         }
 

From 7197501cca1d283c646afa2c3bb4dd859f9e723f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 19 Oct 2024 21:13:07 -0400
Subject: [PATCH 169/458] ProfileDownloadFragment: Stop catching all exceptions

..instead, use the error value returned in the foreground task result.

Catching all exceptions will result in cancellation being ignored when
the fragment is destroyed.
---
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 8d6f99a9e..a45a1ea43 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -215,18 +215,22 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-            try {
-                doDownloadProfile(server, code, confirmationCode, imei)
-            } catch (e: Exception) {
+            val res = doDownloadProfile(server, code, confirmationCode, imei)
+
+            if (res == null || res.error != null) {
                 Log.d(TAG, "Error downloading profile")
-                Log.d(TAG, Log.getStackTraceString(e))
-                Toast.makeText(context, R.string.profile_download_failed, Toast.LENGTH_LONG).show()
-            } finally {
-                if (parentFragment is EuiccProfilesChangedListener) {
-                    (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
+
+                if (res?.error != null) {
+                    Log.d(TAG, Log.getStackTraceString(res.error))
                 }
-                dismiss()
+
+                Toast.makeText(requireContext(), R.string.profile_download_failed, Toast.LENGTH_LONG).show()
             }
+
+            if (parentFragment is EuiccProfilesChangedListener) {
+                (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
+            }
+            dismiss()
         }
     }
 
@@ -254,7 +258,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
             }
         }.last()
 
-        (res as? EuiccChannelManagerService.ForegroundTaskState.Done)?.error?.let { throw it }
+        res as? EuiccChannelManagerService.ForegroundTaskState.Done
     }
 
     override fun onDismiss(dialog: DialogInterface) {

From 2337ad035db31d87ed706aafbeb93f61dd96d570 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Oct 2024 11:44:20 -0400
Subject: [PATCH 170/458] Post a notification to signify task failure from
 service

---
 .../service/EuiccChannelManagerService.kt     | 29 ++++++++++++++++++-
 .../src/main/res/drawable/ic_x_black.xml      |  5 ++++
 app-common/src/main/res/values/strings.xml    |  4 +++
 3 files changed, 37 insertions(+), 1 deletion(-)
 create mode 100644 app-common/src/main/res/drawable/ic_x_black.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 73c38969f..74845db0d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -55,6 +55,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         private const val TAG = "EuiccChannelManagerService"
         private const val CHANNEL_ID = "tasks"
         private const val FOREGROUND_ID = 1000
+        private const val TASK_FAILURE_ID = 1001
     }
 
     inner class LocalBinder : Binder() {
@@ -108,7 +109,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         }
     }
 
-    private suspend fun updateForegroundNotification(title: String, iconRes: Int) {
+    private fun ensureForegroundTaskNotificationChannel() {
         val nm = NotificationManagerCompat.from(this)
         if (nm.getNotificationChannelCompat(CHANNEL_ID) == null) {
             val channel =
@@ -121,7 +122,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                     .build()
             nm.createNotificationChannel(channel)
         }
+    }
 
+    private suspend fun updateForegroundNotification(title: String, iconRes: Int) {
+        ensureForegroundTaskNotificationChannel()
+
+        val nm = NotificationManagerCompat.from(this)
         val state = foregroundTaskState.value
 
         if (state is ForegroundTaskState.InProgress) {
@@ -148,6 +154,18 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         }
     }
 
+    private fun postForegroundTaskFailureNotification(title: String) {
+        if (checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
+            return
+        }
+
+        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
+            .setContentTitle(title)
+            .setSmallIcon(R.drawable.ic_x_black)
+            .build()
+        NotificationManagerCompat.from(this).notify(TASK_FAILURE_ID, notification)
+    }
+
     /**
      * Launch a potentially blocking foreground task in this service's lifecycle context.
      * This function does not block, but returns a Flow that emits ForegroundTaskState
@@ -164,6 +182,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
      */
     private fun launchForegroundTask(
         title: String,
+        failureTitle: String,
         iconRes: Int,
         task: suspend EuiccChannelManagerService.() -> Unit
     ): Flow<ForegroundTaskState>? {
@@ -205,6 +224,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 Log.e(TAG, "Foreground task encountered an error")
                 Log.e(TAG, Log.getStackTraceString(t))
                 foregroundTaskState.value = ForegroundTaskState.Done(t)
+
+                if (isActive) {
+                    postForegroundTaskFailureNotification(failureTitle)
+                }
             } finally {
                 if (isActive) {
                     stopSelf()
@@ -260,6 +283,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     ): Flow<ForegroundTaskState>? =
         launchForegroundTask(
             getString(R.string.task_profile_download),
+            getString(R.string.task_profile_download_failure),
             R.drawable.ic_task_sim_card_download
         ) {
             euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
@@ -294,6 +318,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     ): Flow<ForegroundTaskState>? =
         launchForegroundTask(
             getString(R.string.task_profile_rename),
+            getString(R.string.task_profile_rename_failure),
             R.drawable.ic_task_rename
         ) {
             val res = euiccChannelManager.findEuiccChannelByPort(slotId, portId)!!.lpa.setNickname(
@@ -313,6 +338,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     ): Flow<ForegroundTaskState>? =
         launchForegroundTask(
             getString(R.string.task_profile_delete),
+            getString(R.string.task_profile_delete_failure),
             R.drawable.ic_task_delete
         ) {
             euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
@@ -336,6 +362,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     ): Flow<ForegroundTaskState>? =
         launchForegroundTask(
             getString(R.string.task_profile_switch),
+            getString(R.string.task_profile_switch_failure),
             R.drawable.ic_task_switch
         ) {
             euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
diff --git a/app-common/src/main/res/drawable/ic_x_black.xml b/app-common/src/main/res/drawable/ic_x_black.xml
new file mode 100644
index 000000000..f8ca0c64b
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_x_black.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M19,6.41L17.59,5 12,10.59 6.41,5 5,6.41 10.59,12 5,17.59 6.41,19 12,13.41 17.59,19 19,17.59 13.41,12z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 30d2fbe1c..0278ffae7 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -35,9 +35,13 @@
 
     <string name="task_notification">Long-running Tasks</string>
     <string name="task_profile_download">Downloading eSIM profile</string>
+    <string name="task_profile_download_failure">Failed to download eSIM profile</string>
     <string name="task_profile_rename">Renaming eSIM profile</string>
+    <string name="task_profile_rename_failure">Failed to rename eSIM profile</string>
     <string name="task_profile_delete">Deleting eSIM profile</string>
+    <string name="task_profile_delete_failure">Failed to delete eSIM profile</string>
     <string name="task_profile_switch">Switching eSIM profile</string>
+    <string name="task_profile_switch_failure">Failed to switch eSIM profile</string>
 
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>

From aac457f4b5739cb8d6ef0251e5680fba7e312d00 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Oct 2024 11:45:27 -0400
Subject: [PATCH 171/458] Don't dismiss DialogFragment's when in background

They shall be dismissed automatically. Doing it here may cause
IllegalStateException.

Note that even if they are dismissed, the corresponding tasks will
continue to be executed by EuiccChannelManagerService and will not be
cancelled.
---
 .../java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt    | 6 +++++-
 .../java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt  | 7 ++++++-
 .../java/im/angry/openeuicc/ui/ProfileRenameFragment.kt    | 6 +++++-
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index 467132fa7..901f263a1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -81,7 +81,11 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
                     (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
                 }
 
-                dismiss()
+                try {
+                    dismiss()
+                } catch (e: IllegalStateException) {
+                    // Ignored
+                }
             }.collect()
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index a45a1ea43..843c9e5fe 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -230,7 +230,12 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
             if (parentFragment is EuiccProfilesChangedListener) {
                 (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
             }
-            dismiss()
+
+            try {
+                dismiss()
+            } catch (e: IllegalStateException) {
+                // Ignored
+            }
         }
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 84fd0cd15..278ea4371 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -106,7 +106,11 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
                 (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
             }
 
-            dismiss()
+            try {
+                dismiss()
+            } catch (e: IllegalStateException) {
+                // Ignored
+            }
         }
     }
 }
\ No newline at end of file

From d26a8ddc7867fcd941502a3f174ccb89ca74b84b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Oct 2024 20:37:44 -0400
Subject: [PATCH 172/458] EuiccChannelManagerService: stop using blocking
 variants unnecessarily

---
 .../service/EuiccChannelManagerService.kt     |  8 ++---
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 36 +++++++++++++++++++
 2 files changed, 40 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 74845db0d..8db3bbe59 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -286,7 +286,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_profile_download_failure),
             R.drawable.ic_task_sim_card_download
         ) {
-            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+            euiccChannelManager.beginTrackedOperation(slotId, portId) {
                 val channel = euiccChannelManager.findEuiccChannelByPort(slotId, portId)
                 val res = channel!!.lpa.downloadProfile(
                     smdp,
@@ -341,7 +341,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_profile_delete_failure),
             R.drawable.ic_task_delete
         ) {
-            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
+            euiccChannelManager.beginTrackedOperation(slotId, portId) {
                 euiccChannelManager.findEuiccChannelByPort(
                     slotId,
                     portId
@@ -365,8 +365,8 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_profile_switch_failure),
             R.drawable.ic_task_switch
         ) {
-            euiccChannelManager.beginTrackedOperationBlocking(slotId, portId) {
-                val channel = euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
+            euiccChannelManager.beginTrackedOperation(slotId, portId) {
+                val channel = euiccChannelManager.findEuiccChannelByPort(slotId, portId)!!
                 val (res, refreshed) =
                     if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
                         // Sometimes, we *can* enable or disable the profile, but we cannot
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 50b207757..e7a3322d5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -73,6 +73,42 @@ fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean
  * should be the concern of op() itself, and this function assumes that when
  * op() returns, the slotId and portId will correspond to a valid channel again.
  */
+suspend inline fun EuiccChannelManager.beginTrackedOperation(
+    slotId: Int,
+    portId: Int,
+    op: () -> Boolean
+) {
+    val latestSeq =
+        findEuiccChannelByPort(slotId, portId)!!.lpa.notifications.firstOrNull()?.seqNumber
+            ?: 0
+    Log.d(TAG, "Latest notification is $latestSeq before operation")
+    if (op()) {
+        Log.d(TAG, "Operation has requested notification handling")
+        try {
+            // Note that the exact instance of "channel" might have changed here if reconnected;
+            // so we MUST use the automatic getter for "channel"
+            findEuiccChannelByPort(
+                slotId,
+                portId
+            )?.lpa?.notifications?.filter { it.seqNumber > latestSeq }?.forEach {
+                Log.d(TAG, "Handling notification $it")
+                findEuiccChannelByPort(
+                    slotId,
+                    portId
+                )?.lpa?.handleNotification(it.seqNumber)
+            }
+        } catch (e: Exception) {
+            // Ignore any error during notification handling
+            e.printStackTrace()
+        }
+    }
+    Log.d(TAG, "Operation complete")
+}
+
+/**
+ * Same as beginTrackedOperation but uses blocking primitives.
+ * TODO: This function needs to be phased out of use.
+ */
 inline fun EuiccChannelManager.beginTrackedOperationBlocking(
     slotId: Int,
     portId: Int,

From 65c9a7dc39bc88e23c9a6b8b4c7bd6091f30f5ac Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 23 Oct 2024 04:17:48 +0200
Subject: [PATCH 173/458] fix: refer url (#53)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/53
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index 13848b637..5167da55c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -35,7 +35,7 @@ internal fun keyIdToKeystore(keyIds: Array<String>): KeyStore {
     return ret
 }
 
-// ref: <https://euicc-manual.septs.app/docs/pki/ci/>
+// ref: <https://euicc-manual.osmocom.org/docs/pki/ci/>
 internal val KNOWN_CI_CERTS = hashMapOf(
     // GSM Association - RSP2 Root CI1 (CA: DigiCert)
     // Specs: SGP.21 and SGP.22 version 2 and version 3

From 7cb872a664eabc25ee9ccd176154aa2fae2d0bad Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 15:23:49 -0400
Subject: [PATCH 174/458] Add new withEuiccChannel() method to
 EuiccChannelManager

---
 .../angry/openeuicc/core/DefaultEuiccChannelManager.kt | 10 ++++++++++
 .../im/angry/openeuicc/core/EuiccChannelManager.kt     | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 55fb53d5c..af69c120c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -159,6 +159,16 @@ open class DefaultEuiccChannelManager(
             findEuiccChannelByPort(physicalSlotId, portId)
         }
 
+    override suspend fun <R> withEuiccChannel(
+        physicalSlotId: Int,
+        portId: Int,
+        fn: (EuiccChannel) -> R
+    ): R {
+        val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)
+            ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
+        return fn(channel)
+    }
+
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
         if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) return
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index b21ccf614..304269dd5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -64,6 +64,16 @@ interface EuiccChannelManager {
     suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel?
     fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
 
+    class EuiccChannelNotFoundException: Exception("EuiccChannel not found")
+
+    /**
+     * Find a EuiccChannel by its slot and port, then run a callback with a reference to it.
+     * The reference is not supposed to be held outside of the callback.
+     *
+     * If a channel for that slot / port is not found, EuiccChannelNotFoundException is thrown
+     */
+    suspend fun <R> withEuiccChannel(physicalSlotId: Int, portId: Int, fn: (EuiccChannel) -> R): R
+
     /**
      * Invalidate all EuiccChannels previously cached by this Manager
      */

From d54fcf2589c4e94dc041b4d5d857a56a8e7dbd80 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 15:31:52 -0400
Subject: [PATCH 175/458] refactor: Make EuiccChannel abstract

This allows wrapping to control reference lifetime outside of
EuiccChannelManager.
---
 .../core/DefaultEuiccChannelFactory.kt        |  4 +--
 .../im/angry/openeuicc/core/EuiccChannel.kt   | 26 +++++++------------
 .../angry/openeuicc/core/EuiccChannelImpl.kt  | 26 +++++++++++++++++++
 .../core/PrivilegedEuiccChannelFactory.kt     |  2 +-
 4 files changed, 38 insertions(+), 20 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 7f3abb0b3..2365b071f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -33,7 +33,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
 
         Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
         try {
-            return EuiccChannel(
+            return EuiccChannelImpl(
                 port,
                 OmapiApduInterface(
                     seService!!,
@@ -61,7 +61,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         if (bulkIn == null || bulkOut == null) return null
         val conn = usbManager.openDevice(usbDevice) ?: return null
         if (!conn.claimInterface(usbInterface, true)) return null
-        return EuiccChannel(
+        return EuiccChannelImpl(
             FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
             UsbApduInterface(
                 conn,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index e10653501..11ac7b049 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -1,26 +1,18 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.Flow
-import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
-import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
-import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 
-class EuiccChannel(
-    val port: UiccPortInfoCompat,
-    apduInterface: ApduInterface,
-    verboseLoggingFlow: Flow<Boolean>
-) {
-    val slotId = port.card.physicalSlotIndex // PHYSICAL slot
-    val logicalSlotId = port.logicalSlotIndex
-    val portId = port.portIndex
+interface EuiccChannel {
+    val port: UiccPortInfoCompat
 
-    val lpa: LocalProfileAssistant =
-        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow))
+    val slotId: Int // PHYSICAL slot
+    val logicalSlotId: Int
+    val portId: Int
+
+    val lpa: LocalProfileAssistant
 
     val valid: Boolean
-        get() = lpa.valid
 
-    fun close() = lpa.close()
-}
+    fun close()
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
new file mode 100644
index 000000000..0c0b00ee4
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -0,0 +1,26 @@
+package im.angry.openeuicc.core
+
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.Flow
+import net.typeblog.lpac_jni.ApduInterface
+import net.typeblog.lpac_jni.LocalProfileAssistant
+import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
+import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
+
+class EuiccChannelImpl(
+    override val port: UiccPortInfoCompat,
+    apduInterface: ApduInterface,
+    verboseLoggingFlow: Flow<Boolean>
+) : EuiccChannel {
+    override val slotId = port.card.physicalSlotIndex
+    override val logicalSlotId = port.logicalSlotIndex
+    override val portId = port.portIndex
+
+    override val lpa: LocalProfileAssistant =
+        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow))
+
+    override val valid: Boolean
+        get() = lpa.valid
+
+    override fun close() = lpa.close()
+}
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index ce57fb80a..14e00200a 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -26,7 +26,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                 "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
             )
             try {
-                return EuiccChannel(
+                return EuiccChannelImpl(
                     port,
                     TelephonyManagerApduInterface(
                         port,

From 76e8fbd56b1561965d616e7998cd3f2172811c33 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 15:46:43 -0400
Subject: [PATCH 176/458] Use wrappers to enforce that withEuiccChannel can't
 leak references

---
 .../core/DefaultEuiccChannelManager.kt        |  7 +-
 .../openeuicc/core/EuiccChannelManager.kt     |  3 +-
 .../openeuicc/core/EuiccChannelWrapper.kt     | 41 ++++++++++++
 .../core/LocalProfileAssistantWrapper.kt      | 64 +++++++++++++++++++
 4 files changed, 113 insertions(+), 2 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index af69c120c..458552572 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -166,7 +166,12 @@ open class DefaultEuiccChannelManager(
     ): R {
         val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)
             ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
-        return fn(channel)
+        val wrapper = EuiccChannelWrapper(channel)
+        try {
+            return fn(wrapper)
+        } finally {
+            wrapper.invalidateWrapper()
+        }
     }
 
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 304269dd5..171c21572 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -68,7 +68,8 @@ interface EuiccChannelManager {
 
     /**
      * Find a EuiccChannel by its slot and port, then run a callback with a reference to it.
-     * The reference is not supposed to be held outside of the callback.
+     * The reference is not supposed to be held outside of the callback. This is enforced via
+     * a wrapper object.
      *
      * If a channel for that slot / port is not found, EuiccChannelNotFoundException is thrown
      */
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
new file mode 100644
index 000000000..826ba41d1
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -0,0 +1,41 @@
+package im.angry.openeuicc.core
+
+import im.angry.openeuicc.util.*
+import net.typeblog.lpac_jni.LocalProfileAssistant
+
+class EuiccChannelWrapper(private val _inner: EuiccChannel) : EuiccChannel {
+    private var wrapperInvalidated = false
+
+    private val channel: EuiccChannel
+        get() {
+            if (wrapperInvalidated) {
+                throw IllegalStateException("This wrapper has been invalidated")
+            }
+
+            return _inner
+        }
+    override val port: UiccPortInfoCompat
+        get() = channel.port
+    override val slotId: Int
+        get() = channel.slotId
+    override val logicalSlotId: Int
+        get() = channel.logicalSlotId
+    override val portId: Int
+        get() = channel.portId
+    private val lpaDelegate = lazy {
+        LocalProfileAssistantWrapper(_inner.lpa)
+    }
+    override val lpa: LocalProfileAssistant by lpaDelegate
+    override val valid: Boolean
+        get() = channel.valid
+
+    override fun close() = channel.close()
+
+    fun invalidateWrapper() {
+        wrapperInvalidated = true
+
+        if (lpaDelegate.isInitialized()) {
+            (lpa as LocalProfileAssistantWrapper).invalidateWrapper()
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
new file mode 100644
index 000000000..660dbc2b0
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -0,0 +1,64 @@
+package im.angry.openeuicc.core
+
+import net.typeblog.lpac_jni.EuiccInfo2
+import net.typeblog.lpac_jni.LocalProfileAssistant
+import net.typeblog.lpac_jni.LocalProfileInfo
+import net.typeblog.lpac_jni.LocalProfileNotification
+import net.typeblog.lpac_jni.ProfileDownloadCallback
+
+class LocalProfileAssistantWrapper(private val _inner: LocalProfileAssistant) :
+    LocalProfileAssistant {
+
+    private var wrapperInvalidated = false
+
+    private val lpa: LocalProfileAssistant
+        get() {
+            if (wrapperInvalidated) {
+                throw IllegalStateException("This wrapper has been invalidated")
+            }
+
+            return _inner
+        }
+
+    override val valid: Boolean
+        get() = lpa.valid
+    override val profiles: List<LocalProfileInfo>
+        get() = lpa.profiles
+    override val notifications: List<LocalProfileNotification>
+        get() = lpa.notifications
+    override val eID: String
+        get() = lpa.eID
+    override val euiccInfo2: EuiccInfo2?
+        get() = lpa.euiccInfo2
+
+    override fun setEs10xMss(mss: Byte) = lpa.setEs10xMss(mss)
+
+    override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
+        lpa.enableProfile(iccid, refresh)
+
+    override fun disableProfile(iccid: String, refresh: Boolean): Boolean =
+        lpa.disableProfile(iccid, refresh)
+
+    override fun deleteProfile(iccid: String): Boolean = lpa.deleteProfile(iccid)
+
+    override fun downloadProfile(
+        smdp: String,
+        matchingId: String?,
+        imei: String?,
+        confirmationCode: String?,
+        callback: ProfileDownloadCallback
+    ): Boolean = lpa.downloadProfile(smdp, matchingId, imei, confirmationCode, callback)
+
+    override fun deleteNotification(seqNumber: Long): Boolean = lpa.deleteNotification(seqNumber)
+
+    override fun handleNotification(seqNumber: Long): Boolean = lpa.handleNotification(seqNumber)
+
+    override fun setNickname(iccid: String, nickname: String): Boolean =
+        lpa.setNickname(iccid, nickname)
+
+    override fun close() = lpa.close()
+
+    fun invalidateWrapper() {
+        wrapperInvalidated = true
+    }
+}
\ No newline at end of file

From ef622740573d3d2fea0cac410a3e0f9991b096e5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 15:49:38 -0400
Subject: [PATCH 177/458] Wrappers shouldn't hold references indefinitely

---
 .../im/angry/openeuicc/core/EuiccChannelWrapper.kt   | 12 ++++++------
 .../openeuicc/core/LocalProfileAssistantWrapper.kt   | 11 +++++------
 2 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index 826ba41d1..048881352 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -3,16 +3,16 @@ package im.angry.openeuicc.core
 import im.angry.openeuicc.util.*
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
-class EuiccChannelWrapper(private val _inner: EuiccChannel) : EuiccChannel {
-    private var wrapperInvalidated = false
+class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
+    private var _inner: EuiccChannel? = orig
 
     private val channel: EuiccChannel
         get() {
-            if (wrapperInvalidated) {
+            if (_inner == null) {
                 throw IllegalStateException("This wrapper has been invalidated")
             }
 
-            return _inner
+            return _inner!!
         }
     override val port: UiccPortInfoCompat
         get() = channel.port
@@ -23,7 +23,7 @@ class EuiccChannelWrapper(private val _inner: EuiccChannel) : EuiccChannel {
     override val portId: Int
         get() = channel.portId
     private val lpaDelegate = lazy {
-        LocalProfileAssistantWrapper(_inner.lpa)
+        LocalProfileAssistantWrapper(channel.lpa)
     }
     override val lpa: LocalProfileAssistant by lpaDelegate
     override val valid: Boolean
@@ -32,7 +32,7 @@ class EuiccChannelWrapper(private val _inner: EuiccChannel) : EuiccChannel {
     override fun close() = channel.close()
 
     fun invalidateWrapper() {
-        wrapperInvalidated = true
+        _inner = null
 
         if (lpaDelegate.isInitialized()) {
             (lpa as LocalProfileAssistantWrapper).invalidateWrapper()
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index 660dbc2b0..e6a648afc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -6,18 +6,17 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
-class LocalProfileAssistantWrapper(private val _inner: LocalProfileAssistant) :
+class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
     LocalProfileAssistant {
-
-    private var wrapperInvalidated = false
+    private var _inner: LocalProfileAssistant? = orig
 
     private val lpa: LocalProfileAssistant
         get() {
-            if (wrapperInvalidated) {
+            if (_inner == null) {
                 throw IllegalStateException("This wrapper has been invalidated")
             }
 
-            return _inner
+            return _inner!!
         }
 
     override val valid: Boolean
@@ -59,6 +58,6 @@ class LocalProfileAssistantWrapper(private val _inner: LocalProfileAssistant) :
     override fun close() = lpa.close()
 
     fun invalidateWrapper() {
-        wrapperInvalidated = true
+        _inner = null
     }
 }
\ No newline at end of file

From 95b24e61514002065d8333fb2a8fda22568c7bbc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 21:29:09 -0400
Subject: [PATCH 178/458] Add withEuiccChannel helper for EuiccChannelFragment

---
 .../im/angry/openeuicc/core/DefaultEuiccChannelManager.kt | 6 ++++--
 .../java/im/angry/openeuicc/core/EuiccChannelManager.kt   | 8 +++++++-
 .../im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt  | 5 +++++
 3 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 458552572..4bf634f30 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -162,13 +162,15 @@ open class DefaultEuiccChannelManager(
     override suspend fun <R> withEuiccChannel(
         physicalSlotId: Int,
         portId: Int,
-        fn: (EuiccChannel) -> R
+        fn: suspend (EuiccChannel) -> R
     ): R {
         val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)
             ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
         val wrapper = EuiccChannelWrapper(channel)
         try {
-            return fn(wrapper)
+            return withContext(Dispatchers.IO) {
+                fn(wrapper)
+            }
         } finally {
             wrapper.invalidateWrapper()
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 171c21572..0626c80ce 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -71,9 +71,15 @@ interface EuiccChannelManager {
      * The reference is not supposed to be held outside of the callback. This is enforced via
      * a wrapper object.
      *
+     * The callback is run on Dispatchers.IO by default.
+     *
      * If a channel for that slot / port is not found, EuiccChannelNotFoundException is thrown
      */
-    suspend fun <R> withEuiccChannel(physicalSlotId: Int, portId: Int, fn: (EuiccChannel) -> R): R
+    suspend fun <R> withEuiccChannel(
+        physicalSlotId: Int,
+        portId: Int,
+        fn: suspend (EuiccChannel) -> R
+    ): R
 
     /**
      * Invalidate all EuiccChannels previously cached by this Manager
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index e92be4088..3a74fbb08 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -40,6 +40,11 @@ val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
     get() =
         euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
 
+suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R where T : Fragment, T : EuiccChannelFragmentMarker {
+    ensureEuiccChannelManager()
+    return euiccChannelManager.withEuiccChannel(slotId, portId, fn)
+}
+
 suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: EuiccChannelFragmentMarker =
     (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerLoaded.await()
 

From 3b868e4f9abeb8e4746f1be83e2a66bfdfd46da0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 21:41:56 -0400
Subject: [PATCH 179/458] Move some fragments to withEuiccChannel()

---
 .../openeuicc/ui/EuiccManagementFragment.kt   | 13 +++++---
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 32 +++++++++++--------
 2 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index da2912305..7d47ae1da 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -6,7 +6,6 @@ import android.content.ClipboardManager
 import android.content.Intent
 import android.os.Bundle
 import android.text.method.PasswordTransformationMethod
-import android.util.Log
 import android.view.LayoutInflater
 import android.view.Menu
 import android.view.MenuInflater
@@ -52,6 +51,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var fab: FloatingActionButton
     private lateinit var profileList: RecyclerView
+    private var logicalSlotId: Int = -1
 
     private val adapter = EuiccProfileAdapter()
 
@@ -127,9 +127,11 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     override fun onOptionsItemSelected(item: MenuItem): Boolean =
         when (item.itemId) {
             R.id.show_notifications -> {
-                Intent(requireContext(), NotificationsActivity::class.java).apply {
-                    putExtra("logicalSlotId", channel.logicalSlotId)
-                    startActivity(this)
+                if (logicalSlotId != -1) {
+                    Intent(requireContext(), NotificationsActivity::class.java).apply {
+                        putExtra("logicalSlotId", logicalSlotId)
+                        startActivity(this)
+                    }
                 }
                 true
             }
@@ -162,7 +164,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
             }
 
-            val profiles = withContext(Dispatchers.IO) {
+            val profiles = withEuiccChannel { channel ->
+                logicalSlotId = channel.logicalSlotId
                 euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
                 channel.lpa.profiles.operational
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 843c9e5fe..9aa55068a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -159,22 +159,26 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 return@launch
             }
 
-            val imei = try {
-                telephonyManager.getImei(channel.logicalSlotId) ?: ""
-            } catch (e: Exception) {
-                ""
-            }
+            withEuiccChannel { channel ->
+                val imei = try {
+                    telephonyManager.getImei(channel.logicalSlotId) ?: ""
+                } catch (e: Exception) {
+                    ""
+                }
 
-            // Fetch remaining NVRAM
-            val str = channel.lpa.euiccInfo2?.freeNvram?.also {
-                freeNvram = it
-            }?.let { formatFreeSpace(it) }
+                // Fetch remaining NVRAM
+                val str = channel.lpa.euiccInfo2?.freeNvram?.also {
+                    freeNvram = it
+                }?.let { formatFreeSpace(it) }
 
-            withContext(Dispatchers.Main) {
-                profileDownloadFreeSpace.text = getString(R.string.profile_download_free_space,
-                    str ?: getText(R.string.unknown))
-                profileDownloadIMEI.editText!!.text =
-                    Editable.Factory.getInstance().newEditable(imei)
+                withContext(Dispatchers.Main) {
+                    profileDownloadFreeSpace.text = getString(
+                        R.string.profile_download_free_space,
+                        str ?: getText(R.string.unknown)
+                    )
+                    profileDownloadIMEI.editText!!.text =
+                        Editable.Factory.getInstance().newEditable(imei)
+                }
             }
         }
     }

From 0961ef70f400825cf061bec0957dc71378ee3dba Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 21:45:14 -0400
Subject: [PATCH 180/458] New withEuiccChannel() variant with logical slot ID

---
 .../openeuicc/core/DefaultEuiccChannelManager.kt | 16 ++++++++++++++++
 .../angry/openeuicc/core/EuiccChannelManager.kt  |  8 ++++++++
 2 files changed, 24 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 4bf634f30..53418b72a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -176,6 +176,22 @@ open class DefaultEuiccChannelManager(
         }
     }
 
+    override suspend fun <R> withEuiccChannel(
+        logicalSlotId: Int,
+        fn: suspend (EuiccChannel) -> R
+    ): R {
+        val channel = findEuiccChannelBySlotBlocking(logicalSlotId)
+            ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
+        val wrapper = EuiccChannelWrapper(channel)
+        try {
+            return withContext(Dispatchers.IO) {
+                fn(wrapper)
+            }
+        } finally {
+            wrapper.invalidateWrapper()
+        }
+    }
+
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
         if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) return
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 0626c80ce..a4968c786 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -81,6 +81,14 @@ interface EuiccChannelManager {
         fn: suspend (EuiccChannel) -> R
     ): R
 
+    /**
+     * Same as withEuiccChannel(Int, Int, (EuiccChannel) -> R) but instead uses logical slot ID
+     */
+    suspend fun <R> withEuiccChannel(
+        logicalSlotId: Int,
+        fn: suspend (EuiccChannel) -> R
+    ): R
+
     /**
      * Invalidate all EuiccChannels previously cached by this Manager
      */

From 8ac46bd77890f0243edb190910e0452fa56fc5fd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 21:46:13 -0400
Subject: [PATCH 181/458] Move findEuiccChannelBySlot to non-blocking

---
 .../core/DefaultEuiccChannelManager.kt        | 33 ++++++++++---------
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 53418b72a..91a859df9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -88,23 +88,26 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-                    return@withContext usbChannel
-                }
+    private suspend fun findEuiccChannelBySlot(logicalSlotId: Int): EuiccChannel? =
+        withContext(Dispatchers.IO) {
+            if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                return@withContext usbChannel
+            }
 
-                for (card in uiccCards) {
-                    for (port in card.ports) {
-                        if (port.logicalSlotIndex == logicalSlotId) {
-                            return@withContext tryOpenEuiccChannel(port)
-                        }
+            for (card in uiccCards) {
+                for (port in card.ports) {
+                    if (port.logicalSlotIndex == logicalSlotId) {
+                        return@withContext tryOpenEuiccChannel(port)
                     }
                 }
-
-                null
             }
+
+            null
+        }
+
+    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
+        runBlocking {
+            findEuiccChannelBySlot(logicalSlotId)
         }
 
     override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
@@ -164,7 +167,7 @@ open class DefaultEuiccChannelManager(
         portId: Int,
         fn: suspend (EuiccChannel) -> R
     ): R {
-        val channel = findEuiccChannelByPortBlocking(physicalSlotId, portId)
+        val channel = findEuiccChannelByPort(physicalSlotId, portId)
             ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
         val wrapper = EuiccChannelWrapper(channel)
         try {
@@ -180,7 +183,7 @@ open class DefaultEuiccChannelManager(
         logicalSlotId: Int,
         fn: suspend (EuiccChannel) -> R
     ): R {
-        val channel = findEuiccChannelBySlotBlocking(logicalSlotId)
+        val channel = findEuiccChannelBySlot(logicalSlotId)
             ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
         val wrapper = EuiccChannelWrapper(channel)
         try {

From 6a2d4d66dd8547053ae6d9d1624cf460cdaa850c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 21:52:33 -0400
Subject: [PATCH 182/458] Move EuiccChannelManagerService to withEuiccChannel()

---
 .../service/EuiccChannelManagerService.kt     | 51 ++++++++++---------
 1 file changed, 28 insertions(+), 23 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 8db3bbe59..fce3d3058 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -287,19 +287,20 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             R.drawable.ic_task_sim_card_download
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                val channel = euiccChannelManager.findEuiccChannelByPort(slotId, portId)
-                val res = channel!!.lpa.downloadProfile(
-                    smdp,
-                    matchingId,
-                    imei,
-                    confirmationCode,
-                    object : ProfileDownloadCallback {
-                        override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
-                            if (state.progress == 0) return
-                            foregroundTaskState.value =
-                                ForegroundTaskState.InProgress(state.progress)
-                        }
-                    })
+                val res = euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                    channel.lpa.downloadProfile(
+                        smdp,
+                        matchingId,
+                        imei,
+                        confirmationCode,
+                        object : ProfileDownloadCallback {
+                            override fun onStateUpdate(state: ProfileDownloadCallback.DownloadState) {
+                                if (state.progress == 0) return
+                                foregroundTaskState.value =
+                                    ForegroundTaskState.InProgress(state.progress)
+                            }
+                        })
+                }
 
                 if (!res) {
                     // TODO: Provide more details on the error
@@ -321,10 +322,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_profile_rename_failure),
             R.drawable.ic_task_rename
         ) {
-            val res = euiccChannelManager.findEuiccChannelByPort(slotId, portId)!!.lpa.setNickname(
-                iccid,
-                name
-            )
+            val res = euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                channel.lpa.setNickname(
+                    iccid,
+                    name
+                )
+            }
 
             if (!res) {
                 throw RuntimeException("Profile not renamed")
@@ -342,10 +345,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             R.drawable.ic_task_delete
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                euiccChannelManager.findEuiccChannelByPort(
-                    slotId,
-                    portId
-                )!!.lpa.deleteProfile(iccid)
+                euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                    channel.lpa.deleteProfile(iccid)
+                }
 
                 preferenceRepository.notificationDeleteFlow.first()
             }
@@ -366,8 +368,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             R.drawable.ic_task_switch
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                val channel = euiccChannelManager.findEuiccChannelByPort(slotId, portId)!!
-                val (res, refreshed) =
+                val (res, refreshed) = euiccChannelManager.withEuiccChannel(
+                    slotId,
+                    portId
+                ) { channel ->
                     if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
                         // Sometimes, we *can* enable or disable the profile, but we cannot
                         // send the refresh command to the modem because the profile somehow
@@ -378,6 +382,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                     } else {
                         Pair(true, true)
                     }
+                }
 
                 if (!res) {
                     throw RuntimeException("Could not switch profile")

From 3d4704e77b6e882a9a74c113aa47d316990149fb Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 26 Oct 2024 22:15:02 -0400
Subject: [PATCH 183/458] Remove more EuiccChannel usage in
 PrivilegedEuiccManagementFragment

---
 .../openeuicc/ui/EuiccManagementFragment.kt   | 40 ++++++++++---------
 .../ui/PrivilegedEuiccManagementFragment.kt   | 19 ++++++---
 2 files changed, 35 insertions(+), 24 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 7d47ae1da..0d61581e4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -150,32 +150,36 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             listOf()
         }
 
-    @SuppressLint("NotifyDataSetChanged")
     private fun refresh() {
         if (invalid) return
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
-            ensureEuiccChannelManager()
-            euiccChannelManagerService.waitForForegroundTask()
+            doRefresh()
+        }
+    }
 
-            if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
-                disableSafeguardFlow =
-                    preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
-            }
+    @SuppressLint("NotifyDataSetChanged")
+    protected open suspend fun doRefresh() {
+        ensureEuiccChannelManager()
+        euiccChannelManagerService.waitForForegroundTask()
 
-            val profiles = withEuiccChannel { channel ->
-                logicalSlotId = channel.logicalSlotId
-                euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
-                channel.lpa.profiles.operational
-            }
+        if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
+            disableSafeguardFlow =
+                preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
+        }
 
-            withContext(Dispatchers.Main) {
-                adapter.profiles = profiles
-                adapter.footerViews = onCreateFooterViews(profileList, profiles)
-                adapter.notifyDataSetChanged()
-                swipeRefresh.isRefreshing = false
-            }
+        val profiles = withEuiccChannel { channel ->
+            logicalSlotId = channel.logicalSlotId
+            euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
+            channel.lpa.profiles.operational
+        }
+
+        withContext(Dispatchers.Main) {
+            adapter.profiles = profiles
+            adapter.footerViews = onCreateFooterViews(profileList, profiles)
+            adapter.notifyDataSetChanged()
+            swipeRefresh.isRefreshing = false
         }
     }
 
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index 7d055f470..6a8fede99 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -6,8 +6,6 @@ import android.widget.Button
 import android.widget.PopupMenu
 import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileInfo
 
 class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
@@ -16,14 +14,23 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
             newInstanceEuicc(PrivilegedEuiccManagementFragment::class.java, slotId, portId)
     }
 
+    private var isMEP = false
+    private var isRemovable = false
+
+    override suspend fun doRefresh() {
+        super.doRefresh()
+        withEuiccChannel { channel ->
+            isMEP = channel.isMEP
+            isRemovable = channel.removable
+        }
+    }
+
     override suspend fun onCreateFooterViews(
         parent: ViewGroup,
         profiles: List<LocalProfileInfo>
     ): List<View> =
         super.onCreateFooterViews(parent, profiles).let { footers ->
-            // isMEP can map to a slow operation (UiccCardInfo.isMultipleEnabledProfilesSupported())
-            // so let's do it in the IO context
-            if (withContext(Dispatchers.IO) { channel.isMEP }) {
+            if (isMEP) {
                 val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
                 view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {
                     (requireActivity() as PrivilegedMainActivity).showSlotMappingFragment()
@@ -36,7 +43,7 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
 
     override fun populatePopupWithProfileActions(popup: PopupMenu, profile: LocalProfileInfo) {
         super.populatePopupWithProfileActions(popup, profile)
-        if (profile.isEnabled && !channel.removable) {
+        if (profile.isEnabled && !isRemovable) {
             // Only show the disable option for non-removable eUICCs
             // Some devices without internal eUICCs have the "optimization" of ignoring SIM
             // slots without a valid profile. This can lead to "bricking" of external eUICCs

From c2cc8ceb2a4aefceff16b64c9627d7c53ae7cc9c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 11:04:45 -0400
Subject: [PATCH 184/458] feat: EuiccInfoActivity

---
 app-common/src/main/AndroidManifest.xml       |   4 +
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 137 ++++++++++++++++++
 .../openeuicc/ui/EuiccManagementFragment.kt   |  10 ++
 .../main/res/layout/activity_euicc_info.xml   |  25 ++++
 .../src/main/res/layout/euicc_info_item.xml   |  32 ++++
 .../src/main/res/menu/fragment_euicc.xml      |   5 +
 app-common/src/main/res/values/strings.xml    |   8 +
 7 files changed, 221 insertions(+)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
 create mode 100644 app-common/src/main/res/layout/activity_euicc_info.xml
 create mode 100644 app-common/src/main/res/layout/euicc_info_item.xml

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index aa301cdaa..11f16a6bd 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -24,6 +24,10 @@
             android:label="@string/profile_download"
             android:theme="@style/Theme.AppCompat.Translucent" />
 
+        <activity
+            android:name="im.angry.openeuicc.ui.EuiccInfoActivity"
+            android:label="@string/euicc_info" />
+
         <activity
             android:name="im.angry.openeuicc.ui.LogsActivity"
             android:label="@string/pref_advanced_logs" />
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
new file mode 100644
index 000000000..e8b64dfae
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -0,0 +1,137 @@
+package im.angry.openeuicc.ui
+
+import android.annotation.SuppressLint
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import androidx.activity.enableEdgeToEdge
+import androidx.lifecycle.lifecycleScope
+import androidx.recyclerview.widget.DividerItemDecoration
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import androidx.recyclerview.widget.RecyclerView.ViewHolder
+import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.launch
+
+class EuiccInfoActivity : BaseEuiccAccessActivity() {
+    private lateinit var swipeRefresh: SwipeRefreshLayout
+    private lateinit var infoList: RecyclerView
+
+    private val euiccInfoItems: MutableList<Pair<String, String>> = mutableListOf()
+
+    private var logicalSlotId: Int = -1
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_euicc_info)
+        setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
+        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
+
+        swipeRefresh = requireViewById(R.id.swipe_refresh)
+        infoList = requireViewById(R.id.recycler_view)
+
+        infoList.layoutManager =
+            LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
+        infoList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
+        infoList.adapter = EuiccInfoAdapter()
+
+        logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
+
+        swipeRefresh.setOnRefreshListener { refresh() }
+
+        setupRootViewInsets(infoList)
+    }
+
+    override fun onInit() {
+        refresh()
+    }
+
+    @SuppressLint("NotifyDataSetChanged")
+    private fun refresh() {
+        swipeRefresh.isRefreshing = true
+
+        lifecycleScope.launch {
+            euiccInfoItems.clear()
+
+            val unknownStr = getString(R.string.unknown)
+
+            val (euiccInfo2, eID) = euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
+                Pair(channel.lpa.euiccInfo2, channel.lpa.eID)
+            }
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_eid),
+                    eID
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_firmware_version),
+                    euiccInfo2?.euiccFirmwareVersion ?: unknownStr
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_globalplatform_version),
+                    euiccInfo2?.globalPlatformVersion ?: unknownStr
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_pp_version),
+                    euiccInfo2?.ppVersion ?: unknownStr
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_sas_accreditation_number),
+                    euiccInfo2?.sasAccreditationNumber ?: unknownStr
+                )
+            )
+
+            euiccInfoItems.add(Pair(
+                getString(R.string.euicc_info_free_nvram),
+                euiccInfo2?.freeNvram?.let { formatFreeSpace(it) } ?: unknownStr
+            ))
+
+            infoList.adapter!!.notifyDataSetChanged()
+
+            swipeRefresh.isRefreshing = false
+        }
+    }
+
+    inner class EuiccInfoViewHolder(root: View) : ViewHolder(root) {
+        private val title: TextView = root.requireViewById(R.id.euicc_info_title)
+        private val content: TextView = root.requireViewById(R.id.euicc_info_content)
+
+        fun bind(item: Pair<String, String>) {
+            title.text = item.first
+            content.text = item.second
+        }
+    }
+
+    inner class EuiccInfoAdapter : RecyclerView.Adapter<EuiccInfoViewHolder>() {
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): EuiccInfoViewHolder {
+            val root = LayoutInflater.from(parent.context)
+                .inflate(R.layout.euicc_info_item, parent, false)
+            return EuiccInfoViewHolder(root)
+        }
+
+        override fun getItemCount(): Int = euiccInfoItems.size
+
+        override fun onBindViewHolder(holder: EuiccInfoViewHolder, position: Int) {
+            holder.bind(euiccInfoItems[position])
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 0d61581e4..a122b0ba1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -136,6 +136,16 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 true
             }
 
+            R.id.euicc_info -> {
+                if (logicalSlotId != -1) {
+                    Intent(requireContext(), EuiccInfoActivity::class.java).apply {
+                        putExtra("logicalSlotId", logicalSlotId)
+                        startActivity(this)
+                    }
+                }
+                true
+            }
+
             else -> super.onOptionsItemSelected(item)
         }
 
diff --git a/app-common/src/main/res/layout/activity_euicc_info.xml b/app-common/src/main/res/layout/activity_euicc_info.xml
new file mode 100644
index 000000000..8a8b00126
--- /dev/null
+++ b/app-common/src/main/res/layout/activity_euicc_info.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <include layout="@layout/toolbar_activity" />
+
+    <androidx.swiperefreshlayout.widget.SwipeRefreshLayout
+        android:id="@+id/swipe_refresh"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        app:layout_constraintTop_toBottomOf="@id/toolbar"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent">
+
+        <androidx.recyclerview.widget.RecyclerView
+            android:id="@+id/recycler_view"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent" />
+
+    </androidx.swiperefreshlayout.widget.SwipeRefreshLayout>
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/euicc_info_item.xml b/app-common/src/main/res/layout/euicc_info_item.xml
new file mode 100644
index 000000000..39d15a691
--- /dev/null
+++ b/app-common/src/main/res/layout/euicc_info_item.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="?android:attr/selectableItemBackground"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/euicc_info_title"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="24dp"
+        android:layout_marginVertical="12dp"
+        android:textStyle="bold"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <TextView
+        android:id="@+id/euicc_info_content"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="24dp"
+        android:layout_marginVertical="12dp"
+        android:maxLines="1"
+        android:ellipsize="marquee"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/euicc_info_title"
+        app:layout_constraintBottom_toBottomOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/fragment_euicc.xml b/app-common/src/main/res/menu/fragment_euicc.xml
index 9acb64055..b54eaf17e 100644
--- a/app-common/src/main/res/menu/fragment_euicc.xml
+++ b/app-common/src/main/res/menu/fragment_euicc.xml
@@ -5,4 +5,9 @@
         android:id="@+id/show_notifications"
         android:title="@string/profile_notifications_show"
         app:showAsAction="never" />
+
+    <item
+        android:id="@+id/euicc_info"
+        android:title="@string/euicc_info"
+        app:showAsAction="never" />
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 0278ffae7..4a7dc0096 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -71,6 +71,14 @@
     <string name="profile_notification_process">Process</string>
     <string name="profile_notification_delete">Delete</string>
 
+    <string name="euicc_info">eUICC Info</string>
+    <string name="euicc_info_eid">EID</string>
+    <string name="euicc_info_firmware_version">eUICC OS Version</string>
+    <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>
+    <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
+    <string name="euicc_info_pp_version">Protected Profile Version</string>
+    <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
+
     <string name="logs_save">Save</string>
     <string name="logs_filename_template">Logs at %s</string>
 

From ce7fb29c146d0e32e56963759ad3c4c7d4359f8b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 11:22:10 -0400
Subject: [PATCH 185/458] Display supported certificates (GSMA Test or Prod) in
 EuiccInfoActivity

---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 27 +++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  5 ++++
 .../lpac_jni/impl/RootCertificates.kt         |  3 +++
 3 files changed, 35 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index e8b64dfae..7458b72fb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -16,6 +16,8 @@ import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.launch
+import net.typeblog.lpac_jni.impl.DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
+import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
 
 class EuiccInfoActivity : BaseEuiccAccessActivity() {
     private lateinit var swipeRefresh: SwipeRefreshLayout
@@ -105,6 +107,31 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 euiccInfo2?.freeNvram?.let { formatFreeSpace(it) } ?: unknownStr
             ))
 
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_gsma_prod),
+                    if (euiccInfo2?.euiccCiPKIdListForSigning?.contains(
+                            DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
+                        ) == true
+                    ) {
+                        getString(R.string.supported)
+                    } else {
+                        getString(R.string.unsupported)
+                    }
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_gsma_test),
+                    if (PKID_GSMA_TEST_CI.any { euiccInfo2?.euiccCiPKIdListForSigning?.contains(it) == true }) {
+                        getString(R.string.supported)
+                    } else {
+                        getString(R.string.unsupported)
+                    }
+                )
+            )
+
             infoList.adapter!!.notifyDataSetChanged()
 
             swipeRefresh.isRefreshing = false
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4a7dc0096..32672635d 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -78,6 +78,11 @@
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
     <string name="euicc_info_pp_version">Protected Profile Version</string>
     <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
+    <string name="euicc_info_gsma_prod">GSMA Production Certificate</string>
+    <string name="euicc_info_gsma_test">GSMA Test Certificate</string>
+
+    <string name="supported">Supported</string>
+    <string name="unsupported">Unsupported</string>
 
     <string name="logs_save">Save</string>
     <string name="logs_filename_template">Logs at %s</string>
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index 5167da55c..82c443f2c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -7,6 +7,9 @@ import java.security.cert.CertificateFactory
 
 const val DEFAULT_PKID_GSMA_RSP2_ROOT_CI1 = "81370f5125d0b1d408d4c3b232e6d25e795bebfb"
 
+val PKID_GSMA_TEST_CI =
+    arrayOf("34eecf13156518d48d30bdf06853404d115f955d", "2209f61cd9ec5c9c854e787341ff83ecf9776a5b")
+
 private fun getCertificate(keyId: String): Certificate? =
     KNOWN_CI_CERTS[keyId]?.toByteArray()?.let { cert ->
         ByteArrayInputStream(cert).use { stream ->

From 481b9ce1965562c8dca850d24cc9d2fee3d7eec5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 11:24:22 -0400
Subject: [PATCH 186/458] Show slot ID in EuiccInfoActivity

---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt | 5 +++++
 app-common/src/main/res/values/strings.xml                   | 1 +
 2 files changed, 6 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 7458b72fb..d65179a7b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -45,6 +45,11 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
 
         logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
 
+        title = getString(
+            R.string.euicc_info_activity_title,
+            getString(R.string.channel_name_format, logicalSlotId)
+        )
+
         swipeRefresh.setOnRefreshListener { refresh() }
 
         setupRootViewInsets(infoList)
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 32672635d..989ad76a3 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -72,6 +72,7 @@
     <string name="profile_notification_delete">Delete</string>
 
     <string name="euicc_info">eUICC Info</string>
+    <string name="euicc_info_activity_title">eUICC Info (%s)</string>
     <string name="euicc_info_eid">EID</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>

From f285eacd551725453018611f698ca40282549567 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 15:17:00 -0400
Subject: [PATCH 187/458] Show channel access mode and removable status

---
 .../core/DefaultEuiccChannelFactory.kt        |  3 +++
 .../im/angry/openeuicc/core/EuiccChannel.kt   |  2 ++
 .../angry/openeuicc/core/EuiccChannelImpl.kt  |  1 +
 .../openeuicc/core/EuiccChannelWrapper.kt     |  3 +++
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 26 ++++++++++++++++---
 .../angry/openeuicc/util/TelephonyCompat.kt   |  2 ++
 app-common/src/main/res/values/strings.xml    |  6 +++++
 .../core/PrivilegedEuiccChannelFactory.kt     |  2 ++
 .../ui/PrivilegedEuiccManagementFragment.kt   |  2 +-
 .../util/PrivilegedTelephonyCompat.kt         |  2 +-
 .../util/PrivilegedTelephonyUtils.kt          |  7 ++---
 app/src/main/res/values/strings.xml           |  1 +
 12 files changed, 46 insertions(+), 11 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 2365b071f..410cccc71 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -6,6 +6,7 @@ import android.hardware.usb.UsbInterface
 import android.hardware.usb.UsbManager
 import android.se.omapi.SEService
 import android.util.Log
+import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.usb.UsbApduInterface
 import im.angry.openeuicc.core.usb.getIoEndpoints
 import im.angry.openeuicc.util.*
@@ -34,6 +35,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
         try {
             return EuiccChannelImpl(
+                context.getString(R.string.omapi),
                 port,
                 OmapiApduInterface(
                     seService!!,
@@ -62,6 +64,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         val conn = usbManager.openDevice(usbDevice) ?: return null
         if (!conn.claimInterface(usbInterface, true)) return null
         return EuiccChannelImpl(
+            context.getString(R.string.usb),
             FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
             UsbApduInterface(
                 conn,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 11ac7b049..4ef68089a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -4,6 +4,8 @@ import im.angry.openeuicc.util.*
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
 interface EuiccChannel {
+    val type: String
+
     val port: UiccPortInfoCompat
 
     val slotId: Int // PHYSICAL slot
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index 0c0b00ee4..9bccbff59 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -8,6 +8,7 @@ import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
 import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 
 class EuiccChannelImpl(
+    override val type: String,
     override val port: UiccPortInfoCompat,
     apduInterface: ApduInterface,
     verboseLoggingFlow: Flow<Boolean>
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index 048881352..ab01f22b9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -14,6 +14,9 @@ class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
 
             return _inner!!
         }
+
+    override val type: String
+        get() = channel.type
     override val port: UiccPortInfoCompat
         get() = channel.port
     override val slotId: Int
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index d65179a7b..10b5d2b35 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -68,17 +68,35 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
 
             val unknownStr = getString(R.string.unknown)
 
-            val (euiccInfo2, eID) = euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
-                Pair(channel.lpa.euiccInfo2, channel.lpa.eID)
-            }
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_access_mode),
+                    euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.type }
+                )
+            )
+
+            euiccInfoItems.add(
+                Pair(
+                    getString(R.string.euicc_info_removable),
+                    if (euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.port.card.isRemovable }) {
+                        getString(R.string.yes)
+                    } else {
+                        getString(R.string.no)
+                    }
+                )
+            )
 
             euiccInfoItems.add(
                 Pair(
                     getString(R.string.euicc_info_eid),
-                    eID
+                    euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.lpa.eID }
                 )
             )
 
+            val euiccInfo2 = euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
+                channel.lpa.euiccInfo2
+            }
+
             euiccInfoItems.add(
                 Pair(
                     getString(R.string.euicc_info_firmware_version),
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/TelephonyCompat.kt b/app-common/src/main/java/im/angry/openeuicc/util/TelephonyCompat.kt
index 5c7d2173e..b831f012e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/TelephonyCompat.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/TelephonyCompat.kt
@@ -45,6 +45,8 @@ fun SEService.getUiccReaderCompat(slotNumber: Int): Reader {
 interface UiccCardInfoCompat {
     val physicalSlotIndex: Int
     val ports: Collection<UiccPortInfoCompat>
+    val isRemovable: Boolean
+        get() = true // This defaults to removable unless overridden
 }
 
 interface UiccPortInfoCompat {
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 989ad76a3..cc8f220e8 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -8,6 +8,7 @@
 
     <string name="channel_name_format">Logical Slot %d</string>
     <string name="usb">USB</string>
+    <string name="omapi">OpenMobile API (OMAPI)</string>
 
     <string name="enabled">Enabled</string>
     <string name="disabled">Disabled</string>
@@ -73,6 +74,8 @@
 
     <string name="euicc_info">eUICC Info</string>
     <string name="euicc_info_activity_title">eUICC Info (%s)</string>
+    <string name="euicc_info_access_mode">Access Mode</string>
+    <string name="euicc_info_removable">Removable</string>
     <string name="euicc_info_eid">EID</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>
@@ -85,6 +88,9 @@
     <string name="supported">Supported</string>
     <string name="unsupported">Unsupported</string>
 
+    <string name="yes">Yes</string>
+    <string name="no">No</string>
+
     <string name="logs_save">Save</string>
     <string name="logs_filename_template">Logs at %s</string>
 
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 14e00200a..c90e4502e 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.core
 import android.content.Context
 import android.util.Log
 import im.angry.openeuicc.OpenEuiccApplication
+import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
 import java.lang.IllegalArgumentException
 
@@ -27,6 +28,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
             )
             try {
                 return EuiccChannelImpl(
+                    context.getString(R.string.telephony_manager),
                     port,
                     TelephonyManagerApduInterface(
                         port,
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index 6a8fede99..688ae6c91 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -21,7 +21,7 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
         super.doRefresh()
         withEuiccChannel { channel ->
             isMEP = channel.isMEP
-            isRemovable = channel.removable
+            isRemovable = channel.port.card.isRemovable
         }
     }
 
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
index b947afff2..4c1e19f26 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
@@ -33,7 +33,7 @@ class RealUiccCardInfoCompat(val inner: UiccCardInfo): UiccCardInfoCompat {
     val isEuicc: Boolean
         get() = inner.isEuicc
 
-    val isRemovable: Boolean
+    override val isRemovable: Boolean
         get() = inner.isRemovable
 
     val isMultipleEnabledProfilesSupported: Boolean
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index ae7294a6a..0c0f6f888 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -21,7 +21,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled:
 
     // Disable all eSIM profiles before performing a DSDS switch (only for internal eSIMs)
     knownChannels.forEach {
-        if (!it.removable) {
+        if (!it.port.card.isRemovable) {
             it.lpa.disableActiveProfileWithUndo(false)
         }
     }
@@ -44,7 +44,7 @@ fun TelephonyManager.updateSimSlotMapping(
 
     val undo = unmapped.mapNotNull { mapping ->
         euiccManager.findEuiccChannelByPortBlocking(mapping.physicalSlotIndex, mapping.portIndex)?.let { channel ->
-            if (!channel.removable) {
+            if (!channel.port.card.isRemovable) {
                 return@mapNotNull channel.lpa.disableActiveProfileWithUndo(false)
             } else {
                 // Do not do anything for external eUICCs -- we can't really trust them to work properly
@@ -75,9 +75,6 @@ fun SubscriptionManager.tryRefreshCachedEuiccInfo(cardId: Int) {
 
 // Every EuiccChannel we use here should be backed by a RealUiccPortInfoCompat
 // except when it is from a USB card reader
-val EuiccChannel.removable
-    get() = (port as? RealUiccPortInfoCompat)?.card?.isRemovable ?: true
-
 val EuiccChannel.cardId
     get() = (port as? RealUiccPortInfoCompat)?.card?.cardId ?: -1
 
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 3f024303b..f7dbd81b8 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -1,6 +1,7 @@
 <resources>
     <string name="app_name">OpenEUICC</string>
     <string name="no_euicc">No eUICC found on this device.\nOn some devices, you may need to enable dual SIM first in the menu of this app.</string>
+    <string name="telephony_manager">TelephonyManager (Privileged)</string>
 
     <string name="dsds">Dual SIM</string>
 

From 5cefbc24f5e91d0e51dfc307ccefd8614b79bbf9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 15:57:46 -0400
Subject: [PATCH 188/458] OpenEuiccService: fixup

---
 .../main/java/im/angry/openeuicc/service/OpenEuiccService.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 572b02bb6..c85af3630 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -207,7 +207,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         return@withEuiccChannelManager GetEuiccProfileInfoListResult(
             RESULT_OK,
             profiles.toTypedArray(),
-            channel.removable
+            channel.port.card.isRemovable
         )
     }
 

From 826c120ca581ba5c424a54762f642d4dff4225bd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 27 Oct 2024 15:58:33 -0400
Subject: [PATCH 189/458] EuiccInfoActivity: support back button

---
 .../java/im/angry/openeuicc/ui/EuiccInfoActivity.kt    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 10b5d2b35..e5727a9ae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.ui
 import android.annotation.SuppressLint
 import android.os.Bundle
 import android.view.LayoutInflater
+import android.view.MenuItem
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
@@ -55,6 +56,15 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
         setupRootViewInsets(infoList)
     }
 
+    override fun onOptionsItemSelected(item: MenuItem): Boolean = when (item.itemId) {
+        android.R.id.home -> {
+            finish()
+            true
+        }
+
+        else -> super.onOptionsItemSelected(item)
+    }
+
     override fun onInit() {
         refresh()
     }

From 59b4b9e4abe07a710d452c284e8d772c2a0cb742 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 28 Oct 2024 21:10:01 -0400
Subject: [PATCH 190/458] Fix EuiccInfoActivity crash

---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 37 +++++++++++--------
 1 file changed, 21 insertions(+), 16 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index e5727a9ae..8e475dfd7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -24,8 +24,6 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var infoList: RecyclerView
 
-    private val euiccInfoItems: MutableList<Pair<String, String>> = mutableListOf()
-
     private var logicalSlotId: Int = -1
 
     override fun onCreate(savedInstanceState: Bundle?) {
@@ -69,23 +67,22 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
         refresh()
     }
 
-    @SuppressLint("NotifyDataSetChanged")
     private fun refresh() {
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
-            euiccInfoItems.clear()
-
             val unknownStr = getString(R.string.unknown)
 
-            euiccInfoItems.add(
+            val newItems = mutableListOf<Pair<String, String>>()
+
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_access_mode),
                     euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.type }
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_removable),
                     if (euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.port.card.isRemovable }) {
@@ -96,7 +93,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_eid),
                     euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.lpa.eID }
@@ -107,40 +104,41 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 channel.lpa.euiccInfo2
             }
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_firmware_version),
                     euiccInfo2?.euiccFirmwareVersion ?: unknownStr
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_globalplatform_version),
                     euiccInfo2?.globalPlatformVersion ?: unknownStr
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_pp_version),
                     euiccInfo2?.ppVersion ?: unknownStr
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_sas_accreditation_number),
                     euiccInfo2?.sasAccreditationNumber ?: unknownStr
                 )
             )
 
-            euiccInfoItems.add(Pair(
+            newItems.add(
+                Pair(
                 getString(R.string.euicc_info_free_nvram),
                 euiccInfo2?.freeNvram?.let { formatFreeSpace(it) } ?: unknownStr
             ))
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_gsma_prod),
                     if (euiccInfo2?.euiccCiPKIdListForSigning?.contains(
@@ -154,7 +152,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 )
             )
 
-            euiccInfoItems.add(
+            newItems.add(
                 Pair(
                     getString(R.string.euicc_info_gsma_test),
                     if (PKID_GSMA_TEST_CI.any { euiccInfo2?.euiccCiPKIdListForSigning?.contains(it) == true }) {
@@ -165,7 +163,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 )
             )
 
-            infoList.adapter!!.notifyDataSetChanged()
+            (infoList.adapter!! as EuiccInfoAdapter).euiccInfoItems = newItems
 
             swipeRefresh.isRefreshing = false
         }
@@ -182,6 +180,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
     }
 
     inner class EuiccInfoAdapter : RecyclerView.Adapter<EuiccInfoViewHolder>() {
+        var euiccInfoItems: List<Pair<String, String>> = listOf()
+            @SuppressLint("NotifyDataSetChanged")
+            set(newVal) {
+                field = newVal
+                notifyDataSetChanged()
+            }
+
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): EuiccInfoViewHolder {
             val root = LayoutInflater.from(parent.context)
                 .inflate(R.layout.euicc_info_item, parent, false)

From 2ece6af174d3ee4b98205a168c8fa1bf3292f620 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 29 Oct 2024 20:18:23 -0400
Subject: [PATCH 191/458] Add EuiccChannelManager.flowEuiccPorts()

This is to prepare for refactoring EuiccChannel usage out everywhere
---
 .../core/DefaultEuiccChannelManager.kt        | 33 ++++++++++++++-----
 .../openeuicc/core/EuiccChannelManager.kt     |  3 ++
 2 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 91a859df9..550cc22c3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -10,6 +10,15 @@ import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.delay
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.collect
+import kotlinx.coroutines.flow.count
+import kotlinx.coroutines.flow.flow
+import kotlinx.coroutines.flow.flowOn
+import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.mapNotNull
+import kotlinx.coroutines.flow.onEach
+import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
@@ -222,17 +231,25 @@ open class DefaultEuiccChannelManager(
 
     override suspend fun enumerateEuiccChannels(): List<EuiccChannel> =
         withContext(Dispatchers.IO) {
-            uiccCards.flatMap { info ->
-                info.ports.mapNotNull { port ->
-                    tryOpenEuiccChannel(port)?.also {
-                        Log.d(
-                            TAG,
-                            "Found eUICC on slot ${info.physicalSlotIndex} port ${port.portIndex}"
-                        )
-                    }
+            flowEuiccPorts().mapNotNull { (slotId, portId) ->
+                findEuiccChannelByPort(slotId, portId)
+            }.toList()
+        }
+
+    override fun flowEuiccPorts(): Flow<Pair<Int, Int>> = flow {
+        uiccCards.forEach { info ->
+            info.ports.forEach { port ->
+                tryOpenEuiccChannel(port)?.also {
+                    Log.d(
+                        TAG,
+                        "Found eUICC on slot ${info.physicalSlotIndex} port ${port.portIndex}"
+                    )
+
+                    emit(Pair(info.physicalSlotIndex, port.portIndex))
                 }
             }
         }
+    }.flowOn(Dispatchers.IO)
 
     override suspend fun enumerateUsbEuiccChannel(): Pair<UsbDevice?, EuiccChannel?> =
         withContext(Dispatchers.IO) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index a4968c786..2d5517917 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
 import android.hardware.usb.UsbDevice
+import kotlinx.coroutines.flow.Flow
 
 /**
  * EuiccChannelManager holds references to, and manages the lifecycles of, individual
@@ -24,6 +25,8 @@ interface EuiccChannelManager {
      */
     suspend fun enumerateEuiccChannels(): List<EuiccChannel>
 
+    fun flowEuiccPorts(): Flow<Pair<Int, Int>>
+
     /**
      * Scan all possible USB devices for CCID readers that may contain eUICC cards.
      * If found, try to open it for access, and add it to the internal EuiccChannel cache

From 1dc500468179918bdea9f9c09e08cc0a21487ae7 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 2 Nov 2024 19:27:42 +0100
Subject: [PATCH 192/458] feat: enhanced visual hints for available slots (#54)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/54
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-unpriv/src/main/res/values/strings.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 124bedf4f..548a7b9f5 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -11,11 +11,11 @@
     <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
     <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
     <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: %s.</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: <b>SIM%s</b>.</string>
     <string name="compatibility_check_isdr_channel">ISD-R Channel Access</string>
     <string name="compatibility_check_isdr_channel_desc">Does your device support opening an ISD-R (management) channel to eSIMs via OMAPI?</string>
     <string name="compatibility_check_isdr_channel_desc_unknown">Cannot determine whether ISD-R access through OMAPI is supported. You might want to retry with SIM cards inserted (any SIM card will do) if not already.</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: %s.</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: <b>SIM%s</b>.</string>
     <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
     <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>

From 87eb497f401bb7f7bf206b05e2fb5dce79ffe7fe Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 2 Nov 2024 19:29:37 +0100
Subject: [PATCH 193/458] feat: open stk from menu (#57)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/57
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-unpriv/src/main/AndroidManifest.xml       |  7 +++-
 .../di/UnprivilegedUiComponentFactory.kt      |  6 +++
 .../ui/UnprivilegedEuiccManagementFragment.kt | 40 +++++++++++++++++++
 .../im/angry/openeuicc/util/SIMToolkit.kt     | 38 ++++++++++++++++++
 .../main/res/menu/fragment_sim_toolkit.xml    |  9 +++++
 app-unpriv/src/main/res/values/strings.xml    |  1 +
 6 files changed, 99 insertions(+), 2 deletions(-)
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
 create mode 100644 app-unpriv/src/main/res/menu/fragment_sim_toolkit.xml

diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index e72b11245..cb1ef5ff9 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -22,9 +22,12 @@
 
         <activity
             android:name="im.angry.openeuicc.ui.CompatibilityCheckActivity"
-            android:label="@string/compatibility_check"
-            android:exported="false" />
+            android:exported="false"
+            android:label="@string/compatibility_check" />
 
     </application>
 
+    <queries>
+        <package android:name="com.android.stk" />
+    </queries>
 </manifest>
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
index f1170382a..25316763d 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -1,9 +1,15 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
+import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.ui.EuiccManagementFragment
+import im.angry.openeuicc.ui.UnprivilegedEuiccManagementFragment
 import im.angry.openeuicc.ui.UnprivilegedNoEuiccPlaceholderFragment
 
 class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
+    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
+        UnprivilegedEuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+
     override fun createNoEuiccPlaceholderFragment(): Fragment =
         UnprivilegedNoEuiccPlaceholderFragment()
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
new file mode 100644
index 000000000..91c480472
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
@@ -0,0 +1,40 @@
+package im.angry.openeuicc.ui
+
+import android.util.Log
+import android.view.Menu
+import android.view.MenuInflater
+import android.view.MenuItem
+import im.angry.easyeuicc.R
+import im.angry.openeuicc.util.SIMToolkit
+import im.angry.openeuicc.util.isUsb
+import im.angry.openeuicc.util.newInstanceEuicc
+import im.angry.openeuicc.util.slotId
+
+
+class UnprivilegedEuiccManagementFragment : EuiccManagementFragment() {
+    companion object {
+        const val TAG = "UnprivilegedEuiccManagementFragment"
+
+        fun newInstance(slotId: Int, portId: Int): EuiccManagementFragment =
+            newInstanceEuicc(UnprivilegedEuiccManagementFragment::class.java, slotId, portId)
+    }
+
+    override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
+        super.onCreateOptionsMenu(menu, inflater)
+        inflater.inflate(R.menu.fragment_sim_toolkit, menu)
+        menu.findItem(R.id.open_sim_toolkit).isVisible =
+            SIMToolkit.getComponentName(requireContext(), slotId) != null
+    }
+
+    override fun onOptionsItemSelected(item: MenuItem): Boolean =
+        when (item.itemId) {
+            R.id.open_sim_toolkit -> {
+                val intent = SIMToolkit.intent(requireContext(), slotId)
+                Log.d(TAG, "Opening SIM Toolkit for $slotId slot, intent: $intent")
+                startActivity(intent)
+                true
+            }
+
+            else -> super.onOptionsItemSelected(item)
+        }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
new file mode 100644
index 000000000..b6aed0f69
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
@@ -0,0 +1,38 @@
+package im.angry.openeuicc.util
+
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageManager.NameNotFoundException
+
+object SIMToolkit {
+    private val slot1activities = arrayOf(
+        ComponentName("com.android.stk", "com.android.stk.StkMain1"),
+    )
+
+    private val slot2activities = arrayOf(
+        ComponentName("com.android.stk", "com.android.stk.StkMain2"),
+    )
+
+    fun getComponentName(context: Context, slotId: Int): ComponentName? {
+        val components = when (slotId) {
+            0 -> slot1activities
+            1 -> slot2activities
+            else -> return null
+        }
+        return components.find {
+            try {
+                context.packageManager.getActivityIcon(it)
+                true
+            } catch (_: NameNotFoundException) {
+                false
+            }
+        }
+    }
+
+    fun intent(context: Context, slotId: Int) = Intent(Intent.ACTION_MAIN, null).apply {
+        flags = Intent.FLAG_ACTIVITY_NEW_TASK
+        component = getComponentName(context, slotId)
+        addCategory(Intent.CATEGORY_LAUNCHER)
+    }
+}
diff --git a/app-unpriv/src/main/res/menu/fragment_sim_toolkit.xml b/app-unpriv/src/main/res/menu/fragment_sim_toolkit.xml
new file mode 100644
index 000000000..610b3a120
--- /dev/null
+++ b/app-unpriv/src/main/res/menu/fragment_sim_toolkit.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/open_sim_toolkit"
+        android:title="@string/open_sim_toolkit"
+        android:visible="false"
+        app:showAsAction="never" />
+</menu>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 548a7b9f5..fb7dc94f1 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -2,6 +2,7 @@
     <string name="app_name" translatable="false">EasyEUICC</string>
     <string name="channel_name_format">SIM %d</string>
     <string name="compatibility_check">Compatibility Check</string>
+    <string name="open_sim_toolkit">Open SIM Toolkit</string>
 
     <!-- Compatibility Check Descriptions -->
     <string name="compatibility_check_system_features">System Features</string>

From 5e5210ae2da513a3f8e357bb209ad4a10c734055 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 16:54:30 -0400
Subject: [PATCH 194/458] MainActivity: switch to flowEuiccPorts()

---
 .../openeuicc/di/DefaultUiComponentFactory.kt |   5 +-
 .../angry/openeuicc/di/UiComponentFactory.kt  |   3 +-
 .../im/angry/openeuicc/ui/MainActivity.kt     | 118 +++++++++++-------
 .../openeuicc/ui/UsbCcidReaderFragment.kt     |   5 +-
 .../di/UnprivilegedUiComponentFactory.kt      |   5 +-
 .../di/PrivilegedUiComponentFactory.kt        |   5 +-
 6 files changed, 81 insertions(+), 60 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
index 32550d63f..a0800173b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
@@ -1,13 +1,12 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
 import im.angry.openeuicc.ui.NoEuiccPlaceholderFragment
 
 open class DefaultUiComponentFactory : UiComponentFactory {
-    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
-        EuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+    override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
+        EuiccManagementFragment.newInstance(slotId, portId)
 
     override fun createNoEuiccPlaceholderFragment(): Fragment = NoEuiccPlaceholderFragment()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
index 4e09a7093..eef662cbc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
@@ -1,10 +1,9 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
 
 interface UiComponentFactory {
-    fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment
+    fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment
     fun createNoEuiccPlaceholderFragment(): Fragment
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index e432f6ce8..eb149a9ad 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -23,9 +23,12 @@ import androidx.viewpager2.widget.ViewPager2
 import com.google.android.material.tabs.TabLayout
 import com.google.android.material.tabs.TabLayoutMediator
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
@@ -44,6 +47,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private var refreshing = false
 
     private data class Page(
+        val logicalSlotId: Int,
         val title: String,
         val createFragment: () -> Fragment
     )
@@ -138,65 +142,83 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         // Prevent concurrent access with any running foreground task
         euiccChannelManagerService.waitForForegroundTask()
 
-        val knownChannels = withContext(Dispatchers.IO) {
-            euiccChannelManager.enumerateEuiccChannels().onEach {
-                Log.d(TAG, "slot ${it.slotId} port ${it.portId}")
-                if (preferenceRepository.verboseLoggingFlow.first()) {
-                    Log.d(TAG, it.lpa.eID)
-                }
-                // Request the system to refresh the list of profiles every time we start
-                // Note that this is currently supposed to be no-op when unprivileged,
-                // but it could change in the future
-                euiccChannelManager.notifyEuiccProfilesChanged(it.logicalSlotId)
-            }
-        }
-
         val (usbDevice, _) = withContext(Dispatchers.IO) {
             euiccChannelManager.enumerateUsbEuiccChannel()
         }
 
-        withContext(Dispatchers.Main) {
-            loadingProgress.visibility = View.GONE
+        val newPages: MutableList<Page> = mutableListOf()
 
-            knownChannels.sortedBy { it.logicalSlotId }.forEach { channel ->
-                pages.add(Page(
-                    getString(R.string.channel_name_format, channel.logicalSlotId)
-                ) { appContainer.uiComponentFactory.createEuiccManagementFragment(channel) })
-            }
+        euiccChannelManager.flowEuiccPorts().onEach { (slotId, portId) ->
+            Log.d(TAG, "slot $slotId port $portId")
 
-            // If USB readers exist, add them at the very last
-            // We use a wrapper fragment to handle logic specific to USB readers
-            usbDevice?.let {
-                pages.add(Page(it.productName ?: getString(R.string.usb)) { UsbCcidReaderFragment() })
-            }
-            viewPager.visibility = View.VISIBLE
-
-            if (pages.size > 1) {
-                tabs.visibility = View.VISIBLE
-            } else if (pages.isEmpty()) {
-                pages.add(Page("") { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
-            }
-
-            pagerAdapter.notifyDataSetChanged()
-            // Reset the adapter so that the current view actually gets cleared
-            // notifyDataSetChanged() doesn't cause the current view to be removed.
-            viewPager.adapter = pagerAdapter
-
-            if (fromUsbEvent && usbDevice != null) {
-                // If this refresh was triggered by a USB insertion while active, scroll to that page
-                viewPager.post {
-                    viewPager.setCurrentItem(pages.size - 1, true)
+            euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                if (preferenceRepository.verboseLoggingFlow.first()) {
+                    Log.d(TAG, channel.lpa.eID)
                 }
-            } else {
-                viewPager.currentItem = 0
-            }
+                // Request the system to refresh the list of profiles every time we start
+                // Note that this is currently supposed to be no-op when unprivileged,
+                // but it could change in the future
+                euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
 
-            if (pages.size > 0) {
-                ensureNotificationPermissions()
+                newPages.add(
+                    Page(
+                        channel.logicalSlotId,
+                        getString(R.string.channel_name_format, channel.logicalSlotId)
+                    ) {
+                        appContainer.uiComponentFactory.createEuiccManagementFragment(
+                            slotId,
+                            portId
+                        )
+                    })
             }
+        }.collect()
 
-            refreshing = false
+        // If USB readers exist, add them at the very last
+        // We use a wrapper fragment to handle logic specific to USB readers
+        usbDevice?.let {
+            pages.add(
+                Page(
+                    EuiccChannelManager.USB_CHANNEL_ID,
+                    it.productName ?: getString(R.string.usb)
+                ) { UsbCcidReaderFragment() })
         }
+        viewPager.visibility = View.VISIBLE
+
+        if (pages.size > 1) {
+            tabs.visibility = View.VISIBLE
+        } else if (pages.isEmpty()) {
+            pages.add(
+                Page(
+                    -1,
+                    ""
+                ) { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
+        }
+
+        newPages.sortBy { it.logicalSlotId }
+
+        pages.clear()
+        pages.addAll(newPages)
+
+        loadingProgress.visibility = View.GONE
+        pagerAdapter.notifyDataSetChanged()
+        // Reset the adapter so that the current view actually gets cleared
+        // notifyDataSetChanged() doesn't cause the current view to be removed.
+        viewPager.adapter = pagerAdapter
+
+        if (fromUsbEvent && usbDevice != null) {
+            // If this refresh was triggered by a USB insertion while active, scroll to that page
+            viewPager.post {
+                viewPager.setCurrentItem(pages.size - 1, true)
+            }
+        } else {
+            viewPager.currentItem = 0
+        }
+
+        if (pages.size > 0) {
+            ensureNotificationPermissions()
+        }
+
+        refreshing = false
     }
 
     private fun refresh(fromUsbEvent: Boolean = false) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
index 3988b09a6..6170fc220 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -157,7 +157,10 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
             childFragmentManager.commit {
                 replace(
                     R.id.child_container,
-                    appContainer.uiComponentFactory.createEuiccManagementFragment(channel)
+                    appContainer.uiComponentFactory.createEuiccManagementFragment(
+                        channel.slotId,
+                        channel.portId
+                    )
                 )
             }
         } else {
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
index 25316763d..50e5581fc 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -1,14 +1,13 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
 import im.angry.openeuicc.ui.UnprivilegedEuiccManagementFragment
 import im.angry.openeuicc.ui.UnprivilegedNoEuiccPlaceholderFragment
 
 class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
-    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
-        UnprivilegedEuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+    override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
+        UnprivilegedEuiccManagementFragment.newInstance(slotId, portId)
 
     override fun createNoEuiccPlaceholderFragment(): Fragment =
         UnprivilegedNoEuiccPlaceholderFragment()
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
index d3c5cdbde..701e57d65 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
@@ -1,10 +1,9 @@
 package im.angry.openeuicc.di
 
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.ui.EuiccManagementFragment
 import im.angry.openeuicc.ui.PrivilegedEuiccManagementFragment
 
 class PrivilegedUiComponentFactory : DefaultUiComponentFactory() {
-    override fun createEuiccManagementFragment(channel: EuiccChannel): EuiccManagementFragment =
-        PrivilegedEuiccManagementFragment.newInstance(channel.slotId, channel.portId)
+    override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
+        PrivilegedEuiccManagementFragment.newInstance(slotId, portId)
 }
\ No newline at end of file

From 6257a0305881802e6fbb18c445e7ee8c4961cbe4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 17:16:43 -0400
Subject: [PATCH 195/458] DirectProfileDownloadActivity: use flowEuiccPorts()

---
 .../ui/DirectProfileDownloadActivity.kt       | 22 ++++++++++++++-----
 .../angry/openeuicc/ui/SlotSelectFragment.kt  |  8 +++----
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
index 9e79de6ae..4baf36b98 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
@@ -3,6 +3,8 @@ package im.angry.openeuicc.ui
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
@@ -10,22 +12,32 @@ class DirectProfileDownloadActivity : BaseEuiccAccessActivity(), SlotSelectFragm
     override fun onInit() {
         lifecycleScope.launch {
             val knownChannels = withContext(Dispatchers.IO) {
-                euiccChannelManager.enumerateEuiccChannels()
+                euiccChannelManager.flowEuiccPorts().map { (slotId, portId) ->
+                    euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                        Triple(slotId, channel.logicalSlotId, portId)
+                    }
+                }.toList().sortedBy { it.second }
             }
 
             when {
                 knownChannels.isEmpty() -> {
                     finish()
                 }
-                knownChannels.hasMultipleChips -> {
-                    SlotSelectFragment.newInstance(knownChannels.sortedBy { it.logicalSlotId })
+                // Detect multiple eUICC chips
+                knownChannels.distinctBy { it.first }.size > 1 -> {
+                    SlotSelectFragment.newInstance(
+                        knownChannels.map { it.first },
+                        knownChannels.map { it.second },
+                        knownChannels.map { it.third })
                         .show(supportFragmentManager, SlotSelectFragment.TAG)
                 }
                 else -> {
                     // If the device has only one eSIM "chip" (but may be mapped to multiple slots),
                     // we can skip the slot selection dialog since there is only one chip to save to.
-                    onSlotSelected(knownChannels[0].slotId,
-                        knownChannels[0].portId)
+                    onSlotSelected(
+                        knownChannels[0].first,
+                        knownChannels[0].third
+                    )
                 }
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
index d1239c41d..2c4fe3c4c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
@@ -16,12 +16,12 @@ class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker
     companion object {
         const val TAG = "SlotSelectFragment"
 
-        fun newInstance(knownChannels: List<EuiccChannel>): SlotSelectFragment {
+        fun newInstance(slotIds: List<Int>, logicalSlotIds: List<Int>, portIds: List<Int>): SlotSelectFragment {
             return SlotSelectFragment().apply {
                 arguments = Bundle().apply {
-                    putIntArray("slotIds", knownChannels.map { it.slotId }.toIntArray())
-                    putIntArray("logicalSlotIds", knownChannels.map { it.logicalSlotId }.toIntArray())
-                    putIntArray("portIds", knownChannels.map { it.portId }.toIntArray())
+                    putIntArray("slotIds", slotIds.toIntArray())
+                    putIntArray("logicalSlotIds", logicalSlotIds.toIntArray())
+                    putIntArray("portIds", portIds.toIntArray())
                 }
             }
         }

From 272ab953e06503284875033fd432a59943313a8b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 18:09:12 -0400
Subject: [PATCH 196/458] PrivilegedTelephonyUtils: Switch to flowEuiccPorts()

---
 .../openeuicc/util/PrivilegedTelephonyUtils.kt    | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 0c0f6f888..2c1832158 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -5,6 +5,7 @@ import android.telephony.TelephonyManager
 import android.telephony.UiccSlotMapping
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
+import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.runBlocking
 import java.lang.Exception
 
@@ -15,14 +16,14 @@ val TelephonyManager.dsdsEnabled: Boolean
     get() = activeModemCount >= 2
 
 fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled: Boolean) {
-    val knownChannels = runBlocking {
-        euiccManager.enumerateEuiccChannels()
-    }
-
     // Disable all eSIM profiles before performing a DSDS switch (only for internal eSIMs)
-    knownChannels.forEach {
-        if (!it.port.card.isRemovable) {
-            it.lpa.disableActiveProfileWithUndo(false)
+    runBlocking {
+        euiccManager.flowEuiccPorts().onEach { (slotId, portId) ->
+            euiccManager.withEuiccChannel(slotId, portId) {
+                if (!it.port.card.isRemovable) {
+                    it.lpa.disableActiveProfileWithUndo(false)
+                }
+            }
         }
     }
 

From 573dce56a64a27685dacb6e52f5a3216de20c331 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 19:06:31 -0400
Subject: [PATCH 197/458] EuiccChannelManager: Stop emitting real EuiccChannel
 for USB

---
 .../openeuicc/core/DefaultEuiccChannelManager.kt  |  8 ++++----
 .../angry/openeuicc/core/EuiccChannelManager.kt   |  8 ++++++--
 .../java/im/angry/openeuicc/ui/MainActivity.kt    |  2 +-
 .../angry/openeuicc/ui/UsbCcidReaderFragment.kt   | 15 ++++++---------
 4 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 550cc22c3..ae473b762 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -251,20 +251,20 @@ open class DefaultEuiccChannelManager(
         }
     }.flowOn(Dispatchers.IO)
 
-    override suspend fun enumerateUsbEuiccChannel(): Pair<UsbDevice?, EuiccChannel?> =
+    override suspend fun tryOpenUsbEuiccChannel(): Pair<UsbDevice?, Boolean> =
         withContext(Dispatchers.IO) {
             usbManager.deviceList.values.forEach { device ->
                 Log.i(TAG, "Scanning USB device ${device.deviceId}:${device.vendorId}")
                 val iface = device.getSmartCardInterface() ?: return@forEach
                 // If we don't have permission, tell UI code that we found a candidate device, but we
                 // need permission to be able to do anything with it
-                if (!usbManager.hasPermission(device)) return@withContext Pair(device, null)
+                if (!usbManager.hasPermission(device)) return@withContext Pair(device, false)
                 Log.i(TAG, "Found CCID interface on ${device.deviceId}:${device.vendorId}, and has permission; trying to open channel")
                 try {
                     val channel = euiccChannelFactory.tryOpenUsbEuiccChannel(device, iface)
                     if (channel != null && channel.lpa.valid) {
                         usbChannel = channel
-                        return@withContext Pair(device, channel)
+                        return@withContext Pair(device, true)
                     }
                 } catch (e: Exception) {
                     // Ignored -- skip forward
@@ -272,7 +272,7 @@ open class DefaultEuiccChannelManager(
                 }
                 Log.i(TAG, "No valid eUICC channel found on USB device ${device.deviceId}:${device.vendorId}")
             }
-            return@withContext Pair(null, null)
+            return@withContext Pair(null, false)
         }
 
     override fun invalidate() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 2d5517917..b52f5ba2f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -31,9 +31,13 @@ interface EuiccChannelManager {
      * Scan all possible USB devices for CCID readers that may contain eUICC cards.
      * If found, try to open it for access, and add it to the internal EuiccChannel cache
      * as a "port" with id 99. When user interaction is required to obtain permission
-     * to interact with the device, the second return value (EuiccChannel) will be null.
+     * to interact with the device, the second return value will be false.
+     *
+     * Returns (usbDevice, canOpen). canOpen is false if either (1) no usb reader is found;
+     * or (2) usb reader is found, but user interaction is required for access;
+     * or (3) usb reader is found, but we are unable to open ISD-R.
      */
-    suspend fun enumerateUsbEuiccChannel(): Pair<UsbDevice?, EuiccChannel?>
+    suspend fun tryOpenUsbEuiccChannel(): Pair<UsbDevice?, Boolean>
 
     /**
      * Wait for a slot + port to reconnect (i.e. become valid again)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index eb149a9ad..8dbe3caee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -143,7 +143,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         euiccChannelManagerService.waitForForegroundTask()
 
         val (usbDevice, _) = withContext(Dispatchers.IO) {
-            euiccChannelManager.enumerateUsbEuiccChannel()
+            euiccChannelManager.tryOpenUsbEuiccChannel()
         }
 
         val newPages: MutableList<Page> = mutableListOf()
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
index 6170fc220..d104582f0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -20,7 +20,6 @@ import androidx.fragment.app.Fragment
 import androidx.fragment.app.commit
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -73,7 +72,6 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
     private lateinit var loadingProgress: ProgressBar
 
     private var usbDevice: UsbDevice? = null
-    private var usbChannel: EuiccChannel? = null
 
     override fun onCreateView(
         inflater: LayoutInflater,
@@ -140,26 +138,25 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
         permissionButton.visibility = View.GONE
         loadingProgress.visibility = View.VISIBLE
 
-        val (device, channel) = withContext(Dispatchers.IO) {
-            euiccChannelManager.enumerateUsbEuiccChannel()
+        val (device, canOpen) = withContext(Dispatchers.IO) {
+            euiccChannelManager.tryOpenUsbEuiccChannel()
         }
 
         loadingProgress.visibility = View.GONE
 
         usbDevice = device
-        usbChannel = channel
 
-        if (device != null && channel == null && !usbManager.hasPermission(device)) {
+        if (device != null && !canOpen && !usbManager.hasPermission(device)) {
             text.text = getString(R.string.usb_permission_needed)
             text.visibility = View.VISIBLE
             permissionButton.visibility = View.VISIBLE
-        } else if (device != null && channel != null) {
+        } else if (device != null && canOpen) {
             childFragmentManager.commit {
                 replace(
                     R.id.child_container,
                     appContainer.uiComponentFactory.createEuiccManagementFragment(
-                        channel.slotId,
-                        channel.portId
+                        EuiccChannelManager.USB_CHANNEL_ID,
+                        0
                     )
                 )
             }

From 0ef435956c9e380535a37862bda9a4ad02094864 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 19:09:57 -0400
Subject: [PATCH 198/458] EuiccChannelManager: retire enumerateEuiccChannels()

---
 .../openeuicc/core/DefaultEuiccChannelManager.kt    | 13 -------------
 .../im/angry/openeuicc/core/EuiccChannelManager.kt  | 11 ++++++-----
 2 files changed, 6 insertions(+), 18 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index ae473b762..7549f4e88 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -11,14 +11,8 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.collect
-import kotlinx.coroutines.flow.count
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.flow.flowOn
-import kotlinx.coroutines.flow.map
-import kotlinx.coroutines.flow.mapNotNull
-import kotlinx.coroutines.flow.onEach
-import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
@@ -229,13 +223,6 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    override suspend fun enumerateEuiccChannels(): List<EuiccChannel> =
-        withContext(Dispatchers.IO) {
-            flowEuiccPorts().mapNotNull { (slotId, portId) ->
-                findEuiccChannelByPort(slotId, portId)
-            }.toList()
-        }
-
     override fun flowEuiccPorts(): Flow<Pair<Int, Int>> = flow {
         uiccCards.forEach { info ->
             info.ports.forEach { port ->
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index b52f5ba2f..e252e0616 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -19,12 +19,13 @@ interface EuiccChannelManager {
     }
 
     /**
-     * Scan all possible _device internal_ sources for EuiccChannels, return them and have all
-     * scanned channels cached; these channels will remain open for the entire lifetime of
-     * this EuiccChannelManager object, unless disconnected externally or invalidate()'d
+     * Scan all possible _device internal_ sources for EuiccChannels, as a flow, return their physical
+     * (slotId, portId) and have all scanned channels cached; these channels will remain open
+     * for the entire lifetime of this EuiccChannelManager object, unless disconnected externally
+     * or invalidate()'d.
+     *
+     * To obtain a temporary reference to a EuiccChannel, use `withEuiccChannel()`.
      */
-    suspend fun enumerateEuiccChannels(): List<EuiccChannel>
-
     fun flowEuiccPorts(): Flow<Pair<Int, Int>>
 
     /**

From 04debd62d58c6d92851ab9e5993a482ce9d5b694 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 20:58:56 -0400
Subject: [PATCH 199/458] MainActivity: Fixup ViewPager update

---
 .../src/main/java/im/angry/openeuicc/ui/MainActivity.kt   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 8dbe3caee..74f214751 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -176,7 +176,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         // If USB readers exist, add them at the very last
         // We use a wrapper fragment to handle logic specific to USB readers
         usbDevice?.let {
-            pages.add(
+            newPages.add(
                 Page(
                     EuiccChannelManager.USB_CHANNEL_ID,
                     it.productName ?: getString(R.string.usb)
@@ -184,10 +184,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         }
         viewPager.visibility = View.VISIBLE
 
-        if (pages.size > 1) {
+        if (newPages.size > 1) {
             tabs.visibility = View.VISIBLE
-        } else if (pages.isEmpty()) {
-            pages.add(
+        } else if (newPages.isEmpty()) {
+            newPages.add(
                 Page(
                     -1,
                     ""

From 32f5e3f71a9e31f485801ff23f68b55eddc6ff56 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 2 Nov 2024 21:36:08 -0400
Subject: [PATCH 200/458] PrivilegedTelephonyUtils: Nuke direct EuiccChannel
 usage

---
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 19 ++++++++++------
 .../util/PrivilegedTelephonyUtils.kt          | 22 ++++++++++++++-----
 2 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index e7a3322d5..c96361de9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -48,16 +48,21 @@ fun LocalProfileAssistant.disableActiveProfile(refresh: Boolean): Boolean =
     } ?: true
 
 /**
- * Disable the active profile, return a lambda that reverts this action when called.
- * If refreshOnDisable is true, also cause a eUICC refresh command. Note that refreshing
- * will disconnect the eUICC and might need some time before being operational again.
+ * Disable the current active profile if any. If refresh is true, also cause a refresh command.
  * See EuiccManager.waitForReconnect()
+ *
+ * Return the iccid of the profile being disabled, or null if no active profile found or failed to
+ * disable.
  */
-fun LocalProfileAssistant.disableActiveProfileWithUndo(refreshOnDisable: Boolean): () -> Unit =
+fun LocalProfileAssistant.disableActiveProfileKeepIccId(refresh: Boolean): String? =
     profiles.find { it.isEnabled }?.let {
-        disableProfile(it.iccid, refreshOnDisable)
-        return { enableProfile(it.iccid) }
-    } ?: { }
+        Log.i(TAG, "Disabling active profile ${it.iccid}")
+        if (disableProfile(it.iccid, refresh)) {
+            it.iccid
+        } else {
+            null
+        }
+    }
 
 /**
  * Begin a "tracked" operation where notifications may be generated by the eSIM
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index 2c1832158..edeb49f51 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -21,7 +21,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled:
         euiccManager.flowEuiccPorts().onEach { (slotId, portId) ->
             euiccManager.withEuiccChannel(slotId, portId) {
                 if (!it.port.card.isRemovable) {
-                    it.lpa.disableActiveProfileWithUndo(false)
+                    it.lpa.disableActiveProfile(false)
                 }
             }
         }
@@ -32,7 +32,7 @@ fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled:
 
 // Disable eSIM profiles before switching the slot mapping
 // This ensures that unmapped eSIM ports never have "ghost" profiles enabled
-fun TelephonyManager.updateSimSlotMapping(
+suspend fun TelephonyManager.updateSimSlotMapping(
     euiccManager: EuiccChannelManager, newMapping: Collection<UiccSlotMapping>,
     currentMapping: Collection<UiccSlotMapping> = simSlotMapping
 ) {
@@ -43,14 +43,24 @@ fun TelephonyManager.updateSimSlotMapping(
         }
     }
 
-    val undo = unmapped.mapNotNull { mapping ->
-        euiccManager.findEuiccChannelByPortBlocking(mapping.physicalSlotIndex, mapping.portIndex)?.let { channel ->
+    val undo: List<suspend () -> Unit> = unmapped.mapNotNull { mapping ->
+        euiccManager.withEuiccChannel(mapping.physicalSlotIndex, mapping.portIndex) { channel ->
             if (!channel.port.card.isRemovable) {
-                return@mapNotNull channel.lpa.disableActiveProfileWithUndo(false)
+                channel.lpa.disableActiveProfileKeepIccId(false)
             } else {
                 // Do not do anything for external eUICCs -- we can't really trust them to work properly
                 // with no profile enabled.
-                return@mapNotNull null
+                null
+            }
+        }?.let { iccid ->
+            // Generate undo closure because we can't keep reference to `channel` in the closure above
+            {
+                euiccManager.withEuiccChannel(
+                    mapping.physicalSlotIndex,
+                    mapping.portIndex
+                ) { channel ->
+                    channel.lpa.enableProfile(iccid)
+                }
             }
         }
     }

From 22ec3e3bafce1a1303c5817fe9e4eb46aa8311d7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 3 Nov 2024 10:53:24 -0500
Subject: [PATCH 201/458] OpenEuiccService: Start migrating to
 withEuiccChannel()

---
 .../core/DefaultEuiccChannelManager.kt        |  9 ++
 .../openeuicc/core/EuiccChannelManager.kt     |  6 ++
 .../openeuicc/service/OpenEuiccService.kt     | 97 ++++++++++++-------
 3 files changed, 77 insertions(+), 35 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 7549f4e88..a1cbe86e9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -165,6 +165,15 @@ open class DefaultEuiccChannelManager(
             findEuiccChannelByPort(physicalSlotId, portId)
         }
 
+    override suspend fun findFirstAvailablePort(physicalSlotId: Int): Int =
+        withContext(Dispatchers.IO) {
+            if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                return@withContext 0
+            }
+
+            findAllEuiccChannelsByPhysicalSlot(physicalSlotId)?.getOrNull(0)?.portId ?: -1
+        }
+
     override suspend fun <R> withEuiccChannel(
         physicalSlotId: Int,
         portId: Int,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index e252e0616..9378f9625 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -72,6 +72,12 @@ interface EuiccChannelManager {
     suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel?
     fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
 
+    /**
+     * Returns the first mapped & available port ID for a physical slot, or -1 if
+     * not found.
+     */
+    suspend fun findFirstAvailablePort(physicalSlotId: Int): Int
+
     class EuiccChannelNotFoundException: Exception("EuiccChannel not found")
 
     /**
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index c85af3630..8ec27ec48 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -13,6 +13,7 @@ import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.runBlocking
 import java.lang.IllegalStateException
 
@@ -37,8 +38,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         }
 
     private data class EuiccChannelManagerContext(
-        val euiccChannelManager: EuiccChannelManager
+        val euiccChannelManagerService: EuiccChannelManagerService
     ) {
+        val euiccChannelManager
+            get() = euiccChannelManagerService.euiccChannelManager
+
         fun findChannel(physicalSlotId: Int): EuiccChannel? =
             euiccChannelManager.findEuiccChannelByPhysicalSlotBlocking(physicalSlotId)
 
@@ -59,7 +63,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
      *
      * This function cannot be inline because non-local returns may bypass the unbind
      */
-    private fun <T> withEuiccChannelManager(fn: EuiccChannelManagerContext.() -> T): T {
+    private fun <T> withEuiccChannelManager(fn: suspend EuiccChannelManagerContext.() -> T): T {
         val (binder, unbind) = runBlocking {
             bindServiceSuspended(
                 Intent(
@@ -73,8 +77,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             throw RuntimeException("Unable to bind to EuiccChannelManagerService; aborting")
         }
 
-        val ret =
-            EuiccChannelManagerContext((binder as EuiccChannelManagerService.LocalBinder).service.euiccChannelManager).fn()
+        val localBinder = binder as EuiccChannelManagerService.LocalBinder
+
+        val ret = runBlocking {
+            EuiccChannelManagerContext(localBinder.service).fn()
+        }
 
         unbind()
         return ret
@@ -177,38 +184,54 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         }
 
         // TODO: Temporarily enable the slot to access its profiles if it is currently unmapped
-        val channel =
-            findChannel(slotId) ?: return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+        val port = euiccChannelManager.findFirstAvailablePort(slotId)
+        if (port == -1) {
+            return@withEuiccChannelManager GetEuiccProfileInfoListResult(
                 RESULT_FIRST_USER,
                 arrayOf(),
                 true
             )
-        val profiles = channel.lpa.profiles.operational.map {
-            EuiccProfileInfo.Builder(it.iccid).apply {
-                setProfileName(it.name)
-                setNickname(it.displayName)
-                setServiceProviderName(it.providerName)
-                setState(
-                    when (it.state) {
-                        LocalProfileInfo.State.Enabled -> EuiccProfileInfo.PROFILE_STATE_ENABLED
-                        LocalProfileInfo.State.Disabled -> EuiccProfileInfo.PROFILE_STATE_DISABLED
-                    }
-                )
-                setProfileClass(
-                    when (it.profileClass) {
-                        LocalProfileInfo.Clazz.Testing -> EuiccProfileInfo.PROFILE_CLASS_TESTING
-                        LocalProfileInfo.Clazz.Provisioning -> EuiccProfileInfo.PROFILE_CLASS_PROVISIONING
-                        LocalProfileInfo.Clazz.Operational -> EuiccProfileInfo.PROFILE_CLASS_OPERATIONAL
-                    }
-                )
-            }.build()
         }
 
-        return@withEuiccChannelManager GetEuiccProfileInfoListResult(
-            RESULT_OK,
-            profiles.toTypedArray(),
-            channel.port.card.isRemovable
-        )
+        try {
+            return@withEuiccChannelManager euiccChannelManager.withEuiccChannel(
+                slotId,
+                port
+            ) { channel ->
+                val profiles = channel.lpa.profiles.operational.map {
+                    EuiccProfileInfo.Builder(it.iccid).apply {
+                        setProfileName(it.name)
+                        setNickname(it.displayName)
+                        setServiceProviderName(it.providerName)
+                        setState(
+                            when (it.state) {
+                                LocalProfileInfo.State.Enabled -> EuiccProfileInfo.PROFILE_STATE_ENABLED
+                                LocalProfileInfo.State.Disabled -> EuiccProfileInfo.PROFILE_STATE_DISABLED
+                            }
+                        )
+                        setProfileClass(
+                            when (it.profileClass) {
+                                LocalProfileInfo.Clazz.Testing -> EuiccProfileInfo.PROFILE_CLASS_TESTING
+                                LocalProfileInfo.Clazz.Provisioning -> EuiccProfileInfo.PROFILE_CLASS_PROVISIONING
+                                LocalProfileInfo.Clazz.Operational -> EuiccProfileInfo.PROFILE_CLASS_OPERATIONAL
+                            }
+                        )
+                    }.build()
+                }
+
+                GetEuiccProfileInfoListResult(
+                    RESULT_OK,
+                    profiles.toTypedArray(),
+                    channel.port.card.isRemovable
+                )
+            }
+        } catch (e: EuiccChannelManager.EuiccChannelNotFoundException) {
+            return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+                RESULT_FIRST_USER,
+                arrayOf(),
+                true
+            )
+        }
     }
 
     override fun onGetEuiccInfo(slotId: Int): EuiccInfo {
@@ -335,13 +358,17 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 "onUpdateSubscriptionNickname slotId=$slotId iccid=$iccid nickname=$nickname"
             )
             if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
-            val channel = findChannel(slotId) ?: return@withEuiccChannelManager RESULT_FIRST_USER
-            if (!channel.profileExists(iccid)) {
+            val port = euiccChannelManager.findFirstAvailablePort(slotId)
+            if (port < 0) {
                 return@withEuiccChannelManager RESULT_FIRST_USER
             }
-            val success = channel.lpa
-                .setNickname(iccid, nickname!!)
-            appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
+            val success =
+                (euiccChannelManagerService.launchProfileRenameTask(slotId, port, iccid, nickname!!)
+                    ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)?.error == null
+
+            euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
+                appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)
+            }
             return@withEuiccChannelManager if (success) {
                 RESULT_OK
             } else {

From 9d8e58a95dee711eaf431688c3ece27aa15e8d78 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 9 Nov 2024 01:10:55 +0100
Subject: [PATCH 202/458] refactor: open sim toolkit logical (#58)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/58
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-unpriv/src/main/AndroidManifest.xml       |  2 +
 .../ui/UnprivilegedEuiccManagementFragment.kt | 25 ++----
 .../im/angry/openeuicc/util/SIMToolkit.kt     | 80 ++++++++++++-------
 .../src/main/res/values/sim_toolkit.xml       | 32 ++++++++
 4 files changed, 95 insertions(+), 44 deletions(-)
 create mode 100644 app-unpriv/src/main/res/values/sim_toolkit.xml

diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index cb1ef5ff9..8760fb98e 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -29,5 +29,7 @@
 
     <queries>
         <package android:name="com.android.stk" />
+        <package android:name="com.android.stk1" />
+        <package android:name="com.android.stk2" />
     </queries>
 </manifest>
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
index 91c480472..fad03fdfe 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
@@ -1,12 +1,9 @@
 package im.angry.openeuicc.ui
 
-import android.util.Log
 import android.view.Menu
 import android.view.MenuInflater
-import android.view.MenuItem
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.util.SIMToolkit
-import im.angry.openeuicc.util.isUsb
 import im.angry.openeuicc.util.newInstanceEuicc
 import im.angry.openeuicc.util.slotId
 
@@ -19,22 +16,16 @@ class UnprivilegedEuiccManagementFragment : EuiccManagementFragment() {
             newInstanceEuicc(UnprivilegedEuiccManagementFragment::class.java, slotId, portId)
     }
 
+    private val stk by lazy {
+        SIMToolkit(requireContext())
+    }
+
     override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
         super.onCreateOptionsMenu(menu, inflater)
         inflater.inflate(R.menu.fragment_sim_toolkit, menu)
-        menu.findItem(R.id.open_sim_toolkit).isVisible =
-            SIMToolkit.getComponentName(requireContext(), slotId) != null
-    }
-
-    override fun onOptionsItemSelected(item: MenuItem): Boolean =
-        when (item.itemId) {
-            R.id.open_sim_toolkit -> {
-                val intent = SIMToolkit.intent(requireContext(), slotId)
-                Log.d(TAG, "Opening SIM Toolkit for $slotId slot, intent: $intent")
-                startActivity(intent)
-                true
-            }
-
-            else -> super.onOptionsItemSelected(item)
+        menu.findItem(R.id.open_sim_toolkit).apply {
+            isVisible = stk.isAvailable(slotId)
+            intent = stk.intent(slotId)
         }
+    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
index b6aed0f69..148e93237 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
@@ -3,36 +3,62 @@ package im.angry.openeuicc.util
 import android.content.ComponentName
 import android.content.Context
 import android.content.Intent
-import android.content.pm.PackageManager.NameNotFoundException
+import android.content.pm.PackageManager
+import androidx.annotation.ArrayRes
+import im.angry.easyeuicc.R
+import im.angry.openeuicc.core.EuiccChannelManager
 
-object SIMToolkit {
-    private val slot1activities = arrayOf(
-        ComponentName("com.android.stk", "com.android.stk.StkMain1"),
-    )
+class SIMToolkit(private val context: Context) {
+    private val slotSelection = getComponentNames(R.array.sim_toolkit_slot_selection)
 
-    private val slot2activities = arrayOf(
-        ComponentName("com.android.stk", "com.android.stk.StkMain2"),
-    )
-
-    fun getComponentName(context: Context, slotId: Int): ComponentName? {
-        val components = when (slotId) {
-            0 -> slot1activities
-            1 -> slot2activities
-            else -> return null
-        }
-        return components.find {
-            try {
-                context.packageManager.getActivityIcon(it)
-                true
-            } catch (_: NameNotFoundException) {
-                false
-            }
-        }
+    private val slots = buildMap {
+        put(0, getComponentNames(R.array.sim_toolkit_slot_1))
+        put(1, getComponentNames(R.array.sim_toolkit_slot_2))
     }
 
-    fun intent(context: Context, slotId: Int) = Intent(Intent.ACTION_MAIN, null).apply {
-        flags = Intent.FLAG_ACTIVITY_NEW_TASK
-        component = getComponentName(context, slotId)
-        addCategory(Intent.CATEGORY_LAUNCHER)
+    private val packageNames = buildSet {
+        addAll(slotSelection.map { it.packageName })
+        addAll(slots.values.flatten().map { it.packageName })
+    }
+
+    private val activities = packageNames.flatMap(::getActivities).toSet()
+
+    private val launchIntent by lazy {
+        packageNames.firstNotNullOfOrNull(::getLaunchIntent)
+    }
+
+    private fun getLaunchIntent(packageName: String) = try {
+        val pm = context.packageManager
+        pm.getLaunchIntentForPackage(packageName)
+    } catch (_: PackageManager.NameNotFoundException) {
+        null
+    }
+
+    private fun getActivities(packageName: String) = try {
+        val pm = context.packageManager
+        val packageInfo = pm.getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
+        packageInfo.activities!!.filter { it.exported }
+            .map { ComponentName(it.packageName, it.name) }
+    } catch (_: PackageManager.NameNotFoundException) {
+        emptyList()
+    }
+
+    private fun getComponentNames(@ArrayRes id: Int) =
+        context.resources.getStringArray(id).mapNotNull(ComponentName::unflattenFromString)
+
+    fun isAvailable(slotId: Int) = when (slotId) {
+        -1 -> false
+        EuiccChannelManager.USB_CHANNEL_ID -> false
+        else -> intent(slotId) != null
+    }
+
+    fun intent(slotId: Int): Intent? {
+        val components = slots.getOrDefault(slotId, emptySet()) + slotSelection
+        val intent = Intent(Intent.ACTION_MAIN, null).apply {
+            flags = Intent.FLAG_ACTIVITY_NEW_TASK
+            component = components.find(activities::contains)
+            addCategory(Intent.CATEGORY_LAUNCHER)
+        }
+        return if (intent.component != null) intent else launchIntent
     }
 }
diff --git a/app-unpriv/src/main/res/values/sim_toolkit.xml b/app-unpriv/src/main/res/values/sim_toolkit.xml
new file mode 100644
index 000000000..1f162715e
--- /dev/null
+++ b/app-unpriv/src/main/res/values/sim_toolkit.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="Typos">
+    <string-array name="sim_toolkit_slot_selection">
+        <item>com.android.stk/.StkMain</item>
+        <item>com.android.stk/.StkMainHide</item>
+        <item>com.android.stk/.StkListActivity</item>
+        <item>com.android.stk/.StkLauncherListActivity</item>
+    </string-array>
+    <string-array name="sim_toolkit_slot_1">
+        <item>com.android.stk/.StkMain1</item>
+        <item>com.android.stk/.PrimaryStkMain</item>
+        <item>com.android.stk/.StkLauncherActivity</item>
+        <item>com.android.stk/.StkLauncherActivity_Chn</item>
+        <item>com.android.stk/.StkLauncherActivityI</item>
+        <item>com.android.stk/.OppoStkLauncherActivity1</item>
+        <item>com.android.stk/.OplusStkLauncherActivity1</item>
+        <item>com.android.stk/.mtk.StkLauncherActivityI</item>
+    </string-array>
+    <string-array name="sim_toolkit_slot_2">
+        <item>com.android.stk/.StkMain2</item>
+        <item>com.android.stk/.SecondaryStkMain</item>
+        <item>com.android.stk/.StkLauncherActivity2</item>
+        <item>com.android.stk/.StkLauncherActivityII</item>
+        <item>com.android.stk/.OppoStkLauncherActivity2</item>
+        <item>com.android.stk/.OplusStkLauncherActivity2</item>
+        <item>com.android.stk/.mtk.StkLauncherActivityII</item>
+        <item>com.android.stk1/.StkLauncherActivity</item>
+        <item>com.android.stk2/.StkLauncherActivity</item>
+        <item>com.android.stk2/.StkLauncherActivity_Chn</item>
+        <item>com.android.stk2/.StkLauncherActivity2</item>
+    </string-array>
+</resources>
\ No newline at end of file

From 13085ec2023e3c0802c14c3f3d78f54fc867ead3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 15:57:32 -0500
Subject: [PATCH 203/458] Add findAvailablePorts() to EuiccChannelManager

For use with OpenEuiccService
---
 .../angry/openeuicc/core/DefaultEuiccChannelManager.kt   | 9 +++++++++
 .../java/im/angry/openeuicc/core/EuiccChannelManager.kt  | 5 +++++
 2 files changed, 14 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index a1cbe86e9..1d5d8a986 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -174,6 +174,15 @@ open class DefaultEuiccChannelManager(
             findAllEuiccChannelsByPhysicalSlot(physicalSlotId)?.getOrNull(0)?.portId ?: -1
         }
 
+    override suspend fun findAvailablePorts(physicalSlotId: Int): List<Int> =
+        withContext(Dispatchers.IO) {
+            if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                return@withContext listOf(0)
+            }
+
+            findAllEuiccChannelsByPhysicalSlot(physicalSlotId)?.map { it.portId } ?: listOf()
+        }
+
     override suspend fun <R> withEuiccChannel(
         physicalSlotId: Int,
         portId: Int,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 9378f9625..565bf019b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -78,6 +78,11 @@ interface EuiccChannelManager {
      */
     suspend fun findFirstAvailablePort(physicalSlotId: Int): Int
 
+    /**
+     * Returns all mapped & available port IDs for a physical slot.
+     */
+    suspend fun findAvailablePorts(physicalSlotId: Int): List<Int>
+
     class EuiccChannelNotFoundException: Exception("EuiccChannel not found")
 
     /**

From fe6d4264e3a9543eeaf2c02f29417ec057ea9535 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 17:00:41 -0500
Subject: [PATCH 204/458] OpenEuiccService: switch onDeleteSubscription to use
 EuiccChannelManagerService

---
 .../openeuicc/service/OpenEuiccService.kt     | 45 ++++++++-----------
 1 file changed, 19 insertions(+), 26 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 8ec27ec48..6ec6a01a4 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -242,39 +242,30 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         Log.i(TAG, "onDeleteSubscription slotId=$slotId iccid=$iccid")
         if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
 
-        try {
-            val channels =
-                findAllChannels(slotId) ?: return@withEuiccChannelManager RESULT_FIRST_USER
+        val ports = euiccChannelManager.findAvailablePorts(slotId)
+        if (ports.isEmpty()) return@withEuiccChannelManager RESULT_FIRST_USER
 
-            if (!channels[0].profileExists(iccid)) {
-                return@withEuiccChannelManager RESULT_FIRST_USER
-            }
-
-            // If the profile is enabled by ANY channel (port), we cannot delete it
-            channels.forEach { channel ->
+        // Check that the profile has been disabled on all slots
+        val enabledAnywhere = ports.any { port ->
+            euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
                 val profile = channel.lpa.profiles.find {
                     it.iccid == iccid
-                } ?: return@withEuiccChannelManager RESULT_FIRST_USER
+                } ?: return@withEuiccChannel false
 
-                if (profile.state == LocalProfileInfo.State.Enabled) {
-                    // Must disable the profile first
-                    return@withEuiccChannelManager RESULT_FIRST_USER
-                }
+                profile.state == LocalProfileInfo.State.Enabled
             }
+        }
 
-            euiccChannelManager.beginTrackedOperationBlocking(channels[0].slotId, channels[0].portId) {
-                if (channels[0].lpa.deleteProfile(iccid)) {
-                    return@withEuiccChannelManager RESULT_OK
-                }
+        if (enabledAnywhere) return@withEuiccChannelManager RESULT_FIRST_USER
 
-                runBlocking {
-                    preferenceRepository.notificationDeleteFlow.first()
-                }
-            }
+        euiccChannelManagerService.waitForForegroundTask()
+        val success = (euiccChannelManagerService.launchProfileDeleteTask(slotId, ports[0], iccid)
+            ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)!!.error == null
 
-            return@withEuiccChannelManager RESULT_FIRST_USER
-        } catch (e: Exception) {
-            return@withEuiccChannelManager RESULT_FIRST_USER
+        return@withEuiccChannelManager if (success) {
+            RESULT_OK
+        } else {
+            RESULT_FIRST_USER
         }
     }
 
@@ -362,9 +353,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             if (port < 0) {
                 return@withEuiccChannelManager RESULT_FIRST_USER
             }
+
+            euiccChannelManagerService.waitForForegroundTask()
             val success =
                 (euiccChannelManagerService.launchProfileRenameTask(slotId, port, iccid, nickname!!)
-                    ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)?.error == null
+                    ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)!!.error == null
 
             euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
                 appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)

From 837c34ba70a4a85496ddce25dbf131efc5ce91d5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 17:11:55 -0500
Subject: [PATCH 205/458] Add convience "Done" subscriber method for
 Flow<ForegroundTaskState>

---
 .../service/EuiccChannelManagerService.kt     | 23 +++++++++++++------
 .../openeuicc/ui/EuiccManagementFragment.kt   | 13 ++++-------
 .../openeuicc/ui/ProfileDeleteFragment.kt     |  6 ++---
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 20 +++++++---------
 .../openeuicc/ui/ProfileRenameFragment.kt     |  4 ++--
 .../openeuicc/service/OpenEuiccService.kt     |  7 +++---
 6 files changed, 37 insertions(+), 36 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index fce3d3058..9cfd526ca 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -21,6 +21,8 @@ import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.flow.flow
+import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.flow.onCompletion
 import kotlinx.coroutines.flow.onStart
 import kotlinx.coroutines.flow.takeWhile
@@ -55,7 +57,14 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         private const val TAG = "EuiccChannelManagerService"
         private const val CHANNEL_ID = "tasks"
         private const val FOREGROUND_ID = 1000
-        private const val TASK_FAILURE_ID = 1001
+        private const val TASK_FAILURE_ID = 1000
+
+        /**
+         * Utility function to wait for a foreground task to be done, return its
+         * error if any, or null on success.
+         */
+        suspend fun Flow<ForegroundTaskState>.waitDone(): Throwable? =
+            (this.last() as ForegroundTaskState.Done).error
     }
 
     inner class LocalBinder : Binder() {
@@ -185,7 +194,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         failureTitle: String,
         iconRes: Int,
         task: suspend EuiccChannelManagerService.() -> Unit
-    ): Flow<ForegroundTaskState>? {
+    ): Flow<ForegroundTaskState> {
         // Atomically set the state to InProgress. If this returns true, we are
         // the only task currently in progress.
         if (!foregroundTaskState.compareAndSet(
@@ -193,7 +202,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 ForegroundTaskState.InProgress(0)
             )
         ) {
-            return null
+            return flow { emit(ForegroundTaskState.Done(IllegalStateException("There are tasks currently running"))) }
         }
 
         lifecycleScope.launch(Dispatchers.Main) {
@@ -280,7 +289,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         matchingId: String?,
         confirmationCode: String?,
         imei: String?
-    ): Flow<ForegroundTaskState>? =
+    ): Flow<ForegroundTaskState> =
         launchForegroundTask(
             getString(R.string.task_profile_download),
             getString(R.string.task_profile_download_failure),
@@ -316,7 +325,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         portId: Int,
         iccid: String,
         name: String
-    ): Flow<ForegroundTaskState>? =
+    ): Flow<ForegroundTaskState> =
         launchForegroundTask(
             getString(R.string.task_profile_rename),
             getString(R.string.task_profile_rename_failure),
@@ -338,7 +347,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         slotId: Int,
         portId: Int,
         iccid: String
-    ): Flow<ForegroundTaskState>? =
+    ): Flow<ForegroundTaskState> =
         launchForegroundTask(
             getString(R.string.task_profile_delete),
             getString(R.string.task_profile_delete_failure),
@@ -361,7 +370,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         iccid: String,
         enable: Boolean, // Enable or disable the profile indicated in iccid
         reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect, useful for USB readers
-    ): Flow<ForegroundTaskState>? =
+    ): Flow<ForegroundTaskState> =
         launchForegroundTask(
             getString(R.string.task_profile_switch),
             getString(R.string.task_profile_switch_failure),
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index a122b0ba1..bf46043ee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -30,11 +30,11 @@ import com.google.android.material.floatingactionbutton.FloatingActionButton
 import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.service.EuiccChannelManagerService
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -209,7 +209,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
 
-            val res = euiccChannelManagerService.launchProfileSwitchTask(
+            val err = euiccChannelManagerService.launchProfileSwitchTask(
                 slotId,
                 portId,
                 iccid,
@@ -219,14 +219,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 } else {
                     30 * 1000
                 }
-            )?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done
+            ).waitDone()
 
-            if (res == null) {
-                showSwitchFailureText()
-                return@launch
-            }
-
-            when (res.error) {
+            when (err) {
                 null -> {}
                 is EuiccChannelManagerService.SwitchingProfilesRefreshException -> {
                     // This is only really fatal for internal eSIMs
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index 901f263a1..181aeee18 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -8,8 +8,8 @@ import androidx.appcompat.app.AlertDialog
 import androidx.fragment.app.DialogFragment
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.onStart
 import kotlinx.coroutines.launch
 
@@ -74,7 +74,7 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
                 slotId,
                 portId,
                 requireArguments().getString("iccid")!!
-            )!!.onStart {
+            ).onStart {
                 if (parentFragment is EuiccProfilesChangedListener) {
                     // Trigger a refresh in the parent fragment -- it should wait until
                     // any foreground task is completed before actually doing a refresh
@@ -86,7 +86,7 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
                 } catch (e: IllegalStateException) {
                     // Ignored
                 }
-            }.collect()
+            }.waitDone()
         }
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 9aa55068a..69ad1d02e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -19,9 +19,9 @@ import com.journeyapps.barcodescanner.ScanContract
 import com.journeyapps.barcodescanner.ScanOptions
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.service.EuiccChannelManagerService
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -219,14 +219,11 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-            val res = doDownloadProfile(server, code, confirmationCode, imei)
+            val err = doDownloadProfile(server, code, confirmationCode, imei)
 
-            if (res == null || res.error != null) {
+            if (err != null) {
                 Log.d(TAG, "Error downloading profile")
-
-                if (res?.error != null) {
-                    Log.d(TAG, Log.getStackTraceString(res.error))
-                }
+                Log.d(TAG, Log.getStackTraceString(err))
 
                 Toast.makeText(requireContext(), R.string.profile_download_failed, Toast.LENGTH_LONG).show()
             }
@@ -250,14 +247,15 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
         imei: String?
     ) = withContext(Dispatchers.Main) {
         // The service is responsible for launching the actual blocking part on the IO context
-        val res = euiccChannelManagerService.launchProfileDownloadTask(
+        // On our side, we need the Main context because  of the UI updates
+        euiccChannelManagerService.launchProfileDownloadTask(
             slotId,
             portId,
             server,
             code,
             confirmationCode,
             imei
-        )!!.onEach {
+        ).onEach {
             if (it is EuiccChannelManagerService.ForegroundTaskState.InProgress) {
                 progress.progress = it.progress
                 progress.isIndeterminate = it.progress == 0
@@ -265,9 +263,7 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 progress.progress = 100
                 progress.isIndeterminate = false
             }
-        }.last()
-
-        res as? EuiccChannelManagerService.ForegroundTaskState.Done
+        }.waitDone()
     }
 
     override fun onDismiss(dialog: DialogInterface) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 278ea4371..8582278ed 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -11,8 +11,8 @@ import androidx.appcompat.widget.Toolbar
 import androidx.lifecycle.lifecycleScope
 import com.google.android.material.textfield.TextInputLayout
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.launch
 
 class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragmentMarker {
@@ -100,7 +100,7 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
                 portId,
                 requireArguments().getString("iccid")!!,
                 name
-            )?.collect()
+            ).waitDone()
 
             if (parentFragment is EuiccProfilesChangedListener) {
                 (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 6ec6a01a4..a28716310 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -11,6 +11,7 @@ import android.util.Log
 import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.last
@@ -259,8 +260,8 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         if (enabledAnywhere) return@withEuiccChannelManager RESULT_FIRST_USER
 
         euiccChannelManagerService.waitForForegroundTask()
-        val success = (euiccChannelManagerService.launchProfileDeleteTask(slotId, ports[0], iccid)
-            ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)!!.error == null
+        val success = euiccChannelManagerService.launchProfileDeleteTask(slotId, ports[0], iccid)
+            .waitDone() == null
 
         return@withEuiccChannelManager if (success) {
             RESULT_OK
@@ -357,7 +358,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             euiccChannelManagerService.waitForForegroundTask()
             val success =
                 (euiccChannelManagerService.launchProfileRenameTask(slotId, port, iccid, nickname!!)
-                    ?.last() as? EuiccChannelManagerService.ForegroundTaskState.Done)!!.error == null
+                    .waitDone()) == null
 
             euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
                 appContainer.subscriptionManager.tryRefreshCachedEuiccInfo(channel.cardId)

From 7215a2351bd5e31c6a9cc79da48920d6ab5630be Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:29:25 -0500
Subject: [PATCH 206/458] OpenEuiccService: Switch
 onSwitchToSubscriptionWithPort() to use the new service

---
 .../openeuicc/service/OpenEuiccService.kt     | 118 ++++++++++++------
 1 file changed, 80 insertions(+), 38 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index a28716310..af04117b6 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -13,10 +13,9 @@ import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.first
-import kotlinx.coroutines.flow.last
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.runBlocking
-import java.lang.IllegalStateException
+import kotlin.IllegalStateException
 
 class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
     companion object {
@@ -129,7 +128,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         telephonyManager.simSlotMapping = mappings.reversed()
     }
 
-    private fun <T> retryWithTimeout(timeoutMillis: Int, backoff: Int = 1000, f: () -> T?): T? {
+    private suspend fun <T> retryWithTimeout(
+        timeoutMillis: Int,
+        backoff: Int = 1000,
+        f: suspend () -> T?
+    ): T? {
         val startTimeMillis = System.currentTimeMillis()
         do {
             try {
@@ -137,7 +140,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             } catch (_: Exception) {
                 // Ignore
             } finally {
-                Thread.sleep(backoff.toLong())
+                delay(backoff.toLong())
             }
         } while (System.currentTimeMillis() - startTimeMillis < timeoutMillis)
         return null
@@ -289,52 +292,91 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         if (shouldIgnoreSlot(slotId)) return@withEuiccChannelManager RESULT_FIRST_USER
 
         try {
+            // First, try to find a pair of slotId and portId we can use for the switching operation
             // retryWithTimeout is needed here because this function may be called just after
             // AOSP has switched slot mappings, in which case the slots may not be ready yet.
-            val channel = if (portIndex == -1) {
-                retryWithTimeout(5000) { findChannel(slotId) }
-            } else {
-                retryWithTimeout(5000) { findChannel(slotId, portIndex) }
+            val (foundSlotId, foundPortId) = retryWithTimeout(5000) {
+                if (portIndex == -1) {
+                    // If port is not indicated, we can use any port
+                    val port = euiccChannelManager.findFirstAvailablePort(slotId).let {
+                        if (it < 0) {
+                            throw IllegalStateException("No mapped port available; may need to try again")
+                        }
+
+                        it
+                    }
+
+                    Pair(slotId, port)
+                } else {
+                    // Else, check until the indicated port is available
+                    euiccChannelManager.withEuiccChannel(slotId, portIndex) { channel ->
+                        if (!channel.valid) {
+                            throw IllegalStateException("Indicated slot / port combination is unavailable; may need to try again")
+                        }
+                    }
+
+                    Pair(slotId, portIndex)
+                }
             } ?: run {
+                // Failure case: mapped slots / ports aren't usable per constraints
+                // If we can't find a usable slot / port already mapped, and we aren't allowed to
+                // deactivate a SIM, we can only abort
                 if (!forceDeactivateSim) {
-                    // The user must select which SIM to deactivate
                     return@withEuiccChannelManager RESULT_MUST_DEACTIVATE_SIM
+                }
+
+                // If port ID is not indicated, we just try to map port 0
+                // This is because in order to get here, we have to have failed findFirstAvailablePort(),
+                // which means no eUICC port is mapped or connected properly whatsoever.
+                val foundPortId = if (portIndex == -1) {
+                    0
                 } else {
-                    try {
-                        // If we are allowed to deactivate any SIM we like, try mapping the indicated port first
-                        ensurePortIsMapped(slotId, portIndex)
-                        retryWithTimeout(5000) { findChannel(slotId, portIndex) }
-                    } catch (e: Exception) {
-                        // We cannot map the port (or it is already mapped)
-                        // but we can also use any port available on the card
-                        retryWithTimeout(5000) { findChannel(slotId) }
-                    } ?: return@withEuiccChannelManager RESULT_FIRST_USER
+                    portIndex
                 }
-            }
 
-            if (iccid != null && !channel.profileExists(iccid)) {
-                Log.i(TAG, "onSwitchToSubscriptionWithPort iccid=$iccid not found")
-                return@withEuiccChannelManager RESULT_FIRST_USER
-            }
+                // Now we can try to map an unused port
+                try {
+                    ensurePortIsMapped(slotId, foundPortId)
+                } catch (_: Exception) {
+                    return@withEuiccChannelManager RESULT_FIRST_USER
+                }
 
-            euiccChannelManager.beginTrackedOperationBlocking(channel.slotId, channel.portId) {
-                if (iccid != null) {
-                    // Disable any active profile first if present
-                    channel.lpa.disableActiveProfile(false)
-                    if (!channel.lpa.enableProfile(iccid)) {
-                        return@withEuiccChannelManager RESULT_FIRST_USER
+                // Wait for availability again
+                retryWithTimeout(5000) {
+                    euiccChannelManager.withEuiccChannel(slotId, foundPortId) { channel ->
+                        if (!channel.valid) {
+                            throw IllegalStateException("Indicated slot / port combination is unavailable; may need to try again")
+                        }
                     }
-                } else {
-                    if (!channel.lpa.disableActiveProfile(true)) {
-                        return@withEuiccChannelManager RESULT_FIRST_USER
-                    }
-                }
+                } ?: return@withEuiccChannelManager RESULT_FIRST_USER
 
-                runBlocking {
-                    preferenceRepository.notificationSwitchFlow.first()
-                }
+                Pair(slotId, foundPortId)
             }
 
+            Log.i(TAG, "Found slotId=$foundSlotId, portId=$foundPortId for switching")
+
+            // Now, figure out what they want us to do: disabling a profile, or enabling a new one?
+            val (foundIccid, enable) = if (iccid == null) {
+                // iccid == null means disabling
+                val foundIccid =
+                    euiccChannelManager.withEuiccChannel(foundSlotId, foundPortId) { channel ->
+                        channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }
+                    }?.iccid ?: return@withEuiccChannelManager RESULT_FIRST_USER
+                Pair(foundIccid, false)
+            } else {
+                Pair(iccid, true)
+            }
+
+            val res = euiccChannelManagerService.launchProfileSwitchTask(
+                foundSlotId,
+                foundPortId,
+                foundIccid,
+                enable,
+                30 * 1000
+            ).waitDone()
+
+            if (res != null) return@withEuiccChannelManager RESULT_FIRST_USER
+
             return@withEuiccChannelManager RESULT_OK
         } catch (e: Exception) {
             return@withEuiccChannelManager RESULT_FIRST_USER

From f28867ef2e5db6f631f314887a95c2b9319b678f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:31:09 -0500
Subject: [PATCH 207/458] OpenEuiccService: Remove traces of EuiccChannel usage

---
 .../angry/openeuicc/service/OpenEuiccService.kt   | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index af04117b6..af68dffd8 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -42,15 +42,6 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
     ) {
         val euiccChannelManager
             get() = euiccChannelManagerService.euiccChannelManager
-
-        fun findChannel(physicalSlotId: Int): EuiccChannel? =
-            euiccChannelManager.findEuiccChannelByPhysicalSlotBlocking(physicalSlotId)
-
-        fun findChannel(slotId: Int, portId: Int): EuiccChannel? =
-            euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)
-
-        fun findAllChannels(physicalSlotId: Int): List<EuiccChannel>? =
-            euiccChannelManager.findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId)
     }
 
     /**
@@ -88,7 +79,11 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
     }
 
     override fun onGetEid(slotId: Int): String? = withEuiccChannelManager {
-        findChannel(slotId)?.lpa?.eID
+        val portId = euiccChannelManager.findFirstAvailablePort(slotId)
+        if (portId < 0) return@withEuiccChannelManager null
+        euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+            channel.lpa.eID
+        }
     }
 
     // When two eSIM cards are present on one device, the Android settings UI

From 5dacb7571788e8cfd9f271fa4dd514565e7e5502 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:35:01 -0500
Subject: [PATCH 208/458] EuiccChannelManager: Remove some unused methods

---
 .../core/DefaultEuiccChannelManager.kt        | 25 +-----------
 .../openeuicc/core/EuiccChannelManager.kt     | 14 -------
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 39 -------------------
 3 files changed, 1 insertion(+), 77 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 1d5d8a986..80adc5e3b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -113,25 +113,7 @@ open class DefaultEuiccChannelManager(
             findEuiccChannelBySlot(logicalSlotId)
         }
 
-    override fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel? =
-        runBlocking {
-            withContext(Dispatchers.IO) {
-                if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-                    return@withContext usbChannel
-                }
-
-                for (card in uiccCards) {
-                    if (card.physicalSlotIndex != physicalSlotId) continue
-                    for (port in card.ports) {
-                        tryOpenEuiccChannel(port)?.let { return@withContext it }
-                    }
-                }
-
-                null
-            }
-        }
-
-    override suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
+    private suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
         if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
             return usbChannel?.let { listOf(it) }
         }
@@ -144,11 +126,6 @@ open class DefaultEuiccChannelManager(
         return null
     }
 
-    override fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>? =
-        runBlocking {
-            findAllEuiccChannelsByPhysicalSlot(physicalSlotId)
-        }
-
     override suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel? =
         withContext(Dispatchers.IO) {
             if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 565bf019b..c3ed18b26 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -52,20 +52,6 @@ interface EuiccChannelManager {
      */
     fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
 
-    /**
-     * Returns the first EuiccChannel corresponding to a **physical** slot
-     * If the physical slot supports MEP and has multiple ports, it is undefined
-     * which of the two channels will be returned.
-     */
-    fun findEuiccChannelByPhysicalSlotBlocking(physicalSlotId: Int): EuiccChannel?
-
-    /**
-     * Returns all EuiccChannels corresponding to a **physical** slot
-     * Multiple channels are possible in the case of MEP
-     */
-    suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>?
-    fun findAllEuiccChannelsByPhysicalSlotBlocking(physicalSlotId: Int): List<EuiccChannel>?
-
     /**
      * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
      */
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index c96361de9..0e2fd470d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -3,9 +3,6 @@ package im.angry.openeuicc.util
 import android.util.Log
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.runBlocking
-import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 
@@ -108,40 +105,4 @@ suspend inline fun EuiccChannelManager.beginTrackedOperation(
         }
     }
     Log.d(TAG, "Operation complete")
-}
-
-/**
- * Same as beginTrackedOperation but uses blocking primitives.
- * TODO: This function needs to be phased out of use.
- */
-inline fun EuiccChannelManager.beginTrackedOperationBlocking(
-    slotId: Int,
-    portId: Int,
-    op: () -> Boolean
-) {
-    val latestSeq =
-        findEuiccChannelByPortBlocking(slotId, portId)!!.lpa.notifications.firstOrNull()?.seqNumber
-            ?: 0
-    Log.d(TAG, "Latest notification is $latestSeq before operation")
-    if (op()) {
-        Log.d(TAG, "Operation has requested notification handling")
-        try {
-            // Note that the exact instance of "channel" might have changed here if reconnected;
-            // so we MUST use the automatic getter for "channel"
-            findEuiccChannelByPortBlocking(
-                slotId,
-                portId
-            )?.lpa?.notifications?.filter { it.seqNumber > latestSeq }?.forEach {
-                Log.d(TAG, "Handling notification $it")
-                findEuiccChannelByPortBlocking(
-                    slotId,
-                    portId
-                )?.lpa?.handleNotification(it.seqNumber)
-            }
-        } catch (e: Exception) {
-            // Ignore any error during notification handling
-            e.printStackTrace()
-        }
-    }
-    Log.d(TAG, "Operation complete")
 }
\ No newline at end of file

From d846f0cdc437bc8c7a48e3f8fc24af5c6c038752 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:40:05 -0500
Subject: [PATCH 209/458] LPAUtils: Remove usage of findEuiccChannelByPort()

---
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 21 ++++++++-----------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 0e2fd470d..0fe44c105 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -80,24 +80,21 @@ suspend inline fun EuiccChannelManager.beginTrackedOperation(
     portId: Int,
     op: () -> Boolean
 ) {
-    val latestSeq =
-        findEuiccChannelByPort(slotId, portId)!!.lpa.notifications.firstOrNull()?.seqNumber
+    val latestSeq = withEuiccChannel(slotId, portId) { channel ->
+        channel.lpa.notifications.firstOrNull()?.seqNumber
             ?: 0
+    }
     Log.d(TAG, "Latest notification is $latestSeq before operation")
     if (op()) {
         Log.d(TAG, "Operation has requested notification handling")
         try {
             // Note that the exact instance of "channel" might have changed here if reconnected;
-            // so we MUST use the automatic getter for "channel"
-            findEuiccChannelByPort(
-                slotId,
-                portId
-            )?.lpa?.notifications?.filter { it.seqNumber > latestSeq }?.forEach {
-                Log.d(TAG, "Handling notification $it")
-                findEuiccChannelByPort(
-                    slotId,
-                    portId
-                )?.lpa?.handleNotification(it.seqNumber)
+            // this is why we need to use two distinct calls to withEuiccChannel()
+            withEuiccChannel(slotId, portId) { channel ->
+                channel.lpa.notifications.filter { it.seqNumber > latestSeq }.forEach {
+                    Log.d(TAG, "Handling notification $it")
+                    channel.lpa.handleNotification(it.seqNumber)
+                }
             }
         } catch (e: Exception) {
             // Ignore any error during notification handling

From 7105c43ae42b9fe6f7ff4cc85f65ab9d50ef7466 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:42:21 -0500
Subject: [PATCH 210/458] EuiccChannelManager: Remove findEuiccChannelByPort()
 as public method

---
 .../im/angry/openeuicc/core/DefaultEuiccChannelManager.kt  | 7 +------
 .../java/im/angry/openeuicc/core/EuiccChannelManager.kt    | 6 ------
 .../im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt   | 3 ---
 3 files changed, 1 insertion(+), 15 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 80adc5e3b..618cb405c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -126,7 +126,7 @@ open class DefaultEuiccChannelManager(
         return null
     }
 
-    override suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel? =
+    private suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel? =
         withContext(Dispatchers.IO) {
             if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
                 return@withContext usbChannel
@@ -137,11 +137,6 @@ open class DefaultEuiccChannelManager(
             }
         }
 
-    override fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel? =
-        runBlocking {
-            findEuiccChannelByPort(physicalSlotId, portId)
-        }
-
     override suspend fun findFirstAvailablePort(physicalSlotId: Int): Int =
         withContext(Dispatchers.IO) {
             if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index c3ed18b26..017b6d26d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -52,12 +52,6 @@ interface EuiccChannelManager {
      */
     fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
 
-    /**
-     * Returns the EuiccChannel corresponding to a **physical** slot and a port ID
-     */
-    suspend fun findEuiccChannelByPort(physicalSlotId: Int, portId: Int): EuiccChannel?
-    fun findEuiccChannelByPortBlocking(physicalSlotId: Int, portId: Int): EuiccChannel?
-
     /**
      * Returns the first mapped & available port ID for a physical slot, or -1 if
      * not found.
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 3a74fbb08..f0cf19364 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -36,9 +36,6 @@ val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: EuiccCh
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
 val <T> T.euiccChannelManagerService: EuiccChannelManagerService where T: Fragment, T: EuiccChannelFragmentMarker
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerService
-val <T> T.channel: EuiccChannel where T: Fragment, T: EuiccChannelFragmentMarker
-    get() =
-        euiccChannelManager.findEuiccChannelByPortBlocking(slotId, portId)!!
 
 suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R where T : Fragment, T : EuiccChannelFragmentMarker {
     ensureEuiccChannelManager()

From 9201ee416e325e4e8cff6331939db3d918348c60 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:45:48 -0500
Subject: [PATCH 211/458] OpenEuiccService: Remove more useless stuff

---
 .../java/im/angry/openeuicc/service/OpenEuiccService.kt    | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index af68dffd8..aeda3e489 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -9,7 +9,6 @@ import android.telephony.euicc.DownloadableSubscription
 import android.telephony.euicc.EuiccInfo
 import android.util.Log
 import net.typeblog.lpac_jni.LocalProfileInfo
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
@@ -86,12 +85,6 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         }
     }
 
-    // When two eSIM cards are present on one device, the Android settings UI
-    // gets confused and sets the incorrect slotId for profiles from one of
-    // the cards. This function helps Detect this case and abort early.
-    private fun EuiccChannel.profileExists(iccid: String?) =
-        lpa.profiles.any { it.iccid == iccid }
-
     private fun ensurePortIsMapped(slotId: Int, portId: Int) {
         if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
             return

From 42c870192c05f2754bcb6561ed52f9948ecd6586 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:53:35 -0500
Subject: [PATCH 212/458] Remove last trace of findEuiccChannelBySlotBlocking()
 public usage

---
 .../core/DefaultEuiccChannelManager.kt        |  2 +-
 .../openeuicc/core/EuiccChannelManager.kt     |  5 ---
 .../openeuicc/ui/NotificationsActivity.kt     | 35 ++++++++-----------
 3 files changed, 15 insertions(+), 27 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 618cb405c..432546365 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -108,7 +108,7 @@ open class DefaultEuiccChannelManager(
             null
         }
 
-    override fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
+    protected fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
         runBlocking {
             findEuiccChannelBySlot(logicalSlotId)
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 017b6d26d..323eed92c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -47,11 +47,6 @@ interface EuiccChannelManager {
      */
     suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long = 1000)
 
-    /**
-     * Returns the EuiccChannel corresponding to a **logical** slot
-     */
-    fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel?
-
     /**
      * Returns the first mapped & available port ID for a physical slot, or -1 if
      * not found.
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 884e2237d..31b7d7edc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -20,7 +20,6 @@ import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -33,7 +32,7 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private lateinit var notificationList: RecyclerView
     private val notificationAdapter = NotificationAdapter()
 
-    private lateinit var euiccChannel: EuiccChannel
+    private var logicalSlotId = -1
 
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
@@ -56,7 +55,7 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         notificationList.adapter = notificationAdapter
         registerForContextMenu(notificationList)
 
-        val logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
+        logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
 
         // This is slightly different from the MainActivity logic
         // due to the length (we don't want to display the full USB product name)
@@ -104,16 +103,8 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
-            if (!this@NotificationsActivity::euiccChannel.isInitialized) {
-                withContext(Dispatchers.IO) {
-                    euiccChannelManagerLoaded.await()
-                    euiccChannel = euiccChannelManager.findEuiccChannelBySlotBlocking(
-                        intent.getIntExtra(
-                            "logicalSlotId",
-                            0
-                        )
-                    )!!
-                }
+            withContext(Dispatchers.IO) {
+                euiccChannelManagerLoaded.await()
             }
 
             task()
@@ -124,13 +115,11 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private fun refresh() {
        launchTask {
-           val profiles = withContext(Dispatchers.IO) {
-               euiccChannel.lpa.profiles
-           }
-
            notificationAdapter.notifications =
-               withContext(Dispatchers.IO) {
-                   euiccChannel.lpa.notifications.map {
+               euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
+                   val profiles = channel.lpa.profiles
+
+                   channel.lpa.notifications.map {
                        val profile = profiles.find { p -> p.iccid == it.iccid }
                        LocalProfileNotificationWrapper(it, profile?.displayName ?: "???")
                    }
@@ -205,7 +194,9 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 R.id.notification_process -> {
                     launchTask {
                         withContext(Dispatchers.IO) {
-                            euiccChannel.lpa.handleNotification(notification.inner.seqNumber)
+                            euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
+                                channel.lpa.handleNotification(notification.inner.seqNumber)
+                            }
                         }
 
                         refresh()
@@ -215,7 +206,9 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 R.id.notification_delete -> {
                     launchTask {
                         withContext(Dispatchers.IO) {
-                            euiccChannel.lpa.deleteNotification(notification.inner.seqNumber)
+                            euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
+                                channel.lpa.deleteNotification(notification.inner.seqNumber)
+                            }
                         }
 
                         refresh()

From 8e806c3ae5b950cc8bc7616f6f8d7d128c2b4cb8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:55:12 -0500
Subject: [PATCH 213/458] EuiccChannelManager: slot -> logicalSlot

---
 .../im/angry/openeuicc/core/DefaultEuiccChannelManager.kt | 8 ++++----
 .../angry/openeuicc/core/PrivilegedEuiccChannelManager.kt | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 432546365..aeb037da6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -91,7 +91,7 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    private suspend fun findEuiccChannelBySlot(logicalSlotId: Int): EuiccChannel? =
+    private suspend fun findEuiccChannelByLogicalSlot(logicalSlotId: Int): EuiccChannel? =
         withContext(Dispatchers.IO) {
             if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
                 return@withContext usbChannel
@@ -108,9 +108,9 @@ open class DefaultEuiccChannelManager(
             null
         }
 
-    protected fun findEuiccChannelBySlotBlocking(logicalSlotId: Int): EuiccChannel? =
+    protected fun findEuiccChannelByLogicalSlotBlocking(logicalSlotId: Int): EuiccChannel? =
         runBlocking {
-            findEuiccChannelBySlot(logicalSlotId)
+            findEuiccChannelByLogicalSlot(logicalSlotId)
         }
 
     private suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
@@ -176,7 +176,7 @@ open class DefaultEuiccChannelManager(
         logicalSlotId: Int,
         fn: suspend (EuiccChannel) -> R
     ): R {
-        val channel = findEuiccChannelBySlot(logicalSlotId)
+        val channel = findEuiccChannelByLogicalSlot(logicalSlotId)
             ?: throw EuiccChannelManager.EuiccChannelNotFoundException()
         val wrapper = EuiccChannelWrapper(channel)
         try {
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index 923bbab85..ffc14e9d3 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -30,7 +30,7 @@ class PrivilegedEuiccChannelManager(
 
     override fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
         appContainer.subscriptionManager.apply {
-            findEuiccChannelBySlotBlocking(logicalSlotId)?.let {
+            findEuiccChannelByLogicalSlotBlocking(logicalSlotId)?.let {
                 tryRefreshCachedEuiccInfo(it.cardId)
             }
         }

From 6f8aef8ea83e01112ff22402535cf2e47cac8a44 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 10 Nov 2024 20:56:56 -0500
Subject: [PATCH 214/458] EuiccChannelManager: Remove last trace of blocking
 methods

---
 .../im/angry/openeuicc/core/DefaultEuiccChannelManager.kt  | 7 +------
 .../java/im/angry/openeuicc/core/EuiccChannelManager.kt    | 2 +-
 .../angry/openeuicc/core/PrivilegedEuiccChannelManager.kt  | 4 ++--
 3 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index aeb037da6..c75af4093 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -91,7 +91,7 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    private suspend fun findEuiccChannelByLogicalSlot(logicalSlotId: Int): EuiccChannel? =
+    protected suspend fun findEuiccChannelByLogicalSlot(logicalSlotId: Int): EuiccChannel? =
         withContext(Dispatchers.IO) {
             if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
                 return@withContext usbChannel
@@ -108,11 +108,6 @@ open class DefaultEuiccChannelManager(
             null
         }
 
-    protected fun findEuiccChannelByLogicalSlotBlocking(logicalSlotId: Int): EuiccChannel? =
-        runBlocking {
-            findEuiccChannelByLogicalSlot(logicalSlotId)
-        }
-
     private suspend fun findAllEuiccChannelsByPhysicalSlot(physicalSlotId: Int): List<EuiccChannel>? {
         if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
             return usbChannel?.let { listOf(it) }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index 323eed92c..c485cd259 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -93,7 +93,7 @@ interface EuiccChannelManager {
      * This is only expected to be implemented when the application is privileged
      * TODO: Remove this from the common interface
      */
-    fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
+    suspend fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
         // no-op by default
     }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
index ffc14e9d3..aaf54902b 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelManager.kt
@@ -28,9 +28,9 @@ class PrivilegedEuiccChannelManager(
         }
     }
 
-    override fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
+    override suspend fun notifyEuiccProfilesChanged(logicalSlotId: Int) {
         appContainer.subscriptionManager.apply {
-            findEuiccChannelByLogicalSlotBlocking(logicalSlotId)?.let {
+            findEuiccChannelByLogicalSlot(logicalSlotId)?.let {
                 tryRefreshCachedEuiccInfo(it.cardId)
             }
         }

From 071304349a1f8a74ec30901e3751409a95b98f9d Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 12 Nov 2024 02:42:25 +0100
Subject: [PATCH 215/458] fix: crash with disable com.android.stk app (#60)

```console
pm disable-user com.android.stk
```

after running this command, the app will crash when launched

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/60
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/util/SIMToolkit.kt  | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
index 148e93237..ced813a18 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
@@ -34,13 +34,16 @@ class SIMToolkit(private val context: Context) {
         null
     }
 
-    private fun getActivities(packageName: String) = try {
-        val pm = context.packageManager
-        val packageInfo = pm.getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
-        packageInfo.activities!!.filter { it.exported }
-            .map { ComponentName(it.packageName, it.name) }
-    } catch (_: PackageManager.NameNotFoundException) {
-        emptyList()
+    private fun getActivities(packageName: String): List<ComponentName> {
+        return try {
+            val pm = context.packageManager
+            val packageInfo = pm.getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
+            val activities = packageInfo.activities
+            if (activities.isNullOrEmpty()) return emptyList()
+            activities.filter { it.exported }.map { ComponentName(it.packageName, it.name) }
+        } catch (_: PackageManager.NameNotFoundException) {
+            emptyList()
+        }
     }
 
     private fun getComponentNames(@ArrayRes id: Int) =

From e8db3d1206ad6fcae81c55d4c6fcb262f2f8dd6c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 13 Nov 2024 22:47:35 +0100
Subject: [PATCH 216/458] chore: simplify CompatibilityCheckActivity logical
 (#61)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/61
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/CompatibilityCheckActivity.kt          | 20 ++++++-------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index 06b46df51..433f9c363 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -1,7 +1,6 @@
 package im.angry.openeuicc.ui
 
 import android.os.Bundle
-import android.util.Log
 import android.view.MenuItem
 import android.view.View
 import android.view.ViewGroup
@@ -68,20 +67,13 @@ class CompatibilityCheckActivity: AppCompatActivity() {
                 it.visibility = View.GONE
             }
 
-            when (item.state) {
-                CompatibilityCheck.State.SUCCESS -> {
-                    root.requireViewById<View>(R.id.compatibility_check_checkmark).visibility = View.VISIBLE
-                }
-                CompatibilityCheck.State.FAILURE -> {
-                    root.requireViewById<View>(R.id.compatibility_check_error).visibility = View.VISIBLE
-                }
-                CompatibilityCheck.State.FAILURE_UNKNOWN -> {
-                    root.requireViewById<View>(R.id.compatibility_check_unknown).visibility = View.VISIBLE
-                }
-                else -> {
-                    root.requireViewById<View>(R.id.compatibility_check_progress_bar).visibility = View.VISIBLE
-                }
+            val viewId = when (item.state) {
+                CompatibilityCheck.State.SUCCESS -> R.id.compatibility_check_checkmark
+                CompatibilityCheck.State.FAILURE -> R.id.compatibility_check_error
+                CompatibilityCheck.State.FAILURE_UNKNOWN -> R.id.compatibility_check_unknown
+                else -> R.id.compatibility_check_progress_bar
             }
+            root.requireViewById<View>(viewId).visibility = View.VISIBLE
         }
     }
 

From 506b0e530ac966ccfbe2dcd8b698b28959b822f4 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 14 Nov 2024 14:02:27 +0100
Subject: [PATCH 217/458] feat: low nvram alert (#62)

If free nvram available is less 30 kib, then alert dialog

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/62
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 20 +++++++++++++++++--
 app-common/src/main/res/values/strings.xml    |  3 +++
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 69ad1d02e..85f120a55 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
+import android.app.AlertDialog
 import android.app.Dialog
 import android.content.DialogInterface
 import android.graphics.BitmapFactory
@@ -25,13 +26,14 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
-import kotlin.Exception
 
 class ProfileDownloadFragment : BaseMaterialDialogFragment(),
     Toolbar.OnMenuItemClickListener, EuiccChannelFragmentMarker {
     companion object {
         const val TAG = "ProfileDownloadFragment"
 
+        const val LOW_NVRAM_THRESHOLD = 30 * 1024 // < 30 KiB, the alert may fail
+
         fun newInstance(slotId: Int, portId: Int, finishWhenDone: Boolean = false): ProfileDownloadFragment =
             newInstanceEuicc(ProfileDownloadFragment::class.java, slotId, portId) {
                 putBoolean("finishWhenDone", finishWhenDone)
@@ -135,7 +137,21 @@ class ProfileDownloadFragment : BaseMaterialDialogFragment(),
                 true
             }
             R.id.ok -> {
-                startDownloadProfile()
+                if (freeNvram > LOW_NVRAM_THRESHOLD) {
+                    startDownloadProfile()
+                } else {
+                    AlertDialog.Builder(requireContext()).apply {
+                        setTitle(R.string.profile_download_low_nvram_title)
+                        setMessage(R.string.profile_download_low_nvram_message)
+                        setIcon(android.R.drawable.ic_dialog_alert)
+                        setCancelable(true)
+                        setPositiveButton(android.R.string.ok) { _, _ ->
+                            startDownloadProfile()
+                        }
+                        setNegativeButton(android.R.string.cancel, null)
+                        show()
+                    }
+                }
                 true
             }
             else -> false
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index cc8f220e8..05ea4c5ca 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -55,6 +55,9 @@
     <string name="profile_download_ok">Download</string>
     <string name="profile_download_failed">Failed to download eSIM. Check your activation / QR code.</string>
 
+    <string name="profile_download_low_nvram_title">This download may fail</string>
+    <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
+
     <string name="profile_rename_new_name">New nickname</string>
 
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>

From e9f4d3d1f9d4557628bd9946ffb7f72101dca6bd Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 14 Nov 2024 14:59:13 +0100
Subject: [PATCH 218/458] fix: unified alert dialog style (#65)

see https://gitea.angry.im/PeterCxy/OpenEUICC/search/branch/master?q=.app.AlertDialog

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/65
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
index 85f120a55..f590d365e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
@@ -1,7 +1,6 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
-import android.app.AlertDialog
 import android.app.Dialog
 import android.content.DialogInterface
 import android.graphics.BitmapFactory
@@ -13,6 +12,7 @@ import android.widget.ProgressBar
 import android.widget.TextView
 import android.widget.Toast
 import androidx.activity.result.contract.ActivityResultContracts
+import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.widget.Toolbar
 import androidx.lifecycle.lifecycleScope
 import com.google.android.material.textfield.TextInputLayout

From 47d5c3881c23548ea96482fa1d8286c30a9988e6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 16 Nov 2024 18:34:45 -0500
Subject: [PATCH 219/458] ui: Add skeleton of an experimental new download flow

This doesn't work yet at all, and is hidden behind an experimental
settings switch.
---
 app-common/src/main/AndroidManifest.xml       |  4 ++
 .../openeuicc/ui/EuiccManagementFragment.kt   | 12 ++++-
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  6 +--
 .../ui/wizard/DownloadWizardActivity.kt       | 43 ++++++++++++++++++
 .../angry/openeuicc/util/PreferenceUtils.kt   |  4 ++
 .../src/main/res/drawable/ic_chevron_left.xml |  5 +++
 .../main/res/drawable/ic_chevron_right.xml    |  5 +++
 .../res/layout/activity_download_wizard.xml   | 44 +++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  6 +++
 app-common/src/main/res/xml/pref_settings.xml |  6 +++
 10 files changed, 130 insertions(+), 5 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
 create mode 100644 app-common/src/main/res/drawable/ic_chevron_left.xml
 create mode 100644 app-common/src/main/res/drawable/ic_chevron_right.xml
 create mode 100644 app-common/src/main/res/layout/activity_download_wizard.xml

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index 11f16a6bd..a33838f77 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -32,6 +32,10 @@
             android:name="im.angry.openeuicc.ui.LogsActivity"
             android:label="@string/pref_advanced_logs" />
 
+        <activity
+            android:name="im.angry.openeuicc.ui.wizard.DownloadWizardActivity"
+            android:label="@string/download_wizard" />
+
         <activity
             android:name="com.journeyapps.barcodescanner.CaptureActivity"
             android:screenOrientation="fullSensor"
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index bf46043ee..c3ecbf38b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -31,10 +31,12 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
+import im.angry.openeuicc.ui.wizard.DownloadWizardActivity
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -105,8 +107,14 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
 
         fab.setOnClickListener {
-            ProfileDownloadFragment.newInstance(slotId, portId)
-                .show(childFragmentManager, ProfileDownloadFragment.TAG)
+            lifecycleScope.launch {
+                if (preferenceRepository.experimentalDownloadWizardFlow.first()) {
+                    startActivity(Intent(requireContext(), DownloadWizardActivity::class.java))
+                } else {
+                    ProfileDownloadFragment.newInstance(slotId, portId)
+                        .show(childFragmentManager, ProfileDownloadFragment.TAG)
+                }
+            }
         }
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 5ed43480b..1981db5d9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -3,9 +3,6 @@ package im.angry.openeuicc.ui
 import android.content.Intent
 import android.net.Uri
 import android.os.Bundle
-import android.view.LayoutInflater
-import android.view.View
-import android.view.ViewGroup
 import androidx.datastore.preferences.core.Preferences
 import androidx.lifecycle.lifecycleScope
 import androidx.preference.CheckBoxPreference
@@ -50,6 +47,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
 
         findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
             ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow, PreferenceKeys.VERBOSE_LOGGING)
+
+        findPreference<CheckBoxPreference>("pref_advanced_experimental_download_wizard")
+            ?.bindBooleanFlow(preferenceRepository.experimentalDownloadWizardFlow, PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD)
     }
 
     override fun onStart() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
new file mode 100644
index 000000000..4db4b38eb
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -0,0 +1,43 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.os.Bundle
+import android.view.View
+import androidx.activity.OnBackPressedCallback
+import androidx.activity.enableEdgeToEdge
+import androidx.core.view.ViewCompat
+import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.updatePadding
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.ui.BaseEuiccAccessActivity
+
+class DownloadWizardActivity: BaseEuiccAccessActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_download_wizard)
+        onBackPressedDispatcher.addCallback(object : OnBackPressedCallback(true) {
+            override fun handleOnBackPressed() {
+                // TODO: Actually implement this
+            }
+        })
+
+        val navigation = requireViewById<View>(R.id.download_wizard_navigation)
+        val origHeight = navigation.layoutParams.height
+
+        ViewCompat.setOnApplyWindowInsetsListener(navigation) { v, insets ->
+            val bars = insets.getInsets(
+                WindowInsetsCompat.Type.systemBars()
+                        or WindowInsetsCompat.Type.displayCutout()
+            )
+            v.updatePadding(bars.left, 0, bars.right, bars.bottom)
+            val newParams = navigation.layoutParams
+            newParams.height = origHeight + bars.bottom
+            navigation.layoutParams = newParams
+            WindowInsetsCompat.CONSUMED
+        }
+    }
+
+    override fun onInit() {
+
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 262482ade..ebc32d9e5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -25,6 +25,7 @@ object PreferenceKeys {
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
     val DISABLE_SAFEGUARD_REMOVABLE_ESIM = booleanPreferencesKey("disable_safeguard_removable_esim")
     val VERBOSE_LOGGING = booleanPreferencesKey("verbose_logging")
+    val EXPERIMENTAL_DOWNLOAD_WIZARD = booleanPreferencesKey("experimental_download_wizard")
 }
 
 class PreferenceRepository(context: Context) {
@@ -48,6 +49,9 @@ class PreferenceRepository(context: Context) {
     val verboseLoggingFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.VERBOSE_LOGGING] ?: false }
 
+    val experimentalDownloadWizardFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD] ?: false }
+
     suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
         dataStore.edit {
             it[key] = value
diff --git a/app-common/src/main/res/drawable/ic_chevron_left.xml b/app-common/src/main/res/drawable/ic_chevron_left.xml
new file mode 100644
index 000000000..1152da9f9
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_chevron_left.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M15.41,7.41L14,6l-6,6 6,6 1.41,-1.41L10.83,12z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/drawable/ic_chevron_right.xml b/app-common/src/main/res/drawable/ic_chevron_right.xml
new file mode 100644
index 000000000..1db5e6806
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_chevron_right.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M10,6L8.59,7.41 13.17,12l-4.58,4.59L10,18l6,-6z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/layout/activity_download_wizard.xml b/app-common/src/main/res/layout/activity_download_wizard.xml
new file mode 100644
index 000000000..7f5637c72
--- /dev/null
+++ b/app-common/src/main/res/layout/activity_download_wizard.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:id="@+id/download_wizard_navigation"
+        android:layout_width="match_parent"
+        android:layout_height="48dp"
+        android:background="?attr/colorSurfaceContainer"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent">
+
+        <com.google.android.material.button.MaterialButton
+            android:id="@+id/download_wizard_back"
+            android:text="@string/download_wizard_back"
+            android:background="?attr/selectableItemBackground"
+            android:textColor="?attr/colorPrimary"
+            android:layout_width="wrap_content"
+            android:layout_height="48dp"
+            app:icon="@drawable/ic_chevron_left"
+            app:iconGravity="start"
+            app:iconTint="?attr/colorPrimary"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent" />
+
+        <com.google.android.material.button.MaterialButton
+            android:id="@+id/download_wizard_next"
+            android:text="@string/download_wizard_next"
+            android:background="?attr/selectableItemBackground"
+            android:textColor="?attr/colorPrimary"
+            android:layout_width="wrap_content"
+            android:layout_height="48dp"
+            app:icon="@drawable/ic_chevron_right"
+            app:iconGravity="end"
+            app:iconTint="?attr/colorPrimary"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintTop_toTopOf="parent" />
+
+    </androidx.constraintlayout.widget.ConstraintLayout>
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 05ea4c5ca..47dd89739 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -58,6 +58,10 @@
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
 
+    <string name="download_wizard">Download Wizard</string>
+    <string name="download_wizard_back">Back</string>
+    <string name="download_wizard_next">Next</string>
+
     <string name="profile_rename_new_name">New nickname</string>
 
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>
@@ -113,6 +117,8 @@
     <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
+    <string name="pref_advanced_experimental_download_wizard">Experimental Download Wizard</string>
+    <string name="pref_advanced_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 53395ed8b..96306120c 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -41,6 +41,12 @@
             app:iconSpaceReserved="false"
             app:title="@string/pref_advanced_logs"
             app:summary="@string/pref_advanced_logs_desc" />
+
+        <CheckBoxPreference
+            app:key="pref_advanced_experimental_download_wizard"
+            app:iconSpaceReserved="false"
+            app:title="@string/pref_advanced_experimental_download_wizard"
+            app:summary="@string/pref_advanced_experimental_download_wizard_desc" />
     </PreferenceCategory>
 
     <PreferenceCategory

From efa9b8bfa43f6588c7ab4fe805e8ac1859916b81 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 16 Nov 2024 20:37:43 -0500
Subject: [PATCH 220/458] ui: Set up progress bar for the new wizard

---
 .../ui/wizard/DownloadWizardActivity.kt       |  7 ++++++-
 .../res/layout/activity_download_wizard.xml   | 21 +++++++++++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 4db4b38eb..edd9f2ee8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -2,6 +2,7 @@ package im.angry.openeuicc.ui.wizard
 
 import android.os.Bundle
 import android.view.View
+import android.widget.ProgressBar
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.enableEdgeToEdge
 import androidx.core.view.ViewCompat
@@ -11,6 +12,8 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
+    private lateinit var progressBar: ProgressBar
+
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)
@@ -21,6 +24,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             }
         })
 
+        progressBar = requireViewById(R.id.progress)
+
         val navigation = requireViewById<View>(R.id.download_wizard_navigation)
         val origHeight = navigation.layoutParams.height
 
@@ -38,6 +43,6 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     }
 
     override fun onInit() {
-
+        progressBar.visibility = View.GONE
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/activity_download_wizard.xml b/app-common/src/main/res/layout/activity_download_wizard.xml
index 7f5637c72..605eca251 100644
--- a/app-common/src/main/res/layout/activity_download_wizard.xml
+++ b/app-common/src/main/res/layout/activity_download_wizard.xml
@@ -4,6 +4,27 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
+    <View
+        android:id="@+id/guideline"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:orientation="vertical"
+        android:visibility="invisible"
+        app:layout_constraintBottom_toTopOf="@id/download_wizard_navigation"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent" />
+
+    <ProgressBar
+        android:id="@+id/progress"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:indeterminate="true"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/guideline"
+        app:layout_constraintBottom_toTopOf="@id/download_wizard_navigation"
+        style="@style/Widget.AppCompat.ProgressBar.Horizontal" />
+
     <androidx.constraintlayout.widget.ConstraintLayout
         android:id="@+id/download_wizard_navigation"
         android:layout_width="match_parent"

From 5f0dbe3098e2296beb66bd1c627188e5f75e8ba5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 16 Nov 2024 20:59:36 -0500
Subject: [PATCH 221/458] ui: Hide developer settings behind 7 clicks

---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 67 ++++++++++++++++++-
 .../angry/openeuicc/util/PreferenceUtils.kt   |  5 ++
 app-common/src/main/res/values/strings.xml    |  8 ++-
 app-common/src/main/res/xml/pref_settings.xml | 14 +++-
 4 files changed, 87 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 1981db5d9..f3687326a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -3,23 +3,48 @@ package im.angry.openeuicc.ui
 import android.content.Intent
 import android.net.Uri
 import android.os.Bundle
+import android.widget.Toast
 import androidx.datastore.preferences.core.Preferences
 import androidx.lifecycle.lifecycleScope
 import androidx.preference.CheckBoxPreference
 import androidx.preference.Preference
+import androidx.preference.PreferenceCategory
 import androidx.preference.PreferenceFragmentCompat
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.collect
+import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.runBlocking
 
 class SettingsFragment: PreferenceFragmentCompat() {
+    private lateinit var developerPref: PreferenceCategory
+
+    // Hidden developer options switch
+    private var numClicks = 0
+    private var lastClickTimestamp = -1L
+    private var lastToast: Toast? = null
+
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         setPreferencesFromResource(R.xml.pref_settings, rootKey)
 
+        developerPref = findPreference("pref_developer")!!
+
+        // Show / hide developer preference based on whether it is enabled
+        lifecycleScope.launch {
+            preferenceRepository.developerOptionsEnabledFlow.onEach {
+                developerPref.isVisible = it
+            }.collect()
+        }
+
         findPreference<Preference>("pref_info_app_version")
-            ?.summary = requireContext().selfAppVersion
+            ?.apply {
+                summary = requireContext().selfAppVersion
+
+                // Enable developer options when this is clicked for 7 times
+                setOnPreferenceClickListener(this@SettingsFragment::onAppVersionClicked)
+            }
 
         findPreference<Preference>("pref_info_source_code")
             ?.setOnPreferenceClickListener {
@@ -48,7 +73,7 @@ class SettingsFragment: PreferenceFragmentCompat() {
         findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
             ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow, PreferenceKeys.VERBOSE_LOGGING)
 
-        findPreference<CheckBoxPreference>("pref_advanced_experimental_download_wizard")
+        findPreference<CheckBoxPreference>("pref_developer_experimental_download_wizard")
             ?.bindBooleanFlow(preferenceRepository.experimentalDownloadWizardFlow, PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD)
     }
 
@@ -57,6 +82,44 @@ class SettingsFragment: PreferenceFragmentCompat() {
         setupRootViewInsets(requireView().requireViewById(androidx.preference.R.id.recycler_view))
     }
 
+    @Suppress("UNUSED_PARAMETER")
+    private fun onAppVersionClicked(pref: Preference): Boolean {
+        if (developerPref.isVisible) return false
+        val now = System.currentTimeMillis()
+        if (now - lastClickTimestamp >= 1000) {
+            numClicks = 1
+        } else {
+            numClicks++
+        }
+        lastClickTimestamp = now
+
+        if (numClicks == 7) {
+            lifecycleScope.launch {
+                preferenceRepository.updatePreference(
+                    PreferenceKeys.DEVELOPER_OPTIONS_ENABLED,
+                    true
+                )
+
+                lastToast?.cancel()
+                Toast.makeText(
+                    requireContext(),
+                    R.string.developer_options_enabled,
+                    Toast.LENGTH_SHORT
+                ).show()
+            }
+        } else if (numClicks > 1) {
+            lastToast?.cancel()
+            lastToast = Toast.makeText(
+                requireContext(),
+                getString(R.string.developer_options_steps, 7 - numClicks),
+                Toast.LENGTH_SHORT
+            )
+            lastToast!!.show()
+        }
+
+        return true
+    }
+
     private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
         lifecycleScope.launch {
             flow.collect { isChecked = it }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index ebc32d9e5..700c4cd7c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -25,6 +25,7 @@ object PreferenceKeys {
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
     val DISABLE_SAFEGUARD_REMOVABLE_ESIM = booleanPreferencesKey("disable_safeguard_removable_esim")
     val VERBOSE_LOGGING = booleanPreferencesKey("verbose_logging")
+    val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
     val EXPERIMENTAL_DOWNLOAD_WIZARD = booleanPreferencesKey("experimental_download_wizard")
 }
 
@@ -49,6 +50,10 @@ class PreferenceRepository(context: Context) {
     val verboseLoggingFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.VERBOSE_LOGGING] ?: false }
 
+    // ---- Developer Options ----
+    val developerOptionsEnabledFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.DEVELOPER_OPTIONS_ENABLED] ?: false }
+
     val experimentalDownloadWizardFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD] ?: false }
 
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 47dd89739..062a5c045 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -101,6 +101,9 @@
     <string name="logs_save">Save</string>
     <string name="logs_filename_template">Logs at %s</string>
 
+    <string name="developer_options_steps">You are %d steps away from being a developer.</string>
+    <string name="developer_options_enabled">You are now a developer!</string>
+
     <string name="pref_settings">Settings</string>
     <string name="pref_notifications">Notifications</string>
     <string name="pref_notifications_desc">eSIM profile operations send notifications to the carrier. Fine-tune this behavior as needed here.</string>
@@ -117,8 +120,9 @@
     <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
-    <string name="pref_advanced_experimental_download_wizard">Experimental Download Wizard</string>
-    <string name="pref_advanced_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
+    <string name="pref_developer">Developer Options</string>
+    <string name="pref_developer_experimental_download_wizard">Experimental Download Wizard</string>
+    <string name="pref_developer_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 96306120c..150aca55f 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -42,11 +42,19 @@
             app:title="@string/pref_advanced_logs"
             app:summary="@string/pref_advanced_logs_desc" />
 
+    </PreferenceCategory>
+
+    <PreferenceCategory
+        app:key="pref_developer"
+        app:title="@string/pref_developer"
+        app:iconSpaceReserved="false">
+
         <CheckBoxPreference
-            app:key="pref_advanced_experimental_download_wizard"
+            app:key="pref_developer_experimental_download_wizard"
             app:iconSpaceReserved="false"
-            app:title="@string/pref_advanced_experimental_download_wizard"
-            app:summary="@string/pref_advanced_experimental_download_wizard_desc" />
+            app:title="@string/pref_developer_experimental_download_wizard"
+            app:summary="@string/pref_developer_experimental_download_wizard_desc" />
+
     </PreferenceCategory>
 
     <PreferenceCategory

From a3d59a07610eb1463851b2f40c7605b07e2e42ae Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 17 Nov 2024 03:43:38 +0100
Subject: [PATCH 222/458] feat: ignore tls certificate (#66)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/66
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../core/DefaultEuiccChannelFactory.kt        |  6 +++--
 .../angry/openeuicc/core/EuiccChannelImpl.kt  |  5 ++--
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  3 +++
 .../angry/openeuicc/util/PreferenceUtils.kt   |  9 ++++++++
 app-common/src/main/res/values/strings.xml    |  2 ++
 app-common/src/main/res/xml/pref_settings.xml |  6 +++++
 .../core/PrivilegedEuiccChannelFactory.kt     |  3 ++-
 .../lpac_jni/impl/HttpInterfaceImpl.kt        | 23 +++++++++++++++----
 .../lpac_jni/impl/IgnoreTLSCertificate.kt     | 22 ++++++++++++++++++
 9 files changed, 69 insertions(+), 10 deletions(-)
 create mode 100644 libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 410cccc71..a8fa1d535 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -42,7 +42,8 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                     port,
                     context.preferenceRepository.verboseLoggingFlow
                 ),
-                context.preferenceRepository.verboseLoggingFlow
+                context.preferenceRepository.verboseLoggingFlow,
+                context.preferenceRepository.ignoreTLSCertificateFlow,
             ).also {
                 Log.i(DefaultEuiccChannelManager.TAG, "Is OMAPI channel, setting MSS to 60")
                 it.lpa.setEs10xMss(60)
@@ -72,7 +73,8 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                 bulkOut,
                 context.preferenceRepository.verboseLoggingFlow
             ),
-            context.preferenceRepository.verboseLoggingFlow
+            context.preferenceRepository.verboseLoggingFlow,
+            context.preferenceRepository.ignoreTLSCertificateFlow,
         )
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index 9bccbff59..79dec3436 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -11,14 +11,15 @@ class EuiccChannelImpl(
     override val type: String,
     override val port: UiccPortInfoCompat,
     apduInterface: ApduInterface,
-    verboseLoggingFlow: Flow<Boolean>
+    verboseLoggingFlow: Flow<Boolean>,
+    ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
     override val slotId = port.card.physicalSlotIndex
     override val logicalSlotId = port.logicalSlotIndex
     override val portId = port.portIndex
 
     override val lpa: LocalProfileAssistant =
-        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow))
+        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow))
 
     override val valid: Boolean
         get() = lpa.valid
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index f3687326a..89963cb55 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -75,6 +75,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
 
         findPreference<CheckBoxPreference>("pref_developer_experimental_download_wizard")
             ?.bindBooleanFlow(preferenceRepository.experimentalDownloadWizardFlow, PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD)
+
+        findPreference<CheckBoxPreference>("pref_ignore_tls_certificate")
+            ?.bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow, PreferenceKeys.IGNORE_TLS_CERTIFICATE)
     }
 
     override fun onStart() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 700c4cd7c..505630ee9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -20,13 +20,19 @@ val Fragment.preferenceRepository: PreferenceRepository
     get() = requireContext().preferenceRepository
 
 object PreferenceKeys {
+    // ---- Profile Notifications ----
     val NOTIFICATION_DOWNLOAD = booleanPreferencesKey("notification_download")
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
     val NOTIFICATION_SWITCH = booleanPreferencesKey("notification_switch")
+
+    // ---- Advanced ----
     val DISABLE_SAFEGUARD_REMOVABLE_ESIM = booleanPreferencesKey("disable_safeguard_removable_esim")
     val VERBOSE_LOGGING = booleanPreferencesKey("verbose_logging")
+
+    // ---- Developer Options ----
     val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
     val EXPERIMENTAL_DOWNLOAD_WIZARD = booleanPreferencesKey("experimental_download_wizard")
+    val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
 }
 
 class PreferenceRepository(context: Context) {
@@ -57,6 +63,9 @@ class PreferenceRepository(context: Context) {
     val experimentalDownloadWizardFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD] ?: false }
 
+    val ignoreTLSCertificateFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.IGNORE_TLS_CERTIFICATE] ?: false }
+
     suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
         dataStore.edit {
             it[key] = value
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 062a5c045..bdb89caed 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -123,6 +123,8 @@
     <string name="pref_developer">Developer Options</string>
     <string name="pref_developer_experimental_download_wizard">Experimental Download Wizard</string>
     <string name="pref_developer_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
+    <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">Ignore SM-DP+ TLS certificate, allow any RSP</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 150aca55f..d43c84b8e 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -55,6 +55,12 @@
             app:title="@string/pref_developer_experimental_download_wizard"
             app:summary="@string/pref_developer_experimental_download_wizard_desc" />
 
+        <CheckBoxPreference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_ignore_tls_certificate"
+            app:summary="@string/pref_developer_ignore_tls_certificate_desc"
+            app:title="@string/pref_developer_ignore_tls_certificate" />
+
     </PreferenceCategory>
 
     <PreferenceCategory
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index c90e4502e..1537fc9e5 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -35,7 +35,8 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                         tm,
                         context.preferenceRepository.verboseLoggingFlow
                     ),
-                    context.preferenceRepository.verboseLoggingFlow
+                    context.preferenceRepository.verboseLoggingFlow,
+                    context.preferenceRepository.ignoreTLSCertificateFlow,
                 )
             } catch (e: IllegalArgumentException) {
                 // Failed
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index dd72ab325..77227f860 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -9,10 +9,14 @@ import java.net.URL
 import java.security.SecureRandom
 import javax.net.ssl.HttpsURLConnection
 import javax.net.ssl.SSLContext
+import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.TrustManager
 import javax.net.ssl.TrustManagerFactory
 
-class HttpInterfaceImpl(private val verboseLoggingFlow: Flow<Boolean>) : HttpInterface {
+class HttpInterfaceImpl(
+    private val verboseLoggingFlow: Flow<Boolean>,
+    private val ignoreTLSCertificateFlow: Flow<Boolean>
+) : HttpInterface {
     companion object {
         private const val TAG = "HttpInterfaceImpl"
     }
@@ -36,9 +40,6 @@ class HttpInterfaceImpl(private val verboseLoggingFlow: Flow<Boolean>) : HttpInt
         }
 
         try {
-            val sslContext = SSLContext.getInstance("TLS")
-            sslContext.init(null, trustManagers, SecureRandom())
-
             val conn = parsedUrl.openConnection() as HttpsURLConnection
             conn.connectTimeout = 2000
 
@@ -47,7 +48,7 @@ class HttpInterfaceImpl(private val verboseLoggingFlow: Flow<Boolean>) : HttpInt
                 conn.readTimeout = 1000
             }
 
-            conn.sslSocketFactory = sslContext.socketFactory
+            conn.sslSocketFactory = getSocketFactory()
             conn.requestMethod = "POST"
             conn.doInput = true
             conn.doOutput = true
@@ -79,6 +80,18 @@ class HttpInterfaceImpl(private val verboseLoggingFlow: Flow<Boolean>) : HttpInt
         }
     }
 
+    private fun getSocketFactory(): SSLSocketFactory {
+        val trustManagers =
+            if (runBlocking { ignoreTLSCertificateFlow.first() }) {
+                arrayOf(IgnoreTLSCertificate())
+            } else {
+                this.trustManagers
+            }
+        val sslContext = SSLContext.getInstance("TLS")
+        sslContext.init(null, trustManagers, SecureRandom())
+        return sslContext.socketFactory
+    }
+
     override fun usePublicKeyIds(pkids: Array<String>) {
         val trustManagerFactory = TrustManagerFactory.getInstance("PKIX").apply {
             init(keyIdToKeystore(pkids))
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt
new file mode 100644
index 000000000..7b1328254
--- /dev/null
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt
@@ -0,0 +1,22 @@
+package net.typeblog.lpac_jni.impl
+
+import android.annotation.SuppressLint
+import java.security.cert.X509Certificate
+import javax.net.ssl.X509TrustManager
+
+@SuppressLint("CustomX509TrustManager")
+class IgnoreTLSCertificate : X509TrustManager {
+    @SuppressLint("TrustAllX509TrustManager")
+    override fun checkClientTrusted(p0: Array<out X509Certificate>?, p1: String?) {
+        return
+    }
+
+    @SuppressLint("TrustAllX509TrustManager")
+    override fun checkServerTrusted(p0: Array<out X509Certificate>?, p1: String?) {
+        return
+    }
+
+    override fun getAcceptedIssuers(): Array<X509Certificate> {
+        return emptyArray()
+    }
+}
\ No newline at end of file

From 375d13b7c481021108b94620bed77a250cc951bd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 17:32:42 -0500
Subject: [PATCH 223/458] ui: Start designing UI for selectiing slot in the new
 download flow

incomplete
---
 .../ui/wizard/DownloadWizardActivity.kt       |  69 +++++++++++
 .../DownloadWizardSlotSelectFragment.kt       | 108 ++++++++++++++++++
 .../util/EuiccChannelFragmentUtils.kt         |   6 +-
 .../res/layout/activity_download_wizard.xml   |   9 ++
 .../main/res/layout/download_slot_item.xml    |  77 +++++++++++++
 .../layout/fragment_download_slot_select.xml  |  29 +++++
 app-common/src/main/res/values/strings.xml    |   4 +
 7 files changed, 299 insertions(+), 3 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
 create mode 100644 app-common/src/main/res/layout/download_slot_item.xml
 create mode 100644 app-common/src/main/res/layout/fragment_download_slot_select.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index edd9f2ee8..4a8183400 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -2,17 +2,24 @@ package im.angry.openeuicc.ui.wizard
 
 import android.os.Bundle
 import android.view.View
+import android.widget.Button
 import android.widget.ProgressBar
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.enableEdgeToEdge
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
+import androidx.fragment.app.Fragment
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
+import im.angry.openeuicc.util.*
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
     private lateinit var progressBar: ProgressBar
+    private lateinit var nextButton: Button
+    private lateinit var prevButton: Button
+
+    private var currentFragment: DownloadWizardStepFragment? = null
 
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
@@ -25,6 +32,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         })
 
         progressBar = requireViewById(R.id.progress)
+        nextButton = requireViewById(R.id.download_wizard_next)
+        prevButton = requireViewById(R.id.download_wizard_back)
 
         val navigation = requireViewById<View>(R.id.download_wizard_navigation)
         val origHeight = navigation.layoutParams.height
@@ -40,9 +49,69 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             navigation.layoutParams = newParams
             WindowInsetsCompat.CONSUMED
         }
+
+        val fragmentRoot = requireViewById<View>(R.id.step_fragment_container)
+        ViewCompat.setOnApplyWindowInsetsListener(fragmentRoot) { v, insets ->
+            val bars = insets.getInsets(
+                WindowInsetsCompat.Type.systemBars()
+                        or WindowInsetsCompat.Type.displayCutout()
+            )
+            v.updatePadding(bars.left, bars.top, bars.right, 0)
+            WindowInsetsCompat.CONSUMED
+        }
     }
 
     override fun onInit() {
         progressBar.visibility = View.GONE
+        showFragment(DownloadWizardSlotSelectFragment())
+    }
+
+    private fun showFragment(nextFrag: DownloadWizardStepFragment) {
+        currentFragment = nextFrag
+        supportFragmentManager.beginTransaction().replace(R.id.step_fragment_container, nextFrag)
+            .commit()
+        refreshButtons()
+    }
+
+    private fun refreshButtons() {
+        currentFragment?.let {
+            nextButton.visibility = if (it.hasNext) {
+                View.VISIBLE
+            } else {
+                View.GONE
+            }
+            prevButton.visibility = if (it.hasNext) {
+                View.VISIBLE
+            } else {
+                View.GONE
+            }
+        }
+    }
+
+    abstract class DownloadWizardStepFragment : Fragment(), OpenEuiccContextMarker {
+        abstract val hasNext: Boolean
+        abstract val hasPrev: Boolean
+        abstract fun createNextFragment(): DownloadWizardStepFragment
+        abstract fun createPrevFragment(): DownloadWizardStepFragment
+
+        protected fun hideProgressBar() {
+            (requireActivity() as DownloadWizardActivity).progressBar.visibility = View.GONE
+        }
+
+        protected fun showProgressBar(progressValue: Int) {
+            (requireActivity() as DownloadWizardActivity).progressBar.apply {
+                visibility = View.VISIBLE
+                if (progressValue >= 0) {
+                    isIndeterminate = false
+                    progress = progressValue
+                } else {
+                    isIndeterminate = true
+                }
+            }
+        }
+
+        protected fun refreshButtons() {
+            (requireActivity() as DownloadWizardActivity).refreshButtons()
+        }
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
new file mode 100644
index 000000000..6627f1b2b
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -0,0 +1,108 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.annotation.SuppressLint
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import androidx.lifecycle.lifecycleScope
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import androidx.recyclerview.widget.RecyclerView.ViewHolder
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.toList
+import kotlinx.coroutines.launch
+import net.typeblog.lpac_jni.LocalProfileInfo
+
+class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    private data class SlotInfo(
+        val logicalSlotId: Int,
+        val eID: String,
+        val enabledProfileName: String?
+    )
+
+    private var loaded = false
+
+    private val adapter = SlotInfoAdapter()
+
+    override val hasNext: Boolean
+        get() = loaded
+    override val hasPrev: Boolean
+        get() = false
+
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment {
+        TODO("Not yet implemented")
+    }
+
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment {
+        TODO("Not yet implemented")
+    }
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_download_slot_select, container, false)
+        val recyclerView = view.requireViewById<RecyclerView>(R.id.download_slot_list)
+        recyclerView.adapter = adapter
+        recyclerView.layoutManager =
+            LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
+        return view
+    }
+
+    override fun onStart() {
+        super.onStart()
+        if (!loaded) {
+            lifecycleScope.launch { init() }
+        }
+    }
+
+    @SuppressLint("NotifyDataSetChanged")
+    private suspend fun init() {
+        showProgressBar(-1)
+        val slots = euiccChannelManager.flowEuiccPorts().map { (slotId, portId) ->
+            euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                SlotInfo(
+                    channel.logicalSlotId,
+                    channel.lpa.eID,
+                    channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
+                )
+            }
+        }.toList()
+        adapter.slots = slots
+        adapter.notifyDataSetChanged()
+        hideProgressBar()
+        refreshButtons()
+    }
+
+    private class SlotItemHolder(val root: View) : ViewHolder(root) {
+        private val title = root.requireViewById<TextView>(R.id.slot_item_title)
+        private val eID = root.requireViewById<TextView>(R.id.slot_item_eid)
+        private val activeProfile = root.requireViewById<TextView>(R.id.slot_item_active_profile)
+
+        fun bind(item: SlotInfo) {
+            title.text = root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
+            eID.text = item.eID
+            activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
+        }
+    }
+
+    private class SlotInfoAdapter : RecyclerView.Adapter<SlotItemHolder>() {
+        var slots: List<SlotInfo> = listOf()
+
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SlotItemHolder {
+            val root = LayoutInflater.from(parent.context).inflate(R.layout.download_slot_item, parent, false)
+            return SlotItemHolder(root)
+        }
+
+        override fun getItemCount(): Int = slots.size
+
+        override fun onBindViewHolder(holder: SlotItemHolder, position: Int) {
+            holder.bind(slots[position])
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index f0cf19364..3f3c4ee53 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -32,9 +32,9 @@ val <T> T.portId: Int where T: Fragment, T: EuiccChannelFragmentMarker
 val <T> T.isUsb: Boolean where T: Fragment, T: EuiccChannelFragmentMarker
     get() = requireArguments().getInt("slotId") == EuiccChannelManager.USB_CHANNEL_ID
 
-val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: EuiccChannelFragmentMarker
+val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: OpenEuiccContextMarker
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
-val <T> T.euiccChannelManagerService: EuiccChannelManagerService where T: Fragment, T: EuiccChannelFragmentMarker
+val <T> T.euiccChannelManagerService: EuiccChannelManagerService where T: Fragment, T: OpenEuiccContextMarker
     get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerService
 
 suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R where T : Fragment, T : EuiccChannelFragmentMarker {
@@ -42,7 +42,7 @@ suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R where
     return euiccChannelManager.withEuiccChannel(slotId, portId, fn)
 }
 
-suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: EuiccChannelFragmentMarker =
+suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: OpenEuiccContextMarker =
     (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerLoaded.await()
 
 interface EuiccProfilesChangedListener {
diff --git a/app-common/src/main/res/layout/activity_download_wizard.xml b/app-common/src/main/res/layout/activity_download_wizard.xml
index 605eca251..79513bb77 100644
--- a/app-common/src/main/res/layout/activity_download_wizard.xml
+++ b/app-common/src/main/res/layout/activity_download_wizard.xml
@@ -4,6 +4,15 @@
     android:layout_height="match_parent"
     xmlns:app="http://schemas.android.com/apk/res-auto">
 
+    <FrameLayout
+        android:id="@+id/step_fragment_container"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/download_wizard_navigation"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
     <View
         android:id="@+id/guideline"
         android:layout_width="0dp"
diff --git a/app-common/src/main/res/layout/download_slot_item.xml b/app-common/src/main/res/layout/download_slot_item.xml
new file mode 100644
index 000000000..b1a581045
--- /dev/null
+++ b/app-common/src/main/res/layout/download_slot_item.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:layout_marginBottom="10sp"
+    android:layout_marginTop="10sp"
+    android:paddingStart="20sp"
+    android:paddingEnd="20sp">
+
+    <TextView
+        android:id="@+id/slot_item_title"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_margin="10sp"
+        android:textSize="18sp"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <TextView
+        android:id="@+id/slot_item_eid_label"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="@string/download_wizard_slot_eid"
+        android:textSize="14sp" />
+
+    <TextView
+        android:id="@+id/slot_item_eid"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:textSize="14sp" />
+
+    <TextView
+        android:id="@+id/slot_item_active_profile_label"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="@string/download_wizard_slot_active_profile"
+        android:textSize="14sp" />
+
+    <TextView
+        android:id="@+id/slot_item_active_profile"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:textSize="14sp" />
+
+    <androidx.constraintlayout.helper.widget.Flow
+        android:id="@+id/flow1"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="10sp"
+        android:layout_marginTop="20sp"
+        android:layout_marginEnd="10sp"
+        app:constraint_referenced_ids="slot_item_eid_label,slot_item_eid,slot_item_active_profile_label,slot_item_active_profile"
+        app:flow_wrapMode="aligned"
+        app:flow_horizontalAlign="start"
+        app:flow_horizontalBias="1"
+        app:flow_horizontalGap="10sp"
+        app:flow_horizontalStyle="packed"
+        app:flow_maxElementsWrap="2"
+        app:flow_verticalBias="0"
+        app:flow_verticalGap="16sp"
+        app:flow_verticalStyle="packed"
+        app:layout_constraintEnd_toStartOf="@id/slot_checkbox"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/slot_item_title" />
+
+    <CheckBox
+        android:id="@+id/slot_checkbox"
+        android:layout_width="48dp"
+        android:layout_height="48dp"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toEndOf="@id/flow1"
+        app:layout_constraintTop_toTopOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/fragment_download_slot_select.xml b/app-common/src/main/res/layout/fragment_download_slot_select.xml
new file mode 100644
index 000000000..8d204344b
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_download_slot_select.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/download_slot_select_title"
+        android:text="@string/download_wizard_slot_select"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="20sp"
+        android:layout_margin="20sp"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/download_slot_list"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        app:layout_constraintTop_toBottomOf="@id/download_slot_select_title"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constrainedHeight="true"
+        app:layout_constraintHeight_max="300dp" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bdb89caed..64aeaed70 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -61,6 +61,10 @@
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>
     <string name="download_wizard_next">Next</string>
+    <string name="download_wizard_slot_select">Select an eSIM slot:</string>
+    <string name="download_wizard_slot_title">Logical slot %d</string>
+    <string name="download_wizard_slot_eid">eID:</string>
+    <string name="download_wizard_slot_active_profile">Active Profile:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 1087a676d4e5e00d2081dfd195e7f57234a90a36 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 19:04:41 -0500
Subject: [PATCH 224/458] ui: Fix slot item alignment in new wizard

---
 app-common/src/main/res/layout/download_slot_item.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-common/src/main/res/layout/download_slot_item.xml b/app-common/src/main/res/layout/download_slot_item.xml
index b1a581045..1cf188b40 100644
--- a/app-common/src/main/res/layout/download_slot_item.xml
+++ b/app-common/src/main/res/layout/download_slot_item.xml
@@ -22,6 +22,7 @@
         android:id="@+id/slot_item_eid_label"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
+        android:minWidth="100dp"
         android:text="@string/download_wizard_slot_eid"
         android:textSize="14sp" />
 
@@ -35,6 +36,7 @@
         android:id="@+id/slot_item_active_profile_label"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
+        android:minWidth="100dp"
         android:text="@string/download_wizard_slot_active_profile"
         android:textSize="14sp" />
 

From 93e7297caa2484734765efe39a3a31fc47706a30 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 19:14:00 -0500
Subject: [PATCH 225/458] ui: Implement single selection for new wizard

---
 .../DownloadWizardSlotSelectFragment.kt       | 32 ++++++++++++++++---
 .../main/res/layout/download_slot_item.xml    |  7 ++--
 2 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 6627f1b2b..b12406254 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -5,8 +5,10 @@ import android.os.Bundle
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
+import android.widget.CheckBox
 import android.widget.TextView
 import androidx.lifecycle.lifecycleScope
+import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import androidx.recyclerview.widget.RecyclerView.ViewHolder
@@ -51,6 +53,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         recyclerView.adapter = adapter
         recyclerView.layoutManager =
             LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
+        recyclerView.addItemDecoration(DividerItemDecoration(requireContext(), LinearLayoutManager.VERTICAL))
         return view
     }
 
@@ -79,30 +82,51 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         refreshButtons()
     }
 
-    private class SlotItemHolder(val root: View) : ViewHolder(root) {
+    private class SlotItemHolder(val adapter: SlotInfoAdapter, val root: View) : ViewHolder(root) {
         private val title = root.requireViewById<TextView>(R.id.slot_item_title)
         private val eID = root.requireViewById<TextView>(R.id.slot_item_eid)
         private val activeProfile = root.requireViewById<TextView>(R.id.slot_item_active_profile)
+        private val checkBox = root.requireViewById<CheckBox>(R.id.slot_checkbox)
 
-        fun bind(item: SlotInfo) {
+        private var curIdx = -1
+
+        init {
+            root.setOnClickListener(this::onSelect)
+            checkBox.setOnClickListener(this::onSelect)
+        }
+
+        @Suppress("UNUSED_PARAMETER")
+        fun onSelect(view: View) {
+            if (curIdx < 0) return
+            if (adapter.currentSelectedIdx == curIdx) return
+            val lastIdx = adapter.currentSelectedIdx
+            adapter.currentSelectedIdx = curIdx
+            adapter.notifyItemChanged(lastIdx)
+            adapter.notifyItemChanged(curIdx)
+        }
+
+        fun bind(item: SlotInfo, idx: Int) {
+            curIdx = idx
             title.text = root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
             eID.text = item.eID
             activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
+            checkBox.isChecked = adapter.currentSelectedIdx == idx
         }
     }
 
     private class SlotInfoAdapter : RecyclerView.Adapter<SlotItemHolder>() {
         var slots: List<SlotInfo> = listOf()
+        var currentSelectedIdx = 0
 
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SlotItemHolder {
             val root = LayoutInflater.from(parent.context).inflate(R.layout.download_slot_item, parent, false)
-            return SlotItemHolder(root)
+            return SlotItemHolder(this, root)
         }
 
         override fun getItemCount(): Int = slots.size
 
         override fun onBindViewHolder(holder: SlotItemHolder, position: Int) {
-            holder.bind(slots[position])
+            holder.bind(slots[position], position)
         }
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/download_slot_item.xml b/app-common/src/main/res/layout/download_slot_item.xml
index 1cf188b40..45a7cc948 100644
--- a/app-common/src/main/res/layout/download_slot_item.xml
+++ b/app-common/src/main/res/layout/download_slot_item.xml
@@ -3,10 +3,11 @@
     xmlns:app="http://schemas.android.com/apk/res-auto"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
-    android:layout_marginBottom="10sp"
-    android:layout_marginTop="10sp"
+    android:paddingBottom="20sp"
+    android:paddingTop="10sp"
     android:paddingStart="20sp"
-    android:paddingEnd="20sp">
+    android:paddingEnd="20sp"
+    android:background="?attr/selectableItemBackground">
 
     <TextView
         android:id="@+id/slot_item_title"

From 16636988b0be4d0cc6b6b7e16d6b347590606915 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 19:15:42 -0500
Subject: [PATCH 226/458] ui: Fixup loaded state

---
 .../java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt | 2 +-
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt     | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 4a8183400..2958a7f81 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -80,7 +80,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             } else {
                 View.GONE
             }
-            prevButton.visibility = if (it.hasNext) {
+            prevButton.visibility = if (it.hasPrev) {
                 View.VISIBLE
             } else {
                 View.GONE
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index b12406254..cbbf7926f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -79,6 +79,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         adapter.slots = slots
         adapter.notifyDataSetChanged()
         hideProgressBar()
+        loaded = true
         refreshButtons()
     }
 

From 4fb59a4b015ba3251eeb5ac3a51c701b044ee1ad Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 19:17:29 -0500
Subject: [PATCH 227/458] ui: Fixup strings for eSIM slot selection

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 64aeaed70..dad121801 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -61,7 +61,7 @@
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>
     <string name="download_wizard_next">Next</string>
-    <string name="download_wizard_slot_select">Select an eSIM slot:</string>
+    <string name="download_wizard_slot_select">Confirm the eSIM slot:</string>
     <string name="download_wizard_slot_title">Logical slot %d</string>
     <string name="download_wizard_slot_eid">eID:</string>
     <string name="download_wizard_slot_active_profile">Active Profile:</string>

From 87f36f4166cb62c52bf11f312494d5169ebe3228 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 21:41:40 -0500
Subject: [PATCH 228/458] ui: Expose more info in slot select fragment

---
 .../DownloadWizardSlotSelectFragment.kt       | 19 +++++++++++++++++++
 .../main/res/layout/download_slot_item.xml    | 16 +++++++++++++++-
 .../layout/fragment_download_slot_select.xml  |  3 +--
 app-common/src/main/res/values/strings.xml    |  4 ++++
 4 files changed, 39 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index cbbf7926f..253fbdfd7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -22,6 +22,9 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
     private data class SlotInfo(
         val logicalSlotId: Int,
+        val isRemovable: Boolean,
+        val hasMultiplePorts: Boolean,
+        val portId: Int,
         val eID: String,
         val enabledProfileName: String?
     )
@@ -71,6 +74,9 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
                 SlotInfo(
                     channel.logicalSlotId,
+                    channel.port.card.isRemovable,
+                    channel.port.card.ports.size > 1,
+                    channel.portId,
                     channel.lpa.eID,
                     channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
                 )
@@ -85,6 +91,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
 
     private class SlotItemHolder(val adapter: SlotInfoAdapter, val root: View) : ViewHolder(root) {
         private val title = root.requireViewById<TextView>(R.id.slot_item_title)
+        private val type = root.requireViewById<TextView>(R.id.slot_item_type)
         private val eID = root.requireViewById<TextView>(R.id.slot_item_eid)
         private val activeProfile = root.requireViewById<TextView>(R.id.slot_item_active_profile)
         private val checkBox = root.requireViewById<CheckBox>(R.id.slot_checkbox)
@@ -108,6 +115,18 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
 
         fun bind(item: SlotInfo, idx: Int) {
             curIdx = idx
+
+            type.text = if (item.isRemovable) {
+                root.context.getString(R.string.download_wizard_slot_type_removable)
+            } else if (!item.hasMultiplePorts) {
+                root.context.getString(R.string.download_wizard_slot_type_internal)
+            } else {
+                root.context.getString(
+                    R.string.download_wizard_slot_type_internal_port,
+                    item.portId
+                )
+            }
+
             title.text = root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
             eID.text = item.eID
             activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
diff --git a/app-common/src/main/res/layout/download_slot_item.xml b/app-common/src/main/res/layout/download_slot_item.xml
index 45a7cc948..fa06b4c11 100644
--- a/app-common/src/main/res/layout/download_slot_item.xml
+++ b/app-common/src/main/res/layout/download_slot_item.xml
@@ -19,6 +19,20 @@
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintTop_toTopOf="parent" />
 
+    <TextView
+        android:id="@+id/slot_item_type_label"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:minWidth="100dp"
+        android:text="@string/download_wizard_slot_type"
+        android:textSize="14sp" />
+
+    <TextView
+        android:id="@+id/slot_item_type"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:textSize="14sp" />
+
     <TextView
         android:id="@+id/slot_item_eid_label"
         android:layout_width="wrap_content"
@@ -54,7 +68,7 @@
         android:layout_marginStart="10sp"
         android:layout_marginTop="20sp"
         android:layout_marginEnd="10sp"
-        app:constraint_referenced_ids="slot_item_eid_label,slot_item_eid,slot_item_active_profile_label,slot_item_active_profile"
+        app:constraint_referenced_ids="slot_item_type_label,slot_item_type,slot_item_eid_label,slot_item_eid,slot_item_active_profile_label,slot_item_active_profile"
         app:flow_wrapMode="aligned"
         app:flow_horizontalAlign="start"
         app:flow_horizontalBias="1"
diff --git a/app-common/src/main/res/layout/fragment_download_slot_select.xml b/app-common/src/main/res/layout/fragment_download_slot_select.xml
index 8d204344b..6bd2e5db1 100644
--- a/app-common/src/main/res/layout/fragment_download_slot_select.xml
+++ b/app-common/src/main/res/layout/fragment_download_slot_select.xml
@@ -23,7 +23,6 @@
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintBottom_toBottomOf="parent"
-        app:layout_constrainedHeight="true"
-        app:layout_constraintHeight_max="300dp" />
+        app:layout_constrainedHeight="true" />
 
 </androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index dad121801..609fe7340 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -63,6 +63,10 @@
     <string name="download_wizard_next">Next</string>
     <string name="download_wizard_slot_select">Confirm the eSIM slot:</string>
     <string name="download_wizard_slot_title">Logical slot %d</string>
+    <string name="download_wizard_slot_type">Type:</string>
+    <string name="download_wizard_slot_type_removable">Removable</string>
+    <string name="download_wizard_slot_type_internal">Internal</string>
+    <string name="download_wizard_slot_type_internal_port">Internal, port %d</string>
     <string name="download_wizard_slot_eid">eID:</string>
     <string name="download_wizard_slot_active_profile">Active Profile:</string>
 

From 6458f54db2f4e44d36f11f379e6c2544d0319b3b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 21:42:41 -0500
Subject: [PATCH 229/458] ui: Ensure EuiccChannelManager is available in slot
 select fragment

---
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 253fbdfd7..3617b23e6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -69,6 +69,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
 
     @SuppressLint("NotifyDataSetChanged")
     private suspend fun init() {
+        ensureEuiccChannelManager()
         showProgressBar(-1)
         val slots = euiccChannelManager.flowEuiccPorts().map { (slotId, portId) ->
             euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->

From c4b513fc0affa3ef0a3a1d3ad6adafa009590608 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Nov 2024 22:00:03 -0500
Subject: [PATCH 230/458] ui: Save selected slot as state in
 DownloadWizardActivity

---
 .../openeuicc/ui/EuiccManagementFragment.kt   |  5 ++-
 .../ui/wizard/DownloadWizardActivity.kt       | 17 ++++++++--
 .../DownloadWizardSlotSelectFragment.kt       | 32 +++++++++++++------
 3 files changed, 41 insertions(+), 13 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index c3ecbf38b..6ab6935e0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -109,7 +109,10 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         fab.setOnClickListener {
             lifecycleScope.launch {
                 if (preferenceRepository.experimentalDownloadWizardFlow.first()) {
-                    startActivity(Intent(requireContext(), DownloadWizardActivity::class.java))
+                    Intent(requireContext(), DownloadWizardActivity::class.java).apply {
+                        putExtra("selectedLogicalSlot", logicalSlotId)
+                        startActivity(this)
+                    }
                 } else {
                     ProfileDownloadFragment.newInstance(slotId, portId)
                         .show(childFragmentManager, ProfileDownloadFragment.TAG)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 2958a7f81..408c55d23 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -15,6 +15,12 @@ import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import im.angry.openeuicc.util.*
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
+    data class DownloadWizardState(
+        var selectedLogicalSlot: Int
+    )
+
+    private lateinit var state: DownloadWizardState
+
     private lateinit var progressBar: ProgressBar
     private lateinit var nextButton: Button
     private lateinit var prevButton: Button
@@ -31,6 +37,10 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             }
         })
 
+        state = DownloadWizardState(
+            intent.getIntExtra("selectedLogicalSlot", 0)
+        )
+
         progressBar = requireViewById(R.id.progress)
         nextButton = requireViewById(R.id.download_wizard_next)
         prevButton = requireViewById(R.id.download_wizard_back)
@@ -89,10 +99,13 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     }
 
     abstract class DownloadWizardStepFragment : Fragment(), OpenEuiccContextMarker {
+        protected val state: DownloadWizardState
+            get() = (requireActivity() as DownloadWizardActivity).state
+
         abstract val hasNext: Boolean
         abstract val hasPrev: Boolean
-        abstract fun createNextFragment(): DownloadWizardStepFragment
-        abstract fun createPrevFragment(): DownloadWizardStepFragment
+        abstract fun createNextFragment(): DownloadWizardStepFragment?
+        abstract fun createPrevFragment(): DownloadWizardStepFragment?
 
         protected fun hideProgressBar() {
             (requireActivity() as DownloadWizardActivity).progressBar.visibility = View.GONE
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 3617b23e6..6720242d9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -34,17 +34,15 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
     private val adapter = SlotInfoAdapter()
 
     override val hasNext: Boolean
-        get() = loaded
+        get() = loaded && adapter.slots.isNotEmpty()
     override val hasPrev: Boolean
-        get() = false
+        get() = true
 
-    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment {
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
         TODO("Not yet implemented")
     }
 
-    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment {
-        TODO("Not yet implemented")
-    }
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
     override fun onCreateView(
         inflater: LayoutInflater,
@@ -84,13 +82,25 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             }
         }.toList()
         adapter.slots = slots
+
+        // Ensure we always have a selected slot by default
+        val selectedIdx = slots.indexOfFirst { it.logicalSlotId == state.selectedLogicalSlot }
+        adapter.currentSelectedIdx = if (selectedIdx > 0) {
+            selectedIdx
+        } else {
+            if (slots.isNotEmpty()) {
+                state.selectedLogicalSlot = slots[0].logicalSlotId
+            }
+            0
+        }
+
         adapter.notifyDataSetChanged()
         hideProgressBar()
         loaded = true
         refreshButtons()
     }
 
-    private class SlotItemHolder(val adapter: SlotInfoAdapter, val root: View) : ViewHolder(root) {
+    private inner class SlotItemHolder(val root: View) : ViewHolder(root) {
         private val title = root.requireViewById<TextView>(R.id.slot_item_title)
         private val type = root.requireViewById<TextView>(R.id.slot_item_type)
         private val eID = root.requireViewById<TextView>(R.id.slot_item_eid)
@@ -112,6 +122,8 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             adapter.currentSelectedIdx = curIdx
             adapter.notifyItemChanged(lastIdx)
             adapter.notifyItemChanged(curIdx)
+            // Selected index isn't logical slot ID directly, needs a conversion
+            state.selectedLogicalSlot = adapter.slots[adapter.currentSelectedIdx].logicalSlotId
         }
 
         fun bind(item: SlotInfo, idx: Int) {
@@ -135,13 +147,13 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         }
     }
 
-    private class SlotInfoAdapter : RecyclerView.Adapter<SlotItemHolder>() {
+    private inner class SlotInfoAdapter : RecyclerView.Adapter<SlotItemHolder>() {
         var slots: List<SlotInfo> = listOf()
-        var currentSelectedIdx = 0
+        var currentSelectedIdx = -1
 
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SlotItemHolder {
             val root = LayoutInflater.from(parent.context).inflate(R.layout.download_slot_item, parent, false)
-            return SlotItemHolder(this, root)
+            return SlotItemHolder(root)
         }
 
         override fun getItemCount(): Int = slots.size

From b9d5c1c5bbd02bbfa35eb5d7d914c57f35746760 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 18 Nov 2024 23:39:09 +0100
Subject: [PATCH 231/458] chore: simplify dot-idea gitignore (#68)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/68
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .gitignore       | 7 -------
 .idea/.gitignore | 9 ++++++++-
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.gitignore b/.gitignore
index 2b15a47ea..6cc80a056 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,13 +2,6 @@
 .gradle
 /local.properties
 /keystore.properties
-/.idea/caches
-/.idea/libraries
-/.idea/modules.xml
-/.idea/workspace.xml
-/.idea/navEditor.xml
-/.idea/assetWizardSettings.xml
-/.idea/deploymentTargetDropDown.xml
 .DS_Store
 /build
 /captures
diff --git a/.idea/.gitignore b/.idea/.gitignore
index 26d33521a..c9924abc4 100644
--- a/.idea/.gitignore
+++ b/.idea/.gitignore
@@ -1,3 +1,10 @@
 # Default ignored files
-/shelf/
+/shelf
+/caches
+/libraries
+/modules.xml
 /workspace.xml
+/navEditor.xml
+/assetWizardSettings.xml
+/deploymentTargetDropDown.xml
+/runConfigurations.xml
\ No newline at end of file

From 98e16ee5aad9a051383e1f894600b381f92f4570 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 19:57:01 -0500
Subject: [PATCH 232/458] ui: Hook up prev / next buttons for new download
 wizard

---
 .../ui/wizard/DownloadWizardActivity.kt       | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 408c55d23..f3cb11421 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -45,6 +45,28 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         nextButton = requireViewById(R.id.download_wizard_next)
         prevButton = requireViewById(R.id.download_wizard_back)
 
+        nextButton.setOnClickListener {
+            if (currentFragment?.hasNext == true) {
+                val nextFrag = currentFragment?.createNextFragment()
+                if (nextFrag == null) {
+                    finish()
+                } else {
+                    showFragment(nextFrag)
+                }
+            }
+        }
+
+        prevButton.setOnClickListener {
+            if (currentFragment?.hasPrev == true) {
+                val prevFrag = currentFragment?.createPrevFragment()
+                if (prevFrag == null) {
+                    finish()
+                } else {
+                    showFragment(prevFrag)
+                }
+            }
+        }
+
         val navigation = requireViewById<View>(R.id.download_wizard_navigation)
         val origHeight = navigation.layoutParams.height
 

From aaca9e807a320f943331104c8bf811bfcac031f8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 20:01:43 -0500
Subject: [PATCH 233/458] ui: Show free space when selecting slot

---
 .../wizard/DownloadWizardSlotSelectFragment.kt   |  4 ++++
 .../src/main/res/layout/download_slot_item.xml   | 16 +++++++++++++++-
 app-common/src/main/res/values/strings.xml       |  1 +
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 6720242d9..059f856bf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -26,6 +26,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         val hasMultiplePorts: Boolean,
         val portId: Int,
         val eID: String,
+        val freeSpace: Int,
         val enabledProfileName: String?
     )
 
@@ -77,6 +78,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                     channel.port.card.ports.size > 1,
                     channel.portId,
                     channel.lpa.eID,
+                    channel.lpa.euiccInfo2?.freeNvram ?: 0,
                     channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
                 )
             }
@@ -105,6 +107,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         private val type = root.requireViewById<TextView>(R.id.slot_item_type)
         private val eID = root.requireViewById<TextView>(R.id.slot_item_eid)
         private val activeProfile = root.requireViewById<TextView>(R.id.slot_item_active_profile)
+        private val freeSpace = root.requireViewById<TextView>(R.id.slot_item_free_space)
         private val checkBox = root.requireViewById<CheckBox>(R.id.slot_checkbox)
 
         private var curIdx = -1
@@ -143,6 +146,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             title.text = root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
             eID.text = item.eID
             activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
+            freeSpace.text = formatFreeSpace(item.freeSpace)
             checkBox.isChecked = adapter.currentSelectedIdx == idx
         }
     }
diff --git a/app-common/src/main/res/layout/download_slot_item.xml b/app-common/src/main/res/layout/download_slot_item.xml
index fa06b4c11..d0ca1764a 100644
--- a/app-common/src/main/res/layout/download_slot_item.xml
+++ b/app-common/src/main/res/layout/download_slot_item.xml
@@ -61,6 +61,20 @@
         android:layout_height="wrap_content"
         android:textSize="14sp" />
 
+    <TextView
+        android:id="@+id/slot_item_free_space_label"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:minWidth="100dp"
+        android:text="@string/download_wizard_slot_free_space"
+        android:textSize="14sp" />
+
+    <TextView
+        android:id="@+id/slot_item_free_space"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:textSize="14sp" />
+
     <androidx.constraintlayout.helper.widget.Flow
         android:id="@+id/flow1"
         android:layout_width="0dp"
@@ -68,7 +82,7 @@
         android:layout_marginStart="10sp"
         android:layout_marginTop="20sp"
         android:layout_marginEnd="10sp"
-        app:constraint_referenced_ids="slot_item_type_label,slot_item_type,slot_item_eid_label,slot_item_eid,slot_item_active_profile_label,slot_item_active_profile"
+        app:constraint_referenced_ids="slot_item_type_label,slot_item_type,slot_item_eid_label,slot_item_eid,slot_item_active_profile_label,slot_item_active_profile,slot_item_free_space_label,slot_item_free_space"
         app:flow_wrapMode="aligned"
         app:flow_horizontalAlign="start"
         app:flow_horizontalBias="1"
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 609fe7340..d54006e9b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -69,6 +69,7 @@
     <string name="download_wizard_slot_type_internal_port">Internal, port %d</string>
     <string name="download_wizard_slot_eid">eID:</string>
     <string name="download_wizard_slot_active_profile">Active Profile:</string>
+    <string name="download_wizard_slot_free_space">Free Space:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 0c519af376b54207f3163b879089820a3cb97fa9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 20:19:28 -0500
Subject: [PATCH 234/458] ui: Update slot select prompt text

---
 .../src/main/res/layout/fragment_download_slot_select.xml  | 7 ++++++-
 app-common/src/main/res/values/strings.xml                 | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/res/layout/fragment_download_slot_select.xml b/app-common/src/main/res/layout/fragment_download_slot_select.xml
index 6bd2e5db1..3dfe6fdf3 100644
--- a/app-common/src/main/res/layout/fragment_download_slot_select.xml
+++ b/app-common/src/main/res/layout/fragment_download_slot_select.xml
@@ -9,10 +9,15 @@
         android:text="@string/download_wizard_slot_select"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
+        android:gravity="center_horizontal"
         android:textSize="20sp"
-        android:layout_margin="20sp"
+        android:layout_marginTop="20sp"
+        android:layout_marginBottom="20sp"
+        android:layout_marginStart="60sp"
+        android:layout_marginEnd="60sp"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constrainedWidth="true"
         app:layout_constraintTop_toTopOf="parent" />
 
     <androidx.recyclerview.widget.RecyclerView
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d54006e9b..5a88fe8af 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -61,7 +61,7 @@
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>
     <string name="download_wizard_next">Next</string>
-    <string name="download_wizard_slot_select">Confirm the eSIM slot:</string>
+    <string name="download_wizard_slot_select">Select or confirm the eSIM you would like to download to:</string>
     <string name="download_wizard_slot_title">Logical slot %d</string>
     <string name="download_wizard_slot_type">Type:</string>
     <string name="download_wizard_slot_type_removable">Removable</string>

From 92b7b46598b0881f7d973d0077164f8b9f5827fc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 20:54:42 -0500
Subject: [PATCH 235/458] ui: Lay out the method select fragment for wizard

---
 .../DownloadWizardMethodSelectFragment.kt     | 93 +++++++++++++++++++
 .../DownloadWizardSlotSelectFragment.kt       |  5 +-
 app-common/src/main/res/drawable/ic_edit.xml  |  5 +
 .../main/res/layout/download_method_item.xml  | 44 +++++++++
 .../fragment_download_method_select.xml       | 33 +++++++
 app-common/src/main/res/values/strings.xml    |  4 +
 6 files changed, 181 insertions(+), 3 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
 create mode 100644 app-common/src/main/res/drawable/ic_edit.xml
 create mode 100644 app-common/src/main/res/layout/download_method_item.xml
 create mode 100644 app-common/src/main/res/layout/fragment_download_method_select.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
new file mode 100644
index 000000000..51cf67913
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -0,0 +1,93 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.recyclerview.widget.DividerItemDecoration
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import androidx.recyclerview.widget.RecyclerView.ViewHolder
+import im.angry.openeuicc.common.R
+
+class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    data class DownloadMethod(
+        val iconRes: Int,
+        val titleRes: Int,
+        val onClick: () -> Unit
+    )
+
+    val downloadMethods = arrayOf(
+        DownloadMethod(R.drawable.ic_scan_black, R.string.download_wizard_method_qr_code) {
+
+        },
+        DownloadMethod(R.drawable.ic_gallery_black, R.string.download_wizard_method_gallery) {
+
+        },
+        DownloadMethod(R.drawable.ic_edit, R.string.download_wizard_method_manual) {
+
+        }
+    )
+
+    override val hasNext: Boolean
+        get() = false
+    override val hasPrev: Boolean
+        get() = true
+
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
+        TODO("Not yet implemented")
+    }
+
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
+        DownloadWizardSlotSelectFragment()
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_download_method_select, container, false)
+        val recyclerView = view.requireViewById<RecyclerView>(R.id.download_method_list)
+        recyclerView.adapter = DownloadMethodAdapter()
+        recyclerView.layoutManager =
+            LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
+        recyclerView.addItemDecoration(
+            DividerItemDecoration(
+                requireContext(),
+                LinearLayoutManager.VERTICAL
+            )
+        )
+        return view
+    }
+
+    private class DownloadMethodViewHolder(private val root: View) : ViewHolder(root) {
+        private val icon = root.requireViewById<ImageView>(R.id.download_method_icon)
+        private val title = root.requireViewById<TextView>(R.id.download_method_title)
+
+        fun bind(item: DownloadMethod) {
+            icon.setImageResource(item.iconRes)
+            title.setText(item.titleRes)
+            root.setOnClickListener { item.onClick() }
+        }
+    }
+
+    private inner class DownloadMethodAdapter : RecyclerView.Adapter<DownloadMethodViewHolder>() {
+        override fun onCreateViewHolder(
+            parent: ViewGroup,
+            viewType: Int
+        ): DownloadMethodViewHolder {
+            val view = LayoutInflater.from(parent.context)
+                .inflate(R.layout.download_method_item, parent, false)
+            return DownloadMethodViewHolder(view)
+        }
+
+        override fun getItemCount(): Int = downloadMethods.size
+
+        override fun onBindViewHolder(holder: DownloadMethodViewHolder, position: Int) {
+            holder.bind(downloadMethods[position])
+        }
+
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 059f856bf..34582277a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -39,9 +39,8 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
     override val hasPrev: Boolean
         get() = true
 
-    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
-        TODO("Not yet implemented")
-    }
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
+        DownloadWizardMethodSelectFragment()
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
diff --git a/app-common/src/main/res/drawable/ic_edit.xml b/app-common/src/main/res/drawable/ic_edit.xml
new file mode 100644
index 000000000..3c53db7ec
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_edit.xml
@@ -0,0 +1,5 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M3,17.25V21h3.75L17.81,9.94l-3.75,-3.75L3,17.25zM20.71,7.04c0.39,-0.39 0.39,-1.02 0,-1.41l-2.34,-2.34c-0.39,-0.39 -1.02,-0.39 -1.41,0l-1.83,1.83 3.75,3.75 1.83,-1.83z"/>
+    
+</vector>
diff --git a/app-common/src/main/res/layout/download_method_item.xml b/app-common/src/main/res/layout/download_method_item.xml
new file mode 100644
index 000000000..5b2c2a8a0
--- /dev/null
+++ b/app-common/src/main/res/layout/download_method_item.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:padding="20dp"
+    android:background="?attr/selectableItemBackground">
+
+    <ImageView
+        android:id="@+id/download_method_icon"
+        android:layout_width="30dp"
+        android:layout_height="30dp"
+        app:tint="?attr/colorAccent"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toStartOf="parent" />
+
+    <TextView
+        android:id="@+id/download_method_title"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="20dp"
+        android:layout_marginEnd="20dp"
+        android:textSize="15sp"
+        android:maxLines="1"
+        android:ellipsize="marquee"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintStart_toEndOf="@id/download_method_icon"
+        app:layout_constraintEnd_toStartOf="@id/download_method_chevron"
+        app:layout_constraintHorizontal_bias="0.0"
+        app:layout_constrainedWidth="true" />
+
+    <ImageView
+        android:id="@+id/download_method_chevron"
+        android:src="@drawable/ic_chevron_right"
+        android:layout_width="30dp"
+        android:layout_height="30dp"
+        app:tint="?attr/colorAccent"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/fragment_download_method_select.xml b/app-common/src/main/res/layout/fragment_download_method_select.xml
new file mode 100644
index 000000000..a57e1862a
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_download_method_select.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/download_method_select_title"
+        android:text="@string/download_wizard_method_select"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:gravity="center_horizontal"
+        android:textSize="20sp"
+        android:layout_marginTop="20sp"
+        android:layout_marginBottom="20sp"
+        android:layout_marginStart="60sp"
+        android:layout_marginEnd="60sp"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constrainedWidth="true"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/download_method_list"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        app:layout_constraintTop_toBottomOf="@id/download_method_select_title"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constrainedHeight="true" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 5a88fe8af..bc481422b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -70,6 +70,10 @@
     <string name="download_wizard_slot_eid">eID:</string>
     <string name="download_wizard_slot_active_profile">Active Profile:</string>
     <string name="download_wizard_slot_free_space">Free Space:</string>
+    <string name="download_wizard_method_select">How would you like to download the eSIM profile?</string>
+    <string name="download_wizard_method_qr_code">Scan a QR code with camera</string>
+    <string name="download_wizard_method_gallery">Load a QR code from gallery</string>
+    <string name="download_wizard_method_manual">Enter manually</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From dbdadd33b3e7bc1bb39140eee8b5895989ab035b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 21:02:12 -0500
Subject: [PATCH 236/458] ui: Add slide-in and slide-out animation for wizard
 steps

---
 .../openeuicc/ui/wizard/DownloadWizardActivity.kt   | 13 +++++++++----
 app-common/src/main/res/anim/slide_in_left.xml      |  6 ++++++
 app-common/src/main/res/anim/slide_in_right.xml     |  6 ++++++
 app-common/src/main/res/anim/slide_out_left.xml     |  6 ++++++
 app-common/src/main/res/anim/slide_out_right.xml    |  6 ++++++
 5 files changed, 33 insertions(+), 4 deletions(-)
 create mode 100644 app-common/src/main/res/anim/slide_in_left.xml
 create mode 100644 app-common/src/main/res/anim/slide_in_right.xml
 create mode 100644 app-common/src/main/res/anim/slide_out_left.xml
 create mode 100644 app-common/src/main/res/anim/slide_out_right.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index f3cb11421..09dd38c0f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -51,7 +51,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
                 if (nextFrag == null) {
                     finish()
                 } else {
-                    showFragment(nextFrag)
+                    showFragment(nextFrag, R.anim.slide_in_right, R.anim.slide_out_left)
                 }
             }
         }
@@ -62,7 +62,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
                 if (prevFrag == null) {
                     finish()
                 } else {
-                    showFragment(prevFrag)
+                    showFragment(prevFrag, R.anim.slide_in_left, R.anim.slide_out_right)
                 }
             }
         }
@@ -98,9 +98,14 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         showFragment(DownloadWizardSlotSelectFragment())
     }
 
-    private fun showFragment(nextFrag: DownloadWizardStepFragment) {
+    private fun showFragment(
+        nextFrag: DownloadWizardStepFragment,
+        enterAnim: Int = 0,
+        exitAnim: Int = 0
+    ) {
         currentFragment = nextFrag
-        supportFragmentManager.beginTransaction().replace(R.id.step_fragment_container, nextFrag)
+        supportFragmentManager.beginTransaction().setCustomAnimations(enterAnim, exitAnim)
+            .replace(R.id.step_fragment_container, nextFrag)
             .commit()
         refreshButtons()
     }
diff --git a/app-common/src/main/res/anim/slide_in_left.xml b/app-common/src/main/res/anim/slide_in_left.xml
new file mode 100644
index 000000000..9078d1fb7
--- /dev/null
+++ b/app-common/src/main/res/anim/slide_in_left.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<translate xmlns:android="http://schemas.android.com/apk/res/android"
+    android:duration="@android:integer/config_shortAnimTime"
+    android:interpolator="@android:anim/decelerate_interpolator"
+    android:fromXDelta="-100%"
+    android:toXDelta="0%" />
diff --git a/app-common/src/main/res/anim/slide_in_right.xml b/app-common/src/main/res/anim/slide_in_right.xml
new file mode 100644
index 000000000..42aa3f529
--- /dev/null
+++ b/app-common/src/main/res/anim/slide_in_right.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<translate xmlns:android="http://schemas.android.com/apk/res/android"
+    android:duration="@android:integer/config_shortAnimTime"
+    android:interpolator="@android:anim/decelerate_interpolator"
+    android:fromXDelta="100%"
+    android:toXDelta="0%" />
diff --git a/app-common/src/main/res/anim/slide_out_left.xml b/app-common/src/main/res/anim/slide_out_left.xml
new file mode 100644
index 000000000..1a806a9ba
--- /dev/null
+++ b/app-common/src/main/res/anim/slide_out_left.xml
@@ -0,0 +1,6 @@
+<!-- res/anim/slide_out.xml -->
+<translate xmlns:android="http://schemas.android.com/apk/res/android"
+    android:duration="@android:integer/config_shortAnimTime"
+    android:interpolator="@android:anim/decelerate_interpolator"
+    android:fromXDelta="0%"
+    android:toXDelta="-100%" />
diff --git a/app-common/src/main/res/anim/slide_out_right.xml b/app-common/src/main/res/anim/slide_out_right.xml
new file mode 100644
index 000000000..f209f384d
--- /dev/null
+++ b/app-common/src/main/res/anim/slide_out_right.xml
@@ -0,0 +1,6 @@
+<!-- res/anim/slide_out.xml -->
+<translate xmlns:android="http://schemas.android.com/apk/res/android"
+    android:duration="@android:integer/config_shortAnimTime"
+    android:interpolator="@android:anim/decelerate_interpolator"
+    android:fromXDelta="0%"
+    android:toXDelta="100%" />

From 723ec70730c9102066410407281b66856ef11f45 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 18 Nov 2024 21:06:46 -0500
Subject: [PATCH 237/458] ui: Use prev button action for back pressed

---
 .../ui/wizard/DownloadWizardActivity.kt       | 43 +++++++++++--------
 1 file changed, 26 insertions(+), 17 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 09dd38c0f..8aab4e311 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -33,7 +33,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         setContentView(R.layout.activity_download_wizard)
         onBackPressedDispatcher.addCallback(object : OnBackPressedCallback(true) {
             override fun handleOnBackPressed() {
-                // TODO: Actually implement this
+                // Make back == prev
+                onPrevPressed()
             }
         })
 
@@ -46,25 +47,11 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         prevButton = requireViewById(R.id.download_wizard_back)
 
         nextButton.setOnClickListener {
-            if (currentFragment?.hasNext == true) {
-                val nextFrag = currentFragment?.createNextFragment()
-                if (nextFrag == null) {
-                    finish()
-                } else {
-                    showFragment(nextFrag, R.anim.slide_in_right, R.anim.slide_out_left)
-                }
-            }
+            onNextPressed()
         }
 
         prevButton.setOnClickListener {
-            if (currentFragment?.hasPrev == true) {
-                val prevFrag = currentFragment?.createPrevFragment()
-                if (prevFrag == null) {
-                    finish()
-                } else {
-                    showFragment(prevFrag, R.anim.slide_in_left, R.anim.slide_out_right)
-                }
-            }
+            onPrevPressed()
         }
 
         val navigation = requireViewById<View>(R.id.download_wizard_navigation)
@@ -93,6 +80,28 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         }
     }
 
+    private fun onPrevPressed() {
+        if (currentFragment?.hasPrev == true) {
+            val prevFrag = currentFragment?.createPrevFragment()
+            if (prevFrag == null) {
+                finish()
+            } else {
+                showFragment(prevFrag, R.anim.slide_in_left, R.anim.slide_out_right)
+            }
+        }
+    }
+
+    private fun onNextPressed() {
+        if (currentFragment?.hasNext == true) {
+            val nextFrag = currentFragment?.createNextFragment()
+            if (nextFrag == null) {
+                finish()
+            } else {
+                showFragment(nextFrag, R.anim.slide_in_right, R.anim.slide_out_left)
+            }
+        }
+    }
+
     override fun onInit() {
         progressBar.visibility = View.GONE
         showFragment(DownloadWizardSlotSelectFragment())

From 9cf95ad47ce540383a7f5040714f4f0f19958e76 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 19 Nov 2024 18:38:59 -0500
Subject: [PATCH 238/458] ui: Add a input details fragment for download wizard

---
 .../ui/wizard/DownloadWizardActivity.kt       |  9 ++
 .../wizard/DownloadWizardDetailsFragment.kt   | 30 ++++++
 .../DownloadWizardMethodSelectFragment.kt     |  2 +-
 .../res/layout/fragment_download_details.xml  | 97 +++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  1 +
 5 files changed, 138 insertions(+), 1 deletion(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
 create mode 100644 app-common/src/main/res/layout/fragment_download_details.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 8aab4e311..9387c778c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -143,6 +143,15 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         abstract fun createNextFragment(): DownloadWizardStepFragment?
         abstract fun createPrevFragment(): DownloadWizardStepFragment?
 
+        protected fun gotoNextFragment(next: DownloadWizardStepFragment? = null) {
+            val realNext = next ?: createNextFragment()
+            (requireActivity() as DownloadWizardActivity).showFragment(
+                realNext!!,
+                R.anim.slide_in_right,
+                R.anim.slide_out_left
+            )
+        }
+
         protected fun hideProgressBar() {
             (requireActivity() as DownloadWizardActivity).progressBar.visibility = View.GONE
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
new file mode 100644
index 000000000..fda9d317f
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -0,0 +1,30 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import im.angry.openeuicc.common.R
+
+class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    override val hasNext: Boolean
+        get() = false
+    override val hasPrev: Boolean
+        get() = true
+
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
+        TODO("Not yet implemented")
+    }
+
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
+        DownloadWizardMethodSelectFragment()
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_download_details, container, false)
+        return view
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 51cf67913..1b813a40a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -27,7 +27,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
         },
         DownloadMethod(R.drawable.ic_edit, R.string.download_wizard_method_manual) {
-
+            gotoNextFragment(DownloadWizardDetailsFragment())
         }
     )
 
diff --git a/app-common/src/main/res/layout/fragment_download_details.xml b/app-common/src/main/res/layout/fragment_download_details.xml
new file mode 100644
index 000000000..0820c2748
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_download_details.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:fillViewport="true">
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <TextView
+            android:id="@+id/download_wizard_details_title"
+            android:text="@string/download_wizard_details"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:gravity="center_horizontal"
+            android:textSize="20sp"
+            android:layout_marginTop="20sp"
+            android:layout_marginBottom="20sp"
+            android:layout_marginStart="60sp"
+            android:layout_marginEnd="60sp"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constrainedWidth="true"
+            app:layout_constraintTop_toTopOf="parent" />
+
+        <com.google.android.material.textfield.TextInputLayout
+            android:id="@+id/profile_download_server"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:hint="@string/profile_download_server">
+
+            <com.google.android.material.textfield.TextInputEditText
+                android:layout_width="match_parent"
+                android:layout_height="match_parent" />
+
+        </com.google.android.material.textfield.TextInputLayout>
+
+        <com.google.android.material.textfield.TextInputLayout
+            android:id="@+id/profile_download_code"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:hint="@string/profile_download_code">
+
+            <com.google.android.material.textfield.TextInputEditText
+                android:layout_width="match_parent"
+                android:layout_height="match_parent"
+                android:inputType="textPassword" />
+
+        </com.google.android.material.textfield.TextInputLayout>
+
+        <com.google.android.material.textfield.TextInputLayout
+            android:id="@+id/profile_download_confirmation_code"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:hint="@string/profile_download_confirmation_code">
+
+            <com.google.android.material.textfield.TextInputEditText
+                android:layout_width="match_parent"
+                android:layout_height="match_parent"
+                android:inputType="textPassword" />
+
+        </com.google.android.material.textfield.TextInputLayout>
+
+        <com.google.android.material.textfield.TextInputLayout
+            android:id="@+id/profile_download_imei"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="15dp"
+            android:layout_marginBottom="6dp"
+            android:hint="@string/profile_download_imei"
+            app:passwordToggleEnabled="true">
+
+            <com.google.android.material.textfield.TextInputEditText
+                android:layout_width="match_parent"
+                android:layout_height="match_parent"
+                android:inputType="textPassword" />
+
+        </com.google.android.material.textfield.TextInputLayout>
+
+        <androidx.constraintlayout.helper.widget.Flow
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:layout_marginHorizontal="20dp"
+            app:constraint_referenced_ids="profile_download_server,profile_download_code,profile_download_confirmation_code,profile_download_imei"
+            app:flow_verticalGap="16dp"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toBottomOf="@id/download_wizard_details_title"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constrainedWidth="true" />
+
+    </androidx.constraintlayout.widget.ConstraintLayout>
+
+</ScrollView>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bc481422b..3b075bba3 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -74,6 +74,7 @@
     <string name="download_wizard_method_qr_code">Scan a QR code with camera</string>
     <string name="download_wizard_method_gallery">Load a QR code from gallery</string>
     <string name="download_wizard_method_manual">Enter manually</string>
+    <string name="download_wizard_details">Input or confirm details for downloading your eSIM:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 8c73615fbb49638bc351e62020e0e0b68c03ff11 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 19 Nov 2024 20:11:37 -0500
Subject: [PATCH 239/458] ui: wizard: Implement input by scanning / gallery

---
 .../ui/wizard/DownloadWizardActivity.kt       | 12 +++-
 .../wizard/DownloadWizardDetailsFragment.kt   | 33 ++++++++++-
 .../DownloadWizardMethodSelectFragment.kt     | 58 +++++++++++++++++--
 .../DownloadWizardSlotSelectFragment.kt       | 13 ++++-
 4 files changed, 107 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 9387c778c..a0048627c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -16,7 +16,11 @@ import im.angry.openeuicc.util.*
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
     data class DownloadWizardState(
-        var selectedLogicalSlot: Int
+        var selectedLogicalSlot: Int,
+        var smdp: String,
+        var matchingId: String,
+        var confirmationCode: String,
+        var imei: String,
     )
 
     private lateinit var state: DownloadWizardState
@@ -39,7 +43,11 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         })
 
         state = DownloadWizardState(
-            intent.getIntExtra("selectedLogicalSlot", 0)
+            intent.getIntExtra("selectedLogicalSlot", 0),
+            "",
+            "",
+            "",
+            ""
         )
 
         progressBar = requireViewById(R.id.progress)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index fda9d317f..c4a484f1d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -1,17 +1,27 @@
 package im.angry.openeuicc.ui.wizard
 
 import android.os.Bundle
+import android.util.Patterns
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
+import androidx.core.widget.addTextChangedListener
+import com.google.android.material.textfield.TextInputLayout
 import im.angry.openeuicc.common.R
 
 class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    private var inputComplete = false
+
     override val hasNext: Boolean
-        get() = false
+        get() = inputComplete
     override val hasPrev: Boolean
         get() = true
 
+    private lateinit var smdp: TextInputLayout
+    private lateinit var matchingId: TextInputLayout
+    private lateinit var confirmationCode: TextInputLayout
+    private lateinit var imei: TextInputLayout
+
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
         TODO("Not yet implemented")
     }
@@ -25,6 +35,27 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         savedInstanceState: Bundle?
     ): View? {
         val view = inflater.inflate(R.layout.fragment_download_details, container, false)
+        smdp = view.requireViewById(R.id.profile_download_server)
+        matchingId = view.requireViewById(R.id.profile_download_code)
+        confirmationCode = view.requireViewById(R.id.profile_download_confirmation_code)
+        imei = view.requireViewById(R.id.profile_download_imei)
+        smdp.editText!!.addTextChangedListener {
+            updateInputCompleteness()
+        }
         return view
     }
+
+    override fun onStart() {
+        super.onStart()
+        smdp.editText!!.setText(state.smdp)
+        matchingId.editText!!.setText(state.matchingId)
+        confirmationCode.editText!!.setText(state.confirmationCode)
+        imei.editText!!.setText(state.imei)
+        updateInputCompleteness()
+    }
+
+    private fun updateInputCompleteness() {
+        inputComplete = Patterns.DOMAIN_NAME.matcher(smdp.editText!!.text).matches()
+        refreshButtons()
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 1b813a40a..4d8a38fb2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -1,16 +1,25 @@
 package im.angry.openeuicc.ui.wizard
 
+import android.graphics.BitmapFactory
 import android.os.Bundle
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.ImageView
 import android.widget.TextView
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import androidx.recyclerview.widget.RecyclerView.ViewHolder
+import com.journeyapps.barcodescanner.ScanContract
+import com.journeyapps.barcodescanner.ScanOptions
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
 
 class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
     data class DownloadMethod(
@@ -19,12 +28,44 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         val onClick: () -> Unit
     )
 
+    // TODO: Maybe we should find a better barcode scanner (or an external one?)
+    private val barcodeScannerLauncher = registerForActivityResult(ScanContract()) { result ->
+        result.contents?.let { content ->
+            processLpaString(content)
+        }
+    }
+
+    private val gallerySelectorLauncher =
+        registerForActivityResult(ActivityResultContracts.GetContent()) { result ->
+            if (result == null) return@registerForActivityResult
+
+            lifecycleScope.launch(Dispatchers.IO) {
+                runCatching {
+                    requireContext().contentResolver.openInputStream(result)?.let { input ->
+                        val bmp = BitmapFactory.decodeStream(input)
+                        input.close()
+
+                        decodeQrFromBitmap(bmp)?.let {
+                            withContext(Dispatchers.Main) {
+                                processLpaString(it)
+                            }
+                        }
+
+                        bmp.recycle()
+                    }
+                }
+            }
+        }
+
     val downloadMethods = arrayOf(
         DownloadMethod(R.drawable.ic_scan_black, R.string.download_wizard_method_qr_code) {
-
+            barcodeScannerLauncher.launch(ScanOptions().apply {
+                setDesiredBarcodeFormats(ScanOptions.QR_CODE)
+                setOrientationLocked(false)
+            })
         },
         DownloadMethod(R.drawable.ic_gallery_black, R.string.download_wizard_method_gallery) {
-
+            gallerySelectorLauncher.launch("image/*")
         },
         DownloadMethod(R.drawable.ic_edit, R.string.download_wizard_method_manual) {
             gotoNextFragment(DownloadWizardDetailsFragment())
@@ -36,9 +77,8 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
     override val hasPrev: Boolean
         get() = true
 
-    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
-        TODO("Not yet implemented")
-    }
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? =
+        null
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
         DownloadWizardSlotSelectFragment()
@@ -62,6 +102,14 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         return view
     }
 
+    private fun processLpaString(s: String) {
+        val components = s.split("$")
+        if (components.size < 3 || components[0] != "LPA:1") return
+        state.smdp = components[1]
+        state.matchingId = components[2]
+        gotoNextFragment(DownloadWizardDetailsFragment())
+    }
+
     private class DownloadMethodViewHolder(private val root: View) : ViewHolder(root) {
         private val icon = root.requireViewById<ImageView>(R.id.download_method_icon)
         private val title = root.requireViewById<TextView>(R.id.download_method_title)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 34582277a..22172706f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -27,6 +27,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         val portId: Int,
         val eID: String,
         val freeSpace: Int,
+        val imei: String,
         val enabledProfileName: String?
     )
 
@@ -65,7 +66,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         }
     }
 
-    @SuppressLint("NotifyDataSetChanged")
+    @SuppressLint("NotifyDataSetChanged", "MissingPermission")
     private suspend fun init() {
         ensureEuiccChannelManager()
         showProgressBar(-1)
@@ -78,6 +79,11 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                     channel.portId,
                     channel.lpa.eID,
                     channel.lpa.euiccInfo2?.freeNvram ?: 0,
+                    try {
+                        telephonyManager.getImei(channel.logicalSlotId) ?: ""
+                    } catch (e: Exception) {
+                        ""
+                    },
                     channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
                 )
             }
@@ -95,6 +101,10 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             0
         }
 
+        if (slots.isNotEmpty()) {
+            state.imei = slots[adapter.currentSelectedIdx].imei
+        }
+
         adapter.notifyDataSetChanged()
         hideProgressBar()
         loaded = true
@@ -126,6 +136,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             adapter.notifyItemChanged(curIdx)
             // Selected index isn't logical slot ID directly, needs a conversion
             state.selectedLogicalSlot = adapter.slots[adapter.currentSelectedIdx].logicalSlotId
+            state.imei = adapter.slots[adapter.currentSelectedIdx].imei
         }
 
         fun bind(item: SlotInfo, idx: Int) {

From 81f34f9b1c310109d02b2608d8741134c5372164 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 19 Nov 2024 20:14:30 -0500
Subject: [PATCH 240/458] ui: wizard: Sort by slot ID

---
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 22172706f..c9a9e0f7a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -87,7 +87,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                     channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
                 )
             }
-        }.toList()
+        }.toList().sortedBy { it.logicalSlotId }
         adapter.slots = slots
 
         // Ensure we always have a selected slot by default

From e7a04822811806cc473a0d12636dd0c45226964c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 19 Nov 2024 20:40:53 -0500
Subject: [PATCH 241/458] ui: wizard: Save current state to bundle

---
 .../ui/wizard/DownloadWizardActivity.kt       | 39 ++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index a0048627c..029725cd8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -16,6 +16,7 @@ import im.angry.openeuicc.util.*
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
     data class DownloadWizardState(
+        var currentStepFragmentClassName: String?,
         var selectedLogicalSlot: Int,
         var smdp: String,
         var matchingId: String,
@@ -30,6 +31,12 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     private lateinit var prevButton: Button
 
     private var currentFragment: DownloadWizardStepFragment? = null
+        set(value) {
+            if (this::state.isInitialized) {
+                state.currentStepFragmentClassName = value?.javaClass?.name
+            }
+            field = value
+        }
 
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
@@ -43,6 +50,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         })
 
         state = DownloadWizardState(
+            null,
             intent.getIntExtra("selectedLogicalSlot", 0),
             "",
             "",
@@ -88,6 +96,29 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         }
     }
 
+    override fun onSaveInstanceState(outState: Bundle) {
+        super.onSaveInstanceState(outState)
+        outState.putString("currentStepFragmentClassName", state.currentStepFragmentClassName)
+        outState.putInt("selectedLogicalSlot", state.selectedLogicalSlot)
+        outState.putString("smdp", state.smdp)
+        outState.putString("matchingId", state.matchingId)
+        outState.putString("confirmationCode", state.confirmationCode)
+        outState.putString("imei", state.imei)
+    }
+
+    override fun onRestoreInstanceState(savedInstanceState: Bundle) {
+        super.onRestoreInstanceState(savedInstanceState)
+        state.currentStepFragmentClassName = savedInstanceState.getString(
+            "currentStepFragmentClassName",
+            state.currentStepFragmentClassName
+        )
+        state.selectedLogicalSlot =
+            savedInstanceState.getInt("selectedLogicalSlot", state.selectedLogicalSlot)
+        state.smdp = savedInstanceState.getString("smdp", state.smdp)
+        state.matchingId = savedInstanceState.getString("matchingId", state.matchingId)
+        state.imei = savedInstanceState.getString("imei", state.imei)
+    }
+
     private fun onPrevPressed() {
         if (currentFragment?.hasPrev == true) {
             val prevFrag = currentFragment?.createPrevFragment()
@@ -112,7 +143,13 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
 
     override fun onInit() {
         progressBar.visibility = View.GONE
-        showFragment(DownloadWizardSlotSelectFragment())
+
+        if (state.currentStepFragmentClassName != null) {
+            val clazz = Class.forName(state.currentStepFragmentClassName!!)
+            showFragment(clazz.getDeclaredConstructor().newInstance() as DownloadWizardStepFragment)
+        } else {
+            showFragment(DownloadWizardSlotSelectFragment())
+        }
     }
 
     private fun showFragment(

From f236b40cd4ff7c72b8d2ee568d52b33b7f717f16 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 19 Nov 2024 20:49:34 -0500
Subject: [PATCH 242/458] lpac-jni: Add lookup from progress to state

---
 .../net/typeblog/lpac_jni/ProfileDownloadCallback.kt | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ProfileDownloadCallback.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ProfileDownloadCallback.kt
index 579ad5842..289ddf6b0 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ProfileDownloadCallback.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ProfileDownloadCallback.kt
@@ -1,6 +1,18 @@
 package net.typeblog.lpac_jni
 
 interface ProfileDownloadCallback {
+    companion object {
+        fun lookupStateFromProgress(progress: Int): DownloadState =
+            when (progress) {
+                0 -> DownloadState.Preparing
+                20 -> DownloadState.Connecting
+                40 -> DownloadState.Authenticating
+                60 -> DownloadState.Downloading
+                80 -> DownloadState.Finalizing
+                else -> throw IllegalArgumentException("Unknown state")
+            }
+    }
+
     enum class DownloadState(val progress: Int) {
         Preparing(0),
         Connecting(20), // Before {server,client} authentication

From 39b40f9b0dd0554b9705a783a979d66988021ec4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 20 Nov 2024 20:57:35 -0500
Subject: [PATCH 243/458] ui: wizard: Lay out the download progress UI

---
 .../ui/wizard/DownloadWizardActivity.kt       |   3 +
 .../wizard/DownloadWizardDetailsFragment.kt   |  10 +-
 .../wizard/DownloadWizardProgressFragment.kt  | 117 ++++++++++++++++++
 .../res/drawable/ic_checkmark_outline.xml     |   0
 .../main/res/drawable/ic_error_outline.xml    |   0
 .../res/layout/download_progress_item.xml     |  45 +++++++
 .../res/layout/fragment_download_progress.xml |  33 +++++
 app-common/src/main/res/values/strings.xml    |   6 +
 8 files changed, 212 insertions(+), 2 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
 rename {app-unpriv => app-common}/src/main/res/drawable/ic_checkmark_outline.xml (100%)
 rename {app-unpriv => app-common}/src/main/res/drawable/ic_error_outline.xml (100%)
 create mode 100644 app-common/src/main/res/layout/download_progress_item.xml
 create mode 100644 app-common/src/main/res/layout/fragment_download_progress.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 029725cd8..d76bbe529 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -132,6 +132,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
 
     private fun onNextPressed() {
         if (currentFragment?.hasNext == true) {
+            currentFragment?.beforeNext()
             val nextFrag = currentFragment?.createNextFragment()
             if (nextFrag == null) {
                 finish()
@@ -216,5 +217,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         protected fun refreshButtons() {
             (requireActivity() as DownloadWizardActivity).refreshButtons()
         }
+
+        open fun beforeNext() {}
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index c4a484f1d..8d9be705f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -22,10 +22,16 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
     private lateinit var confirmationCode: TextInputLayout
     private lateinit var imei: TextInputLayout
 
-    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? {
-        TODO("Not yet implemented")
+    override fun beforeNext() {
+        state.smdp = smdp.editText!!.text.toString().trim()
+        state.matchingId = matchingId.editText!!.text.toString().trim()
+        state.confirmationCode = confirmationCode.editText!!.text.toString().trim()
+        state.imei = imei.editText!!.text.toString()
     }
 
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
+        DownloadWizardProgressFragment()
+
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
         DownloadWizardMethodSelectFragment()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
new file mode 100644
index 000000000..ed58b0da1
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -0,0 +1,117 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.ImageView
+import android.widget.ProgressBar
+import android.widget.TextView
+import androidx.recyclerview.widget.DividerItemDecoration
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import im.angry.openeuicc.common.R
+
+class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    private enum class ProgressState {
+        NotStarted,
+        InProgress,
+        Done,
+        Error
+    }
+
+    private data class ProgressItem(
+        val titleRes: Int,
+        val state: ProgressState
+    )
+
+    private val progressItems = arrayOf(
+        ProgressItem(R.string.download_wizard_progress_step_preparing, ProgressState.NotStarted),
+        ProgressItem(R.string.download_wizard_progress_step_connecting, ProgressState.NotStarted),
+        ProgressItem(
+            R.string.download_wizard_progress_step_authenticating,
+            ProgressState.NotStarted
+        ),
+        ProgressItem(R.string.download_wizard_progress_step_downloading, ProgressState.NotStarted),
+        ProgressItem(R.string.download_wizard_progress_step_finalizing, ProgressState.NotStarted)
+    )
+
+    private val adapter = ProgressItemAdapter()
+
+    override val hasNext: Boolean
+        get() = false
+    override val hasPrev: Boolean
+        get() = false
+
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
+
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_download_progress, container, false)
+        val recyclerView = view.requireViewById<RecyclerView>(R.id.download_progress_list)
+        recyclerView.adapter = adapter
+        recyclerView.layoutManager =
+            LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
+        recyclerView.addItemDecoration(
+            DividerItemDecoration(
+                requireContext(),
+                LinearLayoutManager.VERTICAL
+            )
+        )
+        return view
+    }
+
+    private inner class ProgressItemHolder(val root: View) : RecyclerView.ViewHolder(root) {
+        private val title = root.requireViewById<TextView>(R.id.download_progress_item_title)
+        private val progressBar =
+            root.requireViewById<ProgressBar>(R.id.download_progress_icon_progress)
+        private val icon = root.requireViewById<ImageView>(R.id.download_progress_icon)
+
+        fun bind(item: ProgressItem) {
+            title.text = getString(item.titleRes)
+
+            when (item.state) {
+                ProgressState.NotStarted -> {
+                    progressBar.visibility = View.GONE
+                    icon.visibility = View.GONE
+                }
+
+                ProgressState.InProgress -> {
+                    progressBar.visibility = View.VISIBLE
+                    icon.visibility = View.GONE
+                }
+
+                ProgressState.Done -> {
+                    progressBar.visibility = View.GONE
+                    icon.setImageResource(R.drawable.ic_checkmark_outline)
+                    icon.visibility = View.VISIBLE
+                }
+
+                ProgressState.Error -> {
+                    progressBar.visibility = View.GONE
+                    icon.setImageResource(R.drawable.ic_error_outline)
+                    icon.visibility = View.VISIBLE
+                }
+            }
+        }
+    }
+
+    private inner class ProgressItemAdapter : RecyclerView.Adapter<ProgressItemHolder>() {
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ProgressItemHolder {
+            val root = LayoutInflater.from(parent.context)
+                .inflate(R.layout.download_progress_item, parent, false)
+            return ProgressItemHolder(root)
+        }
+
+        override fun getItemCount(): Int = progressItems.size
+
+        override fun onBindViewHolder(holder: ProgressItemHolder, position: Int) {
+            holder.bind(progressItems[position])
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/drawable/ic_checkmark_outline.xml b/app-common/src/main/res/drawable/ic_checkmark_outline.xml
similarity index 100%
rename from app-unpriv/src/main/res/drawable/ic_checkmark_outline.xml
rename to app-common/src/main/res/drawable/ic_checkmark_outline.xml
diff --git a/app-unpriv/src/main/res/drawable/ic_error_outline.xml b/app-common/src/main/res/drawable/ic_error_outline.xml
similarity index 100%
rename from app-unpriv/src/main/res/drawable/ic_error_outline.xml
rename to app-common/src/main/res/drawable/ic_error_outline.xml
diff --git a/app-common/src/main/res/layout/download_progress_item.xml b/app-common/src/main/res/layout/download_progress_item.xml
new file mode 100644
index 000000000..f1d0852e8
--- /dev/null
+++ b/app-common/src/main/res/layout/download_progress_item.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/download_progress_item_title"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_margin="20dp"
+        android:textSize="14sp"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toStartOf="@id/download_progress_icon_container"
+        app:layout_constrainedWidth="true"
+        app:layout_constraintHorizontal_bias="0.0" />
+
+    <FrameLayout
+        android:id="@+id/download_progress_icon_container"
+        android:layout_margin="20dp"
+        android:layout_width="30dp"
+        android:layout_height="30dp"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent">
+
+        <ProgressBar
+            android:id="@+id/download_progress_icon_progress"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:indeterminate="true"
+            android:visibility="gone" />
+
+        <ImageView
+            android:id="@+id/download_progress_icon"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:visibility="gone"
+            app:tint="?attr/colorPrimary" />
+
+    </FrameLayout>
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/layout/fragment_download_progress.xml b/app-common/src/main/res/layout/fragment_download_progress.xml
new file mode 100644
index 000000000..0ec58e454
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_download_progress.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <TextView
+        android:id="@+id/download_progress_title"
+        android:text="@string/download_wizard_progress"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:gravity="center_horizontal"
+        android:textSize="20sp"
+        android:layout_marginTop="20sp"
+        android:layout_marginBottom="20sp"
+        android:layout_marginStart="60sp"
+        android:layout_marginEnd="60sp"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constrainedWidth="true"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/download_progress_list"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        app:layout_constraintTop_toBottomOf="@id/download_progress_title"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constrainedHeight="true" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 3b075bba3..e42bf0494 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -75,6 +75,12 @@
     <string name="download_wizard_method_gallery">Load a QR code from gallery</string>
     <string name="download_wizard_method_manual">Enter manually</string>
     <string name="download_wizard_details">Input or confirm details for downloading your eSIM:</string>
+    <string name="download_wizard_progress">Downloading your eSIM…</string>
+    <string name="download_wizard_progress_step_preparing">Preparing</string>
+    <string name="download_wizard_progress_step_connecting">Establishing connection to server</string>
+    <string name="download_wizard_progress_step_authenticating">Authenticating your device with server</string>
+    <string name="download_wizard_progress_step_downloading">Downloading eSIM profile</string>
+    <string name="download_wizard_progress_step_finalizing">Loading eSIM profile into storage</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 67c9612627389da82b1154b0691fdf360b7158fe Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 20 Nov 2024 21:00:50 -0500
Subject: [PATCH 244/458] ui: wizard: Restrict inputs to single lines

---
 app-common/src/main/res/layout/fragment_download_details.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/app-common/src/main/res/layout/fragment_download_details.xml b/app-common/src/main/res/layout/fragment_download_details.xml
index 0820c2748..ca36d6450 100644
--- a/app-common/src/main/res/layout/fragment_download_details.xml
+++ b/app-common/src/main/res/layout/fragment_download_details.xml
@@ -32,6 +32,8 @@
             android:hint="@string/profile_download_server">
 
             <com.google.android.material.textfield.TextInputEditText
+                android:maxLines="1"
+                android:inputType="text"
                 android:layout_width="match_parent"
                 android:layout_height="match_parent" />
 
@@ -44,6 +46,7 @@
             android:hint="@string/profile_download_code">
 
             <com.google.android.material.textfield.TextInputEditText
+                android:maxLines="1"
                 android:layout_width="match_parent"
                 android:layout_height="match_parent"
                 android:inputType="textPassword" />
@@ -57,6 +60,7 @@
             android:hint="@string/profile_download_confirmation_code">
 
             <com.google.android.material.textfield.TextInputEditText
+                android:maxLines="1"
                 android:layout_width="match_parent"
                 android:layout_height="match_parent"
                 android:inputType="textPassword" />
@@ -73,6 +77,7 @@
             app:passwordToggleEnabled="true">
 
             <com.google.android.material.textfield.TextInputEditText
+                android:maxLines="1"
                 android:layout_width="match_parent"
                 android:layout_height="match_parent"
                 android:inputType="textPassword" />

From b2abe5ee8498648cb8061bc9477e1dc492382501 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 20 Nov 2024 21:03:42 -0500
Subject: [PATCH 245/458] ui: wizard: Make download details nullable

---
 .../openeuicc/ui/wizard/DownloadWizardActivity.kt    | 12 ++++++------
 .../ui/wizard/DownloadWizardDetailsFragment.kt       |  7 ++++---
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index d76bbe529..6383d8b48 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -19,9 +19,9 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var currentStepFragmentClassName: String?,
         var selectedLogicalSlot: Int,
         var smdp: String,
-        var matchingId: String,
-        var confirmationCode: String,
-        var imei: String,
+        var matchingId: String?,
+        var confirmationCode: String?,
+        var imei: String?,
     )
 
     private lateinit var state: DownloadWizardState
@@ -53,9 +53,9 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             null,
             intent.getIntExtra("selectedLogicalSlot", 0),
             "",
-            "",
-            "",
-            ""
+            null,
+            null,
+            null
         )
 
         progressBar = requireViewById(R.id.progress)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index 8d9be705f..eb36710a1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -24,9 +24,10 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
 
     override fun beforeNext() {
         state.smdp = smdp.editText!!.text.toString().trim()
-        state.matchingId = matchingId.editText!!.text.toString().trim()
-        state.confirmationCode = confirmationCode.editText!!.text.toString().trim()
-        state.imei = imei.editText!!.text.toString()
+        // Treat empty inputs as null -- this is important for the download step
+        state.matchingId = matchingId.editText!!.text.toString().trim().ifBlank { null }
+        state.confirmationCode = confirmationCode.editText!!.text.toString().trim().ifBlank { null }
+        state.imei = imei.editText!!.text.toString().ifBlank { null }
     }
 
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment =

From 3507c17834b72feaa5ef374ed510721088622381 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 10:18:54 -0500
Subject: [PATCH 246/458] EuiccChannalManagerService: manually buffer the
 returned flow

---
 .../service/EuiccChannelManagerService.kt     | 52 +++++++++++--------
 1 file changed, 31 insertions(+), 21 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 9cfd526ca..e8f3e1d60 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -15,10 +15,12 @@ import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.NonCancellable
+import kotlinx.coroutines.channels.BufferOverflow
 import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.buffer
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.flow
@@ -249,29 +251,37 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         // Then, we complete the returned flow, but we also set the state back to Idle.
         // The state update back to Idle won't show up in the returned stream, because
         // it has been completed by that point.
-        return foregroundTaskState.transformWhile {
-            // Also update our notification when we see an update
-            // But ignore the first progress = 0 update -- that is the current value.
-            // we need that to be handled by the main coroutine after it finishes.
-            if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
-                withContext(Dispatchers.Main) {
-                    updateForegroundNotification(title, iconRes)
+        val subscriberFlow = foregroundTaskState
+            .transformWhile {
+                // Also update our notification when we see an update
+                // But ignore the first progress = 0 update -- that is the current value.
+                // we need that to be handled by the main coroutine after it finishes.
+                if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
+                    withContext(Dispatchers.Main) {
+                        updateForegroundNotification(title, iconRes)
+                    }
                 }
-            }
-            emit(it)
-            it !is ForegroundTaskState.Done
-        }.onStart {
-            // When this Flow is started, we unblock the coroutine launched above by
-            // self-starting as a foreground service.
-            withContext(Dispatchers.Main) {
-                startForegroundService(
-                    Intent(
-                        this@EuiccChannelManagerService,
-                        this@EuiccChannelManagerService::class.java
+                emit(it)
+                it !is ForegroundTaskState.Done
+            }.onStart {
+                // When this Flow is started, we unblock the coroutine launched above by
+                // self-starting as a foreground service.
+                withContext(Dispatchers.Main) {
+                    startForegroundService(
+                        Intent(
+                            this@EuiccChannelManagerService,
+                            this@EuiccChannelManagerService::class.java
+                        )
                     )
-                )
-            }
-        }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
+                }
+            }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
+            // Buffer the returned flow by 2, so that if there is an error,
+            // we always get a copy of the last process update before completion.
+            // This also guarantees that our onCompletion callback is always run
+            // even if the returned flow isn't subscribed to
+            .buffer(capacity = 2, onBufferOverflow = BufferOverflow.DROP_OLDEST)
+
+        return subscriberFlow
     }
 
     val isForegroundTaskRunning: Boolean

From f2c233fe1ca8a31dfe1beb47816311db0d95542e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 10:42:02 -0500
Subject: [PATCH 247/458] EuiccChannelManagerService: Introduce IDs for tasks

---
 .../service/EuiccChannelManagerService.kt     | 48 ++++++++++++++++---
 1 file changed, 41 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index e8f3e1d60..cd6f3a80a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -100,6 +100,25 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     private val foregroundTaskState: MutableStateFlow<ForegroundTaskState> =
         MutableStateFlow(ForegroundTaskState.Idle)
 
+    /**
+     * A simple wrapper over a flow with taskId added.
+     *
+     * taskID is the exact millisecond-precision timestamp when the task is launched.
+     */
+    class ForegroundTaskSubscriberFlow(val taskId: Long, inner: Flow<ForegroundTaskState>) :
+        Flow<ForegroundTaskState> by inner
+
+    /**
+     * A cache of subscribers to 5 recently-launched foreground tasks, identified by ID
+     *
+     * Only one can be run at the same time, but those that are done will be kept in this
+     * map for a little while -- because UI components may be stopped and recreated while
+     * tasks are running. Having this buffer allows the components to re-subscribe even if
+     * the task completes while they are being recreated.
+     */
+    private val foregroundTaskSubscribers: MutableMap<Long, ForegroundTaskSubscriberFlow> =
+        mutableMapOf()
+
     override fun onBind(intent: Intent): IBinder {
         super.onBind(intent)
         return LocalBinder()
@@ -196,7 +215,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         failureTitle: String,
         iconRes: Int,
         task: suspend EuiccChannelManagerService.() -> Unit
-    ): Flow<ForegroundTaskState> {
+    ): ForegroundTaskSubscriberFlow {
+        val taskID = System.currentTimeMillis()
+
         // Atomically set the state to InProgress. If this returns true, we are
         // the only task currently in progress.
         if (!foregroundTaskState.compareAndSet(
@@ -204,7 +225,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 ForegroundTaskState.InProgress(0)
             )
         ) {
-            return flow { emit(ForegroundTaskState.Done(IllegalStateException("There are tasks currently running"))) }
+            return ForegroundTaskSubscriberFlow(
+                taskID,
+                flow { emit(ForegroundTaskState.Done(IllegalStateException("There are tasks currently running"))) })
         }
 
         lifecycleScope.launch(Dispatchers.Main) {
@@ -281,7 +304,18 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             // even if the returned flow isn't subscribed to
             .buffer(capacity = 2, onBufferOverflow = BufferOverflow.DROP_OLDEST)
 
-        return subscriberFlow
+        val ret = ForegroundTaskSubscriberFlow(taskID, subscriberFlow)
+        foregroundTaskSubscribers[taskID] = ret
+
+        if (foregroundTaskSubscribers.size > 5) {
+            // Remove enough elements so that the size is kept at 5
+            for (key in foregroundTaskSubscribers.keys.sorted()
+                .take(foregroundTaskSubscribers.size - 5)) {
+                foregroundTaskSubscribers.remove(key)
+            }
+        }
+
+        return ret
     }
 
     val isForegroundTaskRunning: Boolean
@@ -299,7 +333,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         matchingId: String?,
         confirmationCode: String?,
         imei: String?
-    ): Flow<ForegroundTaskState> =
+    ): ForegroundTaskSubscriberFlow =
         launchForegroundTask(
             getString(R.string.task_profile_download),
             getString(R.string.task_profile_download_failure),
@@ -335,7 +369,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         portId: Int,
         iccid: String,
         name: String
-    ): Flow<ForegroundTaskState> =
+    ): ForegroundTaskSubscriberFlow =
         launchForegroundTask(
             getString(R.string.task_profile_rename),
             getString(R.string.task_profile_rename_failure),
@@ -357,7 +391,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         slotId: Int,
         portId: Int,
         iccid: String
-    ): Flow<ForegroundTaskState> =
+    ): ForegroundTaskSubscriberFlow =
         launchForegroundTask(
             getString(R.string.task_profile_delete),
             getString(R.string.task_profile_delete_failure),
@@ -380,7 +414,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         iccid: String,
         enable: Boolean, // Enable or disable the profile indicated in iccid
         reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect, useful for USB readers
-    ): Flow<ForegroundTaskState> =
+    ): ForegroundTaskSubscriberFlow =
         launchForegroundTask(
             getString(R.string.task_profile_switch),
             getString(R.string.task_profile_switch_failure),

From 5b079c95ac0a8e44949494810550a7a795b6aba6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 11:23:27 -0500
Subject: [PATCH 248/458] ui: wizard: Implement the download process

---
 .../service/EuiccChannelManagerService.kt     |   8 ++
 .../ui/wizard/DownloadWizardActivity.kt       |  11 +-
 .../wizard/DownloadWizardProgressFragment.kt  | 117 +++++++++++++++++-
 3 files changed, 133 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index cd6f3a80a..9c40fa11d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -196,6 +196,14 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         NotificationManagerCompat.from(this).notify(TASK_FAILURE_ID, notification)
     }
 
+    /**
+     * Recover the subscriber to a foreground task that is recently launched.
+     *
+     * null if the task doesn't exist, or was launched too long ago.
+     */
+    fun recoverForegroundTaskSubscriber(taskId: Long): ForegroundTaskSubscriberFlow? =
+        foregroundTaskSubscribers[taskId]
+
     /**
      * Launch a potentially blocking foreground task in this service's lifecycle context.
      * This function does not block, but returns a Flow that emits ForegroundTaskState
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 6383d8b48..9f47e3e92 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -22,6 +22,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var matchingId: String?,
         var confirmationCode: String?,
         var imei: String?,
+        var downloadStarted: Boolean,
+        var downloadTaskID: Long,
     )
 
     private lateinit var state: DownloadWizardState
@@ -55,7 +57,9 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             "",
             null,
             null,
-            null
+            null,
+            false,
+            -1
         )
 
         progressBar = requireViewById(R.id.progress)
@@ -104,6 +108,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         outState.putString("matchingId", state.matchingId)
         outState.putString("confirmationCode", state.confirmationCode)
         outState.putString("imei", state.imei)
+        outState.putBoolean("downloadStarted", state.downloadStarted)
+        outState.putLong("downloadTaskID", state.downloadTaskID)
     }
 
     override fun onRestoreInstanceState(savedInstanceState: Bundle) {
@@ -117,6 +123,9 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         state.smdp = savedInstanceState.getString("smdp", state.smdp)
         state.matchingId = savedInstanceState.getString("matchingId", state.matchingId)
         state.imei = savedInstanceState.getString("imei", state.imei)
+        state.downloadStarted =
+            savedInstanceState.getBoolean("downloadStarted", state.downloadStarted)
+        state.downloadTaskID = savedInstanceState.getLong("downloadTaskID", state.downloadTaskID)
     }
 
     private fun onPrevPressed() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index ed58b0da1..c1923f598 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -7,12 +7,32 @@ import android.view.ViewGroup
 import android.widget.ImageView
 import android.widget.ProgressBar
 import android.widget.TextView
+import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService
+import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.collect
+import kotlinx.coroutines.flow.onEach
+import kotlinx.coroutines.launch
+import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    companion object {
+        /**
+         * An array of LPA-side state types, mapping 1:1 to progressItems
+         */
+        val LPA_PROGRESS_STATES = arrayOf(
+            ProfileDownloadCallback.DownloadState.Preparing,
+            ProfileDownloadCallback.DownloadState.Connecting,
+            ProfileDownloadCallback.DownloadState.Authenticating,
+            ProfileDownloadCallback.DownloadState.Downloading,
+            ProfileDownloadCallback.DownloadState.Finalizing,
+        )
+    }
+
     private enum class ProgressState {
         NotStarted,
         InProgress,
@@ -22,7 +42,7 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
 
     private data class ProgressItem(
         val titleRes: Int,
-        val state: ProgressState
+        var state: ProgressState
     )
 
     private val progressItems = arrayOf(
@@ -38,8 +58,10 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
 
     private val adapter = ProgressItemAdapter()
 
+    private var isDone = false
+
     override val hasNext: Boolean
-        get() = false
+        get() = isDone
     override val hasPrev: Boolean
         get() = false
 
@@ -66,6 +88,97 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
         return view
     }
 
+    override fun onStart() {
+        super.onStart()
+
+        lifecycleScope.launch {
+            showProgressBar(-1) // set indeterminate first
+            ensureEuiccChannelManager()
+
+            val subscriber = startDownloadOrSubscribe()
+
+            if (subscriber == null) {
+                requireActivity().finish()
+                return@launch
+            }
+
+            subscriber.onEach {
+                when (it) {
+                    is EuiccChannelManagerService.ForegroundTaskState.Done -> {
+                        hideProgressBar()
+
+                        // Change the state of the last InProgress item to Error
+                        progressItems.forEachIndexed { index, progressItem ->
+                            if (progressItem.state == ProgressState.InProgress) {
+                                progressItem.state = ProgressState.Error
+                            }
+
+                            adapter.notifyItemChanged(index)
+                        }
+
+                        isDone = true
+                        refreshButtons()
+                    }
+
+                    is EuiccChannelManagerService.ForegroundTaskState.InProgress -> {
+                        updateProgress(it.progress)
+                    }
+
+                    else -> {}
+                }
+            }.collect()
+        }
+    }
+
+    private suspend fun startDownloadOrSubscribe(): EuiccChannelManagerService.ForegroundTaskSubscriberFlow? =
+        if (state.downloadStarted) {
+            // This will also return null if task ID is -1 (uninitialized), too
+            euiccChannelManagerService.recoverForegroundTaskSubscriber(state.downloadTaskID)
+        } else {
+            euiccChannelManagerService.waitForForegroundTask()
+
+            val (slotId, portId) = euiccChannelManager.withEuiccChannel(state.selectedLogicalSlot) { channel ->
+                Pair(channel.slotId, channel.portId)
+            }
+
+            // Set started to true even before we start -- in case we get killed in the middle
+            state.downloadStarted = true
+
+            val ret = euiccChannelManagerService.launchProfileDownloadTask(
+                slotId,
+                portId,
+                state.smdp,
+                state.matchingId,
+                state.confirmationCode,
+                state.imei
+            )
+
+            state.downloadTaskID = ret.taskId
+
+            ret
+        }
+
+    private fun updateProgress(progress: Int) {
+        showProgressBar(progress)
+
+        val lpaState = ProfileDownloadCallback.lookupStateFromProgress(progress)
+        val stateIndex = LPA_PROGRESS_STATES.indexOf(lpaState)
+
+        if (stateIndex > 0) {
+            for (i in (0..<stateIndex)) {
+                if (progressItems[i].state != ProgressState.Done) {
+                    progressItems[i].state = ProgressState.Done
+                    adapter.notifyItemChanged(i)
+                }
+            }
+        }
+
+        if (progressItems[stateIndex].state != ProgressState.InProgress) {
+            progressItems[stateIndex].state = ProgressState.InProgress
+            adapter.notifyItemChanged(stateIndex)
+        }
+    }
+
     private inner class ProgressItemHolder(val root: View) : RecyclerView.ViewHolder(root) {
         private val title = root.requireViewById<TextView>(R.id.download_progress_item_title)
         private val progressBar =

From d68a7172de6999116a97b803b4b5032b2ec23cca Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 13:14:16 -0500
Subject: [PATCH 249/458] EuiccChannelManagerService: Fix support for multiple
 subscribers

We have to use another SharedFlow here. Otherwise, the flow transforms
break our ability to subscribe to it more than once, which is needed for
UI state to preserve across recreate events.
---
 .../service/EuiccChannelManagerService.kt     | 81 ++++++++++++-------
 1 file changed, 51 insertions(+), 30 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 9c40fa11d..4f6e67c7e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -20,13 +20,13 @@ import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
-import kotlinx.coroutines.flow.buffer
+import kotlinx.coroutines.flow.asSharedFlow
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.flow.last
 import kotlinx.coroutines.flow.onCompletion
-import kotlinx.coroutines.flow.onStart
+import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.flow.takeWhile
 import kotlinx.coroutines.flow.transformWhile
 import kotlinx.coroutines.isActive
@@ -208,8 +208,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
      * Launch a potentially blocking foreground task in this service's lifecycle context.
      * This function does not block, but returns a Flow that emits ForegroundTaskState
      * updates associated with this task. The last update the returned flow will emit is
-     * always ForegroundTaskState.Done. The returned flow MUST be started in order for the
-     * foreground task to run.
+     * always ForegroundTaskState.Done.
+     *
+     * The returned flow can be subscribed multiple times because it is implemented as a
+     * SharedFlow under the hood. New subscribers are guaranteed at least 1 previous update
+     * in addition to latest ones. This is to ensure subscribers always receive at least one
+     * InProgress before any sort of failure.
      *
      * The task closure is expected to update foregroundTaskState whenever appropriate.
      * If a foreground task is already running, this function returns null.
@@ -277,42 +281,49 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             }
         }
 
+        // This is the flow we are going to return. We allow multiple subscribers by
+        // re-emitting state updates into this flow from another coroutine.
+        // replay = 2 ensures that we at least have 1 previous state whenever subscribed to.
+        // This is helpful when the task completed and is then re-subscribed to due to a
+        // UI recreation event -- this way, the UI will know at least one last progress event
+        // before completion / failure
+        val subscriberFlow = MutableSharedFlow<ForegroundTaskState>(
+            replay = 2,
+            onBufferOverflow = BufferOverflow.DROP_OLDEST
+        )
+
         // We should be the only task running, so we can subscribe to foregroundTaskState
         // until we encounter ForegroundTaskState.Done.
         // Then, we complete the returned flow, but we also set the state back to Idle.
         // The state update back to Idle won't show up in the returned stream, because
         // it has been completed by that point.
-        val subscriberFlow = foregroundTaskState
-            .transformWhile {
-                // Also update our notification when we see an update
-                // But ignore the first progress = 0 update -- that is the current value.
-                // we need that to be handled by the main coroutine after it finishes.
-                if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
-                    withContext(Dispatchers.Main) {
+        lifecycleScope.launch(Dispatchers.Main) {
+            foregroundTaskState
+                .transformWhile {
+                    // Also update our notification when we see an update
+                    // But ignore the first progress = 0 update -- that is the current value.
+                    // we need that to be handled by the main coroutine after it finishes.
+                    if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
                         updateForegroundNotification(title, iconRes)
                     }
+                    emit(it)
+                    it !is ForegroundTaskState.Done
                 }
-                emit(it)
-                it !is ForegroundTaskState.Done
-            }.onStart {
-                // When this Flow is started, we unblock the coroutine launched above by
-                // self-starting as a foreground service.
-                withContext(Dispatchers.Main) {
-                    startForegroundService(
-                        Intent(
-                            this@EuiccChannelManagerService,
-                            this@EuiccChannelManagerService::class.java
-                        )
-                    )
+                .onEach {
+                    subscriberFlow.emit(it)
                 }
-            }.onCompletion { foregroundTaskState.value = ForegroundTaskState.Idle }
-            // Buffer the returned flow by 2, so that if there is an error,
-            // we always get a copy of the last process update before completion.
-            // This also guarantees that our onCompletion callback is always run
-            // even if the returned flow isn't subscribed to
-            .buffer(capacity = 2, onBufferOverflow = BufferOverflow.DROP_OLDEST)
+                .onCompletion {
+                    // Reset state back to Idle when we are done.
+                    // We do it here because otherwise Idle and Done might become conflated
+                    // when emitted by the main coroutine in quick succession.
+                    // Doing it here ensures we've seen Done. This Idle event won't be
+                    // emitted to the consumer because the subscription has completed here.
+                    foregroundTaskState.value = ForegroundTaskState.Idle
+                }
+                .collect()
+        }
 
-        val ret = ForegroundTaskSubscriberFlow(taskID, subscriberFlow)
+        val ret = ForegroundTaskSubscriberFlow(taskID, subscriberFlow.asSharedFlow())
         foregroundTaskSubscribers[taskID] = ret
 
         if (foregroundTaskSubscribers.size > 5) {
@@ -323,6 +334,16 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             }
         }
 
+        // Before we return, and after we have set everything up,
+        // self-start with foreground permission.
+        // This is going to unblock the main coroutine handling the task.
+        startForegroundService(
+            Intent(
+                this@EuiccChannelManagerService,
+                this@EuiccChannelManagerService::class.java
+            )
+        )
+
         return ret
     }
 

From 74489a9ae09ccb14bd2728c062365925fb96a67c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 13:25:11 -0500
Subject: [PATCH 250/458] EuiccChannelManagerservice: Fix completion event in
 returned flows

---
 .../service/EuiccChannelManagerService.kt     | 43 +++++++++++++------
 1 file changed, 29 insertions(+), 14 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 4f6e67c7e..e0d403fea 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -20,6 +20,7 @@ import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.SharedFlow
 import kotlinx.coroutines.flow.asSharedFlow
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.first
@@ -116,7 +117,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
      * tasks are running. Having this buffer allows the components to re-subscribe even if
      * the task completes while they are being recreated.
      */
-    private val foregroundTaskSubscribers: MutableMap<Long, ForegroundTaskSubscriberFlow> =
+    private val foregroundTaskSubscribers: MutableMap<Long, SharedFlow<ForegroundTaskState>> =
         mutableMapOf()
 
     override fun onBind(intent: Intent): IBinder {
@@ -196,13 +197,27 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         NotificationManagerCompat.from(this).notify(TASK_FAILURE_ID, notification)
     }
 
+    /**
+     * Apply transform to a ForegroundTaskState flow so that it completes when a Done is seen.
+     *
+     * This must be applied each time a flow is returned for subscription purposes. If applied
+     * beforehand, we lose the ability to subscribe multiple times.
+     */
+    private fun Flow<ForegroundTaskState>.applyCompletionTransform() =
+        transformWhile {
+            emit(it)
+            it !is ForegroundTaskState.Done
+        }
+
     /**
      * Recover the subscriber to a foreground task that is recently launched.
      *
      * null if the task doesn't exist, or was launched too long ago.
      */
     fun recoverForegroundTaskSubscriber(taskId: Long): ForegroundTaskSubscriberFlow? =
-        foregroundTaskSubscribers[taskId]
+        foregroundTaskSubscribers[taskId]?.let {
+            ForegroundTaskSubscriberFlow(taskId, it.applyCompletionTransform())
+        }
 
     /**
      * Launch a potentially blocking foreground task in this service's lifecycle context.
@@ -210,10 +225,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
      * updates associated with this task. The last update the returned flow will emit is
      * always ForegroundTaskState.Done.
      *
-     * The returned flow can be subscribed multiple times because it is implemented as a
-     * SharedFlow under the hood. New subscribers are guaranteed at least 1 previous update
-     * in addition to latest ones. This is to ensure subscribers always receive at least one
-     * InProgress before any sort of failure.
+     * The returned flow can only be subscribed to once even though the underlying implementation
+     * is a SharedFlow. This is due to the need to apply transformations so that the stream
+     * actually completes. In order to subscribe multiple times, use `recoverForegroundTaskSubscriber`
+     * to acquire another instance.
      *
      * The task closure is expected to update foregroundTaskState whenever appropriate.
      * If a foreground task is already running, this function returns null.
@@ -299,17 +314,15 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         // it has been completed by that point.
         lifecycleScope.launch(Dispatchers.Main) {
             foregroundTaskState
-                .transformWhile {
+                .applyCompletionTransform()
+                .onEach {
                     // Also update our notification when we see an update
                     // But ignore the first progress = 0 update -- that is the current value.
                     // we need that to be handled by the main coroutine after it finishes.
                     if (it !is ForegroundTaskState.InProgress || it.progress != 0) {
                         updateForegroundNotification(title, iconRes)
                     }
-                    emit(it)
-                    it !is ForegroundTaskState.Done
-                }
-                .onEach {
+
                     subscriberFlow.emit(it)
                 }
                 .onCompletion {
@@ -323,8 +336,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 .collect()
         }
 
-        val ret = ForegroundTaskSubscriberFlow(taskID, subscriberFlow.asSharedFlow())
-        foregroundTaskSubscribers[taskID] = ret
+        foregroundTaskSubscribers[taskID] = subscriberFlow.asSharedFlow()
 
         if (foregroundTaskSubscribers.size > 5) {
             // Remove enough elements so that the size is kept at 5
@@ -344,7 +356,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             )
         )
 
-        return ret
+        return ForegroundTaskSubscriberFlow(
+            taskID,
+            subscriberFlow.asSharedFlow().applyCompletionTransform()
+        )
     }
 
     val isForegroundTaskRunning: Boolean

From 1a3fd621d920c8e1086d97d8cc10051c9e2a293b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 15:34:36 -0500
Subject: [PATCH 251/458] EuiccChannelManagerService: move
 applyCompletionTransform() to companion object

---
 .../service/EuiccChannelManagerService.kt     | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index e0d403fea..87b5e4895 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -68,6 +68,18 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
          */
         suspend fun Flow<ForegroundTaskState>.waitDone(): Throwable? =
             (this.last() as ForegroundTaskState.Done).error
+
+        /**
+         * Apply transform to a ForegroundTaskState flow so that it completes when a Done is seen.
+         *
+         * This must be applied each time a flow is returned for subscription purposes. If applied
+         * beforehand, we lose the ability to subscribe multiple times.
+         */
+        private fun Flow<ForegroundTaskState>.applyCompletionTransform() =
+            transformWhile {
+                emit(it)
+                it !is ForegroundTaskState.Done
+            }
     }
 
     inner class LocalBinder : Binder() {
@@ -197,18 +209,6 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         NotificationManagerCompat.from(this).notify(TASK_FAILURE_ID, notification)
     }
 
-    /**
-     * Apply transform to a ForegroundTaskState flow so that it completes when a Done is seen.
-     *
-     * This must be applied each time a flow is returned for subscription purposes. If applied
-     * beforehand, we lose the ability to subscribe multiple times.
-     */
-    private fun Flow<ForegroundTaskState>.applyCompletionTransform() =
-        transformWhile {
-            emit(it)
-            it !is ForegroundTaskState.Done
-        }
-
     /**
      * Recover the subscriber to a foreground task that is recently launched.
      *

From 895cbdd53d564075e788be24b47147bd6f9d6ef7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 15:56:44 -0500
Subject: [PATCH 252/458] lpa: Track last HTTP response on failure

We'll have a "error diagnosis" page for the new download wizard.

We'll probably want to do this for APDU too.
---
 .../service/EuiccChannelManagerService.kt      | 18 ++++++++++++------
 .../net/typeblog/lpac_jni/HttpInterface.kt     |  9 +++++++++
 .../typeblog/lpac_jni/LocalProfileAssistant.kt |  3 +++
 .../lpac_jni/impl/HttpInterfaceImpl.kt         |  6 +++++-
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt |  5 ++++-
 5 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 87b5e4895..6a995c836 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -35,6 +35,7 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.withTimeoutOrNull
 import kotlinx.coroutines.yield
+import net.typeblog.lpac_jni.HttpInterface
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 /**
@@ -370,6 +371,10 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             .collect()
     }
 
+    data class ProfileDownloadException(
+        val lastHttpResponse: HttpInterface.HttpResponse?
+    ) : Exception("Failed to download profile")
+
     fun launchProfileDownloadTask(
         slotId: Int,
         portId: Int,
@@ -384,8 +389,8 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             R.drawable.ic_task_sim_card_download
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                val res = euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
-                    channel.lpa.downloadProfile(
+                euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                    val res = channel.lpa.downloadProfile(
                         smdp,
                         matchingId,
                         imei,
@@ -397,11 +402,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                                     ForegroundTaskState.InProgress(state.progress)
                             }
                         })
-                }
 
-                if (!res) {
-                    // TODO: Provide more details on the error
-                    throw RuntimeException("Failed to download profile; this is typically caused by another error happened before.")
+                    if (!res) {
+                        throw ProfileDownloadException(
+                            channel.lpa.lastHttpResponse
+                        )
+                    }
                 }
 
                 preferenceRepository.notificationDownloadFlow.first()
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
index 49d6cc0f1..53b9c4f22 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
@@ -26,6 +26,15 @@ interface HttpInterface {
         }
     }
 
+    /**
+     * The last HTTP response we have received from the SM-DP+ server.
+     *
+     * This is intended for error diagnosis. However, note that most SM-DP+ servers
+     * respond with 200 even when there is an error. This needs to be taken into
+     * account when designing UI.
+     */
+    val lastHttpResponse: HttpResponse?
+
     fun transmit(url: String, tx: ByteArray, headers: Array<String>): HttpResponse
     // The LPA is supposed to pass in a list of pkIds supported by the eUICC.
     // HttpInterface is responsible for providing TrustManager implementations that
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index f256caf72..ed7ae6e5c 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -1,5 +1,7 @@
 package net.typeblog.lpac_jni
 
+import net.typeblog.lpac_jni.HttpInterface.HttpResponse
+
 interface LocalProfileAssistant {
     val valid: Boolean
     val profiles: List<LocalProfileInfo>
@@ -7,6 +9,7 @@ interface LocalProfileAssistant {
     val eID: String
     // Extended EuiccInfo for use with LUIs, containing information such as firmware version
     val euiccInfo2: EuiccInfo2?
+    val lastHttpResponse: HttpResponse?
 
     /**
      * Set the max segment size (mss) for all es10x commands. This can help with removable
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 77227f860..68781bfd1 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -23,6 +23,8 @@ class HttpInterfaceImpl(
 
     private lateinit var trustManagers: Array<TrustManager>
 
+    override var lastHttpResponse: HttpInterface.HttpResponse? = null
+
     override fun transmit(
         url: String,
         tx: ByteArray,
@@ -73,7 +75,9 @@ class HttpInterfaceImpl(
                 }
             }
 
-            return HttpInterface.HttpResponse(conn.responseCode, bytes)
+            return HttpInterface.HttpResponse(conn.responseCode, bytes).also {
+                lastHttpResponse = it
+            }
         } catch (e: Exception) {
             e.printStackTrace()
             throw e
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 51039cde0..6b8497d06 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -12,7 +12,7 @@ import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
     private val apduInterface: ApduInterface,
-    httpInterface: HttpInterface
+    private val httpInterface: HttpInterface
 ): LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
@@ -34,6 +34,9 @@ class LocalProfileAssistantImpl(
         LpacJni.euiccSetMss(contextHandle, mss)
     }
 
+    override val lastHttpResponse: HttpInterface.HttpResponse?
+        get() = httpInterface.lastHttpResponse
+
     override val valid: Boolean
         get() = !finalized && apduInterface.valid && try {
             // If we can read both eID and euiccInfo2 properly, we are likely looking at

From 07072667db604bf771fc9f72ca2c2fabad5805d6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 17:10:46 -0500
Subject: [PATCH 253/458] ui: wizard: Add error diagnostics

We finally have it!!!
---
 .../core/LocalProfileAssistantWrapper.kt      |  4 ++
 .../ui/wizard/DownloadWizardActivity.kt       |  5 +-
 .../DownloadWizardDiagnosticsFragment.kt      | 67 +++++++++++++++++++
 .../wizard/DownloadWizardProgressFragment.kt  | 10 ++-
 .../layout/fragment_download_diagnostics.xml  | 48 +++++++++++++
 app-common/src/main/res/values/strings.xml    |  3 +
 6 files changed, 135 insertions(+), 2 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
 create mode 100644 app-common/src/main/res/layout/fragment_download_diagnostics.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index e6a648afc..d07438f67 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
 import net.typeblog.lpac_jni.EuiccInfo2
+import net.typeblog.lpac_jni.HttpInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
@@ -19,6 +20,9 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
             return _inner!!
         }
 
+    override val lastHttpResponse: HttpInterface.HttpResponse?
+        get() = lpa.lastHttpResponse
+
     override val valid: Boolean
         get() = lpa.valid
     override val profiles: List<LocalProfileInfo>
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 9f47e3e92..6a1c1163c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -11,6 +11,7 @@ import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import im.angry.openeuicc.util.*
 
@@ -24,6 +25,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var imei: String?,
         var downloadStarted: Boolean,
         var downloadTaskID: Long,
+        var downloadError: EuiccChannelManagerService.ProfileDownloadException?,
     )
 
     private lateinit var state: DownloadWizardState
@@ -59,7 +61,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             null,
             null,
             false,
-            -1
+            -1,
+            null
         )
 
         progressBar = requireViewById(R.id.progress)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
new file mode 100644
index 000000000..f077dc91b
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -0,0 +1,67 @@
+package im.angry.openeuicc.ui.wizard
+
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import im.angry.openeuicc.common.R
+
+class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    override val hasNext: Boolean
+        get() = true
+    override val hasPrev: Boolean
+        get() = false
+
+    private lateinit var diagnosticTextView: TextView
+
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
+
+    override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View? {
+        val view = inflater.inflate(R.layout.fragment_download_diagnostics, container, false)
+        diagnosticTextView = view.requireViewById<TextView>(R.id.download_wizard_diagnostics_text)
+        return view
+    }
+
+    override fun onStart() {
+        super.onStart()
+        val str = buildDiagnosticsText()
+        if (str == null) {
+            requireActivity().finish()
+            return
+        }
+
+        diagnosticTextView.text = str
+    }
+
+    private fun buildDiagnosticsText(): String? = state.downloadError?.let { err ->
+        val ret = StringBuilder()
+
+        err.lastHttpResponse?.let { resp ->
+            if (resp.rcode != 200) {
+                // Only show the status if it's not 200
+                // Because we can have errors even if the rcode is 200 due to SM-DP+ servers being dumb
+                // and showing 200 might mislead users
+                ret.appendLine(
+                    getString(
+                        R.string.download_wizard_diagnostics_last_http_status,
+                        resp.rcode
+                    )
+                )
+                ret.appendLine()
+            }
+
+            ret.appendLine(getString(R.string.download_wizard_diagnostics_last_http_response))
+            ret.appendLine()
+            ret.appendLine(resp.data.decodeToString(throwOnInvalidSequence = false))
+        }
+
+        ret.toString()
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index c1923f598..e4d443771 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -65,7 +65,12 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
     override val hasPrev: Boolean
         get() = false
 
-    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
+    override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? =
+        if (state.downloadError != null) {
+            DownloadWizardDiagnosticsFragment()
+        } else {
+            null
+        }
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
@@ -116,6 +121,9 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                             adapter.notifyItemChanged(index)
                         }
 
+                        state.downloadError =
+                            it.error as? EuiccChannelManagerService.ProfileDownloadException
+
                         isDone = true
                         refreshButtons()
                     }
diff --git a/app-common/src/main/res/layout/fragment_download_diagnostics.xml b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
new file mode 100644
index 000000000..b9a0bc250
--- /dev/null
+++ b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:fillViewport="true">
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <TextView
+            android:id="@+id/download_wizard_diagnostics_title"
+            android:text="@string/download_wizard_diagnostics"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:gravity="center_horizontal"
+            android:textSize="20sp"
+            android:layout_marginTop="20sp"
+            android:layout_marginBottom="20sp"
+            android:layout_marginStart="60sp"
+            android:layout_marginEnd="60sp"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constrainedWidth="true"
+            app:layout_constraintTop_toTopOf="parent" />
+
+        <TextView
+            android:id="@+id/download_wizard_diagnostics_text"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:padding="10dp"
+            android:textIsSelectable="true"
+            android:focusable="true"
+            android:textSize="10sp"
+            android:fontFamily="monospace"
+            android:lineSpacingMultiplier="1.1"
+            android:longClickable="true"
+            app:layout_constraintTop_toBottomOf="@id/download_wizard_diagnostics_title"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintBottom_toBottomOf="parent"
+            tools:ignore="SmallSp" />
+
+    </androidx.constraintlayout.widget.ConstraintLayout>
+
+</ScrollView>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index e42bf0494..e8ffb808a 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -81,6 +81,9 @@
     <string name="download_wizard_progress_step_authenticating">Authenticating your device with server</string>
     <string name="download_wizard_progress_step_downloading">Downloading eSIM profile</string>
     <string name="download_wizard_progress_step_finalizing">Loading eSIM profile into storage</string>
+    <string name="download_wizard_diagnostics">Error diagnostics</string>
+    <string name="download_wizard_diagnostics_last_http_status">Last HTTP status: %d</string>
+    <string name="download_wizard_diagnostics_last_http_response">Last HTTP response:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 74d7da35dce724a6cdfba9c994cb748e1ed80218 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 17:29:51 -0500
Subject: [PATCH 254/458] ui: wizard: Quick and dirty JSON pretty-printer

---
 .../DownloadWizardDiagnosticsFragment.kt      | 11 ++-
 .../im/angry/openeuicc/util/StringUtils.kt    | 67 ++++++++++++++++++-
 2 files changed, 76 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index f077dc91b..b334ab971 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -6,6 +6,7 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
 
 class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
     override val hasNext: Boolean
@@ -59,7 +60,15 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
 
             ret.appendLine(getString(R.string.download_wizard_diagnostics_last_http_response))
             ret.appendLine()
-            ret.appendLine(resp.data.decodeToString(throwOnInvalidSequence = false))
+
+            val str = resp.data.decodeToString(throwOnInvalidSequence = false)
+            ret.appendLine(
+                if (str.startsWith('{')) {
+                    str.prettyPrintJson()
+                } else {
+                    str
+                }
+            )
         }
 
         ret.toString()
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index ebf872984..44c782583 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -27,4 +27,69 @@ fun formatFreeSpace(size: Int): String =
         "%.2f KiB".format(size.toDouble() / 1024)
     } else {
         "$size B"
-    }
\ No newline at end of file
+    }
+
+fun String.prettyPrintJson(): String {
+    val ret = StringBuilder()
+    var inQuotes = false
+    var escaped = false
+    val indentSymbolStack = ArrayDeque<Char>()
+
+    val addNewLine = {
+        ret.append('\n')
+        repeat(indentSymbolStack.size) {
+            ret.append('\t')
+        }
+    }
+
+    var lastChar = ' '
+
+    for (c in this) {
+        when {
+            !inQuotes && (c == '{' || c == '[') -> {
+                ret.append(c)
+                indentSymbolStack.addLast(c)
+                addNewLine()
+            }
+
+            !inQuotes && (c == '}' || c == ']') -> {
+                indentSymbolStack.removeLast()
+                if (lastChar != ',') {
+                    addNewLine()
+                }
+                ret.append(c)
+            }
+
+            !inQuotes && c == ',' -> {
+                ret.append(c)
+                addNewLine()
+            }
+
+            !inQuotes && c == ':' -> {
+                ret.append(c)
+                ret.append(' ')
+            }
+
+            inQuotes && c == '\\' -> {
+                ret.append(c)
+                escaped = true
+                continue
+            }
+
+            !escaped && c == '"' -> {
+                ret.append(c)
+                inQuotes = !inQuotes
+            }
+
+            else -> ret.append(c)
+        }
+
+        if (escaped) {
+            escaped = false
+        }
+
+        lastChar = c
+    }
+
+    return ret.toString()
+}
\ No newline at end of file

From 426e5c0197ef156f19d878a8f14fc665c09eb85a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 17:45:11 -0500
Subject: [PATCH 255/458] util: Ignore spaces in JSON string

---
 .../src/main/java/im/angry/openeuicc/util/StringUtils.kt     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index 44c782583..8d724620f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -81,6 +81,11 @@ fun String.prettyPrintJson(): String {
                 inQuotes = !inQuotes
             }
 
+            !inQuotes && c == ' ' -> {
+                // Do nothing -- we ignore spaces outside of quotes by default
+                // This is to ensure predictable formatting
+            }
+
             else -> ret.append(c)
         }
 

From 5476e335b19fc19e4a40982a7429b1759ff7755d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:20:47 -0500
Subject: [PATCH 256/458] Move ProfileDownloadException to LPA

---
 .../openeuicc/core/LocalProfileAssistantWrapper.kt  |  6 +-----
 .../openeuicc/service/EuiccChannelManagerService.kt | 13 +------------
 .../openeuicc/ui/wizard/DownloadWizardActivity.kt   |  4 ++--
 .../ui/wizard/DownloadWizardProgressFragment.kt     |  3 ++-
 .../net/typeblog/lpac_jni/LocalProfileAssistant.kt  |  7 +++++--
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt      | 13 +++++++------
 6 files changed, 18 insertions(+), 28 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index d07438f67..22ece46d5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -1,7 +1,6 @@
 package im.angry.openeuicc.core
 
 import net.typeblog.lpac_jni.EuiccInfo2
-import net.typeblog.lpac_jni.HttpInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
@@ -20,9 +19,6 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
             return _inner!!
         }
 
-    override val lastHttpResponse: HttpInterface.HttpResponse?
-        get() = lpa.lastHttpResponse
-
     override val valid: Boolean
         get() = lpa.valid
     override val profiles: List<LocalProfileInfo>
@@ -50,7 +46,7 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
         imei: String?,
         confirmationCode: String?,
         callback: ProfileDownloadCallback
-    ): Boolean = lpa.downloadProfile(smdp, matchingId, imei, confirmationCode, callback)
+    ) = lpa.downloadProfile(smdp, matchingId, imei, confirmationCode, callback)
 
     override fun deleteNotification(seqNumber: Long): Boolean = lpa.deleteNotification(seqNumber)
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 6a995c836..c4d16df7f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -35,7 +35,6 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.withTimeoutOrNull
 import kotlinx.coroutines.yield
-import net.typeblog.lpac_jni.HttpInterface
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 /**
@@ -371,10 +370,6 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             .collect()
     }
 
-    data class ProfileDownloadException(
-        val lastHttpResponse: HttpInterface.HttpResponse?
-    ) : Exception("Failed to download profile")
-
     fun launchProfileDownloadTask(
         slotId: Int,
         portId: Int,
@@ -390,7 +385,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
                 euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
-                    val res = channel.lpa.downloadProfile(
+                    channel.lpa.downloadProfile(
                         smdp,
                         matchingId,
                         imei,
@@ -402,12 +397,6 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                                     ForegroundTaskState.InProgress(state.progress)
                             }
                         })
-
-                    if (!res) {
-                        throw ProfileDownloadException(
-                            channel.lpa.lastHttpResponse
-                        )
-                    }
                 }
 
                 preferenceRepository.notificationDownloadFlow.first()
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 6a1c1163c..6d810cf57 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -11,9 +11,9 @@ import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import im.angry.openeuicc.util.*
+import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
     data class DownloadWizardState(
@@ -25,7 +25,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var imei: String?,
         var downloadStarted: Boolean,
         var downloadTaskID: Long,
-        var downloadError: EuiccChannelManagerService.ProfileDownloadException?,
+        var downloadError: LocalProfileAssistant.ProfileDownloadException?,
     )
 
     private lateinit var state: DownloadWizardState
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index e4d443771..f6f63fd6c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -17,6 +17,7 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
+import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
@@ -122,7 +123,7 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                         }
 
                         state.downloadError =
-                            it.error as? EuiccChannelManagerService.ProfileDownloadException
+                            it.error as? LocalProfileAssistant.ProfileDownloadException
 
                         isDone = true
                         refreshButtons()
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index ed7ae6e5c..e5d7b20b9 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -3,13 +3,16 @@ package net.typeblog.lpac_jni
 import net.typeblog.lpac_jni.HttpInterface.HttpResponse
 
 interface LocalProfileAssistant {
+    data class ProfileDownloadException(
+        val lastHttpResponse: HttpResponse?
+    ) : Exception("Failed to download profile")
+
     val valid: Boolean
     val profiles: List<LocalProfileInfo>
     val notifications: List<LocalProfileNotification>
     val eID: String
     // Extended EuiccInfo for use with LUIs, containing information such as firmware version
     val euiccInfo2: EuiccInfo2?
-    val lastHttpResponse: HttpResponse?
 
     /**
      * Set the max segment size (mss) for all es10x commands. This can help with removable
@@ -25,7 +28,7 @@ interface LocalProfileAssistant {
     fun deleteProfile(iccid: String): Boolean
 
     fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
-                        confirmationCode: String?, callback: ProfileDownloadCallback): Boolean
+                        confirmationCode: String?, callback: ProfileDownloadCallback)
 
     fun deleteNotification(seqNumber: Long): Boolean
     fun handleNotification(seqNumber: Long): Boolean
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 6b8497d06..3cacc3d5f 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -34,9 +34,6 @@ class LocalProfileAssistantImpl(
         LpacJni.euiccSetMss(contextHandle, mss)
     }
 
-    override val lastHttpResponse: HttpInterface.HttpResponse?
-        get() = httpInterface.lastHttpResponse
-
     override val valid: Boolean
         get() = !finalized && apduInterface.valid && try {
             // If we can read both eID and euiccInfo2 properly, we are likely looking at
@@ -147,15 +144,19 @@ class LocalProfileAssistantImpl(
 
     @Synchronized
     override fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
-                                 confirmationCode: String?, callback: ProfileDownloadCallback): Boolean {
-        return LpacJni.downloadProfile(
+                                 confirmationCode: String?, callback: ProfileDownloadCallback) {
+        val res = LpacJni.downloadProfile(
             contextHandle,
             smdp,
             matchingId,
             imei,
             confirmationCode,
             callback
-        ) == 0
+        )
+
+        if (res != 0) {
+            throw LocalProfileAssistant.ProfileDownloadException(httpInterface.lastHttpResponse)
+        }
     }
 
     @Synchronized

From 26d037048d96e3a0bb9dd4c7eadb40f427c0d605 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:26:47 -0500
Subject: [PATCH 257/458] ui: wizard: Show HTTP exception in diagnostics

---
 .../ui/wizard/DownloadWizardDiagnosticsFragment.kt     | 10 ++++++++++
 app-common/src/main/res/values/strings.xml             |  1 +
 .../main/java/net/typeblog/lpac_jni/HttpInterface.kt   |  5 +++++
 .../net/typeblog/lpac_jni/LocalProfileAssistant.kt     |  3 ++-
 .../net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt    |  6 ++++++
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt         |  5 ++++-
 6 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index b334ab971..a87061922 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -69,6 +69,16 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
                     str
                 }
             )
+
+            ret.appendLine()
+        }
+
+        err.lastHttpException?.let { e ->
+            ret.appendLine(getString(R.string.download_wizard_diagnostics_last_http_exception))
+            ret.appendLine()
+            ret.appendLine("${e.javaClass.name}: ${e.message}")
+            ret.appendLine(e.stackTrace.joinToString("\n"))
+            ret.appendLine()
         }
 
         ret.toString()
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index e8ffb808a..90062dad1 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -84,6 +84,7 @@
     <string name="download_wizard_diagnostics">Error diagnostics</string>
     <string name="download_wizard_diagnostics_last_http_status">Last HTTP status: %d</string>
     <string name="download_wizard_diagnostics_last_http_response">Last HTTP response:</string>
+    <string name="download_wizard_diagnostics_last_http_exception">Last HTTP exception:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
index 53b9c4f22..7a4110227 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
@@ -35,6 +35,11 @@ interface HttpInterface {
      */
     val lastHttpResponse: HttpResponse?
 
+    /**
+     * The last exception that has been thrown during a HTTP connection
+     */
+    val lastHttpException: Exception?
+
     fun transmit(url: String, tx: ByteArray, headers: Array<String>): HttpResponse
     // The LPA is supposed to pass in a list of pkIds supported by the eUICC.
     // HttpInterface is responsible for providing TrustManager implementations that
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index e5d7b20b9..c78f5f2d6 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -4,7 +4,8 @@ import net.typeblog.lpac_jni.HttpInterface.HttpResponse
 
 interface LocalProfileAssistant {
     data class ProfileDownloadException(
-        val lastHttpResponse: HttpResponse?
+        val lastHttpResponse: HttpResponse?,
+        val lastHttpException: Exception?,
     ) : Exception("Failed to download profile")
 
     val valid: Boolean
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 68781bfd1..7c251b735 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -24,6 +24,7 @@ class HttpInterfaceImpl(
     private lateinit var trustManagers: Array<TrustManager>
 
     override var lastHttpResponse: HttpInterface.HttpResponse? = null
+    override var lastHttpException: Exception? = null
 
     override fun transmit(
         url: String,
@@ -80,6 +81,11 @@ class HttpInterfaceImpl(
             }
         } catch (e: Exception) {
             e.printStackTrace()
+
+            // Reset response to null because there's no response here
+            lastHttpResponse = null
+            lastHttpException = e
+
             throw e
         }
     }
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 3cacc3d5f..b568ce192 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -155,7 +155,10 @@ class LocalProfileAssistantImpl(
         )
 
         if (res != 0) {
-            throw LocalProfileAssistant.ProfileDownloadException(httpInterface.lastHttpResponse)
+            throw LocalProfileAssistant.ProfileDownloadException(
+                httpInterface.lastHttpResponse,
+                httpInterface.lastHttpException
+            )
         }
     }
 

From 326b39ed05ac221825e7191638643fe6667b054d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:43:42 -0500
Subject: [PATCH 258/458] ui: wizard: Add APDU errors to diagnostics

---
 .../DownloadWizardDiagnosticsFragment.kt      | 27 ++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  4 +++
 .../lpac_jni/LocalProfileAssistant.kt         |  3 ++
 .../impl/LocalProfileAssistantImpl.kt         | 28 +++++++++++++++++--
 4 files changed, 60 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index a87061922..a820f0533 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -81,6 +81,33 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
             ret.appendLine()
         }
 
+        err.lastApduResponse?.let { resp ->
+            ret.appendLine(
+                getString(
+                    R.string.download_wizard_diagnostics_last_apdu_response,
+                    resp.encodeHex()
+                )
+            )
+            ret.appendLine()
+
+            val isSuccess =
+                resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
+
+            if (isSuccess) {
+                ret.appendLine(getString(R.string.download_wizard_diagnostics_last_apdu_response_success))
+            } else {
+                ret.appendLine(getString(R.string.download_wizard_diagnostics_last_apdu_response_fail))
+            }
+        }
+
+        err.lastApduException?.let { e ->
+            ret.appendLine(getString(R.string.download_wizard_diagnostics_last_apdu_exception))
+            ret.appendLine()
+            ret.appendLine("${e.javaClass.name}: ${e.message}")
+            ret.appendLine(e.stackTrace.joinToString("\n"))
+            ret.appendLine()
+        }
+
         ret.toString()
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 90062dad1..8d003c0bd 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -85,6 +85,10 @@
     <string name="download_wizard_diagnostics_last_http_status">Last HTTP status: %d</string>
     <string name="download_wizard_diagnostics_last_http_response">Last HTTP response:</string>
     <string name="download_wizard_diagnostics_last_http_exception">Last HTTP exception:</string>
+    <string name="download_wizard_diagnostics_last_apdu_response">Last APDU response: %s</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_success">Last APDU response is successful</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_fail">Last APDU response is a failure</string>
+    <string name="download_wizard_diagnostics_last_apdu_exception">Last APDU exception:</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index c78f5f2d6..cf870e11f 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -3,9 +3,12 @@ package net.typeblog.lpac_jni
 import net.typeblog.lpac_jni.HttpInterface.HttpResponse
 
 interface LocalProfileAssistant {
+    @Suppress("ArrayInDataClass")
     data class ProfileDownloadException(
         val lastHttpResponse: HttpResponse?,
         val lastHttpException: Exception?,
+        val lastApduResponse: ByteArray?,
+        val lastApduException: Exception?,
     ) : Exception("Failed to download profile")
 
     val valid: Boolean
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index b568ce192..d4061a33f 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -11,13 +11,35 @@ import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
-    private val apduInterface: ApduInterface,
+    rawApduInterface: ApduInterface,
     private val httpInterface: HttpInterface
 ): LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
     }
 
+    /**
+     * A thin wrapper over ApduInterface to acquire exceptions and errors transparently
+     */
+    private class ApduInterfaceWrapper(val apduInterface: ApduInterface) :
+        ApduInterface by apduInterface {
+        var lastApduResponse: ByteArray? = null
+        var lastApduException: Exception? = null
+
+        override fun transmit(tx: ByteArray): ByteArray =
+            try {
+                apduInterface.transmit(tx).also {
+                    lastApduResponse = it
+                }
+            } catch (e: Exception) {
+                lastApduResponse = null
+                lastApduException = e
+                throw e
+            }
+    }
+
+    private val apduInterface = ApduInterfaceWrapper(rawApduInterface)
+
     private var finalized = false
     private var contextHandle: Long = LpacJni.createContext(apduInterface, httpInterface)
 
@@ -157,7 +179,9 @@ class LocalProfileAssistantImpl(
         if (res != 0) {
             throw LocalProfileAssistant.ProfileDownloadException(
                 httpInterface.lastHttpResponse,
-                httpInterface.lastHttpException
+                httpInterface.lastHttpException,
+                apduInterface.lastApduResponse,
+                apduInterface.lastApduException,
             )
         }
     }

From d7214141e681350c4d61809c3945343769775f53 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:45:05 -0500
Subject: [PATCH 259/458] ui: wizard: Only show full APDU response when it is a
 failure

---
 .../DownloadWizardDiagnosticsFragment.kt       | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index a820f0533..6c578ddee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -82,20 +82,22 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
         }
 
         err.lastApduResponse?.let { resp ->
-            ret.appendLine(
-                getString(
-                    R.string.download_wizard_diagnostics_last_apdu_response,
-                    resp.encodeHex()
-                )
-            )
-            ret.appendLine()
-
             val isSuccess =
                 resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
 
             if (isSuccess) {
                 ret.appendLine(getString(R.string.download_wizard_diagnostics_last_apdu_response_success))
             } else {
+                // Only show the full APDU response when it's a failure
+                // Otherwise it's going to get very crammed
+                ret.appendLine(
+                    getString(
+                        R.string.download_wizard_diagnostics_last_apdu_response,
+                        resp.encodeHex()
+                    )
+                )
+                ret.appendLine()
+
                 ret.appendLine(getString(R.string.download_wizard_diagnostics_last_apdu_response_fail))
             }
         }

From 1c4263a47a07d00e2eb8e916c2577f3f0405ad80 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:45:45 -0500
Subject: [PATCH 260/458] ui: wizard: Make clear what HTTP and APDU mean

---
 app-common/src/main/res/values/strings.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 8d003c0bd..a3067dd6a 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -82,12 +82,12 @@
     <string name="download_wizard_progress_step_downloading">Downloading eSIM profile</string>
     <string name="download_wizard_progress_step_finalizing">Loading eSIM profile into storage</string>
     <string name="download_wizard_diagnostics">Error diagnostics</string>
-    <string name="download_wizard_diagnostics_last_http_status">Last HTTP status: %d</string>
-    <string name="download_wizard_diagnostics_last_http_response">Last HTTP response:</string>
+    <string name="download_wizard_diagnostics_last_http_status">Last HTTP status (from server): %d</string>
+    <string name="download_wizard_diagnostics_last_http_response">Last HTTP response (from server):</string>
     <string name="download_wizard_diagnostics_last_http_exception">Last HTTP exception:</string>
-    <string name="download_wizard_diagnostics_last_apdu_response">Last APDU response: %s</string>
-    <string name="download_wizard_diagnostics_last_apdu_response_success">Last APDU response is successful</string>
-    <string name="download_wizard_diagnostics_last_apdu_response_fail">Last APDU response is a failure</string>
+    <string name="download_wizard_diagnostics_last_apdu_response">Last APDU response (from SIM): %s</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_success">Last APDU response (from SIM) is successful</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_fail">Last APDU response (from SIM) is a failure</string>
     <string name="download_wizard_diagnostics_last_apdu_exception">Last APDU exception:</string>
 
     <string name="profile_rename_new_name">New nickname</string>

From dcae65011eaf8f746c6fe43cfa4062fb0d1849f8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:49:47 -0500
Subject: [PATCH 261/458] lpac_jni: Move HTTP diagnostics to LPA

---
 .../net/typeblog/lpac_jni/HttpInterface.kt    | 14 --------
 .../lpac_jni/impl/HttpInterfaceImpl.kt        | 12 +------
 .../impl/LocalProfileAssistantImpl.kt         | 35 ++++++++++++++++++-
 3 files changed, 35 insertions(+), 26 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
index 7a4110227..49d6cc0f1 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/HttpInterface.kt
@@ -26,20 +26,6 @@ interface HttpInterface {
         }
     }
 
-    /**
-     * The last HTTP response we have received from the SM-DP+ server.
-     *
-     * This is intended for error diagnosis. However, note that most SM-DP+ servers
-     * respond with 200 even when there is an error. This needs to be taken into
-     * account when designing UI.
-     */
-    val lastHttpResponse: HttpResponse?
-
-    /**
-     * The last exception that has been thrown during a HTTP connection
-     */
-    val lastHttpException: Exception?
-
     fun transmit(url: String, tx: ByteArray, headers: Array<String>): HttpResponse
     // The LPA is supposed to pass in a list of pkIds supported by the eUICC.
     // HttpInterface is responsible for providing TrustManager implementations that
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 7c251b735..77227f860 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -23,9 +23,6 @@ class HttpInterfaceImpl(
 
     private lateinit var trustManagers: Array<TrustManager>
 
-    override var lastHttpResponse: HttpInterface.HttpResponse? = null
-    override var lastHttpException: Exception? = null
-
     override fun transmit(
         url: String,
         tx: ByteArray,
@@ -76,16 +73,9 @@ class HttpInterfaceImpl(
                 }
             }
 
-            return HttpInterface.HttpResponse(conn.responseCode, bytes).also {
-                lastHttpResponse = it
-            }
+            return HttpInterface.HttpResponse(conn.responseCode, bytes)
         } catch (e: Exception) {
             e.printStackTrace()
-
-            // Reset response to null because there's no response here
-            lastHttpResponse = null
-            lastHttpException = e
-
             throw e
         }
     }
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index d4061a33f..ece19b371 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -5,6 +5,7 @@ import net.typeblog.lpac_jni.LpacJni
 import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.EuiccInfo2
 import net.typeblog.lpac_jni.HttpInterface
+import net.typeblog.lpac_jni.HttpInterface.HttpResponse
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
@@ -12,7 +13,7 @@ import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
     rawApduInterface: ApduInterface,
-    private val httpInterface: HttpInterface
+    rawHttpInterface: HttpInterface
 ): LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
@@ -38,7 +39,39 @@ class LocalProfileAssistantImpl(
             }
     }
 
+    /**
+     * Same for HTTP for diagnostics
+     */
+    private class HttpInterfaceWrapper(val httpInterface: HttpInterface) :
+        HttpInterface by httpInterface {
+        /**
+         * The last HTTP response we have received from the SM-DP+ server.
+         *
+         * This is intended for error diagnosis. However, note that most SM-DP+ servers
+         * respond with 200 even when there is an error. This needs to be taken into
+         * account when designing UI.
+         */
+        var lastHttpResponse: HttpResponse? = null
+
+        /**
+         * The last exception that has been thrown during a HTTP connection
+         */
+        var lastHttpException: Exception? = null
+
+        override fun transmit(url: String, tx: ByteArray, headers: Array<String>): HttpResponse =
+            try {
+                httpInterface.transmit(url, tx, headers).also {
+                    lastHttpResponse = it
+                }
+            } catch (e: Exception) {
+                lastHttpResponse = null
+                lastHttpException = e
+                throw e
+            }
+    }
+
     private val apduInterface = ApduInterfaceWrapper(rawApduInterface)
+    private val httpInterface = HttpInterfaceWrapper(rawHttpInterface)
 
     private var finalized = false
     private var contextHandle: Long = LpacJni.createContext(apduInterface, httpInterface)

From 96bc9865ff8362837f632ac37cc44ca41d66bf80 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 24 Nov 2024 19:50:27 -0500
Subject: [PATCH 262/458] lpac_jni: Clear exceptions before setting response

---
 .../net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index ece19b371..70606d994 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -30,6 +30,7 @@ class LocalProfileAssistantImpl(
         override fun transmit(tx: ByteArray): ByteArray =
             try {
                 apduInterface.transmit(tx).also {
+                    lastApduException = null
                     lastApduResponse = it
                 }
             } catch (e: Exception) {
@@ -61,6 +62,7 @@ class LocalProfileAssistantImpl(
         override fun transmit(url: String, tx: ByteArray, headers: Array<String>): HttpResponse =
             try {
                 httpInterface.transmit(url, tx, headers).also {
+                    lastHttpException = null
                     lastHttpResponse = it
                 }
             } catch (e: Exception) {

From 90878438f90659a46b5aa0e0f72ff21d9ad40d3c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 27 Nov 2024 15:06:32 +0100
Subject: [PATCH 263/458] refactor: gitignore (#69)

Rebuild root dot-gitignore file

Update subdirectory dot-gitignore file

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/69
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .gitignore               | 22 ++++++++++------------
 .idea/.gitignore         | 13 ++++++++-----
 .idea/gradle.xml         | 39 ---------------------------------------
 .idea/misc.xml           | 25 -------------------------
 app-deps/.gitignore      |  3 ++-
 buildSrc/.gitignore      |  2 ++
 libs/lpac-jni/.gitignore |  1 +
 7 files changed, 23 insertions(+), 82 deletions(-)
 delete mode 100644 .idea/gradle.xml
 delete mode 100644 .idea/misc.xml
 create mode 100644 buildSrc/.gitignore
 create mode 100644 libs/lpac-jni/.gitignore

diff --git a/.gitignore b/.gitignore
index 6cc80a056..1aa6f8a2e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,13 +1,11 @@
-*.iml
-.gradle
-/local.properties
-/keystore.properties
-.DS_Store
-/build
+/.gradle
 /captures
-.externalNativeBuild
-.cxx
-local.properties
-/libs/**/build
-/buildSrc/build
-/app-deps/libs
\ No newline at end of file
+
+# Configuration files
+
+/keystore.properties
+/local.properties
+
+# macOS
+
+.DS_Store
diff --git a/.idea/.gitignore b/.idea/.gitignore
index c9924abc4..0d51aca15 100644
--- a/.idea/.gitignore
+++ b/.idea/.gitignore
@@ -1,10 +1,13 @@
-# Default ignored files
 /shelf
 /caches
 /libraries
-/modules.xml
-/workspace.xml
-/navEditor.xml
 /assetWizardSettings.xml
 /deploymentTargetDropDown.xml
-/runConfigurations.xml
\ No newline at end of file
+/gradle.xml
+/misc.xml
+/modules.xml
+/navEditor.xml
+/runConfigurations.xml
+/workspace.xml
+
+**/*.iml
\ No newline at end of file
diff --git a/.idea/gradle.xml b/.idea/gradle.xml
deleted file mode 100644
index 589fc6ca9..000000000
--- a/.idea/gradle.xml
+++ /dev/null
@@ -1,39 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="GradleMigrationSettings" migrationVersion="1" />
-  <component name="GradleSettings">
-    <option name="linkedExternalProjectsSettings">
-      <GradleProjectSettings>
-        <compositeConfiguration>
-          <compositeBuild compositeDefinitionSource="SCRIPT">
-            <builds>
-              <build path="$PROJECT_DIR$/buildSrc" name="buildSrc">
-                <projects>
-                  <project path="$PROJECT_DIR$/buildSrc" />
-                </projects>
-              </build>
-            </builds>
-          </compositeBuild>
-        </compositeConfiguration>
-        <option name="externalProjectPath" value="$PROJECT_DIR$" />
-        <option name="gradleHome" value="/usr/share/java/gradle" />
-        <option name="gradleJvm" value="#GRADLE_LOCAL_JAVA_HOME" />
-        <option name="modules">
-          <set>
-            <option value="$PROJECT_DIR$" />
-            <option value="$PROJECT_DIR$/app" />
-            <option value="$PROJECT_DIR$/app-common" />
-            <option value="$PROJECT_DIR$/app-deps" />
-            <option value="$PROJECT_DIR$/app-unpriv" />
-            <option value="$PROJECT_DIR$/buildSrc" />
-            <option value="$PROJECT_DIR$/libs" />
-            <option value="$PROJECT_DIR$/libs/hidden-apis-shim" />
-            <option value="$PROJECT_DIR$/libs/hidden-apis-stub" />
-            <option value="$PROJECT_DIR$/libs/lpac-jni" />
-          </set>
-        </option>
-        <option name="resolveExternalAnnotations" value="false" />
-      </GradleProjectSettings>
-    </option>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
deleted file mode 100644
index a1f9d9f9c..000000000
--- a/.idea/misc.xml
+++ /dev/null
@@ -1,25 +0,0 @@
-<project version="4">
-  <component name="DesignSurface">
-    <option name="filePathToZoomLevelMap">
-      <map>
-        <entry key="app/src/main/res/drawable/ic_add.xml" value="0.2015" />
-        <entry key="app/src/main/res/layout/activity_main.xml" value="0.19375" />
-        <entry key="app/src/main/res/layout/euicc_profile.xml" value="0.19375" />
-        <entry key="app/src/main/res/layout/fragment_euicc.xml" value="0.19375" />
-        <entry key="app/src/main/res/layout/fragment_profile_download.xml" value="0.19375" />
-        <entry key="app/src/main/res/layout/fragment_profile_rename.xml" value="0.19375" />
-        <entry key="app/src/main/res/menu/activity_main.xml" value="0.19375" />
-        <entry key="app/src/main/res/menu/activity_main_slot_spinner.xml" value="0.19375" />
-        <entry key="app/src/main/res/menu/fragment_profile_download.xml" value="0.19375" />
-        <entry key="app/src/main/res/menu/fragment_profile_rename.xml" value="0.19375" />
-        <entry key="app/src/main/res/menu/profile_options.xml" value="0.19375" />
-      </map>
-    </option>
-  </component>
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_1_7" project-jdk-name="jbr-17" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/build/classes" />
-  </component>
-  <component name="ProjectType">
-    <option name="id" value="Android" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/app-deps/.gitignore b/app-deps/.gitignore
index 42afabfd2..c23e5a2d8 100644
--- a/app-deps/.gitignore
+++ b/app-deps/.gitignore
@@ -1 +1,2 @@
-/build
\ No newline at end of file
+/build
+/libs
\ No newline at end of file
diff --git a/buildSrc/.gitignore b/buildSrc/.gitignore
new file mode 100644
index 000000000..6fbe8a4ff
--- /dev/null
+++ b/buildSrc/.gitignore
@@ -0,0 +1,2 @@
+/.gradle
+/build
\ No newline at end of file
diff --git a/libs/lpac-jni/.gitignore b/libs/lpac-jni/.gitignore
new file mode 100644
index 000000000..42afabfd2
--- /dev/null
+++ b/libs/lpac-jni/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file

From 92daa56f1ab0da679d4dbf2d18b70447cca24887 Mon Sep 17 00:00:00 2001
From: reindex <reindex@noreply.gitea.angry.im>
Date: Sat, 30 Nov 2024 15:29:09 +0100
Subject: [PATCH 264/458] Add Japanese translate (#71)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/71
Co-authored-by: reindex <reindex@noreply.gitea.angry.im>
Co-committed-by: reindex <reindex@noreply.gitea.angry.im>
---
 app-common/src/main/res/values-ja/strings.xml | 139 ++++++++++++++++++
 app-unpriv/src/main/res/values-ja/strings.xml |  34 +++++
 app/src/main/res/values-ja/strings.xml        |  21 +++
 3 files changed, 194 insertions(+)
 create mode 100644 app-common/src/main/res/values-ja/strings.xml
 create mode 100644 app-unpriv/src/main/res/values-ja/strings.xml
 create mode 100644 app/src/main/res/values-ja/strings.xml

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
new file mode 100644
index 000000000..72b88a831
--- /dev/null
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="no_euicc">このアプリでアクセスできるリムーバブル eUICC カードがデバイス上で検出されていません。互換性のあるカード挿入または USB リーダーを接続してください。</string>
+    <string name="no_profile">この eSIM にはプロファイルがありません。</string>
+    <string name="unknown">不明</string>
+    <string name="help">ヘルプ</string>
+    <string name="reload">スロットを再読み込み</string>
+    <string name="channel_name_format">論理スロット %d</string>
+    <string name="usb">USB</string>
+    <string name="omapi">OpenMobile API (OMAPI)</string>
+    <string name="enabled">有効済み</string>
+    <string name="disabled">無効済み</string>
+    <string name="provider">プロバイダー:</string>
+    <string name="iccid">ICCID:</string>
+    <string name="enable">有効化</string>
+    <string name="disable">無効化</string>
+    <string name="delete">削除</string>
+    <string name="rename">名前を変更</string>
+    <string name="enable_disable_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
+    <string name="switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
+    <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
+    <string name="toast_profile_name_too_long">ニックネームは 64 文字以内にしてください</string>
+    <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
+    <string name="slot_select">スロットを選択</string>
+    <string name="slot_select_select">選択</string>
+    <string name="usb_permission">USB の権限を許可</string>
+    <string name="usb_permission_needed">USB スマートカードリーダーにアクセスするには許可が必要です。</string>
+    <string name="usb_failed">USB スマートカードリーダー経由で eSIM に接続できません。</string>
+    <string name="task_notification">長時間実行されるタスク</string>
+    <string name="task_profile_download">eSIM プロファイルをダウンロード中です</string>
+    <string name="task_profile_download_failure">eSIM プロファイルのダウンロードに失敗しました</string>
+    <string name="task_profile_rename">eSIM プロファイルの名前を変更中です</string>
+    <string name="task_profile_rename_failure">eSIM プロファイルの名前の変更に失敗しました</string>
+    <string name="task_profile_delete">eSIM プロファイルを削除中です</string>
+    <string name="task_profile_delete_failure">eSIM プロファイルの削除に失敗しました</string>
+    <string name="task_profile_switch">eSIM プロファイルを切り替え中</string>
+    <string name="task_profile_switch_failure">eSIM プロファイルの切り替えに失敗しました</string>
+    <string name="profile_download">新しい eSIM</string>
+    <string name="profile_download_server">サーバー (RSP / SM-DP+)</string>
+    <string name="profile_download_code">アクティベーションコード</string>
+    <string name="profile_download_confirmation_code">確認コード (オプション)</string>
+    <string name="profile_download_imei">IMEI (オプション)</string>
+    <string name="profile_download_free_space">残りの容量: %s</string>
+    <string name="profile_download_scan">QR コードをスキャン</string>
+    <string name="profile_download_scan_from_gallery">ギャラリーから QR コードをスキャン</string>
+    <string name="profile_download_ok">ダウンロード</string>
+    <string name="profile_download_failed">eSIM のダウンロードに失敗しました。アクティベーションまたは QR コードを確認してください。</string>
+    <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
+    <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
+    <string name="download_wizard">ダウンロードウィザード</string>
+    <string name="download_wizard_back">戻る</string>
+    <string name="download_wizard_next">次へ</string>
+    <string name="download_wizard_slot_select">ダウンロードする eSIM を選択または確認:</string>
+    <string name="download_wizard_slot_title">論理スロット %d</string>
+    <string name="download_wizard_slot_type">タイプ:</string>
+    <string name="download_wizard_slot_type_removable">リムーバブル</string>
+    <string name="download_wizard_slot_type_internal">内部</string>
+    <string name="download_wizard_slot_type_internal_port">内部 - ポート: %d</string>
+    <string name="download_wizard_slot_eid">eID:</string>
+    <string name="download_wizard_slot_active_profile">有効なプロファイル:</string>
+    <string name="download_wizard_slot_free_space">空き容量:</string>
+    <string name="download_wizard_method_select">eSIM プロファイルをどの方法でダウンロードしますか？</string>
+    <string name="download_wizard_method_qr_code">カメラで QR コードをスキャン</string>
+    <string name="download_wizard_method_gallery">ギャラリーから QR コードをスキャン</string>
+    <string name="download_wizard_method_manual">手動で入力</string>
+    <string name="download_wizard_details">eSIM をダウンロードするための詳細情報を入力または確認:</string>
+    <string name="download_wizard_progress">eSIM をダウンロード中です…</string>
+    <string name="download_wizard_progress_step_preparing">準備中</string>
+    <string name="download_wizard_progress_step_connecting">サーバーへの接続を確立しています</string>
+    <string name="download_wizard_progress_step_authenticating">サーバーでデバイスを認証中です</string>
+    <string name="download_wizard_progress_step_downloading">eSIM プロファイルをダウンロード中です</string>
+    <string name="download_wizard_progress_step_finalizing">eSIM プロファイルをストレージに読み込み中です</string>
+    <string name="download_wizard_diagnostics">エラー診断</string>
+    <string name="download_wizard_diagnostics_last_http_status">最終の HTTP ステータス (サーバー): %d</string>
+    <string name="download_wizard_diagnostics_last_http_response">最終の HTTP レスポンス (サーバー):</string>
+    <string name="download_wizard_diagnostics_last_http_exception">最終の HTTP 例外:</string>
+    <string name="download_wizard_diagnostics_last_apdu_response">最終の APDU レスポンス (SIM): %s</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_success">最終の APDU レスポンス (SIM) は成功しました</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_fail">最終の APDU レスポンス (SIM) は失敗しました</string>
+    <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
+    <string name="profile_rename_new_name">新しいニックネーム</string>
+    <string name="profile_delete_confirm">%s のプロファイルを削除してもよろしいですか？この操作は元に戻せません。</string>
+    <string name="profile_delete_confirm_input">削除を確認するには「%s」を入力してください</string>
+    <string name="profile_notifications">通知</string>
+    <string name="profile_notifications_detailed_format">通知 (%s)</string>
+    <string name="profile_notifications_show">通知の管理</string>
+    <string name="profile_notifications_help">eSIM プロファイルはダウンロードや削除、有効化や無効化されたときに通信事業者に通知を送信できます。送信されるこれらの通知のキューはここにリストされます。\n\n設定では、各タイプの通知を自動的に送信するかどうかを指定できます。通知が送信された場合でもキューのスペースが不足していない限り、記録から自動的に削除されることはありません。\n\nここでは保留中の各通知を手動で送信または削除できます。</string>
+    <string name="profile_notification_operation_download">ダウンロードしました</string>
+    <string name="profile_notification_operation_delete">削除しました</string>
+    <string name="profile_notification_operation_enable">有効化しました</string>
+    <string name="profile_notification_operation_disable">無効化しました</string>
+    <string name="profile_notification_name_format">&lt;b&gt;%1$s&lt;/b&gt; %2$s (%3$s)</string>
+    <string name="profile_notification_process">処理</string>
+    <string name="profile_notification_delete">削除</string>
+    <string name="euicc_info">eUICC 情報</string>
+    <string name="euicc_info_activity_title">eUICC 情報 (%s)</string>
+    <string name="euicc_info_access_mode">アクセスモード</string>
+    <string name="euicc_info_removable">リムーバブル</string>
+    <string name="euicc_info_eid">EID</string>
+    <string name="euicc_info_firmware_version">eUICC OS のバージョン</string>
+    <string name="euicc_info_globalplatform_version">グローバルプラットフォームのバージョン</string>
+    <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
+    <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
+    <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
+    <string name="euicc_info_gsma_prod">GSMA プロダクション証明書</string>
+    <string name="euicc_info_gsma_test">GSMA テスト証明書</string>
+    <string name="supported">対応</string>
+    <string name="unsupported">非対応</string>
+    <string name="yes">はい</string>
+    <string name="no">いいえ</string>
+    <string name="logs_save">保存</string>
+    <string name="logs_filename_template">%s のログ</string>
+    <string name="developer_options_steps">開発者になるまであと %d ステップです。</string>
+    <string name="developer_options_enabled">あなたは開発者になりました！</string>
+    <string name="pref_settings">設定</string>
+    <string name="pref_notifications">通知</string>
+    <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。必要に応じてこの動作を微調整できます。</string>
+    <string name="pref_notifications_download">ダウンロード</string>
+    <string name="pref_notifications_download_desc">プロファイルを<i>ダウンロード中</i>の通知を送信します</string>
+    <string name="pref_notifications_delete">削除</string>
+    <string name="pref_notifications_delete_desc">プロファイルを<i>削除中</i>の通知を送信します</string>
+    <string name="pref_notifications_switch">切り替え中</string>
+    <string name="pref_notifications_switch_desc">プロファイルを<i>切り替え中</i>の通知を送信します\nこのタイプの通知は信頼できないことに注意してください。</string>
+    <string name="pref_advanced">高度な設定</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">有効なプロファイルの無効化と削除を許可する</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">デフォルトでは、このアプリでデバイスに挿入された取り外し可能な eSIM の有効なプロファイルを無効化することを防いでいます。なぜなのかというと<i>時々</i>アクセスができなくなるからです。\nこのチェックボックスを ON にすることで、この保護機能を<i>解除</i>します。</string>
+    <string name="pref_advanced_verbose_logging">詳細ログ</string>
+    <string name="pref_advanced_verbose_logging_desc">詳細ログを有効化します。これには個人的な情報が含まれている可能性があります。この機能を ON にした後は、信頼できるユーザーとのみログを共有してください。</string>
+    <string name="pref_advanced_logs">ログ</string>
+    <string name="pref_advanced_logs_desc">アプリの最新デバッグログを表示します</string>
+    <string name="pref_developer">開発者オプション</string>
+    <string name="pref_developer_experimental_download_wizard">実験的なダウンロードウィザード</string>
+    <string name="pref_developer_experimental_download_wizard_desc">実験的な新しいダウンロードウィザードを有効化します。まだ完全に機能していないことにご注意ください。</string>
+    <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">SM-DP+ TLS 証明書を無視して任意の RSP を許可します</string>
+    <string name="pref_info">情報</string>
+    <string name="pref_info_app_version">アプリバージョン</string>
+    <string name="pref_info_source_code">ソースコード</string>
+</resources>
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
new file mode 100644
index 000000000..003b244e7
--- /dev/null
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="channel_name_format">SIM %d</string>
+    <string name="compatibility_check">互換性のチェック</string>
+    <string name="open_sim_toolkit">SIM ツールキットを開く</string>
+    <!-- Compatibility Check Descriptions -->
+    <string name="compatibility_check_system_features">システムの機能</string>
+    <string name="compatibility_check_system_features_desc">デバイスにリムーバブル eUICC カードの管理に必要なすべての機能が備わっているかどうか。例えば基本的な電話機能や OMAPI のサポートなど。</string>
+    <string name="compatibility_check_system_features_no_telephony">使用しているデバイスには電話機能がありません。</string>
+    <string name="compatibility_check_system_features_no_omapi">使用しているデバイスまたはシステムには OMAPI のサポートを宣言していません。これは、ハードウェアからのサポートが不足していることが原因の可能性があります。または、フラグが不足していることが原因の可能性もあります。OMAPI が実際にサポートされているかどうかを判断するには次の 2 つのチェック項目を参照してください。</string>
+    <string name="compatibility_check_omapi_connectivity">OMAPI の接続</string>
+    <string name="compatibility_check_omapi_connectivity_desc">使用しているデバイスは、OMAPI 経由で SIM カード上のセキュアエレメントへのアクセスを許可していますか？</string>
+    <string name="compatibility_check_omapi_connectivity_fail">OMAPI 経由で SIM カードのセキュアエレメントリーダーを検出できません。このデバイスに SIM を挿入していない場合は、SIM を挿入後にこのチェックを再試行してください。</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">セキュアエレメントアクセスが正常に検出されましたが、次の SIM スロットでのみ有効です: <b>SIM%s</b>.</string>
+    <string name="compatibility_check_isdr_channel">ISD-R チャネルアクセス</string>
+    <string name="compatibility_check_isdr_channel_desc">使用しているデバイスは、OMAPI 経由で eSIM への ISD-R (管理) チャネルを開くことをサポートしていますか？</string>
+    <string name="compatibility_check_isdr_channel_desc_unknown">OMAPI 経由での ISD-R アクセスがサポートされているかどうかを確認できません。まだ SIM カードが挿入されていない場合は、挿入した状態で再試行してください (どの SIM カードでも構いません)。</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">ISD-R への OMAPI アクセスは、次のスロットでのみ可能です: <b>SIM%s</b>.</string>
+    <string name="compatibility_check_known_broken">既知の破損リストに掲載されていない</string>
+    <string name="compatibility_check_known_broken_desc">取り外し可能な eSIM に関連するバグがデバイスに存在しないかを確認します。</string>
+    <string name="compatibility_check_known_broken_fail">おっと...使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
+    <string name="compatibility_check_usb">USB カードリーダーのサポート</string>
+    <string name="compatibility_check_usb_desc">使用しているデバイスは、USB カードリーダー経由の eSIM の管理をサポートしていますか？</string>
+    <string name="compatibility_check_usb_ok">このデバイスの標準 USB CCID リーダーを介して eSIM を管理できます (ここで他のチェック項目に失敗した場合でも)。カードリーダーを挿入し、このアプリを開いてこの方法で eSIM を管理できます。</string>
+    <string name="compatibility_check_usb_fail">使用しているデバイスは USB ホストとしての機能をサポートしていません。</string>
+    <string name="compatibility_check_verdict">判定 (USB 以外)</string>
+    <string name="compatibility_check_verdict_desc">これまでのすべてのチェック項目に基づいて、デバイスに挿入された取り外し可能な eSIM の管理と互換性がある可能性はどのくらいありますか？</string>
+    <string name="compatibility_check_verdict_ok">このデバイスに挿入された取り外し可能な eSIM の使用および管理が使用できる可能性があります。</string>
+    <string name="compatibility_check_verdict_known_broken">挿入された取り外し可能な eSIM にアクセスするとデバイスにバグが発生することが知られています。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_ok">挿入された取り外し可能な eSIM が使用しているデバイスで管理できるかはわかりません。ただし、このデバイスは OMAPI のサポートを宣言しているため、動作する可能性はわずかに高くなります。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_fail">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかは判断できません。デバイスが OMAPI のサポートを宣言していないため、このデバイス上で取り外し可能な eSIM を管理することはサポートされていない可能性があります。\n%s</string>
+    <string name="compatibility_check_verdict_unknown">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかを確認できません。\n%s</string>
+    <string name="compatibility_check_verdict_fail_shared">ただし、eSIM プロファイルがすでに読み込まれている場合、有効化されたプロファイル自体は引き続き機能します。また、プロファイルが管理できない場合は、このデバイスで USB カードリーダーを介してプロファイルを管理できる可能性があります。</string>
+</resources>
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
new file mode 100644
index 000000000..add6e9331
--- /dev/null
+++ b/app/src/main/res/values-ja/strings.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">OpenEUICC</string>
+    <string name="no_euicc">このデバイスで eUICC が見つかりません。\nデバイスによってはアプリのメニューからデュアル SIM を有効化する必要があります。</string>
+    <string name="telephony_manager">TelephonyManager (特権)</string>
+    <string name="dsds">デュアル SIM</string>
+    <string name="toast_dsds_switched">DSDS の状態が切り替わりました。モデムが再起動するまでお待ちください。</string>
+    <string name="footer_mep">このスロットは MEP (Multiple Enabled Profiles) をサポートしています。この機能を有効化または無効化するには「スロットマッピングツール」を使用してください。</string>
+    <string name="slot_mapping">スロットマッピング</string>
+    <string name="slot_mapping_logical_slot">論理スロット %d:</string>
+    <string name="slot_mapping_port">スロット %1$d ポート %2$d</string>
+    <string name="slot_mapping_help">使用しているデバイスは、%1$d 個の論理 SIM スロットと %2$d 個の物理 SIM スロットがあります。%3$s\n\n各論理スロットに対応する物理スロットまたはポートを選択してください。すべてのマッピングモードがハードウェアでサポートされているわけではないことにご注意ください。</string>
+    <string name="slot_mapping_help_mep">\n\n物理スロット %1$d は、複数の有効なプロファイル (MEP) をサポートしています。この機能を使用するには、%2$d の仮想ポートを上記の異なる論理スロットに割り当てます。\n\nMEP を有効化すると、ポートは共有プロファイルの一覧を除いて OpenEUICC の個別の eSIM スロットのように動作します。</string>
+    <string name="slot_mapping_help_dsds">\nデュアル SIM モードはサポートされていますが、無効化されています。デバイスに内部 eSIM チップが搭載されている場合は、デフォルトで有効化されていない可能性があります。上記のマッピングを変更するか、デュアル SIM を有効化して eSIM にアクセスしてください。</string>
+    <string name="slot_mapping_completed">新しいスロットマッピングが設定されました。モデムがスロットを更新するまでお待ちください。</string>
+    <string name="slot_mapping_failure">指定されたマッピングが無効化されているか、ハードウェアがサポートをしていない可能性があります。</string>
+    <string name="lui_title">eSIM をダウンロードしてモバイルネットワークに接続</string>
+    <string name="lui_desc">使用しているデバイスは eSIM をサポートしています。モバイルネットワークに接続するには通信事業者が発行した eSIM をダウンロードするか、物理 SIM を挿入してください。</string>
+    <string name="lui_skip">スキップ</string>
+    <string name="lui_download">eSIM をダウンロード</string>
+</resources>

From 6bb1a16aeeb57d9e7953452dd643eac695f0c96c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 30 Nov 2024 15:47:54 +0100
Subject: [PATCH 265/458] feat: show unfiltered profile list in developer
 options (#73)

resolves #40 #30

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/73
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/ui/EuiccManagementFragment.kt | 15 ++++++++++++---
 .../im/angry/openeuicc/ui/SettingsFragment.kt     |  5 ++++-
 .../im/angry/openeuicc/util/PreferenceUtils.kt    |  4 ++++
 app-common/src/main/res/values/strings.xml        |  2 ++
 app-common/src/main/res/xml/pref_settings.xml     |  6 ++++++
 .../angry/openeuicc/service/OpenEuiccService.kt   |  8 +++++++-
 6 files changed, 35 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 6ab6935e0..b7462e280 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -65,6 +65,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     // This gives us access to the "latest" state without having to launch coroutines
     private lateinit var disableSafeguardFlow: StateFlow<Boolean>
 
+    private lateinit var unfilteredProfileListFlow: StateFlow<Boolean>
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setHasOptionsMenu(true)
@@ -185,15 +187,22 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         ensureEuiccChannelManager()
         euiccChannelManagerService.waitForForegroundTask()
 
-        if (!this@EuiccManagementFragment::disableSafeguardFlow.isInitialized) {
+        if (!::disableSafeguardFlow.isInitialized) {
             disableSafeguardFlow =
                 preferenceRepository.disableSafeguardFlow.stateIn(lifecycleScope)
         }
+        if (!::unfilteredProfileListFlow.isInitialized) {
+            unfilteredProfileListFlow =
+                preferenceRepository.unfilteredProfileListFlow.stateIn(lifecycleScope)
+        }
 
         val profiles = withEuiccChannel { channel ->
             logicalSlotId = channel.logicalSlotId
             euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
-            channel.lpa.profiles.operational
+            if (unfilteredProfileListFlow.value)
+                channel.lpa.profiles
+            else
+                channel.lpa.profiles.operational
         }
 
         withContext(Dispatchers.Main) {
@@ -302,7 +311,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
             companion object {
                 fun fromInt(value: Int) =
-                    Type.values().first { it.value == value }
+                    entries.first { it.value == value }
             }
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 89963cb55..9c071bd4f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -76,13 +76,16 @@ class SettingsFragment: PreferenceFragmentCompat() {
         findPreference<CheckBoxPreference>("pref_developer_experimental_download_wizard")
             ?.bindBooleanFlow(preferenceRepository.experimentalDownloadWizardFlow, PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD)
 
+        findPreference<CheckBoxPreference>("pref_developer_unfiltered_profile_list")
+            ?.bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow, PreferenceKeys.UNFILTERED_PROFILE_LIST)
+
         findPreference<CheckBoxPreference>("pref_ignore_tls_certificate")
             ?.bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow, PreferenceKeys.IGNORE_TLS_CERTIFICATE)
     }
 
     override fun onStart() {
         super.onStart()
-        setupRootViewInsets(requireView().requireViewById(androidx.preference.R.id.recycler_view))
+        setupRootViewInsets(requireView().requireViewById(R.id.recycler_view))
     }
 
     @Suppress("UNUSED_PARAMETER")
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 505630ee9..ae5e3b8e9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -32,6 +32,7 @@ object PreferenceKeys {
     // ---- Developer Options ----
     val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
     val EXPERIMENTAL_DOWNLOAD_WIZARD = booleanPreferencesKey("experimental_download_wizard")
+    val UNFILTERED_PROFILE_LIST = booleanPreferencesKey("unfiltered_profile_list")
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
 }
 
@@ -63,6 +64,9 @@ class PreferenceRepository(context: Context) {
     val experimentalDownloadWizardFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD] ?: false }
 
+    val unfilteredProfileListFlow: Flow<Boolean> =
+        dataStore.data.map { it[PreferenceKeys.UNFILTERED_PROFILE_LIST] ?: false }
+
     val ignoreTLSCertificateFlow: Flow<Boolean> =
         dataStore.data.map { it[PreferenceKeys.IGNORE_TLS_CERTIFICATE] ?: false }
 
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a3067dd6a..73b193837 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -151,6 +151,8 @@
     <string name="pref_developer">Developer Options</string>
     <string name="pref_developer_experimental_download_wizard">Experimental Download Wizard</string>
     <string name="pref_developer_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
+    <string name="pref_developer_unfiltered_profile_list">Show unfiltered profile list</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">Display any profile class in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
     <string name="pref_developer_ignore_tls_certificate_desc">Ignore SM-DP+ TLS certificate, allow any RSP</string>
     <string name="pref_info">Info</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index d43c84b8e..60646bc5e 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -55,6 +55,12 @@
             app:title="@string/pref_developer_experimental_download_wizard"
             app:summary="@string/pref_developer_experimental_download_wizard_desc" />
 
+        <CheckBoxPreference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_unfiltered_profile_list"
+            app:summary="@string/pref_developer_unfiltered_profile_list_desc"
+            app:title="@string/pref_developer_unfiltered_profile_list" />
+
         <CheckBoxPreference
             app:iconSpaceReserved="false"
             app:key="pref_developer_ignore_tls_certificate"
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index aeda3e489..d62633388 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -13,6 +13,7 @@ import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.delay
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.runBlocking
 import kotlin.IllegalStateException
 
@@ -190,7 +191,12 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 slotId,
                 port
             ) { channel ->
-                val profiles = channel.lpa.profiles.operational.map {
+                val filteredProfiles =
+                    if (runBlocking { preferenceRepository.unfilteredProfileListFlow.first() })
+                        channel.lpa.profiles
+                    else
+                        channel.lpa.profiles.operational
+                val profiles = filteredProfiles.map {
                     EuiccProfileInfo.Builder(it.iccid).apply {
                         setProfileName(it.name)
                         setNickname(it.displayName)

From 50c77ea467ee7352917d5e5b5d62c428cb79b902 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 30 Nov 2024 16:05:44 +0100
Subject: [PATCH 266/458] refactor: preference repository (#74)

reduce template code

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/74
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/util/PreferenceUtils.kt   | 45 ++++++-------------
 1 file changed, 14 insertions(+), 31 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index ae5e3b8e9..807706edc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -36,43 +36,26 @@ object PreferenceKeys {
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
 }
 
-class PreferenceRepository(context: Context) {
-    private val dataStore = context.dataStore
-
+class PreferenceRepository(private val context: Context) {
     // Expose flows so that we can also handle default values
     // ---- Profile Notifications ----
-    val notificationDownloadFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_DOWNLOAD] ?: true }
-
-    val notificationDeleteFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_DELETE] ?: true }
-
-    val notificationSwitchFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.NOTIFICATION_SWITCH] ?: false }
+    val notificationDownloadFlow = bindFlow(PreferenceKeys.NOTIFICATION_DOWNLOAD, true)
+    val notificationDeleteFlow = bindFlow(PreferenceKeys.NOTIFICATION_DELETE, true)
+    val notificationSwitchFlow = bindFlow(PreferenceKeys.NOTIFICATION_SWITCH, false)
 
     // ---- Advanced ----
-    val disableSafeguardFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM] ?: false }
-
-    val verboseLoggingFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.VERBOSE_LOGGING] ?: false }
+    val disableSafeguardFlow = bindFlow(PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM, false)
+    val verboseLoggingFlow = bindFlow(PreferenceKeys.VERBOSE_LOGGING, false)
 
     // ---- Developer Options ----
-    val developerOptionsEnabledFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.DEVELOPER_OPTIONS_ENABLED] ?: false }
+    val developerOptionsEnabledFlow = bindFlow(PreferenceKeys.DEVELOPER_OPTIONS_ENABLED, false)
+    val experimentalDownloadWizardFlow = bindFlow(PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD, false)
+    val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
+    val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
 
-    val experimentalDownloadWizardFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD] ?: false }
+    private fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): Flow<T> =
+        context.dataStore.data.map { it[key] ?: defaultValue }
 
-    val unfilteredProfileListFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.UNFILTERED_PROFILE_LIST] ?: false }
-
-    val ignoreTLSCertificateFlow: Flow<Boolean> =
-        dataStore.data.map { it[PreferenceKeys.IGNORE_TLS_CERTIFICATE] ?: false }
-
-    suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) {
-        dataStore.edit {
-            it[key] = value
-        }
-    }
+    suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) =
+        context.dataStore.edit { it[key] = value }
 }
\ No newline at end of file

From 562e5922bea75dcf7e22454404032f9192d8ea1c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 1 Dec 2024 14:46:42 +0100
Subject: [PATCH 267/458] chore: suppress gradle warning (#75)

We recommend using a newer Android Gradle plugin to use `compileSdk = 35`

This Android Gradle plugin (8.1.2) was tested up to `compileSdk = 34`.

You are strongly encouraged to update your project to use a newer
Android Gradle plugin that has been tested with `compileSdk = 35`.

If you are already using the latest version of the Android Gradle plugin,
you may need to wait until a newer version with support for `compileSdk = 35` is available.

To suppress this warning, add/update

```
android.suppressUnsupportedCompileSdk=35
```

to this project's gradle.properties.

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/75
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 gradle.properties | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/gradle.properties b/gradle.properties
index 022338b78..239cc4488 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -22,4 +22,5 @@ kotlin.code.style=official
 # thereby reducing the size of the R class for that library
 android.nonTransitiveRClass=true
 android.defaults.buildfeatures.buildconfig=true
-android.nonFinalResIds=false
\ No newline at end of file
+android.nonFinalResIds=false
+android.suppressUnsupportedCompileSdk=35

From e7f58bbaaf41b02187501f537b8be322a87265ce Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 1 Dec 2024 14:57:30 +0100
Subject: [PATCH 268/458] chore: simplify settings intent (#77)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/77
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 27 ++++++++-----------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 9c071bd4f..d2ae9d6d5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -38,25 +38,20 @@ class SettingsFragment: PreferenceFragmentCompat() {
             }.collect()
         }
 
-        findPreference<Preference>("pref_info_app_version")
-            ?.apply {
-                summary = requireContext().selfAppVersion
+        findPreference<Preference>("pref_info_app_version")?.apply {
+            summary = requireContext().selfAppVersion
 
-                // Enable developer options when this is clicked for 7 times
-                setOnPreferenceClickListener(this@SettingsFragment::onAppVersionClicked)
-            }
+            // Enable developer options when this is clicked for 7 times
+            setOnPreferenceClickListener(::onAppVersionClicked)
+        }
 
-        findPreference<Preference>("pref_info_source_code")
-            ?.setOnPreferenceClickListener {
-                startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(it.summary.toString())))
-                true
-            }
+        findPreference<Preference>("pref_info_source_code")?.apply {
+            intent = Intent(Intent.ACTION_VIEW, Uri.parse(summary.toString()))
+        }
 
-        findPreference<Preference>("pref_advanced_logs")
-            ?.setOnPreferenceClickListener {
-                startActivity(Intent(requireContext(), LogsActivity::class.java))
-                true
-            }
+        findPreference<Preference>("pref_advanced_logs")?.apply {
+            intent = Intent(requireContext(), LogsActivity::class.java)
+        }
 
         findPreference<CheckBoxPreference>("pref_notifications_download")
             ?.bindBooleanFlow(preferenceRepository.notificationDownloadFlow, PreferenceKeys.NOTIFICATION_DOWNLOAD)

From 0a78daee8bc9bf217c746a58d38c178110aa0ae0 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 1 Dec 2024 20:26:14 +0100
Subject: [PATCH 269/458] feat: language preferences (#76)

see https://developer.android.com/guide/topics/resources/app-languages

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/76
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt    | 10 ++++++++++
 app-common/src/main/res/values/strings.xml       |  2 ++
 app-common/src/main/res/xml/locale_config.xml    |  5 +++++
 app-common/src/main/res/xml/pref_settings.xml    |  7 +++++++
 app-unpriv/src/main/AndroidManifest.xml          | 15 +++++++++++++--
 app/src/main/AndroidManifest.xml                 | 16 ++++++++++++++--
 6 files changed, 51 insertions(+), 4 deletions(-)
 create mode 100644 app-common/src/main/res/xml/locale_config.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index d2ae9d6d5..f10f13484 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -2,7 +2,9 @@ package im.angry.openeuicc.ui
 
 import android.content.Intent
 import android.net.Uri
+import android.os.Build
 import android.os.Bundle
+import android.provider.Settings
 import android.widget.Toast
 import androidx.datastore.preferences.core.Preferences
 import androidx.lifecycle.lifecycleScope
@@ -49,6 +51,14 @@ class SettingsFragment: PreferenceFragmentCompat() {
             intent = Intent(Intent.ACTION_VIEW, Uri.parse(summary.toString()))
         }
 
+        findPreference<Preference>("pref_language")?.apply {
+            if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return@apply
+            isVisible = true
+            intent = Intent(Settings.ACTION_APP_LOCALE_SETTINGS).apply {
+                data = Uri.fromParts("package", requireContext().packageName, null)
+            }
+        }
+
         findPreference<Preference>("pref_advanced_logs")?.apply {
             intent = Intent(requireContext(), LogsActivity::class.java)
         }
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 73b193837..174b18ca3 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -146,6 +146,8 @@
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_verbose_logging">Verbose Logging</string>
     <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
+    <string name="pref_language">Language</string>
+    <string name="pref_language_desc">Select current language</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_developer">Developer Options</string>
diff --git a/app-common/src/main/res/xml/locale_config.xml b/app-common/src/main/res/xml/locale_config.xml
new file mode 100644
index 000000000..dd9d189c2
--- /dev/null
+++ b/app-common/src/main/res/xml/locale_config.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
+    <locale android:name="en-US" />
+    <locale android:name="ja" />
+</locale-config>
\ No newline at end of file
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 60646bc5e..107e0b414 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -36,6 +36,13 @@
             app:title="@string/pref_advanced_verbose_logging"
             app:summary="@string/pref_advanced_verbose_logging_desc" />
 
+        <Preference
+            app:iconSpaceReserved="false"
+            app:isPreferenceVisible="false"
+            app:key="pref_language"
+            app:summary="@string/pref_language_desc"
+            app:title="@string/pref_language" />
+
         <Preference
             app:key="pref_advanced_logs"
             app:iconSpaceReserved="false"
diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index 8760fb98e..ce985cdc7 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <application
         android:name="im.angry.openeuicc.UnprivilegedOpenEuiccApplication"
@@ -8,7 +9,9 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/Theme.OpenEUICC">
+        android:localeConfig="@xml/locale_config"
+        android:theme="@style/Theme.OpenEUICC"
+        tools:targetApi="tiramisu">
 
         <activity
             android:name="im.angry.openeuicc.ui.UnprivilegedMainActivity"
@@ -25,6 +28,14 @@
             android:exported="false"
             android:label="@string/compatibility_check" />
 
+        <service
+            android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"
+            android:enabled="false"
+            android:exported="false">
+            <meta-data
+                android:name="autoStoreLocales"
+                android:value="true" />
+        </service>
     </application>
 
     <queries>
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
index cd306200b..cae19d3b1 100644
--- a/app/src/main/AndroidManifest.xml
+++ b/app/src/main/AndroidManifest.xml
@@ -5,7 +5,8 @@
     package="im.angry.openeuicc">
     <uses-feature
         android:name="android.hardware.telephony"
-        android:required="true" />
+        android:required="true"
+        tools:ignore="UnnecessaryRequiredFeature" />
 
     <uses-permission android:name="android.permission.MODIFY_PHONE_STATE" />
     <uses-permission android:name="android.permission.READ_PRIVILEGED_PHONE_STATE" />
@@ -19,7 +20,9 @@
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
-        android:theme="@style/Theme.OpenEUICC">
+        android:localeConfig="@xml/locale_config"
+        android:theme="@style/Theme.OpenEUICC"
+        tools:targetApi="tiramisu">
         <activity
             android:name=".ui.PrivilegedMainActivity"
             android:exported="true">
@@ -49,6 +52,15 @@
                 <category android:name="android.service.euicc.category.EUICC_UI" />
             </intent-filter>
         </activity>
+
+        <service
+            android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"
+            android:enabled="false"
+            android:exported="false">
+            <meta-data
+                android:name="autoStoreLocales"
+                android:value="true" />
+        </service>
     </application>
 
 </manifest>

From c6de599db0825b0ed15c4ce6702639ecd6cbba7f Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 1 Dec 2024 17:08:09 -0500
Subject: [PATCH 270/458] lpac-jni: Cancel es9p/10b sessions on download
 failure

---
 .idea/compiler.xml                                   | 12 +-----------
 .../src/main/java/net/typeblog/lpac_jni/LpacJni.kt   |  2 ++
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt       |  8 +++++++-
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c  | 12 +++++++++++-
 4 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/.idea/compiler.xml b/.idea/compiler.xml
index 61f4db454..1c5ab058d 100644
--- a/.idea/compiler.xml
+++ b/.idea/compiler.xml
@@ -1,16 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="CompilerConfiguration">
-    <bytecodeTargetLevel target="1.7">
-      <module name="OpenEUICC.app" target="17" />
-      <module name="OpenEUICC.app-common" target="17" />
-      <module name="OpenEUICC.app-deps" target="17" />
-      <module name="OpenEUICC.app-unpriv" target="17" />
-      <module name="OpenEUICC.buildSrc" target="17" />
-      <module name="OpenEUICC.buildSrc.main" target="17" />
-      <module name="OpenEUICC.buildSrc.test" target="17" />
-      <module name="OpenEUICC.libs.hidden-apis-shim" target="17" />
-      <module name="OpenEUICC.libs.lpac-jni" target="17" />
-    </bytecodeTargetLevel>
+    <bytecodeTargetLevel target="1.7" />
   </component>
 </project>
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index f9a2f9011..1e64c69de 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -30,6 +30,8 @@ internal object LpacJni {
     external fun downloadProfile(handle: Long, smdp: String, matchingId: String?, imei: String?,
                                  confirmationCode: String?, callback: ProfileDownloadCallback): Int
     external fun handleNotification(handle: Long, seqNumber: Long): Int
+    // Cancel any ongoing es9p and/or es10b sessions
+    external fun cancelSessions(handle: Long)
 
     // es10cex (actually part of es10b)
     external fun es10cexGetEuiccInfo2(handle: Long): Long
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 70606d994..4dbb18132 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -212,12 +212,18 @@ class LocalProfileAssistantImpl(
         )
 
         if (res != 0) {
-            throw LocalProfileAssistant.ProfileDownloadException(
+            // Construct the error now to store any error information we _can_ access
+            val err = LocalProfileAssistant.ProfileDownloadException(
                 httpInterface.lastHttpResponse,
                 httpInterface.lastHttpException,
                 apduInterface.lastApduResponse,
                 apduInterface.lastApduException,
             )
+
+            // Cancel sessions if possible. This will overwrite recorded errors from HTTP and APDU interfaces.
+            LpacJni.cancelSessions(contextHandle)
+
+            throw err
         }
     }
 
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
index 91676daf2..891017079 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
@@ -117,7 +117,8 @@ Java_net_typeblog_lpac_1jni_LpacJni_downloadProfile(JNIEnv *env, jobject thiz, j
     syslog(LOG_INFO, "es10b_load_bound_profile_package %d, reason %d", ret, es10b_load_bound_profile_package_result.errorReason);
 
     out:
-    euicc_http_cleanup(ctx);
+    // We expect Java side to call cancelSessions after any error -- thus, `euicc_http_cleanup` is done there
+    // This is so that Java side can access the last HTTP and/or APDU errors when we return.
     if (_confirmation_code != NULL)
         (*env)->ReleaseStringUTFChars(env, confirmation_code, _confirmation_code);
     if (_matching_id != NULL)
@@ -127,3 +128,12 @@ Java_net_typeblog_lpac_1jni_LpacJni_downloadProfile(JNIEnv *env, jobject thiz, j
         (*env)->ReleaseStringUTFChars(env, imei, _imei);
     return ret;
 }
+
+
+JNIEXPORT void JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_cancelSessions(JNIEnv *env, jobject thiz, jlong handle) {
+    struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
+    es9p_cancel_session(ctx);
+    es10b_cancel_session(ctx, ES10B_CANCEL_SESSION_REASON_UNDEFINED);
+    euicc_http_cleanup(ctx);
+}
\ No newline at end of file

From f74145d0b770d2f93d4fcdc4a41957216b607851 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 1 Dec 2024 17:15:51 -0500
Subject: [PATCH 271/458] i18n: Update new strings

---
 app-common/src/main/res/values-ja/strings.xml | 4 ++++
 app-common/src/main/res/values/strings.xml    | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 72b88a831..de9465f2b 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -136,4 +136,8 @@
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
+    <string name="pref_language">言語</string>
+    <string name="pref_language_desc">アプリの言語を選択</string>
+    <string name="pref_developer_unfiltered_profile_list">すべてのプロファイルを表示</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">プロダクション以外のプロファイルも表示する</string>
 </resources>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 174b18ca3..d0813d2cf 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -147,14 +147,14 @@
     <string name="pref_advanced_verbose_logging">Verbose Logging</string>
     <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
     <string name="pref_language">Language</string>
-    <string name="pref_language_desc">Select current language</string>
+    <string name="pref_language_desc">Select app language</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_developer">Developer Options</string>
     <string name="pref_developer_experimental_download_wizard">Experimental Download Wizard</string>
     <string name="pref_developer_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
     <string name="pref_developer_unfiltered_profile_list">Show unfiltered profile list</string>
-    <string name="pref_developer_unfiltered_profile_list_desc">Display any profile class in the list</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">Include non-production profiles in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
     <string name="pref_developer_ignore_tls_certificate_desc">Ignore SM-DP+ TLS certificate, allow any RSP</string>
     <string name="pref_info">Info</string>

From afeb5c52827477f891f7c5f1413cf5dc67155b79 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 1 Dec 2024 17:22:58 -0500
Subject: [PATCH 272/458] i18n: Fixup Japanese translation for notification
 types

~ing in the en text means the action itself, not the process.
---
 app-common/src/main/res/values-ja/strings.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index de9465f2b..925a5a263 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -114,13 +114,13 @@
     <string name="developer_options_enabled">あなたは開発者になりました！</string>
     <string name="pref_settings">設定</string>
     <string name="pref_notifications">通知</string>
-    <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。必要に応じてこの動作を微調整できます。</string>
+    <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。ここでは、どのタイプの通知を送信するのかを微調整できます。</string>
     <string name="pref_notifications_download">ダウンロード</string>
-    <string name="pref_notifications_download_desc">プロファイルを<i>ダウンロード中</i>の通知を送信します</string>
+    <string name="pref_notifications_download_desc">プロファイルの<i>ダウンロード済み</i>の通知を送信します</string>
     <string name="pref_notifications_delete">削除</string>
-    <string name="pref_notifications_delete_desc">プロファイルを<i>削除中</i>の通知を送信します</string>
-    <string name="pref_notifications_switch">切り替え中</string>
-    <string name="pref_notifications_switch_desc">プロファイルを<i>切り替え中</i>の通知を送信します\nこのタイプの通知は信頼できないことに注意してください。</string>
+    <string name="pref_notifications_delete_desc">プロファイルの<i>削除済み</i>の通知を送信します</string>
+    <string name="pref_notifications_switch">切り替え</string>
+    <string name="pref_notifications_switch_desc">プロファイルの<i>切り替え済み</i>の通知を送信します\nこのタイプの通知は有効化しても必ず送信するとは限らないことに注意してください。</string>
     <string name="pref_advanced">高度な設定</string>
     <string name="pref_advanced_disable_safeguard_removable_esim">有効なプロファイルの無効化と削除を許可する</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">デフォルトでは、このアプリでデバイスに挿入された取り外し可能な eSIM の有効なプロファイルを無効化することを防いでいます。なぜなのかというと<i>時々</i>アクセスができなくなるからです。\nこのチェックボックスを ON にすることで、この保護機能を<i>解除</i>します。</string>

From 78bf3612eeb5aebd5525979ea4d23e1f23064de0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 1 Dec 2024 18:47:58 -0500
Subject: [PATCH 273/458] lpac-jni: Expose error reason as return value

---
 .../src/main/jni/lpac-jni/lpac-download.c     | 24 ++++++++++++++-----
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
index 891017079..f63585a09 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
@@ -82,39 +82,51 @@ Java_net_typeblog_lpac_1jni_LpacJni_downloadProfile(JNIEnv *env, jobject thiz, j
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_preparing);
     ret = es10b_get_euicc_challenge_and_info(ctx);
     syslog(LOG_INFO, "es10b_get_euicc_challenge_and_info %d", ret);
-    if (ret < 0)
+    if (ret < 0) {
+        ret = -ES10B_ERROR_REASON_UNDEFINED;
         goto out;
+    }
 
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_connecting);
     ret = es9p_initiate_authentication(ctx);
     syslog(LOG_INFO, "es9p_initiate_authentication %d", ret);
-    if (ret < 0)
+    if (ret < 0) {
+        ret = -ES10B_ERROR_REASON_UNDEFINED;
         goto out;
+    }
 
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_authenticating);
     ret = es10b_authenticate_server(ctx, _matching_id, _imei);
     syslog(LOG_INFO, "es10b_authenticate_server %d", ret);
-    if (ret < 0)
+    if (ret < 0) {
+        ret = -ES10B_ERROR_REASON_UNDEFINED;
         goto out;
+    }
 
     ret = es9p_authenticate_client(ctx);
-    if (ret < 0)
+    if (ret < 0) {
+        ret = -ES10B_ERROR_REASON_UNDEFINED;
         goto out;
+    }
 
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_downloading);
     ret = es10b_prepare_download(ctx, _confirmation_code);
     syslog(LOG_INFO, "es10b_prepare_download %d", ret);
-    if (ret < 0)
+    if (ret < 0) {
+        ret = -ES10B_ERROR_REASON_UNDEFINED;
         goto out;
+    }
 
     ret = es9p_get_bound_profile_package(ctx);
     if (ret < 0)
         goto out;
 
     (*env)->CallVoidMethod(env, callback, on_state_update, download_state_finalizing);
-    // TODO: Expose error code as Java-side exceptions?
     ret = es10b_load_bound_profile_package(ctx, &es10b_load_bound_profile_package_result);
     syslog(LOG_INFO, "es10b_load_bound_profile_package %d, reason %d", ret, es10b_load_bound_profile_package_result.errorReason);
+    if (ret < 0) {
+        ret = - (int) es10b_load_bound_profile_package_result.errorReason;
+    }
 
     out:
     // We expect Java side to call cancelSessions after any error -- thus, `euicc_http_cleanup` is done there

From 858b6d55d675cf5feead3253955eb6abe50d6632 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 04:39:44 +0100
Subject: [PATCH 274/458] feat: show notification sequence number in upper
 right (#84)

![](https://gitea.angry.im/attachments/049f819a-b647-4db6-ae3d-6519cf8ff2e9)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/84
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/ui/NotificationsActivity.kt  | 16 +++++++++++++---
 .../src/main/res/layout/notification_item.xml    |  9 +++++++++
 app-common/src/main/res/values-ja/strings.xml    |  1 -
 app-common/src/main/res/values/strings.xml       |  3 ++-
 4 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 31b7d7edc..c2a1a0fd6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -117,11 +117,14 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
        launchTask {
            notificationAdapter.notifications =
                euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
-                   val profiles = channel.lpa.profiles
+                   val nameMap = buildMap {
+                       for (profile in channel.lpa.profiles) {
+                           put(profile.iccid, profile.displayName)
+                       }
+                   }
 
                    channel.lpa.notifications.map {
-                       val profile = profiles.find { p -> p.iccid == it.iccid }
-                       LocalProfileNotificationWrapper(it, profile?.displayName ?: "???")
+                       LocalProfileNotificationWrapper(it, nameMap[it.iccid] ?: "???")
                    }
                }
        }
@@ -136,6 +139,8 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     inner class NotificationViewHolder(private val root: View):
         RecyclerView.ViewHolder(root), View.OnCreateContextMenuListener, OnMenuItemClickListener {
         private val address: TextView = root.requireViewById(R.id.notification_address)
+        private val sequenceNumber: TextView =
+            root.requireViewById(R.id.notification_sequence_number)
         private val profileName: TextView = root.requireViewById(R.id.notification_profile_name)
 
         private lateinit var notification: LocalProfileNotificationWrapper
@@ -157,6 +162,7 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
         }
 
+
         private fun operationToLocalizedText(operation: LocalProfileNotification.Operation) =
             root.context.getText(
                 when (operation) {
@@ -170,6 +176,10 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             notification = value
 
             address.text = value.inner.notificationAddress
+            sequenceNumber.text = root.context.getString(
+                R.string.profile_notification_sequence_number_format,
+                value.inner.seqNumber
+            )
             profileName.text = Html.fromHtml(
                 root.context.getString(R.string.profile_notification_name_format,
                     operationToLocalizedText(value.inner.profileManagementOperation),
diff --git a/app-common/src/main/res/layout/notification_item.xml b/app-common/src/main/res/layout/notification_item.xml
index 6b7253c75..5d56b3ae8 100644
--- a/app-common/src/main/res/layout/notification_item.xml
+++ b/app-common/src/main/res/layout/notification_item.xml
@@ -15,6 +15,15 @@
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintTop_toTopOf="parent" />
 
+    <TextView
+        android:id="@+id/notification_sequence_number"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginHorizontal="24dp"
+        android:layout_marginVertical="12dp"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
     <TextView
         android:id="@+id/notification_profile_name"
         android:layout_width="0dp"
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 925a5a263..e035f7d35 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -89,7 +89,6 @@
     <string name="profile_notification_operation_delete">削除しました</string>
     <string name="profile_notification_operation_enable">有効化しました</string>
     <string name="profile_notification_operation_disable">無効化しました</string>
-    <string name="profile_notification_name_format">&lt;b&gt;%1$s&lt;/b&gt; %2$s (%3$s)</string>
     <string name="profile_notification_process">処理</string>
     <string name="profile_notification_delete">削除</string>
     <string name="euicc_info">eUICC 情報</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d0813d2cf..bd89b25f1 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -103,7 +103,8 @@
     <string name="profile_notification_operation_delete">Deleted</string>
     <string name="profile_notification_operation_enable">Enabled</string>
     <string name="profile_notification_operation_disable">Disabled</string>
-    <string name="profile_notification_name_format">&lt;b&gt;%1$s&lt;/b&gt; %2$s (%3$s)</string>
+    <string name="profile_notification_name_format" translatable="false">&lt;b&gt;%1$s&lt;/b&gt; %2$s (%3$s)</string>
+    <string name="profile_notification_sequence_number_format" translatable="false">#%d</string>
     <string name="profile_notification_process">Process</string>
     <string name="profile_notification_delete">Delete</string>
 

From ff6bd45ac6f9f6e65fea167998f2798e2c718db3 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 04:41:49 +0100
Subject: [PATCH 275/458] feat: show profile class with unfiltered profile list
 (#86)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/86
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/ui/EuiccManagementFragment.kt   | 14 ++++++++
 .../src/main/res/layout/euicc_profile.xml     | 35 ++++++++++++++++---
 app-common/src/main/res/values-ja/strings.xml |  1 -
 app-common/src/main/res/values/strings.xml    |  6 +++-
 4 files changed, 49 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index b7462e280..894748088 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -20,6 +20,7 @@ import android.widget.Toast
 import androidx.appcompat.app.AlertDialog
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
+import androidx.core.view.isVisible
 import androidx.core.view.updateLayoutParams
 import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
@@ -339,6 +340,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         private val name: TextView = root.requireViewById(R.id.name)
         private val state: TextView = root.requireViewById(R.id.state)
         private val provider: TextView = root.requireViewById(R.id.provider)
+        private val profileClassLabel: TextView = root.requireViewById(R.id.profile_class_label)
+        private val profileClass: TextView = root.requireViewById(R.id.profile_class)
         private val profileMenu: ImageButton = root.requireViewById(R.id.profile_menu)
 
         init {
@@ -364,6 +367,10 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         private lateinit var profile: LocalProfileInfo
 
         fun setProfile(profile: LocalProfileInfo) {
+            if (unfilteredProfileListFlow.value) {
+                profileClassLabel.isVisible = true
+                profileClass.isVisible = true
+            }
             this.profile = profile
             name.text = profile.displayName
 
@@ -375,6 +382,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
             )
             provider.text = profile.providerName
+            if (profileClass.isVisible) profileClass.setText(
+                when (profile.profileClass) {
+                    LocalProfileInfo.Clazz.Testing -> R.string.profile_class_testing
+                    LocalProfileInfo.Clazz.Provisioning -> R.string.profile_class_provisioning
+                    LocalProfileInfo.Clazz.Operational -> R.string.profile_class_operational
+                }
+            )
             iccid.text = profile.iccid
             iccid.transformationMethod = PasswordTransformationMethod.getInstance()
         }
diff --git a/app-common/src/main/res/layout/euicc_profile.xml b/app-common/src/main/res/layout/euicc_profile.xml
index 06aa2b847..83aae8d9f 100644
--- a/app-common/src/main/res/layout/euicc_profile.xml
+++ b/app-common/src/main/res/layout/euicc_profile.xml
@@ -62,18 +62,43 @@
                 android:singleLine="true"
                 app:layout_constraintLeft_toLeftOf="parent"
                 app:layout_constraintTop_toBottomOf="@id/state"
-                app:layout_constraintBottom_toTopOf="@+id/iccid_label"/>
+                app:layout_constraintBottom_toTopOf="@+id/profile_class_label"/>
 
             <TextView
                 android:id="@+id/provider"
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:layout_marginTop="6dp"
-                android:layout_marginLeft="7dp"
+                android:layout_marginStart="7dp"
                 android:textSize="14sp"
                 android:singleLine="true"
                 app:layout_constraintLeft_toRightOf="@id/provider_label"
                 app:layout_constraintTop_toBottomOf="@id/state"
+                app:layout_constraintBottom_toTopOf="@+id/profile_class"/>
+
+            <TextView
+                android:id="@+id/profile_class_label"
+                android:text="@string/profile_class"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="6dp"
+                android:textSize="14sp"
+                android:textStyle="bold"
+                android:singleLine="true"
+                app:layout_constraintLeft_toLeftOf="parent"
+                app:layout_constraintTop_toBottomOf="@id/provider_label"
+                app:layout_constraintBottom_toTopOf="@+id/iccid_label"/>
+
+            <TextView
+                android:id="@+id/profile_class"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="6dp"
+                android:layout_marginStart="7dp"
+                android:textSize="14sp"
+                android:singleLine="true"
+                app:layout_constraintLeft_toRightOf="@id/profile_class_label"
+                app:layout_constraintTop_toBottomOf="@id/provider"
                 app:layout_constraintBottom_toTopOf="@+id/iccid"/>
 
             <TextView
@@ -86,7 +111,7 @@
                 android:textStyle="bold"
                 android:singleLine="true"
                 app:layout_constraintLeft_toLeftOf="parent"
-                app:layout_constraintTop_toBottomOf="@id/provider_label"
+                app:layout_constraintTop_toBottomOf="@id/profile_class_label"
                 app:layout_constraintBottom_toBottomOf="parent"/>
 
             <TextView
@@ -94,11 +119,11 @@
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:layout_marginTop="6dp"
-                android:layout_marginLeft="7dp"
+                android:layout_marginStart="7dp"
                 android:textSize="14sp"
                 android:singleLine="true"
                 app:layout_constraintLeft_toRightOf="@id/iccid_label"
-                app:layout_constraintTop_toBottomOf="@id/provider"
+                app:layout_constraintTop_toBottomOf="@id/profile_class"
                 app:layout_constraintBottom_toBottomOf="parent"/>
 
         </androidx.constraintlayout.widget.ConstraintLayout>
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index e035f7d35..0f25ca6f7 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -11,7 +11,6 @@
     <string name="enabled">有効済み</string>
     <string name="disabled">無効済み</string>
     <string name="provider">プロバイダー:</string>
-    <string name="iccid">ICCID:</string>
     <string name="enable">有効化</string>
     <string name="disable">無効化</string>
     <string name="delete">削除</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bd89b25f1..8ea6e207e 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -13,7 +13,11 @@
     <string name="enabled">Enabled</string>
     <string name="disabled">Disabled</string>
     <string name="provider">Provider:</string>
-    <string name="iccid">ICCID:</string>
+    <string name="profile_class">Class:</string>
+    <string name="profile_class_testing">Testing</string>
+    <string name="profile_class_provisioning">Provisioning</string>
+    <string name="profile_class_operational">Operational</string>
+    <string name="iccid" translatable="false">ICCID:</string>
 
     <string name="enable">Enable</string>
     <string name="disable">Disable</string>

From 4ae19aea3b5138df4669ad1cae1e23b765cbf369 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 04:43:31 +0100
Subject: [PATCH 276/458] feat: expose ES10c.EuiccMemoryReset (#88)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/88
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/net/typeblog/lpac_jni/LocalProfileAssistant.kt  | 2 ++
 .../src/main/java/net/typeblog/lpac_jni/LpacJni.kt       | 2 ++
 .../typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt  | 4 ++++
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c           | 9 +++++++++
 4 files changed, 17 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index cf870e11f..58f25aa04 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -37,6 +37,8 @@ interface LocalProfileAssistant {
     fun deleteNotification(seqNumber: Long): Boolean
     fun handleNotification(seqNumber: Long): Boolean
 
+    fun euiccMemoryReset()
+
     fun setNickname(
         iccid: String, nickname: String
     ): Boolean
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 1e64c69de..09c0117ea 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -33,6 +33,8 @@ internal object LpacJni {
     // Cancel any ongoing es9p and/or es10b sessions
     external fun cancelSessions(handle: Long)
 
+    // ES10c
+    external fun es10cEuiccMemoryReset(handle: Long): Int
     // es10cex (actually part of es10b)
     external fun es10cexGetEuiccInfo2(handle: Long): Long
 
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 4dbb18132..0cbebf0cf 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -241,6 +241,10 @@ class LocalProfileAssistantImpl(
     override fun setNickname(iccid: String, nickname: String): Boolean =
         LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
 
+    override fun euiccMemoryReset() {
+        LpacJni.es10cEuiccMemoryReset(contextHandle)
+    }
+
     @Synchronized
     override fun close() {
         if (!finalized) {
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index f081f8ef6..2ad694c8e 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -245,6 +245,15 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cexGetEuiccInfo2(JNIEnv *env, jobject th
     return (jlong) info;
 }
 
+
+JNIEXPORT jint JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_es10cEuiccMemoryReset(JNIEnv *env, jobject thiz, jlong handle) {
+    struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
+    int ret;
+    ret = es10c_euicc_memory_reset(ctx);
+    return ret
+}
+
 JNIEXPORT jstring JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_stringDeref(JNIEnv *env, jobject thiz, jlong curr) {
     return toJString(env, *((char **) curr));

From 75221fcf792dcedf26745bc9c3d6dba82ae379c9 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 15:56:24 +0100
Subject: [PATCH 277/458] fix: build failed (ES10c.EuiccMemoryReset) (#90)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/90
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt     | 2 ++
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c                  | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index 22ece46d5..aab9e635a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -52,6 +52,8 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
 
     override fun handleNotification(seqNumber: Long): Boolean = lpa.handleNotification(seqNumber)
 
+    override fun euiccMemoryReset() = lpa.euiccMemoryReset()
+
     override fun setNickname(iccid: String, nickname: String): Boolean =
         lpa.setNickname(iccid, nickname)
 
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 2ad694c8e..8f4752bc3 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -251,7 +251,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cEuiccMemoryReset(JNIEnv *env, jobject t
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     int ret;
     ret = es10c_euicc_memory_reset(ctx);
-    return ret
+    return ret;
 }
 
 JNIEXPORT jstring JNICALL

From fb8b6de35006b813ceb589b2ea23c53b8a70ef8c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 15:57:14 +0100
Subject: [PATCH 278/458] chore: cleanup (#81)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/81
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/im/angry/openeuicc/core/OmapiApduInterface.kt | 4 ++--
 .../src/main/java/im/angry/openeuicc/ui/MainActivity.kt     | 2 +-
 .../angry/openeuicc/core/TelephonyManagerApduInterface.kt   | 2 +-
 .../im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt    | 1 +
 libs/lpac-jni/build.gradle.kts                              | 6 +++---
 5 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index b63f343d1..71aa386f6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -38,8 +38,8 @@ class OmapiApduInterface(
         check(!this::lastChannel.isInitialized) {
             "Can only open one channel"
         }
-        lastChannel = session.openLogicalChannel(aid)!!;
-        return 1;
+        lastChannel = session.openLogicalChannel(aid)!!
+        return 1
     }
 
     override fun logicalChannelClose(handle: Int) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 74f214751..7711643f8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -109,7 +109,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     override fun onOptionsItemSelected(item: MenuItem): Boolean =
         when (item.itemId) {
             R.id.settings -> {
-                startActivity(Intent(this, SettingsActivity::class.java));
+                startActivity(Intent(this, SettingsActivity::class.java))
                 true
             }
             R.id.reload -> {
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index ef877b489..6b093680a 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -39,7 +39,7 @@ class TelephonyManagerApduInterface(
         val hex = aid.encodeHex()
         val channel = tm.iccOpenLogicalChannelByPortCompat(port.card.physicalSlotIndex, port.portIndex, hex, 0)
         if (channel.status != IccOpenLogicalChannelResponse.STATUS_NO_ERROR || channel.channel == IccOpenLogicalChannelResponse.INVALID_CHANNEL) {
-            throw IllegalArgumentException("Cannot open logical channel $hex via TelephonManager on slot ${port.card.physicalSlotIndex} port ${port.portIndex}");
+            throw IllegalArgumentException("Cannot open logical channel $hex via TelephonManager on slot ${port.card.physicalSlotIndex} port ${port.portIndex}")
         }
         lastChannel = channel.channel
         return lastChannel
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
index 4c1e19f26..dbd39f20b 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
@@ -94,6 +94,7 @@ val TelephonyManager.uiccCardsInfoCompat: List<RealUiccCardInfoCompat>
 fun TelephonyManager.iccOpenLogicalChannelByPortCompat(
     slotIndex: Int, portIndex: Int, aid: String?, p2: Int
 ): IccOpenLogicalChannelResponse =
+    @Suppress("UNNECESSARY_NOT_NULL_ASSERTION")
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
         iccOpenLogicalChannelByPort(slotIndex, portIndex, aid, p2)!!
     } else {
diff --git a/libs/lpac-jni/build.gradle.kts b/libs/lpac-jni/build.gradle.kts
index ff34d56e7..93f608206 100644
--- a/libs/lpac-jni/build.gradle.kts
+++ b/libs/lpac-jni/build.gradle.kts
@@ -16,9 +16,9 @@ android {
         externalNativeBuild {
             ndkBuild {
                 cFlags(
-                    "-fmacro-prefix-map=${project.projectDir.toString()}=/fake/path/",
-                    "-fdebug-prefix-map=${project.projectDir.toString()}=/fake/path/",
-                    "-ffile-prefix-map=${project.projectDir.toString()}=/fake/path/"
+                    "-fmacro-prefix-map=${project.projectDir}=/fake/path/",
+                    "-fdebug-prefix-map=${project.projectDir}=/fake/path/",
+                    "-ffile-prefix-map=${project.projectDir}=/fake/path/"
                 )
             }
         }

From acce39fd3b098261839d36846575736e978e9faf Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 7 Dec 2024 15:58:56 +0100
Subject: [PATCH 279/458] chore: flatten install packages (#85)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/85
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .forgejo/workflows/build-debug.yml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.forgejo/workflows/build-debug.yml b/.forgejo/workflows/build-debug.yml
index 1dcc692b4..51e802ca2 100644
--- a/.forgejo/workflows/build-debug.yml
+++ b/.forgejo/workflows/build-debug.yml
@@ -35,11 +35,12 @@ jobs:
       - name: Build Debug APKs
         run: ./gradlew --no-daemon assembleDebug
 
+      - name: Copy Artifacts
+        run: find . -name 'app*-debug.apk' -exec cp {} . \;
+
       - name: Upload Artifacts
         uses: https://gitea.angry.im/actions/upload-artifact@v3
         with:
           name: Debug APKs
           compression-level: 0
-          path: |
-            app-unpriv/build/outputs/apk/debug/app-unpriv-debug.apk
-            app/build/outputs/apk/debug/app-debug.apk
+          path: app*-debug.apk

From 9e637f766d11930ef553817943df308dae0d5e65 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 03:10:53 +0100
Subject: [PATCH 280/458] fix: profile class always display (#92)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/92
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt | 8 +++-----
 app-common/src/main/res/layout/euicc_profile.xml          | 2 ++
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 894748088..824b68335 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -367,10 +367,6 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         private lateinit var profile: LocalProfileInfo
 
         fun setProfile(profile: LocalProfileInfo) {
-            if (unfilteredProfileListFlow.value) {
-                profileClassLabel.isVisible = true
-                profileClass.isVisible = true
-            }
             this.profile = profile
             name.text = profile.displayName
 
@@ -382,7 +378,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 }
             )
             provider.text = profile.providerName
-            if (profileClass.isVisible) profileClass.setText(
+            profileClassLabel.isVisible = unfilteredProfileListFlow.value
+            profileClass.isVisible = unfilteredProfileListFlow.value
+            profileClass.setText(
                 when (profile.profileClass) {
                     LocalProfileInfo.Clazz.Testing -> R.string.profile_class_testing
                     LocalProfileInfo.Clazz.Provisioning -> R.string.profile_class_provisioning
diff --git a/app-common/src/main/res/layout/euicc_profile.xml b/app-common/src/main/res/layout/euicc_profile.xml
index 83aae8d9f..797101765 100644
--- a/app-common/src/main/res/layout/euicc_profile.xml
+++ b/app-common/src/main/res/layout/euicc_profile.xml
@@ -85,6 +85,7 @@
                 android:textSize="14sp"
                 android:textStyle="bold"
                 android:singleLine="true"
+                android:visibility="gone"
                 app:layout_constraintLeft_toLeftOf="parent"
                 app:layout_constraintTop_toBottomOf="@id/provider_label"
                 app:layout_constraintBottom_toTopOf="@+id/iccid_label"/>
@@ -97,6 +98,7 @@
                 android:layout_marginStart="7dp"
                 android:textSize="14sp"
                 android:singleLine="true"
+                android:visibility="gone"
                 app:layout_constraintLeft_toRightOf="@id/profile_class_label"
                 app:layout_constraintTop_toBottomOf="@id/provider"
                 app:layout_constraintBottom_toTopOf="@+id/iccid"/>

From 68cc6adc9bdc0b00cd2212798511acafb0043dad Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 03:11:44 +0100
Subject: [PATCH 281/458] chore: reduce translatable strings (#93)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/93
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/res/values-ja/strings.xml | 2 --
 app-common/src/main/res/values/strings.xml    | 4 ++--
 app-unpriv/src/main/res/values-ja/strings.xml | 3 +--
 app-unpriv/src/main/res/values/strings.xml    | 2 +-
 app/src/main/res/values-ja/strings.xml        | 1 -
 app/src/main/res/values/strings.xml           | 2 +-
 6 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 0f25ca6f7..27041366a 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -6,8 +6,6 @@
     <string name="help">ヘルプ</string>
     <string name="reload">スロットを再読み込み</string>
     <string name="channel_name_format">論理スロット %d</string>
-    <string name="usb">USB</string>
-    <string name="omapi">OpenMobile API (OMAPI)</string>
     <string name="enabled">有効済み</string>
     <string name="disabled">無効済み</string>
     <string name="provider">プロバイダー:</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 8ea6e207e..a5a05abfd 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -7,8 +7,8 @@
     <string name="reload">Reload Slots</string>
 
     <string name="channel_name_format">Logical Slot %d</string>
-    <string name="usb">USB</string>
-    <string name="omapi">OpenMobile API (OMAPI)</string>
+    <string name="usb" translatable="false">USB</string>
+    <string name="omapi" translatable="false">OpenMobile API (OMAPI)</string>
 
     <string name="enabled">Enabled</string>
     <string name="disabled">Disabled</string>
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index 003b244e7..b8fac395a 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="channel_name_format">SIM %d</string>
     <string name="compatibility_check">互換性のチェック</string>
     <string name="open_sim_toolkit">SIM ツールキットを開く</string>
     <!-- Compatibility Check Descriptions -->
@@ -18,7 +17,7 @@
     <string name="compatibility_check_isdr_channel_desc_partial_fail">ISD-R への OMAPI アクセスは、次のスロットでのみ可能です: <b>SIM%s</b>.</string>
     <string name="compatibility_check_known_broken">既知の破損リストに掲載されていない</string>
     <string name="compatibility_check_known_broken_desc">取り外し可能な eSIM に関連するバグがデバイスに存在しないかを確認します。</string>
-    <string name="compatibility_check_known_broken_fail">おっと...使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
+    <string name="compatibility_check_known_broken_fail">おっと…使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
     <string name="compatibility_check_usb">USB カードリーダーのサポート</string>
     <string name="compatibility_check_usb_desc">使用しているデバイスは、USB カードリーダー経由の eSIM の管理をサポートしていますか？</string>
     <string name="compatibility_check_usb_ok">このデバイスの標準 USB CCID リーダーを介して eSIM を管理できます (ここで他のチェック項目に失敗した場合でも)。カードリーダーを挿入し、このアプリを開いてこの方法で eSIM を管理できます。</string>
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index fb7dc94f1..a75484876 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -1,6 +1,6 @@
 <resources>
     <string name="app_name" translatable="false">EasyEUICC</string>
-    <string name="channel_name_format">SIM %d</string>
+    <string name="channel_name_format" translatable="false">SIM %d</string>
     <string name="compatibility_check">Compatibility Check</string>
     <string name="open_sim_toolkit">Open SIM Toolkit</string>
 
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
index add6e9331..5ff67409f 100644
--- a/app/src/main/res/values-ja/strings.xml
+++ b/app/src/main/res/values-ja/strings.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">OpenEUICC</string>
     <string name="no_euicc">このデバイスで eUICC が見つかりません。\nデバイスによってはアプリのメニューからデュアル SIM を有効化する必要があります。</string>
     <string name="telephony_manager">TelephonyManager (特権)</string>
     <string name="dsds">デュアル SIM</string>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index f7dbd81b8..bb2233b8d 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -1,5 +1,5 @@
 <resources>
-    <string name="app_name">OpenEUICC</string>
+    <string name="app_name" translatable="false">OpenEUICC</string>
     <string name="no_euicc">No eUICC found on this device.\nOn some devices, you may need to enable dual SIM first in the menu of this app.</string>
     <string name="telephony_manager">TelephonyManager (Privileged)</string>
 

From 4e5bb5b11e2d880d613fe7c660f7d54e90bc3d29 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 7 Dec 2024 21:25:10 -0500
Subject: [PATCH 282/458] retire Android.mk to prevent AOSP from complaining

we don't use Android.mk for AOSP, but we do for the NDK JNI build. Let's
rename it so that the latest AOSP 15 QPR 1 stops complaining.
---
 Android.mk                                             | 0
 libs/lpac-jni/build.gradle.kts                         | 2 +-
 libs/lpac-jni/src/main/jni/{Android.mk => lpac-jni.mk} | 0
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 Android.mk
 rename libs/lpac-jni/src/main/jni/{Android.mk => lpac-jni.mk} (100%)

diff --git a/Android.mk b/Android.mk
deleted file mode 100644
index e69de29bb..000000000
diff --git a/libs/lpac-jni/build.gradle.kts b/libs/lpac-jni/build.gradle.kts
index 93f608206..636cdf347 100644
--- a/libs/lpac-jni/build.gradle.kts
+++ b/libs/lpac-jni/build.gradle.kts
@@ -32,7 +32,7 @@ android {
     }
     externalNativeBuild {
         ndkBuild {
-            path("src/main/jni/Android.mk")
+            path("src/main/jni/lpac-jni.mk")
         }
     }
     compileOptions {
diff --git a/libs/lpac-jni/src/main/jni/Android.mk b/libs/lpac-jni/src/main/jni/lpac-jni.mk
similarity index 100%
rename from libs/lpac-jni/src/main/jni/Android.mk
rename to libs/lpac-jni/src/main/jni/lpac-jni.mk

From d3e54ece58e59ee93bd19bb3ab91566552f13b76 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 16:29:05 +0100
Subject: [PATCH 283/458] chore: improve compatibility check (#96)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/96
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/CompatibilityCheckActivity.kt          | 20 +++++++++++--------
 app-unpriv/src/main/res/values/strings.xml    |  4 ++--
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
index 433f9c363..39a360f98 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
@@ -1,6 +1,8 @@
 package im.angry.openeuicc.ui
 
+import android.annotation.SuppressLint
 import android.os.Bundle
+import android.text.Html
 import android.view.MenuItem
 import android.view.View
 import android.view.ViewGroup
@@ -8,6 +10,7 @@ import android.widget.TextView
 import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.children
+import androidx.core.view.isVisible
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -29,15 +32,16 @@ class CompatibilityCheckActivity: AppCompatActivity() {
         setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
-        compatibilityCheckList = requireViewById(R.id.recycler_view)
-        compatibilityCheckList.layoutManager =
-            LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
-        compatibilityCheckList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
-        compatibilityCheckList.adapter = adapter
+        compatibilityCheckList = requireViewById<RecyclerView>(R.id.recycler_view).also {
+            it.layoutManager = LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
+            it.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
+            it.adapter = adapter
+        }
 
         setupRootViewInsets(compatibilityCheckList)
     }
 
+    @SuppressLint("NotifyDataSetChanged")
     override fun onStart() {
         super.onStart()
         lifecycleScope.launch {
@@ -61,10 +65,10 @@ class CompatibilityCheckActivity: AppCompatActivity() {
 
         fun bindItem(item: CompatibilityCheck) {
             titleView.text = item.title
-            descView.text = item.description
+            descView.text = Html.fromHtml(item.description, Html.FROM_HTML_MODE_COMPACT)
 
             statusContainer.children.forEach {
-                it.visibility = View.GONE
+                it.isVisible = false
             }
 
             val viewId = when (item.state) {
@@ -73,7 +77,7 @@ class CompatibilityCheckActivity: AppCompatActivity() {
                 CompatibilityCheck.State.FAILURE_UNKNOWN -> R.id.compatibility_check_unknown
                 else -> R.id.compatibility_check_progress_bar
             }
-            root.requireViewById<View>(viewId).visibility = View.VISIBLE
+            root.requireViewById<View>(viewId).isVisible = true
         }
     }
 
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index a75484876..3cf73473d 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -12,11 +12,11 @@
     <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
     <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
     <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: <b>SIM%s</b>.</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: &lt;b&gt;SIM%s&lt;/b&gt;.</string>
     <string name="compatibility_check_isdr_channel">ISD-R Channel Access</string>
     <string name="compatibility_check_isdr_channel_desc">Does your device support opening an ISD-R (management) channel to eSIMs via OMAPI?</string>
     <string name="compatibility_check_isdr_channel_desc_unknown">Cannot determine whether ISD-R access through OMAPI is supported. You might want to retry with SIM cards inserted (any SIM card will do) if not already.</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: <b>SIM%s</b>.</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: &lt;b&gt;SIM%s&lt;/b&gt;.</string>
     <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
     <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
     <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>

From dc0489a693704d10dba6ab579f4c56ae9bb38ccc Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 16:30:00 +0100
Subject: [PATCH 284/458] chore: simplify source code intent (#97)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/97
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/im/angry/openeuicc/ui/SettingsFragment.kt  | 4 ----
 app-common/src/main/res/xml/pref_settings.xml            | 9 +++++++--
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index f10f13484..6ad74c46d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -47,10 +47,6 @@ class SettingsFragment: PreferenceFragmentCompat() {
             setOnPreferenceClickListener(::onAppVersionClicked)
         }
 
-        findPreference<Preference>("pref_info_source_code")?.apply {
-            intent = Intent(Intent.ACTION_VIEW, Uri.parse(summary.toString()))
-        }
-
         findPreference<Preference>("pref_language")?.apply {
             if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return@apply
             isVisible = true
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 107e0b414..52815b9f8 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
+<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
     <im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory
         app:title="@string/pref_notifications"
         app:summary="@string/pref_notifications_desc"
@@ -88,6 +89,10 @@
             app:iconSpaceReserved="false"
             app:title="@string/pref_info_source_code"
             app:summary="@string/pref_info_source_code_url"
-            app:key="pref_info_source_code"/>
+            app:key="pref_info_source_code">
+            <intent
+                android:action="android.intent.action.VIEW"
+                android:data="@string/pref_info_source_code_url" />
+        </Preference>
     </PreferenceCategory>
 </PreferenceScreen>
\ No newline at end of file

From 249aea482b5e1ea44c18fcd3d103c351b2f1c306 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 16:31:39 +0100
Subject: [PATCH 285/458] refactor: euicc info activity (#98)

improve maintainability

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/98
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 121 ++++--------------
 1 file changed, 28 insertions(+), 93 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 8e475dfd7..fec769045 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -15,6 +15,7 @@ import androidx.recyclerview.widget.RecyclerView
 import androidx.recyclerview.widget.RecyclerView.ViewHolder
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
@@ -71,104 +72,38 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
         swipeRefresh.isRefreshing = true
 
         lifecycleScope.launch {
-            val unknownStr = getString(R.string.unknown)
-
-            val newItems = mutableListOf<Pair<String, String>>()
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_access_mode),
-                    euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.type }
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_removable),
-                    if (euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.port.card.isRemovable }) {
-                        getString(R.string.yes)
-                    } else {
-                        getString(R.string.no)
-                    }
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_eid),
-                    euiccChannelManager.withEuiccChannel(logicalSlotId) { channel -> channel.lpa.eID }
-                )
-            )
-
-            val euiccInfo2 = euiccChannelManager.withEuiccChannel(logicalSlotId) { channel ->
-                channel.lpa.euiccInfo2
-            }
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_firmware_version),
-                    euiccInfo2?.euiccFirmwareVersion ?: unknownStr
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_globalplatform_version),
-                    euiccInfo2?.globalPlatformVersion ?: unknownStr
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_pp_version),
-                    euiccInfo2?.ppVersion ?: unknownStr
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_sas_accreditation_number),
-                    euiccInfo2?.sasAccreditationNumber ?: unknownStr
-                )
-            )
-
-            newItems.add(
-                Pair(
-                getString(R.string.euicc_info_free_nvram),
-                euiccInfo2?.freeNvram?.let { formatFreeSpace(it) } ?: unknownStr
-            ))
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_gsma_prod),
-                    if (euiccInfo2?.euiccCiPKIdListForSigning?.contains(
-                            DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
-                        ) == true
-                    ) {
-                        getString(R.string.supported)
-                    } else {
-                        getString(R.string.unsupported)
-                    }
-                )
-            )
-
-            newItems.add(
-                Pair(
-                    getString(R.string.euicc_info_gsma_test),
-                    if (PKID_GSMA_TEST_CI.any { euiccInfo2?.euiccCiPKIdListForSigning?.contains(it) == true }) {
-                        getString(R.string.supported)
-                    } else {
-                        getString(R.string.unsupported)
-                    }
-                )
-            )
-
-            (infoList.adapter!! as EuiccInfoAdapter).euiccInfoItems = newItems
+            (infoList.adapter!! as EuiccInfoAdapter).euiccInfoItems =
+                euiccChannelManager.withEuiccChannel(logicalSlotId, ::buildPairs).map {
+                    Pair(getString(it.first), it.second ?: getString(R.string.unknown))
+                }
 
             swipeRefresh.isRefreshing = false
         }
     }
 
+    private fun buildPairs(channel: EuiccChannel) = buildList {
+        val forYesNo: (ok: Boolean) -> String =
+            { ok -> getString(if (ok) R.string.yes else R.string.no) }
+        val forSupport: (supported: Boolean) -> String =
+            { supported -> getString(if (supported) R.string.supported else R.string.unsupported) }
+        // @formatter:off
+        add(Pair(R.string.euicc_info_access_mode, channel.type))
+        add(Pair(R.string.euicc_info_removable, forYesNo(channel.port.card.isRemovable)))
+        add(Pair(R.string.euicc_info_eid, channel.lpa.eID))
+        channel.lpa.euiccInfo2.let { info ->
+            add(Pair(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
+            add(Pair(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion))
+            add(Pair(R.string.euicc_info_pp_version, info?.ppVersion))
+            add(Pair(R.string.euicc_info_sas_accreditation_number, info?.sasAccreditationNumber))
+            add(Pair(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
+        }
+        channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
+            add(Pair(R.string.euicc_info_gsma_prod, forSupport(signers.contains(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1))))
+            add(Pair(R.string.euicc_info_gsma_test, forSupport(PKID_GSMA_TEST_CI.any(signers::contains))))
+        }
+        // @formatter:on
+    }
+
     inner class EuiccInfoViewHolder(root: View) : ViewHolder(root) {
         private val title: TextView = root.requireViewById(R.id.euicc_info_title)
         private val content: TextView = root.requireViewById(R.id.euicc_info_content)

From 2247749b3737883437d426283e8529a893000371 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 10:35:03 -0500
Subject: [PATCH 286/458] ui: Set layout_constrainedWidth for profile title

---
 app-common/src/main/res/layout/euicc_profile.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/res/layout/euicc_profile.xml b/app-common/src/main/res/layout/euicc_profile.xml
index 797101765..58d55ab1e 100644
--- a/app-common/src/main/res/layout/euicc_profile.xml
+++ b/app-common/src/main/res/layout/euicc_profile.xml
@@ -28,7 +28,8 @@
                 app:layout_constraintRight_toLeftOf="@+id/profile_menu"
                 app:layout_constraintTop_toTopOf="parent"
                 app:layout_constraintBottom_toTopOf="@+id/state"
-                app:layout_constraintHorizontal_bias="0" />
+                app:layout_constraintHorizontal_bias="0"
+                app:layout_constrainedWidth="true" />
 
             <androidx.appcompat.widget.AppCompatImageButton
                 android:id="@+id/profile_menu"

From 790cbb5a580d760e3f7ac0a3cce810c25ab6901b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 10:42:32 -0500
Subject: [PATCH 287/458] i18n: Update ja translations

---
 app-common/src/main/res/values-ja/strings.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 27041366a..fed185d09 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -136,4 +136,8 @@
     <string name="pref_language_desc">アプリの言語を選択</string>
     <string name="pref_developer_unfiltered_profile_list">すべてのプロファイルを表示</string>
     <string name="pref_developer_unfiltered_profile_list_desc">プロダクション以外のプロファイルも表示する</string>
+    <string name="profile_class">タイプ:</string>
+    <string name="profile_class_testing">テスティング</string>
+    <string name="profile_class_provisioning">準備中</string>
+    <string name="profile_class_operational">動作中</string>
 </resources>

From a7e97378fcd39bb836a01433c87987c1ca01e1f1 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 10:51:14 -0500
Subject: [PATCH 288/458] Rework EuiccInfoActivity formatting

---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 44 +++++++++++++++----
 1 file changed, 35 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index fec769045..bb1d5b658 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -22,6 +22,11 @@ import net.typeblog.lpac_jni.impl.DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
 
 class EuiccInfoActivity : BaseEuiccAccessActivity() {
+    companion object {
+        private val YES_NO = Pair(R.string.yes, R.string.no)
+        private val SUPPORTED_UNSUPPORTED = Pair(R.string.supported, R.string.unsupported)
+    }
+
     private lateinit var swipeRefresh: SwipeRefreshLayout
     private lateinit var infoList: RecyclerView
 
@@ -82,13 +87,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
     }
 
     private fun buildPairs(channel: EuiccChannel) = buildList {
-        val forYesNo: (ok: Boolean) -> String =
-            { ok -> getString(if (ok) R.string.yes else R.string.no) }
-        val forSupport: (supported: Boolean) -> String =
-            { supported -> getString(if (supported) R.string.supported else R.string.unsupported) }
-        // @formatter:off
         add(Pair(R.string.euicc_info_access_mode, channel.type))
-        add(Pair(R.string.euicc_info_removable, forYesNo(channel.port.card.isRemovable)))
+        add(
+            Pair(
+                R.string.euicc_info_removable,
+                formatByBoolean(channel.port.card.isRemovable, YES_NO)
+            )
+        )
         add(Pair(R.string.euicc_info_eid, channel.lpa.eID))
         channel.lpa.euiccInfo2.let { info ->
             add(Pair(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
@@ -98,12 +103,33 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
             add(Pair(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
         }
         channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
-            add(Pair(R.string.euicc_info_gsma_prod, forSupport(signers.contains(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1))))
-            add(Pair(R.string.euicc_info_gsma_test, forSupport(PKID_GSMA_TEST_CI.any(signers::contains))))
+            add(
+                Pair(
+                    R.string.euicc_info_gsma_prod,
+                    formatByBoolean(
+                        signers.contains(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1),
+                        SUPPORTED_UNSUPPORTED
+                    )
+                )
+            )
+            add(
+                Pair(
+                    R.string.euicc_info_gsma_test,
+                    formatByBoolean(PKID_GSMA_TEST_CI.any(signers::contains), SUPPORTED_UNSUPPORTED)
+                )
+            )
         }
-        // @formatter:on
     }
 
+    private fun formatByBoolean(b: Boolean, res: Pair<Int, Int>): String =
+        getString(
+            if (b) {
+                res.first
+            } else {
+                res.second
+            }
+        )
+
     inner class EuiccInfoViewHolder(root: View) : ViewHolder(root) {
         private val title: TextView = root.requireViewById(R.id.euicc_info_title)
         private val content: TextView = root.requireViewById(R.id.euicc_info_content)

From 9be1ae7cd105cf2a24bae501274e0e0a4e02bc2c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 11:14:10 -0500
Subject: [PATCH 289/458] lpac-jni: Expose error reason enum as string

---
 .../lpac_jni/LocalProfileAssistant.kt         |  1 +
 .../java/net/typeblog/lpac_jni/LpacJni.kt     |  1 +
 .../impl/LocalProfileAssistantImpl.kt         |  1 +
 .../src/main/jni/lpac-jni/lpac-download.c     | 30 +++++++++++++++++++
 4 files changed, 33 insertions(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 58f25aa04..4ff65fad7 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -5,6 +5,7 @@ import net.typeblog.lpac_jni.HttpInterface.HttpResponse
 interface LocalProfileAssistant {
     @Suppress("ArrayInDataClass")
     data class ProfileDownloadException(
+        val lpaErrorReason: String,
         val lastHttpResponse: HttpResponse?,
         val lastHttpException: Exception?,
         val lastApduResponse: ByteArray?,
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 09c0117ea..8e3f53a99 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -29,6 +29,7 @@ internal object LpacJni {
     // We do not expose all of the functions because of tediousness :)
     external fun downloadProfile(handle: Long, smdp: String, matchingId: String?, imei: String?,
                                  confirmationCode: String?, callback: ProfileDownloadCallback): Int
+    external fun downloadErrCodeToString(code: Int): String
     external fun handleNotification(handle: Long, seqNumber: Long): Int
     // Cancel any ongoing es9p and/or es10b sessions
     external fun cancelSessions(handle: Long)
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 0cbebf0cf..b617f2bea 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -214,6 +214,7 @@ class LocalProfileAssistantImpl(
         if (res != 0) {
             // Construct the error now to store any error information we _can_ access
             val err = LocalProfileAssistant.ProfileDownloadException(
+                lpaErrorReason = LpacJni.downloadErrCodeToString(-res),
                 httpInterface.lastHttpResponse,
                 httpInterface.lastHttpException,
                 apduInterface.lastApduResponse,
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
index f63585a09..028e30d10 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
@@ -148,4 +148,34 @@ Java_net_typeblog_lpac_1jni_LpacJni_cancelSessions(JNIEnv *env, jobject thiz, jl
     es9p_cancel_session(ctx);
     es10b_cancel_session(ctx, ES10B_CANCEL_SESSION_REASON_UNDEFINED);
     euicc_http_cleanup(ctx);
+}
+
+#define QUOTE(S) #S
+#define ERRCODE_ENUM_TO_STRING(VARIANT) case VARIANT: return toJString(env, QUOTE(VARIANT))
+
+JNIEXPORT jstring JNICALL
+Java_net_typeblog_lpac_1jni_LpacJni_downloadErrCodeToString(JNIEnv *env, jobject thiz, jint code) {
+    switch (code) {
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INCORRECT_INPUT_VALUES);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INVALID_SIGNATURE);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INVALID_TRANSACTION_ID);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_UNSUPPORTED_CRT_VALUES);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_UNSUPPORTED_REMOTE_OPERATION_TYPE);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_UNSUPPORTED_PROFILE_CLASS);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_SCP03T_STRUCTURE_ERROR);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_SCP03T_SECURITY_ERROR);
+        ERRCODE_ENUM_TO_STRING(
+                ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_ICCID_ALREADY_EXISTS_ON_EUICC);
+        ERRCODE_ENUM_TO_STRING(
+                ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_INSUFFICIENT_MEMORY_FOR_PROFILE);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_INTERRUPTION);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_PE_PROCESSING_ERROR);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_ICCID_MISMATCH);
+        ERRCODE_ENUM_TO_STRING(
+                ES10B_ERROR_REASON_TEST_PROFILE_INSTALL_FAILED_DUE_TO_INVALID_NAA_KEY);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_PPR_NOT_ALLOWED);
+        ERRCODE_ENUM_TO_STRING(ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_UNKNOWN_ERROR);
+        default:
+            return toJString(env, "ES10B_ERROR_REASON_UNDEFINED");
+    }
 }
\ No newline at end of file

From 1140ddb249990dbb9a87fd29e48169b114609774 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 11:15:11 -0500
Subject: [PATCH 290/458] lpac-jni: IgnoreTLSCertificate ->
 AllowAllTrustManager

---
 .../impl/{IgnoreTLSCertificate.kt => AllowAllTrustManager.kt}   | 2 +-
 .../main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/{IgnoreTLSCertificate.kt => AllowAllTrustManager.kt} (92%)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/AllowAllTrustManager.kt
similarity index 92%
rename from libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt
rename to libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/AllowAllTrustManager.kt
index 7b1328254..55b28fe8a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/IgnoreTLSCertificate.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/AllowAllTrustManager.kt
@@ -5,7 +5,7 @@ import java.security.cert.X509Certificate
 import javax.net.ssl.X509TrustManager
 
 @SuppressLint("CustomX509TrustManager")
-class IgnoreTLSCertificate : X509TrustManager {
+class AllowAllTrustManager : X509TrustManager {
     @SuppressLint("TrustAllX509TrustManager")
     override fun checkClientTrusted(p0: Array<out X509Certificate>?, p1: String?) {
         return
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
index 77227f860..c1b15f78a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/HttpInterfaceImpl.kt
@@ -83,7 +83,7 @@ class HttpInterfaceImpl(
     private fun getSocketFactory(): SSLSocketFactory {
         val trustManagers =
             if (runBlocking { ignoreTLSCertificateFlow.first() }) {
-                arrayOf(IgnoreTLSCertificate())
+                arrayOf(AllowAllTrustManager())
             } else {
                 this.trustManagers
             }

From 022ca1da9d92012508815773101915deb9507b27 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 18:51:48 +0100
Subject: [PATCH 291/458] chore: improve readability (#95)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/95
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/MainActivity.kt     | 42 ++++++++-----------
 .../openeuicc/ui/ProfileDeleteFragment.kt     |  5 ++-
 .../openeuicc/ui/UsbCcidReaderFragment.kt     |  8 ++--
 .../angry/openeuicc/util/PermissionUtils.kt   | 13 ++++++
 .../openeuicc/service/OpenEuiccService.kt     |  2 +-
 .../openeuicc/ui/PrivilegedMainActivity.kt    |  7 ++--
 6 files changed, 41 insertions(+), 36 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 7711643f8..198226aaf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -66,8 +66,9 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private val usbReceiver = object : BroadcastReceiver() {
         override fun onReceive(context: Context?, intent: Intent?) {
-            if (intent?.action == UsbManager.ACTION_USB_DEVICE_ATTACHED || intent?.action == UsbManager.ACTION_USB_DEVICE_DETACHED) {
-                refresh(true)
+            when (intent?.action) {
+                UsbManager.ACTION_USB_DEVICE_ATTACHED -> refresh(fromUsbEvent = true)
+                UsbManager.ACTION_USB_DEVICE_DETACHED -> refresh(fromUsbEvent = true)
             }
         }
     }
@@ -126,10 +127,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private fun ensureNotificationPermissions() {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
             requestPermissions(
-                arrayOf(android.Manifest.permission.POST_NOTIFICATIONS),
-                PERMISSION_REQUEST_CODE
+                PERMISSION_REQUEST_CODE,
+                android.Manifest.permission.POST_NOTIFICATIONS
             )
         }
     }
@@ -160,38 +161,29 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 // but it could change in the future
                 euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
 
-                newPages.add(
-                    Page(
-                        channel.logicalSlotId,
-                        getString(R.string.channel_name_format, channel.logicalSlotId)
-                    ) {
-                        appContainer.uiComponentFactory.createEuiccManagementFragment(
-                            slotId,
-                            portId
-                        )
-                    })
+                val channelName = getString(R.string.channel_name_format, channel.logicalSlotId)
+                newPages.add(Page(channel.logicalSlotId, channelName) {
+                    appContainer.uiComponentFactory.createEuiccManagementFragment(slotId, portId)
+                })
             }
         }.collect()
 
         // If USB readers exist, add them at the very last
         // We use a wrapper fragment to handle logic specific to USB readers
         usbDevice?.let {
-            newPages.add(
-                Page(
-                    EuiccChannelManager.USB_CHANNEL_ID,
-                    it.productName ?: getString(R.string.usb)
-                ) { UsbCcidReaderFragment() })
+            val productName = it.productName ?: getString(R.string.usb)
+            newPages.add(Page(EuiccChannelManager.USB_CHANNEL_ID, productName) {
+                UsbCcidReaderFragment()
+            })
         }
         viewPager.visibility = View.VISIBLE
 
         if (newPages.size > 1) {
             tabs.visibility = View.VISIBLE
         } else if (newPages.isEmpty()) {
-            newPages.add(
-                Page(
-                    -1,
-                    ""
-                ) { appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment() })
+            newPages.add(Page(-1, "") {
+                appContainer.uiComponentFactory.createNoEuiccPlaceholderFragment()
+            })
         }
 
         newPages.sortBy { it.logicalSlotId }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index 181aeee18..cde1fee46 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -39,12 +39,13 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
     private var deleting = false
 
     override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
-        return AlertDialog.Builder(requireContext(), R.style.AlertDialogTheme).apply {
+        AlertDialog.Builder(requireContext(), R.style.AlertDialogTheme).apply {
             setMessage(getString(R.string.profile_delete_confirm, requireArguments().getString("name")))
             setView(editText)
             setPositiveButton(android.R.string.ok, null) // Set listener to null to prevent auto closing
             setNegativeButton(android.R.string.cancel, null)
-        }.create()
+            return create()
+        }
     }
 
     override fun onResume() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
index d104582f0..7a52ca0dd 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/UsbCcidReaderFragment.kt
@@ -120,7 +120,7 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
         try {
             requireContext().unregisterReceiver(usbPermissionReceiver)
         } catch (_: Exception) {
-
+            // ignore
         }
     }
 
@@ -129,7 +129,7 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
         try {
             requireContext().unregisterReceiver(usbPermissionReceiver)
         } catch (_: Exception) {
-
+            // ignore
         }
     }
 
@@ -155,8 +155,8 @@ class UsbCcidReaderFragment : Fragment(), OpenEuiccContextMarker {
                 replace(
                     R.id.child_container,
                     appContainer.uiComponentFactory.createEuiccManagementFragment(
-                        EuiccChannelManager.USB_CHANNEL_ID,
-                        0
+                        slotId = EuiccChannelManager.USB_CHANNEL_ID,
+                        portId = 0
                     )
                 )
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt
new file mode 100644
index 000000000..ba02b79dc
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt
@@ -0,0 +1,13 @@
+package im.angry.openeuicc.util
+
+import android.app.Activity
+import android.content.pm.PackageManager
+
+fun Activity.requestPermissions(requestCode: Int, vararg permissions: String) {
+    val deniedPermissions = permissions.filter { name ->
+        checkSelfPermission(name) == PackageManager.PERMISSION_DENIED
+    }
+    if (deniedPermissions.isNotEmpty()) {
+        requestPermissions(deniedPermissions.toTypedArray(), requestCode)
+    }
+}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index d62633388..3c522c583 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -110,7 +110,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             telephonyManager.simSlotMapping = mappings
             return
         } catch (_: Exception) {
-
+            // ignore
         }
 
         // Sometimes hardware supports one ordering but not the reverse
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
index 440e52908..d00e3c088 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedMainActivity.kt
@@ -16,10 +16,9 @@ class PrivilegedMainActivity : MainActivity() {
             menu.findItem(R.id.slot_mapping).isVisible = false
         }
 
-        if (tm.supportsDSDS) {
-            val dsds = menu.findItem(R.id.dsds)
-            dsds.isVisible = true
-            dsds.isChecked = tm.dsdsEnabled
+        menu.findItem(R.id.dsds).apply {
+            isVisible = tm.supportsDSDS
+            isChecked = tm.dsdsEnabled
         }
 
         return true

From 38d38523f94d3c3ce10732020a41b8831a33adec Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 12:54:33 -0500
Subject: [PATCH 292/458] Revert MainActivity changes

---
 .../src/main/java/im/angry/openeuicc/ui/MainActivity.kt    | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 198226aaf..260d5cdc8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -66,9 +66,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private val usbReceiver = object : BroadcastReceiver() {
         override fun onReceive(context: Context?, intent: Intent?) {
-            when (intent?.action) {
-                UsbManager.ACTION_USB_DEVICE_ATTACHED -> refresh(fromUsbEvent = true)
-                UsbManager.ACTION_USB_DEVICE_DETACHED -> refresh(fromUsbEvent = true)
+            if (intent?.action == UsbManager.ACTION_USB_DEVICE_ATTACHED || intent?.action == UsbManager.ACTION_USB_DEVICE_DETACHED) {
+                refresh(true)
             }
         }
     }
@@ -127,7 +126,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private fun ensureNotificationPermissions() {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
             requestPermissions(
                 PERMISSION_REQUEST_CODE,
                 android.Manifest.permission.POST_NOTIFICATIONS

From 5a000278d37688c4fdd0011e1cc2784602bbd218 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 12:55:42 -0500
Subject: [PATCH 293/458] Revert meaningless PermissionUtils

---
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt |  4 ++--
 .../java/im/angry/openeuicc/util/PermissionUtils.kt | 13 -------------
 2 files changed, 2 insertions(+), 15 deletions(-)
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 260d5cdc8..84ce96dee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -128,8 +128,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     private fun ensureNotificationPermissions() {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
             requestPermissions(
-                PERMISSION_REQUEST_CODE,
-                android.Manifest.permission.POST_NOTIFICATIONS
+                arrayOf(android.Manifest.permission.POST_NOTIFICATIONS),
+                PERMISSION_REQUEST_CODE
             )
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt
deleted file mode 100644
index ba02b79dc..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/util/PermissionUtils.kt
+++ /dev/null
@@ -1,13 +0,0 @@
-package im.angry.openeuicc.util
-
-import android.app.Activity
-import android.content.pm.PackageManager
-
-fun Activity.requestPermissions(requestCode: Int, vararg permissions: String) {
-    val deniedPermissions = permissions.filter { name ->
-        checkSelfPermission(name) == PackageManager.PERMISSION_DENIED
-    }
-    if (deniedPermissions.isNotEmpty()) {
-        requestPermissions(deniedPermissions.toTypedArray(), requestCode)
-    }
-}
\ No newline at end of file

From b4f562f90b2126548ebff70ef86081ca37e91120 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 12:58:24 -0500
Subject: [PATCH 294/458] Make MainActivity permission checks clearer

---
 .../src/main/java/im/angry/openeuicc/ui/MainActivity.kt      | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 84ce96dee..b11a3ddd9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -126,7 +126,10 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     }
 
     private fun ensureNotificationPermissions() {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
+        val needsNotificationPerms = Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU;
+        val notificationPermsGranted =
+            needsNotificationPerms && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED
+        if (needsNotificationPerms && !notificationPermsGranted) {
             requestPermissions(
                 arrayOf(android.Manifest.permission.POST_NOTIFICATIONS),
                 PERMISSION_REQUEST_CODE

From 400c2ff9f91681df63f49bc4199e6698af843174 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 12:59:27 -0500
Subject: [PATCH 295/458] ProfileDeleteFragment: Stop using non-local returns
 for no reason

---
 .../java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt     | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index cde1fee46..a06b587e7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -38,15 +38,13 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         get() = editText.text.toString() == requireArguments().getString("name")!!
     private var deleting = false
 
-    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
+    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog =
         AlertDialog.Builder(requireContext(), R.style.AlertDialogTheme).apply {
             setMessage(getString(R.string.profile_delete_confirm, requireArguments().getString("name")))
             setView(editText)
             setPositiveButton(android.R.string.ok, null) // Set listener to null to prevent auto closing
             setNegativeButton(android.R.string.cancel, null)
-            return create()
-        }
-    }
+        }.create()
 
     override fun onResume() {
         super.onResume()

From 5b80afd5fe7921651c3ae57edc3ac8ee641a8d44 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 13:39:15 -0500
Subject: [PATCH 296/458] ui: Expose download error reason in diagnostics

---
 .../ui/wizard/DownloadWizardDiagnosticsFragment.kt        | 8 ++++++++
 app-common/src/main/res/values-ja/strings.xml             | 1 +
 app-common/src/main/res/values/strings.xml                | 1 +
 3 files changed, 10 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index 6c578ddee..b281ec471 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -44,6 +44,14 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
     private fun buildDiagnosticsText(): String? = state.downloadError?.let { err ->
         val ret = StringBuilder()
 
+        ret.appendLine(
+            getString(
+                R.string.download_wizard_diagnostics_error_code,
+                err.lpaErrorReason
+            )
+        )
+        ret.appendLine()
+
         err.lastHttpResponse?.let { resp ->
             if (resp.rcode != 200) {
                 // Only show the status if it's not 200
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index fed185d09..ea8792d66 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -68,6 +68,7 @@
     <string name="download_wizard_progress_step_downloading">eSIM プロファイルをダウンロード中です</string>
     <string name="download_wizard_progress_step_finalizing">eSIM プロファイルをストレージに読み込み中です</string>
     <string name="download_wizard_diagnostics">エラー診断</string>
+    <string name="download_wizard_diagnostics_error_code">エラーコード: %s</string>
     <string name="download_wizard_diagnostics_last_http_status">最終の HTTP ステータス (サーバー): %d</string>
     <string name="download_wizard_diagnostics_last_http_response">最終の HTTP レスポンス (サーバー):</string>
     <string name="download_wizard_diagnostics_last_http_exception">最終の HTTP 例外:</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a5a05abfd..4c40eb299 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -86,6 +86,7 @@
     <string name="download_wizard_progress_step_downloading">Downloading eSIM profile</string>
     <string name="download_wizard_progress_step_finalizing">Loading eSIM profile into storage</string>
     <string name="download_wizard_diagnostics">Error diagnostics</string>
+    <string name="download_wizard_diagnostics_error_code">Error code: %s</string>
     <string name="download_wizard_diagnostics_last_http_status">Last HTTP status (from server): %d</string>
     <string name="download_wizard_diagnostics_last_http_response">Last HTTP response (from server):</string>
     <string name="download_wizard_diagnostics_last_http_exception">Last HTTP exception:</string>

From eab60bf3d3ba4becdbdac592d8bdefca1663ec10 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 13:44:02 -0500
Subject: [PATCH 297/458] ui: priv: Set isMEP and isRemovable when creating
 footer views

Else, footer views may be created before we actually intialize that
info.
---
 .../ui/PrivilegedEuiccManagementFragment.kt         | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
index 688ae6c91..12b60bdaf 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedEuiccManagementFragment.kt
@@ -17,19 +17,16 @@ class PrivilegedEuiccManagementFragment: EuiccManagementFragment() {
     private var isMEP = false
     private var isRemovable = false
 
-    override suspend fun doRefresh() {
-        super.doRefresh()
-        withEuiccChannel { channel ->
-            isMEP = channel.isMEP
-            isRemovable = channel.port.card.isRemovable
-        }
-    }
-
     override suspend fun onCreateFooterViews(
         parent: ViewGroup,
         profiles: List<LocalProfileInfo>
     ): List<View> =
         super.onCreateFooterViews(parent, profiles).let { footers ->
+            withEuiccChannel { channel ->
+                isMEP = channel.isMEP
+                isRemovable = channel.port.card.isRemovable
+            }
+
             if (isMEP) {
                 val view = layoutInflater.inflate(R.layout.footer_mep, parent, false)
                 view.requireViewById<Button>(R.id.footer_mep_slot_mapping).setOnClickListener {

From 700578a36990800015b80877dfb177f37959edca Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 15:34:38 -0500
Subject: [PATCH 298/458] ui: wizard: Handle download success

Turns out when you test only errors you forget things can actually
succeed...
---
 .../ui/wizard/DownloadWizardProgressFragment.kt       | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index f6f63fd6c..1b816d48f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -113,18 +113,19 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                     is EuiccChannelManagerService.ForegroundTaskState.Done -> {
                         hideProgressBar()
 
-                        // Change the state of the last InProgress item to Error
+                        state.downloadError =
+                            it.error as? LocalProfileAssistant.ProfileDownloadException
+
+                        // Change the state of the last InProgress item to success (or error)
                         progressItems.forEachIndexed { index, progressItem ->
                             if (progressItem.state == ProgressState.InProgress) {
-                                progressItem.state = ProgressState.Error
+                                progressItem.state =
+                                    if (state.downloadError == null) ProgressState.Done else ProgressState.Error
                             }
 
                             adapter.notifyItemChanged(index)
                         }
 
-                        state.downloadError =
-                            it.error as? LocalProfileAssistant.ProfileDownloadException
-
                         isDone = true
                         refreshButtons()
                     }

From 15d3b701a50967cd2491dd5469aa40c0dec26ba6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 15:42:24 -0500
Subject: [PATCH 299/458] Switch LuiActivity to the new wizard

...and rename / alias the old DirectProfileDownloadActivity to the new
DownloadWizardActivity
---
 app-common/src/main/AndroidManifest.xml       |  9 ++--
 .../ui/DirectProfileDownloadActivity.kt       | 52 -------------------
 .../java/im/angry/openeuicc/ui/LuiActivity.kt |  6 ++-
 3 files changed, 8 insertions(+), 59 deletions(-)
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index a33838f77..80e580394 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -19,11 +19,6 @@
             android:name="im.angry.openeuicc.ui.NotificationsActivity"
             android:label="@string/profile_notifications" />
 
-        <activity
-            android:name="im.angry.openeuicc.ui.DirectProfileDownloadActivity"
-            android:label="@string/profile_download"
-            android:theme="@style/Theme.AppCompat.Translucent" />
-
         <activity
             android:name="im.angry.openeuicc.ui.EuiccInfoActivity"
             android:label="@string/euicc_info" />
@@ -36,6 +31,10 @@
             android:name="im.angry.openeuicc.ui.wizard.DownloadWizardActivity"
             android:label="@string/download_wizard" />
 
+        <activity-alias
+            android:name="im.angry.openeuicc.ui.DirectProfileDownloadActivity"
+            android:targetActivity="im.angry.openeuicc.ui.wizard.DownloadWizardActivity" />
+
         <activity
             android:name="com.journeyapps.barcodescanner.CaptureActivity"
             android:screenOrientation="fullSensor"
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
deleted file mode 100644
index 4baf36b98..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/ui/DirectProfileDownloadActivity.kt
+++ /dev/null
@@ -1,52 +0,0 @@
-package im.angry.openeuicc.ui
-
-import androidx.lifecycle.lifecycleScope
-import im.angry.openeuicc.util.*
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.flow.map
-import kotlinx.coroutines.flow.toList
-import kotlinx.coroutines.launch
-import kotlinx.coroutines.withContext
-
-class DirectProfileDownloadActivity : BaseEuiccAccessActivity(), SlotSelectFragment.SlotSelectedListener, OpenEuiccContextMarker {
-    override fun onInit() {
-        lifecycleScope.launch {
-            val knownChannels = withContext(Dispatchers.IO) {
-                euiccChannelManager.flowEuiccPorts().map { (slotId, portId) ->
-                    euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
-                        Triple(slotId, channel.logicalSlotId, portId)
-                    }
-                }.toList().sortedBy { it.second }
-            }
-
-            when {
-                knownChannels.isEmpty() -> {
-                    finish()
-                }
-                // Detect multiple eUICC chips
-                knownChannels.distinctBy { it.first }.size > 1 -> {
-                    SlotSelectFragment.newInstance(
-                        knownChannels.map { it.first },
-                        knownChannels.map { it.second },
-                        knownChannels.map { it.third })
-                        .show(supportFragmentManager, SlotSelectFragment.TAG)
-                }
-                else -> {
-                    // If the device has only one eSIM "chip" (but may be mapped to multiple slots),
-                    // we can skip the slot selection dialog since there is only one chip to save to.
-                    onSlotSelected(
-                        knownChannels[0].first,
-                        knownChannels[0].third
-                    )
-                }
-            }
-        }
-    }
-
-    override fun onSlotSelected(slotId: Int, portId: Int) {
-        ProfileDownloadFragment.newInstance(slotId, portId, finishWhenDone = true)
-            .show(supportFragmentManager, ProfileDownloadFragment.TAG)
-    }
-
-    override fun onSlotSelectCancelled() = finish()
-}
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
index d7ac213bd..de2ca2474 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/LuiActivity.kt
@@ -8,6 +8,7 @@ import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
 import im.angry.openeuicc.R
+import im.angry.openeuicc.ui.wizard.DownloadWizardActivity
 
 class LuiActivity : AppCompatActivity() {
     override fun onStart() {
@@ -25,10 +26,11 @@ class LuiActivity : AppCompatActivity() {
         }
 
         requireViewById<View>(R.id.lui_skip).setOnClickListener { finish() }
-        // TODO: Deactivate LuiActivity if there is no eSIM found.
+        // TODO: Deactivate DownloadWizardActivity if there is no eSIM found.
         // TODO: Support pre-filled download info (from carrier apps); UX
         requireViewById<View>(R.id.lui_download).setOnClickListener {
-            startActivity(Intent(this, DirectProfileDownloadActivity::class.java))
+            startActivity(Intent(this, DownloadWizardActivity::class.java))
+            finish()
         }
     }
 }
\ No newline at end of file

From 0229ef41dfa33943cd44d98de27b2c4c21666acf Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 16:07:23 -0500
Subject: [PATCH 300/458] ui: wizard: Allow saving diagnostics text

---
 .../DownloadWizardDiagnosticsFragment.kt      | 24 ++++++++++++++++++-
 .../layout/fragment_download_diagnostics.xml  | 11 +++++++++
 app-common/src/main/res/values-ja/strings.xml |  2 ++
 app-common/src/main/res/values/strings.xml    |  2 ++
 4 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index b281ec471..fbbd1a006 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -1,12 +1,16 @@
 package im.angry.openeuicc.ui.wizard
 
+import android.icu.text.SimpleDateFormat
 import android.os.Bundle
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
+import androidx.activity.result.contract.ActivityResultContracts
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
+import java.io.FileOutputStream
+import java.util.Date
 
 class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
     override val hasNext: Boolean
@@ -16,6 +20,16 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
 
     private lateinit var diagnosticTextView: TextView
 
+    private val saveDiagnostics =
+        registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
+            if (uri == null) return@registerForActivityResult
+            requireActivity().contentResolver.openFileDescriptor(uri, "w")?.use {
+                FileOutputStream(it.fileDescriptor).use { os ->
+                    os.write(diagnosticTextView.text.toString().encodeToByteArray())
+                }
+            }
+        }
+
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
@@ -26,7 +40,15 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
         savedInstanceState: Bundle?
     ): View? {
         val view = inflater.inflate(R.layout.fragment_download_diagnostics, container, false)
-        diagnosticTextView = view.requireViewById<TextView>(R.id.download_wizard_diagnostics_text)
+        view.requireViewById<View>(R.id.download_wizard_diagnostics_save).setOnClickListener {
+            saveDiagnostics.launch(
+                getString(
+                    R.string.download_wizard_diagnostics_file_template,
+                    SimpleDateFormat.getDateTimeInstance().format(Date())
+                )
+            )
+        }
+        diagnosticTextView = view.requireViewById(R.id.download_wizard_diagnostics_text)
         return view
     }
 
diff --git a/app-common/src/main/res/layout/fragment_download_diagnostics.xml b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
index b9a0bc250..8b663e741 100644
--- a/app-common/src/main/res/layout/fragment_download_diagnostics.xml
+++ b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
@@ -26,6 +26,17 @@
             app:layout_constrainedWidth="true"
             app:layout_constraintTop_toTopOf="parent" />
 
+        <ImageButton
+            android:id="@+id/download_wizard_diagnostics_save"
+            android:src="@drawable/ic_save_as_black"
+            android:layout_margin="20dp"
+            android:layout_width="24dp"
+            android:layout_height="24dp"
+            android:contentDescription="@string/download_wizard_diagnostics_save"
+            app:tint="?attr/colorAccent"
+            app:layout_constraintTop_toTopOf="parent"
+            app:layout_constraintEnd_toEndOf="parent" />
+
         <TextView
             android:id="@+id/download_wizard_diagnostics_text"
             android:layout_width="match_parent"
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index ea8792d66..f4eb35df0 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -76,6 +76,8 @@
     <string name="download_wizard_diagnostics_last_apdu_response_success">最終の APDU レスポンス (SIM) は成功しました</string>
     <string name="download_wizard_diagnostics_last_apdu_response_fail">最終の APDU レスポンス (SIM) は失敗しました</string>
     <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
+    <string name="download_wizard_diagnostics_save">保存</string>
+    <string name="download_wizard_diagnostics_file_template">%s のエラー診断</string>
     <string name="profile_rename_new_name">新しいニックネーム</string>
     <string name="profile_delete_confirm">%s のプロファイルを削除してもよろしいですか？この操作は元に戻せません。</string>
     <string name="profile_delete_confirm_input">削除を確認するには「%s」を入力してください</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4c40eb299..14d25a356 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -94,6 +94,8 @@
     <string name="download_wizard_diagnostics_last_apdu_response_success">Last APDU response (from SIM) is successful</string>
     <string name="download_wizard_diagnostics_last_apdu_response_fail">Last APDU response (from SIM) is a failure</string>
     <string name="download_wizard_diagnostics_last_apdu_exception">Last APDU exception:</string>
+    <string name="download_wizard_diagnostics_save">Save</string>
+    <string name="download_wizard_diagnostics_file_template">Diagnostics at %s</string>
 
     <string name="profile_rename_new_name">New nickname</string>
 

From 84f47cb0f01455c4f71b96ef8067760f8b68a136 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 16:09:39 -0500
Subject: [PATCH 301/458] ui: wizard: Use dp instead of sp in margins

---
 .../src/main/res/layout/fragment_download_details.xml     | 8 ++++----
 .../src/main/res/layout/fragment_download_diagnostics.xml | 8 ++++----
 .../main/res/layout/fragment_download_method_select.xml   | 8 ++++----
 .../src/main/res/layout/fragment_download_progress.xml    | 8 ++++----
 .../src/main/res/layout/fragment_download_slot_select.xml | 8 ++++----
 5 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/app-common/src/main/res/layout/fragment_download_details.xml b/app-common/src/main/res/layout/fragment_download_details.xml
index ca36d6450..3f58844bf 100644
--- a/app-common/src/main/res/layout/fragment_download_details.xml
+++ b/app-common/src/main/res/layout/fragment_download_details.xml
@@ -16,10 +16,10 @@
             android:layout_height="wrap_content"
             android:gravity="center_horizontal"
             android:textSize="20sp"
-            android:layout_marginTop="20sp"
-            android:layout_marginBottom="20sp"
-            android:layout_marginStart="60sp"
-            android:layout_marginEnd="60sp"
+            android:layout_marginTop="20dp"
+            android:layout_marginBottom="20dp"
+            android:layout_marginStart="60dp"
+            android:layout_marginEnd="60dp"
             app:layout_constraintStart_toStartOf="parent"
             app:layout_constraintEnd_toEndOf="parent"
             app:layout_constrainedWidth="true"
diff --git a/app-common/src/main/res/layout/fragment_download_diagnostics.xml b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
index 8b663e741..88b1ffba2 100644
--- a/app-common/src/main/res/layout/fragment_download_diagnostics.xml
+++ b/app-common/src/main/res/layout/fragment_download_diagnostics.xml
@@ -17,10 +17,10 @@
             android:layout_height="wrap_content"
             android:gravity="center_horizontal"
             android:textSize="20sp"
-            android:layout_marginTop="20sp"
-            android:layout_marginBottom="20sp"
-            android:layout_marginStart="60sp"
-            android:layout_marginEnd="60sp"
+            android:layout_marginTop="20dp"
+            android:layout_marginBottom="20dp"
+            android:layout_marginStart="60dp"
+            android:layout_marginEnd="60dp"
             app:layout_constraintStart_toStartOf="parent"
             app:layout_constraintEnd_toEndOf="parent"
             app:layout_constrainedWidth="true"
diff --git a/app-common/src/main/res/layout/fragment_download_method_select.xml b/app-common/src/main/res/layout/fragment_download_method_select.xml
index a57e1862a..7fe223414 100644
--- a/app-common/src/main/res/layout/fragment_download_method_select.xml
+++ b/app-common/src/main/res/layout/fragment_download_method_select.xml
@@ -11,10 +11,10 @@
         android:layout_height="wrap_content"
         android:gravity="center_horizontal"
         android:textSize="20sp"
-        android:layout_marginTop="20sp"
-        android:layout_marginBottom="20sp"
-        android:layout_marginStart="60sp"
-        android:layout_marginEnd="60sp"
+        android:layout_marginTop="20dp"
+        android:layout_marginBottom="20dp"
+        android:layout_marginStart="60dp"
+        android:layout_marginEnd="60dp"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constrainedWidth="true"
diff --git a/app-common/src/main/res/layout/fragment_download_progress.xml b/app-common/src/main/res/layout/fragment_download_progress.xml
index 0ec58e454..82ebb2584 100644
--- a/app-common/src/main/res/layout/fragment_download_progress.xml
+++ b/app-common/src/main/res/layout/fragment_download_progress.xml
@@ -11,10 +11,10 @@
         android:layout_height="wrap_content"
         android:gravity="center_horizontal"
         android:textSize="20sp"
-        android:layout_marginTop="20sp"
-        android:layout_marginBottom="20sp"
-        android:layout_marginStart="60sp"
-        android:layout_marginEnd="60sp"
+        android:layout_marginTop="20dp"
+        android:layout_marginBottom="20dp"
+        android:layout_marginStart="60dp"
+        android:layout_marginEnd="60dp"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constrainedWidth="true"
diff --git a/app-common/src/main/res/layout/fragment_download_slot_select.xml b/app-common/src/main/res/layout/fragment_download_slot_select.xml
index 3dfe6fdf3..69b153532 100644
--- a/app-common/src/main/res/layout/fragment_download_slot_select.xml
+++ b/app-common/src/main/res/layout/fragment_download_slot_select.xml
@@ -11,10 +11,10 @@
         android:layout_height="wrap_content"
         android:gravity="center_horizontal"
         android:textSize="20sp"
-        android:layout_marginTop="20sp"
-        android:layout_marginBottom="20sp"
-        android:layout_marginStart="60sp"
-        android:layout_marginEnd="60sp"
+        android:layout_marginTop="20dp"
+        android:layout_marginBottom="20dp"
+        android:layout_marginStart="60dp"
+        android:layout_marginEnd="60dp"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constrainedWidth="true"

From fdbf9b3252af7c3303930b9c6257dc0d57816d34 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 16:17:50 -0500
Subject: [PATCH 302/458] ui: wizard: Reimplement low nvram warning

---
 .../DownloadWizardSlotSelectFragment.kt       | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index c9a9e0f7a..b268b626c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -7,6 +7,7 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.CheckBox
 import android.widget.TextView
+import androidx.appcompat.app.AlertDialog
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -20,6 +21,11 @@ import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.LocalProfileInfo
 
 class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
+    companion object {
+        const val LOW_NVRAM_THRESHOLD =
+            30 * 1024 // < 30 KiB, alert about potential download failure
+    }
+
     private data class SlotInfo(
         val logicalSlotId: Int,
         val isRemovable: Boolean,
@@ -45,6 +51,21 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
+    override fun beforeNext() {
+        super.beforeNext()
+
+        if (adapter.selected.freeSpace < LOW_NVRAM_THRESHOLD) {
+            AlertDialog.Builder(requireContext()).apply {
+                setTitle(R.string.profile_download_low_nvram_title)
+                setMessage(R.string.profile_download_low_nvram_message)
+                setCancelable(true)
+                setPositiveButton(android.R.string.ok, null)
+                setNegativeButton(android.R.string.cancel, null)
+                show()
+            }
+        }
+    }
+
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
@@ -165,6 +186,9 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         var slots: List<SlotInfo> = listOf()
         var currentSelectedIdx = -1
 
+        val selected: SlotInfo
+            get() = slots[currentSelectedIdx]
+
         override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): SlotItemHolder {
             val root = LayoutInflater.from(parent.context).inflate(R.layout.download_slot_item, parent, false)
             return SlotItemHolder(root)

From 09b98b37ab0c09fd07ea5adf4a017364282fd097 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 16:19:14 -0500
Subject: [PATCH 303/458] Export DownloadWizardActivity

---
 app-common/src/main/AndroidManifest.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index 80e580394..f53e6ffc3 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -28,10 +28,12 @@
             android:label="@string/pref_advanced_logs" />
 
         <activity
+            android:exported="true"
             android:name="im.angry.openeuicc.ui.wizard.DownloadWizardActivity"
             android:label="@string/download_wizard" />
 
         <activity-alias
+            android:exported="true"
             android:name="im.angry.openeuicc.ui.DirectProfileDownloadActivity"
             android:targetActivity="im.angry.openeuicc.ui.wizard.DownloadWizardActivity" />
 

From 2d66c1f33426b369ce03d2158d8b4a7a1eac7c23 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 16:26:36 -0500
Subject: [PATCH 304/458] ui: Switch completely to the new download flow

...and delete the old ProfileDownloadFragment
---
 .../openeuicc/ui/EuiccManagementFragment.kt   |  14 +-
 .../openeuicc/ui/ProfileDownloadFragment.kt   | 298 ------------------
 .../im/angry/openeuicc/ui/SettingsFragment.kt |   3 -
 .../angry/openeuicc/util/PreferenceUtils.kt   |   2 -
 .../res/layout/fragment_profile_download.xml  | 126 --------
 .../res/menu/fragment_profile_download.xml    |  21 --
 app-common/src/main/res/values-ja/strings.xml |   7 -
 app-common/src/main/res/values/strings.xml    |   7 -
 app-common/src/main/res/xml/pref_settings.xml |   6 -
 9 files changed, 3 insertions(+), 481 deletions(-)
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
 delete mode 100644 app-common/src/main/res/layout/fragment_profile_download.xml
 delete mode 100644 app-common/src/main/res/menu/fragment_profile_download.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 824b68335..8e7b15803 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -37,7 +37,6 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
@@ -110,16 +109,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             LinearLayoutManager(view.context, LinearLayoutManager.VERTICAL, false)
 
         fab.setOnClickListener {
-            lifecycleScope.launch {
-                if (preferenceRepository.experimentalDownloadWizardFlow.first()) {
-                    Intent(requireContext(), DownloadWizardActivity::class.java).apply {
-                        putExtra("selectedLogicalSlot", logicalSlotId)
-                        startActivity(this)
-                    }
-                } else {
-                    ProfileDownloadFragment.newInstance(slotId, portId)
-                        .show(childFragmentManager, ProfileDownloadFragment.TAG)
-                }
+            Intent(requireContext(), DownloadWizardActivity::class.java).apply {
+                putExtra("selectedLogicalSlot", logicalSlotId)
+                startActivity(this)
             }
         }
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
deleted file mode 100644
index f590d365e..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDownloadFragment.kt
+++ /dev/null
@@ -1,298 +0,0 @@
-package im.angry.openeuicc.ui
-
-import android.annotation.SuppressLint
-import android.app.Dialog
-import android.content.DialogInterface
-import android.graphics.BitmapFactory
-import android.os.Bundle
-import android.text.Editable
-import android.util.Log
-import android.view.*
-import android.widget.ProgressBar
-import android.widget.TextView
-import android.widget.Toast
-import androidx.activity.result.contract.ActivityResultContracts
-import androidx.appcompat.app.AlertDialog
-import androidx.appcompat.widget.Toolbar
-import androidx.lifecycle.lifecycleScope
-import com.google.android.material.textfield.TextInputLayout
-import com.journeyapps.barcodescanner.ScanContract
-import com.journeyapps.barcodescanner.ScanOptions
-import im.angry.openeuicc.common.R
-import im.angry.openeuicc.service.EuiccChannelManagerService
-import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
-import im.angry.openeuicc.util.*
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.flow.onEach
-import kotlinx.coroutines.launch
-import kotlinx.coroutines.withContext
-
-class ProfileDownloadFragment : BaseMaterialDialogFragment(),
-    Toolbar.OnMenuItemClickListener, EuiccChannelFragmentMarker {
-    companion object {
-        const val TAG = "ProfileDownloadFragment"
-
-        const val LOW_NVRAM_THRESHOLD = 30 * 1024 // < 30 KiB, the alert may fail
-
-        fun newInstance(slotId: Int, portId: Int, finishWhenDone: Boolean = false): ProfileDownloadFragment =
-            newInstanceEuicc(ProfileDownloadFragment::class.java, slotId, portId) {
-                putBoolean("finishWhenDone", finishWhenDone)
-            }
-    }
-
-    private lateinit var toolbar: Toolbar
-    private lateinit var profileDownloadServer: TextInputLayout
-    private lateinit var profileDownloadCode: TextInputLayout
-    private lateinit var profileDownloadConfirmationCode: TextInputLayout
-    private lateinit var profileDownloadIMEI: TextInputLayout
-    private lateinit var profileDownloadFreeSpace: TextView
-    private lateinit var progress: ProgressBar
-
-    private var freeNvram: Int = -1
-
-    private var downloading = false
-
-    private val finishWhenDone by lazy {
-        requireArguments().getBoolean("finishWhenDone", false)
-    }
-
-    private val barcodeScannerLauncher = registerForActivityResult(ScanContract()) { result ->
-        result.contents?.let { content ->
-            onScanResult(content)
-        }
-    }
-
-    private val gallerySelectorLauncher = registerForActivityResult(ActivityResultContracts.GetContent()) { result ->
-        if (result == null) return@registerForActivityResult
-
-        lifecycleScope.launch(Dispatchers.IO) {
-            runCatching {
-                requireContext().contentResolver.openInputStream(result)?.let { input ->
-                    val bmp = BitmapFactory.decodeStream(input)
-                    input.close()
-
-                    decodeQrFromBitmap(bmp)?.let {
-                        withContext(Dispatchers.Main) {
-                            onScanResult(it)
-                        }
-                    }
-
-                    bmp.recycle()
-                }
-            }
-        }
-    }
-
-    private fun onScanResult(result: String) {
-        val components = result.split("$")
-        if (components.size < 3 || components[0] != "LPA:1") return
-        profileDownloadServer.editText?.setText(components[1])
-        profileDownloadCode.editText?.setText(components[2])
-    }
-
-    override fun onCreateView(
-        inflater: LayoutInflater,
-        container: ViewGroup?,
-        savedInstanceState: Bundle?
-    ): View {
-        val view = inflater.inflate(R.layout.fragment_profile_download, container, false)
-
-        toolbar = view.requireViewById(R.id.toolbar)
-        profileDownloadServer = view.requireViewById(R.id.profile_download_server)
-        profileDownloadCode = view.requireViewById(R.id.profile_download_code)
-        profileDownloadConfirmationCode = view.requireViewById(R.id.profile_download_confirmation_code)
-        profileDownloadIMEI = view.requireViewById(R.id.profile_download_imei)
-        profileDownloadFreeSpace = view.requireViewById(R.id.profile_download_free_space)
-        progress = view.requireViewById(R.id.progress)
-
-        toolbar.inflateMenu(R.menu.fragment_profile_download)
-
-        return view
-    }
-
-    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
-        super.onViewCreated(view, savedInstanceState)
-        toolbar.apply {
-            setTitle(R.string.profile_download)
-            setNavigationOnClickListener {
-                if (!downloading) {
-                    dismiss()
-                }
-            }
-            setOnMenuItemClickListener(this@ProfileDownloadFragment)
-        }
-    }
-
-    override fun onMenuItemClick(item: MenuItem): Boolean = downloading ||
-        when (item.itemId) {
-            R.id.scan -> {
-                barcodeScannerLauncher.launch(ScanOptions().apply {
-                    setDesiredBarcodeFormats(ScanOptions.QR_CODE)
-                    setOrientationLocked(false)
-                })
-                true
-            }
-            R.id.scan_from_gallery -> {
-                gallerySelectorLauncher.launch("image/*")
-                true
-            }
-            R.id.ok -> {
-                if (freeNvram > LOW_NVRAM_THRESHOLD) {
-                    startDownloadProfile()
-                } else {
-                    AlertDialog.Builder(requireContext()).apply {
-                        setTitle(R.string.profile_download_low_nvram_title)
-                        setMessage(R.string.profile_download_low_nvram_message)
-                        setIcon(android.R.drawable.ic_dialog_alert)
-                        setCancelable(true)
-                        setPositiveButton(android.R.string.ok) { _, _ ->
-                            startDownloadProfile()
-                        }
-                        setNegativeButton(android.R.string.cancel, null)
-                        show()
-                    }
-                }
-                true
-            }
-            else -> false
-        }
-
-    override fun onResume() {
-        super.onResume()
-        setWidthPercent(95)
-    }
-
-    @SuppressLint("MissingPermission")
-    override fun onStart() {
-        super.onStart()
-
-        lifecycleScope.launch(Dispatchers.IO) {
-            ensureEuiccChannelManager()
-            if (euiccChannelManagerService.isForegroundTaskRunning) {
-                withContext(Dispatchers.Main) {
-                    dismiss()
-                }
-                return@launch
-            }
-
-            withEuiccChannel { channel ->
-                val imei = try {
-                    telephonyManager.getImei(channel.logicalSlotId) ?: ""
-                } catch (e: Exception) {
-                    ""
-                }
-
-                // Fetch remaining NVRAM
-                val str = channel.lpa.euiccInfo2?.freeNvram?.also {
-                    freeNvram = it
-                }?.let { formatFreeSpace(it) }
-
-                withContext(Dispatchers.Main) {
-                    profileDownloadFreeSpace.text = getString(
-                        R.string.profile_download_free_space,
-                        str ?: getText(R.string.unknown)
-                    )
-                    profileDownloadIMEI.editText!!.text =
-                        Editable.Factory.getInstance().newEditable(imei)
-                }
-            }
-        }
-    }
-
-    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
-        return super.onCreateDialog(savedInstanceState).also {
-            it.setCanceledOnTouchOutside(false)
-        }
-    }
-
-    private fun startDownloadProfile() {
-        val server = profileDownloadServer.editText!!.let {
-            it.text.toString().trim().apply {
-                if (isEmpty()) {
-                    it.requestFocus()
-                    return@startDownloadProfile
-                }
-            }
-        }
-
-        val code = profileDownloadCode.editText!!.text.toString().trim()
-            .ifBlank { null }
-        val confirmationCode = profileDownloadConfirmationCode.editText!!.text.toString().trim()
-            .ifBlank { null }
-        val imei = profileDownloadIMEI.editText!!.text.toString().trim()
-            .ifBlank { null }
-
-        downloading = true
-
-        profileDownloadServer.editText!!.isEnabled = false
-        profileDownloadCode.editText!!.isEnabled = false
-        profileDownloadConfirmationCode.editText!!.isEnabled = false
-        profileDownloadIMEI.editText!!.isEnabled = false
-
-        progress.isIndeterminate = true
-        progress.visibility = View.VISIBLE
-
-        lifecycleScope.launch {
-            ensureEuiccChannelManager()
-            euiccChannelManagerService.waitForForegroundTask()
-            val err = doDownloadProfile(server, code, confirmationCode, imei)
-
-            if (err != null) {
-                Log.d(TAG, "Error downloading profile")
-                Log.d(TAG, Log.getStackTraceString(err))
-
-                Toast.makeText(requireContext(), R.string.profile_download_failed, Toast.LENGTH_LONG).show()
-            }
-
-            if (parentFragment is EuiccProfilesChangedListener) {
-                (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
-            }
-
-            try {
-                dismiss()
-            } catch (e: IllegalStateException) {
-                // Ignored
-            }
-        }
-    }
-
-    private suspend fun doDownloadProfile(
-        server: String,
-        code: String?,
-        confirmationCode: String?,
-        imei: String?
-    ) = withContext(Dispatchers.Main) {
-        // The service is responsible for launching the actual blocking part on the IO context
-        // On our side, we need the Main context because  of the UI updates
-        euiccChannelManagerService.launchProfileDownloadTask(
-            slotId,
-            portId,
-            server,
-            code,
-            confirmationCode,
-            imei
-        ).onEach {
-            if (it is EuiccChannelManagerService.ForegroundTaskState.InProgress) {
-                progress.progress = it.progress
-                progress.isIndeterminate = it.progress == 0
-            } else {
-                progress.progress = 100
-                progress.isIndeterminate = false
-            }
-        }.waitDone()
-    }
-
-    override fun onDismiss(dialog: DialogInterface) {
-        super.onDismiss(dialog)
-        if (finishWhenDone) {
-            activity?.finish()
-        }
-    }
-
-    override fun onCancel(dialog: DialogInterface) {
-        super.onCancel(dialog)
-        if (finishWhenDone) {
-            activity?.finish()
-        }
-    }
-}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 6ad74c46d..23f338b88 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -74,9 +74,6 @@ class SettingsFragment: PreferenceFragmentCompat() {
         findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
             ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow, PreferenceKeys.VERBOSE_LOGGING)
 
-        findPreference<CheckBoxPreference>("pref_developer_experimental_download_wizard")
-            ?.bindBooleanFlow(preferenceRepository.experimentalDownloadWizardFlow, PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD)
-
         findPreference<CheckBoxPreference>("pref_developer_unfiltered_profile_list")
             ?.bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow, PreferenceKeys.UNFILTERED_PROFILE_LIST)
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 807706edc..e768fa953 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -31,7 +31,6 @@ object PreferenceKeys {
 
     // ---- Developer Options ----
     val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
-    val EXPERIMENTAL_DOWNLOAD_WIZARD = booleanPreferencesKey("experimental_download_wizard")
     val UNFILTERED_PROFILE_LIST = booleanPreferencesKey("unfiltered_profile_list")
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
 }
@@ -49,7 +48,6 @@ class PreferenceRepository(private val context: Context) {
 
     // ---- Developer Options ----
     val developerOptionsEnabledFlow = bindFlow(PreferenceKeys.DEVELOPER_OPTIONS_ENABLED, false)
-    val experimentalDownloadWizardFlow = bindFlow(PreferenceKeys.EXPERIMENTAL_DOWNLOAD_WIZARD, false)
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
 
diff --git a/app-common/src/main/res/layout/fragment_profile_download.xml b/app-common/src/main/res/layout/fragment_profile_download.xml
deleted file mode 100644
index 78274dc96..000000000
--- a/app-common/src/main/res/layout/fragment_profile_download.xml
+++ /dev/null
@@ -1,126 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    android:background="?attr/colorSurface">
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1"
-        app:navigationIcon="?homeAsUpIndicator" />
-
-    <View
-        android:id="@+id/guideline"
-        android:layout_width="0dp"
-        android:layout_height="0dp"
-        android:orientation="vertical"
-        android:visibility="invisible"
-        app:layout_constraintBottom_toBottomOf="@id/toolbar"
-        app:layout_constraintEnd_toEndOf="parent"
-        app:layout_constraintStart_toStartOf="parent" />
-
-    <ProgressBar
-        android:id="@+id/progress"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:visibility="gone"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/guideline"
-        style="@style/Widget.AppCompat.ProgressBar.Horizontal" />
-
-    <com.google.android.material.textfield.TextInputLayout
-        android:id="@+id/profile_download_server"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:layout_marginTop="15dp"
-        android:hint="@string/profile_download_server"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintWidth_percent=".8">
-
-        <com.google.android.material.textfield.TextInputEditText
-            android:layout_width="match_parent"
-            android:layout_height="match_parent" />
-
-    </com.google.android.material.textfield.TextInputLayout>
-
-    <com.google.android.material.textfield.TextInputLayout
-        android:id="@+id/profile_download_code"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:layout_marginVertical="15dp"
-        android:hint="@string/profile_download_code"
-        app:layout_constraintTop_toBottomOf="@id/profile_download_server"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintWidth_percent=".8"
-        app:passwordToggleEnabled="true">
-
-        <com.google.android.material.textfield.TextInputEditText
-            android:layout_width="match_parent"
-            android:layout_height="match_parent"
-            android:inputType="textPassword" />
-
-    </com.google.android.material.textfield.TextInputLayout>
-
-    <com.google.android.material.textfield.TextInputLayout
-        android:id="@+id/profile_download_confirmation_code"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:layout_marginVertical="15dp"
-        android:hint="@string/profile_download_confirmation_code"
-        app:layout_constraintTop_toBottomOf="@id/profile_download_code"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintWidth_percent=".8"
-        app:passwordToggleEnabled="true">
-
-        <com.google.android.material.textfield.TextInputEditText
-            android:layout_width="match_parent"
-            android:layout_height="match_parent"
-            android:inputType="textPassword" />
-
-    </com.google.android.material.textfield.TextInputLayout>
-
-    <com.google.android.material.textfield.TextInputLayout
-        android:id="@+id/profile_download_imei"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:layout_marginTop="15dp"
-        android:layout_marginBottom="6dp"
-        android:hint="@string/profile_download_imei"
-        app:layout_constraintTop_toBottomOf="@id/profile_download_confirmation_code"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintBottom_toTopOf="@id/profile_download_free_space"
-        app:layout_constraintWidth_percent=".8"
-        app:passwordToggleEnabled="true">
-
-        <com.google.android.material.textfield.TextInputEditText
-            android:layout_width="match_parent"
-            android:layout_height="match_parent"
-            android:inputType="textPassword" />
-
-    </com.google.android.material.textfield.TextInputLayout>
-
-    <TextView
-        android:id="@+id/profile_download_free_space"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        android:gravity="center"
-        android:textSize="11sp"
-        android:layout_marginBottom="4dp"
-        app:layout_constraintTop_toBottomOf="@id/profile_download_imei"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintRight_toRightOf="parent"
-        app:layout_constraintBottom_toBottomOf="parent" />
-
-</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/fragment_profile_download.xml b/app-common/src/main/res/menu/fragment_profile_download.xml
deleted file mode 100644
index f93ae8d83..000000000
--- a/app-common/src/main/res/menu/fragment_profile_download.xml
+++ /dev/null
@@ -1,21 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<menu xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto">
-    <item
-        android:id="@+id/scan"
-        android:icon="@drawable/ic_scan_black"
-        android:title="@string/profile_download_scan"
-        app:showAsAction="ifRoom"/>
-
-    <item
-        android:id="@+id/scan_from_gallery"
-        android:icon="@drawable/ic_gallery_black"
-        android:title="@string/profile_download_scan_from_gallery"
-        app:showAsAction="ifRoom" />
-
-    <item
-        android:id="@+id/ok"
-        android:icon="@drawable/ic_check_black"
-        android:title="@string/profile_download_ok"
-        app:showAsAction="always"/>
-</menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index f4eb35df0..27ff1c20c 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -37,11 +37,6 @@
     <string name="profile_download_code">アクティベーションコード</string>
     <string name="profile_download_confirmation_code">確認コード (オプション)</string>
     <string name="profile_download_imei">IMEI (オプション)</string>
-    <string name="profile_download_free_space">残りの容量: %s</string>
-    <string name="profile_download_scan">QR コードをスキャン</string>
-    <string name="profile_download_scan_from_gallery">ギャラリーから QR コードをスキャン</string>
-    <string name="profile_download_ok">ダウンロード</string>
-    <string name="profile_download_failed">eSIM のダウンロードに失敗しました。アクティベーションまたは QR コードを確認してください。</string>
     <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
     <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
     <string name="download_wizard">ダウンロードウィザード</string>
@@ -128,8 +123,6 @@
     <string name="pref_advanced_logs">ログ</string>
     <string name="pref_advanced_logs_desc">アプリの最新デバッグログを表示します</string>
     <string name="pref_developer">開発者オプション</string>
-    <string name="pref_developer_experimental_download_wizard">実験的なダウンロードウィザード</string>
-    <string name="pref_developer_experimental_download_wizard_desc">実験的な新しいダウンロードウィザードを有効化します。まだ完全に機能していないことにご注意ください。</string>
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
     <string name="pref_developer_ignore_tls_certificate_desc">SM-DP+ TLS 証明書を無視して任意の RSP を許可します</string>
     <string name="pref_info">情報</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 14d25a356..250c1ee1e 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -53,11 +53,6 @@
     <string name="profile_download_code">Activation Code</string>
     <string name="profile_download_confirmation_code">Confirmation Code (Optional)</string>
     <string name="profile_download_imei">IMEI (Optional)</string>
-    <string name="profile_download_free_space">Space remaining: %s</string>
-    <string name="profile_download_scan">Scan QR Code</string>
-    <string name="profile_download_scan_from_gallery">Scan QR Code from Gallery</string>
-    <string name="profile_download_ok">Download</string>
-    <string name="profile_download_failed">Failed to download eSIM. Check your activation / QR code.</string>
 
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
@@ -159,8 +154,6 @@
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_developer">Developer Options</string>
-    <string name="pref_developer_experimental_download_wizard">Experimental Download Wizard</string>
-    <string name="pref_developer_experimental_download_wizard_desc">Enable the experimental new download wizard. Note that it is not fully working yet.</string>
     <string name="pref_developer_unfiltered_profile_list">Show unfiltered profile list</string>
     <string name="pref_developer_unfiltered_profile_list_desc">Include non-production profiles in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 52815b9f8..822b093cf 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -57,12 +57,6 @@
         app:title="@string/pref_developer"
         app:iconSpaceReserved="false">
 
-        <CheckBoxPreference
-            app:key="pref_developer_experimental_download_wizard"
-            app:iconSpaceReserved="false"
-            app:title="@string/pref_developer_experimental_download_wizard"
-            app:summary="@string/pref_developer_experimental_download_wizard_desc" />
-
         <CheckBoxPreference
             app:iconSpaceReserved="false"
             app:key="pref_developer_unfiltered_profile_list"

From 23022b14be98d3e3b9643014186ee7ff9cf448f6 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 8 Dec 2024 16:11:42 +0800
Subject: [PATCH 305/458] feat: copy ara-m sha-1 in settings

---
 .../openeuicc/di/DefaultUiComponentFactory.kt |  4 ++
 .../angry/openeuicc/di/UiComponentFactory.kt  |  2 +
 .../im/angry/openeuicc/ui/SettingsActivity.kt |  7 ++-
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  9 ++--
 .../di/UnprivilegedUiComponentFactory.kt      |  5 ++
 .../ui/UnprivilegedSettingsFragment.kt        | 50 +++++++++++++++++++
 app-unpriv/src/main/res/values/strings.xml    |  6 +++
 .../res/xml/pref_unprivileged_settings.xml    |  9 ++++
 8 files changed, 87 insertions(+), 5 deletions(-)
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
 create mode 100644 app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
index a0800173b..52a501a99 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultUiComponentFactory.kt
@@ -1,12 +1,16 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
+import androidx.preference.PreferenceFragmentCompat
 import im.angry.openeuicc.ui.EuiccManagementFragment
 import im.angry.openeuicc.ui.NoEuiccPlaceholderFragment
+import im.angry.openeuicc.ui.SettingsFragment
 
 open class DefaultUiComponentFactory : UiComponentFactory {
     override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
         EuiccManagementFragment.newInstance(slotId, portId)
 
     override fun createNoEuiccPlaceholderFragment(): Fragment = NoEuiccPlaceholderFragment()
+
+    override fun createSettingsFragment(): Fragment = SettingsFragment()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
index eef662cbc..2c3c72b2a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/UiComponentFactory.kt
@@ -1,9 +1,11 @@
 package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
+import androidx.preference.PreferenceFragmentCompat
 import im.angry.openeuicc.ui.EuiccManagementFragment
 
 interface UiComponentFactory {
     fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment
     fun createNoEuiccPlaceholderFragment(): Fragment
+    fun createSettingsFragment(): Fragment
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
index 52e327271..bb299a317 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsActivity.kt
@@ -4,10 +4,14 @@ import android.os.Bundle
 import android.view.MenuItem
 import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
+import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
 
 class SettingsActivity: AppCompatActivity() {
+    private val appContainer
+        get() = (application as OpenEuiccApplication).appContainer
+
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)
@@ -15,8 +19,9 @@ class SettingsActivity: AppCompatActivity() {
         setSupportActionBar(requireViewById(R.id.toolbar))
         setupToolbarInsets()
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
+        val settingsFragment = appContainer.uiComponentFactory.createSettingsFragment()
         supportFragmentManager.beginTransaction()
-            .replace(R.id.settings_container, SettingsFragment())
+            .replace(R.id.settings_container, settingsFragment)
             .commit()
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 23f338b88..79b37bff5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.ui
 
+import android.content.Context
 import android.content.Intent
 import android.net.Uri
 import android.os.Build
@@ -20,7 +21,7 @@ import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.runBlocking
 
-class SettingsFragment: PreferenceFragmentCompat() {
+open class SettingsFragment: PreferenceFragmentCompat() {
     private lateinit var developerPref: PreferenceCategory
 
     // Hidden developer options switch
@@ -35,9 +36,9 @@ class SettingsFragment: PreferenceFragmentCompat() {
 
         // Show / hide developer preference based on whether it is enabled
         lifecycleScope.launch {
-            preferenceRepository.developerOptionsEnabledFlow.onEach {
-                developerPref.isVisible = it
-            }.collect()
+            preferenceRepository.developerOptionsEnabledFlow
+                .onEach { developerPref.isVisible = it }
+                .collect()
         }
 
         findPreference<Preference>("pref_info_app_version")?.apply {
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
index 50e5581fc..06c489c47 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -2,8 +2,10 @@ package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.ui.EuiccManagementFragment
+import im.angry.openeuicc.ui.SettingsFragment
 import im.angry.openeuicc.ui.UnprivilegedEuiccManagementFragment
 import im.angry.openeuicc.ui.UnprivilegedNoEuiccPlaceholderFragment
+import im.angry.openeuicc.ui.UnprivilegedSettingsFragment
 
 class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
     override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
@@ -11,4 +13,7 @@ class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
 
     override fun createNoEuiccPlaceholderFragment(): Fragment =
         UnprivilegedNoEuiccPlaceholderFragment()
+
+    override fun createSettingsFragment(): Fragment =
+        UnprivilegedSettingsFragment()
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
new file mode 100644
index 000000000..1319ece41
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
@@ -0,0 +1,50 @@
+package im.angry.openeuicc.ui
+
+import android.content.ClipData
+import android.content.ClipboardManager
+import android.content.pm.PackageManager
+import android.os.Bundle
+import android.widget.Toast
+import androidx.preference.Preference
+import androidx.preference.PreferenceCategory
+import im.angry.easyeuicc.R
+import im.angry.openeuicc.util.encodeHex
+import java.security.MessageDigest
+
+class UnprivilegedSettingsFragment : SettingsFragment() {
+    private val firstSigner by lazy {
+        val packageInfo = requireContext().let {
+            it.packageManager.getPackageInfo(
+                it.packageName,
+                PackageManager.GET_SIGNING_CERTIFICATES,
+            )
+        }
+        packageInfo.signingInfo!!.apkContentsSigners.first().let {
+            MessageDigest.getInstance("SHA-1")
+                .apply { update(it.toByteArray()) }
+                .digest()
+        }
+    }
+
+    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
+        super.onCreatePreferences(savedInstanceState, rootKey)
+        addPreferencesFromResource(R.xml.pref_unprivileged_settings)
+        findPreference<Preference>("pref_developer_ara_m")?.apply {
+            bindCategory(this, "pref_developer")
+            isVisible = true
+            summary = firstSigner.encodeHex()
+            setOnPreferenceClickListener {
+                requireContext().getSystemService(ClipboardManager::class.java)!!
+                    .setPrimaryClip(ClipData.newPlainText("ara-m", summary))
+                Toast.makeText(requireContext(), R.string.toast_ara_m_copied, Toast.LENGTH_SHORT)
+                    .show()
+                true
+            }
+        }
+    }
+
+    private fun bindCategory(preference: Preference, key: String) {
+        preference.parent!!.removePreference(preference)
+        findPreference<PreferenceCategory>(key)!!.addPreference(preference)
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 3cf73473d..9d80b0e17 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -4,6 +4,12 @@
     <string name="compatibility_check">Compatibility Check</string>
     <string name="open_sim_toolkit">Open SIM Toolkit</string>
 
+    <!-- Settings -->
+    <string name="pref_developer_ara_m" translatable="false">ARA-M SHA-1</string>
+
+    <!-- Toast -->
+    <string name="toast_ara_m_copied">ARA-M SHA-1 copied to clipboard</string>
+
     <!-- Compatibility Check Descriptions -->
     <string name="compatibility_check_system_features">System Features</string>
     <string name="compatibility_check_system_features_desc">Whether your device has all the required features for managing removable eUICC cards. For example, basic telephony and OMAPI support.</string>
diff --git a/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
new file mode 100644
index 000000000..0c9876c25
--- /dev/null
+++ b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
+    <Preference
+        app:enableCopying="true"
+        app:iconSpaceReserved="false"
+        app:isPreferenceVisible="false"
+        app:key="pref_developer_ara_m"
+        app:title="@string/pref_developer_ara_m" />
+</PreferenceScreen>
\ No newline at end of file

From ca46b578f70816b3ed28d31851823afed0f66e14 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 17:15:36 -0500
Subject: [PATCH 306/458] ui: Display ARA-M SHA-1 under info

---
 app-common/src/main/res/xml/pref_settings.xml               | 1 +
 .../im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt   | 6 +++---
 app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml  | 2 +-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 822b093cf..1da1fd40a 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -72,6 +72,7 @@
     </PreferenceCategory>
 
     <PreferenceCategory
+        app:key="pref_info"
         app:title="@string/pref_info"
         app:iconSpaceReserved="false">
         <Preference
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
index 1319ece41..0b954531c 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
@@ -29,8 +29,8 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         super.onCreatePreferences(savedInstanceState, rootKey)
         addPreferencesFromResource(R.xml.pref_unprivileged_settings)
-        findPreference<Preference>("pref_developer_ara_m")?.apply {
-            bindCategory(this, "pref_developer")
+        findPreference<Preference>("pref_info_ara_m")?.apply {
+            moveCategory(this, "pref_info")
             isVisible = true
             summary = firstSigner.encodeHex()
             setOnPreferenceClickListener {
@@ -43,7 +43,7 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
         }
     }
 
-    private fun bindCategory(preference: Preference, key: String) {
+    private fun moveCategory(preference: Preference, key: String) {
         preference.parent!!.removePreference(preference)
         findPreference<PreferenceCategory>(key)!!.addPreference(preference)
     }
diff --git a/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
index 0c9876c25..606f0d79c 100644
--- a/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
+++ b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
@@ -4,6 +4,6 @@
         app:enableCopying="true"
         app:iconSpaceReserved="false"
         app:isPreferenceVisible="false"
-        app:key="pref_developer_ara_m"
+        app:key="pref_info_ara_m"
         app:title="@string/pref_developer_ara_m" />
 </PreferenceScreen>
\ No newline at end of file

From 4a482b9c734bb0012f6bdf10922c7104e1ff780e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 17:22:46 -0500
Subject: [PATCH 307/458] Implement a generic preference overlay mechanism

We'll need this as we'll probably soon have more priv/unpriv-specific
preferences. For example, exposing removable eSIMs to the system.
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 19 ++++++++++++++++++-
 .../ui/UnprivilegedSettingsFragment.kt        | 10 ++--------
 .../res/xml/pref_unprivileged_settings.xml    | 13 ++++++++-----
 3 files changed, 28 insertions(+), 14 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 79b37bff5..c2cbee3a9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -1,6 +1,5 @@
 package im.angry.openeuicc.ui
 
-import android.content.Context
 import android.content.Intent
 import android.net.Uri
 import android.os.Build
@@ -137,4 +136,22 @@ open class SettingsFragment: PreferenceFragmentCompat() {
             true
         }
     }
+
+    protected fun mergePreferenceOverlay(overlayKey: String, targetKey: String) {
+        val overlayCat = findPreference<PreferenceCategory>(overlayKey)!!
+        val targetCat = findPreference<PreferenceCategory>(targetKey)!!
+
+        val prefs = buildList {
+            for (i in 0..<overlayCat.preferenceCount) {
+                add(overlayCat.getPreference(i))
+            }
+        }
+
+        prefs.forEach {
+            overlayCat.removePreference(it)
+            targetCat.addPreference(it)
+        }
+
+        overlayCat.parent?.removePreference(overlayCat)
+    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
index 0b954531c..1ca9d0f04 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
@@ -6,7 +6,6 @@ import android.content.pm.PackageManager
 import android.os.Bundle
 import android.widget.Toast
 import androidx.preference.Preference
-import androidx.preference.PreferenceCategory
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.util.encodeHex
 import java.security.MessageDigest
@@ -29,9 +28,9 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         super.onCreatePreferences(savedInstanceState, rootKey)
         addPreferencesFromResource(R.xml.pref_unprivileged_settings)
+        mergePreferenceOverlay("pref_info_overlay", "pref_info")
+
         findPreference<Preference>("pref_info_ara_m")?.apply {
-            moveCategory(this, "pref_info")
-            isVisible = true
             summary = firstSigner.encodeHex()
             setOnPreferenceClickListener {
                 requireContext().getSystemService(ClipboardManager::class.java)!!
@@ -42,9 +41,4 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
             }
         }
     }
-
-    private fun moveCategory(preference: Preference, key: String) {
-        preference.parent!!.removePreference(preference)
-        findPreference<PreferenceCategory>(key)!!.addPreference(preference)
-    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
index 606f0d79c..3281cafe9 100644
--- a/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
+++ b/app-unpriv/src/main/res/xml/pref_unprivileged_settings.xml
@@ -1,9 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
-    <Preference
-        app:enableCopying="true"
-        app:iconSpaceReserved="false"
+    <PreferenceCategory
         app:isPreferenceVisible="false"
-        app:key="pref_info_ara_m"
-        app:title="@string/pref_developer_ara_m" />
+        app:key="pref_info_overlay">
+        <Preference
+            app:enableCopying="true"
+            app:iconSpaceReserved="false"
+            app:key="pref_info_ara_m"
+            app:title="@string/pref_developer_ara_m" />
+    </PreferenceCategory>
 </PreferenceScreen>
\ No newline at end of file

From 125f1da6af52bed8d71b3a369a89a341c52434dd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 8 Dec 2024 19:57:16 -0500
Subject: [PATCH 308/458] i18n: Add Simplified Chinese (zh-CN) translation

Also fix up some untranslatable strings and translation mistakes in
ja while we are at it.

Co-authored-by: sekaiacg <sekaiacg@gmail.com>
---
 app-common/src/main/res/values-ja/strings.xml |   4 +-
 .../src/main/res/values-zh-rCN/strings.xml    | 137 ++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |   6 +-
 app-common/src/main/res/xml/locale_config.xml |   1 +
 app-unpriv/src/main/res/values-ja/strings.xml |   1 +
 .../src/main/res/values-zh-rCN/strings.xml    |  32 ++++
 app/src/main/res/values-zh-rCN/strings.xml    |  20 +++
 7 files changed, 195 insertions(+), 6 deletions(-)
 create mode 100644 app-common/src/main/res/values-zh-rCN/strings.xml
 create mode 100644 app-unpriv/src/main/res/values-zh-rCN/strings.xml
 create mode 100644 app/src/main/res/values-zh-rCN/strings.xml

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 27ff1c20c..d25af4938 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -48,7 +48,6 @@
     <string name="download_wizard_slot_type_removable">リムーバブル</string>
     <string name="download_wizard_slot_type_internal">内部</string>
     <string name="download_wizard_slot_type_internal_port">内部 - ポート: %d</string>
-    <string name="download_wizard_slot_eid">eID:</string>
     <string name="download_wizard_slot_active_profile">有効なプロファイル:</string>
     <string name="download_wizard_slot_free_space">空き容量:</string>
     <string name="download_wizard_method_select">eSIM プロファイルをどの方法でダウンロードしますか？</string>
@@ -90,11 +89,10 @@
     <string name="euicc_info_activity_title">eUICC 情報 (%s)</string>
     <string name="euicc_info_access_mode">アクセスモード</string>
     <string name="euicc_info_removable">リムーバブル</string>
-    <string name="euicc_info_eid">EID</string>
     <string name="euicc_info_firmware_version">eUICC OS のバージョン</string>
     <string name="euicc_info_globalplatform_version">グローバルプラットフォームのバージョン</string>
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
-    <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
+    <string name="euicc_info_pp_version">Protected Profileのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
     <string name="euicc_info_gsma_prod">GSMA プロダクション証明書</string>
     <string name="euicc_info_gsma_test">GSMA テスト証明書</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
new file mode 100644
index 000000000..3bb0d042b
--- /dev/null
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="no_euicc">在此设备上未检测到此应用程序可访问的可插拔 eUICC 卡。请插入兼容卡或 USB 读卡器。</string>
+    <string name="no_profile">此 eSIM 上还没有配置文件</string>
+    <string name="unknown">未知</string>
+    <string name="help">帮助</string>
+    <string name="reload">重新加载卡槽</string>
+    <string name="channel_name_format">逻辑卡槽 %d</string>
+    <string name="enabled">已启用</string>
+    <string name="disabled">已禁用</string>
+    <string name="provider">提供商:</string>
+    <string name="profile_class">类型:</string>
+    <string name="enable">启用</string>
+    <string name="disable">禁用</string>
+    <string name="delete">删除</string>
+    <string name="rename">重命名</string>
+    <string name="enable_disable_timeout">等待 eSIM 芯片切换配置文件时超时。这可能是您手机基带固件中的一个错误。请尝试切换飞行模式、重新启动应用程序或重新启动手机</string>
+    <string name="switch_did_not_refresh">操作成功, 但是您手机的基带拒绝刷新。您可能需要切换飞行模式或重新启动，以便使用新的配置文件。</string>
+    <string name="toast_profile_enable_failed">无法切换到新的 eSIM 配置文件。</string>
+    <string name="toast_profile_name_too_long">昵称不能超过 64 个字符</string>
+    <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
+    <string name="slot_select">选择卡槽</string>
+    <string name="slot_select_select">选择</string>
+    <string name="usb_permission">授予 USB 权限</string>
+    <string name="usb_permission_needed">需要获得访问 USB 智能卡读卡器的权限。</string>
+    <string name="usb_failed">无法通过 USB 智能卡读卡器连接到 eSIM。</string>
+    <string name="task_notification">长时间运行的后台任务</string>
+    <string name="task_profile_download">正在下载 eSIM 配置文件</string>
+    <string name="task_profile_download_failure">无法下载 eSIM 配置文件</string>
+    <string name="task_profile_rename">正在重命名 eSIM 配置文件</string>
+    <string name="task_profile_rename_failure">无法重命名 eSIM 配置文件</string>
+    <string name="task_profile_delete">正在删除 eSIM 配置文件</string>
+    <string name="task_profile_delete_failure">无法删除 eSIM 配置文件</string>
+    <string name="task_profile_switch">正在切换 eSIM 配置文件</string>
+    <string name="task_profile_switch_failure">无法切换 eSIM 配置文件</string>
+    <string name="profile_download">添加新 eSIM</string>
+    <string name="profile_download_server">服务器 (RSP / SM-DP+)</string>
+    <string name="profile_download_code">激活码</string>
+    <string name="profile_download_confirmation_code">确认码 (可选)</string>
+    <string name="profile_download_imei">IMEI (可选)</string>
+    <string name="profile_download_low_nvram_title">本次下载可能会失败</string>
+    <string name="profile_download_low_nvram_message">当前芯片的剩余空间不足，可能导致配置下载失败。\n是否继续下载？</string>
+    <string name="profile_rename_new_name">新昵称</string>
+    <string name="profile_delete_confirm">您确定要删除 %s 吗？此操作是不可逆的。</string>
+    <string name="profile_delete_confirm_input">请输入\'%s\'以确认删除</string>
+    <string name="profile_notifications">通知列表</string>
+    <string name="profile_notifications_detailed_format">通知列表 (%s)</string>
+    <string name="profile_notifications_show">管理通知</string>
+    <string name="profile_notifications_help">eSIM 配置文件可以在下载、删除、启用或禁用时向运营商发送通知。此处列出了要发送的这些通知的队列。\n\n在\"设置\"中，您可以指定是否自动发送每种类型的通知。请注意，即使通知已发送，也不会自动从记录中删除，除非队列空间不足。\n\n在这里，您可以手动发送或删除每个待处理的通知。</string>
+    <string name="profile_notification_operation_download">已下载</string>
+    <string name="profile_notification_operation_delete">已删除</string>
+    <string name="profile_notification_operation_enable">已启用</string>
+    <string name="profile_notification_operation_disable">已禁用</string>
+    <string name="profile_notification_process">处理</string>
+    <string name="profile_notification_delete">删除</string>
+    <string name="logs_save">保存日志</string>
+    <string name="logs_filename_template">%s 的日志</string>
+    <string name="pref_settings">设置</string>
+    <string name="pref_notifications">通知</string>
+    <string name="pref_notifications_desc">操作 eSIM 配置文件会向运营商发送通知。根据需要在此处微调此行为。</string>
+    <string name="pref_notifications_download">下载</string>
+    <string name="pref_notifications_download_desc">发送 <i>下载</i> 配置文件的通知</string>
+    <string name="pref_notifications_delete">删除</string>
+    <string name="pref_notifications_delete_desc">发送 <i>删除</i> 配置文件的通知</string>
+    <string name="pref_notifications_switch">切换</string>
+    <string name="pref_notifications_switch_desc">发送 <i>切换</i> 配置文件的通知\n注意，这种类型的通知是不可靠的。</string>
+    <string name="pref_advanced">高级</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">允许 禁用/删除 已启用的配置文件</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">默认情况下，此应用程序会阻止您禁用可插拔 eSIM 中已启用的配置文件。\n因为这样做 <i>有时</i> 会使其无法访问。\n勾选此框以 <i>移除</i> 此保护措施。</string>
+    <string name="pref_advanced_verbose_logging">记录详细日志</string>
+    <string name="pref_advanced_verbose_logging_desc">详细日志中包含敏感信息，开启此功能后请仅与你信任的人共享你的日志。</string>
+    <string name="pref_advanced_logs">日志</string>
+    <string name="pref_advanced_logs_desc">查看应用程序的最新调试日志</string>
+    <string name="pref_info">信息</string>
+    <string name="pref_info_app_version">App 版本</string>
+    <string name="pref_info_source_code">源码</string>
+    <string name="profile_class_testing">测试</string>
+    <string name="profile_class_provisioning">准备中</string>
+    <string name="profile_class_operational">可用</string>
+    <string name="download_wizard">下载向导</string>
+    <string name="download_wizard_back">返回</string>
+    <string name="download_wizard_next">下一步</string>
+    <string name="download_wizard_slot_select">请选择或确认下载目标 eSIM 卡槽:</string>
+    <string name="download_wizard_slot_title">逻辑卡槽 %d</string>
+    <string name="download_wizard_slot_type">类型:</string>
+    <string name="download_wizard_slot_type_removable">可插拔</string>
+    <string name="download_wizard_slot_type_internal">内置</string>
+    <string name="download_wizard_slot_type_internal_port">内置, 端口 %d</string>
+    <string name="download_wizard_slot_active_profile">当前配置文件:</string>
+    <string name="download_wizard_slot_free_space">剩余空间:</string>
+    <string name="download_wizard_method_select">您想要如何下载 eSIM 配置文件?</string>
+    <string name="download_wizard_method_qr_code">用相机扫描二维码</string>
+    <string name="download_wizard_method_gallery">从图库选择二维码</string>
+    <string name="download_wizard_method_manual">手动输入</string>
+    <string name="download_wizard_details">请输入或确认下载 eSIM 的详细信息:</string>
+    <string name="download_wizard_progress">正在下载您的 eSIM...</string>
+    <string name="download_wizard_progress_step_preparing">准备中</string>
+    <string name="download_wizard_progress_step_connecting">正在连接服务器</string>
+    <string name="download_wizard_progress_step_authenticating">正在向服务器认证您的设备</string>
+    <string name="download_wizard_progress_step_downloading">正在下载 eSIM 配置文件</string>
+    <string name="download_wizard_progress_step_finalizing">正在写入 eSIM 配置文件</string>
+    <string name="download_wizard_diagnostics">错误诊断</string>
+    <string name="download_wizard_diagnostics_error_code">错误代码: %s</string>
+    <string name="download_wizard_diagnostics_last_http_status">上次 HTTP 状态码 (来自服务器): %d</string>
+    <string name="download_wizard_diagnostics_last_http_response">上次 HTTP 应答 (来自服务器):</string>
+    <string name="download_wizard_diagnostics_last_http_exception">上次 HTTP 错误:</string>
+    <string name="download_wizard_diagnostics_last_apdu_response">上次 APDU 应答 (来自 SIM): %s</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_success">上次 APDU 应答 (来自 SIM) 是成功的</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_fail">上次 APDU 应答 (来自 SIM) 是失败的</string>
+    <string name="download_wizard_diagnostics_last_apdu_exception">上次 APDU 错误:</string>
+    <string name="download_wizard_diagnostics_save">保存</string>
+    <string name="download_wizard_diagnostics_file_template">%s 的错误诊断</string>
+    <string name="euicc_info">eUICC 详情</string>
+    <string name="euicc_info_activity_title">eUICC 详情 (%s)</string>
+    <string name="euicc_info_access_mode">访问方式</string>
+    <string name="euicc_info_removable">可插拔</string>
+    <string name="euicc_info_firmware_version">eUICC OS 版本</string>
+    <string name="euicc_info_globalplatform_version">GlobalPlatform 版本</string>
+    <string name="euicc_info_sas_accreditation_number">SAS 认证号码</string>
+    <string name="euicc_info_pp_version">Protected Profile 版本</string>
+    <string name="euicc_info_free_nvram">NVRAM 剩余空间 (eSIM 存储容量)</string>
+    <string name="euicc_info_gsma_prod">GSMA 生产环境证书</string>
+    <string name="euicc_info_gsma_test">GSMA 测试环境证书</string>
+    <string name="supported">兼容</string>
+    <string name="unsupported">不兼容</string>
+    <string name="yes">是</string>
+    <string name="no">否</string>
+    <string name="developer_options_steps">还有 %d 步成为开发者</string>
+    <string name="developer_options_enabled">你现在是开发者了！</string>
+    <string name="pref_language">语言</string>
+    <string name="pref_language_desc">选择 App 语言</string>
+    <string name="pref_developer">开发者选项</string>
+    <string name="pref_developer_unfiltered_profile_list">显示未经过滤的配置文件列表</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">在配置文件列表中包括非生产环境的配置文件</string>
+    <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
+</resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 250c1ee1e..4a9f529e7 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -66,7 +66,7 @@
     <string name="download_wizard_slot_type_removable">Removable</string>
     <string name="download_wizard_slot_type_internal">Internal</string>
     <string name="download_wizard_slot_type_internal_port">Internal, port %d</string>
-    <string name="download_wizard_slot_eid">eID:</string>
+    <string name="download_wizard_slot_eid" translatable="false">eID:</string>
     <string name="download_wizard_slot_active_profile">Active Profile:</string>
     <string name="download_wizard_slot_free_space">Free Space:</string>
     <string name="download_wizard_method_select">How would you like to download the eSIM profile?</string>
@@ -114,7 +114,7 @@
     <string name="euicc_info_activity_title">eUICC Info (%s)</string>
     <string name="euicc_info_access_mode">Access Mode</string>
     <string name="euicc_info_removable">Removable</string>
-    <string name="euicc_info_eid">EID</string>
+    <string name="euicc_info_eid" translatable="false">EID</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
@@ -157,7 +157,7 @@
     <string name="pref_developer_unfiltered_profile_list">Show unfiltered profile list</string>
     <string name="pref_developer_unfiltered_profile_list_desc">Include non-production profiles in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
-    <string name="pref_developer_ignore_tls_certificate_desc">Ignore SM-DP+ TLS certificate, allow any RSP</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">Accept any TLS certificate used by the RSP server</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/locale_config.xml b/app-common/src/main/res/xml/locale_config.xml
index dd9d189c2..e1a13f82b 100644
--- a/app-common/src/main/res/xml/locale_config.xml
+++ b/app-common/src/main/res/xml/locale_config.xml
@@ -2,4 +2,5 @@
 <locale-config xmlns:android="http://schemas.android.com/apk/res/android">
     <locale android:name="en-US" />
     <locale android:name="ja" />
+    <locale android:name="zh-CN" />
 </locale-config>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index b8fac395a..053a8d12d 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -30,4 +30,5 @@
     <string name="compatibility_check_verdict_unknown_likely_fail">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかは判断できません。デバイスが OMAPI のサポートを宣言していないため、このデバイス上で取り外し可能な eSIM を管理することはサポートされていない可能性があります。\n%s</string>
     <string name="compatibility_check_verdict_unknown">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかを確認できません。\n%s</string>
     <string name="compatibility_check_verdict_fail_shared">ただし、eSIM プロファイルがすでに読み込まれている場合、有効化されたプロファイル自体は引き続き機能します。また、プロファイルが管理できない場合は、このデバイスで USB カードリーダーを介してプロファイルを管理できる可能性があります。</string>
+    <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-zh-rCN/strings.xml b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
new file mode 100644
index 000000000..8d3060d62
--- /dev/null
+++ b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
@@ -0,0 +1,32 @@
+<resources>
+    <string name="compatibility_check">兼容性检查</string>
+    <string name="open_sim_toolkit">打开 SIM 卡应用程序</string>
+    <string name="compatibility_check_system_features">系统功能</string>
+    <string name="compatibility_check_system_features_desc">您的设备是否具有管理可插拔 eUICC 卡所需的所有功能。例如，基本的电话功能和 OMAPI 支持。</string>
+    <string name="compatibility_check_system_features_no_telephony">您的设备没有电话功能。</string>
+    <string name="compatibility_check_system_features_no_omapi">您的设备/系统未声明支持 OMAPI。这可能是由于缺少硬件支持，或者可能仅仅是由于缺少标志。请参阅以下两项检查以确定 OMAPI 是否确实受支持。</string>
+    <string name="compatibility_check_omapi_connectivity">OMAPI 连接</string>
+    <string name="compatibility_check_omapi_connectivity_desc">您的设备是否允许通过 OMAPI 访问 SIM 卡上的安全元件？</string>
+    <string name="compatibility_check_omapi_connectivity_fail">无法通过 OMAPI 检测到 SIM 卡的 Secure Element。如果您尚未在此设备中插入 SIM 卡，请尝试插入一张 SIM 卡并重试此检查。</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">已成功检测到可访问 Secure Element 的卡槽，但仅限于以下 SIM 卡槽：<b>SIM%s</b>。</string>
+    <string name="compatibility_check_isdr_channel">ISD-R 通道访问</string>
+    <string name="compatibility_check_isdr_channel_desc">您的设备是否支持通过 OMAPI 打开 eSIM 的 ISD-R (管理) 通道？</string>
+    <string name="compatibility_check_isdr_channel_desc_unknown">无法确定是否支持通过 OMAPI 进行 ISD-R 访问。如果尚未插入，您可能需要插入 SIM 卡 (任何 SIM 卡都可以) 重试。</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI 只能在以下 SIM 插槽上访问 ISD-R：<b>SIM%s</b>。</string>
+    <string name="compatibility_check_known_broken">不在已知的 BUG 名单中</string>
+    <string name="compatibility_check_known_broken_desc">确保您的设备不存在与可插拔 eSIM 相关的错误。</string>
+    <string name="compatibility_check_known_broken_fail">糟糕，您的设备在访问可插拔 eSIM 时存在错误。这并不表示完全无法使用，但我们不保证该应用在您设备上的行为。</string>
+    <string name="compatibility_check_usb">USB 读卡器支持</string>
+    <string name="compatibility_check_usb_desc">您的设备是否支持通过 USB 读卡器管理 eSIM？</string>
+    <string name="compatibility_check_usb_ok">您可以通过此设备上的标准 USB CCID 读取器管理 eSIM (即使您在这里有任何其他检查项失败)。请插入读卡器，然后打开此应用程序以这种方式管理 eSIM。</string>
+    <string name="compatibility_check_usb_fail">您的设备不支持 USB 读卡器。</string>
+    <string name="compatibility_check_verdict">结论 (USB 读卡器以外)</string>
+    <string name="compatibility_check_verdict_desc">根据之前的所有检查，您的设备与可插拔 eSIM 卡兼容的可能性有多大？</string>
+    <string name="compatibility_check_verdict_ok">您可以使用和管理插入此设备的可插拔 eSIM 卡。</string>
+    <string name="compatibility_check_verdict_known_broken">已知您的设备在访问可插拔 eSIM 卡时存在问题。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_ok">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。不过，您的设备确实声明支持 OMAPI，因此它工作的可能性略高。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_fail">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。由于您的设备未声明支持OMAPI，因此更有可能不支持在此设备上管理可插拔 eSIM。\n%s</string>
+    <string name="compatibility_check_verdict_unknown">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。\n%s</string>
+    <string name="compatibility_check_verdict_fail_shared">然而，已经加载了eSIM配置文件的可插拔 eSIM 卡仍然可以工作; 即使无法在装置上直接管理可插拔 eSIM 卡中的配置文件，您仍然可以使用 USB 卡读卡器来管理配置文件。</string>
+    <string name="toast_ara_m_copied">ARA-M SHA-1 已拷贝到剪贴板</string>
+</resources>
\ No newline at end of file
diff --git a/app/src/main/res/values-zh-rCN/strings.xml b/app/src/main/res/values-zh-rCN/strings.xml
new file mode 100644
index 000000000..9b34bb80d
--- /dev/null
+++ b/app/src/main/res/values-zh-rCN/strings.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="no_euicc">在此设备上找不到 eUICC 芯片。\n在某些设备上，您可能需要先在此应用的菜单中启用双卡支持。</string>
+    <string name="dsds">双卡</string>
+    <string name="toast_dsds_switched">双卡支持状态已切换。请等待基带重新启动。</string>
+    <string name="footer_mep">此卡槽支持多个启用配置文件 (MEP)。要启用或禁用此功能，请使用\"卡槽映射\"工具。</string>
+    <string name="slot_mapping">卡槽映射</string>
+    <string name="slot_mapping_logical_slot">逻辑卡槽 %d:</string>
+    <string name="slot_mapping_port">卡槽 %1$d 端口 %2$d</string>
+    <string name="slot_mapping_help">您的手机有 %1$d 个逻辑 SIM 卡槽和 %2$d 个物理 SIM 卡槽。%3$s\n\n选择您希望每个逻辑卡槽对应的物理卡槽 和/或 \"端口\"。请注意，并非所有映射模式都受硬件支持。</string>
+    <string name="slot_mapping_help_mep">\n\n物理卡槽 %1$d 支持多个启用的配置文件 (MEP)。要使用此功能，请将其 %2$d 个虚拟\"端口\"分配给上面显示的不同逻辑卡槽。\n\n启用 MEP 后，\"端口\"会在 OpenEUICC 中显示为共享 eSIM 配置文件的独立的 eSIM 卡槽。</string>
+    <string name="slot_mapping_help_dsds">\n支持双卡模式，但已禁用。如果您的设备带有内置 eSIM 芯片，则默认情况下可能不会启用。更改上面的映射或启用双卡以访问您的 eSIM。</string>
+    <string name="slot_mapping_completed">您的新卡槽映射已设置完毕。请等待基带刷新卡槽。</string>
+    <string name="slot_mapping_failure">指定的映射可能无效或硬件不支持您指定的映射。</string>
+    <string name="lui_title">通过下载 eSIM 连接到移动网络</string>
+    <string name="lui_desc">您的设备支持 eSIM。要连接到移动网络，请下载运营商发布的 eSIM，或插入物理 SIM 卡。</string>
+    <string name="lui_skip">跳过</string>
+    <string name="lui_download">下载 eSIM</string>
+    <string name="telephony_manager">TelephonyManager (特权)</string>
+</resources>
\ No newline at end of file

From 8f9c7137f66cded975dc91b6a92bceb97841b196 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 12 Dec 2024 01:59:06 +0100
Subject: [PATCH 309/458] feat: show incorrect lpa string alert dialog (#101)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/101
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt  | 12 +++++++++++-
 app-common/src/main/res/values/strings.xml           |  2 ++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 4d8a38fb2..d32904899 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.ui.wizard
 
+import android.app.AlertDialog
 import android.graphics.BitmapFactory
 import android.os.Bundle
 import android.view.LayoutInflater
@@ -104,7 +105,16 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
     private fun processLpaString(s: String) {
         val components = s.split("$")
-        if (components.size < 3 || components[0] != "LPA:1") return
+        if (components.size < 3 || components[0] != "LPA:1") {
+            AlertDialog.Builder(requireContext()).apply {
+                setTitle(R.string.profile_download_incorrect_lpa_string)
+                setMessage(R.string.profile_download_incorrect_lpa_string_message)
+                setCancelable(true)
+                setNegativeButton(android.R.string.cancel, null)
+                show()
+            }
+            return
+        }
         state.smdp = components[1]
         state.matchingId = components[2]
         gotoNextFragment(DownloadWizardDetailsFragment())
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4a9f529e7..f308826e7 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -56,6 +56,8 @@
 
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
+    <string name="profile_download_incorrect_lpa_string">Incorrect LPA String</string>
+    <string name="profile_download_incorrect_lpa_string_message">The LPA string could not be parsed</string>
 
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>

From 6d962a12b5de1794e9f65e4dbddc40713c65ba39 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 12 Dec 2024 02:09:01 +0100
Subject: [PATCH 310/458] fix: euiccinfo activity channel title (#103)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/103
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/ui/EuiccInfoActivity.kt    | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index bb1d5b658..0a7e16c0b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -16,6 +16,7 @@ import androidx.recyclerview.widget.RecyclerView.ViewHolder
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
@@ -50,10 +51,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
 
         logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
 
-        title = getString(
-            R.string.euicc_info_activity_title,
+        val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+            getString(R.string.usb)
+        } else {
             getString(R.string.channel_name_format, logicalSlotId)
-        )
+        }
+
+        title = getString(R.string.euicc_info_activity_title, channelTitle)
 
         swipeRefresh.setOnRefreshListener { refresh() }
 

From 06873545e24890fd087ccf7f8f2925cc385a15f8 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Fri, 13 Dec 2024 04:41:03 +0100
Subject: [PATCH 311/458] refactor: certificate issuer detecting (#108)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/108
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 29 ++++++++----------
 app-common/src/main/res/values/strings.xml    |  9 +++---
 .../lpac_jni/impl/RootCertificates.kt         | 30 +++++++++++++++++--
 3 files changed, 43 insertions(+), 25 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 0a7e16c0b..84b300e5c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -19,13 +19,12 @@ import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.launch
-import net.typeblog.lpac_jni.impl.DEFAULT_PKID_GSMA_RSP2_ROOT_CI1
+import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
 
 class EuiccInfoActivity : BaseEuiccAccessActivity() {
     companion object {
         private val YES_NO = Pair(R.string.yes, R.string.no)
-        private val SUPPORTED_UNSUPPORTED = Pair(R.string.supported, R.string.unsupported)
     }
 
     private lateinit var swipeRefresh: SwipeRefreshLayout
@@ -107,21 +106,17 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
             add(Pair(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
         }
         channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
-            add(
-                Pair(
-                    R.string.euicc_info_gsma_prod,
-                    formatByBoolean(
-                        signers.contains(DEFAULT_PKID_GSMA_RSP2_ROOT_CI1),
-                        SUPPORTED_UNSUPPORTED
-                    )
-                )
-            )
-            add(
-                Pair(
-                    R.string.euicc_info_gsma_test,
-                    formatByBoolean(PKID_GSMA_TEST_CI.any(signers::contains), SUPPORTED_UNSUPPORTED)
-                )
-            )
+            // SGP.28 v1.0, eSIM CI Registration Criteria (Page 5 of 9, 2019-10-24)
+            // https://www.gsma.com/newsroom/wp-content/uploads/SGP.28-v1.0.pdf#page=5
+            // FS.27 v2.0, Security Guidelines for UICC Profiles (Page 25 of 27, 2024-01-30)
+            // https://www.gsma.com/solutions-and-impact/technologies/security/wp-content/uploads/2024/01/FS.27-Security-Guidelines-for-UICC-Credentials-v2.0-FINAL-23-July.pdf#page=25
+            val resId = when {
+                signers.isEmpty() -> R.string.unknown // the case is not mp, but it's is not common
+                PKID_GSMA_LIVE_CI.any(signers::contains) -> R.string.euicc_info_ci_gsma_live
+                PKID_GSMA_TEST_CI.any(signers::contains) -> R.string.euicc_info_ci_gsma_test
+                else -> R.string.euicc_info_ci_unknown
+            }
+            add(Pair(R.string.euicc_info_ci_type, getString(resId)))
         }
     }
 
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index f308826e7..d532a0c6a 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -122,11 +122,10 @@
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
     <string name="euicc_info_pp_version">Protected Profile Version</string>
     <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
-    <string name="euicc_info_gsma_prod">GSMA Production Certificate</string>
-    <string name="euicc_info_gsma_test">GSMA Test Certificate</string>
-
-    <string name="supported">Supported</string>
-    <string name="unsupported">Unsupported</string>
+    <string name="euicc_info_ci_type">Certificate Issuer</string>
+    <string name="euicc_info_ci_gsma_live">GSMA Live CI</string>
+    <string name="euicc_info_ci_gsma_test">GSMA Test CI</string>
+    <string name="euicc_info_ci_unknown">Unknown eSIM CA</string>
 
     <string name="yes">Yes</string>
     <string name="no">No</string>
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index 82c443f2c..cfd5779f5 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -7,8 +7,32 @@ import java.security.cert.CertificateFactory
 
 const val DEFAULT_PKID_GSMA_RSP2_ROOT_CI1 = "81370f5125d0b1d408d4c3b232e6d25e795bebfb"
 
-val PKID_GSMA_TEST_CI =
-    arrayOf("34eecf13156518d48d30bdf06853404d115f955d", "2209f61cd9ec5c9c854e787341ff83ecf9776a5b")
+// SGP.28 v1.0, eSIM CI Registration Criteria (Page 5 of 9, 2019-10-24)
+// https://www.gsma.com/newsroom/wp-content/uploads/SGP.28-v1.0.pdf#page=5
+// FS.27 v2.0, Security Guidelines for UICC Profiles (Page 25 of 27, 2024-01-30)
+// https://www.gsma.com/solutions-and-impact/technologies/security/wp-content/uploads/2024/01/FS.27-Security-Guidelines-for-UICC-Credentials-v2.0-FINAL-23-July.pdf#page=25
+
+// List of GSMA Live CIs
+// https://www.gsma.com/solutions-and-impact/technologies/esim/gsma-root-ci/
+val PKID_GSMA_LIVE_CI = arrayOf(
+    // GSMA RSP2 Root CI1 (SGP.22 v2+v3, CA: DigiCert)
+    // https://euicc-manual.osmocom.org/docs/pki/ci/files/81370f.txt
+    DEFAULT_PKID_GSMA_RSP2_ROOT_CI1,
+    // OISITE GSMA CI G1 (SGP.22 v2+v3, CA: WISeKey)
+    // https://euicc-manual.osmocom.org/docs/pki/ci/files/4c2796.txt
+    "4c27967ad20c14b391e9601e41e604ad57c0222f",
+)
+
+// SGP.26 v3.0, 2023-12-01
+// https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2023/12/SGP.26-v3.0.pdf
+val PKID_GSMA_TEST_CI = arrayOf(
+    // Test CI (SGP.26, NIST P256)
+    // https://euicc-manual.osmocom.org/docs/pki/ci/files/34eecf.txt
+    "34eecf13156518d48d30bdf06853404d115f955d",
+    // Test CI (SGP.26, BRP P256r1)
+    // https://euicc-manual.osmocom.org/docs/pki/ci/files/2209f6.txt
+    "2209f61cd9ec5c9c854e787341ff83ecf9776a5b",
+)
 
 private fun getCertificate(keyId: String): Certificate? =
     KNOWN_CI_CERTS[keyId]?.toByteArray()?.let { cert ->
@@ -60,7 +84,7 @@ internal val KNOWN_CI_CERTS = hashMapOf(
         -----END CERTIFICATE-----
     """.trimIndent(),
     // OISITE GSMA CI G1 (CA: WISeKey)
-    // Specs: SGP.21 and SGP.22 version 3
+    // Specs: SGP.21 and SGP.22 version 2 and version 3
     "4c27967ad20c14b391e9601e41e604ad57c0222f" to """
         -----BEGIN CERTIFICATE-----
         MIIB9zCCAZ2gAwIBAgIUSpBSCCDYPOEG/IFHUCKpZ2pIAQMwCgYIKoZIzj0EAwIw

From 55d96c6732c1e0223fb6f1c5296e8d1306058f29 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Fri, 13 Dec 2024 05:15:08 +0100
Subject: [PATCH 312/458] feat: if profile delete confirm text is mismatched
 then show toast (#110)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/110
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/ui/ProfileDeleteFragment.kt     | 50 +++++++++++++------
 app-common/src/main/res/values/strings.xml    |  1 +
 2 files changed, 35 insertions(+), 16 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index a06b587e7..7f82f22a8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -4,6 +4,7 @@ import android.app.Dialog
 import android.os.Bundle
 import android.text.Editable
 import android.widget.EditText
+import android.widget.Toast
 import androidx.appcompat.app.AlertDialog
 import androidx.fragment.app.DialogFragment
 import androidx.lifecycle.lifecycleScope
@@ -16,31 +17,47 @@ import kotlinx.coroutines.launch
 class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
     companion object {
         const val TAG = "ProfileDeleteFragment"
+        private const val FIELD_ICCID = "iccid"
+        private const val FIELD_NAME = "name"
 
         fun newInstance(slotId: Int, portId: Int, iccid: String, name: String): ProfileDeleteFragment {
             val instance = newInstanceEuicc(ProfileDeleteFragment::class.java, slotId, portId)
             instance.requireArguments().apply {
-                putString("iccid", iccid)
-                putString("name", name)
+                putString(FIELD_ICCID, iccid)
+                putString(FIELD_NAME, name)
             }
             return instance
         }
     }
 
+    private val iccid by lazy {
+        requireArguments().getString(FIELD_ICCID)!!
+    }
+
+    private val name by lazy {
+        requireArguments().getString(FIELD_NAME)!!
+    }
+
     private val editText by lazy {
         EditText(requireContext()).apply {
-            hint = Editable.Factory.getInstance().newEditable(
-                getString(R.string.profile_delete_confirm_input, requireArguments().getString("name")!!)
-            )
+            hint = Editable.Factory.getInstance()
+                .newEditable(getString(R.string.profile_delete_confirm_input, name))
         }
     }
+
     private val inputMatchesName: Boolean
-        get() = editText.text.toString() == requireArguments().getString("name")!!
+        get() = editText.text.toString() == name
+
+    private var toast: Toast? = null
+
     private var deleting = false
 
+    private val alertDialog: AlertDialog
+        get() = requireDialog() as AlertDialog
+
     override fun onCreateDialog(savedInstanceState: Bundle?): Dialog =
         AlertDialog.Builder(requireContext(), R.style.AlertDialogTheme).apply {
-            setMessage(getString(R.string.profile_delete_confirm, requireArguments().getString("name")))
+            setMessage(getString(R.string.profile_delete_confirm, name))
             setView(editText)
             setPositiveButton(android.R.string.ok, null) // Set listener to null to prevent auto closing
             setNegativeButton(android.R.string.cancel, null)
@@ -48,9 +65,8 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
 
     override fun onResume() {
         super.onResume()
-        val alertDialog = dialog!! as AlertDialog
         alertDialog.getButton(AlertDialog.BUTTON_POSITIVE).setOnClickListener {
-            if (!deleting && inputMatchesName) delete()
+            if (!deleting) delete()
         }
         alertDialog.getButton(AlertDialog.BUTTON_NEGATIVE).setOnClickListener {
             if (!deleting) dismiss()
@@ -58,8 +74,15 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
     }
 
     private fun delete() {
+        toast?.cancel()
+        if (!inputMatchesName) {
+            val resId = R.string.toast_profile_delete_confirm_text_mismatched
+            toast = Toast.makeText(requireContext(), resId, Toast.LENGTH_LONG).also {
+                it.show()
+            }
+            return
+        }
         deleting = true
-        val alertDialog = dialog!! as AlertDialog
         alertDialog.setCanceledOnTouchOutside(false)
         alertDialog.setCancelable(false)
         alertDialog.getButton(AlertDialog.BUTTON_POSITIVE).isEnabled = false
@@ -68,12 +91,7 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         requireParentFragment().lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-
-            euiccChannelManagerService.launchProfileDeleteTask(
-                slotId,
-                portId,
-                requireArguments().getString("iccid")!!
-            ).onStart {
+            euiccChannelManagerService.launchProfileDeleteTask(slotId, portId, iccid).onStart {
                 if (parentFragment is EuiccProfilesChangedListener) {
                     // Trigger a refresh in the parent fragment -- it should wait until
                     // any foreground task is completed before actually doing a refresh
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d532a0c6a..61823f7f5 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -29,6 +29,7 @@
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>
+    <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
 
     <string name="slot_select">Select Slot</string>

From f294fb5e17aa19bdda92769c82bc150105acefb6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 13 Dec 2024 08:33:02 -0500
Subject: [PATCH 313/458] ui: wizard: Reintroduce support for downloading to
 USB readers

...and fixup our API which caused this problem in the first place.
---
 .../openeuicc/core/DefaultEuiccChannelManager.kt      | 11 +++++++++--
 .../im/angry/openeuicc/core/EuiccChannelManager.kt    | 11 ++++++++++-
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt   |  2 +-
 .../ui/wizard/DownloadWizardSlotSelectFragment.kt     |  9 +++++++--
 .../angry/openeuicc/util/PrivilegedTelephonyUtils.kt  |  2 +-
 5 files changed, 28 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index c75af4093..07db80b05 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -13,7 +13,7 @@ import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.flow.flowOn
-import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.flow.merge
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.withContext
@@ -208,7 +208,7 @@ open class DefaultEuiccChannelManager(
         }
     }
 
-    override fun flowEuiccPorts(): Flow<Pair<Int, Int>> = flow {
+    override fun flowInternalEuiccPorts(): Flow<Pair<Int, Int>> = flow {
         uiccCards.forEach { info ->
             info.ports.forEach { port ->
                 tryOpenEuiccChannel(port)?.also {
@@ -223,6 +223,13 @@ open class DefaultEuiccChannelManager(
         }
     }.flowOn(Dispatchers.IO)
 
+    override fun flowAllOpenEuiccPorts(): Flow<Pair<Int, Int>> =
+        merge(flowInternalEuiccPorts(), flow {
+            if (tryOpenUsbEuiccChannel().second) {
+                emit(Pair(EuiccChannelManager.USB_CHANNEL_ID, 0))
+            }
+        })
+
     override suspend fun tryOpenUsbEuiccChannel(): Pair<UsbDevice?, Boolean> =
         withContext(Dispatchers.IO) {
             usbManager.deviceList.values.forEach { device ->
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
index c485cd259..17f3130c6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelManager.kt
@@ -26,7 +26,16 @@ interface EuiccChannelManager {
      *
      * To obtain a temporary reference to a EuiccChannel, use `withEuiccChannel()`.
      */
-    fun flowEuiccPorts(): Flow<Pair<Int, Int>>
+    fun flowInternalEuiccPorts(): Flow<Pair<Int, Int>>
+
+    /**
+     * Same as flowInternalEuiccPorts(), except that this includes non-device internal eUICC chips
+     * as well. Namely, this includes the USB reader.
+     *
+     * Non-internal readers will only be included if they have been opened properly, i.e. with permissions
+     * granted by the user.
+     */
+    fun flowAllOpenEuiccPorts(): Flow<Pair<Int, Int>>
 
     /**
      * Scan all possible USB devices for CCID readers that may contain eUICC cards.
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index b11a3ddd9..767e7e0e4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -151,7 +151,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
         val newPages: MutableList<Page> = mutableListOf()
 
-        euiccChannelManager.flowEuiccPorts().onEach { (slotId, portId) ->
+        euiccChannelManager.flowInternalEuiccPorts().onEach { (slotId, portId) ->
             Log.d(TAG, "slot $slotId port $portId")
 
             euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index b268b626c..ffb3ce1fc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -14,6 +14,7 @@ import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import androidx.recyclerview.widget.RecyclerView.ViewHolder
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.map
 import kotlinx.coroutines.flow.toList
@@ -91,7 +92,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
     private suspend fun init() {
         ensureEuiccChannelManager()
         showProgressBar(-1)
-        val slots = euiccChannelManager.flowEuiccPorts().map { (slotId, portId) ->
+        val slots = euiccChannelManager.flowAllOpenEuiccPorts().map { (slotId, portId) ->
             euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
                 SlotInfo(
                     channel.logicalSlotId,
@@ -174,7 +175,11 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                 )
             }
 
-            title.text = root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
+            title.text = if (item.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                root.context.getString(R.string.usb)
+            } else {
+                root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
+            }
             eID.text = item.eID
             activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
             freeSpace.text = formatFreeSpace(item.freeSpace)
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
index edeb49f51..650fe748a 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyUtils.kt
@@ -18,7 +18,7 @@ val TelephonyManager.dsdsEnabled: Boolean
 fun TelephonyManager.setDsdsEnabled(euiccManager: EuiccChannelManager, enabled: Boolean) {
     // Disable all eSIM profiles before performing a DSDS switch (only for internal eSIMs)
     runBlocking {
-        euiccManager.flowEuiccPorts().onEach { (slotId, portId) ->
+        euiccManager.flowInternalEuiccPorts().onEach { (slotId, portId) ->
             euiccManager.withEuiccChannel(slotId, portId) {
                 if (!it.port.card.isRemovable) {
                     it.lpa.disableActiveProfile(false)

From aed247904487ba9b2f01ac2030406a9bd0c1c37c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 13 Dec 2024 08:34:21 -0500
Subject: [PATCH 314/458] ui: wizard: Prevent de-selecting checkboxes

---
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index ffb3ce1fc..54dbc085d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -151,6 +151,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         @Suppress("UNUSED_PARAMETER")
         fun onSelect(view: View) {
             if (curIdx < 0) return
+            checkBox.isChecked = true
             if (adapter.currentSelectedIdx == curIdx) return
             val lastIdx = adapter.currentSelectedIdx
             adapter.currentSelectedIdx = curIdx

From aefa79b18b93536834f97a338fc4645558a838d8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 13:47:23 -0500
Subject: [PATCH 315/458] refactor: Channel format should use DI instead of
 resource overriding

i18n makes resource overriding unreliable.
---
 .../main/java/im/angry/openeuicc/di/AppContainer.kt    |  1 +
 .../im/angry/openeuicc/di/CustomizableTextProvider.kt  |  9 +++++++++
 .../java/im/angry/openeuicc/di/DefaultAppContainer.kt  |  4 ++++
 .../openeuicc/di/DefaultCustomizableTextProvider.kt    |  9 +++++++++
 .../main/java/im/angry/openeuicc/ui/MainActivity.kt    |  3 ++-
 .../ui/wizard/DownloadWizardSlotSelectFragment.kt      |  2 +-
 app-common/src/main/res/values-ja/strings.xml          |  1 -
 app-common/src/main/res/values-zh-rCN/strings.xml      |  1 -
 app-common/src/main/res/values/strings.xml             |  1 -
 .../im/angry/openeuicc/di/UnprivilegedAppContainer.kt  |  4 ++++
 .../di/UnprivilegedCustomizableTextProvider.kt         | 10 ++++++++++
 app-unpriv/src/main/res/values/strings.xml             |  2 +-
 12 files changed, 41 insertions(+), 6 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedCustomizableTextProvider.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
index 4b3c3cdac..cae7e2ebf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/AppContainer.kt
@@ -15,4 +15,5 @@ interface AppContainer {
     val preferenceRepository: PreferenceRepository
     val uiComponentFactory: UiComponentFactory
     val euiccChannelFactory: EuiccChannelFactory
+    val customizableTextProvider: CustomizableTextProvider
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
new file mode 100644
index 000000000..bb8e69679
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
@@ -0,0 +1,9 @@
+package im.angry.openeuicc.di
+
+interface CustomizableTextProvider {
+    /**
+     * Format the name of a logical slot; internal only -- not intended for
+     * other channels such as USB.
+     */
+    fun formatInternalChannelName(logicalSlotId: Int): String
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
index 93fd8b858..9b70099cc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultAppContainer.kt
@@ -38,4 +38,8 @@ open class DefaultAppContainer(context: Context) : AppContainer {
     override val euiccChannelFactory by lazy {
         DefaultEuiccChannelFactory(context)
     }
+
+    override val customizableTextProvider by lazy {
+        DefaultCustomizableTextProvider(context)
+    }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
new file mode 100644
index 000000000..d8f4b2cd5
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
@@ -0,0 +1,9 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+import im.angry.openeuicc.common.R
+
+open class DefaultCustomizableTextProvider(private val context: Context) : CustomizableTextProvider {
+    override fun formatInternalChannelName(logicalSlotId: Int): String =
+        context.getString(R.string.channel_name_format, logicalSlotId)
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 767e7e0e4..01d0ab2b9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -163,7 +163,8 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
                 // but it could change in the future
                 euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
 
-                val channelName = getString(R.string.channel_name_format, channel.logicalSlotId)
+                val channelName =
+                    appContainer.customizableTextProvider.formatInternalChannelName(channel.logicalSlotId)
                 newPages.add(Page(channel.logicalSlotId, channelName) {
                     appContainer.uiComponentFactory.createEuiccManagementFragment(slotId, portId)
                 })
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 54dbc085d..887987810 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -179,7 +179,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             title.text = if (item.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
                 root.context.getString(R.string.usb)
             } else {
-                root.context.getString(R.string.download_wizard_slot_title, item.logicalSlotId)
+                appContainer.customizableTextProvider.formatInternalChannelName(item.logicalSlotId)
             }
             eID.text = item.eID
             activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index d25af4938..7d99cb7b7 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -43,7 +43,6 @@
     <string name="download_wizard_back">戻る</string>
     <string name="download_wizard_next">次へ</string>
     <string name="download_wizard_slot_select">ダウンロードする eSIM を選択または確認:</string>
-    <string name="download_wizard_slot_title">論理スロット %d</string>
     <string name="download_wizard_slot_type">タイプ:</string>
     <string name="download_wizard_slot_type_removable">リムーバブル</string>
     <string name="download_wizard_slot_type_internal">内部</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 3bb0d042b..551435b4b 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -81,7 +81,6 @@
     <string name="download_wizard_back">返回</string>
     <string name="download_wizard_next">下一步</string>
     <string name="download_wizard_slot_select">请选择或确认下载目标 eSIM 卡槽:</string>
-    <string name="download_wizard_slot_title">逻辑卡槽 %d</string>
     <string name="download_wizard_slot_type">类型:</string>
     <string name="download_wizard_slot_type_removable">可插拔</string>
     <string name="download_wizard_slot_type_internal">内置</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 61823f7f5..eec59c048 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -64,7 +64,6 @@
     <string name="download_wizard_back">Back</string>
     <string name="download_wizard_next">Next</string>
     <string name="download_wizard_slot_select">Select or confirm the eSIM you would like to download to:</string>
-    <string name="download_wizard_slot_title">Logical slot %d</string>
     <string name="download_wizard_slot_type">Type:</string>
     <string name="download_wizard_slot_type_removable">Removable</string>
     <string name="download_wizard_slot_type_internal">Internal</string>
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
index 22d5a62dd..4dbfe4158 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
@@ -6,4 +6,8 @@ class UnprivilegedAppContainer(context: Context) : DefaultAppContainer(context)
     override val uiComponentFactory by lazy {
         UnprivilegedUiComponentFactory()
     }
+
+    override val customizableTextProvider by lazy {
+        UnprivilegedCustomizableTextProvider(context)
+    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedCustomizableTextProvider.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedCustomizableTextProvider.kt
new file mode 100644
index 000000000..929ce84ca
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedCustomizableTextProvider.kt
@@ -0,0 +1,10 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+import im.angry.easyeuicc.R
+
+class UnprivilegedCustomizableTextProvider(private val context: Context) :
+    DefaultCustomizableTextProvider(context) {
+    override fun formatInternalChannelName(logicalSlotId: Int): String =
+        context.getString(R.string.channel_name_format_unpriv, logicalSlotId)
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 9d80b0e17..afed295b8 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -1,6 +1,6 @@
 <resources>
     <string name="app_name" translatable="false">EasyEUICC</string>
-    <string name="channel_name_format" translatable="false">SIM %d</string>
+    <string name="channel_name_format_unpriv" translatable="false">SIM %d</string>
     <string name="compatibility_check">Compatibility Check</string>
     <string name="open_sim_toolkit">Open SIM Toolkit</string>
 

From 14ea84c36e208815196982f80ec8d5778cef8910 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 14:21:05 -0500
Subject: [PATCH 316/458] ui: Add placeholder text for when no eUICC is found
 to TextProvider

---
 .../im/angry/openeuicc/di/CustomizableTextProvider.kt  |  6 ++++++
 .../openeuicc/di/DefaultCustomizableTextProvider.kt    |  3 +++
 .../angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt   |  9 +++++++--
 .../im/angry/openeuicc/di/PrivilegedAppContainer.kt    |  4 ++++
 .../openeuicc/di/PrivilegedCustomizableTextProvider.kt | 10 ++++++++++
 app/src/main/res/values-ja/strings.xml                 |  2 +-
 app/src/main/res/values-zh-rCN/strings.xml             |  2 +-
 app/src/main/res/values/strings.xml                    |  2 +-
 8 files changed, 33 insertions(+), 5 deletions(-)
 create mode 100644 app/src/main/java/im/angry/openeuicc/di/PrivilegedCustomizableTextProvider.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
index bb8e69679..91dac6520 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
@@ -1,6 +1,12 @@
 package im.angry.openeuicc.di
 
 interface CustomizableTextProvider {
+    /**
+     * Explanation string for when no eUICC is found on the device.
+     * This could be different depending on whether the app is privileged or not.
+     */
+    val noEuiccExplanation: String
+
     /**
      * Format the name of a logical slot; internal only -- not intended for
      * other channels such as USB.
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
index d8f4b2cd5..f4d526e8b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
@@ -4,6 +4,9 @@ import android.content.Context
 import im.angry.openeuicc.common.R
 
 open class DefaultCustomizableTextProvider(private val context: Context) : CustomizableTextProvider {
+    override val noEuiccExplanation: String
+        get() = context.getString(R.string.no_euicc)
+
     override fun formatInternalChannelName(logicalSlotId: Int): String =
         context.getString(R.string.channel_name_format, logicalSlotId)
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
index e9e44b118..7e96af3a9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NoEuiccPlaceholderFragment.kt
@@ -4,15 +4,20 @@ import android.os.Bundle
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
+import android.widget.TextView
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.*
 
-class NoEuiccPlaceholderFragment : Fragment() {
+class NoEuiccPlaceholderFragment : Fragment(), OpenEuiccContextMarker {
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
         savedInstanceState: Bundle?
     ): View? {
-        return inflater.inflate(R.layout.fragment_no_euicc_placeholder, container, false)
+        val view = inflater.inflate(R.layout.fragment_no_euicc_placeholder, container, false)
+        val textView = view.requireViewById<TextView>(R.id.no_euicc_placeholder)
+        textView.text = appContainer.customizableTextProvider.noEuiccExplanation
+        return view
     }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index c5896f272..d821e6841 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -23,4 +23,8 @@ class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val euiccChannelFactory by lazy {
         PrivilegedEuiccChannelFactory(context)
     }
+
+    override val customizableTextProvider by lazy {
+        PrivilegedCustomizableTextProvider(context)
+    }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedCustomizableTextProvider.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedCustomizableTextProvider.kt
new file mode 100644
index 000000000..e53832fa4
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedCustomizableTextProvider.kt
@@ -0,0 +1,10 @@
+package im.angry.openeuicc.di
+
+import android.content.Context
+import im.angry.openeuicc.R
+
+class PrivilegedCustomizableTextProvider(private val context: Context) :
+    DefaultCustomizableTextProvider(context) {
+    override val noEuiccExplanation: String
+        get() = context.getString(R.string.no_euicc_priv)
+}
\ No newline at end of file
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
index 5ff67409f..29f3ef6dd 100644
--- a/app/src/main/res/values-ja/strings.xml
+++ b/app/src/main/res/values-ja/strings.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="no_euicc">このデバイスで eUICC が見つかりません。\nデバイスによってはアプリのメニューからデュアル SIM を有効化する必要があります。</string>
+    <string name="no_euicc_priv">このデバイスで eUICC が見つかりません。\nデバイスによってはアプリのメニューからデュアル SIM を有効化する必要があります。</string>
     <string name="telephony_manager">TelephonyManager (特権)</string>
     <string name="dsds">デュアル SIM</string>
     <string name="toast_dsds_switched">DSDS の状態が切り替わりました。モデムが再起動するまでお待ちください。</string>
diff --git a/app/src/main/res/values-zh-rCN/strings.xml b/app/src/main/res/values-zh-rCN/strings.xml
index 9b34bb80d..18497b267 100644
--- a/app/src/main/res/values-zh-rCN/strings.xml
+++ b/app/src/main/res/values-zh-rCN/strings.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="no_euicc">在此设备上找不到 eUICC 芯片。\n在某些设备上，您可能需要先在此应用的菜单中启用双卡支持。</string>
+    <string name="no_euicc_priv">在此设备上找不到 eUICC 芯片。\n在某些设备上，您可能需要先在此应用的菜单中启用双卡支持。</string>
     <string name="dsds">双卡</string>
     <string name="toast_dsds_switched">双卡支持状态已切换。请等待基带重新启动。</string>
     <string name="footer_mep">此卡槽支持多个启用配置文件 (MEP)。要启用或禁用此功能，请使用\"卡槽映射\"工具。</string>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index bb2233b8d..47c88bdd0 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -1,6 +1,6 @@
 <resources>
     <string name="app_name" translatable="false">OpenEUICC</string>
-    <string name="no_euicc">No eUICC found on this device.\nOn some devices, you may need to enable dual SIM first in the menu of this app.</string>
+    <string name="no_euicc_priv">No eUICC found on this device.\nOn some devices, you may need to enable dual SIM first in the menu of this app.</string>
     <string name="telephony_manager">TelephonyManager (Privileged)</string>
 
     <string name="dsds">Dual SIM</string>

From bc238c45cd637e5fd64219fa9888383eb7816bc0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 14:38:09 -0500
Subject: [PATCH 317/458] ui: Add switching timeout message to the new DI text
 provider

---
 .../java/im/angry/openeuicc/di/CustomizableTextProvider.kt   | 5 +++++
 .../im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt | 3 +++
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt    | 2 +-
 3 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
index 91dac6520..2c86273aa 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/CustomizableTextProvider.kt
@@ -7,6 +7,11 @@ interface CustomizableTextProvider {
      */
     val noEuiccExplanation: String
 
+    /**
+     * Shown when we timed out switching between profiles.
+     */
+    val profileSwitchingTimeoutMessage: String
+
     /**
      * Format the name of a logical slot; internal only -- not intended for
      * other channels such as USB.
diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
index f4d526e8b..b49361123 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
@@ -7,6 +7,9 @@ open class DefaultCustomizableTextProvider(private val context: Context) : Custo
     override val noEuiccExplanation: String
         get() = context.getString(R.string.no_euicc)
 
+    override val profileSwitchingTimeoutMessage: String
+        get() = context.getString(R.string.enable_disable_timeout)
+
     override fun formatInternalChannelName(logicalSlotId: Int): String =
         context.getString(R.string.channel_name_format, logicalSlotId)
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 8e7b15803..7056c17be 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -261,7 +261,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                         invalid = true
                         // Timed out waiting for SIM to come back online, we can no longer assume that the LPA is still valid
                         AlertDialog.Builder(requireContext()).apply {
-                            setMessage(R.string.enable_disable_timeout)
+                            setMessage(appContainer.customizableTextProvider.profileSwitchingTimeoutMessage)
                             setPositiveButton(android.R.string.ok) { dialog, _ ->
                                 dialog.dismiss()
                                 requireActivity().finish()

From 70f1e00eb4f5c7cf96a8a06cbc016bae6395b8d7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 14:55:27 -0500
Subject: [PATCH 318/458] refactor: Extract shared log-saving behavior

...so that we implement log-sharing once and apply it to both spots.
---
 .../im/angry/openeuicc/ui/LogsActivity.kt     | 24 ++++++--------
 .../DownloadWizardDiagnosticsFragment.kt      | 26 ++++++---------
 .../java/im/angry/openeuicc/util/UiUtils.kt   | 32 ++++++++++++++++++-
 3 files changed, 51 insertions(+), 31 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index 49bfa0f32..c6ba256b3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -8,7 +8,6 @@ import android.view.View
 import android.widget.ScrollView
 import android.widget.TextView
 import androidx.activity.enableEdgeToEdge
-import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout
@@ -17,7 +16,6 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
-import java.io.FileOutputStream
 import java.util.Date
 
 class LogsActivity : AppCompatActivity() {
@@ -27,15 +25,15 @@ class LogsActivity : AppCompatActivity() {
     private lateinit var logStr: String
 
     private val saveLogs =
-        registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
-            if (uri == null) return@registerForActivityResult
-            if (!this::logStr.isInitialized) return@registerForActivityResult
-            contentResolver.openFileDescriptor(uri, "w")?.use {
-                FileOutputStream(it.fileDescriptor).use { os ->
-                    os.write(logStr.encodeToByteArray())
-                }
-            }
-        }
+        setupLogSaving(
+            getLogFileName = {
+                getString(
+                    R.string.logs_filename_template,
+                    SimpleDateFormat.getDateTimeInstance().format(Date())
+                )
+            },
+            getLogText = { logStr }
+        )
 
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
@@ -76,9 +74,7 @@ class LogsActivity : AppCompatActivity() {
             true
         }
         R.id.save -> {
-            saveLogs.launch(getString(R.string.logs_filename_template,
-                SimpleDateFormat.getDateTimeInstance().format(Date())
-            ))
+            saveLogs()
             true
         }
         else -> super.onOptionsItemSelected(item)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index fbbd1a006..e282196a4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -6,10 +6,8 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
-import androidx.activity.result.contract.ActivityResultContracts
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
-import java.io.FileOutputStream
 import java.util.Date
 
 class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
@@ -21,14 +19,15 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
     private lateinit var diagnosticTextView: TextView
 
     private val saveDiagnostics =
-        registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
-            if (uri == null) return@registerForActivityResult
-            requireActivity().contentResolver.openFileDescriptor(uri, "w")?.use {
-                FileOutputStream(it.fileDescriptor).use { os ->
-                    os.write(diagnosticTextView.text.toString().encodeToByteArray())
-                }
-            }
-        }
+        setupLogSaving(
+            getLogFileName = {
+                getString(
+                    R.string.download_wizard_diagnostics_file_template,
+                    SimpleDateFormat.getDateTimeInstance().format(Date())
+                )
+            },
+            getLogText = { diagnosticTextView.text.toString() }
+        )
 
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 
@@ -41,12 +40,7 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
     ): View? {
         val view = inflater.inflate(R.layout.fragment_download_diagnostics, container, false)
         view.requireViewById<View>(R.id.download_wizard_diagnostics_save).setOnClickListener {
-            saveDiagnostics.launch(
-                getString(
-                    R.string.download_wizard_diagnostics_file_template,
-                    SimpleDateFormat.getDateTimeInstance().format(Date())
-                )
-            )
+            saveDiagnostics()
         }
         diagnosticTextView = view.requireViewById(R.id.download_wizard_diagnostics_text)
         return view
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index fbede8781..b02574e61 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -1,17 +1,21 @@
 package im.angry.openeuicc.util
 
+import android.content.Context
 import android.content.res.Resources
 import android.graphics.Rect
 import android.view.View
 import android.view.ViewGroup
+import androidx.activity.result.ActivityResultCaller
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
-import androidx.appcompat.widget.Toolbar
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updateLayoutParams
 import androidx.core.view.updatePadding
 import androidx.fragment.app.DialogFragment
+import androidx.fragment.app.Fragment
 import im.angry.openeuicc.common.R
+import java.io.FileOutputStream
 
 // Source: <https://stackoverflow.com/questions/12478520/how-to-set-dialogfragments-width-and-height>
 /**
@@ -69,4 +73,30 @@ fun setupRootViewInsets(view: ViewGroup) {
 
         WindowInsetsCompat.CONSUMED
     }
+}
+
+fun <T : ActivityResultCaller> T.setupLogSaving(
+    getLogFileName: () -> String,
+    getLogText: () -> String
+): () -> Unit {
+    val launchSaveIntent =
+        registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
+            if (uri == null) return@registerForActivityResult
+
+            val contentResolver = when (this@setupLogSaving) {
+                is Context -> contentResolver
+                is Fragment -> requireContext().contentResolver
+                else -> throw IllegalArgumentException("Must be either Context or Fragment!")
+            }
+
+            contentResolver.openFileDescriptor(uri, "w")?.use {
+                FileOutputStream(it.fileDescriptor).use { os ->
+                    os.write(getLogText().encodeToByteArray())
+                }
+            }
+        }
+
+    return {
+        launchSaveIntent.launch(getLogFileName())
+    }
 }
\ No newline at end of file

From ec334d104aa84610be95d077bc4bfd97ea3d0d98 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 15:18:47 -0500
Subject: [PATCH 319/458] ui: Implement log content sharing

---
 .../java/im/angry/openeuicc/util/UiUtils.kt   | 24 +++++++++++++++----
 app-common/src/main/res/values/strings.xml    |  2 ++
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index b02574e61..c8e481ccb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -1,12 +1,14 @@
 package im.angry.openeuicc.util
 
 import android.content.Context
+import android.content.Intent
 import android.content.res.Resources
 import android.graphics.Rect
 import android.view.View
 import android.view.ViewGroup
 import androidx.activity.result.ActivityResultCaller
 import androidx.activity.result.contract.ActivityResultContracts
+import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
@@ -83,17 +85,31 @@ fun <T : ActivityResultCaller> T.setupLogSaving(
         registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
             if (uri == null) return@registerForActivityResult
 
-            val contentResolver = when (this@setupLogSaving) {
-                is Context -> contentResolver
-                is Fragment -> requireContext().contentResolver
+            val context = when (this@setupLogSaving) {
+                is Context -> this@setupLogSaving
+                is Fragment -> requireContext()
                 else -> throw IllegalArgumentException("Must be either Context or Fragment!")
             }
 
-            contentResolver.openFileDescriptor(uri, "w")?.use {
+            context.contentResolver.openFileDescriptor(uri, "w")?.use {
                 FileOutputStream(it.fileDescriptor).use { os ->
                     os.write(getLogText().encodeToByteArray())
                 }
             }
+
+            AlertDialog.Builder(context).apply {
+                setMessage(R.string.logs_saved_message)
+                setNegativeButton(R.string.no) { _, _ -> }
+                setPositiveButton(R.string.yes) { _, _ ->
+                    val intent = Intent().apply {
+                        action = Intent.ACTION_SEND
+                        type = "text/plain"
+                        putExtra(Intent.EXTRA_STREAM, uri)
+                    }
+
+                    context.startActivity(Intent.createChooser(intent, null))
+                }
+            }.show()
         }
 
     return {
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index eec59c048..34448ff1d 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -94,6 +94,8 @@
     <string name="download_wizard_diagnostics_save">Save</string>
     <string name="download_wizard_diagnostics_file_template">Diagnostics at %s</string>
 
+    <string name="logs_saved_message">Logs have been saved to the selected path. Would you like to share the log through another app?</string>
+
     <string name="profile_rename_new_name">New nickname</string>
 
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>

From 815d4d4324f265cfc81abe45ab375676922d73a4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 16:11:49 -0500
Subject: [PATCH 320/458] Expose USB device name as intrinsic name for use with
 download wizard

---
 .../im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt | 2 ++
 .../src/main/java/im/angry/openeuicc/core/EuiccChannel.kt | 7 +++++++
 .../main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt | 1 +
 .../java/im/angry/openeuicc/core/EuiccChannelWrapper.kt   | 2 ++
 .../ui/wizard/DownloadWizardSlotSelectFragment.kt         | 8 +++++---
 .../angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt | 1 +
 6 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index a8fa1d535..5e87564c3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -37,6 +37,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
             return EuiccChannelImpl(
                 context.getString(R.string.omapi),
                 port,
+                intrinsicChannelName = null,
                 OmapiApduInterface(
                     seService!!,
                     port,
@@ -67,6 +68,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         return EuiccChannelImpl(
             context.getString(R.string.usb),
             FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
+            intrinsicChannelName = usbDevice.productName,
             UsbApduInterface(
                 conn,
                 bulkIn,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 4ef68089a..541f8671a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -16,5 +16,12 @@ interface EuiccChannel {
 
     val valid: Boolean
 
+    /**
+     * Intrinsic name of this channel. For device-internal SIM slots,
+     * this should be null; for USB readers, this should be the name of
+     * the reader device.
+     */
+    val intrinsicChannelName: String?
+
     fun close()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index 79dec3436..a28194876 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -10,6 +10,7 @@ import net.typeblog.lpac_jni.impl.LocalProfileAssistantImpl
 class EuiccChannelImpl(
     override val type: String,
     override val port: UiccPortInfoCompat,
+    override val intrinsicChannelName: String?,
     apduInterface: ApduInterface,
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index ab01f22b9..6011f5315 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -31,6 +31,8 @@ class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
     override val lpa: LocalProfileAssistant by lpaDelegate
     override val valid: Boolean
         get() = channel.valid
+    override val intrinsicChannelName: String?
+        get() = channel.intrinsicChannelName
 
     override fun close() = channel.close()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 887987810..7e1dc23ea 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -35,7 +35,8 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         val eID: String,
         val freeSpace: Int,
         val imei: String,
-        val enabledProfileName: String?
+        val enabledProfileName: String?,
+        val intrinsicChannelName: String?,
     )
 
     private var loaded = false
@@ -106,7 +107,8 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                     } catch (e: Exception) {
                         ""
                     },
-                    channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName
+                    channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName,
+                    channel.intrinsicChannelName,
                 )
             }
         }.toList().sortedBy { it.logicalSlotId }
@@ -177,7 +179,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             }
 
             title.text = if (item.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-                root.context.getString(R.string.usb)
+                item.intrinsicChannelName ?: root.context.getString(R.string.usb)
             } else {
                 appContainer.customizableTextProvider.formatInternalChannelName(item.logicalSlotId)
             }
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 1537fc9e5..b690c794d 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -30,6 +30,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                 return EuiccChannelImpl(
                     context.getString(R.string.telephony_manager),
                     port,
+                    intrinsicChannelName = null,
                     TelephonyManagerApduInterface(
                         port,
                         tm,

From 343dfb43f8346f967922d31d67bcc9cdb5e58d04 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 16:13:47 -0500
Subject: [PATCH 321/458] Remove unused SlotSelectFragment

---
 .../angry/openeuicc/ui/SlotSelectFragment.kt  | 93 -------------------
 1 file changed, 93 deletions(-)
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
deleted file mode 100644
index 2c4fe3c4c..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SlotSelectFragment.kt
+++ /dev/null
@@ -1,93 +0,0 @@
-package im.angry.openeuicc.ui
-
-import android.content.DialogInterface
-import android.os.Bundle
-import android.view.LayoutInflater
-import android.view.View
-import android.view.ViewGroup
-import android.widget.ArrayAdapter
-import android.widget.Spinner
-import androidx.appcompat.widget.Toolbar
-import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
-import im.angry.openeuicc.util.*
-
-class SlotSelectFragment : BaseMaterialDialogFragment(), OpenEuiccContextMarker {
-    companion object {
-        const val TAG = "SlotSelectFragment"
-
-        fun newInstance(slotIds: List<Int>, logicalSlotIds: List<Int>, portIds: List<Int>): SlotSelectFragment {
-            return SlotSelectFragment().apply {
-                arguments = Bundle().apply {
-                    putIntArray("slotIds", slotIds.toIntArray())
-                    putIntArray("logicalSlotIds", logicalSlotIds.toIntArray())
-                    putIntArray("portIds", portIds.toIntArray())
-                }
-            }
-        }
-    }
-
-    interface SlotSelectedListener {
-        fun onSlotSelected(slotId: Int, portId: Int)
-        fun onSlotSelectCancelled()
-    }
-
-    private lateinit var toolbar: Toolbar
-    private lateinit var spinner: Spinner
-    private lateinit var adapter: ArrayAdapter<String>
-    private lateinit var slotIds: IntArray
-    private lateinit var logicalSlotIds: IntArray
-    private lateinit var portIds: IntArray
-
-    override fun onCreateView(
-        inflater: LayoutInflater,
-        container: ViewGroup?,
-        savedInstanceState: Bundle?
-    ): View? {
-        val view = inflater.inflate(R.layout.fragment_slot_select, container, false)
-
-        toolbar = view.requireViewById(R.id.toolbar)
-        toolbar.setTitle(R.string.slot_select)
-        toolbar.inflateMenu(R.menu.fragment_slot_select)
-
-        adapter = ArrayAdapter<String>(inflater.context, R.layout.spinner_item)
-
-        spinner = view.requireViewById(R.id.spinner)
-        spinner.adapter = adapter
-
-        return view
-    }
-
-    override fun onStart() {
-        super.onStart()
-
-        slotIds = requireArguments().getIntArray("slotIds")!!
-        logicalSlotIds = requireArguments().getIntArray("logicalSlotIds")!!
-        portIds = requireArguments().getIntArray("portIds")!!
-
-        logicalSlotIds.forEach { id ->
-            adapter.add(getString(R.string.channel_name_format, id))
-        }
-
-        toolbar.setNavigationOnClickListener {
-            (requireActivity() as SlotSelectedListener).onSlotSelectCancelled()
-        }
-        toolbar.setOnMenuItemClickListener {
-            val slotId = slotIds[spinner.selectedItemPosition]
-            val portId = portIds[spinner.selectedItemPosition]
-            (requireActivity() as SlotSelectedListener).onSlotSelected(slotId, portId)
-            dismiss()
-            true
-        }
-    }
-
-    override fun onResume() {
-        super.onResume()
-        setWidthPercent(75)
-    }
-
-    override fun onCancel(dialog: DialogInterface) {
-        super.onCancel(dialog)
-        (requireActivity() as SlotSelectedListener).onSlotSelectCancelled()
-    }
-}
\ No newline at end of file

From 55c99831f396b89926b128a978cb3961e59ef643 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 20:36:59 -0500
Subject: [PATCH 322/458] ui: Copyable eid string

peter: redid parts of EuiccInfoViewHolder to remove the need for root
context (we can get it from activity directly).

Co-Authored-By: septs <github@septs.pw>

commit 2a6eb746bff034ed6032b8eac7462963bb39bcf1
Author: septs <github@septs.pw>
Date:   Sat Dec 14 11:26:42 2024 +0800

    feat: hide copied toast in android 13 or higher

commit d5bfd090b7b2e2c74c2cef698a43fc3607db260c
Merge: 0b2a498 aed2479
Author: septs <github@septs.pw>
Date:   Sat Dec 14 03:58:59 2024 +0800

    Merge branch 'master' into copyable-eid-string

commit 0b2a4988f2a2c2c7131a06867fc6bf622b281828
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:35:27 2024 +0800

    refactor: eid copied toast

commit ce854575aae304de68bddc0490998af5729632ab
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:27:18 2024 +0800

    revert: EuiccManagementFragment

commit 41229cac5727001ecb21992f5005b5b96b1d9557
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:27:10 2024 +0800

    revert: EuiccManagementFragment

commit 1f2b2d73ddfdc690442c0167e7f2f1748a78c921
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:25:01 2024 +0800

    feat: add euiccinfo activity specific strings

commit ca76ac841eab489ff1f825fef2f2aecd1ae88bb1
Merge: 110d490 55d96c6
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:23:34 2024 +0800

    Merge branch 'master' into copyable-eid-string

commit 110d49005a0cba26ee72eedfda0fc9e38a501d2a
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:23:21 2024 +0800

    revert: common strings

commit dc12e8d4107b9c80a1ca2bee0c5897f3e7d8dfa4
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:22:47 2024 +0800

    revert: unpriv strings

commit ccba9be141c533145464da3dbbc88afa16fac1fd
Merge: 34c5e41 0687354
Author: septs <github@septs.pw>
Date:   Fri Dec 13 12:15:42 2024 +0800

    Merge branch 'master' of ssh://gitea-ssh.angry.im:2222/PeterCxy/OpenEUICC into copyable-eid-string

commit 34c5e41dde663026b72b2c80301bfde2d14c0964
Author: septs <github@septs.pw>
Date:   Thu Dec 12 11:45:59 2024 +0800

    chore: simplify clickable

commit 4f1ed329f12b590691d273ac2150cb81ded11521
Author: septs <github@septs.pw>
Date:   Thu Dec 12 11:37:15 2024 +0800

    feat: copyable eid string
---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 80 +++++++++++++------
 app-common/src/main/res/values/strings.xml    |  1 +
 2 files changed, 58 insertions(+), 23 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 84b300e5c..36031dd12 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -1,13 +1,18 @@
 package im.angry.openeuicc.ui
 
 import android.annotation.SuppressLint
+import android.content.ClipData
+import android.content.ClipboardManager
+import android.os.Build
 import android.os.Bundle
 import android.view.LayoutInflater
 import android.view.MenuItem
 import android.view.View
 import android.view.ViewGroup
 import android.widget.TextView
+import android.widget.Toast
 import androidx.activity.enableEdgeToEdge
+import androidx.annotation.StringRes
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -32,6 +37,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
 
     private var logicalSlotId: Int = -1
 
+    data class Item(
+        @StringRes
+        val titleResId: Int,
+        val content: String?,
+        val copiedToastResId: Int? = null
+    )
+
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)
@@ -41,12 +53,11 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
         supportActionBar!!.setDisplayHomeAsUpEnabled(true)
 
         swipeRefresh = requireViewById(R.id.swipe_refresh)
-        infoList = requireViewById(R.id.recycler_view)
-
-        infoList.layoutManager =
-            LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
-        infoList.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
-        infoList.adapter = EuiccInfoAdapter()
+        infoList = requireViewById<RecyclerView>(R.id.recycler_view).also {
+            it.layoutManager = LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
+            it.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
+            it.adapter = EuiccInfoAdapter()
+        }
 
         logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
 
@@ -81,29 +92,33 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
 
         lifecycleScope.launch {
             (infoList.adapter!! as EuiccInfoAdapter).euiccInfoItems =
-                euiccChannelManager.withEuiccChannel(logicalSlotId, ::buildPairs).map {
-                    Pair(getString(it.first), it.second ?: getString(R.string.unknown))
-                }
+                euiccChannelManager.withEuiccChannel(logicalSlotId, ::buildEuiccInfoItems)
 
             swipeRefresh.isRefreshing = false
         }
     }
 
-    private fun buildPairs(channel: EuiccChannel) = buildList {
-        add(Pair(R.string.euicc_info_access_mode, channel.type))
+    private fun buildEuiccInfoItems(channel: EuiccChannel) = buildList {
+        add(Item(R.string.euicc_info_access_mode, channel.type))
         add(
-            Pair(
+            Item(
                 R.string.euicc_info_removable,
                 formatByBoolean(channel.port.card.isRemovable, YES_NO)
             )
         )
-        add(Pair(R.string.euicc_info_eid, channel.lpa.eID))
+        add(
+            Item(
+                R.string.euicc_info_eid,
+                channel.lpa.eID,
+                copiedToastResId = R.string.toast_eid_copied
+            )
+        )
         channel.lpa.euiccInfo2.let { info ->
-            add(Pair(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
-            add(Pair(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion))
-            add(Pair(R.string.euicc_info_pp_version, info?.ppVersion))
-            add(Pair(R.string.euicc_info_sas_accreditation_number, info?.sasAccreditationNumber))
-            add(Pair(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
+            add(Item(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
+            add(Item(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion))
+            add(Item(R.string.euicc_info_pp_version, info?.ppVersion))
+            add(Item(R.string.euicc_info_sas_accreditation_number, info?.sasAccreditationNumber))
+            add(Item(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
         }
         channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
             // SGP.28 v1.0, eSIM CI Registration Criteria (Page 5 of 9, 2019-10-24)
@@ -116,7 +131,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
                 PKID_GSMA_TEST_CI.any(signers::contains) -> R.string.euicc_info_ci_gsma_test
                 else -> R.string.euicc_info_ci_unknown
             }
-            add(Pair(R.string.euicc_info_ci_type, getString(resId)))
+            add(Item(R.string.euicc_info_ci_type, getString(resId)))
         }
     }
 
@@ -132,15 +147,34 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
     inner class EuiccInfoViewHolder(root: View) : ViewHolder(root) {
         private val title: TextView = root.requireViewById(R.id.euicc_info_title)
         private val content: TextView = root.requireViewById(R.id.euicc_info_content)
+        private var copiedToastResId: Int? = null
 
-        fun bind(item: Pair<String, String>) {
-            title.text = item.first
-            content.text = item.second
+        init {
+            root.setOnClickListener {
+                if (copiedToastResId != null) {
+                    val label = title.text.toString()
+                    getSystemService(ClipboardManager::class.java)!!
+                        .setPrimaryClip(ClipData.newPlainText(label, content.text))
+                    if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.S_V2) {
+                        Toast.makeText(
+                            this@EuiccInfoActivity,
+                            copiedToastResId!!,
+                            Toast.LENGTH_SHORT
+                        ).show()
+                    }
+                }
+            }
+        }
+
+        fun bind(item: Item) {
+            copiedToastResId = item.copiedToastResId
+            title.setText(item.titleResId)
+            content.text = item.content ?: getString(R.string.unknown)
         }
     }
 
     inner class EuiccInfoAdapter : RecyclerView.Adapter<EuiccInfoViewHolder>() {
-        var euiccInfoItems: List<Pair<String, String>> = listOf()
+        var euiccInfoItems: List<Item> = listOf()
             @SuppressLint("NotifyDataSetChanged")
             set(newVal) {
                 field = newVal
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 34448ff1d..e349c685b 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -31,6 +31,7 @@
     <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
+    <string name="toast_eid_copied">EID copied to clipboard</string>
 
     <string name="slot_select">Select Slot</string>
     <string name="slot_select_select">Select</string>

From 5a8d92c3df844fbbf6ad15db86c885ad21cdfb10 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 15 Dec 2024 02:44:44 +0100
Subject: [PATCH 323/458] feat: hide copied toast in android 13 or higher
 (#114)

see https://developer.android.com/develop/ui/views/touch-and-input/copy-paste#duplicate-notifications

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/114
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/ui/EuiccManagementFragment.kt     | 4 +++-
 .../im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt     | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 7056c17be..f806ae0ec 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -4,6 +4,7 @@ import android.annotation.SuppressLint
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Intent
+import android.os.Build
 import android.os.Bundle
 import android.text.method.PasswordTransformationMethod
 import android.view.LayoutInflater
@@ -348,7 +349,8 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             iccid.setOnLongClickListener {
                 requireContext().getSystemService(ClipboardManager::class.java)!!
                     .setPrimaryClip(ClipData.newPlainText("iccid", iccid.text))
-                Toast.makeText(requireContext(), R.string.toast_iccid_copied, Toast.LENGTH_SHORT)
+                if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.S_V2) Toast
+                    .makeText(requireContext(), R.string.toast_iccid_copied, Toast.LENGTH_SHORT)
                     .show()
                 true
             }
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
index 1ca9d0f04..1ef3e8908 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.ui
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.pm.PackageManager
+import android.os.Build
 import android.os.Bundle
 import android.widget.Toast
 import androidx.preference.Preference
@@ -35,7 +36,8 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
             setOnPreferenceClickListener {
                 requireContext().getSystemService(ClipboardManager::class.java)!!
                     .setPrimaryClip(ClipData.newPlainText("ara-m", summary))
-                Toast.makeText(requireContext(), R.string.toast_ara_m_copied, Toast.LENGTH_SHORT)
+                if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.S_V2) Toast
+                    .makeText(requireContext(), R.string.toast_ara_m_copied, Toast.LENGTH_SHORT)
                     .show()
                 true
             }

From 60396796935b32add43645de560b1fa6f5acdb76 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 20:57:53 -0500
Subject: [PATCH 324/458] refactor: Remove the need for specifying preference
 keys when binding

Co-authored-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 25 ++++++++-----------
 .../angry/openeuicc/util/PreferenceUtils.kt   | 21 +++++++++++++---
 2 files changed, 27 insertions(+), 19 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index c2cbee3a9..cb801afb8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -6,7 +6,6 @@ import android.os.Build
 import android.os.Bundle
 import android.provider.Settings
 import android.widget.Toast
-import androidx.datastore.preferences.core.Preferences
 import androidx.lifecycle.lifecycleScope
 import androidx.preference.CheckBoxPreference
 import androidx.preference.Preference
@@ -14,7 +13,6 @@ import androidx.preference.PreferenceCategory
 import androidx.preference.PreferenceFragmentCompat
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
@@ -60,25 +58,25 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         }
 
         findPreference<CheckBoxPreference>("pref_notifications_download")
-            ?.bindBooleanFlow(preferenceRepository.notificationDownloadFlow, PreferenceKeys.NOTIFICATION_DOWNLOAD)
+            ?.bindBooleanFlow(preferenceRepository.notificationDownloadFlow)
 
         findPreference<CheckBoxPreference>("pref_notifications_delete")
-            ?.bindBooleanFlow(preferenceRepository.notificationDeleteFlow, PreferenceKeys.NOTIFICATION_DELETE)
+            ?.bindBooleanFlow(preferenceRepository.notificationDeleteFlow)
 
         findPreference<CheckBoxPreference>("pref_notifications_switch")
-            ?.bindBooleanFlow(preferenceRepository.notificationSwitchFlow, PreferenceKeys.NOTIFICATION_SWITCH)
+            ?.bindBooleanFlow(preferenceRepository.notificationSwitchFlow)
 
         findPreference<CheckBoxPreference>("pref_advanced_disable_safeguard_removable_esim")
-            ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow, PreferenceKeys.DISABLE_SAFEGUARD_REMOVABLE_ESIM)
+            ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow)
 
         findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
-            ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow, PreferenceKeys.VERBOSE_LOGGING)
+            ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow)
 
         findPreference<CheckBoxPreference>("pref_developer_unfiltered_profile_list")
-            ?.bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow, PreferenceKeys.UNFILTERED_PROFILE_LIST)
+            ?.bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow)
 
         findPreference<CheckBoxPreference>("pref_ignore_tls_certificate")
-            ?.bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow, PreferenceKeys.IGNORE_TLS_CERTIFICATE)
+            ?.bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
     }
 
     override fun onStart() {
@@ -99,10 +97,7 @@ open class SettingsFragment: PreferenceFragmentCompat() {
 
         if (numClicks == 7) {
             lifecycleScope.launch {
-                preferenceRepository.updatePreference(
-                    PreferenceKeys.DEVELOPER_OPTIONS_ENABLED,
-                    true
-                )
+                preferenceRepository.developerOptionsEnabledFlow.updatePreference(true)
 
                 lastToast?.cancel()
                 Toast.makeText(
@@ -124,14 +119,14 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         return true
     }
 
-    private fun CheckBoxPreference.bindBooleanFlow(flow: Flow<Boolean>, key: Preferences.Key<Boolean>) {
+    private fun CheckBoxPreference.bindBooleanFlow(flow: PreferenceFlowWrapper<Boolean>) {
         lifecycleScope.launch {
             flow.collect { isChecked = it }
         }
 
         setOnPreferenceChangeListener { _, newValue ->
             runBlocking {
-                preferenceRepository.updatePreference(key, newValue as Boolean)
+                flow.updatePreference(newValue as Boolean)
             }
             true
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index e768fa953..f5e3ca2c1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -19,7 +19,7 @@ val Context.preferenceRepository: PreferenceRepository
 val Fragment.preferenceRepository: PreferenceRepository
     get() = requireContext().preferenceRepository
 
-object PreferenceKeys {
+internal object PreferenceKeys {
     // ---- Profile Notifications ----
     val NOTIFICATION_DOWNLOAD = booleanPreferencesKey("notification_download")
     val NOTIFICATION_DELETE = booleanPreferencesKey("notification_delete")
@@ -51,9 +51,22 @@ class PreferenceRepository(private val context: Context) {
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
 
-    private fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): Flow<T> =
-        context.dataStore.data.map { it[key] ?: defaultValue }
+    private fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): PreferenceFlowWrapper<T> =
+        PreferenceFlowWrapper(context, key, defaultValue)
+}
 
-    suspend fun <T> updatePreference(key: Preferences.Key<T>, value: T) =
+class PreferenceFlowWrapper<T> private constructor(
+    private val context: Context,
+    private val key: Preferences.Key<T>,
+    inner: Flow<T>
+) : Flow<T> by inner {
+    internal constructor(context: Context, key: Preferences.Key<T>, defaultValue: T) : this(
+        context,
+        key,
+        context.dataStore.data.map { it[key] ?: defaultValue }
+    )
+
+    suspend fun updatePreference(value: T) {
         context.dataStore.edit { it[key] = value }
+    }
 }
\ No newline at end of file

From 9d18253e44574a4cf518523a339e4cada2f3f57c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 14 Dec 2024 22:47:00 -0500
Subject: [PATCH 325/458] ui: Cancel download from the low nvram warning dialog

---
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 7e1dc23ea..f16a0861a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -62,7 +62,9 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                 setMessage(R.string.profile_download_low_nvram_message)
                 setCancelable(true)
                 setPositiveButton(android.R.string.ok, null)
-                setNegativeButton(android.R.string.cancel, null)
+                setNegativeButton(android.R.string.cancel) { _, _ ->
+                    requireActivity().finish()
+                }
                 show()
             }
         }

From 7d1c7663bc992dd21a025cea6894b9062f95c525 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 15 Dec 2024 16:42:59 +0100
Subject: [PATCH 326/458] fix: format channel name (#117)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/117
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt  | 4 ++--
 .../main/java/im/angry/openeuicc/ui/NotificationsActivity.kt  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 36031dd12..aca2572e6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -27,7 +27,7 @@ import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
 
-class EuiccInfoActivity : BaseEuiccAccessActivity() {
+class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         private val YES_NO = Pair(R.string.yes, R.string.no)
     }
@@ -64,7 +64,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity() {
         val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
             getString(R.string.usb)
         } else {
-            getString(R.string.channel_name_format, logicalSlotId)
+            appContainer.customizableTextProvider.formatInternalChannelName(logicalSlotId)
         }
 
         title = getString(R.string.euicc_info_activity_title, channelTitle)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index c2a1a0fd6..21a2d4056 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -62,7 +62,7 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
             getString(R.string.usb)
         } else {
-            getString(R.string.channel_name_format, logicalSlotId)
+            appContainer.customizableTextProvider.formatInternalChannelName(logicalSlotId)
         }
 
         title = getString(R.string.profile_notifications_detailed_format, channelTitle)

From 456754db5d66d4fd0828d9c9a2492fc566e2c2d3 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 15 Dec 2024 16:46:06 +0100
Subject: [PATCH 327/458] fix: move language switcher component name in
 advanced category (#118)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/118
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt | 2 +-
 app-common/src/main/res/values-ja/strings.xml               | 4 ++--
 app-common/src/main/res/values-zh-rCN/strings.xml           | 4 ++--
 app-common/src/main/res/values/strings.xml                  | 4 ++--
 app-common/src/main/res/xml/pref_settings.xml               | 6 +++---
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index cb801afb8..ef4ef8bbc 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -45,7 +45,7 @@ open class SettingsFragment: PreferenceFragmentCompat() {
             setOnPreferenceClickListener(::onAppVersionClicked)
         }
 
-        findPreference<Preference>("pref_language")?.apply {
+        findPreference<Preference>("pref_advanced_language")?.apply {
             if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return@apply
             isVisible = true
             intent = Intent(Settings.ACTION_APP_LOCALE_SETTINGS).apply {
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 7d99cb7b7..dacfd6856 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -125,8 +125,8 @@
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
-    <string name="pref_language">言語</string>
-    <string name="pref_language_desc">アプリの言語を選択</string>
+    <string name="pref_advanced_language">言語</string>
+    <string name="pref_advanced_language_desc">アプリの言語を選択</string>
     <string name="pref_developer_unfiltered_profile_list">すべてのプロファイルを表示</string>
     <string name="pref_developer_unfiltered_profile_list_desc">プロダクション以外のプロファイルも表示する</string>
     <string name="profile_class">タイプ:</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 551435b4b..b97969d3e 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -126,8 +126,8 @@
     <string name="no">否</string>
     <string name="developer_options_steps">还有 %d 步成为开发者</string>
     <string name="developer_options_enabled">你现在是开发者了！</string>
-    <string name="pref_language">语言</string>
-    <string name="pref_language_desc">选择 App 语言</string>
+    <string name="pref_advanced_language">语言</string>
+    <string name="pref_advanced_language_desc">选择 App 语言</string>
     <string name="pref_developer">开发者选项</string>
     <string name="pref_developer_unfiltered_profile_list">显示未经过滤的配置文件列表</string>
     <string name="pref_developer_unfiltered_profile_list_desc">在配置文件列表中包括非生产环境的配置文件</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index e349c685b..bd3b3afb4 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -153,8 +153,8 @@
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">By default, this app prevents you from disabling the active profile on a removable eSIM inserted in the device, because doing so may <i>sometimes</i> render it inaccessible.\nCheck this box to <i>remove</i> this safeguard.</string>
     <string name="pref_advanced_verbose_logging">Verbose Logging</string>
     <string name="pref_advanced_verbose_logging_desc">Enable verbose logs, which may contain sensitive information. Only share your logs with someone you trust after turning this on.</string>
-    <string name="pref_language">Language</string>
-    <string name="pref_language_desc">Select app language</string>
+    <string name="pref_advanced_language">Language</string>
+    <string name="pref_advanced_language_desc">Select app language</string>
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_developer">Developer Options</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 1da1fd40a..bb5bd5050 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -40,9 +40,9 @@
         <Preference
             app:iconSpaceReserved="false"
             app:isPreferenceVisible="false"
-            app:key="pref_language"
-            app:summary="@string/pref_language_desc"
-            app:title="@string/pref_language" />
+            app:key="pref_advanced_language"
+            app:summary="@string/pref_advanced_language_desc"
+            app:title="@string/pref_advanced_language" />
 
         <Preference
             app:key="pref_advanced_logs"

From f395cee2e0fa0dc65de26241caf77f6bc8defc2e Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 15 Dec 2024 18:47:57 +0100
Subject: [PATCH 328/458] chore: cleanup unused resource from 343dfb43f8 (#119)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/119
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/res/layout/fragment_slot_select.xml  | 27 -------------------
 .../main/res/menu/fragment_slot_select.xml    |  9 -------
 app-common/src/main/res/values-ja/strings.xml |  2 --
 .../src/main/res/values-zh-rCN/strings.xml    |  2 --
 app-common/src/main/res/values/strings.xml    |  3 ---
 5 files changed, 43 deletions(-)
 delete mode 100644 app-common/src/main/res/layout/fragment_slot_select.xml
 delete mode 100644 app-common/src/main/res/menu/fragment_slot_select.xml

diff --git a/app-common/src/main/res/layout/fragment_slot_select.xml b/app-common/src/main/res/layout/fragment_slot_select.xml
deleted file mode 100644
index b818b808d..000000000
--- a/app-common/src/main/res/layout/fragment_slot_select.xml
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    android:background="?attr/colorSurface">
-
-    <com.google.android.material.appbar.MaterialToolbar
-        android:id="@+id/toolbar"
-        android:layout_width="0dp"
-        android:layout_height="wrap_content"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintLeft_toLeftOf="parent"
-        app:layout_constraintWidth_percent="1"
-        app:navigationIcon="?homeAsUpIndicator" />
-
-    <Spinner
-        android:id="@+id/spinner"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:layout_marginVertical="48dp"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"
-        app:layout_constraintBottom_toBottomOf="parent"
-        app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintEnd_toEndOf="parent"/>
-
-</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/fragment_slot_select.xml b/app-common/src/main/res/menu/fragment_slot_select.xml
deleted file mode 100644
index e129008b0..000000000
--- a/app-common/src/main/res/menu/fragment_slot_select.xml
+++ /dev/null
@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<menu xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto">
-    <item
-        android:id="@+id/ok"
-        android:icon="@drawable/ic_check_black"
-        android:title="@string/slot_select_select"
-        app:showAsAction="ifRoom"/>
-</menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index dacfd6856..1f1f38940 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -18,8 +18,6 @@
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
     <string name="toast_profile_name_too_long">ニックネームは 64 文字以内にしてください</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
-    <string name="slot_select">スロットを選択</string>
-    <string name="slot_select_select">選択</string>
     <string name="usb_permission">USB の権限を許可</string>
     <string name="usb_permission_needed">USB スマートカードリーダーにアクセスするには許可が必要です。</string>
     <string name="usb_failed">USB スマートカードリーダー経由で eSIM に接続できません。</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index b97969d3e..d9d6c771e 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -19,8 +19,6 @@
     <string name="toast_profile_enable_failed">无法切换到新的 eSIM 配置文件。</string>
     <string name="toast_profile_name_too_long">昵称不能超过 64 个字符</string>
     <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
-    <string name="slot_select">选择卡槽</string>
-    <string name="slot_select_select">选择</string>
     <string name="usb_permission">授予 USB 权限</string>
     <string name="usb_permission_needed">需要获得访问 USB 智能卡读卡器的权限。</string>
     <string name="usb_failed">无法通过 USB 智能卡读卡器连接到 eSIM。</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bd3b3afb4..196dbbe90 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -33,9 +33,6 @@
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>
 
-    <string name="slot_select">Select Slot</string>
-    <string name="slot_select_select">Select</string>
-
     <string name="usb_permission">Grant USB permission</string>
     <string name="usb_permission_needed">Permission is needed to access the USB smart card reader.</string>
     <string name="usb_failed">Cannot connect to eSIM via a USB smart card reader.</string>

From 905d0c897eaedc1a2dbca4e022f6961388a60326 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 13:19:23 -0500
Subject: [PATCH 329/458] ui: wizard: Save activity before showing nvram
 warning dialog

---
 .../openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index f16a0861a..3723aea3c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -57,13 +57,15 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         super.beforeNext()
 
         if (adapter.selected.freeSpace < LOW_NVRAM_THRESHOLD) {
+            val activity = requireActivity()
+
             AlertDialog.Builder(requireContext()).apply {
                 setTitle(R.string.profile_download_low_nvram_title)
                 setMessage(R.string.profile_download_low_nvram_message)
                 setCancelable(true)
                 setPositiveButton(android.R.string.ok, null)
                 setNegativeButton(android.R.string.cancel) { _, _ ->
-                    requireActivity().finish()
+                    activity.finish()
                 }
                 show()
             }

From 0fbda7dd78e5fe61237bbce1b39f704581b0e444 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 14 Dec 2024 21:49:09 +0800
Subject: [PATCH 330/458] feat: load lpa string from clipboard

---
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt    | 10 ++++++++++
 app-common/src/main/res/values/strings.xml             |  1 +
 2 files changed, 11 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index d32904899..16b975983 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.ui.wizard
 
 import android.app.AlertDialog
+import android.content.ClipboardManager
 import android.graphics.BitmapFactory
 import android.os.Bundle
 import android.view.LayoutInflater
@@ -68,6 +69,9 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         DownloadMethod(R.drawable.ic_gallery_black, R.string.download_wizard_method_gallery) {
             gallerySelectorLauncher.launch("image/*")
         },
+        DownloadMethod(R.drawable.ic_scan_black, R.string.download_wizard_method_clipboard) {
+            handleLoadFromClipboard()
+        },
         DownloadMethod(R.drawable.ic_edit, R.string.download_wizard_method_manual) {
             gotoNextFragment(DownloadWizardDetailsFragment())
         }
@@ -103,6 +107,12 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         return view
     }
 
+    private fun handleLoadFromClipboard() {
+        val clipboard = requireContext().getSystemService(ClipboardManager::class.java)
+        val text = clipboard.primaryClip?.getItemAt(0)?.text ?: return
+        processLpaString(text.toString())
+    }
+
     private fun processLpaString(s: String) {
         val components = s.split("$")
         if (components.size < 3 || components[0] != "LPA:1") {
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 196dbbe90..90d9c2998 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -72,6 +72,7 @@
     <string name="download_wizard_method_select">How would you like to download the eSIM profile?</string>
     <string name="download_wizard_method_qr_code">Scan a QR code with camera</string>
     <string name="download_wizard_method_gallery">Load a QR code from gallery</string>
+    <string name="download_wizard_method_clipboard">Load from Clipboard</string>
     <string name="download_wizard_method_manual">Enter manually</string>
     <string name="download_wizard_details">Input or confirm details for downloading your eSIM:</string>
     <string name="download_wizard_progress">Downloading your eSIM…</string>

From 24f04f54e4bb5016e730578d4fdc44cb4861b6d8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 14:37:30 -0500
Subject: [PATCH 331/458] Add icon for loading from clipboard

---
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt        | 2 +-
 app-common/src/main/res/drawable/ic_paste_go.xml           | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)
 create mode 100644 app-common/src/main/res/drawable/ic_paste_go.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 16b975983..7f5eaea5d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -69,7 +69,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         DownloadMethod(R.drawable.ic_gallery_black, R.string.download_wizard_method_gallery) {
             gallerySelectorLauncher.launch("image/*")
         },
-        DownloadMethod(R.drawable.ic_scan_black, R.string.download_wizard_method_clipboard) {
+        DownloadMethod(R.drawable.ic_paste_go, R.string.download_wizard_method_clipboard) {
             handleLoadFromClipboard()
         },
         DownloadMethod(R.drawable.ic_edit, R.string.download_wizard_method_manual) {
diff --git a/app-common/src/main/res/drawable/ic_paste_go.xml b/app-common/src/main/res/drawable/ic_paste_go.xml
new file mode 100644
index 000000000..7536fff38
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_paste_go.xml
@@ -0,0 +1,7 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="?attr/colorControlNormal" android:viewportHeight="24" android:viewportWidth="24" android:width="24dp">
+      
+    <path android:fillColor="@android:color/white" android:pathData="M5,5h2v3h10V5h2v6h2V5c0,-1.1 -0.9,-2 -2,-2h-4.18C14.4,1.84 13.3,1 12,1S9.6,1.84 9.18,3H5C3.9,3 3,3.9 3,5v14c0,1.1 0.9,2 2,2h5v-2H5V5zM12,3c0.55,0 1,0.45 1,1s-0.45,1 -1,1s-1,-0.45 -1,-1S11.45,3 12,3z"/>
+      
+    <path android:fillColor="@android:color/white" android:pathData="M18.01,13l-1.42,1.41l1.58,1.58l-6.17,0l0,2l6.17,0l-1.58,1.59l1.42,1.41l3.99,-4z"/>
+    
+</vector>

From 343040660335e800195d3e39d6ba52e64383d362 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 14:40:59 -0500
Subject: [PATCH 332/458] ui: wizard: Add toast for when clipboard is empty

---
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt | 13 ++++++++++++-
 app-common/src/main/res/values/strings.xml          |  1 +
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 7f5eaea5d..6203364ea 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -9,6 +9,7 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.ImageView
 import android.widget.TextView
+import android.widget.Toast
 import androidx.activity.result.contract.ActivityResultContracts
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
@@ -109,7 +110,17 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
     private fun handleLoadFromClipboard() {
         val clipboard = requireContext().getSystemService(ClipboardManager::class.java)
-        val text = clipboard.primaryClip?.getItemAt(0)?.text ?: return
+        val text = clipboard.primaryClip?.getItemAt(0)?.text
+
+        if (text == null) {
+            Toast.makeText(
+                requireContext(),
+                R.string.profile_download_no_lpa_string,
+                Toast.LENGTH_SHORT
+            ).show()
+            return
+        }
+
         processLpaString(text.toString())
     }
 
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 90d9c2998..1521c61e9 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -55,6 +55,7 @@
 
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
+    <string name="profile_download_no_lpa_string">No LPA string found in clipboard</string>
     <string name="profile_download_incorrect_lpa_string">Incorrect LPA String</string>
     <string name="profile_download_incorrect_lpa_string_message">The LPA string could not be parsed</string>
 

From 74e946cc8f4d738f327a98b987ad46c6acb94c92 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 14:42:12 -0500
Subject: [PATCH 333/458] i18n: Update message for LPA string parsing failure

---
 app-common/src/main/res/values/strings.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 1521c61e9..a0e8e50e3 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -57,7 +57,7 @@
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
     <string name="profile_download_no_lpa_string">No LPA string found in clipboard</string>
     <string name="profile_download_incorrect_lpa_string">Incorrect LPA String</string>
-    <string name="profile_download_incorrect_lpa_string_message">The LPA string could not be parsed</string>
+    <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as an LPA string for downloading eSIMs.</string>
 
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>

From 3b7bd8b31e6e6404257a098360c3617e23769c4c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 16:02:27 -0500
Subject: [PATCH 334/458] fix: Validate nickname and convert to proper UTF-8
 before passing to JNI

The JNI "modified" UTF-8 isn't what SGP.22 mandates. Let's encode
properly, validate the length, and pass the string as a C
null-terminated string directly over JNI.

This also introduces new exceptions that are exposed via UI as Toasts.
---
 .../core/LocalProfileAssistantWrapper.kt      |  3 +-
 .../service/EuiccChannelManagerService.kt     |  6 +--
 .../openeuicc/ui/ProfileRenameFragment.kt     | 45 +++++++++++++++----
 app-common/src/main/res/values/strings.xml    |  3 ++
 .../lpac_jni/LocalProfileAssistant.kt         | 11 ++++-
 .../java/net/typeblog/lpac_jni/LpacJni.kt     |  2 +-
 .../impl/LocalProfileAssistantImpl.kt         | 19 +++++++-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.c | 10 ++---
 8 files changed, 76 insertions(+), 23 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index aab9e635a..b715ca08f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -54,8 +54,9 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
 
     override fun euiccMemoryReset() = lpa.euiccMemoryReset()
 
-    override fun setNickname(iccid: String, nickname: String): Boolean =
+    override fun setNickname(iccid: String, nickname: String) {
         lpa.setNickname(iccid, nickname)
+    }
 
     override fun close() = lpa.close()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index c4d16df7f..a20c8db41 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -414,16 +414,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_profile_rename_failure),
             R.drawable.ic_task_rename
         ) {
-            val res = euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+            euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
                 channel.lpa.setNickname(
                     iccid,
                     name
                 )
             }
-
-            if (!res) {
-                throw RuntimeException("Profile not renamed")
-            }
         }
 
     fun launchProfileDeleteTask(
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 8582278ed..a3e4571e3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -14,6 +14,7 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.launch
+import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragmentMarker {
     companion object {
@@ -95,21 +96,49 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-            euiccChannelManagerService.launchProfileRenameTask(
+            val res = euiccChannelManagerService.launchProfileRenameTask(
                 slotId,
                 portId,
                 requireArguments().getString("iccid")!!,
                 name
             ).waitDone()
 
-            if (parentFragment is EuiccProfilesChangedListener) {
-                (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
-            }
+            when (res) {
+                is LocalProfileAssistant.ProfileNameTooLongException -> {
+                    Toast.makeText(
+                        requireContext(),
+                        R.string.profile_rename_too_long,
+                        Toast.LENGTH_LONG
+                    ).show()
+                }
 
-            try {
-                dismiss()
-            } catch (e: IllegalStateException) {
-                // Ignored
+                is LocalProfileAssistant.ProfileNameIsInvalidUTF8Exception -> {
+                    Toast.makeText(
+                        requireContext(),
+                        R.string.profile_rename_encoding_error,
+                        Toast.LENGTH_LONG
+                    ).show()
+                }
+
+                is Throwable -> {
+                    Toast.makeText(
+                        requireContext(),
+                        R.string.profile_rename_failure,
+                        Toast.LENGTH_LONG
+                    ).show()
+                }
+
+                else -> {
+                    if (parentFragment is EuiccProfilesChangedListener) {
+                        (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
+                    }
+
+                    try {
+                        dismiss()
+                    } catch (e: IllegalStateException) {
+                        // Ignored
+                    }
+                }
             }
         }
     }
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a0e8e50e3..39d2c430a 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -97,6 +97,9 @@
     <string name="logs_saved_message">Logs have been saved to the selected path. Would you like to share the log through another app?</string>
 
     <string name="profile_rename_new_name">New nickname</string>
+    <string name="profile_rename_encoding_error">Failed to encode nickname as UTF-8</string>
+    <string name="profile_rename_too_long">Nickname is too long</string>
+    <string name="profile_rename_failure">Unknown failure when renaming profile</string>
 
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>
     <string name="profile_delete_confirm_input">Type \'%s\' here to confirm deletion</string>
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 4ff65fad7..48ab1c54a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -12,6 +12,10 @@ interface LocalProfileAssistant {
         val lastApduException: Exception?,
     ) : Exception("Failed to download profile")
 
+    class ProfileRenameException() : Exception("Failed to rename profile")
+    class ProfileNameTooLongException() : Exception("Profile name too long")
+    class ProfileNameIsInvalidUTF8Exception() : Exception("Profile name is invalid UTF-8")
+
     val valid: Boolean
     val profiles: List<LocalProfileInfo>
     val notifications: List<LocalProfileNotification>
@@ -40,9 +44,14 @@ interface LocalProfileAssistant {
 
     fun euiccMemoryReset()
 
+    /**
+     * Nickname must be valid UTF-8 and shorter than 64 chars.
+     *
+     * May throw one of: ProfileRenameException, ProfileNameTooLongException, ProfileNameIsInvalidUTF8Exception
+     */
     fun setNickname(
         iccid: String, nickname: String
-    ): Boolean
+    )
 
     fun close()
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 8e3f53a99..d50c1c1cb 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -19,7 +19,7 @@ internal object LpacJni {
     external fun es10cEnableProfile(handle: Long, iccid: String, refresh: Boolean): Int
     external fun es10cDisableProfile(handle: Long, iccid: String, refresh: Boolean): Int
     external fun es10cDeleteProfile(handle: Long, iccid: String): Int
-    external fun es10cSetNickname(handle: Long, iccid: String, nick: String): Int
+    external fun es10cSetNickname(handle: Long, iccid: String, nickNullTerminated: ByteArray): Int
 
     // es10b
     external fun es10bListNotification(handle: Long): Long // A native pointer to a linked list. Handle with linked list-related methods below. May be 0 (null)
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index b617f2bea..0330d828e 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -239,8 +239,23 @@ class LocalProfileAssistantImpl(
         } == 0
 
     @Synchronized
-    override fun setNickname(iccid: String, nickname: String): Boolean =
-        LpacJni.es10cSetNickname(contextHandle, iccid, nickname) == 0
+    override fun setNickname(iccid: String, nickname: String) {
+        val encoded = try {
+            Charsets.UTF_8.encode(nickname).array()
+        } catch (e: CharacterCodingException) {
+            throw LocalProfileAssistant.ProfileNameIsInvalidUTF8Exception()
+        }
+
+        if (encoded.size >= 64) {
+            throw LocalProfileAssistant.ProfileNameTooLongException()
+        }
+
+        val encodedNullTerminated = encoded + byteArrayOf(0)
+
+        if (LpacJni.es10cSetNickname(contextHandle, iccid, encodedNullTerminated) != 0) {
+            throw LocalProfileAssistant.ProfileRenameException()
+        }
+    }
 
     override fun euiccMemoryReset() {
         LpacJni.es10cEuiccMemoryReset(contextHandle)
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 8f4752bc3..e4381072d 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -205,16 +205,16 @@ Java_net_typeblog_lpac_1jni_LpacJni_es10cDisableProfile(JNIEnv *env, jobject thi
 
 JNIEXPORT jint JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_es10cSetNickname(JNIEnv *env, jobject thiz, jlong handle,
-                                                     jstring iccid, jstring nick) {
+                                                     jstring iccid, jbyteArray nick) {
     struct euicc_ctx *ctx = (struct euicc_ctx *) handle;
     const char *_iccid = NULL;
-    const char *_nick = NULL;
+    jbyte *_nick = NULL;
     int ret;
 
     _iccid = (*env)->GetStringUTFChars(env, iccid, NULL);
-    _nick = (*env)->GetStringUTFChars(env, nick, NULL);
-    ret = es10c_set_nickname(ctx, _iccid, _nick);
-    (*env)->ReleaseStringUTFChars(env, nick, _nick);
+    _nick = (*env)->GetByteArrayElements(env, nick, NULL);
+    ret = es10c_set_nickname(ctx, _iccid, (const char *) _nick);
+    (*env)->ReleaseByteArrayElements(env, nick, _nick, JNI_ABORT);
     (*env)->ReleaseStringUTFChars(env, iccid, _iccid);
     return ret;
 }

From f135a0da6065b4a9d47c6aa39813c2f9c5f5c165 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 22:49:02 -0500
Subject: [PATCH 335/458] ui: Fixup rename error toasts

---
 .../openeuicc/ui/ProfileRenameFragment.kt     | 29 +++++++++----------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index a3e4571e3..915d82f62 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -82,6 +82,17 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         }
     }
 
+    private fun showErrorAndCancel(errorStrRes: Int) {
+        Toast.makeText(
+            requireContext(),
+            errorStrRes,
+            Toast.LENGTH_LONG
+        ).show()
+
+        renaming = false
+        progress.visibility = View.GONE
+    }
+
     private fun rename() {
         val name = profileRenameNewName.editText!!.text.toString().trim()
         if (name.length >= 64) {
@@ -105,27 +116,15 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
 
             when (res) {
                 is LocalProfileAssistant.ProfileNameTooLongException -> {
-                    Toast.makeText(
-                        requireContext(),
-                        R.string.profile_rename_too_long,
-                        Toast.LENGTH_LONG
-                    ).show()
+                    showErrorAndCancel(R.string.profile_rename_too_long)
                 }
 
                 is LocalProfileAssistant.ProfileNameIsInvalidUTF8Exception -> {
-                    Toast.makeText(
-                        requireContext(),
-                        R.string.profile_rename_encoding_error,
-                        Toast.LENGTH_LONG
-                    ).show()
+                    showErrorAndCancel(R.string.profile_rename_encoding_error)
                 }
 
                 is Throwable -> {
-                    Toast.makeText(
-                        requireContext(),
-                        R.string.profile_rename_failure,
-                        Toast.LENGTH_LONG
-                    ).show()
+                    showErrorAndCancel(R.string.profile_rename_failure)
                 }
 
                 else -> {

From 24076e8fb4dc4a14c7da0a064c4c97ba4444915b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 15 Dec 2024 22:51:36 -0500
Subject: [PATCH 336/458] ui:  Remove old toast for profile name length

We'll add back i18n later.
---
 .../java/im/angry/openeuicc/ui/ProfileRenameFragment.kt   | 8 +-------
 app-common/src/main/res/values-ja/strings.xml             | 1 -
 app-common/src/main/res/values-zh-rCN/strings.xml         | 1 -
 app-common/src/main/res/values/strings.xml                | 1 -
 4 files changed, 1 insertion(+), 10 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 915d82f62..e3f2d8df1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -94,12 +94,6 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
     }
 
     private fun rename() {
-        val name = profileRenameNewName.editText!!.text.toString().trim()
-        if (name.length >= 64) {
-            Toast.makeText(context, R.string.toast_profile_name_too_long, Toast.LENGTH_LONG).show()
-            return
-        }
-
         renaming = true
         progress.isIndeterminate = true
         progress.visibility = View.VISIBLE
@@ -111,7 +105,7 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
                 slotId,
                 portId,
                 requireArguments().getString("iccid")!!,
-                name
+                profileRenameNewName.editText!!.text.toString().trim()
             ).waitDone()
 
             when (res) {
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 1f1f38940..54d58906e 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -16,7 +16,6 @@
     <string name="enable_disable_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
     <string name="switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
-    <string name="toast_profile_name_too_long">ニックネームは 64 文字以内にしてください</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
     <string name="usb_permission">USB の権限を許可</string>
     <string name="usb_permission_needed">USB スマートカードリーダーにアクセスするには許可が必要です。</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index d9d6c771e..200931a59 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -17,7 +17,6 @@
     <string name="enable_disable_timeout">等待 eSIM 芯片切换配置文件时超时。这可能是您手机基带固件中的一个错误。请尝试切换飞行模式、重新启动应用程序或重新启动手机</string>
     <string name="switch_did_not_refresh">操作成功, 但是您手机的基带拒绝刷新。您可能需要切换飞行模式或重新启动，以便使用新的配置文件。</string>
     <string name="toast_profile_enable_failed">无法切换到新的 eSIM 配置文件。</string>
-    <string name="toast_profile_name_too_long">昵称不能超过 64 个字符</string>
     <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
     <string name="usb_permission">授予 USB 权限</string>
     <string name="usb_permission_needed">需要获得访问 USB 智能卡读卡器的权限。</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 39d2c430a..95ea261f0 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -28,7 +28,6 @@
     <string name="switch_did_not_refresh">The operation was successful, but your phone\'s modem refused to refresh. You might need to toggle airplane mode or reboot in order to use the new profile.</string>
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
-    <string name="toast_profile_name_too_long">Nickname cannot be longer than 64 characters</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>

From 087c760010a921f2ef0ab0db2eb198e5a5d317c1 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 17 Dec 2024 04:17:47 +0100
Subject: [PATCH 337/458] fix: password mask toggle in profile download wizard
 (#125)

![image](/attachments/540449a1-7f12-4194-881f-21d0787101b8)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/125
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/res/layout/fragment_download_details.xml       | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/res/layout/fragment_download_details.xml b/app-common/src/main/res/layout/fragment_download_details.xml
index 3f58844bf..be01ad29c 100644
--- a/app-common/src/main/res/layout/fragment_download_details.xml
+++ b/app-common/src/main/res/layout/fragment_download_details.xml
@@ -43,7 +43,8 @@
             android:id="@+id/profile_download_code"
             android:layout_width="0dp"
             android:layout_height="wrap_content"
-            android:hint="@string/profile_download_code">
+            android:hint="@string/profile_download_code"
+            app:passwordToggleEnabled="true">
 
             <com.google.android.material.textfield.TextInputEditText
                 android:maxLines="1"
@@ -57,7 +58,8 @@
             android:id="@+id/profile_download_confirmation_code"
             android:layout_width="0dp"
             android:layout_height="wrap_content"
-            android:hint="@string/profile_download_confirmation_code">
+            android:hint="@string/profile_download_confirmation_code"
+            app:passwordToggleEnabled="true">
 
             <com.google.android.material.textfield.TextInputEditText
                 android:maxLines="1"

From 9596b8632c141c17a82aeefa704268277f41fc8c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 18 Dec 2024 01:26:06 +0100
Subject: [PATCH 338/458] refactor: strong preference key constraint (#128)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/128
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 43 ++++++++++---------
 .../ui/UnprivilegedSettingsFragment.kt        |  2 +-
 2 files changed, 24 insertions(+), 21 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index ef4ef8bbc..fab680f2a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -29,7 +29,7 @@ open class SettingsFragment: PreferenceFragmentCompat() {
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         setPreferencesFromResource(R.xml.pref_settings, rootKey)
 
-        developerPref = findPreference("pref_developer")!!
+        developerPref = requirePreference("pref_developer")
 
         // Show / hide developer preference based on whether it is enabled
         lifecycleScope.launch {
@@ -38,14 +38,14 @@ open class SettingsFragment: PreferenceFragmentCompat() {
                 .collect()
         }
 
-        findPreference<Preference>("pref_info_app_version")?.apply {
+        requirePreference<Preference>("pref_info_app_version").apply {
             summary = requireContext().selfAppVersion
 
             // Enable developer options when this is clicked for 7 times
             setOnPreferenceClickListener(::onAppVersionClicked)
         }
 
-        findPreference<Preference>("pref_advanced_language")?.apply {
+        requirePreference<Preference>("pref_advanced_language").apply {
             if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return@apply
             isVisible = true
             intent = Intent(Settings.ACTION_APP_LOCALE_SETTINGS).apply {
@@ -53,32 +53,35 @@ open class SettingsFragment: PreferenceFragmentCompat() {
             }
         }
 
-        findPreference<Preference>("pref_advanced_logs")?.apply {
+        requirePreference<Preference>("pref_advanced_logs").apply {
             intent = Intent(requireContext(), LogsActivity::class.java)
         }
 
-        findPreference<CheckBoxPreference>("pref_notifications_download")
-            ?.bindBooleanFlow(preferenceRepository.notificationDownloadFlow)
+        requirePreference<CheckBoxPreference>("pref_notifications_download")
+            .bindBooleanFlow(preferenceRepository.notificationDownloadFlow)
 
-        findPreference<CheckBoxPreference>("pref_notifications_delete")
-            ?.bindBooleanFlow(preferenceRepository.notificationDeleteFlow)
+        requirePreference<CheckBoxPreference>("pref_notifications_delete")
+            .bindBooleanFlow(preferenceRepository.notificationDeleteFlow)
 
-        findPreference<CheckBoxPreference>("pref_notifications_switch")
-            ?.bindBooleanFlow(preferenceRepository.notificationSwitchFlow)
+        requirePreference<CheckBoxPreference>("pref_notifications_switch")
+            .bindBooleanFlow(preferenceRepository.notificationSwitchFlow)
 
-        findPreference<CheckBoxPreference>("pref_advanced_disable_safeguard_removable_esim")
-            ?.bindBooleanFlow(preferenceRepository.disableSafeguardFlow)
+        requirePreference<CheckBoxPreference>("pref_advanced_disable_safeguard_removable_esim")
+            .bindBooleanFlow(preferenceRepository.disableSafeguardFlow)
 
-        findPreference<CheckBoxPreference>("pref_advanced_verbose_logging")
-            ?.bindBooleanFlow(preferenceRepository.verboseLoggingFlow)
+        requirePreference<CheckBoxPreference>("pref_advanced_verbose_logging")
+            .bindBooleanFlow(preferenceRepository.verboseLoggingFlow)
 
-        findPreference<CheckBoxPreference>("pref_developer_unfiltered_profile_list")
-            ?.bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow)
+        requirePreference<CheckBoxPreference>("pref_developer_unfiltered_profile_list")
+            .bindBooleanFlow(preferenceRepository.unfilteredProfileListFlow)
 
-        findPreference<CheckBoxPreference>("pref_ignore_tls_certificate")
-            ?.bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
+        requirePreference<CheckBoxPreference>("pref_developer_ignore_tls_certificate")
+            .bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
     }
 
+    protected fun <T : Preference> requirePreference(key: CharSequence) =
+        findPreference<T>(key)!!
+
     override fun onStart() {
         super.onStart()
         setupRootViewInsets(requireView().requireViewById(R.id.recycler_view))
@@ -133,8 +136,8 @@ open class SettingsFragment: PreferenceFragmentCompat() {
     }
 
     protected fun mergePreferenceOverlay(overlayKey: String, targetKey: String) {
-        val overlayCat = findPreference<PreferenceCategory>(overlayKey)!!
-        val targetCat = findPreference<PreferenceCategory>(targetKey)!!
+        val overlayCat = requirePreference<PreferenceCategory>(overlayKey)
+        val targetCat = requirePreference<PreferenceCategory>(targetKey)
 
         val prefs = buildList {
             for (i in 0..<overlayCat.preferenceCount) {
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
index 1ef3e8908..23589a6ac 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedSettingsFragment.kt
@@ -31,7 +31,7 @@ class UnprivilegedSettingsFragment : SettingsFragment() {
         addPreferencesFromResource(R.xml.pref_unprivileged_settings)
         mergePreferenceOverlay("pref_info_overlay", "pref_info")
 
-        findPreference<Preference>("pref_info_ara_m")?.apply {
+        requirePreference<Preference>("pref_info_ara_m").apply {
             summary = firstSigner.encodeHex()
             setOnPreferenceClickListener {
                 requireContext().getSystemService(ClipboardManager::class.java)!!

From b88345057ce42618f1071f56a5f10d01ef527bd1 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 18 Dec 2024 01:28:24 +0100
Subject: [PATCH 339/458] feat: add header to saved log file (#123)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/123
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/im/angry/openeuicc/ui/LogsActivity.kt | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
index c6ba256b3..599e9d3f5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/LogsActivity.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.ui
 
 import android.icu.text.SimpleDateFormat
+import android.os.Build
 import android.os.Bundle
 import android.view.Menu
 import android.view.MenuItem
@@ -32,9 +33,19 @@ class LogsActivity : AppCompatActivity() {
                     SimpleDateFormat.getDateTimeInstance().format(Date())
                 )
             },
-            getLogText = { logStr }
+            getLogText = ::buildLogText
         )
 
+    private fun buildLogText() = buildString {
+        appendLine("Manufacturer: ${Build.MANUFACTURER}")
+        appendLine("Brand: ${Build.BRAND}")
+        appendLine("Model: ${Build.MODEL}")
+        appendLine("SDK Version: ${Build.VERSION.SDK_INT}")
+        appendLine("App Version: $selfAppVersion")
+        appendLine("-".repeat(10))
+        appendLine(logStr)
+    }
+
     override fun onCreate(savedInstanceState: Bundle?) {
         enableEdgeToEdge()
         super.onCreate(savedInstanceState)

From a87f15465315f06a19e092868ff68b419ff92eb9 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 17 Dec 2024 22:01:43 -0500
Subject: [PATCH 340/458] EuiccChannelManagerService: Stop throwing exceptions
 for USB channels when switching

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index a20c8db41..f76f1dc2d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -476,8 +476,9 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                     throw RuntimeException("Could not switch profile")
                 }
 
-                if (!refreshed) {
+                if (!refreshed && slotId != EuiccChannelManager.USB_CHANNEL_ID) {
                     // We may have switched the profile, but we could not refresh. Tell the caller about this
+                    // but only if we are talking to a modem and not a USB reader
                     throw SwitchingProfilesRefreshException()
                 }
 

From 895899d03ab49c108b608673ad6dfadf8fbd1cc5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 17 Dec 2024 22:34:06 -0500
Subject: [PATCH 341/458] i18n: Optimize strings and update translations

---
 app-common/src/main/res/values-ja/strings.xml  | 18 ++++++++++++++----
 .../src/main/res/values-zh-rCN/strings.xml     | 18 ++++++++++++++----
 app-common/src/main/res/values/strings.xml     | 12 ++++++------
 3 files changed, 34 insertions(+), 14 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 54d58906e..25211b01f 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -16,7 +16,9 @@
     <string name="enable_disable_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
     <string name="switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
+    <string name="toast_profile_delete_confirm_text_mismatched">入力した確認用テキストは一致していません</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
+    <string name="toast_eid_copied">EID をクリップボードにコピーしました</string>
     <string name="usb_permission">USB の権限を許可</string>
     <string name="usb_permission_needed">USB スマートカードリーダーにアクセスするには許可が必要です。</string>
     <string name="usb_failed">USB スマートカードリーダー経由で eSIM に接続できません。</string>
@@ -36,6 +38,9 @@
     <string name="profile_download_imei">IMEI (オプション)</string>
     <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
     <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
+    <string name="profile_download_no_lpa_string">クリップボードに LPA コードが見つかりません</string>
+    <string name="profile_download_incorrect_lpa_string">LPA コードを解析できません</string>
+    <string name="profile_download_incorrect_lpa_string_message">クリップボードまたは QR コードの内容を LPA コードとして解析できません</string>
     <string name="download_wizard">ダウンロードウィザード</string>
     <string name="download_wizard_back">戻る</string>
     <string name="download_wizard_next">次へ</string>
@@ -49,6 +54,7 @@
     <string name="download_wizard_method_select">eSIM プロファイルをどの方法でダウンロードしますか？</string>
     <string name="download_wizard_method_qr_code">カメラで QR コードをスキャン</string>
     <string name="download_wizard_method_gallery">ギャラリーから QR コードをスキャン</string>
+    <string name="download_wizard_method_clipboard">クリップボードから読み込む</string>
     <string name="download_wizard_method_manual">手動で入力</string>
     <string name="download_wizard_details">eSIM をダウンロードするための詳細情報を入力または確認:</string>
     <string name="download_wizard_progress">eSIM をダウンロード中です…</string>
@@ -68,7 +74,11 @@
     <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
     <string name="download_wizard_diagnostics_save">保存</string>
     <string name="download_wizard_diagnostics_file_template">%s のエラー診断</string>
+    <string name="logs_saved_message">ログは指定されたパスに保存しました。他のアプリにシェアしますか？</string>
     <string name="profile_rename_new_name">新しいニックネーム</string>
+    <string name="profile_rename_encoding_error">ニックネームを UTF-8 にエンコードできません</string>
+    <string name="profile_rename_too_long">ニックネームは 64 文字以内にしてください</string>
+    <string name="profile_rename_failure">ニックネームの変更で予期せぬエラーが発生しました</string>
     <string name="profile_delete_confirm">%s のプロファイルを削除してもよろしいですか？この操作は元に戻せません。</string>
     <string name="profile_delete_confirm_input">削除を確認するには「%s」を入力してください</string>
     <string name="profile_notifications">通知</string>
@@ -90,10 +100,10 @@
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
     <string name="euicc_info_pp_version">Protected Profileのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
-    <string name="euicc_info_gsma_prod">GSMA プロダクション証明書</string>
-    <string name="euicc_info_gsma_test">GSMA テスト証明書</string>
-    <string name="supported">対応</string>
-    <string name="unsupported">非対応</string>
+    <string name="euicc_info_ci_type">証明書の発行者 (CI)</string>
+    <string name="euicc_info_ci_gsma_live">GSMA プロダクション CI</string>
+    <string name="euicc_info_ci_gsma_test">GSMA テスト CI</string>
+    <string name="euicc_info_ci_unknown">未知の eSIM CI</string>
     <string name="yes">はい</string>
     <string name="no">いいえ</string>
     <string name="logs_save">保存</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 200931a59..208566683 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -17,7 +17,9 @@
     <string name="enable_disable_timeout">等待 eSIM 芯片切换配置文件时超时。这可能是您手机基带固件中的一个错误。请尝试切换飞行模式、重新启动应用程序或重新启动手机</string>
     <string name="switch_did_not_refresh">操作成功, 但是您手机的基带拒绝刷新。您可能需要切换飞行模式或重新启动，以便使用新的配置文件。</string>
     <string name="toast_profile_enable_failed">无法切换到新的 eSIM 配置文件。</string>
+    <string name="toast_profile_delete_confirm_text_mismatched">输入的确认文本不匹配</string>
     <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
+    <string name="toast_eid_copied">已复制 EID 到剪贴板</string>
     <string name="usb_permission">授予 USB 权限</string>
     <string name="usb_permission_needed">需要获得访问 USB 智能卡读卡器的权限。</string>
     <string name="usb_failed">无法通过 USB 智能卡读卡器连接到 eSIM。</string>
@@ -37,7 +39,11 @@
     <string name="profile_download_imei">IMEI (可选)</string>
     <string name="profile_download_low_nvram_title">本次下载可能会失败</string>
     <string name="profile_download_low_nvram_message">当前芯片的剩余空间不足，可能导致配置下载失败。\n是否继续下载？</string>
+    <string name="logs_saved_message">日志已保存到指定路径。需要通过其他 App 分享吗？</string>
     <string name="profile_rename_new_name">新昵称</string>
+    <string name="profile_rename_encoding_error">无法将昵称编码为 UTF-8</string>
+    <string name="profile_rename_too_long">昵称长于 64 字符</string>
+    <string name="profile_rename_failure">重命名配置文件时发生了未知错误</string>
     <string name="profile_delete_confirm">您确定要删除 %s 吗？此操作是不可逆的。</string>
     <string name="profile_delete_confirm_input">请输入\'%s\'以确认删除</string>
     <string name="profile_notifications">通知列表</string>
@@ -74,6 +80,9 @@
     <string name="profile_class_testing">测试</string>
     <string name="profile_class_provisioning">准备中</string>
     <string name="profile_class_operational">可用</string>
+    <string name="profile_download_no_lpa_string">未在剪贴板上发现 LPA 码</string>
+    <string name="profile_download_incorrect_lpa_string">LPA 码解析错误</string>
+    <string name="profile_download_incorrect_lpa_string_message">无法将二维码或剪贴板内容解析为 LPA 码</string>
     <string name="download_wizard">下载向导</string>
     <string name="download_wizard_back">返回</string>
     <string name="download_wizard_next">下一步</string>
@@ -87,6 +96,7 @@
     <string name="download_wizard_method_select">您想要如何下载 eSIM 配置文件?</string>
     <string name="download_wizard_method_qr_code">用相机扫描二维码</string>
     <string name="download_wizard_method_gallery">从图库选择二维码</string>
+    <string name="download_wizard_method_clipboard">从剪贴板读取</string>
     <string name="download_wizard_method_manual">手动输入</string>
     <string name="download_wizard_details">请输入或确认下载 eSIM 的详细信息:</string>
     <string name="download_wizard_progress">正在下载您的 eSIM...</string>
@@ -115,10 +125,10 @@
     <string name="euicc_info_sas_accreditation_number">SAS 认证号码</string>
     <string name="euicc_info_pp_version">Protected Profile 版本</string>
     <string name="euicc_info_free_nvram">NVRAM 剩余空间 (eSIM 存储容量)</string>
-    <string name="euicc_info_gsma_prod">GSMA 生产环境证书</string>
-    <string name="euicc_info_gsma_test">GSMA 测试环境证书</string>
-    <string name="supported">兼容</string>
-    <string name="unsupported">不兼容</string>
+    <string name="euicc_info_ci_type">证书签发者 (CI)</string>
+    <string name="euicc_info_ci_gsma_live">GSMA 生产环境 CI</string>
+    <string name="euicc_info_ci_gsma_test">GSMA 测试 CI</string>
+    <string name="euicc_info_ci_unknown">未知 eSIM CI</string>
     <string name="yes">是</string>
     <string name="no">否</string>
     <string name="developer_options_steps">还有 %d 步成为开发者</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 95ea261f0..7b0ff6998 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -54,9 +54,9 @@
 
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
-    <string name="profile_download_no_lpa_string">No LPA string found in clipboard</string>
-    <string name="profile_download_incorrect_lpa_string">Incorrect LPA String</string>
-    <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as an LPA string for downloading eSIMs.</string>
+    <string name="profile_download_no_lpa_string">No LPA code found in clipboard</string>
+    <string name="profile_download_incorrect_lpa_string">Unable to parse</string>
+    <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as a LPA code.</string>
 
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>
@@ -97,7 +97,7 @@
 
     <string name="profile_rename_new_name">New nickname</string>
     <string name="profile_rename_encoding_error">Failed to encode nickname as UTF-8</string>
-    <string name="profile_rename_too_long">Nickname is too long</string>
+    <string name="profile_rename_too_long">Nickname is longer than 64 characters</string>
     <string name="profile_rename_failure">Unknown failure when renaming profile</string>
 
     <string name="profile_delete_confirm">Are you sure you want to delete the profile %s? This operation is irreversible.</string>
@@ -126,10 +126,10 @@
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
     <string name="euicc_info_pp_version">Protected Profile Version</string>
     <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
-    <string name="euicc_info_ci_type">Certificate Issuer</string>
+    <string name="euicc_info_ci_type">Certificate Issuer (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA Live CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA Test CI</string>
-    <string name="euicc_info_ci_unknown">Unknown eSIM CA</string>
+    <string name="euicc_info_ci_unknown">Unknown eSIM CI</string>
 
     <string name="yes">Yes</string>
     <string name="no">No</string>

From 75d3894462f0dc657ba47ffe20fe87b1912a3bc6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 18:02:24 -0500
Subject: [PATCH 342/458] ui: wizard: Save input state on pause

Fixes #131 and supersedes #132.
---
 .../openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index eb36710a1..5fa800220 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -22,7 +22,7 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
     private lateinit var confirmationCode: TextInputLayout
     private lateinit var imei: TextInputLayout
 
-    override fun beforeNext() {
+    private fun saveState() {
         state.smdp = smdp.editText!!.text.toString().trim()
         // Treat empty inputs as null -- this is important for the download step
         state.matchingId = matchingId.editText!!.text.toString().trim().ifBlank { null }
@@ -30,6 +30,8 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         state.imei = imei.editText!!.text.toString().ifBlank { null }
     }
 
+    override fun beforeNext() = saveState()
+
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
         DownloadWizardProgressFragment()
 
@@ -61,6 +63,11 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         updateInputCompleteness()
     }
 
+    override fun onPause() {
+        super.onPause()
+        saveState()
+    }
+
     private fun updateInputCompleteness() {
         inputComplete = Patterns.DOMAIN_NAME.matcher(smdp.editText!!.text).matches()
         refreshButtons()

From de3ae19a10cd5dab66b7a297e2f3c411b96a6471 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 18:16:33 -0500
Subject: [PATCH 343/458] ui: wizard: Resize activity root view with IME

...and hide the IME whenever we switch between the fragments.
---
 .../openeuicc/ui/wizard/DownloadWizardActivity.kt   | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 6d810cf57..66b31bcbd 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -2,6 +2,7 @@ package im.angry.openeuicc.ui.wizard
 
 import android.os.Bundle
 import android.view.View
+import android.view.inputmethod.InputMethodManager
 import android.widget.Button
 import android.widget.ProgressBar
 import androidx.activity.OnBackPressedCallback
@@ -84,6 +85,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             val bars = insets.getInsets(
                 WindowInsetsCompat.Type.systemBars()
                         or WindowInsetsCompat.Type.displayCutout()
+                        or WindowInsetsCompat.Type.ime()
             )
             v.updatePadding(bars.left, 0, bars.right, bars.bottom)
             val newParams = navigation.layoutParams
@@ -132,6 +134,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     }
 
     private fun onPrevPressed() {
+        hideIme()
+
         if (currentFragment?.hasPrev == true) {
             val prevFrag = currentFragment?.createPrevFragment()
             if (prevFrag == null) {
@@ -143,6 +147,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     }
 
     private fun onNextPressed() {
+        hideIme()
+
         if (currentFragment?.hasNext == true) {
             currentFragment?.beforeNext()
             val nextFrag = currentFragment?.createNextFragment()
@@ -192,6 +198,13 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         }
     }
 
+    private fun hideIme() {
+        currentFocus?.let {
+            val imm = getSystemService(InputMethodManager::class.java)
+            imm.hideSoftInputFromWindow(it.windowToken, 0)
+        }
+    }
+
     abstract class DownloadWizardStepFragment : Fragment(), OpenEuiccContextMarker {
         protected val state: DownloadWizardState
             get() = (requireActivity() as DownloadWizardActivity).state

From 960f8855adf30a6e38c2eb766393ec78d250b6a9 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 19 Dec 2024 00:18:59 +0100
Subject: [PATCH 344/458] refactor: simplify profile operation (#129)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/129
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../DownloadWizardSlotSelectFragment.kt       |  2 +-
 .../java/im/angry/openeuicc/util/LPAUtils.kt  | 11 +++++-----
 .../openeuicc/service/OpenEuiccService.kt     | 21 +++++++------------
 3 files changed, 14 insertions(+), 20 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 3723aea3c..5510fb05c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -111,7 +111,7 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
                     } catch (e: Exception) {
                         ""
                     },
-                    channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }?.displayName,
+                    channel.lpa.profiles.enabled?.displayName,
                     channel.intrinsicChannelName,
                 )
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
index 0fe44c105..9f95412e6 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAUtils.kt
@@ -16,9 +16,10 @@ val LocalProfileInfo.isEnabled: Boolean
     get() = state == LocalProfileInfo.State.Enabled
 
 val List<LocalProfileInfo>.operational: List<LocalProfileInfo>
-    get() = filter {
-        it.profileClass == LocalProfileInfo.Clazz.Operational
-    }
+    get() = filter { it.profileClass == LocalProfileInfo.Clazz.Operational }
+
+val List<LocalProfileInfo>.enabled: LocalProfileInfo?
+    get() = find { it.isEnabled }
 
 val List<EuiccChannel>.hasMultipleChips: Boolean
     get() = distinctBy { it.slotId }.size > 1
@@ -39,7 +40,7 @@ fun LocalProfileAssistant.switchProfile(
  * See EuiccManager.waitForReconnect()
  */
 fun LocalProfileAssistant.disableActiveProfile(refresh: Boolean): Boolean =
-    profiles.find { it.isEnabled }?.let {
+    profiles.enabled?.let {
         Log.i(TAG, "Disabling active profile ${it.iccid}")
         disableProfile(it.iccid, refresh)
     } ?: true
@@ -52,7 +53,7 @@ fun LocalProfileAssistant.disableActiveProfile(refresh: Boolean): Boolean =
  * disable.
  */
 fun LocalProfileAssistant.disableActiveProfileKeepIccId(refresh: Boolean): String? =
-    profiles.find { it.isEnabled }?.let {
+    profiles.enabled?.let {
         Log.i(TAG, "Disabling active profile ${it.iccid}")
         if (disableProfile(it.iccid, refresh)) {
             it.iccid
diff --git a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
index 3c522c583..02b3baf3d 100644
--- a/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
+++ b/app/src/main/java/im/angry/openeuicc/service/OpenEuiccService.kt
@@ -186,13 +186,10 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
             )
         }
 
-        try {
-            return@withEuiccChannelManager euiccChannelManager.withEuiccChannel(
-                slotId,
-                port
-            ) { channel ->
+        return@withEuiccChannelManager try {
+            euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
                 val filteredProfiles =
-                    if (runBlocking { preferenceRepository.unfilteredProfileListFlow.first() })
+                    if (preferenceRepository.unfilteredProfileListFlow.first())
                         channel.lpa.profiles
                     else
                         channel.lpa.profiles.operational
@@ -224,7 +221,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 )
             }
         } catch (e: EuiccChannelManager.EuiccChannelNotFoundException) {
-            return@withEuiccChannelManager GetEuiccProfileInfoListResult(
+            GetEuiccProfileInfoListResult(
                 RESULT_FIRST_USER,
                 arrayOf(),
                 true
@@ -246,11 +243,7 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
         // Check that the profile has been disabled on all slots
         val enabledAnywhere = ports.any { port ->
             euiccChannelManager.withEuiccChannel(slotId, port) { channel ->
-                val profile = channel.lpa.profiles.find {
-                    it.iccid == iccid
-                } ?: return@withEuiccChannel false
-
-                profile.state == LocalProfileInfo.State.Enabled
+                channel.lpa.profiles.enabled?.iccid == iccid
             }
         }
 
@@ -354,8 +347,8 @@ class OpenEuiccService : EuiccService(), OpenEuiccContextMarker {
                 // iccid == null means disabling
                 val foundIccid =
                     euiccChannelManager.withEuiccChannel(foundSlotId, foundPortId) { channel ->
-                        channel.lpa.profiles.find { it.state == LocalProfileInfo.State.Enabled }
-                    }?.iccid ?: return@withEuiccChannelManager RESULT_FIRST_USER
+                        channel.lpa.profiles.enabled?.iccid
+                    } ?: return@withEuiccChannelManager RESULT_FIRST_USER
                 Pair(foundIccid, false)
             } else {
                 Pair(iccid, true)

From 43f247a71bec450fa75856cfdc3ee4d38968e354 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 19 Dec 2024 00:19:34 +0100
Subject: [PATCH 345/458] fix: share file name display (#122)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/122
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/util/UiUtils.kt | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index c8e481ccb..a73d7fe05 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.util
 
+import android.content.ClipData
 import android.content.Context
 import android.content.Intent
 import android.content.res.Resources
@@ -81,6 +82,8 @@ fun <T : ActivityResultCaller> T.setupLogSaving(
     getLogFileName: () -> String,
     getLogText: () -> String
 ): () -> Unit {
+    var lastFileName = "untitled"
+
     val launchSaveIntent =
         registerForActivityResult(ActivityResultContracts.CreateDocument("text/plain")) { uri ->
             if (uri == null) return@registerForActivityResult
@@ -101,10 +104,12 @@ fun <T : ActivityResultCaller> T.setupLogSaving(
                 setMessage(R.string.logs_saved_message)
                 setNegativeButton(R.string.no) { _, _ -> }
                 setPositiveButton(R.string.yes) { _, _ ->
-                    val intent = Intent().apply {
-                        action = Intent.ACTION_SEND
+                    val intent = Intent(Intent.ACTION_SEND).apply {
                         type = "text/plain"
+                        clipData = ClipData.newUri(context.contentResolver, lastFileName, uri)
+                        putExtra(Intent.EXTRA_TITLE, lastFileName)
                         putExtra(Intent.EXTRA_STREAM, uri)
+                        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
                     }
 
                     context.startActivity(Intent.createChooser(intent, null))
@@ -113,6 +118,7 @@ fun <T : ActivityResultCaller> T.setupLogSaving(
         }
 
     return {
-        launchSaveIntent.launch(getLogFileName())
+        lastFileName = getLogFileName()
+        launchSaveIntent.launch(lastFileName)
     }
 }
\ No newline at end of file

From 66bee041a01baae4205c33cdcb75dcf7905e7bd7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 20:04:55 -0500
Subject: [PATCH 346/458] ui: wizard: IMEI input type should be numberPassword

---
 app-common/src/main/res/layout/fragment_download_details.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/res/layout/fragment_download_details.xml b/app-common/src/main/res/layout/fragment_download_details.xml
index be01ad29c..1a250756a 100644
--- a/app-common/src/main/res/layout/fragment_download_details.xml
+++ b/app-common/src/main/res/layout/fragment_download_details.xml
@@ -82,7 +82,7 @@
                 android:maxLines="1"
                 android:layout_width="match_parent"
                 android:layout_height="match_parent"
-                android:inputType="textPassword" />
+                android:inputType="numberPassword" />
 
         </com.google.android.material.textfield.TextInputLayout>
 

From 6e3176668a2e6088826d528a54e2b84f83a9789c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 20:44:08 -0500
Subject: [PATCH 347/458] core: Reconnect to USB readers after switching
 profiles as well

Apparently some reader + card combination results in the need to
re-establish the ISD-R even though this is not a modem.

It doesn't hurt to run waitForReconnect() anyway :)
---
 .../core/DefaultEuiccChannelManager.kt        | 28 +++++++++++++------
 .../service/EuiccChannelManagerService.kt     |  2 +-
 .../openeuicc/ui/EuiccManagementFragment.kt   |  6 +---
 3 files changed, 21 insertions(+), 15 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 07db80b05..293042c03 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -184,20 +184,30 @@ open class DefaultEuiccChannelManager(
     }
 
     override suspend fun waitForReconnect(physicalSlotId: Int, portId: Int, timeoutMillis: Long) {
-        if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) return
-
-        // If there is already a valid channel, we close it proactively
-        // Sometimes the current channel can linger on for a bit even after it should have become invalid
-        channelCache.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
-            if (valid) close()
+        if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+            usbChannel?.close()
+            usbChannel = null
+        } else {
+            // If there is already a valid channel, we close it proactively
+            // Sometimes the current channel can linger on for a bit even after it should have become invalid
+            channelCache.find { it.slotId == physicalSlotId && it.portId == portId }?.apply {
+                if (valid) close()
+            }
         }
 
         withTimeout(timeoutMillis) {
             while (true) {
                 try {
-                    // tryOpenEuiccChannel() will automatically dispose of invalid channels
-                    // and recreate when needed
-                    val channel = findEuiccChannelByPort(physicalSlotId, portId)!!
+                    val channel = if (physicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
+                        // tryOpenUsbEuiccChannel() will always try to reopen the channel, even if
+                        // a USB channel already exists
+                        tryOpenUsbEuiccChannel()
+                        usbChannel!!
+                    } else {
+                        // tryOpenEuiccChannel() will automatically dispose of invalid channels
+                        // and recreate when needed
+                        findEuiccChannelByPort(physicalSlotId, portId)!!
+                    }
                     check(channel.valid) { "Invalid channel" }
                     break
                 } catch (e: Exception) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index f76f1dc2d..da1062a4c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -448,7 +448,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         portId: Int,
         iccid: String,
         enable: Boolean, // Enable or disable the profile indicated in iccid
-        reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect, useful for USB readers
+        reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect
     ): ForegroundTaskSubscriberFlow =
         launchForegroundTask(
             getString(R.string.task_profile_switch),
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index f806ae0ec..842f4ec7d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -228,11 +228,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 portId,
                 iccid,
                 enable,
-                reconnectTimeoutMillis = if (isUsb) {
-                    0
-                } else {
-                    30 * 1000
-                }
+                reconnectTimeoutMillis = 30 * 1000
             ).waitDone()
 
             when (err) {

From c0a691764515c8a7f1e94d32f7e251eec5ffdae3 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 20:57:37 -0500
Subject: [PATCH 348/458] Remove unused isForegroundTaskRunning

idk what this was used for
---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt   | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index da1062a4c..760f1af86 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -362,9 +362,6 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         )
     }
 
-    val isForegroundTaskRunning: Boolean
-        get() = foregroundTaskState.value != ForegroundTaskState.Idle
-
     suspend fun waitForForegroundTask() {
         foregroundTaskState.takeWhile { it != ForegroundTaskState.Idle }
             .collect()

From 0f8749ee04de7ec65180aa88801a48eb33317705 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 21:11:15 -0500
Subject: [PATCH 349/458] ui: wizard: Verify the EuiccChannel is still valid
 every time next is pressed

---
 .../ui/wizard/DownloadWizardActivity.kt       | 44 ++++++++++++++++---
 app-common/src/main/res/values/strings.xml    |  1 +
 2 files changed, 38 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 66b31bcbd..d2310b330 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -5,15 +5,21 @@ import android.view.View
 import android.view.inputmethod.InputMethodManager
 import android.widget.Button
 import android.widget.ProgressBar
+import android.widget.Toast
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.enableEdgeToEdge
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
 import androidx.fragment.app.Fragment
+import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
@@ -149,13 +155,37 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     private fun onNextPressed() {
         hideIme()
 
-        if (currentFragment?.hasNext == true) {
-            currentFragment?.beforeNext()
-            val nextFrag = currentFragment?.createNextFragment()
-            if (nextFrag == null) {
-                finish()
-            } else {
-                showFragment(nextFrag, R.anim.slide_in_right, R.anim.slide_out_left)
+        progressBar.visibility = View.VISIBLE
+        progressBar.isIndeterminate = true
+
+        lifecycleScope.launch(Dispatchers.Main) {
+            if (state.selectedLogicalSlot >= 0) {
+                try {
+                    // This is run on IO by default
+                    euiccChannelManager.withEuiccChannel(state.selectedLogicalSlot) { channel ->
+                        // Be _very_ sure that the channel we got is valid
+                        if (!channel.valid) throw EuiccChannelManager.EuiccChannelNotFoundException()
+                    }
+                } catch (e: EuiccChannelManager.EuiccChannelNotFoundException) {
+                    Toast.makeText(
+                        this@DownloadWizardActivity,
+                        R.string.download_wizard_slot_removed,
+                        Toast.LENGTH_LONG
+                    ).show()
+                    finish()
+                }
+            }
+
+            progressBar.visibility = View.GONE
+
+            if (currentFragment?.hasNext == true) {
+                currentFragment?.beforeNext()
+                val nextFrag = currentFragment?.createNextFragment()
+                if (nextFrag == null) {
+                    finish()
+                } else {
+                    showFragment(nextFrag, R.anim.slide_in_right, R.anim.slide_out_left)
+                }
             }
         }
     }
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 7b0ff6998..6c9fc3476 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -61,6 +61,7 @@
     <string name="download_wizard">Download Wizard</string>
     <string name="download_wizard_back">Back</string>
     <string name="download_wizard_next">Next</string>
+    <string name="download_wizard_slot_removed">Selected SIM has been removed</string>
     <string name="download_wizard_slot_select">Select or confirm the eSIM you would like to download to:</string>
     <string name="download_wizard_slot_type">Type:</string>
     <string name="download_wizard_slot_type_removable">Removable</string>

From 653a7b32ee8cc6d5c2294f69df49f137dc941644 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Wed, 18 Dec 2024 21:13:08 -0500
Subject: [PATCH 350/458] ui: wizard: Prevent clicking next multiple times

---
 .../java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index d2310b330..e342dee6f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -155,6 +155,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     private fun onNextPressed() {
         hideIme()
 
+        nextButton.isEnabled = false
         progressBar.visibility = View.VISIBLE
         progressBar.isIndeterminate = true
 
@@ -177,6 +178,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             }
 
             progressBar.visibility = View.GONE
+            nextButton.isEnabled = true
 
             if (currentFragment?.hasNext == true) {
                 currentFragment?.beforeNext()

From e7ef370e461a0f0511b95b868902a1df514a64f2 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Fri, 20 Dec 2024 22:56:31 +0100
Subject: [PATCH 351/458] feat: sgp.22 version in euicc info activity (#130)

Co-authored-by: Peter Cai <peter@typeblog.net>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/130
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt     | 1 +
 app-common/src/main/res/values/strings.xml                       | 1 +
 libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt  | 1 +
 libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt     | 1 +
 .../java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt | 1 +
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c                   | 1 +
 6 files changed, 6 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index aca2572e6..df206c894 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -114,6 +114,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             )
         )
         channel.lpa.euiccInfo2.let { info ->
+            add(Item(R.string.euicc_info_sgp22_version, info?.sgp22Version))
             add(Item(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
             add(Item(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion))
             add(Item(R.string.euicc_info_pp_version, info?.ppVersion))
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 6c9fc3476..6da59901c 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -122,6 +122,7 @@
     <string name="euicc_info_access_mode">Access Mode</string>
     <string name="euicc_info_removable">Removable</string>
     <string name="euicc_info_eid" translatable="false">EID</string>
+    <string name="euicc_info_sgp22_version">SGP.22 Version</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
index e69c7ff3a..6c7305199 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
@@ -2,6 +2,7 @@ package net.typeblog.lpac_jni
 
 /* Corresponds to EuiccInfo2 in SGP.22 */
 data class EuiccInfo2(
+    val sgp22Version: String,
     val profileVersion: String,
     val euiccFirmwareVersion: String,
     val globalPlatformVersion: String,
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index d50c1c1cb..370fcabc4 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -62,6 +62,7 @@ internal object LpacJni {
     external fun notificationsFree(head: Long)
     // EuiccInfo2
     external fun euiccInfo2Free(info: Long)
+    external fun euiccInfo2GetSGP22Version(info: Long): String
     external fun euiccInfo2GetProfileVersion(info: Long): String
     external fun euiccInfo2GetEuiccFirmwareVersion(info: Long): String
     external fun euiccInfo2GetGlobalPlatformVersion(info: Long): String
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 0330d828e..7310acd73 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -171,6 +171,7 @@ class LocalProfileAssistantImpl(
             }
 
             val ret = EuiccInfo2(
+                LpacJni.euiccInfo2GetSGP22Version(cInfo),
                 LpacJni.euiccInfo2GetProfileVersion(cInfo),
                 LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo),
                 LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo),
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index e4381072d..38d4f3a34 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -266,6 +266,7 @@ void lpac_jni_euiccinfo2_free(struct es10c_ex_euiccinfo2 *info) {
 
 LPAC_JNI_STRUCT_GETTER_NULL_TERM_LIST_NEXT(char*, stringArr)
 LPAC_JNI_STRUCT_FREE(struct es10c_ex_euiccinfo2, euiccInfo2, lpac_jni_euiccinfo2_free)
+LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, svn, SGP22Version)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, profileVersion, ProfileVersion)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, euiccFirmwareVer, EuiccFirmwareVersion)
 LPAC_JNI_STRUCT_GETTER_STRING(struct es10c_ex_euiccinfo2, euiccInfo2, globalplatformVersion, GlobalPlatformVersion)

From 31d595a6b19f54d6bb70a04f561d41f8d80f77f6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 20 Dec 2024 19:03:28 -0500
Subject: [PATCH 352/458] ui: Don't reset profile name while resuming the
 rename fragment

---
 .../java/im/angry/openeuicc/ui/ProfileRenameFragment.kt     | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index e3f2d8df1..25c5273e4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -54,6 +54,7 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
 
     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
         super.onViewCreated(view, savedInstanceState)
+        profileRenameNewName.editText!!.setText(requireArguments().getString("currentName"))
         toolbar.apply {
             setTitle(R.string.rename)
             setNavigationOnClickListener {
@@ -66,11 +67,6 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         }
     }
 
-    override fun onStart() {
-        super.onStart()
-        profileRenameNewName.editText!!.setText(requireArguments().getString("currentName"))
-    }
-
     override fun onResume() {
         super.onResume()
         setWidthPercent(95)

From 3ef78a23dbf26ebd20bf26478db209d4620b3fec Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Fri, 20 Dec 2024 19:05:29 -0500
Subject: [PATCH 353/458] feat: atr in euiccinfo activity

commit 0fbec512ab7dd8be207bb771129a29eb5f9434a8
Author: septs <github@septs.pw>
Date:   Wed Dec 18 21:27:53 2024 +0800

    feat: atr in euiccinfo activity
---
 .../openeuicc/core/LocalProfileAssistantWrapper.kt |  2 ++
 .../im/angry/openeuicc/core/OmapiApduInterface.kt  |  3 +++
 .../angry/openeuicc/core/usb/UsbApduInterface.kt   |  9 ++++++++-
 .../im/angry/openeuicc/ui/EuiccInfoActivity.kt     | 14 +++++++++++++-
 app-common/src/main/res/values/strings.xml         |  3 +++
 .../core/TelephonyManagerApduInterface.kt          |  3 +++
 .../java/net/typeblog/lpac_jni/ApduInterface.kt    |  5 +++++
 .../net/typeblog/lpac_jni/LocalProfileAssistant.kt |  2 ++
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt     |  2 ++
 9 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index b715ca08f..7f352138e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -30,6 +30,8 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
     override val euiccInfo2: EuiccInfo2?
         get() = lpa.euiccInfo2
 
+    override fun readATR() = lpa.readATR()
+
     override fun setEs10xMss(mss: Byte) = lpa.setEs10xMss(mss)
 
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index 71aa386f6..c024b98d8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -26,6 +26,9 @@ class OmapiApduInterface(
     override val valid: Boolean
         get() = service.isConnected && (this::session.isInitialized && !session.isClosed)
 
+    override fun readATR() =
+        session.atr?.clone() ?: throw IllegalStateException("atr unavailable")
+
     override fun connect() {
         session = service.getUiccReaderCompat(port.logicalSlotIndex + 1).openSession()
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 9894343d6..da103e8e8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -32,7 +32,9 @@ class UsbApduInterface(
         transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription, verboseLoggingFlow)
 
         try {
-            transceiver.iccPowerOn()
+            // 6.1.1.1 PC_to_RDR_IccPowerOn (Page 20 of 40)
+            // https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
+            atr = transceiver.iccPowerOn().data
         } catch (e: Exception) {
             e.printStackTrace()
             throw e
@@ -99,6 +101,11 @@ class UsbApduInterface(
     override val valid: Boolean
         get() = channelId != -1
 
+    private var atr: ByteArray? = null
+
+    override fun readATR() =
+        atr?.clone() ?: throw IllegalStateException("atr unavailable")
+
     private fun isSuccessResponse(resp: ByteArray): Boolean =
         resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index df206c894..a36314c4e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -23,6 +23,7 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
@@ -41,7 +42,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         @StringRes
         val titleResId: Int,
         val content: String?,
-        val copiedToastResId: Int? = null
+        val copiedToastResId: Int? = null,
     )
 
     override fun onCreate(savedInstanceState: Bundle?) {
@@ -134,6 +135,17 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
             add(Item(R.string.euicc_info_ci_type, getString(resId)))
         }
+        add(
+            Item(
+                R.string.euicc_info_atr,
+                try {
+                    channel.lpa.readATR().encodeHex()
+                } catch (e: Exception) {
+                    getString(R.string.euicc_info_atr_unavailable)
+                },
+                copiedToastResId = R.string.toast_atr_copied,
+            )
+        )
     }
 
     private fun formatByBoolean(b: Boolean, res: Pair<Int, Int>): String =
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 6da59901c..4723e8805 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -31,6 +31,7 @@
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>
+    <string name="toast_atr_copied">ATR copied to clipboard</string>
 
     <string name="usb_permission">Grant USB permission</string>
     <string name="usb_permission_needed">Permission is needed to access the USB smart card reader.</string>
@@ -132,6 +133,8 @@
     <string name="euicc_info_ci_gsma_live">GSMA Live CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA Test CI</string>
     <string name="euicc_info_ci_unknown">Unknown eSIM CI</string>
+    <string name="euicc_info_atr">ATR (Answer To Reset)</string>
+    <string name="euicc_info_atr_unavailable">ATR unavailable</string>
 
     <string name="yes">Yes</string>
     <string name="no">No</string>
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index 6b093680a..6ab695d6d 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -25,6 +25,9 @@ class TelephonyManagerApduInterface(
         // just that transactions might return errors or nonsense
         get() = lastChannel != -1
 
+    override fun readATR() =
+        throw IllegalStateException("atr unavailable")
+
     override fun connect() {
         // Do nothing
     }
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
index dfa92dfa7..4e52a427b 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
@@ -16,4 +16,9 @@ interface ApduInterface {
      * callers should further check with the LPA to fully determine the validity of a channel
      */
     val valid: Boolean
+
+    /**
+     * Read Answer To Reset
+     */
+    fun readATR(): ByteArray
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 48ab1c54a..52ffce285 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -23,6 +23,8 @@ interface LocalProfileAssistant {
     // Extended EuiccInfo for use with LUIs, containing information such as firmware version
     val euiccInfo2: EuiccInfo2?
 
+    fun readATR(): ByteArray
+
     /**
      * Set the max segment size (mss) for all es10x commands. This can help with removable
      * eUICCs that may run at a baud rate too fast for the modem.
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 7310acd73..bf4848257 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -188,6 +188,8 @@ class LocalProfileAssistantImpl(
             return ret
         }
 
+    override fun readATR() = apduInterface.readATR()
+
     @Synchronized
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
         LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0

From 6b4723daeed139404946997857e8c6b3f609ce0d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 20 Dec 2024 19:30:33 -0500
Subject: [PATCH 354/458] refactor: ATR should not be the concern of lpac-jni

...instead, use a separate interface to represent channel types that do
support reading ATR.
---
 .../angry/openeuicc/core/ApduInterfaceAtrProvider.kt   |  5 +++++
 .../main/java/im/angry/openeuicc/core/EuiccChannel.kt  |  5 +++++
 .../java/im/angry/openeuicc/core/EuiccChannelImpl.kt   |  5 ++++-
 .../im/angry/openeuicc/core/EuiccChannelWrapper.kt     |  2 ++
 .../openeuicc/core/LocalProfileAssistantWrapper.kt     |  2 --
 .../java/im/angry/openeuicc/core/OmapiApduInterface.kt |  6 +++---
 .../im/angry/openeuicc/core/usb/UsbApduInterface.kt    | 10 ++++------
 .../java/im/angry/openeuicc/ui/EuiccInfoActivity.kt    |  7 +------
 .../openeuicc/core/TelephonyManagerApduInterface.kt    |  3 ---
 .../main/java/net/typeblog/lpac_jni/ApduInterface.kt   |  5 -----
 .../net/typeblog/lpac_jni/LocalProfileAssistant.kt     |  2 --
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt         |  2 --
 12 files changed, 24 insertions(+), 30 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/ApduInterfaceAtrProvider.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/ApduInterfaceAtrProvider.kt b/app-common/src/main/java/im/angry/openeuicc/core/ApduInterfaceAtrProvider.kt
new file mode 100644
index 000000000..c3646d21c
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/ApduInterfaceAtrProvider.kt
@@ -0,0 +1,5 @@
+package im.angry.openeuicc.core
+
+interface ApduInterfaceAtrProvider {
+    val atr: ByteArray?
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 541f8671a..5f399ea3a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -16,6 +16,11 @@ interface EuiccChannel {
 
     val valid: Boolean
 
+    /**
+     * Answer to Reset (ATR) value of the underlying interface, if any
+     */
+    val atr: ByteArray?
+
     /**
      * Intrinsic name of this channel. For device-internal SIM slots,
      * this should be null; for USB readers, this should be the name of
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index a28194876..a82cb970c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -11,7 +11,7 @@ class EuiccChannelImpl(
     override val type: String,
     override val port: UiccPortInfoCompat,
     override val intrinsicChannelName: String?,
-    apduInterface: ApduInterface,
+    private val apduInterface: ApduInterface,
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
@@ -22,6 +22,9 @@ class EuiccChannelImpl(
     override val lpa: LocalProfileAssistant =
         LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow))
 
+    override val atr: ByteArray?
+        get() = (apduInterface as? ApduInterfaceAtrProvider)?.atr
+
     override val valid: Boolean
         get() = lpa.valid
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index 6011f5315..4204e8266 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -33,6 +33,8 @@ class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
         get() = channel.valid
     override val intrinsicChannelName: String?
         get() = channel.intrinsicChannelName
+    override val atr: ByteArray?
+        get() = channel.atr
 
     override fun close() = channel.close()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
index 7f352138e..b715ca08f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/LocalProfileAssistantWrapper.kt
@@ -30,8 +30,6 @@ class LocalProfileAssistantWrapper(orig: LocalProfileAssistant) :
     override val euiccInfo2: EuiccInfo2?
         get() = lpa.euiccInfo2
 
-    override fun readATR() = lpa.readATR()
-
     override fun setEs10xMss(mss: Byte) = lpa.setEs10xMss(mss)
 
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index c024b98d8..c70669d49 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -15,7 +15,7 @@ class OmapiApduInterface(
     private val service: SEService,
     private val port: UiccPortInfoCompat,
     private val verboseLoggingFlow: Flow<Boolean>
-): ApduInterface {
+): ApduInterface, ApduInterfaceAtrProvider {
     companion object {
         const val TAG = "OmapiApduInterface"
     }
@@ -26,8 +26,8 @@ class OmapiApduInterface(
     override val valid: Boolean
         get() = service.isConnected && (this::session.isInitialized && !session.isClosed)
 
-    override fun readATR() =
-        session.atr?.clone() ?: throw IllegalStateException("atr unavailable")
+    override val atr: ByteArray?
+        get() = session.atr
 
     override fun connect() {
         session = service.getUiccReaderCompat(port.logicalSlotIndex + 1).openSession()
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index da103e8e8..624ef894b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.core.usb
 import android.hardware.usb.UsbDeviceConnection
 import android.hardware.usb.UsbEndpoint
 import android.util.Log
+import im.angry.openeuicc.core.ApduInterfaceAtrProvider
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.Flow
 import net.typeblog.lpac_jni.ApduInterface
@@ -12,7 +13,7 @@ class UsbApduInterface(
     private val bulkIn: UsbEndpoint,
     private val bulkOut: UsbEndpoint,
     private val verboseLoggingFlow: Flow<Boolean>
-): ApduInterface {
+) : ApduInterface, ApduInterfaceAtrProvider {
     companion object {
         private const val TAG = "UsbApduInterface"
     }
@@ -22,6 +23,8 @@ class UsbApduInterface(
 
     private var channelId = -1
 
+    override var atr: ByteArray? = null
+
     override fun connect() {
         ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
 
@@ -101,11 +104,6 @@ class UsbApduInterface(
     override val valid: Boolean
         get() = channelId != -1
 
-    private var atr: ByteArray? = null
-
-    override fun readATR() =
-        atr?.clone() ?: throw IllegalStateException("atr unavailable")
-
     private fun isSuccessResponse(resp: ByteArray): Boolean =
         resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index a36314c4e..735166d31 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -23,7 +23,6 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
@@ -138,11 +137,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(
             Item(
                 R.string.euicc_info_atr,
-                try {
-                    channel.lpa.readATR().encodeHex()
-                } catch (e: Exception) {
-                    getString(R.string.euicc_info_atr_unavailable)
-                },
+                channel.atr?.encodeHex() ?: getString(R.string.euicc_info_atr_unavailable),
                 copiedToastResId = R.string.toast_atr_copied,
             )
         )
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index 6ab695d6d..6b093680a 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -25,9 +25,6 @@ class TelephonyManagerApduInterface(
         // just that transactions might return errors or nonsense
         get() = lastChannel != -1
 
-    override fun readATR() =
-        throw IllegalStateException("atr unavailable")
-
     override fun connect() {
         // Do nothing
     }
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
index 4e52a427b..dfa92dfa7 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
@@ -16,9 +16,4 @@ interface ApduInterface {
      * callers should further check with the LPA to fully determine the validity of a channel
      */
     val valid: Boolean
-
-    /**
-     * Read Answer To Reset
-     */
-    fun readATR(): ByteArray
 }
\ No newline at end of file
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
index 52ffce285..48ab1c54a 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LocalProfileAssistant.kt
@@ -23,8 +23,6 @@ interface LocalProfileAssistant {
     // Extended EuiccInfo for use with LUIs, containing information such as firmware version
     val euiccInfo2: EuiccInfo2?
 
-    fun readATR(): ByteArray
-
     /**
      * Set the max segment size (mss) for all es10x commands. This can help with removable
      * eUICCs that may run at a baud rate too fast for the modem.
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index bf4848257..7310acd73 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -188,8 +188,6 @@ class LocalProfileAssistantImpl(
             return ret
         }
 
-    override fun readATR() = apduInterface.readATR()
-
     @Synchronized
     override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
         LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0

From 3a860601a34f8c48cb6669d50252d3787b87cdca Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 20 Dec 2024 19:32:58 -0500
Subject: [PATCH 355/458] ui: Optimize ATR strings

---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt  | 2 +-
 app-common/src/main/res/values/strings.xml                    | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 735166d31..b303e3388 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -137,7 +137,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(
             Item(
                 R.string.euicc_info_atr,
-                channel.atr?.encodeHex() ?: getString(R.string.euicc_info_atr_unavailable),
+                channel.atr?.encodeHex() ?: getString(R.string.unavailable),
                 copiedToastResId = R.string.toast_atr_copied,
             )
         )
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 4723e8805..bc468253f 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -3,6 +3,7 @@
     <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device. Insert a compatible card or a USB reader.</string>
     <string name="no_profile">No profiles (yet) on this eSIM.</string>
     <string name="unknown">Unknown</string>
+    <string name="unavailable">Unavailable</string>
     <string name="help">Help</string>
     <string name="reload">Reload Slots</string>
 
@@ -133,8 +134,7 @@
     <string name="euicc_info_ci_gsma_live">GSMA Live CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA Test CI</string>
     <string name="euicc_info_ci_unknown">Unknown eSIM CI</string>
-    <string name="euicc_info_atr">ATR (Answer To Reset)</string>
-    <string name="euicc_info_atr_unavailable">ATR unavailable</string>
+    <string name="euicc_info_atr" translatable="false">Answer To Reset (ATR)</string>
 
     <string name="yes">Yes</string>
     <string name="no">No</string>

From d0b3d54c6662be0f6c7e8668ff7389f825d26956 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 20 Dec 2024 19:33:43 -0500
Subject: [PATCH 356/458] ui: Allow multi-line strings in EuiccInfoActivity

---
 app-common/src/main/res/layout/euicc_info_item.xml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/app-common/src/main/res/layout/euicc_info_item.xml b/app-common/src/main/res/layout/euicc_info_item.xml
index 39d15a691..fa148fbb1 100644
--- a/app-common/src/main/res/layout/euicc_info_item.xml
+++ b/app-common/src/main/res/layout/euicc_info_item.xml
@@ -22,8 +22,6 @@
         android:layout_height="wrap_content"
         android:layout_marginHorizontal="24dp"
         android:layout_marginVertical="12dp"
-        android:maxLines="1"
-        android:ellipsize="marquee"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintTop_toBottomOf="@id/euicc_info_title"

From 50ba81f1319253ca1dd85b84c407acbef36491fc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 21 Dec 2024 14:31:14 -0500
Subject: [PATCH 357/458] i18n: Update translations of all new strings

---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt  | 2 +-
 app-common/src/main/res/values-ja/strings.xml                 | 4 ++++
 app-common/src/main/res/values-zh-rCN/strings.xml             | 4 ++++
 app-common/src/main/res/values/strings.xml                    | 2 +-
 4 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index b303e3388..e88ad0123 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -137,7 +137,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(
             Item(
                 R.string.euicc_info_atr,
-                channel.atr?.encodeHex() ?: getString(R.string.unavailable),
+                channel.atr?.encodeHex() ?: getString(R.string.information_unavailable),
                 copiedToastResId = R.string.toast_atr_copied,
             )
         )
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 25211b01f..b592ec3ad 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -3,6 +3,7 @@
     <string name="no_euicc">このアプリでアクセスできるリムーバブル eUICC カードがデバイス上で検出されていません。互換性のあるカード挿入または USB リーダーを接続してください。</string>
     <string name="no_profile">この eSIM にはプロファイルがありません。</string>
     <string name="unknown">不明</string>
+    <string name="information_unavailable">情報なし</string>
     <string name="help">ヘルプ</string>
     <string name="reload">スロットを再読み込み</string>
     <string name="channel_name_format">論理スロット %d</string>
@@ -19,6 +20,7 @@
     <string name="toast_profile_delete_confirm_text_mismatched">入力した確認用テキストは一致していません</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
     <string name="toast_eid_copied">EID をクリップボードにコピーしました</string>
+    <string name="toast_atr_copied">ATR をクリップボードにコピーしました</string>
     <string name="usb_permission">USB の権限を許可</string>
     <string name="usb_permission_needed">USB スマートカードリーダーにアクセスするには許可が必要です。</string>
     <string name="usb_failed">USB スマートカードリーダー経由で eSIM に接続できません。</string>
@@ -44,6 +46,7 @@
     <string name="download_wizard">ダウンロードウィザード</string>
     <string name="download_wizard_back">戻る</string>
     <string name="download_wizard_next">次へ</string>
+    <string name="download_wizard_slot_removed">選択された SIM が取り外されました</string>
     <string name="download_wizard_slot_select">ダウンロードする eSIM を選択または確認:</string>
     <string name="download_wizard_slot_type">タイプ:</string>
     <string name="download_wizard_slot_type_removable">リムーバブル</string>
@@ -95,6 +98,7 @@
     <string name="euicc_info_activity_title">eUICC 情報 (%s)</string>
     <string name="euicc_info_access_mode">アクセスモード</string>
     <string name="euicc_info_removable">リムーバブル</string>
+    <string name="euicc_info_sgp22_version">SGP.22 バージョン</string>
     <string name="euicc_info_firmware_version">eUICC OS のバージョン</string>
     <string name="euicc_info_globalplatform_version">グローバルプラットフォームのバージョン</string>
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 208566683..cf517346f 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -20,6 +20,7 @@
     <string name="toast_profile_delete_confirm_text_mismatched">输入的确认文本不匹配</string>
     <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
     <string name="toast_eid_copied">已复制 EID 到剪贴板</string>
+    <string name="toast_atr_copied">已复制 ATR 到剪贴板</string>
     <string name="usb_permission">授予 USB 权限</string>
     <string name="usb_permission_needed">需要获得访问 USB 智能卡读卡器的权限。</string>
     <string name="usb_failed">无法通过 USB 智能卡读卡器连接到 eSIM。</string>
@@ -86,6 +87,7 @@
     <string name="download_wizard">下载向导</string>
     <string name="download_wizard_back">返回</string>
     <string name="download_wizard_next">下一步</string>
+    <string name="download_wizard_slot_removed">您选择的 SIM 已被移除</string>
     <string name="download_wizard_slot_select">请选择或确认下载目标 eSIM 卡槽:</string>
     <string name="download_wizard_slot_type">类型:</string>
     <string name="download_wizard_slot_type_removable">可插拔</string>
@@ -120,6 +122,7 @@
     <string name="euicc_info_activity_title">eUICC 详情 (%s)</string>
     <string name="euicc_info_access_mode">访问方式</string>
     <string name="euicc_info_removable">可插拔</string>
+    <string name="euicc_info_sgp22_version">SGP.22 版本</string>
     <string name="euicc_info_firmware_version">eUICC OS 版本</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform 版本</string>
     <string name="euicc_info_sas_accreditation_number">SAS 认证号码</string>
@@ -140,4 +143,5 @@
     <string name="pref_developer_unfiltered_profile_list_desc">在配置文件列表中包括非生产环境的配置文件</string>
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
+    <string name="information_unavailable">无信息</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index bc468253f..d3bce0025 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -3,7 +3,7 @@
     <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device. Insert a compatible card or a USB reader.</string>
     <string name="no_profile">No profiles (yet) on this eSIM.</string>
     <string name="unknown">Unknown</string>
-    <string name="unavailable">Unavailable</string>
+    <string name="information_unavailable">Information Unavailable</string>
     <string name="help">Help</string>
     <string name="reload">Reload Slots</string>
 

From bcd1295a18e6a0b00f9752d0a516f870d517fff2 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 21 Dec 2024 15:01:07 -0500
Subject: [PATCH 358/458] ui: Disable language picker for privileged OpenEUICC
 (for now)

...because AOSP is stupid and doesn't allow apps signed with the
platform key to use language settings.
---
 .../di/PrivilegedUiComponentFactory.kt          |  5 +++++
 .../openeuicc/ui/PrivilegedSettingsFragment.kt  | 17 +++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt

diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
index 701e57d65..e5b747ab1 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedUiComponentFactory.kt
@@ -1,9 +1,14 @@
 package im.angry.openeuicc.di
 
+import androidx.fragment.app.Fragment
 import im.angry.openeuicc.ui.EuiccManagementFragment
 import im.angry.openeuicc.ui.PrivilegedEuiccManagementFragment
+import im.angry.openeuicc.ui.PrivilegedSettingsFragment
 
 class PrivilegedUiComponentFactory : DefaultUiComponentFactory() {
     override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
         PrivilegedEuiccManagementFragment.newInstance(slotId, portId)
+
+    override fun createSettingsFragment(): Fragment =
+        PrivilegedSettingsFragment()
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
new file mode 100644
index 000000000..3306c7335
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
@@ -0,0 +1,17 @@
+package im.angry.openeuicc.ui
+
+import android.os.Bundle
+import androidx.preference.Preference
+
+class PrivilegedSettingsFragment : SettingsFragment() {
+    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
+        super.onCreatePreferences(savedInstanceState, rootKey)
+        // It's stupid to _disable_ things for privileged, but for now, the per-app locale picker
+        // is not usable for apps signed with the platform key.
+        // ref: <https://android.googlesource.com/platform/packages/apps/Settings/+/refs/tags/android-15.0.0_r6/src/com/android/settings/applications/AppLocaleUtil.java#60>
+        // This is disabled here, not moved to unprivileged, because I have hope that this will
+        // eventually work for platform-signed apps. Or, at some point we might introduce our own
+        // locale picker, which hopefully works whether privileged or not.
+        requirePreference<Preference>("pref_advanced_language").isVisible = false
+    }
+}
\ No newline at end of file

From f5074acae2abf0f9c5f2efd3a8ced5fce9c43d2a Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 4 Feb 2025 22:02:58 -0500
Subject: [PATCH 359/458] feat: alert when confirmation code is required by QR
 code

Closes #136

Co-authored-by: septs <github@septs.pw>
---
 .../DownloadWizardMethodSelectFragment.kt     | 23 +++++++++++++------
 .../im/angry/openeuicc/util/ActivationCode.kt | 23 +++++++++++++++++++
 app-common/src/main/res/values-ja/strings.xml |  2 ++
 .../src/main/res/values-zh-rCN/strings.xml    |  2 ++
 app-common/src/main/res/values/strings.xml    |  2 ++
 5 files changed, 45 insertions(+), 7 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 6203364ea..2846fd776 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -124,9 +124,22 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         processLpaString(text.toString())
     }
 
-    private fun processLpaString(s: String) {
-        val components = s.split("$")
-        if (components.size < 3 || components[0] != "LPA:1") {
+    private fun processLpaString(input: String) {
+        try {
+            val parsed = ActivationCode.fromString(input)
+            state.smdp = parsed.address
+            state.matchingId = parsed.matchingId
+            if (parsed.confirmationCodeRequired) {
+                AlertDialog.Builder(requireContext()).apply {
+                    setTitle(R.string.profile_download_required_confirmation_code)
+                    setMessage(R.string.profile_download_required_confirmation_code_message)
+                    setCancelable(true)
+                    setPositiveButton(android.R.string.ok, null)
+                    show()
+                }
+            }
+            gotoNextFragment(DownloadWizardDetailsFragment())
+        } catch (e: IllegalArgumentException) {
             AlertDialog.Builder(requireContext()).apply {
                 setTitle(R.string.profile_download_incorrect_lpa_string)
                 setMessage(R.string.profile_download_incorrect_lpa_string_message)
@@ -134,11 +147,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
                 setNegativeButton(android.R.string.cancel, null)
                 show()
             }
-            return
         }
-        state.smdp = components[1]
-        state.matchingId = components[2]
-        gotoNextFragment(DownloadWizardDetailsFragment())
     }
 
     private class DownloadMethodViewHolder(private val root: View) : ViewHolder(root) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
new file mode 100644
index 000000000..3aca0d63c
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
@@ -0,0 +1,23 @@
+package im.angry.openeuicc.util
+
+data class ActivationCode(
+    val address: String,
+    val matchingId: String? = null,
+    val oid: String? = null,
+    val confirmationCodeRequired: Boolean = false,
+) {
+    companion object {
+        fun fromString(input: String): ActivationCode {
+            val components = input.removePrefix("LPA:").split('$')
+            if (components.size < 2 || components[0] != "1") {
+                throw IllegalArgumentException("Invalid activation code format")
+            }
+            return ActivationCode(
+                address = components[1].trim(),
+                matchingId = components.getOrNull(2)?.trim()?.ifBlank { null },
+                oid = components.getOrNull(3)?.trim()?.ifBlank { null },
+                confirmationCodeRequired = components.getOrNull(4)?.trim() == "1"
+            )
+        }
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index b592ec3ad..1710a7ddf 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -144,4 +144,6 @@
     <string name="profile_class_testing">テスティング</string>
     <string name="profile_class_provisioning">準備中</string>
     <string name="profile_class_operational">動作中</string>
+    <string name="profile_download_required_confirmation_code">要確認コード</string>
+    <string name="profile_download_required_confirmation_code_message">スキャンされた QR コード、又はクリップボードからペーストされた LPA コードには、確認コードの必要が表示されています。</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index cf517346f..2cadc03db 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -144,4 +144,6 @@
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
     <string name="information_unavailable">无信息</string>
+    <string name="profile_download_required_confirmation_code">需要确认码</string>
+    <string name="profile_download_required_confirmation_code_message">您扫描的二维码或粘贴的 LPA 码需要一个额外的确认码</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d3bce0025..71e2418ad 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -57,6 +57,8 @@
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
     <string name="profile_download_no_lpa_string">No LPA code found in clipboard</string>
+    <string name="profile_download_required_confirmation_code">Confirmation Code Required</string>
+    <string name="profile_download_required_confirmation_code_message">Please provide a confirmation code as required by the scanned QR code or LPA code from clipboard.</string>
     <string name="profile_download_incorrect_lpa_string">Unable to parse</string>
     <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as a LPA code.</string>
 

From 9517f53712eb125cead4139a69e897c612649388 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 15 Feb 2025 14:26:45 -0500
Subject: [PATCH 360/458] chore: Update lpac dependency

---
 libs/lpac-jni/src/main/jni/lpac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac b/libs/lpac-jni/src/main/jni/lpac
index a5a0516f0..90f710484 160000
--- a/libs/lpac-jni/src/main/jni/lpac
+++ b/libs/lpac-jni/src/main/jni/lpac
@@ -1 +1 @@
-Subproject commit a5a0516f084936e7e87cf7420fb99283fa3052ef
+Subproject commit 90f7104847d4bb392b275746da20a55177a67573

From 03bfdf373c59e973d78f7549646ba2f0c91fd937 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 17 Feb 2025 17:07:11 -0500
Subject: [PATCH 361/458] lpac-jni: Expose customizable ISDR AIDs from lpac

...so that we could expose an option to the user going forward.
---
 .../im/angry/openeuicc/core/EuiccChannelImpl.kt    | 11 ++++++++++-
 .../src/main/java/net/typeblog/lpac_jni/LpacJni.kt |  6 +++++-
 .../lpac_jni/impl/LocalProfileAssistantImpl.kt     |  3 ++-
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c     | 14 ++++++++++++++
 4 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index a82cb970c..3da829a10 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -15,12 +15,21 @@ class EuiccChannelImpl(
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
+    companion object {
+        // TODO: This needs to go somewhere else.
+        val ISDR_AID = "A0000005591010FFFFFFFF8900000100".decodeHex()
+    }
+
     override val slotId = port.card.physicalSlotIndex
     override val logicalSlotId = port.logicalSlotIndex
     override val portId = port.portIndex
 
     override val lpa: LocalProfileAssistant =
-        LocalProfileAssistantImpl(apduInterface, HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow))
+        LocalProfileAssistantImpl(
+            ISDR_AID,
+            apduInterface,
+            HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow)
+        )
 
     override val atr: ByteArray?
         get() = (apduInterface as? ApduInterfaceAtrProvider)?.atr
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
index 370fcabc4..fa9474fe3 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/LpacJni.kt
@@ -5,7 +5,11 @@ internal object LpacJni {
         System.loadLibrary("lpac-jni")
     }
 
-    external fun createContext(apduInterface: ApduInterface, httpInterface: HttpInterface): Long
+    external fun createContext(
+        isdrAid: ByteArray,
+        apduInterface: ApduInterface,
+        httpInterface: HttpInterface
+    ): Long
     external fun destroyContext(handle: Long)
 
     external fun euiccInit(handle: Long): Int
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 7310acd73..8aafe94cd 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -12,6 +12,7 @@ import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 
 class LocalProfileAssistantImpl(
+    isdrAid: ByteArray,
     rawApduInterface: ApduInterface,
     rawHttpInterface: HttpInterface
 ): LocalProfileAssistant {
@@ -76,7 +77,7 @@ class LocalProfileAssistantImpl(
     private val httpInterface = HttpInterfaceWrapper(rawHttpInterface)
 
     private var finalized = false
-    private var contextHandle: Long = LpacJni.createContext(apduInterface, httpInterface)
+    private var contextHandle: Long = LpacJni.createContext(isdrAid, apduInterface, httpInterface)
 
     init {
         if (LpacJni.euiccInit(contextHandle) < 0) {
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 38d4f3a34..6ea9d3e5e 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -37,17 +37,30 @@ jint JNI_OnLoad(JavaVM *vm, void *reserved) {
 
 JNIEXPORT jlong JNICALL
 Java_net_typeblog_lpac_1jni_LpacJni_createContext(JNIEnv *env, jobject thiz,
+                                                  jbyteArray isdr_aid,
                                                   jobject apdu_interface,
                                                   jobject http_interface) {
     struct lpac_jni_ctx *jni_ctx = NULL;
     struct euicc_ctx *ctx = NULL;
+    jbyte *isdr_java = NULL;
+    uint32_t isdr_len = 0;
+    uint8_t *isdr_c = NULL;
 
     ctx = calloc(1, sizeof(struct euicc_ctx));
     jni_ctx = calloc(1, sizeof(struct lpac_jni_ctx));
+
+    isdr_java = (*env)->GetByteArrayElements(env, isdr_aid, JNI_FALSE);
+    isdr_len = (*env)->GetArrayLength(env, isdr_aid);
+    isdr_c = calloc(isdr_len, sizeof(uint8_t));
+    memcpy(isdr_c, isdr_java, isdr_len);
+    (*env)->ReleaseByteArrayElements(env, isdr_aid, isdr_java, JNI_ABORT);
+
     ctx->apdu.interface = &lpac_jni_apdu_interface;
     ctx->http.interface = &lpac_jni_http_interface;
     jni_ctx->apdu_interface = (*env)->NewGlobalRef(env, apdu_interface);
     jni_ctx->http_interface = (*env)->NewGlobalRef(env, http_interface);
+    ctx->aid = (const uint8_t *) isdr_c;
+    ctx->aid_len = isdr_len;
     ctx->userdata = (void *) jni_ctx;
     return (jlong) ctx;
 }
@@ -60,6 +73,7 @@ Java_net_typeblog_lpac_1jni_LpacJni_destroyContext(JNIEnv *env, jobject thiz, jl
     (*env)->DeleteGlobalRef(env, jni_ctx->apdu_interface);
     (*env)->DeleteGlobalRef(env, jni_ctx->http_interface);
     free(jni_ctx);
+    free((void *) ctx->aid);
     free(ctx);
 }
 

From c8ecdee09546191550db0b1f292ed26e9894b39b Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 26 Feb 2025 14:33:18 +0100
Subject: [PATCH 362/458] feat: supports for multi logical channel (#148)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/148
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/core/EuiccChannel.kt   |  6 ++
 .../angry/openeuicc/core/EuiccChannelImpl.kt  |  5 +-
 .../openeuicc/core/EuiccChannelWrapper.kt     |  3 +
 .../openeuicc/core/OmapiApduInterface.kt      | 36 ++++++------
 .../openeuicc/core/usb/UsbApduInterface.kt    | 39 +++++++------
 .../core/TelephonyManagerApduInterface.kt     | 57 +++++++------------
 .../util/PrivilegedTelephonyCompat.kt         | 23 ++++++--
 .../net/typeblog/lpac_jni/ApduInterface.kt    | 13 ++++-
 .../impl/LocalProfileAssistantImpl.kt         |  4 +-
 .../src/main/jni/lpac-jni/interface-wrapper.c | 16 ++++--
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.c |  2 +-
 .../lpac-jni/src/main/jni/lpac-jni/lpac-jni.h |  1 +
 12 files changed, 117 insertions(+), 88 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 5f399ea3a..597a70d26 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.*
+import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
 interface EuiccChannel {
@@ -28,5 +29,10 @@ interface EuiccChannel {
      */
     val intrinsicChannelName: String?
 
+    /**
+     * The underlying APDU interface for this channel
+     */
+    val apduInterface: ApduInterface
+
     fun close()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index 3da829a10..a56b1ccb9 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
-import im.angry.openeuicc.util.*
+import im.angry.openeuicc.util.UiccPortInfoCompat
+import im.angry.openeuicc.util.decodeHex
 import kotlinx.coroutines.flow.Flow
 import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
@@ -11,7 +12,7 @@ class EuiccChannelImpl(
     override val type: String,
     override val port: UiccPortInfoCompat,
     override val intrinsicChannelName: String?,
-    private val apduInterface: ApduInterface,
+    override val apduInterface: ApduInterface,
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index 4204e8266..09004d358 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.*
+import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
@@ -33,6 +34,8 @@ class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
         get() = channel.valid
     override val intrinsicChannelName: String?
         get() = channel.intrinsicChannelName
+    override val apduInterface: ApduInterface
+        get() = channel.apduInterface
     override val atr: ByteArray?
         get() = channel.atr
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index c70669d49..b3f42b526 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -7,7 +7,6 @@ import android.util.Log
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.first
-import kotlinx.coroutines.flow.single
 import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.ApduInterface
 
@@ -21,7 +20,12 @@ class OmapiApduInterface(
     }
 
     private lateinit var session: Session
-    private lateinit var lastChannel: Channel
+    private val channels = arrayOf<Channel?>(
+        null,
+        null,
+        null,
+        null,
+    )
 
     override val valid: Boolean
         get() = service.isConnected && (this::session.isInitialized && !session.isClosed)
@@ -38,24 +42,24 @@ class OmapiApduInterface(
     }
 
     override fun logicalChannelOpen(aid: ByteArray): Int {
-        check(!this::lastChannel.isInitialized) {
-            "Can only open one channel"
-        }
-        lastChannel = session.openLogicalChannel(aid)!!
-        return 1
+        val channel = session.openLogicalChannel(aid)
+        check(channel != null) { "Failed to open logical channel (${aid.encodeHex()})" }
+        val index = channels.indexOf(null)
+        check(index != -1) { "No free logical channel slots" }
+        synchronized(channels) { channels[index] = channel }
+        return index
     }
 
     override fun logicalChannelClose(handle: Int) {
-        check(handle == 1 && !this::lastChannel.isInitialized) {
-            "Unknown channel"
-        }
-        lastChannel.close()
+        val channel = channels.getOrNull(handle)
+        check(channel != null) { "Invalid logical channel handle $handle" }
+        if (channel.isOpen) channel.close()
+        synchronized(channels) { channels[handle] = null }
     }
 
-    override fun transmit(tx: ByteArray): ByteArray {
-        check(this::lastChannel.isInitialized) {
-            "Unknown channel"
-        }
+    override fun transmit(handle: Int, tx: ByteArray): ByteArray {
+        val channel = channels.getOrNull(handle)
+        check(channel != null) { "Invalid logical channel handle $handle" }
 
         if (runBlocking { verboseLoggingFlow.first() }) {
             Log.d(TAG, "OMAPI APDU: ${tx.encodeHex()}")
@@ -63,7 +67,7 @@ class OmapiApduInterface(
 
         try {
             for (i in 0..10) {
-                val res = lastChannel.transmit(tx)
+                val res = channel.transmit(tx)
                 if (runBlocking { verboseLoggingFlow.first() }) {
                     Log.d(TAG, "OMAPI APDU response: ${res.encodeHex()}")
                 }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 624ef894b..f9e764b50 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -21,10 +21,13 @@ class UsbApduInterface(
     private lateinit var ccidDescription: UsbCcidDescription
     private lateinit var transceiver: UsbCcidTransceiver
 
-    private var channelId = -1
-
     override var atr: ByteArray? = null
 
+    override val valid: Boolean
+        get() = channels.isNotEmpty()
+
+    private var channels = mutableSetOf<Int>()
+
     override fun connect() {
         ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
 
@@ -46,11 +49,11 @@ class UsbApduInterface(
 
     override fun disconnect() {
         conn.close()
+
+        atr = null
     }
 
     override fun logicalChannelOpen(aid: ByteArray): Int {
-        check(channelId == -1) { "Logical channel already opened" }
-
         // OPEN LOGICAL CHANNEL
         val req = manageChannelCmd(true, 0)
 
@@ -66,7 +69,7 @@ class UsbApduInterface(
             return -1
         }
 
-        channelId = resp[0].toInt()
+        val channelId = resp[0].toInt()
         Log.d(TAG, "channelId = $channelId")
 
         // Then, select AID
@@ -78,32 +81,32 @@ class UsbApduInterface(
             return -1
         }
 
+        channels.add(channelId)
+
         return channelId
     }
 
     override fun logicalChannelClose(handle: Int) {
-        check(handle == channelId) { "Logical channel ID mismatch" }
-        check(channelId != -1) { "Logical channel is not opened" }
-
+        check(channels.contains(handle)) {
+            "Invalid logical channel handle $handle"
+        }
         // CLOSE LOGICAL CHANNEL
-        val req = manageChannelCmd(false, channelId.toByte())
-        val resp = transmitApduByChannel(req, channelId.toByte())
+        val req = manageChannelCmd(false, handle.toByte())
+        val resp = transmitApduByChannel(req, handle.toByte())
 
         if (!isSuccessResponse(resp)) {
             Log.d(TAG, "CLOSE LOGICAL CHANNEL failed: ${resp.encodeHex()}")
         }
-
-        channelId = -1
+        channels.remove(handle)
     }
 
-    override fun transmit(tx: ByteArray): ByteArray {
-        check(channelId != -1) { "Logical channel is not opened" }
-        return transmitApduByChannel(tx, channelId.toByte())
+    override fun transmit(handle: Int, tx: ByteArray): ByteArray {
+        check(channels.contains(handle)) {
+            "Invalid logical channel handle $handle"
+        }
+        return transmitApduByChannel(tx, handle.toByte())
     }
 
-    override val valid: Boolean
-        get() = channelId != -1
-
     private fun isSuccessResponse(resp: ByteArray): Boolean =
         resp.size >= 2 && resp[resp.size - 2] == 0x90.toByte() && resp[resp.size - 1] == 0x00.toByte()
 
diff --git a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
index 6b093680a..f0b190968 100644
--- a/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/TelephonyManagerApduInterface.kt
@@ -18,12 +18,10 @@ class TelephonyManagerApduInterface(
         const val TAG = "TelephonyManagerApduInterface"
     }
 
-    private var lastChannel: Int = -1
-
     override val valid: Boolean
-        // TelephonyManager channels will never become truly "invalid",
-        // just that transactions might return errors or nonsense
-        get() = lastChannel != -1
+        get() = channels.isNotEmpty()
+
+    private var channels = mutableSetOf<Int>()
 
     override fun connect() {
         // Do nothing
@@ -31,52 +29,39 @@ class TelephonyManagerApduInterface(
 
     override fun disconnect() {
         // Do nothing
-        lastChannel = -1
     }
 
     override fun logicalChannelOpen(aid: ByteArray): Int {
-        check(lastChannel == -1) { "Already initialized" }
         val hex = aid.encodeHex()
         val channel = tm.iccOpenLogicalChannelByPortCompat(port.card.physicalSlotIndex, port.portIndex, hex, 0)
         if (channel.status != IccOpenLogicalChannelResponse.STATUS_NO_ERROR || channel.channel == IccOpenLogicalChannelResponse.INVALID_CHANNEL) {
-            throw IllegalArgumentException("Cannot open logical channel $hex via TelephonManager on slot ${port.card.physicalSlotIndex} port ${port.portIndex}")
+            throw IllegalArgumentException("Cannot open logical channel $hex via TelephonyManager on slot ${port.card.physicalSlotIndex} port ${port.portIndex}")
         }
-        lastChannel = channel.channel
-        return lastChannel
+        channels.add(channel.channel)
+        return channel.channel
     }
 
     override fun logicalChannelClose(handle: Int) {
-        check(handle == lastChannel) { "Invalid channel handle " }
+        check(channels.contains(handle)) {
+            "Invalid logical channel handle $handle"
+        }
         tm.iccCloseLogicalChannelByPortCompat(port.card.physicalSlotIndex, port.portIndex, handle)
-        lastChannel = -1
+        channels.remove(handle)
     }
 
-    override fun transmit(tx: ByteArray): ByteArray {
-        check(lastChannel != -1) { "Uninitialized" }
-
+    override fun transmit(handle: Int, tx: ByteArray): ByteArray {
+        check(channels.contains(handle)) {
+            "Invalid logical channel handle $handle"
+        }
         if (runBlocking { verboseLoggingFlow.first() }) {
             Log.d(TAG, "TelephonyManager APDU: ${tx.encodeHex()}")
         }
-
-        val cla = tx[0].toUByte().toInt()
-        val instruction = tx[1].toUByte().toInt()
-        val p1 = tx[2].toUByte().toInt()
-        val p2 = tx[3].toUByte().toInt()
-        val p3 = tx[4].toUByte().toInt()
-        val p4 = tx.drop(5).toByteArray().encodeHex()
-
-        return tm.iccTransmitApduLogicalChannelByPortCompat(port.card.physicalSlotIndex, port.portIndex, lastChannel,
-            cla,
-            instruction,
-            p1,
-            p2,
-            p3,
-            p4
-        ).also {
-            if (runBlocking { verboseLoggingFlow.first() }) {
-                Log.d(TAG, "TelephonyManager APDU response: $it")
-            }
-        }?.decodeHex() ?: byteArrayOf()
+        val result = tm.iccTransmitApduLogicalChannelByPortCompat(
+            port.card.physicalSlotIndex, port.portIndex, handle,
+            tx,
+        )
+        if (runBlocking { verboseLoggingFlow.first() })
+            Log.d(TAG, "TelephonyManager APDU response: $result")
+        return result?.decodeHex() ?: byteArrayOf()
     }
-
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
index dbd39f20b..a9df18eb7 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedTelephonyCompat.kt
@@ -111,15 +111,26 @@ fun TelephonyManager.iccCloseLogicalChannelByPortCompat(
     }
 
 fun TelephonyManager.iccTransmitApduLogicalChannelByPortCompat(
-    slotIndex: Int, portIndex: Int, channel: Int,
-    cla: Int, inst: Int, p1: Int, p2: Int, p3: Int, data: String?
-): String? =
-    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+    slotIndex: Int,
+    portIndex: Int,
+    channel: Int,
+    tx: ByteArray
+): String? {
+    val cla = tx[0].toUByte().toInt()
+    val ins = tx[1].toUByte().toInt()
+    val p1 = tx[2].toUByte().toInt()
+    val p2 = tx[3].toUByte().toInt()
+    val p3 = tx[4].toUByte().toInt()
+    val p4 = tx.drop(5).toByteArray().encodeHex()
+    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
         iccTransmitApduLogicalChannelByPort(
-            slotIndex, portIndex, channel, cla, inst, p1, p2, p3, data
+            slotIndex, portIndex, channel,
+            cla, ins, p1, p2, p3, p4
         )
     } else {
         iccTransmitApduLogicalChannelBySlot(
-            slotIndex, channel, cla, inst, p1, p2, p3, data
+            slotIndex, channel,
+            cla, ins, p1, p2, p3, p4
         )
     }
+}
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
index dfa92dfa7..75a690543 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/ApduInterface.kt
@@ -8,7 +8,7 @@ interface ApduInterface {
     fun disconnect()
     fun logicalChannelOpen(aid: ByteArray): Int
     fun logicalChannelClose(handle: Int)
-    fun transmit(tx: ByteArray): ByteArray
+    fun transmit(handle: Int, tx: ByteArray): ByteArray
 
     /**
      * Is this APDU connection still valid?
@@ -16,4 +16,13 @@ interface ApduInterface {
      * callers should further check with the LPA to fully determine the validity of a channel
      */
     val valid: Boolean
-}
\ No newline at end of file
+
+    fun <T> withLogicalChannel(aid: ByteArray, cb: ((ByteArray) -> ByteArray) -> T): T {
+        val handle = logicalChannelOpen(aid)
+        return try {
+            cb { transmit(handle, it) }
+        } finally {
+            logicalChannelClose(handle)
+        }
+    }
+}
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 8aafe94cd..faf531262 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -28,9 +28,9 @@ class LocalProfileAssistantImpl(
         var lastApduResponse: ByteArray? = null
         var lastApduException: Exception? = null
 
-        override fun transmit(tx: ByteArray): ByteArray =
+        override fun transmit(handle: Int, tx: ByteArray): ByteArray =
             try {
-                apduInterface.transmit(tx).also {
+                apduInterface.transmit(handle, tx).also {
                     lastApduException = null
                     lastApduResponse = it
                 }
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c b/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
index 9059171a4..a61fc9672 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
@@ -22,7 +22,7 @@ void interface_wrapper_init() {
                                                            "([B)I");
     method_apdu_logical_channel_close = (*env)->GetMethodID(env, apdu_class, "logicalChannelClose",
                                                             "(I)V");
-    method_apdu_transmit = (*env)->GetMethodID(env, apdu_class, "transmit", "([B)[B");
+    method_apdu_transmit = (*env)->GetMethodID(env, apdu_class, "transmit", "(I[B)[B");
 
     jclass http_class = (*env)->FindClass(env, "net/typeblog/lpac_jni/HttpInterface");
     method_http_transmit = (*env)->GetMethodID(env, http_class, "transmit",
@@ -53,24 +53,30 @@ apdu_interface_logical_channel_open(struct euicc_ctx *ctx, const uint8_t *aid, u
     jint ret = (*env)->CallIntMethod(env, LPAC_JNI_CTX(ctx)->apdu_interface,
                                      method_apdu_logical_channel_open, jbarr);
     LPAC_JNI_EXCEPTION_RETURN;
+    LPAC_JNI_CTX(ctx)->logical_channel_id = ret;
     return ret;
 }
 
-static void apdu_interface_logical_channel_close(struct euicc_ctx *ctx, uint8_t channel) {
+static void apdu_interface_logical_channel_close(struct euicc_ctx *ctx,
+                                                 __attribute__((unused)) uint8_t channel) {
     LPAC_JNI_SETUP_ENV;
+    jint logical_channel_id = LPAC_JNI_CTX(ctx)->logical_channel_id;
     (*env)->CallVoidMethod(env, LPAC_JNI_CTX(ctx)->apdu_interface,
-                           method_apdu_logical_channel_close, channel);
+                           method_apdu_logical_channel_close, logical_channel_id);
     (*env)->ExceptionClear(env);
 }
 
 static int
 apdu_interface_transmit(struct euicc_ctx *ctx, uint8_t **rx, uint32_t *rx_len, const uint8_t *tx,
                         uint32_t tx_len) {
+    const int logic_channel = LPAC_JNI_CTX(ctx)->logical_channel_id;
     LPAC_JNI_SETUP_ENV;
     jbyteArray txArr = (*env)->NewByteArray(env, tx_len);
     (*env)->SetByteArrayRegion(env, txArr, 0, tx_len, (const jbyte *) tx);
-    jbyteArray ret = (jbyteArray) (*env)->CallObjectMethod(env, LPAC_JNI_CTX(ctx)->apdu_interface,
-                                                           method_apdu_transmit, txArr);
+    jbyteArray ret = (jbyteArray) (*env)->CallObjectMethod(
+            env, LPAC_JNI_CTX(ctx)->apdu_interface,
+            method_apdu_transmit, logic_channel, txArr
+    );
     LPAC_JNI_EXCEPTION_RETURN;
     *rx_len = (*env)->GetArrayLength(env, ret);
     *rx = calloc(*rx_len, sizeof(uint8_t));
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
index 6ea9d3e5e..ca319db27 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.c
@@ -28,7 +28,7 @@ jint JNI_OnLoad(JavaVM *vm, void *reserved) {
     string_constructor = (*env)->GetMethodID(env, string_class, "<init>",
                                              "([BLjava/lang/String;)V");
 
-    const char _unused[1];
+    const jchar _unused[1];
     empty_string = (*env)->NewString(env, _unused, 0);
     empty_string = (*env)->NewGlobalRef(env, empty_string);
 
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
index a5d6262d6..c2300beb2 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-jni.h
@@ -8,6 +8,7 @@ _Static_assert(sizeof(void *) <= sizeof(jlong),
                "jlong must be big enough to hold a platform raw pointer");
 
 struct lpac_jni_ctx {
+    jint logical_channel_id;
     jobject apdu_interface;
     jobject http_interface;
 };

From 1d67fa5cfa6d22dd1bbed4342916c8493d60dfc1 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 4 Mar 2025 03:12:40 +0100
Subject: [PATCH 363/458] feat: detect used product (#147)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/147
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .idea/.gitignore                              |  1 +
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 43 +++++++---------
 .../im/angry/openeuicc/vendored/estkme.kt     | 49 +++++++++++++++++++
 .../im/angry/openeuicc/vendored/simlink.kt    | 20 ++++++++
 app-common/src/main/res/values/strings.xml    |  5 ++
 .../java/net/typeblog/lpac_jni/EuiccInfo2.kt  | 33 ++++++++++---
 .../impl/LocalProfileAssistantImpl.kt         | 45 +++++++++--------
 .../lpac_jni/impl/RootCertificates.kt         |  4 +-
 8 files changed, 143 insertions(+), 57 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt

diff --git a/.idea/.gitignore b/.idea/.gitignore
index 0d51aca15..b7c2402ad 100644
--- a/.idea/.gitignore
+++ b/.idea/.gitignore
@@ -9,5 +9,6 @@
 /navEditor.xml
 /runConfigurations.xml
 /workspace.xml
+/AndroidProjectSystem.xml
 
 **/*.iml
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index e88ad0123..528b2324d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -23,6 +23,8 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
+import im.angry.openeuicc.vendored.getESTKmeInfo
+import im.angry.openeuicc.vendored.getSIMLinkVersion
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
@@ -100,24 +102,22 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
 
     private fun buildEuiccInfoItems(channel: EuiccChannel) = buildList {
         add(Item(R.string.euicc_info_access_mode, channel.type))
-        add(
-            Item(
-                R.string.euicc_info_removable,
-                formatByBoolean(channel.port.card.isRemovable, YES_NO)
-            )
-        )
-        add(
-            Item(
-                R.string.euicc_info_eid,
-                channel.lpa.eID,
-                copiedToastResId = R.string.toast_eid_copied
-            )
-        )
+        add(Item(R.string.euicc_info_removable, formatByBoolean(channel.port.card.isRemovable, YES_NO)))
+        add(Item(R.string.euicc_info_eid, channel.lpa.eID, copiedToastResId = R.string.toast_eid_copied))
+        getESTKmeInfo(channel.apduInterface)?.let {
+            add(Item(R.string.euicc_info_sku, it.skuName))
+            add(Item(R.string.euicc_info_sn, it.serialNumber, copiedToastResId = R.string.toast_sn_copied))
+            add(Item(R.string.euicc_info_bl_ver, it.bootloaderVersion))
+            add(Item(R.string.euicc_info_fw_ver, it.firmwareVersion))
+        }
+        getSIMLinkVersion(channel.lpa.eID, channel.lpa.euiccInfo2?.euiccFirmwareVersion)?.let {
+            add(Item(R.string.euicc_info_sku, "9eSIM $it"))
+        }
         channel.lpa.euiccInfo2.let { info ->
-            add(Item(R.string.euicc_info_sgp22_version, info?.sgp22Version))
-            add(Item(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion))
-            add(Item(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion))
-            add(Item(R.string.euicc_info_pp_version, info?.ppVersion))
+            add(Item(R.string.euicc_info_sgp22_version, info?.sgp22Version.toString()))
+            add(Item(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion.toString()))
+            add(Item(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion.toString()))
+            add(Item(R.string.euicc_info_pp_version, info?.ppVersion.toString()))
             add(Item(R.string.euicc_info_sas_accreditation_number, info?.sasAccreditationNumber))
             add(Item(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
         }
@@ -134,13 +134,8 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
             add(Item(R.string.euicc_info_ci_type, getString(resId)))
         }
-        add(
-            Item(
-                R.string.euicc_info_atr,
-                channel.atr?.encodeHex() ?: getString(R.string.information_unavailable),
-                copiedToastResId = R.string.toast_atr_copied,
-            )
-        )
+        val atr =  channel.atr?.encodeHex() ?: getString(R.string.information_unavailable)
+        add(Item(R.string.euicc_info_atr, atr, copiedToastResId = R.string.toast_atr_copied))
     }
 
     private fun formatByBoolean(b: Boolean, res: Pair<Int, Int>): String =
diff --git a/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt b/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
new file mode 100644
index 000000000..228292149
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
@@ -0,0 +1,49 @@
+package im.angry.openeuicc.vendored
+
+import android.util.Log
+import im.angry.openeuicc.core.ApduInterfaceAtrProvider
+import im.angry.openeuicc.util.TAG
+import im.angry.openeuicc.util.decodeHex
+import net.typeblog.lpac_jni.ApduInterface
+
+data class ESTKmeInfo(
+    val serialNumber: String?,
+    val bootloaderVersion: String?,
+    val firmwareVersion: String?,
+    val skuName: String?,
+)
+
+fun isESTKmeATR(iface: ApduInterface): Boolean {
+    if (iface !is ApduInterfaceAtrProvider) return false
+    val atr = iface.atr ?: return false
+    val fpr = "estk.me".encodeToByteArray()
+    for (index in atr.indices) {
+        if (atr.size - index < fpr.size) break
+        if (atr.sliceArray(index until index + fpr.size).contentEquals(fpr)) return true
+    }
+    return false
+}
+
+fun getESTKmeInfo(iface: ApduInterface): ESTKmeInfo? {
+    if (!isESTKmeATR(iface)) return null
+    fun decode(b: ByteArray): String? {
+        if (b.size < 2) return null
+        if (b[b.size - 2] != 0x90.toByte() || b[b.size - 1] != 0x00.toByte()) return null
+        return b.sliceArray(0 until b.size - 2).decodeToString()
+    }
+    return try {
+        iface.withLogicalChannel("A06573746B6D65FFFFFFFFFFFF6D6774".decodeHex()) { transmit ->
+            fun invoke(p1: Byte) = decode(transmit(byteArrayOf(0x00, 0x00, p1, 0x00, 0x00)))
+            ESTKmeInfo(
+                invoke(0x00), // serial number
+                invoke(0x01), // bootloader version
+                invoke(0x02), // firmware version
+                invoke(0x03), // sku name
+            )
+        }
+    } catch (e: Exception) {
+        Log.d(TAG, "Failed to get ESTKmeInfo", e)
+        null
+    }
+}
+
diff --git a/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt b/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt
new file mode 100644
index 000000000..506f16c61
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt
@@ -0,0 +1,20 @@
+package im.angry.openeuicc.vendored
+
+import net.typeblog.lpac_jni.Version
+
+private val prefix = Regex("^89044045(84|21)67274948") // SIMLink EID prefix
+
+fun getSIMLinkVersion(eid: String, version: Version?): String? {
+    if (version == null || prefix.find(eid, 0) == null) return null
+    return when {
+        // @formatter:off
+        version >= Version(37,  1, 41) -> "v3.1 (beta 1)"
+        version >= Version(36, 18,  5) -> "v3 (final)"
+        version >= Version(36, 17, 39) -> "v3 (beta)"
+        version >= Version(36, 17,  4) -> "v2s"
+        version >= Version(36,  9,  3) -> "v2.1"
+        version >= Version(36,  7,  2) -> "v2"
+        // @formatter:on
+        else -> null
+    }
+}
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 71e2418ad..a45ce1f6c 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -31,6 +31,7 @@
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
+    <string name="toast_sn_copied">Serial Number copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>
     <string name="toast_atr_copied">ATR copied to clipboard</string>
 
@@ -125,6 +126,10 @@
     <string name="euicc_info_activity_title">eUICC Info (%s)</string>
     <string name="euicc_info_access_mode">Access Mode</string>
     <string name="euicc_info_removable">Removable</string>
+    <string name="euicc_info_sku">Product Name</string>
+    <string name="euicc_info_sn">Product Serial Number</string>
+    <string name="euicc_info_bl_ver">Product Bootloader Version</string>
+    <string name="euicc_info_fw_ver">Product Firmware Version</string>
     <string name="euicc_info_eid" translatable="false">EID</string>
     <string name="euicc_info_sgp22_version">SGP.22 Version</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
index 6c7305199..072004970 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/EuiccInfo2.kt
@@ -2,14 +2,31 @@ package net.typeblog.lpac_jni
 
 /* Corresponds to EuiccInfo2 in SGP.22 */
 data class EuiccInfo2(
-    val sgp22Version: String,
-    val profileVersion: String,
-    val euiccFirmwareVersion: String,
-    val globalPlatformVersion: String,
+    val sgp22Version: Version,
+    val profileVersion: Version,
+    val euiccFirmwareVersion: Version,
+    val globalPlatformVersion: Version,
     val sasAccreditationNumber: String,
-    val ppVersion: String,
+    val ppVersion: Version,
     val freeNvram: Int,
     val freeRam: Int,
-    val euiccCiPKIdListForSigning: Array<String>,
-    val euiccCiPKIdListForVerification: Array<String>,
-)
\ No newline at end of file
+    val euiccCiPKIdListForSigning: Set<String>,
+    val euiccCiPKIdListForVerification: Set<String>,
+)
+
+data class Version(
+    val major: Int,
+    val minor: Int,
+    val patch: Int,
+) {
+    constructor(version: String) : this(version.split('.').map(String::toInt))
+    private constructor(parts: List<Int>) : this(parts[0], parts[1], parts[2])
+
+    operator fun compareTo(other: Version): Int {
+        if (major != other.major) return major - other.major
+        if (minor != other.minor) return minor - other.minor
+        return patch - other.patch
+    }
+
+    override fun toString() = "$major.$minor.$patch"
+}
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index faf531262..3674f4f19 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -10,6 +10,7 @@ import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
+import net.typeblog.lpac_jni.Version
 
 class LocalProfileAssistantImpl(
     isdrAid: ByteArray,
@@ -84,8 +85,8 @@ class LocalProfileAssistantImpl(
             throw IllegalArgumentException("Failed to initialize LPA")
         }
 
-        val pkids = euiccInfo2?.euiccCiPKIdListForVerification ?: arrayOf()
-        httpInterface.usePublicKeyIds(pkids)
+        val pkids = euiccInfo2?.euiccCiPKIdListForVerification ?: setOf()
+        httpInterface.usePublicKeyIds(pkids.toTypedArray())
     }
 
     override fun setEs10xMss(mss: Byte) {
@@ -157,31 +158,29 @@ class LocalProfileAssistantImpl(
             val cInfo = LpacJni.es10cexGetEuiccInfo2(contextHandle)
             if (cInfo == 0L) return null
 
-            val euiccCiPKIdListForSigning = mutableListOf<String>()
-            var curr = LpacJni.euiccInfo2GetEuiccCiPKIdListForSigning(cInfo)
-            while (curr != 0L) {
-                euiccCiPKIdListForSigning.add(LpacJni.stringDeref(curr))
-                curr = LpacJni.stringArrNext(curr)
-            }
-
-            val euiccCiPKIdListForVerification = mutableListOf<String>()
-            curr = LpacJni.euiccInfo2GetEuiccCiPKIdListForVerification(cInfo)
-            while (curr != 0L) {
-                euiccCiPKIdListForVerification.add(LpacJni.stringDeref(curr))
-                curr = LpacJni.stringArrNext(curr)
-            }
-
             val ret = EuiccInfo2(
-                LpacJni.euiccInfo2GetSGP22Version(cInfo),
-                LpacJni.euiccInfo2GetProfileVersion(cInfo),
-                LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo),
-                LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo),
+                Version(LpacJni.euiccInfo2GetSGP22Version(cInfo)),
+                Version(LpacJni.euiccInfo2GetProfileVersion(cInfo)),
+                Version(LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo)),
+                Version(LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo)),
                 LpacJni.euiccInfo2GetSasAcreditationNumber(cInfo),
-                LpacJni.euiccInfo2GetPpVersion(cInfo),
+                Version(LpacJni.euiccInfo2GetPpVersion(cInfo)),
                 LpacJni.euiccInfo2GetFreeNonVolatileMemory(cInfo).toInt(),
                 LpacJni.euiccInfo2GetFreeVolatileMemory(cInfo).toInt(),
-                euiccCiPKIdListForSigning.toTypedArray(),
-                euiccCiPKIdListForVerification.toTypedArray()
+                buildSet {
+                    var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForSigning(cInfo)
+                    while (cursor != 0L) {
+                        add(LpacJni.stringDeref(cursor))
+                        cursor = LpacJni.stringArrNext(cursor)
+                    }
+                },
+                buildSet {
+                    var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForVerification(cInfo)
+                    while (cursor != 0L) {
+                        add(LpacJni.stringDeref(cursor))
+                        cursor = LpacJni.stringArrNext(cursor)
+                    }
+                },
             )
 
             LpacJni.euiccInfo2Free(cInfo)
diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
index cfd5779f5..295a91158 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/RootCertificates.kt
@@ -14,7 +14,7 @@ const val DEFAULT_PKID_GSMA_RSP2_ROOT_CI1 = "81370f5125d0b1d408d4c3b232e6d25e795
 
 // List of GSMA Live CIs
 // https://www.gsma.com/solutions-and-impact/technologies/esim/gsma-root-ci/
-val PKID_GSMA_LIVE_CI = arrayOf(
+val PKID_GSMA_LIVE_CI = setOf(
     // GSMA RSP2 Root CI1 (SGP.22 v2+v3, CA: DigiCert)
     // https://euicc-manual.osmocom.org/docs/pki/ci/files/81370f.txt
     DEFAULT_PKID_GSMA_RSP2_ROOT_CI1,
@@ -25,7 +25,7 @@ val PKID_GSMA_LIVE_CI = arrayOf(
 
 // SGP.26 v3.0, 2023-12-01
 // https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2023/12/SGP.26-v3.0.pdf
-val PKID_GSMA_TEST_CI = arrayOf(
+val PKID_GSMA_TEST_CI = setOf(
     // Test CI (SGP.26, NIST P256)
     // https://euicc-manual.osmocom.org/docs/pki/ci/files/34eecf.txt
     "34eecf13156518d48d30bdf06853404d115f955d",

From ef295c9d128de48cd9e22968dd6f81337bc6029b Mon Sep 17 00:00:00 2001
From: h0353914 <h0353914@gmail.com>
Date: Tue, 4 Mar 2025 03:13:39 +0100
Subject: [PATCH 364/458] Add Traditional Chinese (zh-TW) translation (#142)

Converted from Simplified Chinese

Co-authored-by: h0353914 <45159732+h0353914@users.noreply.github.com>
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/142
Co-authored-by: h0353914 <h0353914@gmail.com>
Co-committed-by: h0353914 <h0353914@gmail.com>
---
 .../src/main/res/values-zh-rTW/strings.xml    | 147 ++++++++++++++++++
 .../src/main/res/values-zh-rTW/strings.xml    |  32 ++++
 app/src/main/res/values-zh-rTW/strings.xml    |  20 +++
 3 files changed, 199 insertions(+)
 create mode 100644 app-common/src/main/res/values-zh-rTW/strings.xml
 create mode 100644 app-unpriv/src/main/res/values-zh-rTW/strings.xml
 create mode 100644 app/src/main/res/values-zh-rTW/strings.xml

diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
new file mode 100644
index 000000000..28691a0cc
--- /dev/null
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="no_euicc">在此裝置上未檢測到此應用程式可訪問的可插拔 eUICC 卡。請插入相容卡或 USB 晶片讀卡機。</string>
+    <string name="no_profile">此 eSIM 上還沒有設定檔</string>
+    <string name="unknown">未知</string>
+    <string name="help">幫助</string>
+    <string name="reload">重新載入卡槽</string>
+    <string name="channel_name_format">虛擬卡槽 %d</string>
+    <string name="enabled">已啟用</string>
+    <string name="disabled">已停用</string>
+    <string name="provider">電信業者:</string>
+    <string name="profile_class">類型:</string>
+    <string name="enable">啟用</string>
+    <string name="disable">停用</string>
+    <string name="delete">刪除</string>
+    <string name="rename">重新命名</string>
+    <string name="enable_disable_timeout">等待 eSIM 切換設定檔時逾時。這可能是您手機基頻處理器韌體中的一個錯誤。請嘗試切換飛航模式、重新啟動應用程式或重新啟動手機</string>
+    <string name="switch_did_not_refresh">操作成功, 但是您手機的基頻處理器沒有重新整理。您可能需要切換飛航模式或重新啟動，以便使用新的設定檔。</string>
+    <string name="toast_profile_enable_failed">無法切換到新的 eSIM 設定檔。</string>
+    <string name="toast_profile_delete_confirm_text_mismatched">輸入的確認文字不匹配</string>
+    <string name="toast_iccid_copied">已複製 ICCID 到剪貼簿</string>
+    <string name="toast_eid_copied">已複製 EID 到剪貼簿</string>
+    <string name="toast_atr_copied">已複製 ATR 到剪貼簿</string>
+    <string name="usb_permission">授予 USB 權限</string>
+    <string name="usb_permission_needed">需要獲得訪問 USB 晶片讀卡機的權限。</string>
+    <string name="usb_failed">無法透過 USB 晶片讀卡機連線到 eSIM。</string>
+    <string name="task_notification">長時間運行的背景作業</string>
+    <string name="task_profile_download">正在下載 eSIM 設定檔</string>
+    <string name="task_profile_download_failure">無法下載 eSIM 設定檔</string>
+    <string name="task_profile_rename">正在重新命名 eSIM 設定檔</string>
+    <string name="task_profile_rename_failure">無法重新命名 eSIM 設定檔</string>
+    <string name="task_profile_delete">正在刪除 eSIM 設定檔</string>
+    <string name="task_profile_delete_failure">無法刪除 eSIM 設定檔</string>
+    <string name="task_profile_switch">正在切換 eSIM 設定檔</string>
+    <string name="task_profile_switch_failure">無法切換 eSIM 設定檔</string>
+    <string name="profile_download">新增新 eSIM</string>
+    <string name="profile_download_server">伺服器 (RSP / SM-DP+)</string>
+    <string name="profile_download_code">啟用碼</string>
+    <string name="profile_download_confirmation_code">確認碼 (可選)</string>
+    <string name="profile_download_imei">IMEI (可選)</string>
+    <string name="profile_download_low_nvram_title">本次下載可能會失敗</string>
+    <string name="profile_download_low_nvram_message">目前晶片的剩餘空間不足，可能導致配置下載失敗。\n是否繼續下載？</string>
+    <string name="logs_saved_message">日誌已儲存到指定路徑。需要透過其他 App 分享嗎？</string>
+    <string name="profile_rename_new_name">新名稱</string>
+    <string name="profile_rename_encoding_error">無法將名稱編碼為 UTF-8</string>
+    <string name="profile_rename_too_long">名稱長於 64 字元</string>
+    <string name="profile_rename_failure">重新命名設定檔時發生了未知錯誤</string>
+    <string name="profile_delete_confirm">您確定要刪除 %s 嗎？此動作無法還原。</string>
+    <string name="profile_delete_confirm_input">請輸入\'%s\'以確認刪除</string>
+    <string name="profile_notifications">通知列表</string>
+    <string name="profile_notifications_detailed_format">通知列表 (%s)</string>
+    <string name="profile_notifications_show">管理通知</string>
+    <string name="profile_notifications_help">eSIM 設定檔可以在下載、刪除、啟用或停用時向電信業者傳送通知。此處列出了要傳送的這些通知的佇列。\n\n在\"設定\"中，您可以指定是否自動傳送每種型別的通知。請注意，即使通知已傳送，也不會自動從記錄中刪除，除非佇列空間不足。\n\n在這裡，您可以手動傳送或刪除每個待處理的通知。</string>
+    <string name="profile_notification_operation_download">已下載</string>
+    <string name="profile_notification_operation_delete">已刪除</string>
+    <string name="profile_notification_operation_enable">已啟用</string>
+    <string name="profile_notification_operation_disable">已停用</string>
+    <string name="profile_notification_process">處理</string>
+    <string name="profile_notification_delete">刪除</string>
+    <string name="logs_save">儲存日誌</string>
+    <string name="logs_filename_template">%s 的日誌</string>
+    <string name="pref_settings">設定</string>
+    <string name="pref_notifications">通知</string>
+    <string name="pref_notifications_desc">變更 eSIM 設定檔會向電信業者傳送通知。根據需要在此處微調此行為。</string>
+    <string name="pref_notifications_download">下載</string>
+    <string name="pref_notifications_download_desc">傳送 <i>下載</i> 設定檔的通知</string>
+    <string name="pref_notifications_delete">刪除</string>
+    <string name="pref_notifications_delete_desc">傳送 <i>刪除</i> 設定檔的通知</string>
+    <string name="pref_notifications_switch">切換</string>
+    <string name="pref_advanced_verbose_logging">記錄詳細日誌</string>
+    <string name="pref_advanced_verbose_logging_desc">詳細日誌中包含敏感資訊，開啟此功能後請僅與你信任的人共享你的日誌。</string>
+    <string name="pref_advanced_logs">日誌</string>
+    <string name="pref_advanced_logs_desc">檢視應用程式的最新除錯日誌</string>
+    <string name="pref_notifications_switch_desc">傳送 <i>切換</i> 設定檔的通知\n注意，這種型別的通知是不可靠的。</string>
+    <string name="pref_advanced">進階</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">允許 停用/刪除 已啟用的設定檔</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">預設情況下，此應用程式會阻止您停用可插拔 eSIM 中已啟用的設定檔。\n因為這樣做 <i>有時</i> 會導致無法存取。\n勾選此框以 <i>移除</i> 此保護措施。</string>
+    <string name="pref_info">資訊</string>
+    <string name="pref_info_app_version">App 版本</string>
+    <string name="pref_info_source_code">原始碼</string>
+    <string name="profile_class_testing">測試</string>
+    <string name="profile_class_provisioning">準備中</string>
+    <string name="profile_class_operational">可用</string>
+    <string name="profile_download_no_lpa_string">未在剪貼簿上發現 LPA 碼</string>
+    <string name="profile_download_incorrect_lpa_string">LPA 碼解析錯誤</string>
+    <string name="profile_download_incorrect_lpa_string_message">無法將二維碼或剪貼簿內容解析為 LPA 碼</string>
+    <string name="download_wizard">下載精靈</string>
+    <string name="download_wizard_back">返回</string>
+    <string name="download_wizard_next">下一步</string>
+    <string name="download_wizard_slot_removed">您選擇的 SIM 卡已被移除</string>
+    <string name="download_wizard_slot_select">請選擇或確認下載目標 eSIM 卡槽:</string>
+    <string name="download_wizard_slot_type">型別:</string>
+    <string name="download_wizard_slot_type_removable">可插拔</string>
+    <string name="download_wizard_slot_type_internal">內建</string>
+    <string name="download_wizard_slot_type_internal_port">內建, 埠 %d</string>
+    <string name="download_wizard_slot_active_profile">目前設定檔:</string>
+    <string name="download_wizard_slot_free_space">剩餘空間:</string>
+    <string name="download_wizard_method_select">您想要如何下載 eSIM 設定檔?</string>
+    <string name="download_wizard_method_qr_code">用相機掃描二維碼</string>
+    <string name="download_wizard_method_gallery">從相簿選擇二維碼</string>
+    <string name="download_wizard_method_clipboard">從剪貼簿讀取</string>
+    <string name="download_wizard_method_manual">手動輸入</string>
+    <string name="download_wizard_details">請輸入或確認下載 eSIM 的詳細資訊:</string>
+    <string name="download_wizard_progress">正在下載您的 eSIM...</string>
+    <string name="download_wizard_progress_step_preparing">準備中</string>
+    <string name="download_wizard_progress_step_connecting">正在連線到伺服器</string>
+    <string name="download_wizard_progress_step_authenticating">正在向伺服器驗證您的裝置</string>
+    <string name="download_wizard_progress_step_downloading">正在下載 eSIM 設定檔</string>
+    <string name="download_wizard_progress_step_finalizing">正在寫入 eSIM 設定檔</string>
+    <string name="download_wizard_diagnostics">錯誤診斷</string>
+    <string name="download_wizard_diagnostics_error_code">錯誤代碼: %s</string>
+    <string name="download_wizard_diagnostics_last_http_status">上次 HTTP 狀態碼 (來自伺服器): %d</string>
+    <string name="download_wizard_diagnostics_last_http_response">上次 HTTP 應答 (來自伺服器):</string>
+    <string name="download_wizard_diagnostics_last_http_exception">上次 HTTP 錯誤:</string>
+    <string name="download_wizard_diagnostics_last_apdu_response">上次 APDU 應答 (來自 SIM): %s</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_success">上次 APDU 應答 (來自 SIM) 是成功的</string>
+    <string name="download_wizard_diagnostics_last_apdu_response_fail">上次 APDU 應答 (來自 SIM) 是失敗的</string>
+    <string name="download_wizard_diagnostics_last_apdu_exception">上次 APDU 錯誤:</string>
+    <string name="download_wizard_diagnostics_save">儲存</string>
+    <string name="download_wizard_diagnostics_file_template">%s 的錯誤診斷</string>
+    <string name="euicc_info">eUICC 詳情</string>
+    <string name="euicc_info_activity_title">eUICC 詳情 (%s)</string>
+    <string name="euicc_info_access_mode">訪問方式</string>
+    <string name="euicc_info_removable">可插拔</string>
+    <string name="euicc_info_sgp22_version">SGP.22 版本</string>
+    <string name="euicc_info_firmware_version">eUICC OS 版本</string>
+    <string name="euicc_info_globalplatform_version">GlobalPlatform 版本</string>
+    <string name="euicc_info_sas_accreditation_number">SAS 認證號碼</string>
+    <string name="euicc_info_pp_version">Protected Profile 版本</string>
+    <string name="euicc_info_free_nvram">NVRAM 剩餘空間 (eSIM 儲存容量)</string>
+    <string name="euicc_info_ci_type">證書簽發者 (CI)</string>
+    <string name="euicc_info_ci_gsma_live">GSMA 生產環境 CI</string>
+    <string name="euicc_info_ci_gsma_test">GSMA 測試 CI</string>
+    <string name="euicc_info_ci_unknown">未知 eSIM CI</string>
+    <string name="yes">是</string>
+    <string name="no">否</string>
+    <string name="developer_options_steps">還有 %d 步成為開發者</string>
+    <string name="developer_options_enabled">您現在是開發者了！</string>
+    <string name="pref_advanced_language">語言</string>
+    <string name="pref_advanced_language_desc">選擇 App 語言</string>
+    <string name="pref_developer">開發人員選項</string>
+    <string name="pref_developer_unfiltered_profile_list">顯示未經過濾的設定檔列表</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">在設定檔列表中包括非生產環境的設定檔</string>
+    <string name="pref_developer_ignore_tls_certificate">忽略 SM-DP+ 的 TLS 證書</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">允許 RSP 伺服器使用任意證書</string>
+    <string name="information_unavailable">無資訊</string>
+</resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-zh-rTW/strings.xml b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
new file mode 100644
index 000000000..b8d0eb83d
--- /dev/null
+++ b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
@@ -0,0 +1,32 @@
+<resources>
+    <string name="compatibility_check">相容性檢查</string>
+    <string name="open_sim_toolkit">啟動 SIM 卡應用程式</string>
+    <string name="compatibility_check_system_features">系統功能</string>
+    <string name="compatibility_check_system_features_desc">您的裝置是否具有管理可插拔 eUICC 卡所需的所有功能。例如，基本的電話功能和 OMAPI 支援。</string>
+    <string name="compatibility_check_system_features_no_telephony">您的裝置沒有電話功能。</string>
+    <string name="compatibility_check_system_features_no_omapi">您的裝置/系統未宣告支援 OMAPI。這可能是由於缺少硬體支援，或者可能僅僅是由於缺少標誌。請參閱以下兩項檢查以確定 OMAPI 是否確實受支援。</string>
+    <string name="compatibility_check_omapi_connectivity">OMAPI 連線</string>
+    <string name="compatibility_check_omapi_connectivity_desc">您的裝置是否允許透過 OMAPI 存取 SIM 卡上的安全元件？</string>
+    <string name="compatibility_check_omapi_connectivity_fail">無法透過 OMAPI 偵測到 SIM 卡的 Secure Element。如果您尚未在此裝置中插入 SIM 卡，請嘗試插入一張 SIM 卡並重試此檢查。</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">已成功檢測到可存取 Secure Element 的卡槽，但僅限於以下 SIM 卡槽：<b>SIM%s</b>。</string>
+    <string name="compatibility_check_isdr_channel">ISD-R 通道存取</string>
+    <string name="compatibility_check_isdr_channel_desc">您的裝置是否支援透過 OMAPI 開啟 eSIM 的 ISD-R (管理) 通道？</string>
+    <string name="compatibility_check_isdr_channel_desc_unknown">無法確定是否支援透過 OMAPI 進行 ISD-R 的存取。如果尚未插入，您可能需要插入 SIM 卡 (任何 SIM 卡都可以) 重試。</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI 只能在以下 SIM 插槽上存取 ISD-R：<b>SIM%s</b>。</string>
+    <string name="compatibility_check_known_broken">不在已知錯誤清單中</string>
+    <string name="compatibility_check_known_broken_desc">確保您的裝置不存在與可插拔 eSIM 相關的錯誤。</string>
+    <string name="compatibility_check_known_broken_fail">很抱歉，您的裝置在存取可插拔 eSIM 時存在錯誤。這並不表示完全無法使用，但我們不保證該應用在您裝置上的行為。</string>
+    <string name="compatibility_check_usb">USB 晶片讀卡機支援</string>
+    <string name="compatibility_check_usb_desc">您的裝置是否支援透過 USB 晶片讀卡機管理 eSIM？</string>
+    <string name="compatibility_check_usb_ok">您可以透過此裝置上的標準 USB CCID 讀卡機管理 eSIM (即使您在這裡有任何其他檢查項失敗)。請插入讀卡機，然後開啟此應用程式以這種方式管理 eSIM。</string>
+    <string name="compatibility_check_usb_fail">您的裝置不支援 USB 晶片讀卡機。</string>
+    <string name="compatibility_check_verdict">結論 (USB 晶片讀卡機以外)</string>
+    <string name="compatibility_check_verdict_desc">根據之前的所有檢查，您的裝置與可插拔 eSIM 卡相容的可能性有多大？</string>
+    <string name="compatibility_check_verdict_ok">您可以使用和管理插入此裝置的可插拔 eSIM 卡。</string>
+    <string name="compatibility_check_verdict_known_broken">已知您的裝置在存取可插拔 eSIM 卡時存在問題。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_ok">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。不過，您的裝置確實宣告支援 OMAPI，因此它工作的可能性略高。\n%s</string>
+    <string name="compatibility_check_verdict_unknown_likely_fail">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。由於您的裝置未宣告支援OMAPI，因此更有可能不支援在此裝置上管理可插拔 eSIM。\n%s</string>
+    <string name="compatibility_check_verdict_unknown">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。\n%s</string>
+    <string name="compatibility_check_verdict_fail_shared">然而，已經載入了eSIM設定檔的可插拔 eSIM 卡仍然可以工作; 即使無法在裝置上直接管理可插拔 eSIM 卡中的設定檔，您仍然可以使用 USB 卡讀卡機來管理設定檔。</string>
+    <string name="toast_ara_m_copied">ARA-M SHA-1 已複製到剪貼簿</string>
+</resources>
\ No newline at end of file
diff --git a/app/src/main/res/values-zh-rTW/strings.xml b/app/src/main/res/values-zh-rTW/strings.xml
new file mode 100644
index 000000000..368efbc60
--- /dev/null
+++ b/app/src/main/res/values-zh-rTW/strings.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="no_euicc_priv">在此裝置上找不到 eUICC 晶片。\n在某些裝置上，您可能需要先在此應用的選單中啟用雙卡支援。</string>
+    <string name="dsds">雙卡</string>
+    <string name="toast_dsds_switched">雙卡支援狀態已切換。請等待基頻處理器重新啟動。</string>
+    <string name="footer_mep">此卡槽支援多個啟用設定檔 (MEP)。要啟用或停用此功能，請使用\"卡槽對映\"工具。</string>
+    <string name="slot_mapping">卡槽對映</string>
+    <string name="slot_mapping_logical_slot">虛擬卡槽 %d:</string>
+    <string name="slot_mapping_port">卡槽 %1$d 端口 %2$d</string>
+    <string name="slot_mapping_help">您的手機有 %1$d 個虛擬 SIM 卡槽和 %2$d 個實體 SIM 卡槽。%3$s\n\n選擇您希望每個虛擬卡槽對應的實體卡槽 和/或 \"端口\"。請注意，並非所有對映模式都受硬體支援。</string>
+    <string name="slot_mapping_help_mep">\n\n實體卡槽 %1$d 支援多個啟用的設定檔 (MEP)。要使用此功能，請將其 %2$d 個虛擬\"端口\"分配給上面顯示的不同虛擬卡槽。\n\n啟用 MEP 後，\"端口\"會在 OpenEUICC 中顯示為共享 eSIM 設定檔的獨立的 eSIM 卡槽。</string>
+    <string name="slot_mapping_help_dsds">\n支援雙卡模式，但已停用。如果您的裝置帶有內建 eSIM 晶片，則預設情況下可能不會啟用。更改上面的對映或啟用雙卡以訪問您的 eSIM。</string>
+    <string name="slot_mapping_completed">您的新卡槽對映已設定完畢。請等待基頻處理器重新整理卡槽。</string>
+    <string name="slot_mapping_failure">指定的對映可能無效或硬體不支援您指定的對映。</string>
+    <string name="lui_title">透過下載 eSIM 連線到行動網路</string>
+    <string name="lui_desc">您的裝置支援 eSIM。要連線到行動網路，請下載電信業者釋出的 eSIM，或插入實體 SIM 卡。</string>
+    <string name="lui_skip">跳過</string>
+    <string name="lui_download">下載 eSIM</string>
+    <string name="telephony_manager">TelephonyManager (特權)</string>
+</resources>
\ No newline at end of file

From d5aefcaec740c7fd646912612eefbb49cee2ad12 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 4 Mar 2025 03:14:01 +0100
Subject: [PATCH 365/458] refactor: usb ccid driver (#149)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/149
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../core/DefaultEuiccChannelFactory.kt        |  5 +-
 .../core/DefaultEuiccChannelManager.kt        |  5 +-
 .../openeuicc/core/usb/UsbCcidDescription.kt  | 39 ++++++---------
 .../openeuicc/core/usb/UsbCcidTransceiver.kt  | 49 +++++++++----------
 .../angry/openeuicc/core/usb/UsbCcidUtils.kt  | 41 ++++++----------
 5 files changed, 61 insertions(+), 78 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 5e87564c3..ea0bd6023 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -8,7 +8,8 @@ import android.se.omapi.SEService
 import android.util.Log
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.usb.UsbApduInterface
-import im.angry.openeuicc.core.usb.getIoEndpoints
+import im.angry.openeuicc.core.usb.bulkPair
+import im.angry.openeuicc.core.usb.endpoints
 import im.angry.openeuicc.util.*
 import java.lang.IllegalArgumentException
 
@@ -61,7 +62,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
     }
 
     override fun tryOpenUsbEuiccChannel(usbDevice: UsbDevice, usbInterface: UsbInterface): EuiccChannel? {
-        val (bulkIn, bulkOut) = usbInterface.getIoEndpoints()
+        val (bulkIn, bulkOut) = usbInterface.endpoints.bulkPair
         if (bulkIn == null || bulkOut == null) return null
         val conn = usbManager.openDevice(usbDevice) ?: return null
         if (!conn.claimInterface(usbInterface, true)) return null
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 293042c03..dd57eab2d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -5,7 +5,8 @@ import android.hardware.usb.UsbDevice
 import android.hardware.usb.UsbManager
 import android.telephony.SubscriptionManager
 import android.util.Log
-import im.angry.openeuicc.core.usb.getSmartCardInterface
+import im.angry.openeuicc.core.usb.smartCard
+import im.angry.openeuicc.core.usb.interfaces
 import im.angry.openeuicc.di.AppContainer
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -244,7 +245,7 @@ open class DefaultEuiccChannelManager(
         withContext(Dispatchers.IO) {
             usbManager.deviceList.values.forEach { device ->
                 Log.i(TAG, "Scanning USB device ${device.deviceId}:${device.vendorId}")
-                val iface = device.getSmartCardInterface() ?: return@forEach
+                val iface = device.interfaces.smartCard ?: return@forEach
                 // If we don't have permission, tell UI code that we found a candidate device, but we
                 // need permission to be able to do anything with it
                 if (!usbManager.hasPermission(device)) return@withContext Pair(device, false)
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
index 5123d530a..bc32fb6b5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidDescription.kt
@@ -20,12 +20,12 @@ data class UsbCcidDescription(
 
         private const val FEATURE_EXCHANGE_LEVEL_TPDU = 0x10000
         private const val FEATURE_EXCHANGE_LEVEL_SHORT_APDU = 0x20000
-        private const val FEATURE_EXCHAGE_LEVEL_EXTENDED_APDU = 0x40000
+        private const val FEATURE_EXCHANGE_LEVEL_EXTENDED_APDU = 0x40000
 
         // bVoltageSupport Masks
-        private const val VOLTAGE_5V: Byte = 1
-        private const val VOLTAGE_3V: Byte = 2
-        private const val VOLTAGE_1_8V: Byte = 4
+        private const val VOLTAGE_5V0: Byte = 1
+        private const val VOLTAGE_3V0: Byte = 2
+        private const val VOLTAGE_1V8: Byte = 4
 
         private const val SLOT_OFFSET = 4
         private const val FEATURES_OFFSET = 40
@@ -71,31 +71,24 @@ data class UsbCcidDescription(
     }
 
     enum class Voltage(powerOnValue: Int, mask: Int) {
-        AUTO(0, 0), _5V(1, VOLTAGE_5V.toInt()), _3V(2, VOLTAGE_3V.toInt()), _1_8V(
-            3,
-            VOLTAGE_1_8V.toInt()
-        );
+        // @formatter:off
+        AUTO(0, 0),
+        V50(1, VOLTAGE_5V0.toInt()),
+        V30(2, VOLTAGE_3V0.toInt()),
+        V18(3, VOLTAGE_1V8.toInt());
+        // @formatter:on
 
         val mask = powerOnValue.toByte()
         val powerOnValue = mask.toByte()
     }
 
-    private fun hasFeature(feature: Int): Boolean =
-        (dwFeatures and feature) != 0
+    private fun hasFeature(feature: Int) = (dwFeatures and feature) != 0
 
-    val voltages: Array<Voltage>
-        get() =
-            if (hasFeature(FEATURE_AUTOMATIC_VOLTAGE)) {
-                arrayOf(Voltage.AUTO)
-            } else {
-                Voltage.values().mapNotNull {
-                    if ((it.mask.toInt() and bVoltageSupport.toInt()) != 0) {
-                        it
-                    } else {
-                        null
-                    }
-                }.toTypedArray()
-            }
+    val voltages: List<Voltage>
+        get() {
+            if (hasFeature(FEATURE_AUTOMATIC_VOLTAGE)) return listOf(Voltage.AUTO)
+            return Voltage.entries.filter { (it.mask.toInt() and bVoltageSupport.toInt()) != 0 }
+        }
 
     val hasAutomaticPps: Boolean
         get() = hasFeature(FEATURE_AUTOMATIC_PPS)
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
index 5ef35afa6..9155721f3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidTransceiver.kt
@@ -95,6 +95,7 @@ class UsbCcidTransceiver(
     data class UsbCcidErrorException(val msg: String, val errorResponse: CcidDataBlock) :
         Exception(msg)
 
+    @Suppress("ArrayInDataClass")
     data class CcidDataBlock(
         val dwLength: Int,
         val bSlot: Byte,
@@ -183,31 +184,26 @@ class UsbCcidTransceiver(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
             )
             if (runBlocking { verboseLoggingFlow.first() }) {
-                Log.d(TAG, "Received " + readBytes + " bytes: " + inputBuffer.encodeHex())
+                Log.d(TAG, "Received $readBytes bytes: ${inputBuffer.encodeHex()}")
             }
         } while (readBytes <= 0 && attempts-- > 0)
         if (readBytes < CCID_HEADER_LENGTH) {
             throw UsbTransportException("USB-CCID error - failed to receive CCID header")
         }
         if (inputBuffer[0] != MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK.toByte()) {
-            if (expectedSequenceNumber != inputBuffer[6]) {
-                throw UsbTransportException(
-                    ((("USB-CCID error - bad CCID header, type " + inputBuffer[0]) + " (expected " +
-                            MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK) + "), sequence number " + inputBuffer[6]
-                            ) + " (expected " +
-                            expectedSequenceNumber + ")"
-                )
-            }
-            throw UsbTransportException(
-                "USB-CCID error - bad CCID header type " + inputBuffer[0]
-            )
+            throw UsbTransportException(buildString {
+                append("USB-CCID error - bad CCID header")
+                append(", type ")
+                append("%d (expected %d)".format(inputBuffer[0], MESSAGE_TYPE_RDR_TO_PC_DATA_BLOCK))
+                if (expectedSequenceNumber != inputBuffer[6]) {
+                    append(", sequence number ")
+                    append("%d (expected %d)".format(inputBuffer[6], expectedSequenceNumber))
+                }
+            })
         }
         var result = CcidDataBlock.parseHeaderFromBytes(inputBuffer)
         if (expectedSequenceNumber != result.bSeq) {
-            throw UsbTransportException(
-                ("USB-CCID error - expected sequence number " +
-                        expectedSequenceNumber + ", got " + result)
-            )
+            throw UsbTransportException("USB-CCID error - expected sequence number $expectedSequenceNumber, got $result")
         }
 
         val dataBuffer = ByteArray(result.dwLength)
@@ -218,9 +214,7 @@ class UsbCcidTransceiver(
                 usbBulkIn, inputBuffer, inputBuffer.size, DEVICE_COMMUNICATE_TIMEOUT_MILLIS
             )
             if (readBytes < 0) {
-                throw UsbTransportException(
-                    "USB error - failed reading response data! Header: $result"
-                )
+                throw UsbTransportException("USB error - failed reading response data! Header: $result")
             }
             System.arraycopy(inputBuffer, 0, dataBuffer, bufferedBytes, readBytes)
             bufferedBytes += readBytes
@@ -285,7 +279,7 @@ class UsbCcidTransceiver(
         }
         val ccidDataBlock = receiveDataBlock(sequenceNumber)
         val elapsedTime = SystemClock.elapsedRealtime() - startTime
-        Log.d(TAG, "USB XferBlock call took " + elapsedTime + "ms")
+        Log.d(TAG, "USB XferBlock call took ${elapsedTime}ms")
         return ccidDataBlock
     }
 
@@ -293,13 +287,13 @@ class UsbCcidTransceiver(
         val startTime = SystemClock.elapsedRealtime()
         skipAvailableInput()
         var response: CcidDataBlock? = null
-        for (v in usbCcidDescription.voltages) {
-            Log.v(TAG, "CCID: attempting to power on with voltage $v")
+        for (voltage in usbCcidDescription.voltages) {
+            Log.v(TAG, "CCID: attempting to power on with voltage $voltage")
             response = try {
-                iccPowerOnVoltage(v.powerOnValue)
+                iccPowerOnVoltage(voltage.powerOnValue)
             } catch (e: UsbCcidErrorException) {
                 if (e.errorResponse.bError.toInt() == 7) { // Power select error
-                    Log.v(TAG, "CCID: failed to power on with voltage $v")
+                    Log.v(TAG, "CCID: failed to power on with voltage $voltage")
                     iccPowerOff()
                     Log.v(TAG, "CCID: powered off")
                     continue
@@ -314,8 +308,11 @@ class UsbCcidTransceiver(
         val elapsedTime = SystemClock.elapsedRealtime() - startTime
         Log.d(
             TAG,
-            "Usb transport connected, took " + elapsedTime + "ms, ATR=" +
-                    response.data?.encodeHex()
+            buildString {
+                append("Usb transport connected")
+                append(", took ", elapsedTime, "ms")
+                append(", ATR=", response.data?.encodeHex())
+            }
         )
         return response
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
index edca7a03a..877c7fd20 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidUtils.kt
@@ -6,31 +6,22 @@ import android.hardware.usb.UsbDevice
 import android.hardware.usb.UsbEndpoint
 import android.hardware.usb.UsbInterface
 
-class UsbTransportException(msg: String) : Exception(msg)
+class UsbTransportException(message: String) : Exception(message)
 
-fun UsbInterface.getIoEndpoints(): Pair<UsbEndpoint?, UsbEndpoint?> {
-    var bulkIn: UsbEndpoint? = null
-    var bulkOut: UsbEndpoint? = null
-    for (i in 0 until endpointCount) {
-        val endpoint = getEndpoint(i)
-        if (endpoint.type != UsbConstants.USB_ENDPOINT_XFER_BULK) {
-            continue
-        }
-        if (endpoint.direction == UsbConstants.USB_DIR_IN) {
-            bulkIn = endpoint
-        } else if (endpoint.direction == UsbConstants.USB_DIR_OUT) {
-            bulkOut = endpoint
-        }
-    }
-    return Pair(bulkIn, bulkOut)
-}
+val UsbDevice.interfaces: Iterable<UsbInterface>
+    get() = (0 until interfaceCount).map(::getInterface)
 
-fun UsbDevice.getSmartCardInterface(): UsbInterface? {
-    for (i in 0 until interfaceCount) {
-        val anInterface = getInterface(i)
-        if (anInterface.interfaceClass == UsbConstants.USB_CLASS_CSCID) {
-            return anInterface
-        }
+val Iterable<UsbInterface>.smartCard: UsbInterface?
+    get() = find { it.interfaceClass == UsbConstants.USB_CLASS_CSCID }
+
+val UsbInterface.endpoints: Iterable<UsbEndpoint>
+    get() = (0 until endpointCount).map(::getEndpoint)
+
+val Iterable<UsbEndpoint>.bulkPair: Pair<UsbEndpoint?, UsbEndpoint?>
+    get() {
+        val endpoints = filter { it.type == UsbConstants.USB_ENDPOINT_XFER_BULK }
+        return Pair(
+            endpoints.find { it.direction == UsbConstants.USB_DIR_IN },
+            endpoints.find { it.direction == UsbConstants.USB_DIR_OUT },
+        )
     }
-    return null
-}
\ No newline at end of file

From 6c9063a7612009e13fd6989aa064f6d18d3a7dc2 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 5 Mar 2025 14:18:03 +0100
Subject: [PATCH 366/458] chore: add zh-TW to locale-config (#155)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/155
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/res/xml/locale_config.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-common/src/main/res/xml/locale_config.xml b/app-common/src/main/res/xml/locale_config.xml
index e1a13f82b..6d7f0764b 100644
--- a/app-common/src/main/res/xml/locale_config.xml
+++ b/app-common/src/main/res/xml/locale_config.xml
@@ -3,4 +3,5 @@
     <locale android:name="en-US" />
     <locale android:name="ja" />
     <locale android:name="zh-CN" />
+    <locale android:name="zh-TW" />
 </locale-config>
\ No newline at end of file

From 65c7f8de83dacc3ed538a4210e38d47677c1f018 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 5 Mar 2025 14:18:56 +0100
Subject: [PATCH 367/458] feat: prompt to enable disabled sim toolkit app
 (#153)

<video src="/attachments/fb9f210c-5960-4889-ba6a-dba4aa085a12" title="screen-20250305-130942.mp4" controls></video>

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/153
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/UnprivilegedEuiccManagementFragment.kt |  23 +++-
 .../im/angry/openeuicc/util/SIMToolkit.kt     | 104 +++++++++++-------
 app-unpriv/src/main/res/values/strings.xml    |   1 +
 3 files changed, 84 insertions(+), 44 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
index fad03fdfe..617cbec55 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
@@ -1,7 +1,10 @@
 package im.angry.openeuicc.ui
 
+import android.content.pm.PackageManager
+import android.provider.Settings
 import android.view.Menu
 import android.view.MenuInflater
+import android.widget.Toast
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.util.SIMToolkit
 import im.angry.openeuicc.util.newInstanceEuicc
@@ -24,8 +27,22 @@ class UnprivilegedEuiccManagementFragment : EuiccManagementFragment() {
         super.onCreateOptionsMenu(menu, inflater)
         inflater.inflate(R.menu.fragment_sim_toolkit, menu)
         menu.findItem(R.id.open_sim_toolkit).apply {
-            isVisible = stk.isAvailable(slotId)
-            intent = stk.intent(slotId)
+            val slot = stk[slotId] ?: return@apply
+            isVisible = slot.intent != null
+            setOnMenuItemClickListener {
+                val intent = slot.intent ?: return@setOnMenuItemClickListener false
+                if (intent.action == Settings.ACTION_APPLICATION_DETAILS_SETTINGS) {
+                    val packageName = intent.data!!.schemeSpecificPart
+                    val label = requireContext().packageManager.getApplicationLabel(packageName)
+                    val message = requireContext().getString(R.string.toast_prompt_to_enable_sim_toolkit, label)
+                    Toast.makeText(context, message, Toast.LENGTH_LONG).show()
+                }
+                startActivity(intent)
+                true
+            }
         }
     }
-}
\ No newline at end of file
+}
+
+private fun PackageManager.getApplicationLabel(packageName: String): CharSequence =
+    getApplicationLabel(getApplicationInfo(packageName, 0))
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
index ced813a18..99824ffe4 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
@@ -3,65 +3,87 @@ package im.angry.openeuicc.util
 import android.content.ComponentName
 import android.content.Context
 import android.content.Intent
+import android.content.pm.ActivityInfo
 import android.content.pm.PackageManager
+import android.net.Uri
+import android.provider.Settings
+import android.widget.Toast
 import androidx.annotation.ArrayRes
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.core.EuiccChannelManager
 
 class SIMToolkit(private val context: Context) {
-    private val slotSelection = getComponentNames(R.array.sim_toolkit_slot_selection)
-
     private val slots = buildMap {
+        fun getComponentNames(@ArrayRes id: Int) = context.resources
+            .getStringArray(id).mapNotNull(ComponentName::unflattenFromString)
+        put(-1, getComponentNames(R.array.sim_toolkit_slot_selection))
         put(0, getComponentNames(R.array.sim_toolkit_slot_1))
         put(1, getComponentNames(R.array.sim_toolkit_slot_2))
     }
 
-    private val packageNames = buildSet {
-        addAll(slotSelection.map { it.packageName })
-        addAll(slots.values.flatten().map { it.packageName })
+    operator fun get(slotId: Int): Slot? = when (slotId) {
+        -1, EuiccChannelManager.USB_CHANNEL_ID -> null
+        else -> Slot(context.packageManager, buildSet {
+            addAll(slots.getOrDefault(slotId, emptySet()))
+            addAll(slots.getOrDefault(-1, emptySet()))
+        })
     }
 
-    private val activities = packageNames.flatMap(::getActivities).toSet()
+    data class Slot(private val packageManager: PackageManager, private val components: Set<ComponentName>) {
+        private val packageNames: Iterable<String>
+            get() = components.map(ComponentName::getPackageName).toSet()
 
-    private val launchIntent by lazy {
-        packageNames.firstNotNullOfOrNull(::getLaunchIntent)
-    }
+        private val launchIntent: Intent?
+            get() = packageNames.firstNotNullOfOrNull(packageManager::getLaunchIntent)
 
-    private fun getLaunchIntent(packageName: String) = try {
-        val pm = context.packageManager
-        pm.getLaunchIntentForPackage(packageName)
-    } catch (_: PackageManager.NameNotFoundException) {
-        null
-    }
+        private val activities: Iterable<ComponentName>
+            get() = packageNames.flatMap(packageManager::getActivities)
+                .filter(ActivityInfo::exported).map { ComponentName(it.packageName, it.name) }
 
-    private fun getActivities(packageName: String): List<ComponentName> {
-        return try {
-            val pm = context.packageManager
-            val packageInfo = pm.getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
-            val activities = packageInfo.activities
-            if (activities.isNullOrEmpty()) return emptyList()
-            activities.filter { it.exported }.map { ComponentName(it.packageName, it.name) }
-        } catch (_: PackageManager.NameNotFoundException) {
-            emptyList()
+        private fun getActivityIntent(): Intent? {
+            for (activity in activities) {
+                if (!components.contains(activity)) continue
+                if (isDisabledState(packageManager.getComponentEnabledSetting(activity))) continue
+                return Intent.makeMainActivity(activity)
+            }
+            return launchIntent
         }
-    }
 
-    private fun getComponentNames(@ArrayRes id: Int) =
-        context.resources.getStringArray(id).mapNotNull(ComponentName::unflattenFromString)
-
-    fun isAvailable(slotId: Int) = when (slotId) {
-        -1 -> false
-        EuiccChannelManager.USB_CHANNEL_ID -> false
-        else -> intent(slotId) != null
-    }
-
-    fun intent(slotId: Int): Intent? {
-        val components = slots.getOrDefault(slotId, emptySet()) + slotSelection
-        val intent = Intent(Intent.ACTION_MAIN, null).apply {
-            flags = Intent.FLAG_ACTIVITY_NEW_TASK
-            component = components.find(activities::contains)
-            addCategory(Intent.CATEGORY_LAUNCHER)
+        private fun getDisabledPackageIntent(): Intent? {
+            val disabledPackageName = packageNames.find {
+                try {
+                    isDisabledState(packageManager.getApplicationEnabledSetting(it))
+                } catch (_: IllegalArgumentException) {
+                    false
+                }
+            }
+            if (disabledPackageName == null) return null
+            return Intent(
+                Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
+                Uri.fromParts("package", disabledPackageName, null)
+            )
         }
-        return if (intent.component != null) intent else launchIntent
+
+        val intent: Intent?
+            get() = getActivityIntent() ?: getDisabledPackageIntent()
     }
 }
+
+private fun isDisabledState(state: Int) = when (state) {
+    PackageManager.COMPONENT_ENABLED_STATE_DISABLED -> true
+    PackageManager.COMPONENT_ENABLED_STATE_DISABLED_USER -> true
+    else -> false
+}
+
+private fun PackageManager.getLaunchIntent(packageName: String) = try {
+    getLaunchIntentForPackage(packageName)
+} catch (_: PackageManager.NameNotFoundException) {
+    null
+}
+
+private fun PackageManager.getActivities(packageName: String) = try {
+    getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
+        .activities?.toList() ?: emptyList()
+} catch (_: PackageManager.NameNotFoundException) {
+    emptyList()
+}
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index afed295b8..43bf44fa5 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -9,6 +9,7 @@
 
     <!-- Toast -->
     <string name="toast_ara_m_copied">ARA-M SHA-1 copied to clipboard</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">Please ENABLE your \"%s\" application</string>
 
     <!-- Compatibility Check Descriptions -->
     <string name="compatibility_check_system_features">System Features</string>

From 99d9200c28f73afed57a227074e09c7bfa4629be Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 5 Mar 2025 14:19:16 +0100
Subject: [PATCH 368/458] fix: omapi apdu interface (#152)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/152
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/core/OmapiApduInterface.kt      | 22 ++++++++-----------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
index b3f42b526..f918494ae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/OmapiApduInterface.kt
@@ -9,6 +9,7 @@ import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.ApduInterface
+import java.util.concurrent.atomic.AtomicInteger
 
 class OmapiApduInterface(
     private val service: SEService,
@@ -20,12 +21,8 @@ class OmapiApduInterface(
     }
 
     private lateinit var session: Session
-    private val channels = arrayOf<Channel?>(
-        null,
-        null,
-        null,
-        null,
-    )
+    private val index = AtomicInteger(0)
+    private val channels = mutableMapOf<Int, Channel>()
 
     override val valid: Boolean
         get() = service.isConnected && (this::session.isInitialized && !session.isClosed)
@@ -44,21 +41,20 @@ class OmapiApduInterface(
     override fun logicalChannelOpen(aid: ByteArray): Int {
         val channel = session.openLogicalChannel(aid)
         check(channel != null) { "Failed to open logical channel (${aid.encodeHex()})" }
-        val index = channels.indexOf(null)
-        check(index != -1) { "No free logical channel slots" }
-        synchronized(channels) { channels[index] = channel }
-        return index
+        val handle = index.incrementAndGet()
+        synchronized(channels) { channels[handle] = channel }
+        return handle
     }
 
     override fun logicalChannelClose(handle: Int) {
-        val channel = channels.getOrNull(handle)
+        val channel = channels[handle]
         check(channel != null) { "Invalid logical channel handle $handle" }
         if (channel.isOpen) channel.close()
-        synchronized(channels) { channels[handle] = null }
+        synchronized(channels) { channels.remove(handle) }
     }
 
     override fun transmit(handle: Int, tx: ByteArray): ByteArray {
-        val channel = channels.getOrNull(handle)
+        val channel = channels[handle]
         check(channel != null) { "Invalid logical channel handle $handle" }
 
         if (runBlocking { verboseLoggingFlow.first() }) {

From 1313bfd24e41ec0a9e6a0e0e28c59b063aac0868 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 16:46:46 +0100
Subject: [PATCH 369/458] fix: iccCloseLogicalChannelByPort method signature
 (#157)

fixes #154

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/157
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/util/TelephonyManagerHiddenApi.kt  | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/libs/hidden-apis-shim/src/main/java/im/angry/openeuicc/util/TelephonyManagerHiddenApi.kt b/libs/hidden-apis-shim/src/main/java/im/angry/openeuicc/util/TelephonyManagerHiddenApi.kt
index 4203feaef..0d4235469 100644
--- a/libs/hidden-apis-shim/src/main/java/im/angry/openeuicc/util/TelephonyManagerHiddenApi.kt
+++ b/libs/hidden-apis-shim/src/main/java/im/angry/openeuicc/util/TelephonyManagerHiddenApi.kt
@@ -69,11 +69,13 @@ fun TelephonyManager.iccOpenLogicalChannelByPort(
 ): IccOpenLogicalChannelResponse =
     iccOpenLogicalChannelByPort.invoke(this, slotId, portId, appletId, p2) as IccOpenLogicalChannelResponse
 
-fun TelephonyManager.iccCloseLogicalChannelBySlot(slotId: Int, channel: Int): Boolean =
-    iccCloseLogicalChannelBySlot.invoke(this, slotId, channel) as Boolean
+fun TelephonyManager.iccCloseLogicalChannelBySlot(slotId: Int, channel: Int) {
+    iccCloseLogicalChannelBySlot.invoke(this, slotId, channel)
+}
 
-fun TelephonyManager.iccCloseLogicalChannelByPort(slotId: Int, portId: Int, channel: Int): Boolean =
-    iccCloseLogicalChannelByPort.invoke(this, slotId, portId, channel) as Boolean
+fun TelephonyManager.iccCloseLogicalChannelByPort(slotId: Int, portId: Int, channel: Int) {
+    iccCloseLogicalChannelByPort.invoke(this, slotId, portId, channel)
+}
 
 fun TelephonyManager.iccTransmitApduLogicalChannelBySlot(
     slotId: Int, channel: Int, cla: Int, instruction: Int,

From 6a5d4b92888507758c27eb1431724b6388698679 Mon Sep 17 00:00:00 2001
From: reindex <reindex@noreply.gitea.angry.im>
Date: Sat, 8 Mar 2025 16:47:43 +0100
Subject: [PATCH 370/458] Update Japanese (#159)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Crowdinで英語のXMLを同期、Stringsを比較しやすいように再成形済み。

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/159
Co-authored-by: reindex <reindex@noreply.gitea.angry.im>
Co-committed-by: reindex <reindex@noreply.gitea.angry.im>
---
 app-common/src/main/res/values-ja/strings.xml | 71 ++++++++++---------
 app-unpriv/src/main/res/values-ja/strings.xml | 21 +++---
 2 files changed, 50 insertions(+), 42 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 1710a7ddf..e4969c1f7 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -3,13 +3,17 @@
     <string name="no_euicc">このアプリでアクセスできるリムーバブル eUICC カードがデバイス上で検出されていません。互換性のあるカード挿入または USB リーダーを接続してください。</string>
     <string name="no_profile">この eSIM にはプロファイルがありません。</string>
     <string name="unknown">不明</string>
-    <string name="information_unavailable">情報なし</string>
+    <string name="information_unavailable">情報がありません</string>
     <string name="help">ヘルプ</string>
     <string name="reload">スロットを再読み込み</string>
     <string name="channel_name_format">論理スロット %d</string>
     <string name="enabled">有効済み</string>
     <string name="disabled">無効済み</string>
     <string name="provider">プロバイダー:</string>
+    <string name="profile_class">クラス:</string>
+    <string name="profile_class_testing">テスト中</string>
+    <string name="profile_class_provisioning">プロビジョニング</string>
+    <string name="profile_class_operational">稼働中</string>
     <string name="enable">有効化</string>
     <string name="disable">無効化</string>
     <string name="delete">削除</string>
@@ -17,8 +21,9 @@
     <string name="enable_disable_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
     <string name="switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
-    <string name="toast_profile_delete_confirm_text_mismatched">入力した確認用テキストは一致していません</string>
+    <string name="toast_profile_delete_confirm_text_mismatched">確認文字列が一致しません</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
+    <string name="toast_sn_copied">シリアル番号をクリップボードにコピーしました</string>
     <string name="toast_eid_copied">EID をクリップボードにコピーしました</string>
     <string name="toast_atr_copied">ATR をクリップボードにコピーしました</string>
     <string name="usb_permission">USB の権限を許可</string>
@@ -40,13 +45,15 @@
     <string name="profile_download_imei">IMEI (オプション)</string>
     <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
     <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
-    <string name="profile_download_no_lpa_string">クリップボードに LPA コードが見つかりません</string>
-    <string name="profile_download_incorrect_lpa_string">LPA コードを解析できません</string>
-    <string name="profile_download_incorrect_lpa_string_message">クリップボードまたは QR コードの内容を LPA コードとして解析できません</string>
+    <string name="profile_download_no_lpa_string">クリップボードに LPA コードがありません</string>
+    <string name="profile_download_required_confirmation_code">確認コードが必要です</string>
+    <string name="profile_download_required_confirmation_code_message">クリップボードからスキャンした QR コードまたは LPA コードに必要な確認コードを入力してください。</string>
+    <string name="profile_download_incorrect_lpa_string">解析できません</string>
+    <string name="profile_download_incorrect_lpa_string_message">QR コードまたはクリップボードの内容を LPA コードとして解析できませんでした。</string>
     <string name="download_wizard">ダウンロードウィザード</string>
     <string name="download_wizard_back">戻る</string>
     <string name="download_wizard_next">次へ</string>
-    <string name="download_wizard_slot_removed">選択された SIM が取り外されました</string>
+    <string name="download_wizard_slot_removed">選択した SIM が削除されました</string>
     <string name="download_wizard_slot_select">ダウンロードする eSIM を選択または確認:</string>
     <string name="download_wizard_slot_type">タイプ:</string>
     <string name="download_wizard_slot_type_removable">リムーバブル</string>
@@ -76,12 +83,12 @@
     <string name="download_wizard_diagnostics_last_apdu_response_fail">最終の APDU レスポンス (SIM) は失敗しました</string>
     <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
     <string name="download_wizard_diagnostics_save">保存</string>
-    <string name="download_wizard_diagnostics_file_template">%s のエラー診断</string>
-    <string name="logs_saved_message">ログは指定されたパスに保存しました。他のアプリにシェアしますか？</string>
+    <string name="download_wizard_diagnostics_file_template">「%s」での診断</string>
+    <string name="logs_saved_message">ログは共有したパスに保存されました。別のアプリで共有しますか？</string>
     <string name="profile_rename_new_name">新しいニックネーム</string>
-    <string name="profile_rename_encoding_error">ニックネームを UTF-8 にエンコードできません</string>
-    <string name="profile_rename_too_long">ニックネームは 64 文字以内にしてください</string>
-    <string name="profile_rename_failure">ニックネームの変更で予期せぬエラーが発生しました</string>
+    <string name="profile_rename_encoding_error">ニックネームを UTF-8 にエンコードできませんでした</string>
+    <string name="profile_rename_too_long">ニックネームが 64 文字を超えています</string>
+    <string name="profile_rename_failure">プロファイルの名前変更時に不明なエラーが発生しました</string>
     <string name="profile_delete_confirm">%s のプロファイルを削除してもよろしいですか？この操作は元に戻せません。</string>
     <string name="profile_delete_confirm_input">削除を確認するには「%s」を入力してください</string>
     <string name="profile_notifications">通知</string>
@@ -98,16 +105,20 @@
     <string name="euicc_info_activity_title">eUICC 情報 (%s)</string>
     <string name="euicc_info_access_mode">アクセスモード</string>
     <string name="euicc_info_removable">リムーバブル</string>
+    <string name="euicc_info_sku">製品名</string>
+    <string name="euicc_info_sn">製品シリアル番号</string>
+    <string name="euicc_info_bl_ver">製品ブートローダーバージョン</string>
+    <string name="euicc_info_fw_ver">製品ファームウェアバージョン</string>
     <string name="euicc_info_sgp22_version">SGP.22 バージョン</string>
-    <string name="euicc_info_firmware_version">eUICC OS のバージョン</string>
+    <string name="euicc_info_firmware_version">eUICC OS バージョン</string>
     <string name="euicc_info_globalplatform_version">グローバルプラットフォームのバージョン</string>
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
-    <string name="euicc_info_pp_version">Protected Profileのバージョン</string>
+    <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
-    <string name="euicc_info_ci_type">証明書の発行者 (CI)</string>
-    <string name="euicc_info_ci_gsma_live">GSMA プロダクション CI</string>
+    <string name="euicc_info_ci_type">証明書発行者 (CI)</string>
+    <string name="euicc_info_ci_gsma_live">GSMA ライブ CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA テスト CI</string>
-    <string name="euicc_info_ci_unknown">未知の eSIM CI</string>
+    <string name="euicc_info_ci_unknown">不明な eSIM CI</string>
     <string name="yes">はい</string>
     <string name="no">いいえ</string>
     <string name="logs_save">保存</string>
@@ -116,34 +127,28 @@
     <string name="developer_options_enabled">あなたは開発者になりました！</string>
     <string name="pref_settings">設定</string>
     <string name="pref_notifications">通知</string>
-    <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。ここでは、どのタイプの通知を送信するのかを微調整できます。</string>
+    <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。必要に応じてこの動作を微調整できます。</string>
     <string name="pref_notifications_download">ダウンロード</string>
-    <string name="pref_notifications_download_desc">プロファイルの<i>ダウンロード済み</i>の通知を送信します</string>
+    <string name="pref_notifications_download_desc">プロファイルを<i>ダウンロード中</i>の通知を送信します</string>
     <string name="pref_notifications_delete">削除</string>
-    <string name="pref_notifications_delete_desc">プロファイルの<i>削除済み</i>の通知を送信します</string>
-    <string name="pref_notifications_switch">切り替え</string>
-    <string name="pref_notifications_switch_desc">プロファイルの<i>切り替え済み</i>の通知を送信します\nこのタイプの通知は有効化しても必ず送信するとは限らないことに注意してください。</string>
+    <string name="pref_notifications_delete_desc">プロファイルを<i>削除中</i>の通知を送信します</string>
+    <string name="pref_notifications_switch">切り替え中</string>
+    <string name="pref_notifications_switch_desc">プロファイルを<i>切り替え中</i>の通知を送信します\nこのタイプの通知は信頼できないことに注意してください。</string>
     <string name="pref_advanced">高度な設定</string>
-    <string name="pref_advanced_disable_safeguard_removable_esim">有効なプロファイルの無効化と削除を許可する</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim">プロファイルの無効化と削除を許可</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">デフォルトでは、このアプリでデバイスに挿入された取り外し可能な eSIM の有効なプロファイルを無効化することを防いでいます。なぜなのかというと<i>時々</i>アクセスができなくなるからです。\nこのチェックボックスを ON にすることで、この保護機能を<i>解除</i>します。</string>
     <string name="pref_advanced_verbose_logging">詳細ログ</string>
     <string name="pref_advanced_verbose_logging_desc">詳細ログを有効化します。これには個人的な情報が含まれている可能性があります。この機能を ON にした後は、信頼できるユーザーとのみログを共有してください。</string>
+    <string name="pref_advanced_language">言語</string>
+    <string name="pref_advanced_language_desc">アプリの言語</string>
     <string name="pref_advanced_logs">ログ</string>
     <string name="pref_advanced_logs_desc">アプリの最新デバッグログを表示します</string>
     <string name="pref_developer">開発者オプション</string>
+    <string name="pref_developer_unfiltered_profile_list">フィルタリングされていないプロファイル一覧を表示</string>
+    <string name="pref_developer_unfiltered_profile_list_desc">非運用のプロファイルも含めます</string>
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
-    <string name="pref_developer_ignore_tls_certificate_desc">SM-DP+ TLS 証明書を無視して任意の RSP を許可します</string>
+    <string name="pref_developer_ignore_tls_certificate_desc">RSP サーバーで使用される TLS 証明書を受け入れます</string>
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
-    <string name="pref_advanced_language">言語</string>
-    <string name="pref_advanced_language_desc">アプリの言語を選択</string>
-    <string name="pref_developer_unfiltered_profile_list">すべてのプロファイルを表示</string>
-    <string name="pref_developer_unfiltered_profile_list_desc">プロダクション以外のプロファイルも表示する</string>
-    <string name="profile_class">タイプ:</string>
-    <string name="profile_class_testing">テスティング</string>
-    <string name="profile_class_provisioning">準備中</string>
-    <string name="profile_class_operational">動作中</string>
-    <string name="profile_download_required_confirmation_code">要確認コード</string>
-    <string name="profile_download_required_confirmation_code_message">スキャンされた QR コード、又はクリップボードからペーストされた LPA コードには、確認コードの必要が表示されています。</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index 053a8d12d..3a6851a9f 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -2,33 +2,36 @@
 <resources>
     <string name="compatibility_check">互換性のチェック</string>
     <string name="open_sim_toolkit">SIM ツールキットを開く</string>
+    <!-- Settings -->
+    <!-- Toast -->
+    <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">「%s」アプリを有効化してください</string>
     <!-- Compatibility Check Descriptions -->
     <string name="compatibility_check_system_features">システムの機能</string>
     <string name="compatibility_check_system_features_desc">デバイスにリムーバブル eUICC カードの管理に必要なすべての機能が備わっているかどうか。例えば基本的な電話機能や OMAPI のサポートなど。</string>
     <string name="compatibility_check_system_features_no_telephony">使用しているデバイスには電話機能がありません。</string>
     <string name="compatibility_check_system_features_no_omapi">使用しているデバイスまたはシステムには OMAPI のサポートを宣言していません。これは、ハードウェアからのサポートが不足していることが原因の可能性があります。または、フラグが不足していることが原因の可能性もあります。OMAPI が実際にサポートされているかどうかを判断するには次の 2 つのチェック項目を参照してください。</string>
     <string name="compatibility_check_omapi_connectivity">OMAPI の接続</string>
-    <string name="compatibility_check_omapi_connectivity_desc">使用しているデバイスは、OMAPI 経由で SIM カード上のセキュアエレメントへのアクセスを許可していますか？</string>
+    <string name="compatibility_check_omapi_connectivity_desc">使用しているデバイスは、OMAPI 経由で SIM カード上のセキュアエレメントへのアクセスを許可しているか否や。</string>
     <string name="compatibility_check_omapi_connectivity_fail">OMAPI 経由で SIM カードのセキュアエレメントリーダーを検出できません。このデバイスに SIM を挿入していない場合は、SIM を挿入後にこのチェックを再試行してください。</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">セキュアエレメントアクセスが正常に検出されましたが、次の SIM スロットでのみ有効です: <b>SIM%s</b>.</string>
+    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">セキュアエレメントのアクセスが正常に検出されましたが、次の SIM スロットでのみ有効です: &lt;b&gt;SIM%s&lt;/b&gt;</string>
     <string name="compatibility_check_isdr_channel">ISD-R チャネルアクセス</string>
-    <string name="compatibility_check_isdr_channel_desc">使用しているデバイスは、OMAPI 経由で eSIM への ISD-R (管理) チャネルを開くことをサポートしていますか？</string>
+    <string name="compatibility_check_isdr_channel_desc">使用しているデバイスは、OMAPI 経由で eSIM への ISD-R (管理) チャネルを開くことをサポートしているか否や。</string>
     <string name="compatibility_check_isdr_channel_desc_unknown">OMAPI 経由での ISD-R アクセスがサポートされているかどうかを確認できません。まだ SIM カードが挿入されていない場合は、挿入した状態で再試行してください (どの SIM カードでも構いません)。</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">ISD-R への OMAPI アクセスは、次のスロットでのみ可能です: <b>SIM%s</b>.</string>
-    <string name="compatibility_check_known_broken">既知の破損リストに掲載されていない</string>
+    <string name="compatibility_check_isdr_channel_desc_partial_fail">ISD-R への OMAPI アクセスは、次のスロットでのみ可能です: &lt;b&gt;SIM%s&lt;/b&gt;</string>
+    <string name="compatibility_check_known_broken">既知の破損リストの記載されていない</string>
     <string name="compatibility_check_known_broken_desc">取り外し可能な eSIM に関連するバグがデバイスに存在しないかを確認します。</string>
-    <string name="compatibility_check_known_broken_fail">おっと…使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
+    <string name="compatibility_check_known_broken_fail">おっと...使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
     <string name="compatibility_check_usb">USB カードリーダーのサポート</string>
-    <string name="compatibility_check_usb_desc">使用しているデバイスは、USB カードリーダー経由の eSIM の管理をサポートしていますか？</string>
+    <string name="compatibility_check_usb_desc">使用しているデバイスは、USB カードリーダー経由の eSIM の管理をサポートしているか否や。</string>
     <string name="compatibility_check_usb_ok">このデバイスの標準 USB CCID リーダーを介して eSIM を管理できます (ここで他のチェック項目に失敗した場合でも)。カードリーダーを挿入し、このアプリを開いてこの方法で eSIM を管理できます。</string>
     <string name="compatibility_check_usb_fail">使用しているデバイスは USB ホストとしての機能をサポートしていません。</string>
     <string name="compatibility_check_verdict">判定 (USB 以外)</string>
-    <string name="compatibility_check_verdict_desc">これまでのすべてのチェック項目に基づいて、デバイスに挿入された取り外し可能な eSIM の管理と互換性がある可能性はどのくらいありますか？</string>
+    <string name="compatibility_check_verdict_desc">これまでのすべてのチェック項目に基づいて、デバイスに挿入された取り外し可能な eSIM の管理と互換性がある可能性はどの程度かについて</string>
     <string name="compatibility_check_verdict_ok">このデバイスに挿入された取り外し可能な eSIM の使用および管理が使用できる可能性があります。</string>
     <string name="compatibility_check_verdict_known_broken">挿入された取り外し可能な eSIM にアクセスするとデバイスにバグが発生することが知られています。\n%s</string>
     <string name="compatibility_check_verdict_unknown_likely_ok">挿入された取り外し可能な eSIM が使用しているデバイスで管理できるかはわかりません。ただし、このデバイスは OMAPI のサポートを宣言しているため、動作する可能性はわずかに高くなります。\n%s</string>
     <string name="compatibility_check_verdict_unknown_likely_fail">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかは判断できません。デバイスが OMAPI のサポートを宣言していないため、このデバイス上で取り外し可能な eSIM を管理することはサポートされていない可能性があります。\n%s</string>
     <string name="compatibility_check_verdict_unknown">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかを確認できません。\n%s</string>
     <string name="compatibility_check_verdict_fail_shared">ただし、eSIM プロファイルがすでに読み込まれている場合、有効化されたプロファイル自体は引き続き機能します。また、プロファイルが管理できない場合は、このデバイスで USB カードリーダーを介してプロファイルを管理できる可能性があります。</string>
-    <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
 </resources>

From d068261ff92c198c7c0b002f44ae521314e928a1 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 16:48:32 +0100
Subject: [PATCH 371/458] improve stk menu handling (#162)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/162
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/UnprivilegedEuiccManagementFragment.kt | 33 ++++++++------
 .../im/angry/openeuicc/util/SIMToolkit.kt     | 43 +++++++++----------
 2 files changed, 40 insertions(+), 36 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
index 617cbec55..7cf300cf9 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedEuiccManagementFragment.kt
@@ -4,6 +4,7 @@ import android.content.pm.PackageManager
 import android.provider.Settings
 import android.view.Menu
 import android.view.MenuInflater
+import android.view.MenuItem
 import android.widget.Toast
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.util.SIMToolkit
@@ -26,22 +27,28 @@ class UnprivilegedEuiccManagementFragment : EuiccManagementFragment() {
     override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
         super.onCreateOptionsMenu(menu, inflater)
         inflater.inflate(R.menu.fragment_sim_toolkit, menu)
+    }
+
+    override fun onPrepareOptionsMenu(menu: Menu) {
+        super.onPrepareOptionsMenu(menu)
         menu.findItem(R.id.open_sim_toolkit).apply {
-            val slot = stk[slotId] ?: return@apply
-            isVisible = slot.intent != null
-            setOnMenuItemClickListener {
-                val intent = slot.intent ?: return@setOnMenuItemClickListener false
-                if (intent.action == Settings.ACTION_APPLICATION_DETAILS_SETTINGS) {
-                    val packageName = intent.data!!.schemeSpecificPart
-                    val label = requireContext().packageManager.getApplicationLabel(packageName)
-                    val message = requireContext().getString(R.string.toast_prompt_to_enable_sim_toolkit, label)
-                    Toast.makeText(context, message, Toast.LENGTH_LONG).show()
-                }
-                startActivity(intent)
-                true
-            }
+            intent = stk[slotId]?.intent
+            isVisible = intent != null
         }
     }
+
+    override fun onOptionsItemSelected(item: MenuItem) = when (item.itemId) {
+        R.id.open_sim_toolkit -> {
+            SIMToolkit.getDisabledPackageName(item.intent)?.also { packageName ->
+                val label = requireContext().packageManager.getApplicationLabel(packageName)
+                val message = getString(R.string.toast_prompt_to_enable_sim_toolkit, label)
+                Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show()
+            }
+            super.onOptionsItemSelected(item) // handling intent
+        }
+
+        else -> super.onOptionsItemSelected(item)
+    }
 }
 
 private fun PackageManager.getApplicationLabel(packageName: String): CharSequence =
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
index 99824ffe4..f58f76af4 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/SIMToolkit.kt
@@ -7,7 +7,6 @@ import android.content.pm.ActivityInfo
 import android.content.pm.PackageManager
 import android.net.Uri
 import android.provider.Settings
-import android.widget.Toast
 import androidx.annotation.ArrayRes
 import im.angry.easyeuicc.R
 import im.angry.openeuicc.core.EuiccChannelManager
@@ -32,9 +31,10 @@ class SIMToolkit(private val context: Context) {
     data class Slot(private val packageManager: PackageManager, private val components: Set<ComponentName>) {
         private val packageNames: Iterable<String>
             get() = components.map(ComponentName::getPackageName).toSet()
+                .filter(packageManager::isInstalledApp)
 
         private val launchIntent: Intent?
-            get() = packageNames.firstNotNullOfOrNull(packageManager::getLaunchIntent)
+            get() = packageNames.firstNotNullOfOrNull(packageManager::getLaunchIntentForPackage)
 
         private val activities: Iterable<ComponentName>
             get() = packageNames.flatMap(packageManager::getActivities)
@@ -50,23 +50,23 @@ class SIMToolkit(private val context: Context) {
         }
 
         private fun getDisabledPackageIntent(): Intent? {
-            val disabledPackageName = packageNames.find {
-                try {
-                    isDisabledState(packageManager.getApplicationEnabledSetting(it))
-                } catch (_: IllegalArgumentException) {
-                    false
-                }
-            }
-            if (disabledPackageName == null) return null
-            return Intent(
-                Settings.ACTION_APPLICATION_DETAILS_SETTINGS,
-                Uri.fromParts("package", disabledPackageName, null)
-            )
+            val disabledPackageName = packageNames
+                .find { isDisabledState(packageManager.getApplicationEnabledSetting(it)) }
+                ?: return null
+            val uri = Uri.fromParts("package", disabledPackageName, null)
+            return Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS, uri)
         }
 
         val intent: Intent?
             get() = getActivityIntent() ?: getDisabledPackageIntent()
     }
+
+    companion object {
+        fun getDisabledPackageName(intent: Intent?): String? {
+            if (intent?.action != Settings.ACTION_APPLICATION_DETAILS_SETTINGS) return null
+            return intent.data?.schemeSpecificPart
+        }
+    }
 }
 
 private fun isDisabledState(state: Int) = when (state) {
@@ -75,15 +75,12 @@ private fun isDisabledState(state: Int) = when (state) {
     else -> false
 }
 
-private fun PackageManager.getLaunchIntent(packageName: String) = try {
-    getLaunchIntentForPackage(packageName)
+private fun PackageManager.isInstalledApp(packageName: String) = try {
+    getPackageInfo(packageName, 0)
+    true
 } catch (_: PackageManager.NameNotFoundException) {
-    null
+    false
 }
 
-private fun PackageManager.getActivities(packageName: String) = try {
-    getPackageInfo(packageName, PackageManager.GET_ACTIVITIES)
-        .activities?.toList() ?: emptyList()
-} catch (_: PackageManager.NameNotFoundException) {
-    emptyList()
-}
+private fun PackageManager.getActivities(packageName: String) =
+    getPackageInfo(packageName, PackageManager.GET_ACTIVITIES).activities?.toList() ?: emptyList()

From 2eabf719d024e286ba488ba97b9eb4db3c2b81f1 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 16:52:19 +0100
Subject: [PATCH 372/458] refactor: EuiccChannelFragmentUtils (#164)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/164
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/ui/ProfileDeleteFragment.kt     | 24 ++-----
 .../openeuicc/ui/ProfileRenameFragment.kt     | 55 ++++++++--------
 .../util/EuiccChannelFragmentUtils.kt         | 66 ++++++++++++-------
 3 files changed, 77 insertions(+), 68 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
index 7f82f22a8..38d1bc6f1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileDeleteFragment.kt
@@ -20,13 +20,10 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         private const val FIELD_ICCID = "iccid"
         private const val FIELD_NAME = "name"
 
-        fun newInstance(slotId: Int, portId: Int, iccid: String, name: String): ProfileDeleteFragment {
-            val instance = newInstanceEuicc(ProfileDeleteFragment::class.java, slotId, portId)
-            instance.requireArguments().apply {
+        fun newInstance(slotId: Int, portId: Int, iccid: String, name: String) =
+            newInstanceEuicc(ProfileDeleteFragment::class.java, slotId, portId) {
                 putString(FIELD_ICCID, iccid)
                 putString(FIELD_NAME, name)
-            }
-            return instance
         }
     }
 
@@ -91,19 +88,12 @@ class ProfileDeleteFragment : DialogFragment(), EuiccChannelFragmentMarker {
         requireParentFragment().lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-            euiccChannelManagerService.launchProfileDeleteTask(slotId, portId, iccid).onStart {
-                if (parentFragment is EuiccProfilesChangedListener) {
-                    // Trigger a refresh in the parent fragment -- it should wait until
-                    // any foreground task is completed before actually doing a refresh
-                    (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
+            euiccChannelManagerService.launchProfileDeleteTask(slotId, portId, iccid)
+                .onStart {
+                    parentFragment?.notifyEuiccProfilesChanged()
+                    runCatching(::dismiss)
                 }
-
-                try {
-                    dismiss()
-                } catch (e: IllegalStateException) {
-                    // Ignored
-                }
-            }.waitDone()
+                .waitDone()
         }
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index 25c5273e4..c588254c1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -7,6 +7,7 @@ import android.view.View
 import android.view.ViewGroup
 import android.widget.ProgressBar
 import android.widget.Toast
+import androidx.annotation.StringRes
 import androidx.appcompat.widget.Toolbar
 import androidx.lifecycle.lifecycleScope
 import com.google.android.material.textfield.TextInputLayout
@@ -18,16 +19,16 @@ import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragmentMarker {
     companion object {
+        private const val FIELD_ICCID = "iccid"
+        private const val FIELD_CURRENT_NAME = "currentName"
+
         const val TAG = "ProfileRenameFragment"
 
-        fun newInstance(slotId: Int, portId: Int, iccid: String, currentName: String): ProfileRenameFragment {
-            val instance = newInstanceEuicc(ProfileRenameFragment::class.java, slotId, portId)
-            instance.requireArguments().apply {
-                putString("iccid", iccid)
-                putString("currentName", currentName)
+        fun newInstance(slotId: Int, portId: Int, iccid: String, currentName: String) =
+            newInstanceEuicc(ProfileRenameFragment::class.java, slotId, portId) {
+                putString(FIELD_ICCID, iccid)
+                putString(FIELD_CURRENT_NAME, currentName)
             }
-            return instance
-        }
     }
 
     private lateinit var toolbar: Toolbar
@@ -36,6 +37,14 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
 
     private var renaming = false
 
+    private val iccid: String by lazy {
+        requireArguments().getString(FIELD_ICCID)!!
+    }
+
+    private val currentName: String by lazy {
+        requireArguments().getString(FIELD_CURRENT_NAME)!!
+    }
+
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
@@ -54,7 +63,7 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
 
     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
         super.onViewCreated(view, savedInstanceState)
-        profileRenameNewName.editText!!.setText(requireArguments().getString("currentName"))
+        profileRenameNewName.editText!!.setText(currentName)
         toolbar.apply {
             setTitle(R.string.rename)
             setNavigationOnClickListener {
@@ -78,12 +87,8 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         }
     }
 
-    private fun showErrorAndCancel(errorStrRes: Int) {
-        Toast.makeText(
-            requireContext(),
-            errorStrRes,
-            Toast.LENGTH_LONG
-        ).show()
+    private fun showErrorAndCancel(@StringRes resId: Int) {
+        Toast.makeText(requireContext(), resId, Toast.LENGTH_LONG).show()
 
         renaming = false
         progress.visibility = View.GONE
@@ -94,17 +99,15 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         progress.isIndeterminate = true
         progress.visibility = View.VISIBLE
 
+        val newName = profileRenameNewName.editText!!.text.toString().trim()
+
         lifecycleScope.launch {
             ensureEuiccChannelManager()
             euiccChannelManagerService.waitForForegroundTask()
-            val res = euiccChannelManagerService.launchProfileRenameTask(
-                slotId,
-                portId,
-                requireArguments().getString("iccid")!!,
-                profileRenameNewName.editText!!.text.toString().trim()
-            ).waitDone()
+            val response = euiccChannelManagerService
+                .launchProfileRenameTask(slotId, portId, iccid, newName).waitDone()
 
-            when (res) {
+            when (response) {
                 is LocalProfileAssistant.ProfileNameTooLongException -> {
                     showErrorAndCancel(R.string.profile_rename_too_long)
                 }
@@ -118,15 +121,9 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
                 }
 
                 else -> {
-                    if (parentFragment is EuiccProfilesChangedListener) {
-                        (parentFragment as EuiccProfilesChangedListener).onEuiccProfilesChanged()
-                    }
+                    parentFragment?.notifyEuiccProfilesChanged()
 
-                    try {
-                        dismiss()
-                    } catch (e: IllegalStateException) {
-                        // Ignored
-                    }
+                    runCatching(::dismiss)
                 }
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
index 3f3c4ee53..b44bef896 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/EuiccChannelFragmentUtils.kt
@@ -7,43 +7,65 @@ import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.service.EuiccChannelManagerService
 import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 
-interface EuiccChannelFragmentMarker: OpenEuiccContextMarker
+private const val FIELD_SLOT_ID = "slotId"
+private const val FIELD_PORT_ID = "portId"
+
+interface EuiccChannelFragmentMarker : OpenEuiccContextMarker
+
+private typealias BundleSetter = Bundle.() -> Unit
 
 // We must use extension functions because there is no way to add bounds to the type of "self"
 // in the definition of an interface, so the only way is to limit where the extension functions
 // can be applied.
-fun <T> newInstanceEuicc(clazz: Class<T>, slotId: Int, portId: Int, addArguments: Bundle.() -> Unit = {}): T where T: Fragment, T: EuiccChannelFragmentMarker {
-    val instance = clazz.newInstance()
-    instance.arguments = Bundle().apply {
-        putInt("slotId", slotId)
-        putInt("portId", portId)
-        addArguments()
+fun <T> newInstanceEuicc(clazz: Class<T>, slotId: Int, portId: Int, addArguments: BundleSetter = {}): T
+        where T : Fragment, T : EuiccChannelFragmentMarker =
+    clazz.getDeclaredConstructor().newInstance().apply {
+        arguments = Bundle()
+        arguments!!.putInt(FIELD_SLOT_ID, slotId)
+        arguments!!.putInt(FIELD_PORT_ID, portId)
+        arguments!!.addArguments()
     }
-    return instance
-}
 
 // Convenient methods to avoid using `channel` for these
 // `channel` requires that the channel actually exists in EuiccChannelManager, which is
 // not always the case during operations such as switching
-val <T> T.slotId: Int where T: Fragment, T: EuiccChannelFragmentMarker
-    get() = requireArguments().getInt("slotId")
-val <T> T.portId: Int where T: Fragment, T: EuiccChannelFragmentMarker
-    get() = requireArguments().getInt("portId")
-val <T> T.isUsb: Boolean where T: Fragment, T: EuiccChannelFragmentMarker
-    get() = requireArguments().getInt("slotId") == EuiccChannelManager.USB_CHANNEL_ID
+val <T> T.slotId: Int
+        where T : Fragment, T : EuiccChannelFragmentMarker
+    get() = requireArguments().getInt(FIELD_SLOT_ID)
+val <T> T.portId: Int
+        where T : Fragment, T : EuiccChannelFragmentMarker
+    get() = requireArguments().getInt(FIELD_PORT_ID)
+val <T> T.isUsb: Boolean
+        where T : Fragment, T : EuiccChannelFragmentMarker
+    get() = slotId == EuiccChannelManager.USB_CHANNEL_ID
 
-val <T> T.euiccChannelManager: EuiccChannelManager where T: Fragment, T: OpenEuiccContextMarker
-    get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManager
-val <T> T.euiccChannelManagerService: EuiccChannelManagerService where T: Fragment, T: OpenEuiccContextMarker
-    get() = (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerService
+private fun <T> T.requireEuiccActivity(): BaseEuiccAccessActivity
+        where T : Fragment, T : OpenEuiccContextMarker =
+    requireActivity() as BaseEuiccAccessActivity
 
-suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R where T : Fragment, T : EuiccChannelFragmentMarker {
+val <T> T.euiccChannelManager: EuiccChannelManager
+        where T : Fragment, T : OpenEuiccContextMarker
+    get() = requireEuiccActivity().euiccChannelManager
+
+val <T> T.euiccChannelManagerService: EuiccChannelManagerService
+        where T : Fragment, T : OpenEuiccContextMarker
+    get() = requireEuiccActivity().euiccChannelManagerService
+
+suspend fun <T, R> T.withEuiccChannel(fn: suspend (EuiccChannel) -> R): R
+        where T : Fragment, T : EuiccChannelFragmentMarker {
     ensureEuiccChannelManager()
     return euiccChannelManager.withEuiccChannel(slotId, portId, fn)
 }
 
-suspend fun <T> T.ensureEuiccChannelManager() where T: Fragment, T: OpenEuiccContextMarker =
-    (requireActivity() as BaseEuiccAccessActivity).euiccChannelManagerLoaded.await()
+suspend fun <T> T.ensureEuiccChannelManager() where T : Fragment, T : OpenEuiccContextMarker =
+    requireEuiccActivity().euiccChannelManagerLoaded.await()
+
+fun <T> T.notifyEuiccProfilesChanged() where T : Fragment {
+    if (this !is EuiccProfilesChangedListener) return
+    // Trigger a refresh in the parent fragment -- it should wait until
+    // any foreground task is completed before actually doing a refresh
+    this.onEuiccProfilesChanged()
+}
 
 interface EuiccProfilesChangedListener {
     fun onEuiccProfilesChanged()

From 8243914588a41df0d45cb67a1bf33bd0fc308985 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 16:54:53 +0100
Subject: [PATCH 373/458] feat: recent url sharing (#160)

![Screenshot_20250306-135020.png](/attachments/c2932882-72bd-4fb4-8955-e538d2dcd59c)

see https://developer.android.com/guide/components/activities/recents#url-sharing

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/160
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../ui/wizard/DownloadWizardActivity.kt         | 17 +++++++++++++++++
 .../im/angry/openeuicc/util/ActivationCode.kt   | 11 +++++++++++
 2 files changed, 28 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index e342dee6f..8cab18b97 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -1,5 +1,6 @@
 package im.angry.openeuicc.ui.wizard
 
+import android.app.assist.AssistContent
 import android.os.Bundle
 import android.view.View
 import android.view.inputmethod.InputMethodManager
@@ -8,6 +9,7 @@ import android.widget.ProgressBar
 import android.widget.Toast
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.enableEdgeToEdge
+import androidx.core.net.toUri
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
@@ -111,6 +113,21 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         }
     }
 
+    override fun onProvideAssistContent(outContent: AssistContent?) {
+        super.onProvideAssistContent(outContent)
+        outContent?.webUri = try {
+            val activationCode = ActivationCode(
+                state.smdp,
+                state.matchingId,
+                null,
+                state.confirmationCode != null,
+            )
+            "LPA:$activationCode".toUri()
+        } catch (_: Exception) {
+            null
+        }
+    }
+
     override fun onSaveInstanceState(outState: Bundle) {
         super.onSaveInstanceState(outState)
         outState.putString("currentStepFragmentClassName", state.currentStepFragmentClassName)
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
index 3aca0d63c..c21e837ee 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
@@ -20,4 +20,15 @@ data class ActivationCode(
             )
         }
     }
+
+    override fun toString(): String {
+        val parts = arrayOf(
+            "1",
+            address,
+            matchingId ?: "",
+            oid ?: "",
+            if (confirmationCodeRequired) "1" else ""
+        )
+        return parts.joinToString("$").trimEnd('$')
+    }
 }
\ No newline at end of file

From 889b08767ce25cb42cf16ccf5189f70a5086d432 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 11:34:26 -0500
Subject: [PATCH 374/458] Move eUICC vendor handling to an interface in util

...instead of ad-hoc functions
---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   |  15 +--
 .../java/im/angry/openeuicc/util/Vendors.kt   | 112 ++++++++++++++++++
 .../im/angry/openeuicc/vendored/estkme.kt     |  49 --------
 .../im/angry/openeuicc/vendored/simlink.kt    |  20 ----
 4 files changed, 117 insertions(+), 79 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/util/Vendors.kt
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
 delete mode 100644 app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 528b2324d..4e499dc24 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -23,8 +23,6 @@ import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
-import im.angry.openeuicc.vendored.getESTKmeInfo
-import im.angry.openeuicc.vendored.getSIMLinkVersion
 import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
@@ -104,14 +102,11 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(Item(R.string.euicc_info_access_mode, channel.type))
         add(Item(R.string.euicc_info_removable, formatByBoolean(channel.port.card.isRemovable, YES_NO)))
         add(Item(R.string.euicc_info_eid, channel.lpa.eID, copiedToastResId = R.string.toast_eid_copied))
-        getESTKmeInfo(channel.apduInterface)?.let {
-            add(Item(R.string.euicc_info_sku, it.skuName))
-            add(Item(R.string.euicc_info_sn, it.serialNumber, copiedToastResId = R.string.toast_sn_copied))
-            add(Item(R.string.euicc_info_bl_ver, it.bootloaderVersion))
-            add(Item(R.string.euicc_info_fw_ver, it.firmwareVersion))
-        }
-        getSIMLinkVersion(channel.lpa.eID, channel.lpa.euiccInfo2?.euiccFirmwareVersion)?.let {
-            add(Item(R.string.euicc_info_sku, "9eSIM $it"))
+        channel.tryParseEuiccVendorInfo()?.let { vendorInfo ->
+            vendorInfo.skuName?.let { add(Item(R.string.euicc_info_sku, it)) }
+            vendorInfo.serialNumber?.let { add(Item(R.string.euicc_info_sn, it)) }
+            vendorInfo.firmwareVersion?.let { add(Item(R.string.euicc_info_fw_ver, it)) }
+            vendorInfo.bootloaderVersion?.let { add(Item(R.string.euicc_info_bl_ver, it)) }
         }
         channel.lpa.euiccInfo2.let { info ->
             add(Item(R.string.euicc_info_sgp22_version, info?.sgp22Version.toString()))
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Vendors.kt b/app-common/src/main/java/im/angry/openeuicc/util/Vendors.kt
new file mode 100644
index 000000000..529f9ee84
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Vendors.kt
@@ -0,0 +1,112 @@
+package im.angry.openeuicc.util
+
+import android.util.Log
+import im.angry.openeuicc.core.ApduInterfaceAtrProvider
+import im.angry.openeuicc.core.EuiccChannel
+import net.typeblog.lpac_jni.Version
+
+data class EuiccVendorInfo(
+    val skuName: String?,
+    val serialNumber: String?,
+    val bootloaderVersion: String?,
+    val firmwareVersion: String?,
+)
+
+private val EUICC_VENDORS: Array<EuiccVendor> = arrayOf(EstkMe(), SimLink())
+
+fun EuiccChannel.tryParseEuiccVendorInfo(): EuiccVendorInfo? {
+    EUICC_VENDORS.forEach { vendor ->
+        vendor.tryParseEuiccVendorInfo(this@tryParseEuiccVendorInfo)?.let {
+            return it
+        }
+    }
+
+    return null
+}
+
+interface EuiccVendor {
+    fun tryParseEuiccVendorInfo(channel: EuiccChannel): EuiccVendorInfo?
+}
+
+private class EstkMe : EuiccVendor {
+    companion object {
+        private val PRODUCT_AID = "A06573746B6D65FFFFFFFFFFFF6D6774".decodeHex()
+        private val PRODUCT_ATR_FPR = "estk.me".encodeToByteArray()
+    }
+
+    private fun checkAtr(channel: EuiccChannel): Boolean {
+        val iface = channel.apduInterface
+        if (iface !is ApduInterfaceAtrProvider) return false
+        val atr = iface.atr ?: return false
+        for (index in atr.indices) {
+            if (atr.size - index < PRODUCT_ATR_FPR.size) break
+            if (atr.sliceArray(index until index + PRODUCT_ATR_FPR.size)
+                    .contentEquals(PRODUCT_ATR_FPR)
+            ) return true
+        }
+        return false
+    }
+
+    private fun decodeAsn1String(b: ByteArray): String? {
+        if (b.size < 2) return null
+        if (b[b.size - 2] != 0x90.toByte() || b[b.size - 1] != 0x00.toByte()) return null
+        return b.sliceArray(0 until b.size - 2).decodeToString()
+    }
+
+    override fun tryParseEuiccVendorInfo(channel: EuiccChannel): EuiccVendorInfo? {
+        if (!checkAtr(channel)) return null
+
+        val iface = channel.apduInterface
+        return try {
+            iface.withLogicalChannel(PRODUCT_AID) { transmit ->
+                fun invoke(p1: Byte) =
+                    decodeAsn1String(transmit(byteArrayOf(0x00, 0x00, p1, 0x00, 0x00)))
+                EuiccVendorInfo(
+                    skuName = invoke(0x03),
+                    serialNumber = invoke(0x00),
+                    bootloaderVersion = invoke(0x01),
+                    firmwareVersion = invoke(0x02),
+                )
+            }
+        } catch (e: Exception) {
+            Log.d(TAG, "Failed to get ESTKmeInfo", e)
+            null
+        }
+    }
+}
+
+private class SimLink : EuiccVendor {
+    companion object {
+        private val EID_PATTERN = Regex("^89044045(84|21)67274948")
+    }
+
+    override fun tryParseEuiccVendorInfo(channel: EuiccChannel): EuiccVendorInfo? {
+        val eid = channel.lpa.eID
+        val version = channel.lpa.euiccInfo2?.euiccFirmwareVersion
+        if (version == null || EID_PATTERN.find(eid, 0) == null) return null
+        val versionName = when {
+            // @formatter:off
+            version >= Version(37,  1, 41) -> "v3.1 (beta 1)"
+            version >= Version(36, 18,  5) -> "v3 (final)"
+            version >= Version(36, 17, 39) -> "v3 (beta)"
+            version >= Version(36, 17,  4) -> "v2s"
+            version >= Version(36,  9,  3) -> "v2.1"
+            version >= Version(36,  7,  2) -> "v2"
+            // @formatter:on
+            else -> null
+        }
+
+        val skuName = if (versionName == null) {
+            "9eSIM"
+        } else {
+            "9eSIM $versionName"
+        }
+
+        return EuiccVendorInfo(
+            skuName = skuName,
+            serialNumber = null,
+            bootloaderVersion = null,
+            firmwareVersion = null
+        )
+    }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt b/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
deleted file mode 100644
index 228292149..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/vendored/estkme.kt
+++ /dev/null
@@ -1,49 +0,0 @@
-package im.angry.openeuicc.vendored
-
-import android.util.Log
-import im.angry.openeuicc.core.ApduInterfaceAtrProvider
-import im.angry.openeuicc.util.TAG
-import im.angry.openeuicc.util.decodeHex
-import net.typeblog.lpac_jni.ApduInterface
-
-data class ESTKmeInfo(
-    val serialNumber: String?,
-    val bootloaderVersion: String?,
-    val firmwareVersion: String?,
-    val skuName: String?,
-)
-
-fun isESTKmeATR(iface: ApduInterface): Boolean {
-    if (iface !is ApduInterfaceAtrProvider) return false
-    val atr = iface.atr ?: return false
-    val fpr = "estk.me".encodeToByteArray()
-    for (index in atr.indices) {
-        if (atr.size - index < fpr.size) break
-        if (atr.sliceArray(index until index + fpr.size).contentEquals(fpr)) return true
-    }
-    return false
-}
-
-fun getESTKmeInfo(iface: ApduInterface): ESTKmeInfo? {
-    if (!isESTKmeATR(iface)) return null
-    fun decode(b: ByteArray): String? {
-        if (b.size < 2) return null
-        if (b[b.size - 2] != 0x90.toByte() || b[b.size - 1] != 0x00.toByte()) return null
-        return b.sliceArray(0 until b.size - 2).decodeToString()
-    }
-    return try {
-        iface.withLogicalChannel("A06573746B6D65FFFFFFFFFFFF6D6774".decodeHex()) { transmit ->
-            fun invoke(p1: Byte) = decode(transmit(byteArrayOf(0x00, 0x00, p1, 0x00, 0x00)))
-            ESTKmeInfo(
-                invoke(0x00), // serial number
-                invoke(0x01), // bootloader version
-                invoke(0x02), // firmware version
-                invoke(0x03), // sku name
-            )
-        }
-    } catch (e: Exception) {
-        Log.d(TAG, "Failed to get ESTKmeInfo", e)
-        null
-    }
-}
-
diff --git a/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt b/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt
deleted file mode 100644
index 506f16c61..000000000
--- a/app-common/src/main/java/im/angry/openeuicc/vendored/simlink.kt
+++ /dev/null
@@ -1,20 +0,0 @@
-package im.angry.openeuicc.vendored
-
-import net.typeblog.lpac_jni.Version
-
-private val prefix = Regex("^89044045(84|21)67274948") // SIMLink EID prefix
-
-fun getSIMLinkVersion(eid: String, version: Version?): String? {
-    if (version == null || prefix.find(eid, 0) == null) return null
-    return when {
-        // @formatter:off
-        version >= Version(37,  1, 41) -> "v3.1 (beta 1)"
-        version >= Version(36, 18,  5) -> "v3 (final)"
-        version >= Version(36, 17, 39) -> "v3 (beta)"
-        version >= Version(36, 17,  4) -> "v2s"
-        version >= Version(36,  9,  3) -> "v2.1"
-        version >= Version(36,  7,  2) -> "v2"
-        // @formatter:on
-        else -> null
-    }
-}

From c528962f29cf8087838550ed46565d664807dba4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 15:40:30 -0500
Subject: [PATCH 375/458] wizard: Accept deep-links with the LPA: schema

Co-authored-by: septs <github@septs.pw>
---
 app-common/src/main/AndroidManifest.xml       | 15 +++++++-
 .../ui/wizard/DownloadWizardActivity.kt       | 35 ++++++++++++++-----
 .../wizard/DownloadWizardDetailsFragment.kt   |  6 +++-
 .../DownloadWizardSlotSelectFragment.kt       |  6 +++-
 4 files changed, 50 insertions(+), 12 deletions(-)

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index f53e6ffc3..6edaaf13a 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -30,7 +30,20 @@
         <activity
             android:exported="true"
             android:name="im.angry.openeuicc.ui.wizard.DownloadWizardActivity"
-            android:label="@string/download_wizard" />
+            android:label="@string/download_wizard">
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <!-- Accepts URIs that begin with "lpa:" -->
+                <!-- for example: "LPA:1$..." -->
+                <!-- refs: https://www.iana.org/assignments/uri-schemes/prov/lpa -->
+                <data android:scheme="lpa"/>
+                <data android:sspPrefix="1$"/>
+            </intent-filter>
+        </activity>
 
         <activity-alias
             android:exported="true"
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 8cab18b97..01a4d7c28 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -35,6 +35,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var downloadStarted: Boolean,
         var downloadTaskID: Long,
         var downloadError: LocalProfileAssistant.ProfileDownloadException?,
+        var skipMethodSelect: Boolean,
     )
 
     private lateinit var state: DownloadWizardState
@@ -63,17 +64,20 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         })
 
         state = DownloadWizardState(
-            null,
-            intent.getIntExtra("selectedLogicalSlot", 0),
-            "",
-            null,
-            null,
-            null,
-            false,
-            -1,
-            null
+            currentStepFragmentClassName = null,
+            selectedLogicalSlot = intent.getIntExtra("selectedLogicalSlot", 0),
+            smdp = "",
+            matchingId = null,
+            confirmationCode = null,
+            imei = null,
+            downloadStarted = false,
+            downloadTaskID = -1,
+            downloadError = null,
+            skipMethodSelect = false
         )
 
+        handleDeepLink()
+
         progressBar = requireViewById(R.id.progress)
         nextButton = requireViewById(R.id.download_wizard_next)
         prevButton = requireViewById(R.id.download_wizard_back)
@@ -113,6 +117,19 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         }
     }
 
+    private fun handleDeepLink() {
+        // If we get an LPA string from deep-link intents, extract from there.
+        // Note that `onRestoreInstanceState` could override this with user input,
+        // but that _is_ the desired behavior.
+        val uri = intent.data
+        if (uri?.scheme == "lpa") {
+            val parsed = ActivationCode.fromString(uri.schemeSpecificPart)
+            state.smdp = parsed.address
+            state.matchingId = parsed.matchingId
+            state.skipMethodSelect = true
+        }
+    }
+
     override fun onProvideAssistContent(outContent: AssistContent?) {
         super.onProvideAssistContent(outContent)
         outContent?.webUri = try {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index 5fa800220..4a852ecce 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -36,7 +36,11 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         DownloadWizardProgressFragment()
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
-        DownloadWizardMethodSelectFragment()
+        if (state.skipMethodSelect) {
+            DownloadWizardSlotSelectFragment()
+        } else {
+            DownloadWizardMethodSelectFragment()
+        }
 
     override fun onCreateView(
         inflater: LayoutInflater,
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 5510fb05c..28bc9f00e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -49,7 +49,11 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
         get() = true
 
     override fun createNextFragment(): DownloadWizardActivity.DownloadWizardStepFragment =
-        DownloadWizardMethodSelectFragment()
+        if (state.skipMethodSelect) {
+            DownloadWizardDetailsFragment()
+        } else {
+            DownloadWizardMethodSelectFragment()
+        }
 
     override fun createPrevFragment(): DownloadWizardActivity.DownloadWizardStepFragment? = null
 

From e5753ec2d99787bb4a821ab53d1db452122325ab Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 15:45:58 -0500
Subject: [PATCH 376/458] ActivationCode::fromString -> ActivationCode::parse

Un-confusion :D
---
 .../angry/openeuicc/ui/wizard/DownloadWizardActivity.kt   | 3 +--
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt       | 2 +-
 .../main/java/im/angry/openeuicc/util/ActivationCode.kt   | 8 ++++----
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 01a4d7c28..44b74790c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -21,7 +21,6 @@ import im.angry.openeuicc.ui.BaseEuiccAccessActivity
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
-import kotlinx.coroutines.withContext
 import net.typeblog.lpac_jni.LocalProfileAssistant
 
 class DownloadWizardActivity: BaseEuiccAccessActivity() {
@@ -123,7 +122,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         // but that _is_ the desired behavior.
         val uri = intent.data
         if (uri?.scheme == "lpa") {
-            val parsed = ActivationCode.fromString(uri.schemeSpecificPart)
+            val parsed = ActivationCode.parse(uri.schemeSpecificPart)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
             state.skipMethodSelect = true
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 2846fd776..452f1e187 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -126,7 +126,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
     private fun processLpaString(input: String) {
         try {
-            val parsed = ActivationCode.fromString(input)
+            val parsed = ActivationCode.parse(input)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
             if (parsed.confirmationCodeRequired) {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
index c21e837ee..2399b5a24 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
@@ -2,12 +2,12 @@ package im.angry.openeuicc.util
 
 data class ActivationCode(
     val address: String,
-    val matchingId: String? = null,
-    val oid: String? = null,
-    val confirmationCodeRequired: Boolean = false,
+    val matchingId: String?,
+    val oid: String?,
+    val confirmationCodeRequired: Boolean,
 ) {
     companion object {
-        fun fromString(input: String): ActivationCode {
+        fun parse(input: String): ActivationCode {
             val components = input.removePrefix("LPA:").split('$')
             if (components.size < 2 || components[0] != "1") {
                 throw IllegalArgumentException("Invalid activation code format")

From 7edde1ffa438a70c1910126a8551ce6338dc81af Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:05:00 -0500
Subject: [PATCH 377/458] wizard: Rework handling for confirmation code from
 LPA strings

There are more than one way to acquire an LPA string here. Let's just
store whether we need confirmation code as a boolean in state and then
use that to decide whether it is actually required in the step for
inputting details.
---
 .../ui/wizard/DownloadWizardActivity.kt       |  8 +++++++-
 .../wizard/DownloadWizardDetailsFragment.kt   | 16 ++++++++++++++++
 .../DownloadWizardMethodSelectFragment.kt     | 19 ++++++++-----------
 app-common/src/main/res/values-ja/strings.xml |  3 +--
 .../src/main/res/values-zh-rCN/strings.xml    |  3 +--
 .../src/main/res/values-zh-rTW/strings.xml    |  1 +
 app-common/src/main/res/values/strings.xml    |  3 +--
 7 files changed, 35 insertions(+), 18 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 44b74790c..dfbe17da4 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -35,6 +35,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         var downloadTaskID: Long,
         var downloadError: LocalProfileAssistant.ProfileDownloadException?,
         var skipMethodSelect: Boolean,
+        var confirmationCodeRequired: Boolean,
     )
 
     private lateinit var state: DownloadWizardState
@@ -72,7 +73,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             downloadStarted = false,
             downloadTaskID = -1,
             downloadError = null,
-            skipMethodSelect = false
+            skipMethodSelect = false,
+            confirmationCodeRequired = false,
         )
 
         handleDeepLink()
@@ -125,6 +127,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
             val parsed = ActivationCode.parse(uri.schemeSpecificPart)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
+            state.confirmationCodeRequired = parsed.confirmationCodeRequired
             state.skipMethodSelect = true
         }
     }
@@ -154,6 +157,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         outState.putString("imei", state.imei)
         outState.putBoolean("downloadStarted", state.downloadStarted)
         outState.putLong("downloadTaskID", state.downloadTaskID)
+        outState.putBoolean("confirmationCodeRequired", state.confirmationCodeRequired)
     }
 
     override fun onRestoreInstanceState(savedInstanceState: Bundle) {
@@ -170,6 +174,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         state.downloadStarted =
             savedInstanceState.getBoolean("downloadStarted", state.downloadStarted)
         state.downloadTaskID = savedInstanceState.getLong("downloadTaskID", state.downloadTaskID)
+        state.confirmationCode = savedInstanceState.getString("confirmationCode", state.confirmationCode)
+        state.confirmationCodeRequired = savedInstanceState.getBoolean("confirmationCodeRequired", state.confirmationCodeRequired)
     }
 
     private fun onPrevPressed() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index 4a852ecce..402e7a523 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -5,6 +5,7 @@ import android.util.Patterns
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
+import android.widget.Toast
 import androidx.core.widget.addTextChangedListener
 import com.google.android.material.textfield.TextInputLayout
 import im.angry.openeuicc.common.R
@@ -55,6 +56,9 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         smdp.editText!!.addTextChangedListener {
             updateInputCompleteness()
         }
+        confirmationCode.editText!!.addTextChangedListener {
+            updateInputCompleteness()
+        }
         return view
     }
 
@@ -65,6 +69,15 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
         confirmationCode.editText!!.setText(state.confirmationCode)
         imei.editText!!.setText(state.imei)
         updateInputCompleteness()
+
+        if (state.confirmationCodeRequired) {
+            confirmationCode.editText!!.requestFocus()
+            confirmationCode.editText!!.hint =
+                getString(R.string.profile_download_confirmation_code_required)
+        } else {
+            confirmationCode.editText!!.hint =
+                getString(R.string.profile_download_confirmation_code)
+        }
     }
 
     override fun onPause() {
@@ -74,6 +87,9 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
 
     private fun updateInputCompleteness() {
         inputComplete = Patterns.DOMAIN_NAME.matcher(smdp.editText!!.text).matches()
+        if (state.confirmationCodeRequired) {
+            inputComplete = inputComplete && confirmationCode.editText!!.text.isNotEmpty()
+        }
         refreshButtons()
     }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 452f1e187..85d75b33a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -129,15 +129,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
             val parsed = ActivationCode.parse(input)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
-            if (parsed.confirmationCodeRequired) {
-                AlertDialog.Builder(requireContext()).apply {
-                    setTitle(R.string.profile_download_required_confirmation_code)
-                    setMessage(R.string.profile_download_required_confirmation_code_message)
-                    setCancelable(true)
-                    setPositiveButton(android.R.string.ok, null)
-                    show()
-                }
-            }
+            state.confirmationCodeRequired = parsed.confirmationCodeRequired
             gotoNextFragment(DownloadWizardDetailsFragment())
         } catch (e: IllegalArgumentException) {
             AlertDialog.Builder(requireContext()).apply {
@@ -150,14 +142,19 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         }
     }
 
-    private class DownloadMethodViewHolder(private val root: View) : ViewHolder(root) {
+    private inner class DownloadMethodViewHolder(private val root: View) : ViewHolder(root) {
         private val icon = root.requireViewById<ImageView>(R.id.download_method_icon)
         private val title = root.requireViewById<TextView>(R.id.download_method_title)
 
         fun bind(item: DownloadMethod) {
             icon.setImageResource(item.iconRes)
             title.setText(item.titleRes)
-            root.setOnClickListener { item.onClick() }
+            root.setOnClickListener {
+                // If the user elected to use another download method, reset the confirmation code flag
+                // too
+                state.confirmationCodeRequired = false
+                item.onClick()
+            }
         }
     }
 
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index e4969c1f7..df7267484 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -42,12 +42,11 @@
     <string name="profile_download_server">サーバー (RSP / SM-DP+)</string>
     <string name="profile_download_code">アクティベーションコード</string>
     <string name="profile_download_confirmation_code">確認コード (オプション)</string>
+    <string name="profile_download_confirmation_code_required">確認コード (必須)</string>
     <string name="profile_download_imei">IMEI (オプション)</string>
     <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
     <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
     <string name="profile_download_no_lpa_string">クリップボードに LPA コードがありません</string>
-    <string name="profile_download_required_confirmation_code">確認コードが必要です</string>
-    <string name="profile_download_required_confirmation_code_message">クリップボードからスキャンした QR コードまたは LPA コードに必要な確認コードを入力してください。</string>
     <string name="profile_download_incorrect_lpa_string">解析できません</string>
     <string name="profile_download_incorrect_lpa_string_message">QR コードまたはクリップボードの内容を LPA コードとして解析できませんでした。</string>
     <string name="download_wizard">ダウンロードウィザード</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 2cadc03db..de020460f 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -37,6 +37,7 @@
     <string name="profile_download_server">服务器 (RSP / SM-DP+)</string>
     <string name="profile_download_code">激活码</string>
     <string name="profile_download_confirmation_code">确认码 (可选)</string>
+    <string name="profile_download_confirmation_code_required">确认码 (必需)</string>
     <string name="profile_download_imei">IMEI (可选)</string>
     <string name="profile_download_low_nvram_title">本次下载可能会失败</string>
     <string name="profile_download_low_nvram_message">当前芯片的剩余空间不足，可能导致配置下载失败。\n是否继续下载？</string>
@@ -144,6 +145,4 @@
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
     <string name="information_unavailable">无信息</string>
-    <string name="profile_download_required_confirmation_code">需要确认码</string>
-    <string name="profile_download_required_confirmation_code_message">您扫描的二维码或粘贴的 LPA 码需要一个额外的确认码</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 28691a0cc..d133d2b66 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -37,6 +37,7 @@
     <string name="profile_download_server">伺服器 (RSP / SM-DP+)</string>
     <string name="profile_download_code">啟用碼</string>
     <string name="profile_download_confirmation_code">確認碼 (可選)</string>
+    <string name="profile_download_confirmation_code_required">確認碼 (必需)</string>
     <string name="profile_download_imei">IMEI (可選)</string>
     <string name="profile_download_low_nvram_title">本次下載可能會失敗</string>
     <string name="profile_download_low_nvram_message">目前晶片的剩餘空間不足，可能導致配置下載失敗。\n是否繼續下載？</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a45ce1f6c..990e62930 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -53,13 +53,12 @@
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>
     <string name="profile_download_code">Activation Code</string>
     <string name="profile_download_confirmation_code">Confirmation Code (Optional)</string>
+    <string name="profile_download_confirmation_code_required">Confirmation Code (Required)</string>
     <string name="profile_download_imei">IMEI (Optional)</string>
 
     <string name="profile_download_low_nvram_title">This download may fail</string>
     <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
     <string name="profile_download_no_lpa_string">No LPA code found in clipboard</string>
-    <string name="profile_download_required_confirmation_code">Confirmation Code Required</string>
-    <string name="profile_download_required_confirmation_code_message">Please provide a confirmation code as required by the scanned QR code or LPA code from clipboard.</string>
     <string name="profile_download_incorrect_lpa_string">Unable to parse</string>
     <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as a LPA code.</string>
 

From 2b86d719ddcc34ee1e3597e3992a3d522891fb71 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:07:41 -0500
Subject: [PATCH 378/458] ActivationCode -> LPAString

Un-confuse myself.... The term "ActivationCode" is too overloaded even
within OpenEUICC itself.
---
 .../im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt  | 4 ++--
 .../ui/wizard/DownloadWizardMethodSelectFragment.kt         | 2 +-
 .../openeuicc/util/{ActivationCode.kt => LPAString.kt}      | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)
 rename app-common/src/main/java/im/angry/openeuicc/util/{ActivationCode.kt => LPAString.kt} (89%)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index dfbe17da4..a9f868f02 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -124,7 +124,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         // but that _is_ the desired behavior.
         val uri = intent.data
         if (uri?.scheme == "lpa") {
-            val parsed = ActivationCode.parse(uri.schemeSpecificPart)
+            val parsed = LPAString.parse(uri.schemeSpecificPart)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
             state.confirmationCodeRequired = parsed.confirmationCodeRequired
@@ -135,7 +135,7 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
     override fun onProvideAssistContent(outContent: AssistContent?) {
         super.onProvideAssistContent(outContent)
         outContent?.webUri = try {
-            val activationCode = ActivationCode(
+            val activationCode = LPAString(
                 state.smdp,
                 state.matchingId,
                 null,
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 85d75b33a..90fdb3306 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -126,7 +126,7 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
     private fun processLpaString(input: String) {
         try {
-            val parsed = ActivationCode.parse(input)
+            val parsed = LPAString.parse(input)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId
             state.confirmationCodeRequired = parsed.confirmationCodeRequired
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
similarity index 89%
rename from app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
rename to app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
index 2399b5a24..20956fb52 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/ActivationCode.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
@@ -1,18 +1,18 @@
 package im.angry.openeuicc.util
 
-data class ActivationCode(
+data class LPAString(
     val address: String,
     val matchingId: String?,
     val oid: String?,
     val confirmationCodeRequired: Boolean,
 ) {
     companion object {
-        fun parse(input: String): ActivationCode {
+        fun parse(input: String): LPAString {
             val components = input.removePrefix("LPA:").split('$')
             if (components.size < 2 || components[0] != "1") {
                 throw IllegalArgumentException("Invalid activation code format")
             }
-            return ActivationCode(
+            return LPAString(
                 address = components[1].trim(),
                 matchingId = components.getOrNull(2)?.trim()?.ifBlank { null },
                 oid = components.getOrNull(3)?.trim()?.ifBlank { null },

From 6557ce45a749ed99f9e78f0412e88b492412aafd Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:09:47 -0500
Subject: [PATCH 379/458] i18n: Update alert for low NVRAM

---
 app-common/src/main/res/values-ja/strings.xml     | 2 +-
 app-common/src/main/res/values-zh-rCN/strings.xml | 2 +-
 app-common/src/main/res/values-zh-rTW/strings.xml | 2 +-
 app-common/src/main/res/values/strings.xml        | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index df7267484..22b8a4c22 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -44,7 +44,7 @@
     <string name="profile_download_confirmation_code">確認コード (オプション)</string>
     <string name="profile_download_confirmation_code_required">確認コード (必須)</string>
     <string name="profile_download_imei">IMEI (オプション)</string>
-    <string name="profile_download_low_nvram_title">ダウンロードに失敗する可能性があります</string>
+    <string name="profile_download_low_nvram_title">残り容量が少ない</string>
     <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
     <string name="profile_download_no_lpa_string">クリップボードに LPA コードがありません</string>
     <string name="profile_download_incorrect_lpa_string">解析できません</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index de020460f..9fa27f409 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -39,7 +39,7 @@
     <string name="profile_download_confirmation_code">确认码 (可选)</string>
     <string name="profile_download_confirmation_code_required">确认码 (必需)</string>
     <string name="profile_download_imei">IMEI (可选)</string>
-    <string name="profile_download_low_nvram_title">本次下载可能会失败</string>
+    <string name="profile_download_low_nvram_title">剩余空间不足</string>
     <string name="profile_download_low_nvram_message">当前芯片的剩余空间不足，可能导致配置下载失败。\n是否继续下载？</string>
     <string name="logs_saved_message">日志已保存到指定路径。需要通过其他 App 分享吗？</string>
     <string name="profile_rename_new_name">新昵称</string>
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index d133d2b66..1b076b254 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -39,7 +39,7 @@
     <string name="profile_download_confirmation_code">確認碼 (可選)</string>
     <string name="profile_download_confirmation_code_required">確認碼 (必需)</string>
     <string name="profile_download_imei">IMEI (可選)</string>
-    <string name="profile_download_low_nvram_title">本次下載可能會失敗</string>
+    <string name="profile_download_low_nvram_title">剩餘空間不足</string>
     <string name="profile_download_low_nvram_message">目前晶片的剩餘空間不足，可能導致配置下載失敗。\n是否繼續下載？</string>
     <string name="logs_saved_message">日誌已儲存到指定路徑。需要透過其他 App 分享嗎？</string>
     <string name="profile_rename_new_name">新名稱</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 990e62930..d6e1781dd 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -56,8 +56,8 @@
     <string name="profile_download_confirmation_code_required">Confirmation Code (Required)</string>
     <string name="profile_download_imei">IMEI (Optional)</string>
 
-    <string name="profile_download_low_nvram_title">This download may fail</string>
-    <string name="profile_download_low_nvram_message">This download may fail due to low remaining capacity.</string>
+    <string name="profile_download_low_nvram_title">Low remaining capacity</string>
+    <string name="profile_download_low_nvram_message">This profile may fail to download due to low remaining capacity.</string>
     <string name="profile_download_no_lpa_string">No LPA code found in clipboard</string>
     <string name="profile_download_incorrect_lpa_string">Unable to parse</string>
     <string name="profile_download_incorrect_lpa_string_message">Could not parse QR code or clipboard content as a LPA code.</string>

From 53f9459aed7ba760b1c19ac0dec345c0815aa4cc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:14:37 -0500
Subject: [PATCH 380/458] i18n: Update missing translations

---
 app-common/src/main/res/values-zh-rCN/strings.xml | 5 +++++
 app-common/src/main/res/values-zh-rTW/strings.xml | 5 +++++
 app-common/src/main/res/values/strings.xml        | 2 +-
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 9fa27f409..e255d9a8b 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -37,6 +37,11 @@
     <string name="profile_download_server">服务器 (RSP / SM-DP+)</string>
     <string name="profile_download_code">激活码</string>
     <string name="profile_download_confirmation_code">确认码 (可选)</string>
+    <string name="toast_sn_copied">已复制序列号到剪贴板</string>
+    <string name="euicc_info_sku">产品名称</string>
+    <string name="euicc_info_sn">产品序列号</string>
+    <string name="euicc_info_bl_ver">产品 Bootloader 版本</string>
+    <string name="euicc_info_fw_ver">产品固件版本</string>
     <string name="profile_download_confirmation_code_required">确认码 (必需)</string>
     <string name="profile_download_imei">IMEI (可选)</string>
     <string name="profile_download_low_nvram_title">剩余空间不足</string>
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 1b076b254..b8c94b5e8 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -37,6 +37,11 @@
     <string name="profile_download_server">伺服器 (RSP / SM-DP+)</string>
     <string name="profile_download_code">啟用碼</string>
     <string name="profile_download_confirmation_code">確認碼 (可選)</string>
+    <string name="toast_sn_copied">已複製序號到剪貼簿</string>
+    <string name="euicc_info_sku">產品名稱</string>
+    <string name="euicc_info_sn">產品序號</string>
+    <string name="euicc_info_bl_ver">產品引導程式版本</string>
+    <string name="euicc_info_fw_ver">產品韌體版本</string>
     <string name="profile_download_confirmation_code_required">確認碼 (必需)</string>
     <string name="profile_download_imei">IMEI (可選)</string>
     <string name="profile_download_low_nvram_title">剩餘空間不足</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d6e1781dd..8a0ac24f2 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -31,7 +31,7 @@
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
-    <string name="toast_sn_copied">Serial Number copied to clipboard</string>
+    <string name="toast_sn_copied">Serial number copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>
     <string name="toast_atr_copied">ATR copied to clipboard</string>
 

From d3df70501a9e99d28a830558cdb7f9234861965d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:27:36 -0500
Subject: [PATCH 381/458] wizard: Make sure bitmaps are recycled properly

Co-authored-by: septs <github@septs.pw>
---
 .../wizard/DownloadWizardMethodSelectFragment.kt  | 15 ++++++---------
 .../main/java/im/angry/openeuicc/util/Utils.kt    |  7 +++++++
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 90fdb3306..0ae330e98 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -44,17 +44,14 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
 
             lifecycleScope.launch(Dispatchers.IO) {
                 runCatching {
-                    requireContext().contentResolver.openInputStream(result)?.let { input ->
-                        val bmp = BitmapFactory.decodeStream(input)
-                        input.close()
-
-                        decodeQrFromBitmap(bmp)?.let {
-                            withContext(Dispatchers.Main) {
-                                processLpaString(it)
+                    requireContext().contentResolver.openInputStream(result)?.use { input ->
+                        BitmapFactory.decodeStream(input).use { bmp ->
+                            decodeQrFromBitmap(bmp)?.let {
+                                withContext(Dispatchers.Main) {
+                                    processLpaString(it)
+                                }
                             }
                         }
-
-                        bmp.recycle()
                     }
                 }
             }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 444c17692..5a559f976 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -86,6 +86,13 @@ suspend fun connectSEService(context: Context): SEService = suspendCoroutine { c
     }
 }
 
+inline fun <T> Bitmap.use(f: (Bitmap) -> T): T =
+    try {
+        f(this)
+    } finally {
+        recycle()
+    }
+
 fun decodeQrFromBitmap(bmp: Bitmap): String? =
      runCatching {
         val pixels = IntArray(bmp.width * bmp.height)

From db8063cd5fd0347767ba77e388b0c29b53198d8a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 16:42:48 -0500
Subject: [PATCH 382/458] wizard: Reduce nested closures

---
 .../wizard/DownloadWizardMethodSelectFragment.kt | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
index 0ae330e98..4b02b7a19 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardMethodSelectFragment.kt
@@ -42,18 +42,16 @@ class DownloadWizardMethodSelectFragment : DownloadWizardActivity.DownloadWizard
         registerForActivityResult(ActivityResultContracts.GetContent()) { result ->
             if (result == null) return@registerForActivityResult
 
-            lifecycleScope.launch(Dispatchers.IO) {
-                runCatching {
-                    requireContext().contentResolver.openInputStream(result)?.use { input ->
-                        BitmapFactory.decodeStream(input).use { bmp ->
-                            decodeQrFromBitmap(bmp)?.let {
-                                withContext(Dispatchers.Main) {
-                                    processLpaString(it)
-                                }
-                            }
+            lifecycleScope.launch {
+                val decoded = withContext(Dispatchers.IO) {
+                    runCatching {
+                        requireContext().contentResolver.openInputStream(result)?.use { input ->
+                            BitmapFactory.decodeStream(input).use(::decodeQrFromBitmap)
                         }
                     }
                 }
+
+                decoded.getOrNull()?.let { processLpaString(it) }
             }
         }
 

From ece231f17ba851f4dfec2d2770944ff3ce1303d0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 17:05:52 -0500
Subject: [PATCH 383/458] lpac-jni: Run `euicc_http_cleanup()` on success

---
 libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
index 028e30d10..bae2ee8a7 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/lpac-download.c
@@ -126,8 +126,11 @@ Java_net_typeblog_lpac_1jni_LpacJni_downloadProfile(JNIEnv *env, jobject thiz, j
     syslog(LOG_INFO, "es10b_load_bound_profile_package %d, reason %d", ret, es10b_load_bound_profile_package_result.errorReason);
     if (ret < 0) {
         ret = - (int) es10b_load_bound_profile_package_result.errorReason;
+        goto out;
     }
 
+    euicc_http_cleanup(ctx);
+
     out:
     // We expect Java side to call cancelSessions after any error -- thus, `euicc_http_cleanup` is done there
     // This is so that Java side can access the last HTTP and/or APDU errors when we return.

From 17102be7cbda1c05a3e6543ad7a03677b7175b27 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 17:25:26 -0500
Subject: [PATCH 384/458] feat: Allow forcing the use of TelephonyManager
 everywhere

Manual merge of #139, but removed all reference to "TMAPI" because such
a term does not exist.

Also reworked PreferenceRepository to allow extensibility from the
privileged app.
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt     |  2 +-
 .../im/angry/openeuicc/util/PreferenceUtils.kt    |  4 ++--
 app-common/src/main/res/xml/pref_settings.xml     |  4 ++--
 .../core/PrivilegedEuiccChannelFactory.kt         |  3 ++-
 .../angry/openeuicc/di/PrivilegedAppContainer.kt  |  5 +++++
 .../openeuicc/ui/PrivilegedSettingsFragment.kt    | 10 ++++++++++
 .../util/PrivilegedPreferenceRepository.kt        | 15 +++++++++++++++
 app/src/main/res/values-ja/strings.xml            |  2 ++
 app/src/main/res/values-zh-rCN/strings.xml        |  2 ++
 app/src/main/res/values-zh-rTW/strings.xml        |  2 ++
 app/src/main/res/values/strings.xml               |  4 ++++
 app/src/main/res/xml/pref_privileged_settings.xml | 12 ++++++++++++
 12 files changed, 59 insertions(+), 6 deletions(-)
 create mode 100644 app/src/main/java/im/angry/openeuicc/util/PrivilegedPreferenceRepository.kt
 create mode 100644 app/src/main/res/xml/pref_privileged_settings.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index fab680f2a..c54d6a185 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -122,7 +122,7 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         return true
     }
 
-    private fun CheckBoxPreference.bindBooleanFlow(flow: PreferenceFlowWrapper<Boolean>) {
+    protected fun CheckBoxPreference.bindBooleanFlow(flow: PreferenceFlowWrapper<Boolean>) {
         lifecycleScope.launch {
             flow.collect { isChecked = it }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index f5e3ca2c1..3c7bbf4f5 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -35,7 +35,7 @@ internal object PreferenceKeys {
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
 }
 
-class PreferenceRepository(private val context: Context) {
+open class PreferenceRepository(private val context: Context) {
     // Expose flows so that we can also handle default values
     // ---- Profile Notifications ----
     val notificationDownloadFlow = bindFlow(PreferenceKeys.NOTIFICATION_DOWNLOAD, true)
@@ -51,7 +51,7 @@ class PreferenceRepository(private val context: Context) {
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
 
-    private fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): PreferenceFlowWrapper<T> =
+    protected fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): PreferenceFlowWrapper<T> =
         PreferenceFlowWrapper(context, key, defaultValue)
 }
 
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index bb5bd5050..944bd27b9 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -52,7 +52,7 @@
 
     </PreferenceCategory>
 
-    <PreferenceCategory
+    <im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory
         app:key="pref_developer"
         app:title="@string/pref_developer"
         app:iconSpaceReserved="false">
@@ -69,7 +69,7 @@
             app:summary="@string/pref_developer_ignore_tls_certificate_desc"
             app:title="@string/pref_developer_ignore_tls_certificate" />
 
-    </PreferenceCategory>
+    </im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory>
 
     <PreferenceCategory
         app:key="pref_info"
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index b690c794d..2044c02ee 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -5,6 +5,7 @@ import android.util.Log
 import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
+import kotlinx.coroutines.flow.first
 import java.lang.IllegalArgumentException
 
 class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFactory(context) {
@@ -21,7 +22,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
             super.tryOpenEuiccChannel(port)?.let { return it }
         }
 
-        if (port.card.isEuicc) {
+        if (port.card.isEuicc || (context.preferenceRepository as PrivilegedPreferenceRepository).removableTelephonyManagerFlow.first()) {
             Log.i(
                 DefaultEuiccChannelManager.TAG,
                 "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
diff --git a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
index d821e6841..08b3cf434 100644
--- a/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
+++ b/app/src/main/java/im/angry/openeuicc/di/PrivilegedAppContainer.kt
@@ -6,6 +6,7 @@ import im.angry.openeuicc.core.EuiccChannelManagerFactory
 import im.angry.openeuicc.core.PrivilegedEuiccChannelFactory
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManager
 import im.angry.openeuicc.core.PrivilegedEuiccChannelManagerFactory
+import im.angry.openeuicc.util.*
 
 class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val euiccChannelManager: EuiccChannelManager by lazy {
@@ -27,4 +28,8 @@ class PrivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val customizableTextProvider by lazy {
         PrivilegedCustomizableTextProvider(context)
     }
+
+    override val preferenceRepository by lazy {
+        PrivilegedPreferenceRepository(context)
+    }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
index 3306c7335..7229688b3 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
@@ -1,11 +1,17 @@
 package im.angry.openeuicc.ui
 
 import android.os.Bundle
+import androidx.preference.CheckBoxPreference
 import androidx.preference.Preference
+import im.angry.openeuicc.R
+import im.angry.openeuicc.util.*
 
 class PrivilegedSettingsFragment : SettingsFragment() {
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         super.onCreatePreferences(savedInstanceState, rootKey)
+        addPreferencesFromResource(R.xml.pref_privileged_settings)
+        mergePreferenceOverlay("pref_developer_overlay", "pref_developer")
+
         // It's stupid to _disable_ things for privileged, but for now, the per-app locale picker
         // is not usable for apps signed with the platform key.
         // ref: <https://android.googlesource.com/platform/packages/apps/Settings/+/refs/tags/android-15.0.0_r6/src/com/android/settings/applications/AppLocaleUtil.java#60>
@@ -13,5 +19,9 @@ class PrivilegedSettingsFragment : SettingsFragment() {
         // eventually work for platform-signed apps. Or, at some point we might introduce our own
         // locale picker, which hopefully works whether privileged or not.
         requirePreference<Preference>("pref_advanced_language").isVisible = false
+
+        // Force use TelephonyManager API
+        requirePreference<CheckBoxPreference>("pref_developer_tmapi_removable")
+            .bindBooleanFlow((preferenceRepository as PrivilegedPreferenceRepository).removableTelephonyManagerFlow)
     }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedPreferenceRepository.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedPreferenceRepository.kt
new file mode 100644
index 000000000..9e1ffcc94
--- /dev/null
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedPreferenceRepository.kt
@@ -0,0 +1,15 @@
+package im.angry.openeuicc.util
+
+import android.content.Context
+import androidx.datastore.preferences.core.booleanPreferencesKey
+
+internal object PrivilegedPreferenceKeys {
+    // ---- Developer Options ----
+    val REMOVABLE_TELEPHONY_MANAGER = booleanPreferencesKey("removable_telephony_manager")
+}
+
+class PrivilegedPreferenceRepository(context: Context) : PreferenceRepository(context) {
+    // ---- Developer Options ----
+    val removableTelephonyManagerFlow =
+        bindFlow(PrivilegedPreferenceKeys.REMOVABLE_TELEPHONY_MANAGER, false)
+}
\ No newline at end of file
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
index 29f3ef6dd..acc1728fe 100644
--- a/app/src/main/res/values-ja/strings.xml
+++ b/app/src/main/res/values-ja/strings.xml
@@ -17,4 +17,6 @@
     <string name="lui_desc">使用しているデバイスは eSIM をサポートしています。モバイルネットワークに接続するには通信事業者が発行した eSIM をダウンロードするか、物理 SIM を挿入してください。</string>
     <string name="lui_skip">スキップ</string>
     <string name="lui_download">eSIM をダウンロード</string>
+    <string name="pref_developer_telephony_manager_removable">TelephonyManagerをどこでも使用</string>
+    <string name="pref_developer_telephony_manager_removable_desc">デフォルトでは、非特権モード (EasyEUICC) と一致するように、取り外し可能な eUICC に対して OMAPI のみが試行されます。これは、一部のデバイスではうまく機能しない可能性があります。このオプションを選択する場合、取り外し可能な eUICC でも TelephonyManager を使用することになります。</string>
 </resources>
diff --git a/app/src/main/res/values-zh-rCN/strings.xml b/app/src/main/res/values-zh-rCN/strings.xml
index 18497b267..d6befc2d2 100644
--- a/app/src/main/res/values-zh-rCN/strings.xml
+++ b/app/src/main/res/values-zh-rCN/strings.xml
@@ -17,4 +17,6 @@
     <string name="lui_skip">跳过</string>
     <string name="lui_download">下载 eSIM</string>
     <string name="telephony_manager">TelephonyManager (特权)</string>
+    <string name="pref_developer_telephony_manager_removable">全局使用 TelephonyManager</string>
+    <string name="pref_developer_telephony_manager_removable_desc">在默认情况下，可移除 eUICC 将仅使用 OMAPI。这与非特权模式 (EasyEUICC) 一致。在某些设备上 OMAPI 可能存在问题 -- 选择此选项以强制使用 TelephonyManager。</string>
 </resources>
\ No newline at end of file
diff --git a/app/src/main/res/values-zh-rTW/strings.xml b/app/src/main/res/values-zh-rTW/strings.xml
index 368efbc60..10285d3cd 100644
--- a/app/src/main/res/values-zh-rTW/strings.xml
+++ b/app/src/main/res/values-zh-rTW/strings.xml
@@ -17,4 +17,6 @@
     <string name="lui_skip">跳過</string>
     <string name="lui_download">下載 eSIM</string>
     <string name="telephony_manager">TelephonyManager (特權)</string>
+    <string name="pref_developer_telephony_manager_removable">全域使用 TelephonyManager</string>
+    <string name="pref_developer_telephony_manager_removable_desc">在預設情況下，可移除 eUICC 將僅使用 OMAPI。這與非特權模式 (EasyEUICC) 一致。在某些裝置上 OMAPI 可能有問題 -- 選擇此選項以強制使用 TelephonyManager。</string>
 </resources>
\ No newline at end of file
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 47c88bdd0..ddf17e40e 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -22,4 +22,8 @@
     <string name="lui_desc">Your device supports eSIMs. To connect to mobile network, download your eSIM issued by a carrier, or insert a physical SIM.</string>
     <string name="lui_skip">Skip</string>
     <string name="lui_download">Download eSIM</string>
+
+    <!-- Preference -->
+    <string name="pref_developer_telephony_manager_removable">Use TelephonyManager everywhere</string>
+    <string name="pref_developer_telephony_manager_removable_desc">By default, only OMAPI is attempted for removable eUICCs to match what is done in unprivileged mode (i.e. EasyEUICC). This may not work well on some devices. Select this option to force the use of TelephonyManager even for removable eUICCs.</string>
 </resources>
\ No newline at end of file
diff --git a/app/src/main/res/xml/pref_privileged_settings.xml b/app/src/main/res/xml/pref_privileged_settings.xml
new file mode 100644
index 000000000..339233bc4
--- /dev/null
+++ b/app/src/main/res/xml/pref_privileged_settings.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto">
+    <PreferenceCategory
+        app:isPreferenceVisible="false"
+        app:key="pref_developer_overlay">
+        <CheckBoxPreference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_tmapi_removable"
+            app:summary="@string/pref_developer_telephony_manager_removable_desc"
+            app:title="@string/pref_developer_telephony_manager_removable" />
+    </PreferenceCategory>
+</PreferenceScreen>
\ No newline at end of file

From 5dd9eed4feebf18f0e49f155456d63f0bcbfd115 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sat, 8 Mar 2025 20:26:30 -0500
Subject: [PATCH 385/458] feat: euicc memory reset

peter: Adjusted strings and i18n translation. Also removed the arbitrary
limit on USB channels -- this is a developer option anyway.
---
 .../service/EuiccChannelManagerService.kt     |  15 +++
 .../openeuicc/ui/EuiccManagementFragment.kt   |  57 +++++---
 .../openeuicc/ui/EuiccMemoryResetFragment.kt  | 126 ++++++++++++++++++
 .../im/angry/openeuicc/ui/SettingsFragment.kt |   6 +
 .../angry/openeuicc/util/PreferenceUtils.kt   |   2 +
 .../res/drawable/ic_euicc_memory_reset.xml    |  18 +++
 .../src/main/res/menu/fragment_euicc.xml      |   5 +
 app-common/src/main/res/values-ja/strings.xml |  12 ++
 .../src/main/res/values-zh-rCN/strings.xml    |  12 ++
 .../src/main/res/values-zh-rTW/strings.xml    |  12 ++
 app-common/src/main/res/values/strings.xml    |  13 ++
 app-common/src/main/res/xml/pref_settings.xml |   7 +
 12 files changed, 264 insertions(+), 21 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/EuiccMemoryResetFragment.kt
 create mode 100644 app-common/src/main/res/drawable/ic_euicc_memory_reset.xml

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 760f1af86..52943d87e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -495,4 +495,19 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                 preferenceRepository.notificationSwitchFlow.first()
             }
         }
+
+    fun launchMemoryReset(slotId: Int, portId: Int): ForegroundTaskSubscriberFlow =
+        launchForegroundTask(
+            getString(R.string.task_euicc_memory_reset),
+            getString(R.string.task_euicc_memory_reset_failure),
+            R.drawable.ic_euicc_memory_reset
+        ) {
+            euiccChannelManager.beginTrackedOperation(slotId, portId) {
+                euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                    channel.lpa.euiccMemoryReset()
+                }
+
+                preferenceRepository.euiccMemoryResetFlow.first()
+            }
+        }
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 842f4ec7d..12995ff70 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -38,8 +38,10 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.launch
+import kotlinx.coroutines.runBlocking
 import kotlinx.coroutines.withContext
 
 open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
@@ -55,6 +57,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
     private lateinit var fab: FloatingActionButton
     private lateinit var profileList: RecyclerView
     private var logicalSlotId: Int = -1
+    private lateinit var eid: String
 
     private val adapter = EuiccProfileAdapter()
 
@@ -131,31 +134,42 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         inflater.inflate(R.menu.fragment_euicc, menu)
     }
 
-    override fun onOptionsItemSelected(item: MenuItem): Boolean =
-        when (item.itemId) {
-            R.id.show_notifications -> {
-                if (logicalSlotId != -1) {
-                    Intent(requireContext(), NotificationsActivity::class.java).apply {
-                        putExtra("logicalSlotId", logicalSlotId)
-                        startActivity(this)
-                    }
-                }
-                true
-            }
+    override fun onPrepareOptionsMenu(menu: Menu) {
+        super.onPrepareOptionsMenu(menu)
+        menu.findItem(R.id.show_notifications).isVisible =
+            logicalSlotId != -1
+        menu.findItem(R.id.euicc_info).isVisible =
+            logicalSlotId != -1
+        menu.findItem(R.id.euicc_memory_reset).isVisible =
+            runBlocking { preferenceRepository.euiccMemoryResetFlow.first() }
+    }
 
-            R.id.euicc_info -> {
-                if (logicalSlotId != -1) {
-                    Intent(requireContext(), EuiccInfoActivity::class.java).apply {
-                        putExtra("logicalSlotId", logicalSlotId)
-                        startActivity(this)
-                    }
-                }
-                true
+    override fun onOptionsItemSelected(item: MenuItem) = when (item.itemId) {
+        R.id.show_notifications -> {
+            Intent(requireContext(), NotificationsActivity::class.java).apply {
+                putExtra("logicalSlotId", logicalSlotId)
+                startActivity(this)
             }
-
-            else -> super.onOptionsItemSelected(item)
+            true
         }
 
+        R.id.euicc_info -> {
+            Intent(requireContext(), EuiccInfoActivity::class.java).apply {
+                putExtra("logicalSlotId", logicalSlotId)
+                startActivity(this)
+            }
+            true
+        }
+
+        R.id.euicc_memory_reset -> {
+            EuiccMemoryResetFragment.newInstance(slotId, portId, eid)
+                .show(childFragmentManager, EuiccMemoryResetFragment.TAG)
+            true
+        }
+
+        else -> super.onOptionsItemSelected(item)
+    }
+
     protected open suspend fun onCreateFooterViews(
         parent: ViewGroup,
         profiles: List<LocalProfileInfo>
@@ -192,6 +206,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
         val profiles = withEuiccChannel { channel ->
             logicalSlotId = channel.logicalSlotId
+            eid = channel.lpa.eID
             euiccChannelManager.notifyEuiccProfilesChanged(channel.logicalSlotId)
             if (unfilteredProfileListFlow.value)
                 channel.lpa.profiles
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccMemoryResetFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccMemoryResetFragment.kt
new file mode 100644
index 000000000..086a849a9
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccMemoryResetFragment.kt
@@ -0,0 +1,126 @@
+package im.angry.openeuicc.ui
+
+import android.graphics.Typeface
+import android.os.Bundle
+import android.text.Editable
+import android.util.Log
+import android.widget.EditText
+import android.widget.Toast
+import androidx.appcompat.app.AlertDialog
+import androidx.fragment.app.DialogFragment
+import androidx.fragment.app.Fragment
+import androidx.lifecycle.lifecycleScope
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.service.EuiccChannelManagerService.Companion.waitDone
+import im.angry.openeuicc.util.EuiccChannelFragmentMarker
+import im.angry.openeuicc.util.EuiccProfilesChangedListener
+import im.angry.openeuicc.util.ensureEuiccChannelManager
+import im.angry.openeuicc.util.euiccChannelManagerService
+import im.angry.openeuicc.util.newInstanceEuicc
+import im.angry.openeuicc.util.notifyEuiccProfilesChanged
+import im.angry.openeuicc.util.portId
+import im.angry.openeuicc.util.slotId
+import kotlinx.coroutines.flow.onStart
+import kotlinx.coroutines.launch
+
+class EuiccMemoryResetFragment : DialogFragment(), EuiccChannelFragmentMarker {
+    companion object {
+        const val TAG = "EuiccMemoryResetFragment"
+
+        private const val FIELD_EID = "eid"
+
+        fun newInstance(slotId: Int, portId: Int, eid: String) =
+            newInstanceEuicc(EuiccMemoryResetFragment::class.java, slotId, portId) {
+                putString(FIELD_EID, eid)
+            }
+    }
+
+    private val eid: String by lazy { requireArguments().getString(FIELD_EID)!! }
+
+    private val confirmText: String by lazy {
+        getString(R.string.euicc_memory_reset_confirm_text, eid.takeLast(8))
+    }
+
+    private inline val isMatched: Boolean
+        get() = editText.text.toString() == confirmText
+
+    private var confirmed = false
+
+    private var toast: Toast? = null
+        set(value) {
+            toast?.cancel()
+            field = value
+            value?.show()
+        }
+
+    private val editText by lazy {
+        EditText(requireContext()).apply {
+            isLongClickable = false
+            typeface = Typeface.MONOSPACE
+            hint = Editable.Factory.getInstance()
+                .newEditable(getString(R.string.euicc_memory_reset_hint_text, confirmText))
+        }
+    }
+
+    private inline val alertDialog: AlertDialog
+        get() = requireDialog() as AlertDialog
+
+    override fun onCreateDialog(savedInstanceState: Bundle?) =
+        AlertDialog.Builder(requireContext(), R.style.AlertDialogTheme)
+            .setTitle(R.string.euicc_memory_reset_title)
+            .setMessage(getString(R.string.euicc_memory_reset_message, eid, confirmText))
+            .setView(editText)
+            // Set listener to null to prevent auto closing
+            .setNegativeButton(android.R.string.cancel, null)
+            .setPositiveButton(R.string.euicc_memory_reset_invoke_button, null)
+            .create()
+
+    override fun onResume() {
+        super.onResume()
+        alertDialog.setCanceledOnTouchOutside(false)
+        alertDialog.getButton(AlertDialog.BUTTON_POSITIVE)
+            .setOnClickListener { if (!confirmed) confirmation() }
+        alertDialog.getButton(AlertDialog.BUTTON_NEGATIVE)
+            .setOnClickListener { if (!confirmed) dismiss() }
+    }
+
+    private fun confirmation() {
+        toast?.cancel()
+        if (!isMatched) {
+            Log.d(TAG, buildString {
+                appendLine("User input is mismatch:")
+                appendLine(editText.text)
+                appendLine(confirmText)
+            })
+            val resId = R.string.toast_euicc_memory_reset_confirm_text_mismatched
+            toast = Toast.makeText(requireContext(), resId, Toast.LENGTH_LONG)
+            return
+        }
+        confirmed = true
+        preventUserAction()
+
+        requireParentFragment().lifecycleScope.launch {
+            ensureEuiccChannelManager()
+            euiccChannelManagerService.waitForForegroundTask()
+
+            euiccChannelManagerService.launchMemoryReset(slotId, portId)
+                .onStart {
+                    parentFragment?.notifyEuiccProfilesChanged()
+
+                    val resId = R.string.toast_euicc_memory_reset_finitshed
+                    toast = Toast.makeText(requireContext(), resId, Toast.LENGTH_LONG)
+
+                    runCatching(::dismiss)
+                }
+                .waitDone()
+        }
+    }
+
+    private fun preventUserAction() {
+        editText.isEnabled = false
+        alertDialog.setCancelable(false)
+        alertDialog.setCanceledOnTouchOutside(false)
+        alertDialog.getButton(AlertDialog.BUTTON_POSITIVE).isEnabled = false
+        alertDialog.getButton(AlertDialog.BUTTON_NEGATIVE).isEnabled = false
+    }
+}
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index c54d6a185..cdb58f143 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.ui
 
 import android.content.Intent
+import android.content.pm.PackageManager
 import android.net.Uri
 import android.os.Build
 import android.os.Bundle
@@ -77,6 +78,11 @@ open class SettingsFragment: PreferenceFragmentCompat() {
 
         requirePreference<CheckBoxPreference>("pref_developer_ignore_tls_certificate")
             .bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
+
+        requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset").apply {
+            isVisible = context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_HOST)
+            bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
+        }
     }
 
     protected fun <T : Preference> requirePreference(key: CharSequence) =
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 3c7bbf4f5..34d1cfd96 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -33,6 +33,7 @@ internal object PreferenceKeys {
     val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
     val UNFILTERED_PROFILE_LIST = booleanPreferencesKey("unfiltered_profile_list")
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
+    val EUICC_MEMORY_RESET = booleanPreferencesKey("euicc_memory_reset")
 }
 
 open class PreferenceRepository(private val context: Context) {
@@ -50,6 +51,7 @@ open class PreferenceRepository(private val context: Context) {
     val developerOptionsEnabledFlow = bindFlow(PreferenceKeys.DEVELOPER_OPTIONS_ENABLED, false)
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
+    val euiccMemoryResetFlow = bindFlow(PreferenceKeys.EUICC_MEMORY_RESET, false)
 
     protected fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): PreferenceFlowWrapper<T> =
         PreferenceFlowWrapper(context, key, defaultValue)
diff --git a/app-common/src/main/res/drawable/ic_euicc_memory_reset.xml b/app-common/src/main/res/drawable/ic_euicc_memory_reset.xml
new file mode 100644
index 000000000..f1ca8c164
--- /dev/null
+++ b/app-common/src/main/res/drawable/ic_euicc_memory_reset.xml
@@ -0,0 +1,18 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="21"
+    android:viewportHeight="21">
+    <path
+        android:pathData="m3.578,6.487c1.385,-2.384 3.966,-3.987 6.922,-3.987 4.418,0 8,3.582 8,8s-3.582,8 -8,8 -8,-3.582 -8,-8"
+        android:strokeWidth="1"
+        android:strokeColor="@android:color/white"
+        android:strokeLineCap="round"
+        android:strokeLineJoin="round" />
+    <path
+        android:pathData="m7.5,6.5l-4,0l-0,-4"
+        android:strokeWidth="1"
+        android:strokeColor="@android:color/white"
+        android:strokeLineCap="round"
+        android:strokeLineJoin="round" />
+</vector>
diff --git a/app-common/src/main/res/menu/fragment_euicc.xml b/app-common/src/main/res/menu/fragment_euicc.xml
index b54eaf17e..6e2dfbe87 100644
--- a/app-common/src/main/res/menu/fragment_euicc.xml
+++ b/app-common/src/main/res/menu/fragment_euicc.xml
@@ -10,4 +10,9 @@
         android:id="@+id/euicc_info"
         android:title="@string/euicc_info"
         app:showAsAction="never" />
+
+    <item
+        android:id="@+id/euicc_memory_reset"
+        android:title="@string/euicc_memory_reset"
+        app:showAsAction="never" />
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 22b8a4c22..1fd361c8b 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -150,4 +150,16 @@
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
+    <string name="toast_euicc_memory_reset_confirm_text_mismatched">確認文字列が一致しません</string>
+    <string name="toast_euicc_memory_reset_finitshed">このチップは消去されました</string>
+    <string name="task_euicc_memory_reset">eSIM チップを消去しています</string>
+    <string name="task_euicc_memory_reset_failure">eSIM チップの消去は失敗しました</string>
+    <string name="euicc_memory_reset">eSIM を消去する</string>
+    <string name="euicc_memory_reset_title">eSIM を消去する</string>
+    <string name="euicc_memory_reset_message">このチップ内のすべてのプロファイルを削除することをご確認してください。この操作は元に戻せないことをご理解してください。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_hint_text">確認のため、ここに「%s」を入力してください</string>
+    <string name="euicc_memory_reset_confirm_text">EID が %s で終わるチップを消去することに同意します。これは元に戻せないことを理解しています。</string>
+    <string name="euicc_memory_reset_invoke_button">消去する</string>
+    <string name="pref_developer_euicc_memory_reset">eUICC の消去を可能にする</string>
+    <string name="pref_developer_euicc_memory_reset_desc">この操作は、デフォルトでは非表示になっている危険な操作です。代わりに、すべての構成ファイルを手動で削除することもできます。</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index e255d9a8b..8c360912c 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -150,4 +150,16 @@
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
     <string name="information_unavailable">无信息</string>
+    <string name="toast_euicc_memory_reset_confirm_text_mismatched">输入的确认文本不匹配</string>
+    <string name="toast_euicc_memory_reset_finitshed">此芯片已被擦除</string>
+    <string name="task_euicc_memory_reset">正在擦除 eSIM 芯片</string>
+    <string name="task_euicc_memory_reset_failure">eSIM 芯片擦除失败</string>
+    <string name="euicc_memory_reset">擦除 eSIM 芯片</string>
+    <string name="euicc_memory_reset_title">擦除 eSIM 芯片</string>
+    <string name="euicc_memory_reset_message">请确认删除此芯片上的所有配置文件，并了解此操作不可逆。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_hint_text">请在此处输入「%s」以确认</string>
+    <string name="euicc_memory_reset_confirm_text">我确认擦除 EID 以 %s 结尾的芯片，并了解此操作不可逆</string>
+    <string name="euicc_memory_reset_invoke_button">擦除</string>
+    <string name="pref_developer_euicc_memory_reset">允许擦除 eUICC</string>
+    <string name="pref_developer_euicc_memory_reset_desc">此操作是默认隐藏的危险操作。作为替代方案，您可以手动删除所有配置文件。</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index b8c94b5e8..3d8270ddc 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -150,4 +150,16 @@
     <string name="pref_developer_ignore_tls_certificate">忽略 SM-DP+ 的 TLS 證書</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允許 RSP 伺服器使用任意證書</string>
     <string name="information_unavailable">無資訊</string>
+    <string name="toast_euicc_memory_reset_confirm_text_mismatched">輸入的確認文字不匹配</string>
+    <string name="toast_euicc_memory_reset_finitshed">此晶片已被擦除</string>
+    <string name="task_euicc_memory_reset">正在擦除 eSIM 晶片</string>
+    <string name="task_euicc_memory_reset_failure">eSIM 晶片擦除失敗</string>
+    <string name="euicc_memory_reset">擦除 eSIM 晶片</string>
+    <string name="euicc_memory_reset_title">擦除 eSIM 晶片</string>
+    <string name="euicc_memory_reset_message">請確認刪除此晶片上的所有配置文件，並了解此操作不可逆。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_hint_text">請在此輸入「%s」以確認</string>
+    <string name="euicc_memory_reset_confirm_text">我確認擦除 EID 以 %s 結尾的晶片，並了解此操作不可逆</string>
+    <string name="euicc_memory_reset_invoke_button">擦除</string>
+    <string name="pref_developer_euicc_memory_reset">允許擦除 eUICC</string>
+    <string name="pref_developer_euicc_memory_reset_desc">此操作是預設隱藏的危險操作。作為替代方案，您可以手動刪除所有設定檔。</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 8a0ac24f2..cc84381d6 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -30,6 +30,8 @@
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>
+    <string name="toast_euicc_memory_reset_confirm_text_mismatched">Confirmation string mismatch</string>
+    <string name="toast_euicc_memory_reset_finitshed">This chip has been erased</string>
     <string name="toast_iccid_copied">ICCID copied to clipboard</string>
     <string name="toast_sn_copied">Serial number copied to clipboard</string>
     <string name="toast_eid_copied">EID copied to clipboard</string>
@@ -48,6 +50,8 @@
     <string name="task_profile_delete_failure">Failed to delete eSIM profile</string>
     <string name="task_profile_switch">Switching eSIM profile</string>
     <string name="task_profile_switch_failure">Failed to switch eSIM profile</string>
+    <string name="task_euicc_memory_reset">Erasing eSIM chip</string>
+    <string name="task_euicc_memory_reset_failure">Failed to erase eSIM chip</string>
 
     <string name="profile_download">New eSIM</string>
     <string name="profile_download_server">Server (RSP / SM-DP+)</string>
@@ -142,6 +146,13 @@
     <string name="euicc_info_ci_unknown">Unknown eSIM CI</string>
     <string name="euicc_info_atr" translatable="false">Answer To Reset (ATR)</string>
 
+    <string name="euicc_memory_reset">Erase eUICC</string>
+    <string name="euicc_memory_reset_title">Erase eUICC</string>
+    <string name="euicc_memory_reset_message">Please confirm to delete all profiles on this chip and understand that this operation is irreversible.\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_hint_text">Type \'%s\' here to confirm</string>
+    <string name="euicc_memory_reset_confirm_text">I CONFIRM TO ERASE THE CHIP WHOSE EID ENDS WITH %s AND UNDERSTAND THAT THIS IS IRREVERSIBLE</string>
+    <string name="euicc_memory_reset_invoke_button">Erase</string>
+
     <string name="yes">Yes</string>
     <string name="no">No</string>
 
@@ -174,6 +185,8 @@
     <string name="pref_developer_unfiltered_profile_list_desc">Include non-production profiles in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
     <string name="pref_developer_ignore_tls_certificate_desc">Accept any TLS certificate used by the RSP server</string>
+    <string name="pref_developer_euicc_memory_reset">Allow erasing eUICC</string>
+    <string name="pref_developer_euicc_memory_reset_desc">This is a dangerous operation and hidden by default. As an alternative, you can delete all profiles manually.</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 944bd27b9..008f9aeb4 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -69,6 +69,13 @@
             app:summary="@string/pref_developer_ignore_tls_certificate_desc"
             app:title="@string/pref_developer_ignore_tls_certificate" />
 
+        <CheckBoxPreference
+            app:iconSpaceReserved="false"
+            app:isPreferenceVisible="false"
+            app:key="pref_developer_euicc_memory_reset"
+            app:summary="@string/pref_developer_euicc_memory_reset_desc"
+            app:title="@string/pref_developer_euicc_memory_reset" />
+
     </im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory>
 
     <PreferenceCategory

From c2659ddb696918b9ce958be5214ce767f0b9c5e1 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 20:28:19 -0500
Subject: [PATCH 386/458] fix: Don't use beginTrackedOperation for erasure.
 It's wrong.

---
 .../angry/openeuicc/service/EuiccChannelManagerService.kt | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 52943d87e..9957f30d8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -502,12 +502,8 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_euicc_memory_reset_failure),
             R.drawable.ic_euicc_memory_reset
         ) {
-            euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
-                    channel.lpa.euiccMemoryReset()
-                }
-
-                preferenceRepository.euiccMemoryResetFlow.first()
+            euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                channel.lpa.euiccMemoryReset()
             }
         }
 }
\ No newline at end of file

From f6c50490b86bc912e1cb52ca9f08e49138adeef0 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 8 Mar 2025 20:35:00 -0500
Subject: [PATCH 387/458] fix: No USB_HOST feature requirement for eUICC
 erasure

---
 .../main/java/im/angry/openeuicc/ui/SettingsFragment.kt    | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index cdb58f143..b085286fb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -1,7 +1,6 @@
 package im.angry.openeuicc.ui
 
 import android.content.Intent
-import android.content.pm.PackageManager
 import android.net.Uri
 import android.os.Build
 import android.os.Bundle
@@ -79,10 +78,8 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         requirePreference<CheckBoxPreference>("pref_developer_ignore_tls_certificate")
             .bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
 
-        requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset").apply {
-            isVisible = context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_HOST)
-            bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
-        }
+        requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset")
+            .bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
     }
 
     protected fun <T : Preference> requirePreference(key: CharSequence) =

From 74cc08ce8e7d678de49f40a9f5926a1d5ebb77da Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 9 Mar 2025 04:22:07 +0100
Subject: [PATCH 388/458] chore: remove visibility attribute from euicc memory
 reset preference (#166)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/166
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/res/xml/pref_settings.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 008f9aeb4..7d25118d1 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -71,7 +71,6 @@
 
         <CheckBoxPreference
             app:iconSpaceReserved="false"
-            app:isPreferenceVisible="false"
             app:key="pref_developer_euicc_memory_reset"
             app:summary="@string/pref_developer_euicc_memory_reset_desc"
             app:title="@string/pref_developer_euicc_memory_reset" />

From 88eb1ce0e22efff875e35eaa5025dec0c1a2eae2 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 9 Mar 2025 22:47:02 +0100
Subject: [PATCH 389/458] feat: update TelephonyManager preference key and
 implement context marker interface (#167)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/167
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/core/PrivilegedEuiccChannelFactory.kt |  5 +++--
 .../openeuicc/ui/PrivilegedSettingsFragment.kt      |  6 +++---
 .../java/im/angry/openeuicc/util/PrivilegedUtils.kt | 13 +++++++++++++
 app/src/main/res/xml/pref_privileged_settings.xml   |  2 +-
 4 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 2044c02ee..6dccda948 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -8,7 +8,8 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.first
 import java.lang.IllegalArgumentException
 
-class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFactory(context) {
+class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFactory(context),
+    PrivilegedEuiccContextMarker {
     private val tm by lazy {
         (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
     }
@@ -22,7 +23,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
             super.tryOpenEuiccChannel(port)?.let { return it }
         }
 
-        if (port.card.isEuicc || (context.preferenceRepository as PrivilegedPreferenceRepository).removableTelephonyManagerFlow.first()) {
+        if (port.card.isEuicc || preferenceRepository.removableTelephonyManagerFlow.first()) {
             Log.i(
                 DefaultEuiccChannelManager.TAG,
                 "Trying TelephonyManager for slot ${port.card.physicalSlotIndex} port ${port.portIndex}"
diff --git a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
index 7229688b3..c67d88047 100644
--- a/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
+++ b/app/src/main/java/im/angry/openeuicc/ui/PrivilegedSettingsFragment.kt
@@ -6,7 +6,7 @@ import androidx.preference.Preference
 import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
 
-class PrivilegedSettingsFragment : SettingsFragment() {
+class PrivilegedSettingsFragment : SettingsFragment(), PrivilegedEuiccContextMarker {
     override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
         super.onCreatePreferences(savedInstanceState, rootKey)
         addPreferencesFromResource(R.xml.pref_privileged_settings)
@@ -21,7 +21,7 @@ class PrivilegedSettingsFragment : SettingsFragment() {
         requirePreference<Preference>("pref_advanced_language").isVisible = false
 
         // Force use TelephonyManager API
-        requirePreference<CheckBoxPreference>("pref_developer_tmapi_removable")
-            .bindBooleanFlow((preferenceRepository as PrivilegedPreferenceRepository).removableTelephonyManagerFlow)
+        requirePreference<CheckBoxPreference>("pref_developer_removable_telephony_manager")
+            .bindBooleanFlow(preferenceRepository.removableTelephonyManagerFlow)
     }
 }
\ No newline at end of file
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
index e295f2694..21c8002f0 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
@@ -5,10 +5,23 @@ import android.content.Context
 import android.content.Intent
 import android.content.ServiceConnection
 import android.os.IBinder
+import androidx.fragment.app.Fragment
 import java.util.concurrent.Executors
 import kotlin.coroutines.resume
 import kotlin.coroutines.suspendCoroutine
 
+interface PrivilegedEuiccContextMarker {
+    val privilegedEuiccMarkerContext: Context
+        get() = when (this) {
+            is Context -> this
+            is Fragment -> requireContext()
+            else -> throw RuntimeException("PrivilegedEuiccContextMarker shall only be used on Fragments or UI types that derive from Context")
+        }
+
+    val preferenceRepository: PrivilegedPreferenceRepository
+        get() = privilegedEuiccMarkerContext.preferenceRepository as PrivilegedPreferenceRepository
+}
+
 suspend fun Context.bindServiceSuspended(intent: Intent, flags: Int): Pair<IBinder?, () -> Unit> =
     suspendCoroutine { cont ->
         var binder: IBinder?
diff --git a/app/src/main/res/xml/pref_privileged_settings.xml b/app/src/main/res/xml/pref_privileged_settings.xml
index 339233bc4..5279126af 100644
--- a/app/src/main/res/xml/pref_privileged_settings.xml
+++ b/app/src/main/res/xml/pref_privileged_settings.xml
@@ -5,7 +5,7 @@
         app:key="pref_developer_overlay">
         <CheckBoxPreference
             app:iconSpaceReserved="false"
-            app:key="pref_developer_tmapi_removable"
+            app:key="pref_developer_removable_telephony_manager"
             app:summary="@string/pref_developer_telephony_manager_removable_desc"
             app:title="@string/pref_developer_telephony_manager_removable" />
     </PreferenceCategory>

From b9849afe182ef747ddf7819732d27f97d03cce6e Mon Sep 17 00:00:00 2001
From: LuK1337 <priv.luk@gmail.com>
Date: Wed, 12 Mar 2025 01:00:10 +0100
Subject: [PATCH 390/458] fix: Address multiple substitutions in string format
 error (#175)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/175
Co-authored-by: LuK1337 <priv.luk@gmail.com>
Co-committed-by: LuK1337 <priv.luk@gmail.com>
---
 app-common/src/main/res/values-ja/strings.xml     | 2 +-
 app-common/src/main/res/values-zh-rCN/strings.xml | 2 +-
 app-common/src/main/res/values-zh-rTW/strings.xml | 2 +-
 app-common/src/main/res/values/strings.xml        | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 1fd361c8b..644e56458 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -156,7 +156,7 @@
     <string name="task_euicc_memory_reset_failure">eSIM チップの消去は失敗しました</string>
     <string name="euicc_memory_reset">eSIM を消去する</string>
     <string name="euicc_memory_reset_title">eSIM を消去する</string>
-    <string name="euicc_memory_reset_message">このチップ内のすべてのプロファイルを削除することをご確認してください。この操作は元に戻せないことをご理解してください。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_message">このチップ内のすべてのプロファイルを削除することをご確認してください。この操作は元に戻せないことをご理解してください。\n\nEID: %1$s\n\n%2$s</string>
     <string name="euicc_memory_reset_hint_text">確認のため、ここに「%s」を入力してください</string>
     <string name="euicc_memory_reset_confirm_text">EID が %s で終わるチップを消去することに同意します。これは元に戻せないことを理解しています。</string>
     <string name="euicc_memory_reset_invoke_button">消去する</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 8c360912c..789b53200 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -156,7 +156,7 @@
     <string name="task_euicc_memory_reset_failure">eSIM 芯片擦除失败</string>
     <string name="euicc_memory_reset">擦除 eSIM 芯片</string>
     <string name="euicc_memory_reset_title">擦除 eSIM 芯片</string>
-    <string name="euicc_memory_reset_message">请确认删除此芯片上的所有配置文件，并了解此操作不可逆。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_message">请确认删除此芯片上的所有配置文件，并了解此操作不可逆。\n\nEID: %1$s\n\n%2$s</string>
     <string name="euicc_memory_reset_hint_text">请在此处输入「%s」以确认</string>
     <string name="euicc_memory_reset_confirm_text">我确认擦除 EID 以 %s 结尾的芯片，并了解此操作不可逆</string>
     <string name="euicc_memory_reset_invoke_button">擦除</string>
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 3d8270ddc..53be5715d 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -156,7 +156,7 @@
     <string name="task_euicc_memory_reset_failure">eSIM 晶片擦除失敗</string>
     <string name="euicc_memory_reset">擦除 eSIM 晶片</string>
     <string name="euicc_memory_reset_title">擦除 eSIM 晶片</string>
-    <string name="euicc_memory_reset_message">請確認刪除此晶片上的所有配置文件，並了解此操作不可逆。\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_message">請確認刪除此晶片上的所有配置文件，並了解此操作不可逆。\n\nEID: %1$s\n\n%2$s</string>
     <string name="euicc_memory_reset_hint_text">請在此輸入「%s」以確認</string>
     <string name="euicc_memory_reset_confirm_text">我確認擦除 EID 以 %s 結尾的晶片，並了解此操作不可逆</string>
     <string name="euicc_memory_reset_invoke_button">擦除</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index cc84381d6..8146f5472 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -148,7 +148,7 @@
 
     <string name="euicc_memory_reset">Erase eUICC</string>
     <string name="euicc_memory_reset_title">Erase eUICC</string>
-    <string name="euicc_memory_reset_message">Please confirm to delete all profiles on this chip and understand that this operation is irreversible.\n\nEID: %s\n\n%s</string>
+    <string name="euicc_memory_reset_message">Please confirm to delete all profiles on this chip and understand that this operation is irreversible.\n\nEID: %1$s\n\n%2$s</string>
     <string name="euicc_memory_reset_hint_text">Type \'%s\' here to confirm</string>
     <string name="euicc_memory_reset_confirm_text">I CONFIRM TO ERASE THE CHIP WHOSE EID ENDS WITH %s AND UNDERSTAND THAT THIS IS IRREVERSIBLE</string>
     <string name="euicc_memory_reset_invoke_button">Erase</string>

From 360760b78fbc2298c62521921f8960d82ad41242 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 15 Mar 2025 15:38:26 -0400
Subject: [PATCH 391/458] chore: Upgrade Android Studio and Gradle

---
 .idea/codeStyles/Project.xml             |   6 +
 .idea/codeStyles/codeStyleConfig.xml     |   1 +
 .idea/deploymentTargetSelector.xml       |  24 ++
 .idea/kotlinc.xml                        |   2 +-
 gradle/wrapper/gradle-wrapper.jar        | Bin 59203 -> 43583 bytes
 gradle/wrapper/gradle-wrapper.properties |   7 +-
 gradlew                                  | 297 ++++++++++++++---------
 gradlew.bat                              |  37 +--
 8 files changed, 239 insertions(+), 135 deletions(-)

diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml
index 4bec4ea8a..7643783a8 100644
--- a/.idea/codeStyles/Project.xml
+++ b/.idea/codeStyles/Project.xml
@@ -1,5 +1,8 @@
 <component name="ProjectCodeStyleConfiguration">
   <code_scheme name="Project" version="173">
+    <JetCodeStyleSettings>
+      <option name="CODE_STYLE_DEFAULTS" value="KOTLIN_OFFICIAL" />
+    </JetCodeStyleSettings>
     <codeStyleSettings language="XML">
       <option name="FORCE_REARRANGE_MODE" value="1" />
       <indentOptions>
@@ -113,5 +116,8 @@
         </rules>
       </arrangement>
     </codeStyleSettings>
+    <codeStyleSettings language="kotlin">
+      <option name="CODE_STYLE_DEFAULTS" value="KOTLIN_OFFICIAL" />
+    </codeStyleSettings>
   </code_scheme>
 </component>
\ No newline at end of file
diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml
index a55e7a179..6e6eec114 100644
--- a/.idea/codeStyles/codeStyleConfig.xml
+++ b/.idea/codeStyles/codeStyleConfig.xml
@@ -1,5 +1,6 @@
 <component name="ProjectCodeStyleConfiguration">
   <state>
+    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
     <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
   </state>
 </component>
\ No newline at end of file
diff --git a/.idea/deploymentTargetSelector.xml b/.idea/deploymentTargetSelector.xml
index 8096d6c0d..e40be604b 100644
--- a/.idea/deploymentTargetSelector.xml
+++ b/.idea/deploymentTargetSelector.xml
@@ -8,6 +8,30 @@
       <SelectionState runConfigName="app">
         <option name="selectionMode" value="DROPDOWN" />
       </SelectionState>
+      <SelectionState runConfigName="app-unpriv.androidTest">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="app-unpriv.main">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="app-unpriv.unitTest">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="app.unitTest">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="app.androidTest">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="app.main">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="workspace.OpenEUICC.app-unpriv">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
+      <SelectionState runConfigName="workspace.OpenEUICC.app">
+        <option name="selectionMode" value="DROPDOWN" />
+      </SelectionState>
     </selectionStates>
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/kotlinc.xml b/.idea/kotlinc.xml
index e805548aa..148fdd246 100644
--- a/.idea/kotlinc.xml
+++ b/.idea/kotlinc.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="KotlinJpsPluginSettings">
-    <option name="version" value="1.9.20" />
+    <option name="version" value="1.9.24" />
   </component>
 </project>
\ No newline at end of file
diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index e708b1c023ec8b20f512888fe07c5bd3ff77bb8f..a4b76b9530d66f5e68d973ea569d8e19de379189 100644
GIT binary patch
literal 43583
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
GZ~q4|mN%#X

literal 59203
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
E2O(~oYXATM

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index dab3589f2..9355b4155 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,7 @@
-#Wed Jun 08 13:28:20 EDT 2022
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
 distributionPath=wrapper/dists
-zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/gradlew b/gradlew
index 4f906e0c8..f5feea6d6 100755
--- a/gradlew
+++ b/gradlew
@@ -1,7 +1,7 @@
-#!/usr/bin/env sh
+#!/bin/sh
 
 #
-# Copyright 2015 the original author or authors.
+# Copyright © 2015-2021 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,69 +15,104 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+# SPDX-License-Identifier: Apache-2.0
+#
 
 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################
 
 # Attempt to set APP_HOME
+
 # Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
 done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
 
-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s
+' "$PWD" ) || exit
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum
 
 warn () {
     echo "$*"
-}
+} >&2
 
 die () {
     echo
     echo "$*"
     echo
     exit 1
-}
+} >&2
 
 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
 nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac
 
 CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
@@ -87,9 +122,9 @@ CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
 if [ -n "$JAVA_HOME" ] ; then
     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
         # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
     else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
     fi
     if [ ! -x "$JAVACMD" ] ; then
         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -98,88 +133,120 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
     fi
 else
-    JAVACMD="java"
-    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
+    fi
 fi
 
 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
-fi
-
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
-
-# For Cygwin or MSYS, switch paths to Windows format before running java
-if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
-        fi
-        i=`expr $i + 1`
-    done
-    case $i in
-        0) set -- ;;
-        1) set -- "$args0" ;;
-        2) set -- "$args0" "$args1" ;;
-        3) set -- "$args0" "$args1" "$args2" ;;
-        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
 fi
 
-# Escape application args
-save () {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=`save "$@"`
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
 
-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
 
 exec "$JAVACMD" "$@"
diff --git a/gradlew.bat b/gradlew.bat
index ac1b06f93..9b42019c7 100644
--- a/gradlew.bat
+++ b/gradlew.bat
@@ -13,8 +13,10 @@
 @rem See the License for the specific language governing permissions and
 @rem limitations under the License.
 @rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
 
-@if "%DEBUG%" == "" @echo off
+@if "%DEBUG%"=="" @echo off
 @rem ##########################################################################
 @rem
 @rem  Gradle startup script for Windows
@@ -25,7 +27,8 @@
 if "%OS%"=="Windows_NT" setlocal
 
 set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 
@@ -40,13 +43,13 @@ if defined JAVA_HOME goto findJavaFromJavaHome
 
 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto execute
+if %ERRORLEVEL% equ 0 goto execute
 
-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
@@ -56,11 +59,11 @@ set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
 if exist "%JAVA_EXE%" goto execute
 
-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
 
 goto fail
 
@@ -75,13 +78,15 @@ set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
 
 :end
 @rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
+if %ERRORLEVEL% equ 0 goto mainEnd
 
 :fail
 rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
 rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
 
 :mainEnd
 if "%OS%"=="Windows_NT" endlocal

From a6286ed09765fbc2cd80a5f38c70050cf9cacc50 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Mar 2025 17:32:09 -0400
Subject: [PATCH 392/458] feat: Acquire partial wake lock for all foreground
 tasks

All of our foreground tasks require the CPU to be at least awake to make
any progress. We could keep the screen on but we really only need the
partial wake lock to make sure progress is made.
---
 app-common/src/main/AndroidManifest.xml                |  1 +
 .../openeuicc/service/EuiccChannelManagerService.kt    | 10 ++++++++++
 2 files changed, 11 insertions(+)

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index 6edaaf13a..464ae0f5f 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -7,6 +7,7 @@
     <uses-permission android:name="android.permission.READ_PHONE_STATE" />
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
 
     <application
         android:enableOnBackInvokedCallback="true"
diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 9957f30d8..a812a47db 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -4,6 +4,7 @@ import android.content.Intent
 import android.content.pm.PackageManager
 import android.os.Binder
 import android.os.IBinder
+import android.os.PowerManager
 import android.util.Log
 import androidx.core.app.NotificationChannelCompat
 import androidx.core.app.NotificationCompat
@@ -91,6 +92,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     }
     val euiccChannelManager: EuiccChannelManager by euiccChannelManagerDelegate
 
+    val wakeLock: PowerManager.WakeLock by lazy {
+        (getSystemService(POWER_SERVICE) as PowerManager).run {
+            newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, this::class.simpleName)
+        }
+    }
+
     /**
      * The state of a "foreground" task (named so due to the need to startForeground())
      */
@@ -275,6 +282,8 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
 
             updateForegroundNotification(title, iconRes)
 
+            wakeLock.acquire(10 * 60 * 1000L /*10 minutes*/)
+
             try {
                 withContext(Dispatchers.IO + NonCancellable) { // Any LPA-related task must always complete
                     this@EuiccChannelManagerService.task()
@@ -290,6 +299,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
                     postForegroundTaskFailureNotification(failureTitle)
                 }
             } finally {
+                wakeLock.release()
                 if (isActive) {
                     stopSelf()
                 }

From 291869207a39b29fa453d9f2efbe46a988085b85 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Mar 2025 17:35:46 -0400
Subject: [PATCH 393/458] We don't need a public wake lock

---
 .../im/angry/openeuicc/service/EuiccChannelManagerService.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index a812a47db..88c805796 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -92,7 +92,7 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
     }
     val euiccChannelManager: EuiccChannelManager by euiccChannelManagerDelegate
 
-    val wakeLock: PowerManager.WakeLock by lazy {
+    private val wakeLock: PowerManager.WakeLock by lazy {
         (getSystemService(POWER_SERVICE) as PowerManager).run {
             newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, this::class.simpleName)
         }

From 33d383a3ce8dbe405791c17c6d4e34b67d7c47c8 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 16 Mar 2025 17:54:54 -0400
Subject: [PATCH 394/458] ui: wizard: Keep screen on during the download
 process

---
 .../openeuicc/ui/wizard/DownloadWizardActivity.kt     | 11 +++++++++++
 .../ui/wizard/DownloadWizardProgressFragment.kt       |  3 +++
 2 files changed, 14 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index a9f868f02..9e312d4e8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -3,6 +3,7 @@ package im.angry.openeuicc.ui.wizard
 import android.app.assist.AssistContent
 import android.os.Bundle
 import android.view.View
+import android.view.WindowManager
 import android.view.inputmethod.InputMethodManager
 import android.widget.Button
 import android.widget.ProgressBar
@@ -251,6 +252,14 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         supportFragmentManager.beginTransaction().setCustomAnimations(enterAnim, exitAnim)
             .replace(R.id.step_fragment_container, nextFrag)
             .commit()
+
+        // Sync screen on state
+        if (nextFrag.keepScreenOn) {
+            window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+        } else {
+            window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+        }
+
         refreshButtons()
     }
 
@@ -280,6 +289,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         protected val state: DownloadWizardState
             get() = (requireActivity() as DownloadWizardActivity).state
 
+        open val keepScreenOn = false
+
         abstract val hasNext: Boolean
         abstract val hasPrev: Boolean
         abstract fun createNextFragment(): DownloadWizardStepFragment?
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index 1b816d48f..342a687f8 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -59,6 +59,9 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
 
     private val adapter = ProgressItemAdapter()
 
+    // We don't want to turn off the screen during a download
+    override val keepScreenOn = true
+
     private var isDone = false
 
     override val hasNext: Boolean

From 6b169c505d623c186d10283a3ec94501b5f4e5f3 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 17 Mar 2025 00:01:06 +0100
Subject: [PATCH 395/458] fix: crash (priv) (#177)

resolves #178

```
1741836445.585 10331 13748 13748 E AndroidRuntime: FATAL EXCEPTION: main
1741836445.585 10331 13748 13748 E AndroidRuntime: Process: im.angry.openeuicc, PID: 13748
1741836445.585 10331 13748 13748 E AndroidRuntime: java.lang.RuntimeException: PrivilegedEuiccContextMarker shall only be used on Fragments or UI types that derive from Context
1741836445.585 10331 13748 13748 E AndroidRuntime: 	at im.angry.openeuicc.util.PrivilegedEuiccContextMarker$DefaultImpls.getPrivilegedEuiccMarkerContext(PrivilegedUtils.kt:18)
```

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/177
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/util/Utils.kt  |  3 +++
 .../openeuicc/core/PrivilegedEuiccChannelFactory.kt |  7 +++----
 .../java/im/angry/openeuicc/util/PrivilegedUtils.kt | 13 +++----------
 3 files changed, 9 insertions(+), 14 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
index 5a559f976..046657f8d 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/Utils.kt
@@ -54,6 +54,9 @@ interface OpenEuiccContextMarker {
     val appContainer: AppContainer
         get() = openEuiccApplication.appContainer
 
+    val preferenceRepository: PreferenceRepository
+        get() = appContainer.preferenceRepository
+
     val telephonyManager: TelephonyManager
         get() = appContainer.telephonyManager
 }
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 6dccda948..d9bceda3e 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -10,9 +10,8 @@ import java.lang.IllegalArgumentException
 
 class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFactory(context),
     PrivilegedEuiccContextMarker {
-    private val tm by lazy {
-        (context.applicationContext as OpenEuiccApplication).appContainer.telephonyManager
-    }
+    override val openEuiccMarkerContext: Context
+        get() = context
 
     @Suppress("NAME_SHADOWING")
     override suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
@@ -35,7 +34,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                     intrinsicChannelName = null,
                     TelephonyManagerApduInterface(
                         port,
-                        tm,
+                        telephonyManager,
                         context.preferenceRepository.verboseLoggingFlow
                     ),
                     context.preferenceRepository.verboseLoggingFlow,
diff --git a/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
index 21c8002f0..641858101 100644
--- a/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
+++ b/app/src/main/java/im/angry/openeuicc/util/PrivilegedUtils.kt
@@ -10,16 +10,9 @@ import java.util.concurrent.Executors
 import kotlin.coroutines.resume
 import kotlin.coroutines.suspendCoroutine
 
-interface PrivilegedEuiccContextMarker {
-    val privilegedEuiccMarkerContext: Context
-        get() = when (this) {
-            is Context -> this
-            is Fragment -> requireContext()
-            else -> throw RuntimeException("PrivilegedEuiccContextMarker shall only be used on Fragments or UI types that derive from Context")
-        }
-
-    val preferenceRepository: PrivilegedPreferenceRepository
-        get() = privilegedEuiccMarkerContext.preferenceRepository as PrivilegedPreferenceRepository
+interface PrivilegedEuiccContextMarker : OpenEuiccContextMarker {
+    override val preferenceRepository: PrivilegedPreferenceRepository
+        get() = appContainer.preferenceRepository as PrivilegedPreferenceRepository
 }
 
 suspend fun Context.bindServiceSuspended(intent: Intent, flags: Int): Pair<IBinder?, () -> Unit> =

From e08f8beb45007d6b70fa3a649815f16e760c1a6d Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 17 Mar 2025 00:01:22 +0100
Subject: [PATCH 396/458] feat: add iQOO stk launch support (#179)

![image](/attachments/b2aac119-c488-41e6-a39f-eab8559cd63b)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/179
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-unpriv/src/main/res/values/sim_toolkit.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-unpriv/src/main/res/values/sim_toolkit.xml b/app-unpriv/src/main/res/values/sim_toolkit.xml
index 1f162715e..8db99550b 100644
--- a/app-unpriv/src/main/res/values/sim_toolkit.xml
+++ b/app-unpriv/src/main/res/values/sim_toolkit.xml
@@ -5,12 +5,14 @@
         <item>com.android.stk/.StkMainHide</item>
         <item>com.android.stk/.StkListActivity</item>
         <item>com.android.stk/.StkLauncherListActivity</item>
+        <item>com.android.stk/.StkSelectionActivity</item>
     </string-array>
     <string-array name="sim_toolkit_slot_1">
         <item>com.android.stk/.StkMain1</item>
         <item>com.android.stk/.PrimaryStkMain</item>
         <item>com.android.stk/.StkLauncherActivity</item>
         <item>com.android.stk/.StkLauncherActivity_Chn</item>
+        <item>com.android.stk/.StkLauncherActivity1</item>
         <item>com.android.stk/.StkLauncherActivityI</item>
         <item>com.android.stk/.OppoStkLauncherActivity1</item>
         <item>com.android.stk/.OplusStkLauncherActivity1</item>

From dc6b3a4810bd05b25bd5433993cece12a79c5945 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 16 Mar 2025 21:04:28 -0400
Subject: [PATCH 397/458] feat: support disabling refresh after switch in
 settings

peter: Reworked strings and i18 translations. Also removed the ad-hoc
function in favor of a lambda.
---
 .../service/EuiccChannelManagerService.kt     | 37 +++++++++++--------
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  3 ++
 .../angry/openeuicc/util/PreferenceUtils.kt   | 13 +++----
 app-common/src/main/res/values-ja/strings.xml |  2 +
 .../src/main/res/values-zh-rCN/strings.xml    |  2 +
 .../src/main/res/values-zh-rTW/strings.xml    |  2 +
 app-common/src/main/res/values/strings.xml    |  2 +
 app-common/src/main/res/xml/pref_settings.xml |  6 +++
 8 files changed, 44 insertions(+), 23 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 88c805796..2a2448889 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -12,6 +12,7 @@ import androidx.core.app.NotificationManagerCompat
 import androidx.lifecycle.LifecycleService
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
+import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -456,30 +457,34 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
         iccid: String,
         enable: Boolean, // Enable or disable the profile indicated in iccid
         reconnectTimeoutMillis: Long = 0 // 0 = do not wait for reconnect
-    ): ForegroundTaskSubscriberFlow =
+    ) =
         launchForegroundTask(
             getString(R.string.task_profile_switch),
             getString(R.string.task_profile_switch_failure),
             R.drawable.ic_task_switch
         ) {
             euiccChannelManager.beginTrackedOperation(slotId, portId) {
-                val (res, refreshed) = euiccChannelManager.withEuiccChannel(
-                    slotId,
-                    portId
-                ) { channel ->
-                    if (!channel.lpa.switchProfile(iccid, enable, refresh = true)) {
-                        // Sometimes, we *can* enable or disable the profile, but we cannot
-                        // send the refresh command to the modem because the profile somehow
-                        // makes the modem "busy". In this case, we can still switch by setting
-                        // refresh to false, but then the switch cannot take effect until the
-                        // user resets the modem manually by toggling airplane mode or rebooting.
-                        Pair(channel.lpa.switchProfile(iccid, enable, refresh = false), false)
-                    } else {
-                        Pair(true, true)
+                val (response, refreshed) =
+                    euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                        val refresh = preferenceRepository.refreshAfterSwitchFlow.first()
+                        val response = channel.lpa.switchProfile(iccid, enable, refresh)
+                        if (response || !refresh) {
+                            Pair(response, refresh)
+                        } else {
+                            // refresh failed, but refresh was requested
+                            // Sometimes, we *can* enable or disable the profile, but we cannot
+                            // send the refresh command to the modem because the profile somehow
+                            // makes the modem "busy". In this case, we can still switch by setting
+                            // refresh to false, but then the switch cannot take effect until the
+                            // user resets the modem manually by toggling airplane mode or rebooting.
+                            Pair(
+                                channel.lpa.switchProfile(iccid, enable, refresh = false),
+                                false
+                            )
+                        }
                     }
-                }
 
-                if (!res) {
+                if (!response) {
                     throw RuntimeException("Could not switch profile")
                 }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index b085286fb..d137e9099 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -78,6 +78,9 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         requirePreference<CheckBoxPreference>("pref_developer_ignore_tls_certificate")
             .bindBooleanFlow(preferenceRepository.ignoreTLSCertificateFlow)
 
+        requirePreference<CheckBoxPreference>("pref_developer_refresh_after_switch")
+            .bindBooleanFlow(preferenceRepository.refreshAfterSwitchFlow)
+
         requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset")
             .bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
     }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 34d1cfd96..c69c5e43c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -31,6 +31,7 @@ internal object PreferenceKeys {
 
     // ---- Developer Options ----
     val DEVELOPER_OPTIONS_ENABLED = booleanPreferencesKey("developer_options_enabled")
+    val REFRESH_AFTER_SWITCH = booleanPreferencesKey("refresh_after_switch")
     val UNFILTERED_PROFILE_LIST = booleanPreferencesKey("unfiltered_profile_list")
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
     val EUICC_MEMORY_RESET = booleanPreferencesKey("euicc_memory_reset")
@@ -48,6 +49,7 @@ open class PreferenceRepository(private val context: Context) {
     val verboseLoggingFlow = bindFlow(PreferenceKeys.VERBOSE_LOGGING, false)
 
     // ---- Developer Options ----
+    val refreshAfterSwitchFlow = bindFlow(PreferenceKeys.REFRESH_AFTER_SWITCH, true)
     val developerOptionsEnabledFlow = bindFlow(PreferenceKeys.DEVELOPER_OPTIONS_ENABLED, false)
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
@@ -60,15 +62,12 @@ open class PreferenceRepository(private val context: Context) {
 class PreferenceFlowWrapper<T> private constructor(
     private val context: Context,
     private val key: Preferences.Key<T>,
-    inner: Flow<T>
+    inner: Flow<T>,
 ) : Flow<T> by inner {
-    internal constructor(context: Context, key: Preferences.Key<T>, defaultValue: T) : this(
-        context,
-        key,
-        context.dataStore.data.map { it[key] ?: defaultValue }
-    )
+    internal constructor(context: Context, key: Preferences.Key<T>, defaultValue: T) :
+            this(context, key, context.dataStore.data.map { it[key] ?: defaultValue })
 
     suspend fun updatePreference(value: T) {
         context.dataStore.edit { it[key] = value }
     }
-}
\ No newline at end of file
+}
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 644e56458..35fd40014 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -143,6 +143,7 @@
     <string name="pref_advanced_logs">ログ</string>
     <string name="pref_advanced_logs_desc">アプリの最新デバッグログを表示します</string>
     <string name="pref_developer">開発者オプション</string>
+    <string name="pref_developer_refresh_after_switch_desc">プロファイルを切り替えた後にモデムに更新コマンドを送信するかどうか。クラッシュが発生する場合は、これを無効にしてみてください。</string>
     <string name="pref_developer_unfiltered_profile_list">フィルタリングされていないプロファイル一覧を表示</string>
     <string name="pref_developer_unfiltered_profile_list_desc">非運用のプロファイルも含めます</string>
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
@@ -162,4 +163,5 @@
     <string name="euicc_memory_reset_invoke_button">消去する</string>
     <string name="pref_developer_euicc_memory_reset">eUICC の消去を可能にする</string>
     <string name="pref_developer_euicc_memory_reset_desc">この操作は、デフォルトでは非表示になっている危険な操作です。代わりに、すべての構成ファイルを手動で削除することもできます。</string>
+    <string name="pref_developer_refresh_after_switch">モデムに更新コマンドを送信</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 789b53200..2e069bd63 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -145,6 +145,7 @@
     <string name="pref_advanced_language">语言</string>
     <string name="pref_advanced_language_desc">选择 App 语言</string>
     <string name="pref_developer">开发者选项</string>
+    <string name="pref_developer_refresh_after_switch_desc">切换配置文件后是否向基带发送刷新命令。如果发现崩溃，请尝试禁用此功能。</string>
     <string name="pref_developer_unfiltered_profile_list">显示未经过滤的配置文件列表</string>
     <string name="pref_developer_unfiltered_profile_list_desc">在配置文件列表中包括非生产环境的配置文件</string>
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
@@ -162,4 +163,5 @@
     <string name="euicc_memory_reset_invoke_button">擦除</string>
     <string name="pref_developer_euicc_memory_reset">允许擦除 eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">此操作是默认隐藏的危险操作。作为替代方案，您可以手动删除所有配置文件。</string>
+    <string name="pref_developer_refresh_after_switch">向基带发送刷新命令</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 53be5715d..729893ca4 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -145,6 +145,7 @@
     <string name="pref_advanced_language">語言</string>
     <string name="pref_advanced_language_desc">選擇 App 語言</string>
     <string name="pref_developer">開發人員選項</string>
+    <string name="pref_developer_refresh_after_switch_desc">切換設定檔後是否向基帶發送刷新命令。如果發現崩潰，請嘗試停用此功能。</string>
     <string name="pref_developer_unfiltered_profile_list">顯示未經過濾的設定檔列表</string>
     <string name="pref_developer_unfiltered_profile_list_desc">在設定檔列表中包括非生產環境的設定檔</string>
     <string name="pref_developer_ignore_tls_certificate">忽略 SM-DP+ 的 TLS 證書</string>
@@ -162,4 +163,5 @@
     <string name="euicc_memory_reset_invoke_button">擦除</string>
     <string name="pref_developer_euicc_memory_reset">允許擦除 eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">此操作是預設隱藏的危險操作。作為替代方案，您可以手動刪除所有設定檔。</string>
+    <string name="pref_developer_refresh_after_switch">向基帶發送刷新命令</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 8146f5472..a366b88e5 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -181,6 +181,8 @@
     <string name="pref_advanced_logs">Logs</string>
     <string name="pref_advanced_logs_desc">View recent debug logs of the application</string>
     <string name="pref_developer">Developer Options</string>
+    <string name="pref_developer_refresh_after_switch">Send refresh command to modem</string>
+    <string name="pref_developer_refresh_after_switch_desc">Whether to send a refresh command to the modem after switching profiles. Try disabling this if you see crashes.</string>
     <string name="pref_developer_unfiltered_profile_list">Show unfiltered profile list</string>
     <string name="pref_developer_unfiltered_profile_list_desc">Include non-production profiles in the list</string>
     <string name="pref_developer_ignore_tls_certificate">Ignore SM-DP+ TLS certificate</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 7d25118d1..ce700f5eb 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -57,6 +57,12 @@
         app:title="@string/pref_developer"
         app:iconSpaceReserved="false">
 
+        <CheckBoxPreference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_refresh_after_switch"
+            app:summary="@string/pref_developer_refresh_after_switch_desc"
+            app:title="@string/pref_developer_refresh_after_switch" />
+
         <CheckBoxPreference
             app:iconSpaceReserved="false"
             app:key="pref_developer_unfiltered_profile_list"

From c6963feb1731a657152f80d32677e422adb56048 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 23 Mar 2025 10:35:07 -0400
Subject: [PATCH 398/458] feat: Customizable ISD-R AID list

This is stored base64-encoded in shared preferences (to avoid XML
encoding issues).

By default we have the standard AID plus the 5ber one. We may add more
going forward.
---
 app-common/src/main/AndroidManifest.xml       |  4 ++
 .../core/DefaultEuiccChannelFactory.kt        | 23 +++++--
 .../core/DefaultEuiccChannelManager.kt        | 48 +++++++++++--
 .../openeuicc/core/EuiccChannelFactory.kt     |  8 ++-
 .../angry/openeuicc/core/EuiccChannelImpl.kt  |  8 +--
 .../angry/openeuicc/ui/IsdrAidListActivity.kt | 67 +++++++++++++++++++
 .../im/angry/openeuicc/ui/SettingsFragment.kt |  4 ++
 .../angry/openeuicc/util/PreferenceUtils.kt   | 52 ++++++++++++--
 .../im/angry/openeuicc/util/StringUtils.kt    | 18 ++++-
 .../res/layout/activity_isdr_aid_list.xml     | 23 +++++++
 .../main/res/menu/activity_isdr_aid_list.xml  | 15 +++++
 app-common/src/main/res/values-ja/strings.xml |  5 ++
 .../src/main/res/values-zh-rCN/strings.xml    |  5 ++
 .../src/main/res/values-zh-rTW/strings.xml    |  5 ++
 app-common/src/main/res/values/strings.xml    |  7 ++
 app-common/src/main/res/xml/pref_settings.xml |  6 ++
 .../core/PrivilegedEuiccChannelFactory.kt     | 10 ++-
 17 files changed, 280 insertions(+), 28 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
 create mode 100644 app-common/src/main/res/layout/activity_isdr_aid_list.xml
 create mode 100644 app-common/src/main/res/menu/activity_isdr_aid_list.xml

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index 464ae0f5f..b0324dce4 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -28,6 +28,10 @@
             android:name="im.angry.openeuicc.ui.LogsActivity"
             android:label="@string/pref_advanced_logs" />
 
+        <activity
+            android:name="im.angry.openeuicc.ui.IsdrAidListActivity"
+            android:label="@string/isdr_aid_list" />
+
         <activity
             android:exported="true"
             android:name="im.angry.openeuicc.ui.wizard.DownloadWizardActivity"
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index ea0bd6023..b24967594 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -26,14 +26,23 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         }
     }
 
-    override suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
+    override suspend fun tryOpenEuiccChannel(
+        port: UiccPortInfoCompat,
+        isdrAid: ByteArray
+    ): EuiccChannel? {
         if (port.portIndex != 0) {
-            Log.w(DefaultEuiccChannelManager.TAG, "OMAPI channel attempted on non-zero portId, this may or may not work.")
+            Log.w(
+                DefaultEuiccChannelManager.TAG,
+                "OMAPI channel attempted on non-zero portId, this may or may not work."
+            )
         }
 
         ensureSEService()
 
-        Log.i(DefaultEuiccChannelManager.TAG, "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}")
+        Log.i(
+            DefaultEuiccChannelManager.TAG,
+            "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}"
+        )
         try {
             return EuiccChannelImpl(
                 context.getString(R.string.omapi),
@@ -44,6 +53,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                     port,
                     context.preferenceRepository.verboseLoggingFlow
                 ),
+                isdrAid,
                 context.preferenceRepository.verboseLoggingFlow,
                 context.preferenceRepository.ignoreTLSCertificateFlow,
             ).also {
@@ -61,7 +71,11 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         return null
     }
 
-    override fun tryOpenUsbEuiccChannel(usbDevice: UsbDevice, usbInterface: UsbInterface): EuiccChannel? {
+    override fun tryOpenUsbEuiccChannel(
+        usbDevice: UsbDevice,
+        usbInterface: UsbInterface,
+        isdrAid: ByteArray
+    ): EuiccChannel? {
         val (bulkIn, bulkOut) = usbInterface.endpoints.bulkPair
         if (bulkIn == null || bulkOut == null) return null
         val conn = usbManager.openDevice(usbDevice) ?: return null
@@ -76,6 +90,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                 bulkOut,
                 context.preferenceRepository.verboseLoggingFlow
             ),
+            isdrAid,
             context.preferenceRepository.verboseLoggingFlow,
             context.preferenceRepository.ignoreTLSCertificateFlow,
         )
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index dd57eab2d..74ec285c0 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -12,6 +12,7 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.flow.flowOn
 import kotlinx.coroutines.flow.merge
@@ -49,6 +50,24 @@ open class DefaultEuiccChannelManager(
     protected open val uiccCards: Collection<UiccCardInfoCompat>
         get() = (0..<tm.activeModemCountCompat).map { FakeUiccCardInfoCompat(it) }
 
+    private suspend inline fun tryOpenChannelFirstValidAid(openFn: (ByteArray) -> EuiccChannel?): EuiccChannel? {
+        val isdrAidList =
+            parseIsdrAidList(appContainer.preferenceRepository.isdrAidListFlow.first())
+
+        return isdrAidList.firstNotNullOfOrNull {
+            Log.i(TAG, "Opening channel, trying ISDR AID ${it.encodeHex()}")
+
+            openFn(it)?.let { channel ->
+                if (channel.valid) {
+                    channel
+                } else {
+                    channel.close()
+                    null
+                }
+            }
+        }
+    }
+
     private suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
         lock.withLock {
             if (port.card.physicalSlotIndex == EuiccChannelManager.USB_CHANNEL_ID) {
@@ -76,9 +95,10 @@ open class DefaultEuiccChannelManager(
                 return null
             }
 
-            val channel = euiccChannelFactory.tryOpenEuiccChannel(port) ?: return null
+            val channel =
+                tryOpenChannelFirstValidAid { euiccChannelFactory.tryOpenEuiccChannel(port, it) }
 
-            if (channel.valid) {
+            if (channel != null) {
                 channelCache.add(channel)
                 return channel
             } else {
@@ -86,7 +106,6 @@ open class DefaultEuiccChannelManager(
                     TAG,
                     "Was able to open channel for logical slot ${port.logicalSlotIndex}, but the channel is invalid (cannot get eID or profiles without errors). This slot might be broken, aborting."
                 )
-                channel.close()
                 return null
             }
         }
@@ -212,7 +231,10 @@ open class DefaultEuiccChannelManager(
                     check(channel.valid) { "Invalid channel" }
                     break
                 } catch (e: Exception) {
-                    Log.d(TAG, "Slot $physicalSlotId port $portId reconnect failure, retrying in 1000 ms")
+                    Log.d(
+                        TAG,
+                        "Slot $physicalSlotId port $portId reconnect failure, retrying in 1000 ms"
+                    )
                 }
                 delay(1000)
             }
@@ -249,9 +271,18 @@ open class DefaultEuiccChannelManager(
                 // If we don't have permission, tell UI code that we found a candidate device, but we
                 // need permission to be able to do anything with it
                 if (!usbManager.hasPermission(device)) return@withContext Pair(device, false)
-                Log.i(TAG, "Found CCID interface on ${device.deviceId}:${device.vendorId}, and has permission; trying to open channel")
+                Log.i(
+                    TAG,
+                    "Found CCID interface on ${device.deviceId}:${device.vendorId}, and has permission; trying to open channel"
+                )
                 try {
-                    val channel = euiccChannelFactory.tryOpenUsbEuiccChannel(device, iface)
+                    val channel = tryOpenChannelFirstValidAid {
+                        euiccChannelFactory.tryOpenUsbEuiccChannel(
+                            device,
+                            iface,
+                            it
+                        )
+                    }
                     if (channel != null && channel.lpa.valid) {
                         usbChannel = channel
                         return@withContext Pair(device, true)
@@ -260,7 +291,10 @@ open class DefaultEuiccChannelManager(
                     // Ignored -- skip forward
                     e.printStackTrace()
                 }
-                Log.i(TAG, "No valid eUICC channel found on USB device ${device.deviceId}:${device.vendorId}")
+                Log.i(
+                    TAG,
+                    "No valid eUICC channel found on USB device ${device.deviceId}:${device.vendorId}"
+                )
             }
             return@withContext Pair(null, false)
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
index fb5d95d8b..87f588504 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
@@ -7,9 +7,13 @@ import im.angry.openeuicc.util.*
 // This class is here instead of inside DI because it contains a bit more logic than just
 // "dumb" dependency injection.
 interface EuiccChannelFactory {
-    suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel?
+    suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat, isdrAid: ByteArray): EuiccChannel?
 
-    fun tryOpenUsbEuiccChannel(usbDevice: UsbDevice, usbInterface: UsbInterface): EuiccChannel?
+    fun tryOpenUsbEuiccChannel(
+        usbDevice: UsbDevice,
+        usbInterface: UsbInterface,
+        isdrAid: ByteArray
+    ): EuiccChannel?
 
     /**
      * Release all resources used by this EuiccChannelFactory
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index a56b1ccb9..ed8797a33 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -13,21 +13,17 @@ class EuiccChannelImpl(
     override val port: UiccPortInfoCompat,
     override val intrinsicChannelName: String?,
     override val apduInterface: ApduInterface,
+    isdrAid: ByteArray,
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
-    companion object {
-        // TODO: This needs to go somewhere else.
-        val ISDR_AID = "A0000005591010FFFFFFFF8900000100".decodeHex()
-    }
-
     override val slotId = port.card.physicalSlotIndex
     override val logicalSlotId = port.logicalSlotIndex
     override val portId = port.portIndex
 
     override val lpa: LocalProfileAssistant =
         LocalProfileAssistantImpl(
-            ISDR_AID,
+            isdrAid,
             apduInterface,
             HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow)
         )
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
new file mode 100644
index 000000000..655342181
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
@@ -0,0 +1,67 @@
+package im.angry.openeuicc.ui
+
+import android.os.Bundle
+import android.text.Editable
+import android.view.Menu
+import android.view.MenuItem
+import android.widget.EditText
+import android.widget.Toast
+import androidx.activity.enableEdgeToEdge
+import androidx.appcompat.app.AppCompatActivity
+import androidx.lifecycle.lifecycleScope
+import im.angry.openeuicc.common.R
+import im.angry.openeuicc.util.preferenceRepository
+import im.angry.openeuicc.util.setupToolbarInsets
+import kotlinx.coroutines.flow.collect
+import kotlinx.coroutines.flow.onEach
+import kotlinx.coroutines.launch
+
+class IsdrAidListActivity : AppCompatActivity() {
+    private lateinit var isdrAidListEditor: EditText
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_isdr_aid_list)
+        setSupportActionBar(requireViewById(R.id.toolbar))
+        setupToolbarInsets()
+        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
+
+        isdrAidListEditor = requireViewById(R.id.isdr_aid_list_editor)
+
+        lifecycleScope.launch {
+            preferenceRepository.isdrAidListFlow.onEach {
+                isdrAidListEditor.text = Editable.Factory.getInstance().newEditable(it)
+            }.collect()
+        }
+    }
+
+    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
+        menuInflater.inflate(R.menu.activity_isdr_aid_list, menu)
+        return true
+    }
+
+    override fun onOptionsItemSelected(item: MenuItem): Boolean =
+        when (item.itemId) {
+            R.id.save -> {
+                lifecycleScope.launch {
+                    preferenceRepository.isdrAidListFlow.updatePreference(isdrAidListEditor.text.toString())
+                    Toast.makeText(
+                        this@IsdrAidListActivity,
+                        R.string.isdr_aid_list_saved,
+                        Toast.LENGTH_SHORT
+                    ).show()
+                }
+                true
+            }
+
+            R.id.reset -> {
+                lifecycleScope.launch {
+                    preferenceRepository.isdrAidListFlow.removePreference()
+                }
+                true
+            }
+
+            else -> super.onOptionsItemSelected(item)
+        }
+}
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index d137e9099..65541428e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -83,6 +83,10 @@ open class SettingsFragment: PreferenceFragmentCompat() {
 
         requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset")
             .bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
+
+        requirePreference<Preference>("pref_developer_isdr_aid_list").apply {
+            intent = Intent(requireContext(), IsdrAidListActivity::class.java)
+        }
     }
 
     protected fun <T : Preference> requirePreference(key: CharSequence) =
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index c69c5e43c..928079fb7 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -5,11 +5,13 @@ import androidx.datastore.core.DataStore
 import androidx.datastore.preferences.core.Preferences
 import androidx.datastore.preferences.core.booleanPreferencesKey
 import androidx.datastore.preferences.core.edit
+import androidx.datastore.preferences.core.stringPreferencesKey
 import androidx.datastore.preferences.preferencesDataStore
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.OpenEuiccApplication
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.map
+import java.util.Base64
 
 private val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "prefs")
 
@@ -35,6 +37,20 @@ internal object PreferenceKeys {
     val UNFILTERED_PROFILE_LIST = booleanPreferencesKey("unfiltered_profile_list")
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
     val EUICC_MEMORY_RESET = booleanPreferencesKey("euicc_memory_reset")
+    val ISDR_AID_LIST = stringPreferencesKey("isdr_aid_list")
+}
+
+const val EUICC_DEFAULT_ISDR_AID = "A0000005591010FFFFFFFF8900000100"
+
+internal object PreferenceConstants {
+    val DEFAULT_AID_LIST = """
+        # One AID per line. Comment lines start with #.
+        # eUICC standard
+        $EUICC_DEFAULT_ISDR_AID
+        
+        # 5ber
+        A0000005591010FFFFFFFF8900050500
+    """.trimIndent()
 }
 
 open class PreferenceRepository(private val context: Context) {
@@ -54,20 +70,46 @@ open class PreferenceRepository(private val context: Context) {
     val unfilteredProfileListFlow = bindFlow(PreferenceKeys.UNFILTERED_PROFILE_LIST, false)
     val ignoreTLSCertificateFlow = bindFlow(PreferenceKeys.IGNORE_TLS_CERTIFICATE, false)
     val euiccMemoryResetFlow = bindFlow(PreferenceKeys.EUICC_MEMORY_RESET, false)
+    val isdrAidListFlow = bindFlow(
+        PreferenceKeys.ISDR_AID_LIST,
+        PreferenceConstants.DEFAULT_AID_LIST,
+        { Base64.getEncoder().encodeToString(it.encodeToByteArray()) },
+        { Base64.getDecoder().decode(it).decodeToString() })
 
-    protected fun <T> bindFlow(key: Preferences.Key<T>, defaultValue: T): PreferenceFlowWrapper<T> =
-        PreferenceFlowWrapper(context, key, defaultValue)
+    protected fun <T> bindFlow(
+        key: Preferences.Key<T>,
+        defaultValue: T,
+        encoder: (T) -> T = { it },
+        decoder: (T) -> T = { it }
+    ): PreferenceFlowWrapper<T> =
+        PreferenceFlowWrapper(context, key, defaultValue, encoder, decoder)
 }
 
 class PreferenceFlowWrapper<T> private constructor(
     private val context: Context,
     private val key: Preferences.Key<T>,
     inner: Flow<T>,
+    private val encoder: (T) -> T,
 ) : Flow<T> by inner {
-    internal constructor(context: Context, key: Preferences.Key<T>, defaultValue: T) :
-            this(context, key, context.dataStore.data.map { it[key] ?: defaultValue })
+    internal constructor(
+        context: Context,
+        key: Preferences.Key<T>,
+        defaultValue: T,
+        encoder: (T) -> T,
+        decoder: (T) -> T
+    ) :
+            this(
+                context,
+                key,
+                context.dataStore.data.map { it[key]?.let(decoder) ?: defaultValue },
+                encoder
+            )
 
     suspend fun updatePreference(value: T) {
-        context.dataStore.edit { it[key] = value }
+        context.dataStore.edit { it[key] = encoder(value) }
+    }
+
+    suspend fun removePreference() {
+        context.dataStore.edit { it.remove(key) }
     }
 }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index 8d724620f..9f993a318 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -1,7 +1,7 @@
 package im.angry.openeuicc.util
 
 fun String.decodeHex(): ByteArray {
-    check(length % 2 == 0) { "Must have an even length" }
+    require(length % 2 == 0) { "Must have an even length" }
 
     val decodedLength = length / 2
     val out = ByteArray(decodedLength)
@@ -29,6 +29,22 @@ fun formatFreeSpace(size: Int): String =
         "$size B"
     }
 
+/**
+ * Decode a list of potential ISDR AIDs, one per line. Lines starting with '#' are ignored.
+ * If none is found, at least EUICC_DEFAULT_ISDR_AID is returned
+ */
+fun parseIsdrAidList(s: String): List<ByteArray> =
+    s.split('\n').map(String::trim).filter { !it.startsWith('#') }
+        .map(String::trim)
+        .mapNotNull {
+            try {
+                it.decodeHex()
+            } catch (_: IllegalArgumentException) {
+                null
+            }
+        }
+        .ifEmpty { listOf(EUICC_DEFAULT_ISDR_AID.decodeHex()) }
+
 fun String.prettyPrintJson(): String {
     val ret = StringBuilder()
     var inQuotes = false
diff --git a/app-common/src/main/res/layout/activity_isdr_aid_list.xml b/app-common/src/main/res/layout/activity_isdr_aid_list.xml
new file mode 100644
index 000000000..06a75a19e
--- /dev/null
+++ b/app-common/src/main/res/layout/activity_isdr_aid_list.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <include layout="@layout/toolbar_activity" />
+
+    <EditText
+        android:id="@+id/isdr_aid_list_editor"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:importantForAutofill="no"
+        android:inputType="textMultiLine"
+        android:gravity="top|start"
+        app:layout_constraintTop_toBottomOf="@id/toolbar"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        tools:ignore="LabelFor" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/activity_isdr_aid_list.xml b/app-common/src/main/res/menu/activity_isdr_aid_list.xml
new file mode 100644
index 000000000..32f178a99
--- /dev/null
+++ b/app-common/src/main/res/menu/activity_isdr_aid_list.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/save"
+        android:icon="@drawable/ic_save_as_black"
+        android:title="@string/logs_save"
+        app:showAsAction="always" />
+
+    <item
+        android:id="@+id/reset"
+        android:title="@string/reset"
+        android:icon="@drawable/ic_refresh_black"
+        app:showAsAction="ifRoom" />
+</menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 35fd40014..d51e2c79d 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -124,6 +124,7 @@
     <string name="logs_filename_template">%s のログ</string>
     <string name="developer_options_steps">開発者になるまであと %d ステップです。</string>
     <string name="developer_options_enabled">あなたは開発者になりました！</string>
+    <string name="isdr_aid_list_saved">カスタム ISD-R AID リストが保存されました</string>
     <string name="pref_settings">設定</string>
     <string name="pref_notifications">通知</string>
     <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。必要に応じてこの動作を微調整できます。</string>
@@ -148,6 +149,7 @@
     <string name="pref_developer_unfiltered_profile_list_desc">非運用のプロファイルも含めます</string>
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
     <string name="pref_developer_ignore_tls_certificate_desc">RSP サーバーで使用される TLS 証明書を受け入れます</string>
+    <string name="pref_developer_isdr_aid_list_desc">一部のブランドの取り外し可能な eUICC では、独自の非標準 ISD-R AID が使用されている場合があり、サードパーティ アプリからアクセスできなくなります。アプリはこのリストに追加された非標準の AID の使用を試みる可能性がありますが、動作することは保証されません。</string>
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
@@ -164,4 +166,7 @@
     <string name="pref_developer_euicc_memory_reset">eUICC の消去を可能にする</string>
     <string name="pref_developer_euicc_memory_reset_desc">この操作は、デフォルトでは非表示になっている危険な操作です。代わりに、すべての構成ファイルを手動で削除することもできます。</string>
     <string name="pref_developer_refresh_after_switch">モデムに更新コマンドを送信</string>
+    <string name="pref_developer_isdr_aid_list">ISD-R AID リストのカスタマイズ</string>
+    <string name="reset">リセット</string>
+    <string name="isdr_aid_list">ISD-R AID リスト</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 2e069bd63..32ced907c 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -65,6 +65,7 @@
     <string name="profile_notification_delete">删除</string>
     <string name="logs_save">保存日志</string>
     <string name="logs_filename_template">%s 的日志</string>
+    <string name="isdr_aid_list_saved">自定义 ISD-R AID 列表已保存</string>
     <string name="pref_settings">设置</string>
     <string name="pref_notifications">通知</string>
     <string name="pref_notifications_desc">操作 eSIM 配置文件会向运营商发送通知。根据需要在此处微调此行为。</string>
@@ -81,6 +82,7 @@
     <string name="pref_advanced_verbose_logging_desc">详细日志中包含敏感信息，开启此功能后请仅与你信任的人共享你的日志。</string>
     <string name="pref_advanced_logs">日志</string>
     <string name="pref_advanced_logs_desc">查看应用程序的最新调试日志</string>
+    <string name="pref_developer_isdr_aid_list_desc">某些品牌的可移除 eUICC 可能会使用自己的非标准 ISD-R AID，导致第三方应用无法访问。此 App 可以尝试使用此列表中添加的非标准 AID，但不能保证它们一定有效。</string>
     <string name="pref_info">信息</string>
     <string name="pref_info_app_version">App 版本</string>
     <string name="pref_info_source_code">源码</string>
@@ -164,4 +166,7 @@
     <string name="pref_developer_euicc_memory_reset">允许擦除 eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">此操作是默认隐藏的危险操作。作为替代方案，您可以手动删除所有配置文件。</string>
     <string name="pref_developer_refresh_after_switch">向基带发送刷新命令</string>
+    <string name="pref_developer_isdr_aid_list">自定义 ISD-R AID 列表</string>
+    <string name="reset">重置</string>
+    <string name="isdr_aid_list">ISD-R AID 列表</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 729893ca4..5136bf739 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -65,6 +65,7 @@
     <string name="profile_notification_delete">刪除</string>
     <string name="logs_save">儲存日誌</string>
     <string name="logs_filename_template">%s 的日誌</string>
+    <string name="isdr_aid_list_saved">自訂 ISD-R AID 列表已儲存</string>
     <string name="pref_settings">設定</string>
     <string name="pref_notifications">通知</string>
     <string name="pref_notifications_desc">變更 eSIM 設定檔會向電信業者傳送通知。根據需要在此處微調此行為。</string>
@@ -81,6 +82,7 @@
     <string name="pref_advanced">進階</string>
     <string name="pref_advanced_disable_safeguard_removable_esim">允許 停用/刪除 已啟用的設定檔</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">預設情況下，此應用程式會阻止您停用可插拔 eSIM 中已啟用的設定檔。\n因為這樣做 <i>有時</i> 會導致無法存取。\n勾選此框以 <i>移除</i> 此保護措施。</string>
+    <string name="pref_developer_isdr_aid_list_desc">某些品牌的可移除 eUICC 可能會使用自己的非標準 ISD-R AID，導致第三方應用程式無法存取。此 App 可以嘗試使用此清單中新增的非標準 AID，但不能保證它們一定有效。</string>
     <string name="pref_info">資訊</string>
     <string name="pref_info_app_version">App 版本</string>
     <string name="pref_info_source_code">原始碼</string>
@@ -164,4 +166,7 @@
     <string name="pref_developer_euicc_memory_reset">允許擦除 eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">此操作是預設隱藏的危險操作。作為替代方案，您可以手動刪除所有設定檔。</string>
     <string name="pref_developer_refresh_after_switch">向基帶發送刷新命令</string>
+    <string name="pref_developer_isdr_aid_list">自訂 ISD-R AID 列表</string>
+    <string name="reset">重置</string>
+    <string name="isdr_aid_list">ISD-R AID 列表</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a366b88e5..5e4e4da03 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -162,6 +162,11 @@
     <string name="developer_options_steps">You are %d steps away from being a developer.</string>
     <string name="developer_options_enabled">You are now a developer!</string>
 
+    <string name="reset">Reset</string>
+
+    <string name="isdr_aid_list">ISD-R AID List</string>
+    <string name="isdr_aid_list_saved">Saved custom ISD-R AID list.</string>
+
     <string name="pref_settings">Settings</string>
     <string name="pref_notifications">Notifications</string>
     <string name="pref_notifications_desc">eSIM profile operations send notifications to the carrier. Fine-tune this behavior as needed here.</string>
@@ -189,6 +194,8 @@
     <string name="pref_developer_ignore_tls_certificate_desc">Accept any TLS certificate used by the RSP server</string>
     <string name="pref_developer_euicc_memory_reset">Allow erasing eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">This is a dangerous operation and hidden by default. As an alternative, you can delete all profiles manually.</string>
+    <string name="pref_developer_isdr_aid_list">Customize ISD-R AID list</string>
+    <string name="pref_developer_isdr_aid_list_desc">Some brands of removable eUICCs may use their own non-standard ISD-R AID, rendering them inaccessible to third-party apps. We can attempt to use non-standard AIDs added in this list, but there is no guarantee that they will work.</string>
     <string name="pref_info">Info</string>
     <string name="pref_info_app_version">App Version</string>
     <string name="pref_info_source_code">Source Code</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index ce700f5eb..690a12013 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -81,6 +81,12 @@
             app:summary="@string/pref_developer_euicc_memory_reset_desc"
             app:title="@string/pref_developer_euicc_memory_reset" />
 
+        <Preference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_isdr_aid_list"
+            app:title="@string/pref_developer_isdr_aid_list"
+            app:summary="@string/pref_developer_isdr_aid_list_desc" />
+
     </im.angry.openeuicc.ui.preference.LongSummaryPreferenceCategory>
 
     <PreferenceCategory
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index d9bceda3e..5489bd5bd 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -14,12 +14,15 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
         get() = context
 
     @Suppress("NAME_SHADOWING")
-    override suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat): EuiccChannel? {
+    override suspend fun tryOpenEuiccChannel(
+        port: UiccPortInfoCompat,
+        isdrAid: ByteArray
+    ): EuiccChannel? {
         val port = port as RealUiccPortInfoCompat
         if (port.card.isRemovable) {
             // Attempt unprivileged (OMAPI) before TelephonyManager
             // but still try TelephonyManager in case OMAPI is broken
-            super.tryOpenEuiccChannel(port)?.let { return it }
+            super.tryOpenEuiccChannel(port, isdrAid)?.let { return it }
         }
 
         if (port.card.isEuicc || preferenceRepository.removableTelephonyManagerFlow.first()) {
@@ -37,6 +40,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                         telephonyManager,
                         context.preferenceRepository.verboseLoggingFlow
                     ),
+                    isdrAid,
                     context.preferenceRepository.verboseLoggingFlow,
                     context.preferenceRepository.ignoreTLSCertificateFlow,
                 )
@@ -49,6 +53,6 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
             }
         }
 
-        return super.tryOpenEuiccChannel(port)
+        return super.tryOpenEuiccChannel(port, isdrAid)
     }
 }
\ No newline at end of file

From d7bfd84de925735957b780e3f53f6510c95c8303 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 23 Mar 2025 11:00:28 -0400
Subject: [PATCH 399/458] CompatibilityCheck: use the shared default AID
 constant

---
 .../java/im/angry/openeuicc/util/CompatibilityCheck.kt   | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 8424c5507..94ee9d6c8 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -128,10 +128,6 @@ internal class OmapiConnCheck(private val context: Context): CompatibilityCheck(
 }
 
 internal class IsdrChannelAccessCheck(private val context: Context): CompatibilityCheck(context) {
-    companion object {
-        val ISDR_AID = "A0000005591010FFFFFFFF8900000100".decodeHex()
-    }
-
     override val title: String
         get() = context.getString(R.string.compatibility_check_isdr_channel)
     override val defaultDescription: String
@@ -147,7 +143,10 @@ internal class IsdrChannelAccessCheck(private val context: Context): Compatibili
 
         val (validSlotIds, result) = readers.map {
             try {
-                it.openSession().openLogicalChannel(ISDR_AID)?.close()
+                // Note: we ONLY check the default ISD-R AID, because this test is for the _device_,
+                // NOT the eUICC. We don't care what AID a potential eUICC might use, all we need to
+                // check is we can open _some_ AID.
+                it.openSession().openLogicalChannel(EUICC_DEFAULT_ISDR_AID.decodeHex())?.close()
                 Pair(it.slotIndex, State.SUCCESS)
             } catch (_: SecurityException) {
                 // Ignore; this is expected when everything works

From 92fbfc52296dcc9819bf5c4974d6b78cd3fb6742 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 1 Apr 2025 03:18:02 +0200
Subject: [PATCH 400/458] chore: add more isd-r aids (#184)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/184
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/util/PreferenceUtils.kt   | 28 +++++++++++++------
 .../res/layout/activity_isdr_aid_list.xml     |  1 +
 2 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 928079fb7..5f4aec442 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -45,11 +45,22 @@ const val EUICC_DEFAULT_ISDR_AID = "A0000005591010FFFFFFFF8900000100"
 internal object PreferenceConstants {
     val DEFAULT_AID_LIST = """
         # One AID per line. Comment lines start with #.
+        # Refs: <https://euicc-manual.osmocom.org/docs/lpa/applet-id-oem/>
+
         # eUICC standard
         $EUICC_DEFAULT_ISDR_AID
-        
-        # 5ber
+
+        # eSTK.me
+        A06573746B6D65FFFFFFFF4953442D52
+
+        # eSIM.me
+        A0000005591010000000008900000300
+
+        # 5ber.eSIM
         A0000005591010FFFFFFFF8900050500
+
+        # Xesim
+        A0000005591010FFFFFFFF8900000177
     """.trimIndent()
 }
 
@@ -97,13 +108,12 @@ class PreferenceFlowWrapper<T> private constructor(
         defaultValue: T,
         encoder: (T) -> T,
         decoder: (T) -> T
-    ) :
-            this(
-                context,
-                key,
-                context.dataStore.data.map { it[key]?.let(decoder) ?: defaultValue },
-                encoder
-            )
+    ) : this(
+        context,
+        key,
+        context.dataStore.data.map { it[key]?.let(decoder) ?: defaultValue },
+        encoder
+    )
 
     suspend fun updatePreference(value: T) {
         context.dataStore.edit { it[key] = encoder(value) }
diff --git a/app-common/src/main/res/layout/activity_isdr_aid_list.xml b/app-common/src/main/res/layout/activity_isdr_aid_list.xml
index 06a75a19e..48135fbe8 100644
--- a/app-common/src/main/res/layout/activity_isdr_aid_list.xml
+++ b/app-common/src/main/res/layout/activity_isdr_aid_list.xml
@@ -11,6 +11,7 @@
         android:id="@+id/isdr_aid_list_editor"
         android:layout_width="0dp"
         android:layout_height="0dp"
+        android:fontFamily="monospace"
         android:importantForAutofill="no"
         android:inputType="textMultiLine"
         android:gravity="top|start"

From 05abed117a71796648b0ab6ac51a60ad63b57e8c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 1 Apr 2025 03:18:22 +0200
Subject: [PATCH 401/458] fix: click sn copy (#186)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/186
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 4e499dc24..aa922be7b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -104,7 +104,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(Item(R.string.euicc_info_eid, channel.lpa.eID, copiedToastResId = R.string.toast_eid_copied))
         channel.tryParseEuiccVendorInfo()?.let { vendorInfo ->
             vendorInfo.skuName?.let { add(Item(R.string.euicc_info_sku, it)) }
-            vendorInfo.serialNumber?.let { add(Item(R.string.euicc_info_sn, it)) }
+            vendorInfo.serialNumber?.let { add(Item(R.string.euicc_info_sn, it, copiedToastResId = R.string.toast_sn_copied)) }
             vendorInfo.firmwareVersion?.let { add(Item(R.string.euicc_info_fw_ver, it)) }
             vendorInfo.bootloaderVersion?.let { add(Item(R.string.euicc_info_bl_ver, it)) }
         }

From 3662f93760b6c418e89d585fa024e15f522f2ed0 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 1 Apr 2025 03:18:45 +0200
Subject: [PATCH 402/458] fix: send terminal capabilities (#187)

fix 9eSIM v1 (G+D) on USB

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/187
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/core/usb/UsbApduInterface.kt | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index f9e764b50..31ba333da 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -45,6 +45,15 @@ class UsbApduInterface(
             e.printStackTrace()
             throw e
         }
+
+        // Send Terminal Capabilities
+        // Specs: ETSI TS 102 221 v15.0.0 - 11.1.19 TERMINAL CAPABILITY
+        val terminalCapabilities = buildCmd(
+            0x80.toByte(), 0xaa.toByte(), 0x00, 0x00,
+            "A9088100820101830107".decodeHex(),
+            le = null,
+        )
+        transmitApduByChannel(terminalCapabilities, 0,)
     }
 
     override fun disconnect() {

From 00ddf092874bf3aa863bed925eb2c6fddcc4eb0b Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 1 Apr 2025 03:19:21 +0200
Subject: [PATCH 403/458] fix: improve lpa string parsing (#181)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/181
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../java/im/angry/openeuicc/util/LPAString.kt    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt b/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
index 20956fb52..63a81f19a 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/LPAString.kt
@@ -8,15 +8,15 @@ data class LPAString(
 ) {
     companion object {
         fun parse(input: String): LPAString {
-            val components = input.removePrefix("LPA:").split('$')
-            if (components.size < 2 || components[0] != "1") {
-                throw IllegalArgumentException("Invalid activation code format")
-            }
+            var token = input
+            if (token.startsWith("LPA:", ignoreCase = true)) token = token.drop(4)
+            val components = token.split('$').map { it.trim().ifBlank { null } }
+            require(components.getOrNull(0) == "1") { "Invalid AC_Format" }
             return LPAString(
-                address = components[1].trim(),
-                matchingId = components.getOrNull(2)?.trim()?.ifBlank { null },
-                oid = components.getOrNull(3)?.trim()?.ifBlank { null },
-                confirmationCodeRequired = components.getOrNull(4)?.trim() == "1"
+                requireNotNull(components.getOrNull(1)) { "SM-DP+ is required" },
+                components.getOrNull(2),
+                components.getOrNull(3),
+                components.getOrNull(4) == "1"
             )
         }
     }

From 6c774450ec65924b6058338444379447b3d0d74f Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 1 Apr 2025 23:13:57 +0200
Subject: [PATCH 404/458] fix: usb isd-r aid fallback (#188)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/188
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../core/DefaultEuiccChannelFactory.kt        | 41 +++++++++++--------
 .../core/DefaultEuiccChannelManager.kt        |  6 +--
 .../openeuicc/core/usb/UsbApduInterface.kt    |  2 +-
 .../im/angry/openeuicc/util/StringUtils.kt    | 13 +++---
 .../core/PrivilegedEuiccChannelFactory.kt     |  4 +-
 5 files changed, 34 insertions(+), 32 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index b24967594..870baae56 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -60,11 +60,11 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
                 Log.i(DefaultEuiccChannelManager.TAG, "Is OMAPI channel, setting MSS to 60")
                 it.lpa.setEs10xMss(60)
             }
-        } catch (e: IllegalArgumentException) {
+        } catch (_: IllegalArgumentException) {
             // Failed
             Log.w(
                 DefaultEuiccChannelManager.TAG,
-                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex}."
+                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex} with ISD-R AID: ${isdrAid.encodeHex()}."
             )
         }
 
@@ -80,20 +80,29 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         if (bulkIn == null || bulkOut == null) return null
         val conn = usbManager.openDevice(usbDevice) ?: return null
         if (!conn.claimInterface(usbInterface, true)) return null
-        return EuiccChannelImpl(
-            context.getString(R.string.usb),
-            FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
-            intrinsicChannelName = usbDevice.productName,
-            UsbApduInterface(
-                conn,
-                bulkIn,
-                bulkOut,
-                context.preferenceRepository.verboseLoggingFlow
-            ),
-            isdrAid,
-            context.preferenceRepository.verboseLoggingFlow,
-            context.preferenceRepository.ignoreTLSCertificateFlow,
-        )
+        try {
+            return EuiccChannelImpl(
+                context.getString(R.string.usb),
+                FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
+                intrinsicChannelName = usbDevice.productName,
+                UsbApduInterface(
+                    conn,
+                    bulkIn,
+                    bulkOut,
+                    context.preferenceRepository.verboseLoggingFlow
+                ),
+                isdrAid,
+                context.preferenceRepository.verboseLoggingFlow,
+                context.preferenceRepository.ignoreTLSCertificateFlow,
+            )
+        } catch (_: IllegalArgumentException) {
+            // Failed
+            Log.w(
+                DefaultEuiccChannelManager.TAG,
+                "USB APDU interface unavailable for ISD-R AID: ${isdrAid.encodeHex()}."
+            )
+        }
+        return null
     }
 
     override fun cleanup() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index 74ec285c0..ac9ba0876 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -277,11 +277,7 @@ open class DefaultEuiccChannelManager(
                 )
                 try {
                     val channel = tryOpenChannelFirstValidAid {
-                        euiccChannelFactory.tryOpenUsbEuiccChannel(
-                            device,
-                            iface,
-                            it
-                        )
+                        euiccChannelFactory.tryOpenUsbEuiccChannel(device, iface, it)
                     }
                     if (channel != null && channel.lpa.valid) {
                         usbChannel = channel
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 31ba333da..107395feb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -53,7 +53,7 @@ class UsbApduInterface(
             "A9088100820101830107".decodeHex(),
             le = null,
         )
-        transmitApduByChannel(terminalCapabilities, 0,)
+        transmitApduByChannel(terminalCapabilities, 0)
     }
 
     override fun disconnect() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index 9f993a318..079853ebd 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -34,15 +34,12 @@ fun formatFreeSpace(size: Int): String =
  * If none is found, at least EUICC_DEFAULT_ISDR_AID is returned
  */
 fun parseIsdrAidList(s: String): List<ByteArray> =
-    s.split('\n').map(String::trim).filter { !it.startsWith('#') }
+    s.split('\n')
         .map(String::trim)
-        .mapNotNull {
-            try {
-                it.decodeHex()
-            } catch (_: IllegalArgumentException) {
-                null
-            }
-        }
+        .filter { !it.startsWith('#') }
+        .map(String::trim)
+        .filter(String::isNotEmpty)
+        .mapNotNull { runCatching(it::decodeHex).getOrNull() }
         .ifEmpty { listOf(EUICC_DEFAULT_ISDR_AID.decodeHex()) }
 
 fun String.prettyPrintJson(): String {
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 5489bd5bd..68eddefd1 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -44,11 +44,11 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                     context.preferenceRepository.verboseLoggingFlow,
                     context.preferenceRepository.ignoreTLSCertificateFlow,
                 )
-            } catch (e: IllegalArgumentException) {
+            } catch (_: IllegalArgumentException) {
                 // Failed
                 Log.w(
                     DefaultEuiccChannelManager.TAG,
-                    "TelephonyManager APDU interface unavailable for slot ${port.card.physicalSlotIndex} port ${port.portIndex}, falling back"
+                    "TelephonyManager APDU interface unavailable for slot ${port.card.physicalSlotIndex} port ${port.portIndex} with ISD-R AID: ${isdrAid.encodeHex()}."
                 )
             }
         }

From 994324acb6d7887b703ab2d1ee5479100eab1e56 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 5 Apr 2025 17:57:47 -0400
Subject: [PATCH 405/458] Fix up back button for IsdrAidListActivity

---
 .../main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
index 655342181..022a391bb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/IsdrAidListActivity.kt
@@ -62,6 +62,11 @@ class IsdrAidListActivity : AppCompatActivity() {
                 true
             }
 
+            android.R.id.home -> {
+                finish()
+                true
+            }
+
             else -> super.onOptionsItemSelected(item)
         }
 }
\ No newline at end of file

From 1fda1204591b10215bcdcd858e2b68b2e1f6387c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 5 Apr 2025 20:44:15 -0400
Subject: [PATCH 406/458] Avoid reconnecting to USB iface repeatedly while
 trying different AIDs

---
 .../core/DefaultEuiccChannelFactory.kt        | 24 +----
 .../core/DefaultEuiccChannelManager.kt        | 11 ++-
 .../openeuicc/core/EuiccChannelFactory.kt     |  6 +-
 .../openeuicc/core/usb/UsbApduInterface.kt    | 43 ++-------
 .../openeuicc/core/usb/UsbCcidContext.kt      | 87 +++++++++++++++++++
 5 files changed, 111 insertions(+), 60 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidContext.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 870baae56..0de99b563 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -1,25 +1,17 @@
 package im.angry.openeuicc.core
 
 import android.content.Context
-import android.hardware.usb.UsbDevice
-import android.hardware.usb.UsbInterface
-import android.hardware.usb.UsbManager
 import android.se.omapi.SEService
 import android.util.Log
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.core.usb.UsbApduInterface
-import im.angry.openeuicc.core.usb.bulkPair
-import im.angry.openeuicc.core.usb.endpoints
+import im.angry.openeuicc.core.usb.UsbCcidContext
 import im.angry.openeuicc.util.*
 import java.lang.IllegalArgumentException
 
 open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccChannelFactory {
     private var seService: SEService? = null
 
-    private val usbManager by lazy {
-        context.getSystemService(Context.USB_SERVICE) as UsbManager
-    }
-
     private suspend fun ensureSEService() {
         if (seService == null || !seService!!.isConnected) {
             seService = connectSEService(context)
@@ -72,24 +64,16 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
     }
 
     override fun tryOpenUsbEuiccChannel(
-        usbDevice: UsbDevice,
-        usbInterface: UsbInterface,
+        ccidCtx: UsbCcidContext,
         isdrAid: ByteArray
     ): EuiccChannel? {
-        val (bulkIn, bulkOut) = usbInterface.endpoints.bulkPair
-        if (bulkIn == null || bulkOut == null) return null
-        val conn = usbManager.openDevice(usbDevice) ?: return null
-        if (!conn.claimInterface(usbInterface, true)) return null
         try {
             return EuiccChannelImpl(
                 context.getString(R.string.usb),
                 FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
-                intrinsicChannelName = usbDevice.productName,
+                intrinsicChannelName = ccidCtx.productName,
                 UsbApduInterface(
-                    conn,
-                    bulkIn,
-                    bulkOut,
-                    context.preferenceRepository.verboseLoggingFlow
+                    ccidCtx
                 ),
                 isdrAid,
                 context.preferenceRepository.verboseLoggingFlow,
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
index ac9ba0876..6b336cdae 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelManager.kt
@@ -5,6 +5,7 @@ import android.hardware.usb.UsbDevice
 import android.hardware.usb.UsbManager
 import android.telephony.SubscriptionManager
 import android.util.Log
+import im.angry.openeuicc.core.usb.UsbCcidContext
 import im.angry.openeuicc.core.usb.smartCard
 import im.angry.openeuicc.core.usb.interfaces
 import im.angry.openeuicc.di.AppContainer
@@ -275,11 +276,15 @@ open class DefaultEuiccChannelManager(
                     TAG,
                     "Found CCID interface on ${device.deviceId}:${device.vendorId}, and has permission; trying to open channel"
                 )
+
+                val ccidCtx = UsbCcidContext.createFromUsbDevice(context, device, iface) ?: return@forEach
+
                 try {
                     val channel = tryOpenChannelFirstValidAid {
-                        euiccChannelFactory.tryOpenUsbEuiccChannel(device, iface, it)
+                        euiccChannelFactory.tryOpenUsbEuiccChannel(ccidCtx, it)
                     }
                     if (channel != null && channel.lpa.valid) {
+                        ccidCtx.allowDisconnect = true
                         usbChannel = channel
                         return@withContext Pair(device, true)
                     }
@@ -287,6 +292,10 @@ open class DefaultEuiccChannelManager(
                     // Ignored -- skip forward
                     e.printStackTrace()
                 }
+
+                ccidCtx.allowDisconnect = true
+                ccidCtx.disconnect()
+
                 Log.i(
                     TAG,
                     "No valid eUICC channel found on USB device ${device.deviceId}:${device.vendorId}"
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
index 87f588504..ba587a638 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelFactory.kt
@@ -1,7 +1,6 @@
 package im.angry.openeuicc.core
 
-import android.hardware.usb.UsbDevice
-import android.hardware.usb.UsbInterface
+import im.angry.openeuicc.core.usb.UsbCcidContext
 import im.angry.openeuicc.util.*
 
 // This class is here instead of inside DI because it contains a bit more logic than just
@@ -10,8 +9,7 @@ interface EuiccChannelFactory {
     suspend fun tryOpenEuiccChannel(port: UiccPortInfoCompat, isdrAid: ByteArray): EuiccChannel?
 
     fun tryOpenUsbEuiccChannel(
-        usbDevice: UsbDevice,
-        usbInterface: UsbInterface,
+        ccidCtx: UsbCcidContext,
         isdrAid: ByteArray
     ): EuiccChannel?
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
index 107395feb..4a4ccb98c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbApduInterface.kt
@@ -1,27 +1,19 @@
 package im.angry.openeuicc.core.usb
 
-import android.hardware.usb.UsbDeviceConnection
-import android.hardware.usb.UsbEndpoint
 import android.util.Log
 import im.angry.openeuicc.core.ApduInterfaceAtrProvider
 import im.angry.openeuicc.util.*
-import kotlinx.coroutines.flow.Flow
 import net.typeblog.lpac_jni.ApduInterface
 
 class UsbApduInterface(
-    private val conn: UsbDeviceConnection,
-    private val bulkIn: UsbEndpoint,
-    private val bulkOut: UsbEndpoint,
-    private val verboseLoggingFlow: Flow<Boolean>
+    private val ccidCtx: UsbCcidContext
 ) : ApduInterface, ApduInterfaceAtrProvider {
     companion object {
         private const val TAG = "UsbApduInterface"
     }
 
-    private lateinit var ccidDescription: UsbCcidDescription
-    private lateinit var transceiver: UsbCcidTransceiver
-
-    override var atr: ByteArray? = null
+    override val atr: ByteArray?
+        get() = ccidCtx.atr
 
     override val valid: Boolean
         get() = channels.isNotEmpty()
@@ -29,22 +21,7 @@ class UsbApduInterface(
     private var channels = mutableSetOf<Int>()
 
     override fun connect() {
-        ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
-
-        if (!ccidDescription.hasT0Protocol) {
-            throw IllegalArgumentException("Unsupported card reader; T=0 support is required")
-        }
-
-        transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription, verboseLoggingFlow)
-
-        try {
-            // 6.1.1.1 PC_to_RDR_IccPowerOn (Page 20 of 40)
-            // https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
-            atr = transceiver.iccPowerOn().data
-        } catch (e: Exception) {
-            e.printStackTrace()
-            throw e
-        }
+        ccidCtx.connect()
 
         // Send Terminal Capabilities
         // Specs: ETSI TS 102 221 v15.0.0 - 11.1.19 TERMINAL CAPABILITY
@@ -56,11 +33,7 @@ class UsbApduInterface(
         transmitApduByChannel(terminalCapabilities, 0)
     }
 
-    override fun disconnect() {
-        conn.close()
-
-        atr = null
-    }
+    override fun disconnect() = ccidCtx.disconnect()
 
     override fun logicalChannelOpen(aid: ByteArray): Int {
         // OPEN LOGICAL CHANNEL
@@ -149,7 +122,7 @@ class UsbApduInterface(
         // OR the channel mask into the CLA byte
         realTx[0] = ((realTx[0].toInt() and 0xFC) or channel.toInt()).toByte()
 
-        var resp = transceiver.sendXfrBlock(realTx).data!!
+        var resp = ccidCtx.transceiver.sendXfrBlock(realTx).data!!
 
         if (resp.size < 2) throw RuntimeException("APDU response smaller than 2 (sw1 + sw2)!")
 
@@ -160,7 +133,7 @@ class UsbApduInterface(
             // 0x6C = wrong le
             // so we fix the le field here
             realTx[realTx.size - 1] = resp[resp.size - 1]
-            resp = transceiver.sendXfrBlock(realTx).data!!
+            resp = ccidCtx.transceiver.sendXfrBlock(realTx).data!!
         } else if (sw1 == 0x61) {
             // 0x61 = X bytes available
             // continue reading by GET RESPONSE
@@ -170,7 +143,7 @@ class UsbApduInterface(
                     realTx[0], 0xC0.toByte(), 0x00, 0x00, sw2.toByte()
                 )
 
-                val tmp = transceiver.sendXfrBlock(getResponseCmd).data!!
+                val tmp = ccidCtx.transceiver.sendXfrBlock(getResponseCmd).data!!
 
                 resp = resp.sliceArray(0 until (resp.size - 2)) + tmp
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidContext.kt b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidContext.kt
new file mode 100644
index 000000000..caf69e7de
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/core/usb/UsbCcidContext.kt
@@ -0,0 +1,87 @@
+package im.angry.openeuicc.core.usb
+
+import android.content.Context
+import android.hardware.usb.UsbDevice
+import android.hardware.usb.UsbDeviceConnection
+import android.hardware.usb.UsbEndpoint
+import android.hardware.usb.UsbInterface
+import android.hardware.usb.UsbManager
+import im.angry.openeuicc.util.preferenceRepository
+import kotlinx.coroutines.flow.Flow
+
+/**
+ * A wrapper over an usb device + interface, manages the lifecycle independent
+ * of the APDU interface exposed to lpac-jni.
+ *
+ * This allows us to try multiple AIDs on each interface without opening / closing
+ * the USB connection numerous times.
+ */
+class UsbCcidContext private constructor(
+    private val conn: UsbDeviceConnection,
+    private val bulkIn: UsbEndpoint,
+    private val bulkOut: UsbEndpoint,
+    val productName: String,
+    val verboseLoggingFlow: Flow<Boolean>
+) {
+    companion object {
+        fun createFromUsbDevice(
+            context: Context,
+            usbDevice: UsbDevice,
+            usbInterface: UsbInterface
+        ): UsbCcidContext? = runCatching {
+            val (bulkIn, bulkOut) = usbInterface.endpoints.bulkPair
+            if (bulkIn == null || bulkOut == null) return@runCatching null
+            val conn = context.getSystemService(UsbManager::class.java).openDevice(usbDevice)
+                ?: return@runCatching null
+            if (!conn.claimInterface(usbInterface, true)) return@runCatching null
+            UsbCcidContext(
+                conn,
+                bulkIn,
+                bulkOut,
+                usbDevice.productName ?: "USB",
+                context.preferenceRepository.verboseLoggingFlow
+            )
+        }.getOrNull()
+    }
+
+    /**
+     * When set to false (the default), the disconnect() method does nothing.
+     * This allows the separation of device disconnection from lpac-jni's APDU interface.
+     */
+    var allowDisconnect = false
+    private var initialized = false
+    lateinit var transceiver: UsbCcidTransceiver
+    var atr: ByteArray? = null
+
+    fun connect() {
+        if (initialized) {
+            return
+        }
+
+        val ccidDescription = UsbCcidDescription.fromRawDescriptors(conn.rawDescriptors)!!
+
+        if (!ccidDescription.hasT0Protocol) {
+            throw IllegalArgumentException("Unsupported card reader; T=0 support is required")
+        }
+
+        transceiver = UsbCcidTransceiver(conn, bulkIn, bulkOut, ccidDescription, verboseLoggingFlow)
+
+        try {
+            // 6.1.1.1 PC_to_RDR_IccPowerOn (Page 20 of 40)
+            // https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
+            atr = transceiver.iccPowerOn().data
+        } catch (e: Exception) {
+            e.printStackTrace()
+            throw e
+        }
+
+        initialized = true
+    }
+
+    fun disconnect() {
+        if (initialized && allowDisconnect) {
+            conn.close()
+            atr = null
+        }
+    }
+}

From 68114fa863623c2b6068ed47501df1ae611288c6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sat, 5 Apr 2025 20:50:10 -0400
Subject: [PATCH 407/458] Expose the current ISD-R AID in use

---
 .../src/main/java/im/angry/openeuicc/core/EuiccChannel.kt    | 5 +++++
 .../main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt    | 2 +-
 .../main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt | 2 ++
 .../src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt | 1 +
 app-common/src/main/res/values/strings.xml                   | 1 +
 5 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
index 597a70d26..b20932fe1 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannel.kt
@@ -34,5 +34,10 @@ interface EuiccChannel {
      */
     val apduInterface: ApduInterface
 
+    /**
+     * The AID of the ISD-R channel currently in use
+     */
+    val isdrAid: ByteArray
+
     fun close()
 }
\ No newline at end of file
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index ed8797a33..2a33c2061 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -13,7 +13,7 @@ class EuiccChannelImpl(
     override val port: UiccPortInfoCompat,
     override val intrinsicChannelName: String?,
     override val apduInterface: ApduInterface,
-    isdrAid: ByteArray,
+    override val isdrAid: ByteArray,
     verboseLoggingFlow: Flow<Boolean>,
     ignoreTLSCertificateFlow: Flow<Boolean>
 ) : EuiccChannel {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
index 09004d358..361a9438e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelWrapper.kt
@@ -38,6 +38,8 @@ class EuiccChannelWrapper(orig: EuiccChannel) : EuiccChannel {
         get() = channel.apduInterface
     override val atr: ByteArray?
         get() = channel.atr
+    override val isdrAid: ByteArray
+        get() = channel.isdrAid
 
     override fun close() = channel.close()
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index aa922be7b..1d5f37ffb 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -102,6 +102,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         add(Item(R.string.euicc_info_access_mode, channel.type))
         add(Item(R.string.euicc_info_removable, formatByBoolean(channel.port.card.isRemovable, YES_NO)))
         add(Item(R.string.euicc_info_eid, channel.lpa.eID, copiedToastResId = R.string.toast_eid_copied))
+        add(Item(R.string.euicc_info_isdr_aid, channel.isdrAid.encodeHex()))
         channel.tryParseEuiccVendorInfo()?.let { vendorInfo ->
             vendorInfo.skuName?.let { add(Item(R.string.euicc_info_sku, it)) }
             vendorInfo.serialNumber?.let { add(Item(R.string.euicc_info_sn, it, copiedToastResId = R.string.toast_sn_copied)) }
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 5e4e4da03..05ca15a1a 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -134,6 +134,7 @@
     <string name="euicc_info_bl_ver">Product Bootloader Version</string>
     <string name="euicc_info_fw_ver">Product Firmware Version</string>
     <string name="euicc_info_eid" translatable="false">EID</string>
+    <string name="euicc_info_isdr_aid" translatable="false">ISD-R AID</string>
     <string name="euicc_info_sgp22_version">SGP.22 Version</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
     <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>

From 756c621d5e0f23be814a33cdb745993933cc1f75 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 14 Apr 2025 03:36:14 +0200
Subject: [PATCH 408/458] fix: stricted sm-dp+ address checking (#190)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/190
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../wizard/DownloadWizardDetailsFragment.kt   | 28 +++++++++++++++++--
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
index 402e7a523..1c69de582 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDetailsFragment.kt
@@ -1,11 +1,9 @@
 package im.angry.openeuicc.ui.wizard
 
 import android.os.Bundle
-import android.util.Patterns
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
-import android.widget.Toast
 import androidx.core.widget.addTextChangedListener
 import com.google.android.material.textfield.TextInputLayout
 import im.angry.openeuicc.common.R
@@ -86,10 +84,34 @@ class DownloadWizardDetailsFragment : DownloadWizardActivity.DownloadWizardStepF
     }
 
     private fun updateInputCompleteness() {
-        inputComplete = Patterns.DOMAIN_NAME.matcher(smdp.editText!!.text).matches()
+        inputComplete = isValidAddress(smdp.editText!!.text)
         if (state.confirmationCodeRequired) {
             inputComplete = inputComplete && confirmationCode.editText!!.text.isNotEmpty()
         }
         refreshButtons()
     }
+}
+
+private fun isValidAddress(input: CharSequence): Boolean {
+    if (!input.contains('.')) return false
+    var fqdn = input
+    var port = 443
+    if (input.contains(':')) {
+        val portIndex = input.lastIndexOf(':')
+        fqdn = input.substring(0, portIndex)
+        port = input.substring(portIndex + 1, input.length).toIntOrNull(10) ?: 0
+    }
+    // see https://en.wikipedia.org/wiki/Port_(computer_networking)
+    if (port < 1 || port > 0xffff) return false
+    // see https://en.wikipedia.org/wiki/Fully_qualified_domain_name
+    if (fqdn.isEmpty() || fqdn.length > 255) return false
+    for (part in fqdn.split('.')) {
+        if (part.isEmpty() || part.length > 64) return false
+        if (part.first() == '-' || part.last() == '-') return false
+        for (c in part) {
+            if (c.isLetterOrDigit() || c == '-') continue
+            return false
+        }
+    }
+    return true
 }
\ No newline at end of file

From a601ab7d72b55fd23f898926923e805acfa1280c Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 14 Apr 2025 03:36:38 +0200
Subject: [PATCH 409/458] fix: send euicc memory reset notification (#189)

```console
$ ./lpac profile list | jq
{
  "type": "lpa",
  "payload": {
    "code": 0,
    "message": "success",
    "data": [
      {
        "iccid": "8944476500001320600",
        "isdpAid": "a0000005591010ffffffff8900001100",
        "profileState": "enabled",
        "profileNickname": null,
        "serviceProviderName": "BetterRoaming",
        "profileName": "BetterRoaming",
        "iconType": null,
        "icon": null,
        "profileClass": "operational"
      },
      {
        "iccid": "89861234567891232113",
        "isdpAid": "a0000005591010ffffffff8900001200",
        "profileState": "disabled",
        "profileNickname": null,
        "serviceProviderName": "rspmanager_tester2",
        "profileName": "20230625_yysx",
        "iconType": null,
        "icon": null,
        "profileClass": "operational"
      }
    ]
  }
}
$ ./lpac notification list | jq
{
  "type": "lpa",
  "payload": {
    "code": 0,
    "message": "success",
    "data": [
      {
        "seqNumber": 48,
        "profileManagementOperation": "install",
        "notificationAddress": "smdp.io",
        "iccid": "8944476500001320600"
      },
      {
        "seqNumber": 49,
        "profileManagementOperation": "enable",
        "notificationAddress": "rsp.truphone.com",
        "iccid": "8944476500001320600"
      },
      {
        "seqNumber": 50,
        "profileManagementOperation": "install",
        "notificationAddress": "secsmsminiapp.eastcompeace.com",
        "iccid": "89861234567891232113"
      },
      {
        "seqNumber": 51,
        "profileManagementOperation": "install",
        "notificationAddress": "secsmsminiapp.eastcompeace.com",
        "iccid": "89861234567891232113"
      }
    ]
  }
}
$ ./lpac chip purge yes
{"type":"lpa","payload":{"code":0,"message":"success","data":null}}
$ ./lpac notification list | jq
{
  "type": "lpa",
  "payload": {
    "code": 0,
    "message": "success",
    "data": [
      {
        "seqNumber": 48,
        "profileManagementOperation": "install",
        "notificationAddress": "smdp.io",
        "iccid": "8944476500001320600"
      },
      {
        "seqNumber": 49,
        "profileManagementOperation": "enable",
        "notificationAddress": "rsp.truphone.com",
        "iccid": "8944476500001320600"
      },
      {
        "seqNumber": 50,
        "profileManagementOperation": "install",
        "notificationAddress": "secsmsminiapp.eastcompeace.com",
        "iccid": "89861234567891232113"
      },
      {
        "seqNumber": 51,
        "profileManagementOperation": "install",
        "notificationAddress": "secsmsminiapp.eastcompeace.com",
        "iccid": "89861234567891232113"
      },
      {
        "seqNumber": 52,
        "profileManagementOperation": "delete",
        "notificationAddress": "rsp.truphone.com",
        "iccid": "8944476500001320600"
      },
      {
        "seqNumber": 53,
        "profileManagementOperation": "delete",
        "notificationAddress": "secsmsminiapp.eastcompeace.com",
        "iccid": "89861234567891232113"
      }
    ]
  }
}
```

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/189
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/service/EuiccChannelManagerService.kt      | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
index 2a2448889..47443216e 100644
--- a/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/service/EuiccChannelManagerService.kt
@@ -12,7 +12,6 @@ import androidx.core.app.NotificationManagerCompat
 import androidx.lifecycle.LifecycleService
 import androidx.lifecycle.lifecycleScope
 import im.angry.openeuicc.common.R
-import im.angry.openeuicc.core.EuiccChannel
 import im.angry.openeuicc.core.EuiccChannelManager
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.Dispatchers
@@ -517,8 +516,12 @@ class EuiccChannelManagerService : LifecycleService(), OpenEuiccContextMarker {
             getString(R.string.task_euicc_memory_reset_failure),
             R.drawable.ic_euicc_memory_reset
         ) {
-            euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
-                channel.lpa.euiccMemoryReset()
+            euiccChannelManager.beginTrackedOperation(slotId, portId) {
+                euiccChannelManager.withEuiccChannel(slotId, portId) { channel ->
+                    channel.lpa.euiccMemoryReset()
+                }
+
+                preferenceRepository.notificationDeleteFlow.first()
             }
         }
 }
\ No newline at end of file

From 023f6ded28faec991f9472a0af4fef980abb2417 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 4 May 2025 21:10:32 -0400
Subject: [PATCH 410/458] Update README.md to add a comparison matrix for
 Easy/OpenEUICC

---
 README.md | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index f8019b2ac..28a616a81 100644
--- a/README.md
+++ b/README.md
@@ -2,18 +2,22 @@
 
 A fully free and open-source Local Profile Assistant implementation for Android devices.
 
-There are two variants of this project:
+There are two variants of this project, OpenEUICC and EasyEUICC:
 
-- OpenEUICC: The full-fledged privileged variant.
-  - Due to its privilege requirement, OpenEUICC must be placed inside `/system/priv-app` and be signed with the platform certificate.
-  - The preferred way to including OpenEUICC in a system image is to [build it along with AOSP](#building-aosp).
-  - __Note__: When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
-- EasyEUICC: Unprivileged version that can run as a user app.
-  - This version supports two modes of operation:
-    1. Inserted, removable eSIMs: Due to obvious security requirements, EasyEUICC is only able to access eSIM chips whose [ARF/ARA](https://source.android.com/docs/core/connect/uicc#arf) contains the hash of EasyEUICC's signing certificate.
-    2. USB CCID Card Readers: Only `T=0` readers that use the standard [USB CCID protocol](https://en.wikipedia.org/wiki/CCID_(protocol)) are supported. In this mode, EasyEUICC can access any eSIM chip loaded in the card reader regardless of their ARF/ARA, as long as they implement the [SGP.22 standard](https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2021/07/SGP.22-v2.3.pdf).
-  - Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases)
-  - For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`
+|                               |                    OpenEUICC                    |     EasyEUICC     |
+|:------------------------------|:-----------------------------------------------:|:-----------------:|
+| Privileged                    |         Must be installed as system app         |        No         |
+| Internal eSIM                 |                    Supported                    |    Unsupported    |
+| External (Removable) eSIM     |                    Supported                    |     Supported     |
+| USB Readers                   |                       Yes                       |        Yes        |
+| Requires allowlisting by eSIM |                       No                        | Yes -- except USB |
+| System Integration            | Partial (carrier partner API unimplemented yet) |        No         |
+
+Some side notes:
+1. When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
+2. Both variants support accessing eUICC chips through USB CCID readers, regardless of whether the chip contains the correct ARA-M hash to allow for unprivileged access. However, only `T=0` readers that use the standard [USB CCID protocol](https://en.wikipedia.org/wiki/CCID_(protocol)) are supported.
+3. Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases). For OpenEUICC, no official release is currently provided and only debug mode APKs can be found in the CI page.
+4. For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`.
 
 __This project is Free Software licensed under GNU GPL v3, WITHOUT the "or later" clause.__ Any modification and derivative work __MUST__ be released under the SAME license, which means, at the very least, that the source code __MUST__ be available upon request.
 

From eaef00b88af4ea3e52579e8a662bc3304f1ab689 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 18 May 2025 11:17:43 -0400
Subject: [PATCH 411/458] Fixup README

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 28a616a81..f953f9ea5 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ There are two variants of this project, OpenEUICC and EasyEUICC:
 | Privileged                    |         Must be installed as system app         |        No         |
 | Internal eSIM                 |                    Supported                    |    Unsupported    |
 | External (Removable) eSIM     |                    Supported                    |     Supported     |
-| USB Readers                   |                       Yes                       |        Yes        |
+| USB Readers                   |                    Supported                    |     Supported     |
 | Requires allowlisting by eSIM |                       No                        | Yes -- except USB |
 | System Integration            | Partial (carrier partner API unimplemented yet) |        No         |
 

From 149a19ca1c90696ddf1b31d0f562a82f06fb2086 Mon Sep 17 00:00:00 2001
From: xqdoo00o <xqdoo00o@gmail.com>
Date: Mon, 16 Jun 2025 03:54:02 +0200
Subject: [PATCH 412/458] fix: build warning (#194)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/194
Co-authored-by: xqdoo00o <xqdoo00o@gmail.com>
Co-committed-by: xqdoo00o <xqdoo00o@gmail.com>
---
 libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c b/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
index a61fc9672..007e80dea 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
+++ b/libs/lpac-jni/src/main/jni/lpac-jni/interface-wrapper.c
@@ -80,7 +80,7 @@ apdu_interface_transmit(struct euicc_ctx *ctx, uint8_t **rx, uint32_t *rx_len, c
     LPAC_JNI_EXCEPTION_RETURN;
     *rx_len = (*env)->GetArrayLength(env, ret);
     *rx = calloc(*rx_len, sizeof(uint8_t));
-    (*env)->GetByteArrayRegion(env, ret, 0, *rx_len, *rx);
+    (*env)->GetByteArrayRegion(env, ret, 0, *rx_len, (jbyte *) *rx);
     (*env)->DeleteLocalRef(env, txArr);
     (*env)->DeleteLocalRef(env, ret);
     return 0;
@@ -113,7 +113,7 @@ http_interface_transmit(struct euicc_ctx *ctx, const char *url, uint32_t *rcode,
     jbyteArray rxArr = (jbyteArray) (*env)->GetObjectField(env, ret, field_resp_data);
     *rx_len = (*env)->GetArrayLength(env, rxArr);
     *rx = calloc(*rx_len, sizeof(uint8_t));
-    (*env)->GetByteArrayRegion(env, rxArr, 0, *rx_len, *rx);
+    (*env)->GetByteArrayRegion(env, rxArr, 0, *rx_len, (jbyte *) *rx);
     (*env)->DeleteLocalRef(env, txArr);
     (*env)->DeleteLocalRef(env, rxArr);
     (*env)->DeleteLocalRef(env, headersArr);

From db4645b17fa7087cfdf23deedfe6a79e2e689133 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 16 Jun 2025 03:54:32 +0200
Subject: [PATCH 413/458] feat: sas accreditation number format check (#193)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/193
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 33 ++++++++++---------
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 1d5f37ffb..4a34edd56 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -27,6 +27,13 @@ import kotlinx.coroutines.launch
 import net.typeblog.lpac_jni.impl.PKID_GSMA_LIVE_CI
 import net.typeblog.lpac_jni.impl.PKID_GSMA_TEST_CI
 
+// https://euicc-manual.osmocom.org/docs/pki/eum/accredited.json
+// ref: <https://regex101.com/r/5FFz8u>
+private val RE_SAS = Regex(
+    """^[A-Z]{2}-[A-Z]{2}(?:-UP)?-\d{4}T?(?:-\d+)?T?$""",
+    setOf(RegexOption.IGNORE_CASE),
+)
+
 class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
         private val YES_NO = Pair(R.string.yes, R.string.no)
@@ -109,13 +116,14 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             vendorInfo.firmwareVersion?.let { add(Item(R.string.euicc_info_fw_ver, it)) }
             vendorInfo.bootloaderVersion?.let { add(Item(R.string.euicc_info_bl_ver, it)) }
         }
-        channel.lpa.euiccInfo2.let { info ->
-            add(Item(R.string.euicc_info_sgp22_version, info?.sgp22Version.toString()))
-            add(Item(R.string.euicc_info_firmware_version, info?.euiccFirmwareVersion.toString()))
-            add(Item(R.string.euicc_info_globalplatform_version, info?.globalPlatformVersion.toString()))
-            add(Item(R.string.euicc_info_pp_version, info?.ppVersion.toString()))
-            add(Item(R.string.euicc_info_sas_accreditation_number, info?.sasAccreditationNumber))
-            add(Item(R.string.euicc_info_free_nvram, info?.freeNvram?.let(::formatFreeSpace)))
+        channel.lpa.euiccInfo2?.let { info ->
+            add(Item(R.string.euicc_info_sgp22_version, info.sgp22Version.toString()))
+            add(Item(R.string.euicc_info_firmware_version, info.euiccFirmwareVersion.toString()))
+            add(Item(R.string.euicc_info_globalplatform_version, info.globalPlatformVersion.toString()))
+            add(Item(R.string.euicc_info_pp_version, info.ppVersion.toString()))
+            info.sasAccreditationNumber.trim().takeIf(RE_SAS::matches)
+                ?.let { add(Item(R.string.euicc_info_sas_accreditation_number, it.uppercase())) }
+            add(Item(R.string.euicc_info_free_nvram, info.freeNvram.let(::formatFreeSpace)))
         }
         channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
             // SGP.28 v1.0, eSIM CI Registration Criteria (Page 5 of 9, 2019-10-24)
@@ -130,18 +138,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             }
             add(Item(R.string.euicc_info_ci_type, getString(resId)))
         }
-        val atr =  channel.atr?.encodeHex() ?: getString(R.string.information_unavailable)
+        val atr = channel.atr?.encodeHex() ?: getString(R.string.information_unavailable)
         add(Item(R.string.euicc_info_atr, atr, copiedToastResId = R.string.toast_atr_copied))
     }
 
+    @Suppress("SameParameterValue")
     private fun formatByBoolean(b: Boolean, res: Pair<Int, Int>): String =
-        getString(
-            if (b) {
-                res.first
-            } else {
-                res.second
-            }
-        )
+        getString(if (b) res.first else res.second)
 
     inner class EuiccInfoViewHolder(root: View) : ViewHolder(root) {
         private val title: TextView = root.requireViewById(R.id.euicc_info_title)

From 21c04ed1795b6415f8a8953c50b4d5eb63c8bf36 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Tue, 17 Jun 2025 07:57:19 -0400
Subject: [PATCH 414/458] Allow Actions to build from any branch

---
 .forgejo/workflows/build-debug.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.forgejo/workflows/build-debug.yml b/.forgejo/workflows/build-debug.yml
index 51e802ca2..660dabcb7 100644
--- a/.forgejo/workflows/build-debug.yml
+++ b/.forgejo/workflows/build-debug.yml
@@ -1,7 +1,7 @@
 on:
   push:
     branches:
-      - 'master'
+      - '*'
 
 jobs:
   build-debug:

From c0dc8ac19d38dcc899553ee66446ba3cf2dc7ffe Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Tue, 8 Jul 2025 15:51:36 +0800
Subject: [PATCH 415/458] feat: profile sequence number

---
 .../angry/openeuicc/ui/EuiccManagementFragment.kt   | 13 ++++++++++++-
 app-common/src/main/res/layout/euicc_profile.xml    |  8 ++++++++
 app-common/src/main/res/layout/fragment_euicc.xml   |  1 +
 app-common/src/main/res/values/strings.xml          |  1 +
 4 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 12995ff70..3c94c6cda 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -347,6 +347,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
         private val profileClassLabel: TextView = root.requireViewById(R.id.profile_class_label)
         private val profileClass: TextView = root.requireViewById(R.id.profile_class)
         private val profileMenu: ImageButton = root.requireViewById(R.id.profile_menu)
+        private val profileSeqNumber: TextView = root.requireViewById(R.id.profile_sequence_number)
 
         init {
             iccid.setOnClickListener {
@@ -366,7 +367,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                 true
             }
 
-            profileMenu.setOnClickListener { showOptionsMenu() }
+            profileMenu.setOnClickListener {
+                showOptionsMenu()
+            }
         }
 
         private lateinit var profile: LocalProfileInfo
@@ -396,6 +399,13 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             iccid.transformationMethod = PasswordTransformationMethod.getInstance()
         }
 
+        fun setProfileSequenceNumber(index: Int) {
+            profileSeqNumber.text = root.context.getString(
+                R.string.profile_sequence_number_format,
+                index,
+            )
+        }
+
         private fun showOptionsMenu() {
             // Prevent users from doing multiple things at once
             if (invalid || swipeRefresh.isRefreshing) return
@@ -461,6 +471,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
             when (holder) {
                 is ProfileViewHolder -> {
                     holder.setProfile(profiles[position])
+                    holder.setProfileSequenceNumber(position + 1)
                 }
                 is FooterViewHolder -> {
                     holder.attach(footerViews[position - profiles.size])
diff --git a/app-common/src/main/res/layout/euicc_profile.xml b/app-common/src/main/res/layout/euicc_profile.xml
index 58d55ab1e..74c1d7a0c 100644
--- a/app-common/src/main/res/layout/euicc_profile.xml
+++ b/app-common/src/main/res/layout/euicc_profile.xml
@@ -129,6 +129,14 @@
                 app:layout_constraintTop_toBottomOf="@id/profile_class"
                 app:layout_constraintBottom_toBottomOf="parent"/>
 
+            <TextView
+                android:id="@+id/profile_sequence_number"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_marginHorizontal="6dp"
+                app:layout_constraintRight_toRightOf="parent"
+                app:layout_constraintTop_toTopOf="@id/iccid" />
+
         </androidx.constraintlayout.widget.ConstraintLayout>
 
     </com.google.android.material.card.MaterialCardView>
diff --git a/app-common/src/main/res/layout/fragment_euicc.xml b/app-common/src/main/res/layout/fragment_euicc.xml
index 4ae7523a8..c5fde7bc5 100644
--- a/app-common/src/main/res/layout/fragment_euicc.xml
+++ b/app-common/src/main/res/layout/fragment_euicc.xml
@@ -27,6 +27,7 @@
         android:layout_height="wrap_content"
         android:layout_marginEnd="16dp"
         android:layout_marginBottom="16dp"
+        android:contentDescription="@string/profile_download"
         android:src="@drawable/ic_add"
         app:layout_constraintRight_toRightOf="parent"
         app:layout_constraintBottom_toBottomOf="parent"/>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 05ca15a1a..38bb97662 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -19,6 +19,7 @@
     <string name="profile_class_provisioning">Provisioning</string>
     <string name="profile_class_operational">Operational</string>
     <string name="iccid" translatable="false">ICCID:</string>
+    <string name="profile_sequence_number_format" translatable="false">#%d</string>
 
     <string name="enable">Enable</string>
     <string name="disable">Disable</string>

From 4ac0820bbfd5d467b4646fe5ff2d5c204b06ae23 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 10 Jul 2025 02:54:25 +0200
Subject: [PATCH 416/458] fix: improve deep-link compatibility (#198)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/198
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/AndroidManifest.xml                      | 5 +++--
 .../im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt   | 4 ++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/app-common/src/main/AndroidManifest.xml b/app-common/src/main/AndroidManifest.xml
index b0324dce4..44c82c015 100644
--- a/app-common/src/main/AndroidManifest.xml
+++ b/app-common/src/main/AndroidManifest.xml
@@ -45,8 +45,9 @@
                 <!-- Accepts URIs that begin with "lpa:" -->
                 <!-- for example: "LPA:1$..." -->
                 <!-- refs: https://www.iana.org/assignments/uri-schemes/prov/lpa -->
-                <data android:scheme="lpa"/>
-                <data android:sspPrefix="1$"/>
+                <data android:scheme="lpa" />
+                <data android:scheme="LPA" tools:ignore="AppLinkUrlError" />
+                <data android:sspPrefix="1$" />
             </intent-filter>
         </activity>
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
index 9e312d4e8..6574645ad 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardActivity.kt
@@ -123,8 +123,8 @@ class DownloadWizardActivity: BaseEuiccAccessActivity() {
         // If we get an LPA string from deep-link intents, extract from there.
         // Note that `onRestoreInstanceState` could override this with user input,
         // but that _is_ the desired behavior.
-        val uri = intent.data
-        if (uri?.scheme == "lpa") {
+        val uri = intent.data ?: return
+        if (uri.scheme.contentEquals("lpa", ignoreCase = true)) {
             val parsed = LPAString.parse(uri.schemeSpecificPart)
             state.smdp = parsed.address
             state.matchingId = parsed.matchingId

From 6d43a9207cbfb1c03ccf304a2c3cd117c578df34 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 16 Jul 2025 14:24:05 +0200
Subject: [PATCH 417/458] chore: simplify pretty print json string (#201)

https://developer.android.com/reference/org/json/JSONObject
Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/201
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../DownloadWizardDiagnosticsFragment.kt      |  4 +-
 .../im/angry/openeuicc/util/StringUtils.kt    | 70 -------------------
 2 files changed, 3 insertions(+), 71 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
index e282196a4..38418684f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardDiagnosticsFragment.kt
@@ -8,6 +8,7 @@ import android.view.ViewGroup
 import android.widget.TextView
 import im.angry.openeuicc.common.R
 import im.angry.openeuicc.util.*
+import org.json.JSONObject
 import java.util.Date
 
 class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
@@ -86,9 +87,10 @@ class DownloadWizardDiagnosticsFragment : DownloadWizardActivity.DownloadWizardS
             ret.appendLine()
 
             val str = resp.data.decodeToString(throwOnInvalidSequence = false)
+
             ret.appendLine(
                 if (str.startsWith('{')) {
-                    str.prettyPrintJson()
+                    JSONObject(str).toString(2)
                 } else {
                     str
                 }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
index 079853ebd..57d150b31 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/StringUtils.kt
@@ -41,73 +41,3 @@ fun parseIsdrAidList(s: String): List<ByteArray> =
         .filter(String::isNotEmpty)
         .mapNotNull { runCatching(it::decodeHex).getOrNull() }
         .ifEmpty { listOf(EUICC_DEFAULT_ISDR_AID.decodeHex()) }
-
-fun String.prettyPrintJson(): String {
-    val ret = StringBuilder()
-    var inQuotes = false
-    var escaped = false
-    val indentSymbolStack = ArrayDeque<Char>()
-
-    val addNewLine = {
-        ret.append('\n')
-        repeat(indentSymbolStack.size) {
-            ret.append('\t')
-        }
-    }
-
-    var lastChar = ' '
-
-    for (c in this) {
-        when {
-            !inQuotes && (c == '{' || c == '[') -> {
-                ret.append(c)
-                indentSymbolStack.addLast(c)
-                addNewLine()
-            }
-
-            !inQuotes && (c == '}' || c == ']') -> {
-                indentSymbolStack.removeLast()
-                if (lastChar != ',') {
-                    addNewLine()
-                }
-                ret.append(c)
-            }
-
-            !inQuotes && c == ',' -> {
-                ret.append(c)
-                addNewLine()
-            }
-
-            !inQuotes && c == ':' -> {
-                ret.append(c)
-                ret.append(' ')
-            }
-
-            inQuotes && c == '\\' -> {
-                ret.append(c)
-                escaped = true
-                continue
-            }
-
-            !escaped && c == '"' -> {
-                ret.append(c)
-                inQuotes = !inQuotes
-            }
-
-            !inQuotes && c == ' ' -> {
-                // Do nothing -- we ignore spaces outside of quotes by default
-                // This is to ensure predictable formatting
-            }
-
-            else -> ret.append(c)
-        }
-
-        if (escaped) {
-            escaped = false
-        }
-
-        lastChar = c
-    }
-
-    return ret.toString()
-}
\ No newline at end of file

From 677b69cedfcae37557ca5626bb1741987ffb0a10 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:29:27 -0400
Subject: [PATCH 418/458] feat: quick compatibility check

Co-authored-by: septs <github@septs.pw>
---
 app-unpriv/src/main/AndroidManifest.xml       |   5 +
 .../openeuicc/di/UnprivilegedAppContainer.kt  |   5 +
 .../di/UnprivilegedUiComponentFactory.kt      |   7 +-
 .../ui/QuickCompatibilityActivity.kt          |  25 ++++
 .../ui/QuickCompatibilityFragment.kt          | 140 ++++++++++++++++++
 .../openeuicc/ui/UnprivilegedMainActivity.kt  |  13 +-
 .../openeuicc/util/CompatibilityCheck.kt      |   6 +-
 .../util/UnprivilegedPreferenceRepository.kt  |  14 ++
 .../angry/openeuicc/util/UnprivilegedUtils.kt |   6 +
 .../layout/activity_quick_compatibility.xml   |  16 ++
 .../layout/fragment_quick_compatibility.xml   |  53 +++++++
 app-unpriv/src/main/res/values/strings.xml    |  10 ++
 12 files changed, 294 insertions(+), 6 deletions(-)
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
 create mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedUtils.kt
 create mode 100644 app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
 create mode 100644 app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml

diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index ce985cdc7..ba3707997 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -23,6 +23,11 @@
             </intent-filter>
         </activity>
 
+        <activity
+            android:name="im.angry.openeuicc.ui.QuickCompatibilityActivity"
+            android:exported="false"
+            android:label="@string/quick_compatibility" />
+
         <activity
             android:name="im.angry.openeuicc.ui.CompatibilityCheckActivity"
             android:exported="false"
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
index 4dbfe4158..042c72075 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedAppContainer.kt
@@ -1,6 +1,7 @@
 package im.angry.openeuicc.di
 
 import android.content.Context
+import im.angry.openeuicc.util.UnprivilegedPreferenceRepository
 
 class UnprivilegedAppContainer(context: Context) : DefaultAppContainer(context) {
     override val uiComponentFactory by lazy {
@@ -10,4 +11,8 @@ class UnprivilegedAppContainer(context: Context) : DefaultAppContainer(context)
     override val customizableTextProvider by lazy {
         UnprivilegedCustomizableTextProvider(context)
     }
+
+    override val preferenceRepository by lazy {
+        UnprivilegedPreferenceRepository(context)
+    }
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
index 06c489c47..73f33d1b5 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -2,12 +2,12 @@ package im.angry.openeuicc.di
 
 import androidx.fragment.app.Fragment
 import im.angry.openeuicc.ui.EuiccManagementFragment
-import im.angry.openeuicc.ui.SettingsFragment
+import im.angry.openeuicc.ui.QuickCompatibilityFragment
 import im.angry.openeuicc.ui.UnprivilegedEuiccManagementFragment
 import im.angry.openeuicc.ui.UnprivilegedNoEuiccPlaceholderFragment
 import im.angry.openeuicc.ui.UnprivilegedSettingsFragment
 
-class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
+open class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
     override fun createEuiccManagementFragment(slotId: Int, portId: Int): EuiccManagementFragment =
         UnprivilegedEuiccManagementFragment.newInstance(slotId, portId)
 
@@ -16,4 +16,7 @@ class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
 
     override fun createSettingsFragment(): Fragment =
         UnprivilegedSettingsFragment()
+
+    open fun createQuickAvailabilityFragment(): Fragment =
+        QuickCompatibilityFragment()
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
new file mode 100644
index 000000000..d83903b40
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
@@ -0,0 +1,25 @@
+package im.angry.openeuicc.ui
+
+import android.content.Intent
+import android.os.Bundle
+import androidx.activity.enableEdgeToEdge
+import androidx.appcompat.app.AppCompatActivity
+import im.angry.easyeuicc.R
+import im.angry.openeuicc.di.UnprivilegedUiComponentFactory
+import im.angry.openeuicc.util.OpenEuiccContextMarker
+
+class QuickCompatibilityActivity : AppCompatActivity(), OpenEuiccContextMarker {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        enableEdgeToEdge()
+        setContentView(R.layout.activity_quick_compatibility)
+
+        val quickAvailabilityFragment =
+            (appContainer.uiComponentFactory as UnprivilegedUiComponentFactory)
+                .createQuickAvailabilityFragment()
+
+        supportFragmentManager.beginTransaction()
+            .replace(R.id.quick_availability_container, quickAvailabilityFragment)
+            .commit()
+    }
+}
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
new file mode 100644
index 000000000..9086234d2
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -0,0 +1,140 @@
+package im.angry.openeuicc.ui
+
+import android.content.pm.PackageManager
+import android.icu.text.ListFormatter
+import android.os.Build
+import android.os.Bundle
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.Button
+import android.widget.CheckBox
+import android.widget.TextView
+import androidx.core.view.isVisible
+import androidx.fragment.app.Fragment
+import androidx.lifecycle.lifecycleScope
+import im.angry.easyeuicc.R
+import im.angry.openeuicc.util.EUICC_DEFAULT_ISDR_AID
+import im.angry.openeuicc.util.UnprivilegedEuiccContextMarker
+import im.angry.openeuicc.util.connectSEService
+import im.angry.openeuicc.util.decodeHex
+import im.angry.openeuicc.util.isSIM
+import im.angry.openeuicc.util.slotIndex
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.runBlocking
+
+open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMarker {
+    companion object {
+        enum class Compatibility {
+            COMPATIBLE,
+            NOT_COMPATIBLE,
+        }
+
+        data class CompatibilityResult(
+            val compatibility: Compatibility,
+            val slots: List<String> = emptyList()
+        )
+    }
+
+    private val conclusion: TextView by lazy {
+        requireView().requireViewById(R.id.quick_availability_conclusion)
+    }
+
+    private val resultSlots: TextView by lazy {
+        requireView().requireViewById(R.id.quick_availability_result_slots)
+    }
+
+    private val resultNotes: TextView by lazy {
+        requireView().requireViewById(R.id.quick_availability_result_notes)
+    }
+
+    private val hidden: CheckBox by lazy {
+        requireView().requireViewById(R.id.quick_availability_hidden)
+    }
+
+    override fun onCreateView(
+        inflater: LayoutInflater,
+        container: ViewGroup?,
+        savedInstanceState: Bundle?
+    ): View = inflater.inflate(R.layout.fragment_quick_compatibility, container, false).apply {
+        requireViewById<TextView>(R.id.quick_availability_device_information)
+            .text = formatDeviceInformation()
+        requireViewById<Button>(R.id.quick_availability_button_continue)
+            .setOnClickListener { onContinueToApp() }
+    }
+
+    override fun onStart() {
+        super.onStart()
+        lifecycleScope.launch {
+            onCompatibilityUpdate(getCompatibilityCheckResult())
+        }
+    }
+
+    private fun onContinueToApp() {
+        runBlocking {
+            preferenceRepository.skipQuickAvailabilityFlow
+                .updatePreference(hidden.isChecked)
+        }
+        requireActivity().finish()
+    }
+
+    private fun onCompatibilityUpdate(result: CompatibilityResult) {
+        conclusion.text = formatConclusion(result)
+        if (result.compatibility != Compatibility.COMPATIBLE) return
+        resultSlots.isVisible = true
+        resultSlots.text = getString(
+            R.string.quick_compatibility_result_slots,
+            ListFormatter.getInstance().format(result.slots)
+        )
+        resultNotes.isVisible = true
+    }
+
+    private suspend fun getCompatibilityCheckResult(): CompatibilityResult {
+        val service = connectSEService(requireContext())
+        if (!service.isConnected) {
+            return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
+        }
+        val slots = service.readers.filter { it.isSIM }.mapNotNull { reader ->
+            try {
+                // Note: we ONLY check the default ISD-R AID, because this test is for the _device_,
+                // NOT the eUICC. We don't care what AID a potential eUICC might use, all we need to
+                // check is we can open _some_ AID.
+                reader.openSession().openLogicalChannel(EUICC_DEFAULT_ISDR_AID.decodeHex())?.close()
+                reader.slotIndex
+            } catch (_: SecurityException) {
+                // Ignore; this is expected when everything works
+                // ref: https://android.googlesource.com/platform/frameworks/base/+/4fe64fb4712a99d5da9c9a0eb8fd5169b252e1e1/omapi/java/android/se/omapi/Session.java#305
+                // SecurityException is only thrown when Channel is constructed, which means everything else needs to succeed
+                reader.slotIndex
+            } catch (_: Exception) {
+                null
+            }
+        }
+        if (slots.isEmpty()) {
+            return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
+        }
+        return CompatibilityResult(Compatibility.COMPATIBLE, slots = slots.map { "SIM$it" })
+    }
+
+    open fun formatConclusion(result: CompatibilityResult): String {
+        val usbHost = requireContext().packageManager
+            .hasSystemFeature(PackageManager.FEATURE_USB_HOST)
+        val resId = when (result.compatibility) {
+            Compatibility.COMPATIBLE ->
+                R.string.quick_compatibility_compatible
+
+            Compatibility.NOT_COMPATIBLE -> if (usbHost)
+                R.string.quick_compatibility_not_compatible_but_usb else
+                R.string.quick_compatibility_not_compatible
+        }
+        return getString(resId, getString(R.string.app_name))
+    }
+
+    open fun formatDeviceInformation() = buildString {
+        appendLine("BRAND: ${Build.BRAND}")
+        appendLine("DEVICE: ${Build.DEVICE}")
+        appendLine("MODEL: ${Build.MODEL}")
+        appendLine("VERSION.RELEASE: ${Build.VERSION.RELEASE}")
+        appendLine("VERSION.SDK_INT: ${Build.VERSION.SDK_INT}")
+    }
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
index 1ed0cced0..ac2055723 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
@@ -1,11 +1,22 @@
 package im.angry.openeuicc.ui
 
 import android.content.Intent
+import android.os.Bundle
 import android.view.Menu
 import android.view.MenuItem
 import im.angry.easyeuicc.R
+import im.angry.openeuicc.util.UnprivilegedEuiccContextMarker
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.runBlocking
+
+class UnprivilegedMainActivity : MainActivity(), UnprivilegedEuiccContextMarker {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        if (runBlocking { !preferenceRepository.skipQuickAvailabilityFlow.first() }) {
+            startActivity(Intent(this, QuickCompatibilityActivity::class.java))
+        }
+    }
 
-class UnprivilegedMainActivity: MainActivity() {
     override fun onCreateOptionsMenu(menu: Menu): Boolean {
         super.onCreateOptionsMenu(menu)
         menuInflater.inflate(R.menu.activity_main_unprivileged, menu)
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
index 94ee9d6c8..b2b503a9c 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
@@ -33,10 +33,10 @@ suspend fun List<CompatibilityCheck>.executeAll(callback: () -> Unit) = withCont
     }
 }
 
-private val Reader.isSIM: Boolean
+val Reader.isSIM: Boolean
     get() = name.startsWith("SIM")
 
-private val Reader.slotIndex: Int
+val Reader.slotIndex: Int
     get() = (name.replace("SIM", "").toIntOrNull() ?: 1)
 
 abstract class CompatibilityCheck(context: Context) {
@@ -173,7 +173,7 @@ internal class IsdrChannelAccessCheck(private val context: Context): Compatibili
             }
         }
 
-        if (result != State.SUCCESS && validSlotIds.size > 0) {
+        if (result != State.SUCCESS && validSlotIds.isNotEmpty()) {
             if (!context.packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY_EUICC)) {
                 failureDescription = context.getString(
                     R.string.compatibility_check_isdr_channel_desc_partial_fail,
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
new file mode 100644
index 000000000..193a2fac5
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
@@ -0,0 +1,14 @@
+package im.angry.openeuicc.util
+
+import android.content.Context
+import androidx.datastore.preferences.core.booleanPreferencesKey
+
+internal object UnprivilegedPreferenceKeys {
+    // ---- Miscellaneous ----
+    val SKIP_QUICK_AVAILABILITY = booleanPreferencesKey("skip_quick_availability")
+}
+
+class UnprivilegedPreferenceRepository(context: Context) : PreferenceRepository(context) {
+    // ---- Miscellaneous ----
+    val skipQuickAvailabilityFlow = bindFlow(UnprivilegedPreferenceKeys.SKIP_QUICK_AVAILABILITY, false)
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedUtils.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedUtils.kt
new file mode 100644
index 000000000..a8b2246d6
--- /dev/null
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedUtils.kt
@@ -0,0 +1,6 @@
+package im.angry.openeuicc.util
+
+interface UnprivilegedEuiccContextMarker : OpenEuiccContextMarker {
+    override val preferenceRepository: UnprivilegedPreferenceRepository
+        get() = appContainer.preferenceRepository as UnprivilegedPreferenceRepository
+}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml b/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
new file mode 100644
index 000000000..42f3896f4
--- /dev/null
+++ b/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <FrameLayout
+        android:id="@+id/quick_availability_container"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintTop_toBottomOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
new file mode 100644
index 000000000..8089c889b
--- /dev/null
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -0,0 +1,53 @@
+<?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:gravity="center"
+    android:orientation="vertical"
+    android:padding="32dp"
+    android:textAlignment="center">
+
+    <TextView
+        android:id="@+id/quick_availability_conclusion"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginBottom="16dp"
+        android:textAlignment="center"
+        android:textSize="20sp"
+        android:textStyle="bold" />
+
+    <TextView
+        android:id="@+id/quick_availability_device_information"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:fontFamily="monospace"
+        android:lineHeight="30dp"
+        android:textAlignment="center" />
+
+    <TextView
+        android:id="@+id/quick_availability_result_slots"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginBottom="16dp"
+        android:visibility="gone" />
+
+    <TextView
+        android:id="@+id/quick_availability_result_notes"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="@string/quick_compatibility_result_notes"
+        android:visibility="gone" />
+
+    <CheckBox
+        android:id="@+id/quick_availability_hidden"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="@string/quick_compatibility_hidden" />
+
+    <Button
+        android:id="@+id/quick_availability_button_continue"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="@string/quick_compatibility_button_continue" />
+
+</LinearLayout>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 43bf44fa5..8530dd09d 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -11,6 +11,16 @@
     <string name="toast_ara_m_copied">ARA-M SHA-1 copied to clipboard</string>
     <string name="toast_prompt_to_enable_sim_toolkit">Please ENABLE your \"%s\" application</string>
 
+    <!-- Quick Compatibility -->
+    <string name="quick_compatibility">Quick Compatibility Check</string>
+    <string name="quick_compatibility_compatible">Your smartphone can manage %s-compatible cards</string>
+    <string name="quick_compatibility_not_compatible">Your smartphone is not compatible with %s</string>
+    <string name="quick_compatibility_not_compatible_but_usb">Your smartphone is not fully compatible with %s. However, you can still use a USB smart card reader for near-full functionality.</string>
+    <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
+    <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
+    <string name="quick_compatibility_hidden">Do not show this message again.</string>
+    <string name="quick_compatibility_button_continue">Continue</string>
+
     <!-- Compatibility Check Descriptions -->
     <string name="compatibility_check_system_features">System Features</string>
     <string name="compatibility_check_system_features_desc">Whether your device has all the required features for managing removable eUICC cards. For example, basic telephony and OMAPI support.</string>

From cbe3d1fd5004877afe3dfc22045b99d276084e2a Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:33:16 -0400
Subject: [PATCH 419/458] Use quick compatibility check as the main method of
 compatibility checks

The old one doesn't really add much for the purpose, fwiw
---
 .../im/angry/openeuicc/ui/QuickCompatibilityFragment.kt    | 7 +------
 .../java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt | 2 +-
 .../src/main/res/layout/fragment_quick_compatibility.xml   | 6 ------
 app-unpriv/src/main/res/values/strings.xml                 | 1 -
 4 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index 9086234d2..9b54640c0 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -8,7 +8,6 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.Button
-import android.widget.CheckBox
 import android.widget.TextView
 import androidx.core.view.isVisible
 import androidx.fragment.app.Fragment
@@ -48,10 +47,6 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         requireView().requireViewById(R.id.quick_availability_result_notes)
     }
 
-    private val hidden: CheckBox by lazy {
-        requireView().requireViewById(R.id.quick_availability_hidden)
-    }
-
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
@@ -73,7 +68,7 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     private fun onContinueToApp() {
         runBlocking {
             preferenceRepository.skipQuickAvailabilityFlow
-                .updatePreference(hidden.isChecked)
+                .updatePreference(true)
         }
         requireActivity().finish()
     }
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
index ac2055723..da75d6f16 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
@@ -26,7 +26,7 @@ class UnprivilegedMainActivity : MainActivity(), UnprivilegedEuiccContextMarker
     override fun onOptionsItemSelected(item: MenuItem): Boolean =
         when (item.itemId) {
             R.id.compatibility_check -> {
-                startActivity(Intent(this, CompatibilityCheckActivity::class.java))
+                startActivity(Intent(this, QuickCompatibilityActivity::class.java))
                 true
             }
             else -> super.onOptionsItemSelected(item)
diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
index 8089c889b..c1b206ac1 100644
--- a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -38,12 +38,6 @@
         android:text="@string/quick_compatibility_result_notes"
         android:visibility="gone" />
 
-    <CheckBox
-        android:id="@+id/quick_availability_hidden"
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:text="@string/quick_compatibility_hidden" />
-
     <Button
         android:id="@+id/quick_availability_button_continue"
         android:layout_width="match_parent"
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 8530dd09d..490b128d6 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -18,7 +18,6 @@
     <string name="quick_compatibility_not_compatible_but_usb">Your smartphone is not fully compatible with %s. However, you can still use a USB smart card reader for near-full functionality.</string>
     <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
-    <string name="quick_compatibility_hidden">Do not show this message again.</string>
     <string name="quick_compatibility_button_continue">Continue</string>
 
     <!-- Compatibility Check Descriptions -->

From 65775c1d063475c8c26ff97c1b4b322ca30774f7 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:37:30 -0400
Subject: [PATCH 420/458] Delete old (and useless) compatibility checks

---
 app-unpriv/src/main/AndroidManifest.xml       |   5 -
 .../ui/CompatibilityCheckActivity.kt          |  95 ------
 .../UnprivilegedNoEuiccPlaceholderFragment.kt |   2 +-
 .../openeuicc/util/CompatibilityCheck.kt      | 280 ------------------
 .../layout/activity_compatibility_check.xml   |  18 --
 app-unpriv/src/main/res/values-ja/strings.xml |  28 --
 .../src/main/res/values-zh-rCN/strings.xml    |  27 --
 .../src/main/res/values-zh-rTW/strings.xml    |  27 --
 app-unpriv/src/main/res/values/strings.xml    |  29 --
 9 files changed, 1 insertion(+), 510 deletions(-)
 delete mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
 delete mode 100644 app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
 delete mode 100644 app-unpriv/src/main/res/layout/activity_compatibility_check.xml

diff --git a/app-unpriv/src/main/AndroidManifest.xml b/app-unpriv/src/main/AndroidManifest.xml
index ba3707997..9c141634c 100644
--- a/app-unpriv/src/main/AndroidManifest.xml
+++ b/app-unpriv/src/main/AndroidManifest.xml
@@ -28,11 +28,6 @@
             android:exported="false"
             android:label="@string/quick_compatibility" />
 
-        <activity
-            android:name="im.angry.openeuicc.ui.CompatibilityCheckActivity"
-            android:exported="false"
-            android:label="@string/compatibility_check" />
-
         <service
             android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"
             android:enabled="false"
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
deleted file mode 100644
index 39a360f98..000000000
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/CompatibilityCheckActivity.kt
+++ /dev/null
@@ -1,95 +0,0 @@
-package im.angry.openeuicc.ui
-
-import android.annotation.SuppressLint
-import android.os.Bundle
-import android.text.Html
-import android.view.MenuItem
-import android.view.View
-import android.view.ViewGroup
-import android.widget.TextView
-import androidx.activity.enableEdgeToEdge
-import androidx.appcompat.app.AppCompatActivity
-import androidx.core.view.children
-import androidx.core.view.isVisible
-import androidx.lifecycle.lifecycleScope
-import androidx.recyclerview.widget.DividerItemDecoration
-import androidx.recyclerview.widget.LinearLayoutManager
-import androidx.recyclerview.widget.RecyclerView
-import im.angry.easyeuicc.R
-import im.angry.openeuicc.util.*
-import kotlinx.coroutines.launch
-
-class CompatibilityCheckActivity: AppCompatActivity() {
-    private lateinit var compatibilityCheckList: RecyclerView
-    private val compatibilityChecks: List<CompatibilityCheck> by lazy { getCompatibilityChecks(this) }
-    private val adapter = CompatibilityChecksAdapter()
-
-    override fun onCreate(savedInstanceState: Bundle?) {
-        enableEdgeToEdge()
-        super.onCreate(savedInstanceState)
-        setContentView(R.layout.activity_compatibility_check)
-        setSupportActionBar(requireViewById(im.angry.openeuicc.common.R.id.toolbar))
-        setupToolbarInsets()
-        supportActionBar!!.setDisplayHomeAsUpEnabled(true)
-
-        compatibilityCheckList = requireViewById<RecyclerView>(R.id.recycler_view).also {
-            it.layoutManager = LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false)
-            it.addItemDecoration(DividerItemDecoration(this, LinearLayoutManager.VERTICAL))
-            it.adapter = adapter
-        }
-
-        setupRootViewInsets(compatibilityCheckList)
-    }
-
-    @SuppressLint("NotifyDataSetChanged")
-    override fun onStart() {
-        super.onStart()
-        lifecycleScope.launch {
-            compatibilityChecks.executeAll { adapter.notifyDataSetChanged() }
-        }
-    }
-
-    override fun onOptionsItemSelected(item: MenuItem): Boolean =
-        when (item.itemId) {
-            android.R.id.home -> {
-                finish()
-                true
-            }
-            else -> super.onOptionsItemSelected(item)
-        }
-
-    inner class ViewHolder(private val root: View): RecyclerView.ViewHolder(root) {
-        private val titleView: TextView = root.requireViewById(R.id.compatibility_check_title)
-        private val descView: TextView = root.requireViewById(R.id.compatibility_check_desc)
-        private val statusContainer: ViewGroup = root.requireViewById(R.id.compatibility_check_status_container)
-
-        fun bindItem(item: CompatibilityCheck) {
-            titleView.text = item.title
-            descView.text = Html.fromHtml(item.description, Html.FROM_HTML_MODE_COMPACT)
-
-            statusContainer.children.forEach {
-                it.isVisible = false
-            }
-
-            val viewId = when (item.state) {
-                CompatibilityCheck.State.SUCCESS -> R.id.compatibility_check_checkmark
-                CompatibilityCheck.State.FAILURE -> R.id.compatibility_check_error
-                CompatibilityCheck.State.FAILURE_UNKNOWN -> R.id.compatibility_check_unknown
-                else -> R.id.compatibility_check_progress_bar
-            }
-            root.requireViewById<View>(viewId).isVisible = true
-        }
-    }
-
-    inner class CompatibilityChecksAdapter: RecyclerView.Adapter<ViewHolder>() {
-        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder =
-            ViewHolder(layoutInflater.inflate(R.layout.compatibility_check_item, parent, false))
-
-        override fun getItemCount(): Int =
-            compatibilityChecks.indexOfLast { it.state != CompatibilityCheck.State.NOT_STARTED } + 1
-
-        override fun onBindViewHolder(holder: ViewHolder, position: Int) {
-            holder.bindItem(compatibilityChecks[position])
-        }
-    }
-}
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
index 92cda23bf..56ad690d5 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedNoEuiccPlaceholderFragment.kt
@@ -21,7 +21,7 @@ class UnprivilegedNoEuiccPlaceholderFragment : Fragment() {
         )
 
         view.findViewById<View>(R.id.compatibility_check).setOnClickListener {
-            startActivity(Intent(requireContext(), CompatibilityCheckActivity::class.java))
+            startActivity(Intent(requireContext(), QuickCompatibilityActivity::class.java))
         }
 
         return view
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
deleted file mode 100644
index b2b503a9c..000000000
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/CompatibilityCheck.kt
+++ /dev/null
@@ -1,280 +0,0 @@
-package im.angry.openeuicc.util
-
-import android.content.Context
-import android.content.pm.PackageManager
-import android.os.Build
-import android.se.omapi.Reader
-import android.telephony.TelephonyManager
-import im.angry.easyeuicc.R
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.delay
-import kotlinx.coroutines.withContext
-import java.io.IOException
-
-fun getCompatibilityChecks(context: Context): List<CompatibilityCheck> =
-    listOf(
-        HasSystemFeaturesCheck(context),
-        OmapiConnCheck(context),
-        IsdrChannelAccessCheck(context),
-        KnownBrokenCheck(context),
-        UsbCheck(context),
-        Verdict(context),
-    )
-
-inline fun <reified T: CompatibilityCheck> List<CompatibilityCheck>.findCheck(): T? =
-    find { it.javaClass == T::class.java }?.let { it as T }
-
-suspend fun List<CompatibilityCheck>.executeAll(callback: () -> Unit) = withContext(Dispatchers.IO) {
-    forEach {
-        it.run(this@executeAll)
-        withContext(Dispatchers.Main) {
-            callback()
-        }
-    }
-}
-
-val Reader.isSIM: Boolean
-    get() = name.startsWith("SIM")
-
-val Reader.slotIndex: Int
-    get() = (name.replace("SIM", "").toIntOrNull() ?: 1)
-
-abstract class CompatibilityCheck(context: Context) {
-    enum class State {
-        NOT_STARTED,
-        IN_PROGRESS,
-        SUCCESS,
-        FAILURE_UNKNOWN, // The check technically failed, but no conclusion can be drawn
-        FAILURE
-    }
-
-    var state = State.NOT_STARTED
-
-    abstract val title: String
-    protected abstract val defaultDescription: String
-    protected lateinit var successDescription: String
-    protected lateinit var failureDescription: String
-
-    val description: String
-        get() = when {
-            (state == State.FAILURE || state == State.FAILURE_UNKNOWN) && this::failureDescription.isInitialized -> failureDescription
-            state == State.SUCCESS && this::successDescription.isInitialized -> successDescription
-            else -> defaultDescription
-        }
-
-    protected abstract suspend fun doCheck(allChecks: List<CompatibilityCheck>): State
-
-    suspend fun run(allChecks: List<CompatibilityCheck>) {
-        state = State.IN_PROGRESS
-        delay(200)
-        state = try {
-            doCheck(allChecks)
-        } catch (_: Exception) {
-            State.FAILURE
-        }
-    }
-}
-
-internal class HasSystemFeaturesCheck(private val context: Context): CompatibilityCheck(context) {
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_system_features)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_system_features_desc)
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
-        if (!context.packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY)) {
-            failureDescription = context.getString(R.string.compatibility_check_system_features_no_telephony)
-            return State.FAILURE
-        }
-
-        // We can check OMAPI UICC availability on R or later (if before R, we check OMAPI connectivity later)
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R && !context.packageManager.hasSystemFeature(
-            PackageManager.FEATURE_SE_OMAPI_UICC
-        )) {
-            failureDescription = context.getString(R.string.compatibility_check_system_features_no_omapi)
-            return State.FAILURE_UNKNOWN
-        }
-
-        return State.SUCCESS
-    }
-}
-
-internal class OmapiConnCheck(private val context: Context): CompatibilityCheck(context) {
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_omapi_connectivity)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_omapi_connectivity_desc)
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
-        val seService = connectSEService(context)
-        if (!seService.isConnected) {
-            failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail)
-            return State.FAILURE
-        }
-
-        val tm = context.getSystemService(TelephonyManager::class.java)
-        val simReaders = seService.readers.filter { it.isSIM }
-        if (simReaders.isEmpty()) {
-            failureDescription = context.getString(R.string.compatibility_check_omapi_connectivity_fail)
-            return State.FAILURE_UNKNOWN
-        } else if (simReaders.size < tm.activeModemCountCompat) {
-            successDescription = context.getString(R.string.compatibility_check_omapi_connectivity_partial_success_sim_number,
-                simReaders.map { it.slotIndex }.joinToString(", "))
-            return State.SUCCESS
-        }
-
-        return State.SUCCESS
-    }
-}
-
-internal class IsdrChannelAccessCheck(private val context: Context): CompatibilityCheck(context) {
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_isdr_channel)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_isdr_channel_desc)
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
-        val seService = connectSEService(context)
-        val readers = seService.readers.filter { it.isSIM }
-        if (readers.isEmpty()) {
-            failureDescription = context.getString(R.string.compatibility_check_isdr_channel_desc_unknown)
-            return State.FAILURE_UNKNOWN
-        }
-
-        val (validSlotIds, result) = readers.map {
-            try {
-                // Note: we ONLY check the default ISD-R AID, because this test is for the _device_,
-                // NOT the eUICC. We don't care what AID a potential eUICC might use, all we need to
-                // check is we can open _some_ AID.
-                it.openSession().openLogicalChannel(EUICC_DEFAULT_ISDR_AID.decodeHex())?.close()
-                Pair(it.slotIndex, State.SUCCESS)
-            } catch (_: SecurityException) {
-                // Ignore; this is expected when everything works
-                // ref: https://android.googlesource.com/platform/frameworks/base/+/4fe64fb4712a99d5da9c9a0eb8fd5169b252e1e1/omapi/java/android/se/omapi/Session.java#305
-                // SecurityException is only thrown when Channel is constructed, which means everything else needs to succeed
-                Pair(it.slotIndex, State.SUCCESS)
-            } catch (e: IOException) {
-                e.printStackTrace()
-                if (e.message?.contains("Secure Element is not present") == true) {
-                    failureDescription = context.getString(R.string.compatibility_check_isdr_channel_desc_unknown)
-                    Pair(it.slotIndex, State.FAILURE_UNKNOWN)
-                } else {
-                    Pair(it.slotIndex, State.FAILURE)
-                }
-            } catch (e: Exception) {
-                e.printStackTrace()
-                Pair(it.slotIndex, State.FAILURE)
-            }
-        }.fold(Pair(mutableListOf<Int>(), State.SUCCESS)) { (ids, result), (id, ok) ->
-            if (ok != State.SUCCESS) {
-                Pair(ids, ok)
-            } else {
-                Pair(ids.apply { add(id) }, result)
-            }
-        }
-
-        if (result != State.SUCCESS && validSlotIds.isNotEmpty()) {
-            if (!context.packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY_EUICC)) {
-                failureDescription = context.getString(
-                    R.string.compatibility_check_isdr_channel_desc_partial_fail,
-                    validSlotIds.joinToString(", ")
-                )
-            } else {
-                // If the device has embedded eSIMs, we can likely ignore the failure here;
-                // the OMAPI failure likely resulted from trying to access internal eSIMs.
-                return State.SUCCESS
-            }
-        }
-
-        return result
-    }
-}
-
-internal class KnownBrokenCheck(private val context: Context): CompatibilityCheck(context) {
-    companion object {
-        val BROKEN_MANUFACTURERS = arrayOf("xiaomi", "huawei", "honor")
-    }
-
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_known_broken)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_known_broken_desc)
-
-    init {
-        failureDescription = context.getString(R.string.compatibility_check_known_broken_fail)
-    }
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State =
-        if (Build.MANUFACTURER.lowercase() in BROKEN_MANUFACTURERS) {
-            State.FAILURE
-        } else {
-            State.SUCCESS
-        }
-}
-
-internal class UsbCheck(private val context: Context) : CompatibilityCheck(context) {
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_usb)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_usb_desc)
-
-    init {
-        successDescription = context.getString(R.string.compatibility_check_usb_ok)
-        failureDescription = context.getString(R.string.compatibility_check_usb_fail)
-    }
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State =
-        if (context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_HOST)) {
-            State.SUCCESS
-        } else {
-            State.FAILURE
-        }
-
-}
-
-internal class Verdict(private val context: Context) : CompatibilityCheck(context) {
-    override val title: String
-        get() = context.getString(R.string.compatibility_check_verdict)
-    override val defaultDescription: String
-        get() = context.getString(R.string.compatibility_check_verdict_desc)
-
-    override suspend fun doCheck(allChecks: List<CompatibilityCheck>): State {
-        if (allChecks.findCheck<KnownBrokenCheck>()?.state == State.FAILURE) {
-            failureDescription = context.getString(
-                R.string.compatibility_check_verdict_known_broken,
-                context.getString(R.string.compatibility_check_verdict_fail_shared)
-            )
-            return State.FAILURE
-        }
-
-        if (allChecks.findCheck<OmapiConnCheck>()?.state == State.SUCCESS &&
-            allChecks.findCheck<IsdrChannelAccessCheck>()?.state == State.SUCCESS
-        ) {
-            successDescription = context.getString(R.string.compatibility_check_verdict_ok)
-            return State.SUCCESS
-        }
-
-        if (allChecks.findCheck<OmapiConnCheck>()?.state == State.FAILURE_UNKNOWN ||
-            allChecks.findCheck<IsdrChannelAccessCheck>()?.state == State.FAILURE_UNKNOWN
-        ) {
-            // We are not sure because we can't fully check OMAPI
-            // however we can guess based on feature flags
-            // TODO: We probably need a "known-good" list for these devices as well?
-            failureDescription = context.getString(
-                if (allChecks.findCheck<HasSystemFeaturesCheck>()?.state == State.SUCCESS) {
-                    R.string.compatibility_check_verdict_unknown_likely_ok
-                } else {
-                    R.string.compatibility_check_verdict_unknown_likely_fail
-                },
-                context.getString(R.string.compatibility_check_verdict_fail_shared)
-            )
-            return State.FAILURE_UNKNOWN
-        }
-
-        failureDescription = context.getString(
-            R.string.compatibility_check_verdict_unknown,
-            context.getString(R.string.compatibility_check_verdict_fail_shared)
-        )
-        return State.FAILURE_UNKNOWN
-    }
-}
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml b/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
deleted file mode 100644
index 4d622e391..000000000
--- a/app-unpriv/src/main/res/layout/activity_compatibility_check.xml
+++ /dev/null
@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent">
-
-    <include layout="@layout/toolbar_activity" />
-
-    <androidx.recyclerview.widget.RecyclerView
-        android:id="@+id/recycler_view"
-        android:layout_width="0dp"
-        android:layout_height="0dp"
-        app:layout_constraintTop_toBottomOf="@id/toolbar"
-        app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintEnd_toEndOf="parent"
-        app:layout_constraintBottom_toBottomOf="parent" />
-
-</androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index 3a6851a9f..c9443dc03 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -6,32 +6,4 @@
     <!-- Toast -->
     <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
     <string name="toast_prompt_to_enable_sim_toolkit">「%s」アプリを有効化してください</string>
-    <!-- Compatibility Check Descriptions -->
-    <string name="compatibility_check_system_features">システムの機能</string>
-    <string name="compatibility_check_system_features_desc">デバイスにリムーバブル eUICC カードの管理に必要なすべての機能が備わっているかどうか。例えば基本的な電話機能や OMAPI のサポートなど。</string>
-    <string name="compatibility_check_system_features_no_telephony">使用しているデバイスには電話機能がありません。</string>
-    <string name="compatibility_check_system_features_no_omapi">使用しているデバイスまたはシステムには OMAPI のサポートを宣言していません。これは、ハードウェアからのサポートが不足していることが原因の可能性があります。または、フラグが不足していることが原因の可能性もあります。OMAPI が実際にサポートされているかどうかを判断するには次の 2 つのチェック項目を参照してください。</string>
-    <string name="compatibility_check_omapi_connectivity">OMAPI の接続</string>
-    <string name="compatibility_check_omapi_connectivity_desc">使用しているデバイスは、OMAPI 経由で SIM カード上のセキュアエレメントへのアクセスを許可しているか否や。</string>
-    <string name="compatibility_check_omapi_connectivity_fail">OMAPI 経由で SIM カードのセキュアエレメントリーダーを検出できません。このデバイスに SIM を挿入していない場合は、SIM を挿入後にこのチェックを再試行してください。</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">セキュアエレメントのアクセスが正常に検出されましたが、次の SIM スロットでのみ有効です: &lt;b&gt;SIM%s&lt;/b&gt;</string>
-    <string name="compatibility_check_isdr_channel">ISD-R チャネルアクセス</string>
-    <string name="compatibility_check_isdr_channel_desc">使用しているデバイスは、OMAPI 経由で eSIM への ISD-R (管理) チャネルを開くことをサポートしているか否や。</string>
-    <string name="compatibility_check_isdr_channel_desc_unknown">OMAPI 経由での ISD-R アクセスがサポートされているかどうかを確認できません。まだ SIM カードが挿入されていない場合は、挿入した状態で再試行してください (どの SIM カードでも構いません)。</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">ISD-R への OMAPI アクセスは、次のスロットでのみ可能です: &lt;b&gt;SIM%s&lt;/b&gt;</string>
-    <string name="compatibility_check_known_broken">既知の破損リストの記載されていない</string>
-    <string name="compatibility_check_known_broken_desc">取り外し可能な eSIM に関連するバグがデバイスに存在しないかを確認します。</string>
-    <string name="compatibility_check_known_broken_fail">おっと...使用しているデバイスには、取り外し可能な eSIM へのアクセス時にバグが存在します。これは必ずしも全く機能しないことを意味するわけではありませんが、注意して進める必要があります。</string>
-    <string name="compatibility_check_usb">USB カードリーダーのサポート</string>
-    <string name="compatibility_check_usb_desc">使用しているデバイスは、USB カードリーダー経由の eSIM の管理をサポートしているか否や。</string>
-    <string name="compatibility_check_usb_ok">このデバイスの標準 USB CCID リーダーを介して eSIM を管理できます (ここで他のチェック項目に失敗した場合でも)。カードリーダーを挿入し、このアプリを開いてこの方法で eSIM を管理できます。</string>
-    <string name="compatibility_check_usb_fail">使用しているデバイスは USB ホストとしての機能をサポートしていません。</string>
-    <string name="compatibility_check_verdict">判定 (USB 以外)</string>
-    <string name="compatibility_check_verdict_desc">これまでのすべてのチェック項目に基づいて、デバイスに挿入された取り外し可能な eSIM の管理と互換性がある可能性はどの程度かについて</string>
-    <string name="compatibility_check_verdict_ok">このデバイスに挿入された取り外し可能な eSIM の使用および管理が使用できる可能性があります。</string>
-    <string name="compatibility_check_verdict_known_broken">挿入された取り外し可能な eSIM にアクセスするとデバイスにバグが発生することが知られています。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_ok">挿入された取り外し可能な eSIM が使用しているデバイスで管理できるかはわかりません。ただし、このデバイスは OMAPI のサポートを宣言しているため、動作する可能性はわずかに高くなります。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_fail">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかは判断できません。デバイスが OMAPI のサポートを宣言していないため、このデバイス上で取り外し可能な eSIM を管理することはサポートされていない可能性があります。\n%s</string>
-    <string name="compatibility_check_verdict_unknown">挿入された取り外し可能な eSIM がデバイス上で管理できるかどうかを確認できません。\n%s</string>
-    <string name="compatibility_check_verdict_fail_shared">ただし、eSIM プロファイルがすでに読み込まれている場合、有効化されたプロファイル自体は引き続き機能します。また、プロファイルが管理できない場合は、このデバイスで USB カードリーダーを介してプロファイルを管理できる可能性があります。</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-zh-rCN/strings.xml b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
index 8d3060d62..5666fbb61 100644
--- a/app-unpriv/src/main/res/values-zh-rCN/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
@@ -1,32 +1,5 @@
 <resources>
     <string name="compatibility_check">兼容性检查</string>
     <string name="open_sim_toolkit">打开 SIM 卡应用程序</string>
-    <string name="compatibility_check_system_features">系统功能</string>
-    <string name="compatibility_check_system_features_desc">您的设备是否具有管理可插拔 eUICC 卡所需的所有功能。例如，基本的电话功能和 OMAPI 支持。</string>
-    <string name="compatibility_check_system_features_no_telephony">您的设备没有电话功能。</string>
-    <string name="compatibility_check_system_features_no_omapi">您的设备/系统未声明支持 OMAPI。这可能是由于缺少硬件支持，或者可能仅仅是由于缺少标志。请参阅以下两项检查以确定 OMAPI 是否确实受支持。</string>
-    <string name="compatibility_check_omapi_connectivity">OMAPI 连接</string>
-    <string name="compatibility_check_omapi_connectivity_desc">您的设备是否允许通过 OMAPI 访问 SIM 卡上的安全元件？</string>
-    <string name="compatibility_check_omapi_connectivity_fail">无法通过 OMAPI 检测到 SIM 卡的 Secure Element。如果您尚未在此设备中插入 SIM 卡，请尝试插入一张 SIM 卡并重试此检查。</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">已成功检测到可访问 Secure Element 的卡槽，但仅限于以下 SIM 卡槽：<b>SIM%s</b>。</string>
-    <string name="compatibility_check_isdr_channel">ISD-R 通道访问</string>
-    <string name="compatibility_check_isdr_channel_desc">您的设备是否支持通过 OMAPI 打开 eSIM 的 ISD-R (管理) 通道？</string>
-    <string name="compatibility_check_isdr_channel_desc_unknown">无法确定是否支持通过 OMAPI 进行 ISD-R 访问。如果尚未插入，您可能需要插入 SIM 卡 (任何 SIM 卡都可以) 重试。</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI 只能在以下 SIM 插槽上访问 ISD-R：<b>SIM%s</b>。</string>
-    <string name="compatibility_check_known_broken">不在已知的 BUG 名单中</string>
-    <string name="compatibility_check_known_broken_desc">确保您的设备不存在与可插拔 eSIM 相关的错误。</string>
-    <string name="compatibility_check_known_broken_fail">糟糕，您的设备在访问可插拔 eSIM 时存在错误。这并不表示完全无法使用，但我们不保证该应用在您设备上的行为。</string>
-    <string name="compatibility_check_usb">USB 读卡器支持</string>
-    <string name="compatibility_check_usb_desc">您的设备是否支持通过 USB 读卡器管理 eSIM？</string>
-    <string name="compatibility_check_usb_ok">您可以通过此设备上的标准 USB CCID 读取器管理 eSIM (即使您在这里有任何其他检查项失败)。请插入读卡器，然后打开此应用程序以这种方式管理 eSIM。</string>
-    <string name="compatibility_check_usb_fail">您的设备不支持 USB 读卡器。</string>
-    <string name="compatibility_check_verdict">结论 (USB 读卡器以外)</string>
-    <string name="compatibility_check_verdict_desc">根据之前的所有检查，您的设备与可插拔 eSIM 卡兼容的可能性有多大？</string>
-    <string name="compatibility_check_verdict_ok">您可以使用和管理插入此设备的可插拔 eSIM 卡。</string>
-    <string name="compatibility_check_verdict_known_broken">已知您的设备在访问可插拔 eSIM 卡时存在问题。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_ok">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。不过，您的设备确实声明支持 OMAPI，因此它工作的可能性略高。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_fail">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。由于您的设备未声明支持OMAPI，因此更有可能不支持在此设备上管理可插拔 eSIM。\n%s</string>
-    <string name="compatibility_check_verdict_unknown">我们无法确定是否可以在您的设备上管理可插拔 eSIM 卡。\n%s</string>
-    <string name="compatibility_check_verdict_fail_shared">然而，已经加载了eSIM配置文件的可插拔 eSIM 卡仍然可以工作; 即使无法在装置上直接管理可插拔 eSIM 卡中的配置文件，您仍然可以使用 USB 卡读卡器来管理配置文件。</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已拷贝到剪贴板</string>
 </resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-zh-rTW/strings.xml b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
index b8d0eb83d..dcded790c 100644
--- a/app-unpriv/src/main/res/values-zh-rTW/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
@@ -1,32 +1,5 @@
 <resources>
     <string name="compatibility_check">相容性檢查</string>
     <string name="open_sim_toolkit">啟動 SIM 卡應用程式</string>
-    <string name="compatibility_check_system_features">系統功能</string>
-    <string name="compatibility_check_system_features_desc">您的裝置是否具有管理可插拔 eUICC 卡所需的所有功能。例如，基本的電話功能和 OMAPI 支援。</string>
-    <string name="compatibility_check_system_features_no_telephony">您的裝置沒有電話功能。</string>
-    <string name="compatibility_check_system_features_no_omapi">您的裝置/系統未宣告支援 OMAPI。這可能是由於缺少硬體支援，或者可能僅僅是由於缺少標誌。請參閱以下兩項檢查以確定 OMAPI 是否確實受支援。</string>
-    <string name="compatibility_check_omapi_connectivity">OMAPI 連線</string>
-    <string name="compatibility_check_omapi_connectivity_desc">您的裝置是否允許透過 OMAPI 存取 SIM 卡上的安全元件？</string>
-    <string name="compatibility_check_omapi_connectivity_fail">無法透過 OMAPI 偵測到 SIM 卡的 Secure Element。如果您尚未在此裝置中插入 SIM 卡，請嘗試插入一張 SIM 卡並重試此檢查。</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">已成功檢測到可存取 Secure Element 的卡槽，但僅限於以下 SIM 卡槽：<b>SIM%s</b>。</string>
-    <string name="compatibility_check_isdr_channel">ISD-R 通道存取</string>
-    <string name="compatibility_check_isdr_channel_desc">您的裝置是否支援透過 OMAPI 開啟 eSIM 的 ISD-R (管理) 通道？</string>
-    <string name="compatibility_check_isdr_channel_desc_unknown">無法確定是否支援透過 OMAPI 進行 ISD-R 的存取。如果尚未插入，您可能需要插入 SIM 卡 (任何 SIM 卡都可以) 重試。</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI 只能在以下 SIM 插槽上存取 ISD-R：<b>SIM%s</b>。</string>
-    <string name="compatibility_check_known_broken">不在已知錯誤清單中</string>
-    <string name="compatibility_check_known_broken_desc">確保您的裝置不存在與可插拔 eSIM 相關的錯誤。</string>
-    <string name="compatibility_check_known_broken_fail">很抱歉，您的裝置在存取可插拔 eSIM 時存在錯誤。這並不表示完全無法使用，但我們不保證該應用在您裝置上的行為。</string>
-    <string name="compatibility_check_usb">USB 晶片讀卡機支援</string>
-    <string name="compatibility_check_usb_desc">您的裝置是否支援透過 USB 晶片讀卡機管理 eSIM？</string>
-    <string name="compatibility_check_usb_ok">您可以透過此裝置上的標準 USB CCID 讀卡機管理 eSIM (即使您在這裡有任何其他檢查項失敗)。請插入讀卡機，然後開啟此應用程式以這種方式管理 eSIM。</string>
-    <string name="compatibility_check_usb_fail">您的裝置不支援 USB 晶片讀卡機。</string>
-    <string name="compatibility_check_verdict">結論 (USB 晶片讀卡機以外)</string>
-    <string name="compatibility_check_verdict_desc">根據之前的所有檢查，您的裝置與可插拔 eSIM 卡相容的可能性有多大？</string>
-    <string name="compatibility_check_verdict_ok">您可以使用和管理插入此裝置的可插拔 eSIM 卡。</string>
-    <string name="compatibility_check_verdict_known_broken">已知您的裝置在存取可插拔 eSIM 卡時存在問題。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_ok">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。不過，您的裝置確實宣告支援 OMAPI，因此它工作的可能性略高。\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_fail">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。由於您的裝置未宣告支援OMAPI，因此更有可能不支援在此裝置上管理可插拔 eSIM。\n%s</string>
-    <string name="compatibility_check_verdict_unknown">我們無法確定是否可以在您的裝置上管理可插拔 eSIM 卡。\n%s</string>
-    <string name="compatibility_check_verdict_fail_shared">然而，已經載入了eSIM設定檔的可插拔 eSIM 卡仍然可以工作; 即使無法在裝置上直接管理可插拔 eSIM 卡中的設定檔，您仍然可以使用 USB 卡讀卡機來管理設定檔。</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已複製到剪貼簿</string>
 </resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 490b128d6..9ab4d3d84 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -19,33 +19,4 @@
     <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
     <string name="quick_compatibility_button_continue">Continue</string>
-
-    <!-- Compatibility Check Descriptions -->
-    <string name="compatibility_check_system_features">System Features</string>
-    <string name="compatibility_check_system_features_desc">Whether your device has all the required features for managing removable eUICC cards. For example, basic telephony and OMAPI support.</string>
-    <string name="compatibility_check_system_features_no_telephony">Your device has no telephony features.</string>
-    <string name="compatibility_check_system_features_no_omapi">Your device / system does not declare support for OMAPI. This could be due to missing support from hardware, or it could be simply due to a missing flag. See the following two checks to determine whether OMAPI is actually supported or not.</string>
-    <string name="compatibility_check_omapi_connectivity">OMAPI Connectivity</string>
-    <string name="compatibility_check_omapi_connectivity_desc">Does your device allow access to Secure Elements on SIM cards via OMAPI?</string>
-    <string name="compatibility_check_omapi_connectivity_fail">Unable to detect Secure Element readers for SIM cards via OMAPI. If you have not inserted a SIM in this device, try inserting one and retry this check.</string>
-    <string name="compatibility_check_omapi_connectivity_partial_success_sim_number">Successfully detected Secure Element access, but only for the following SIM slots: &lt;b&gt;SIM%s&lt;/b&gt;.</string>
-    <string name="compatibility_check_isdr_channel">ISD-R Channel Access</string>
-    <string name="compatibility_check_isdr_channel_desc">Does your device support opening an ISD-R (management) channel to eSIMs via OMAPI?</string>
-    <string name="compatibility_check_isdr_channel_desc_unknown">Cannot determine whether ISD-R access through OMAPI is supported. You might want to retry with SIM cards inserted (any SIM card will do) if not already.</string>
-    <string name="compatibility_check_isdr_channel_desc_partial_fail">OMAPI access to ISD-R is only possible on the following SIM slots: &lt;b&gt;SIM%s&lt;/b&gt;.</string>
-    <string name="compatibility_check_known_broken">Not on the Known Broken List</string>
-    <string name="compatibility_check_known_broken_desc">Making sure your device is not known to have bugs associated with removable eSIMs.</string>
-    <string name="compatibility_check_known_broken_fail">Oops, your device is known to have bugs when accessing removable eSIMs. This does not necessarily mean that it will not work at all, but you will have to proceed with caution.</string>
-    <string name="compatibility_check_usb">USB Card Reader Support</string>
-    <string name="compatibility_check_usb_desc">Does your device support managing eSIMs via USB card readers?</string>
-    <string name="compatibility_check_usb_ok">You can manage eSIMs through standard USB CCID readers on this device (even if you had any other check items fail here). Insert the card reader and then open this app to manage eSIMs in this way.</string>
-    <string name="compatibility_check_usb_fail">Your device does not support acting as a USB host.</string>
-    <string name="compatibility_check_verdict">Verdict (non-USB)</string>
-    <string name="compatibility_check_verdict_desc">Based on all previous checks, how likely is your device to be compatible with managing inserted removable eSIMs?</string>
-    <string name="compatibility_check_verdict_ok">You can likely use and manage removable eSIMs inserted into this device.</string>
-    <string name="compatibility_check_verdict_known_broken">Your device is known to be buggy when accessing inserted removable eSIMs.\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_ok">We cannot determine whether inserted removable eSIMs can be managed on your device. Your device does declare support for OMAPI, though, so it is slightly more likely that it will work.\n%s</string>
-    <string name="compatibility_check_verdict_unknown_likely_fail">We cannot determine whether inserted removable eSIMs can be managed on your device. Since your device does not declare support for OMAPI, it is more likely that managing removable eSIMs on this device is unsupported.\n%s</string>
-    <string name="compatibility_check_verdict_unknown">We cannot determine whether inserted removable eSIMs can be managed on your device.\n%s</string>
-    <string name="compatibility_check_verdict_fail_shared">However, a removable eSIM that has already been loaded with an eSIM profile will still work; you can also most likely use a USB card reader plugged into this device to manage profiles, even if you cannot manage one inserted into your device.</string>
 </resources>
\ No newline at end of file

From 4991f2580ec9265e901019263beae37b0ae76322 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:43:21 -0400
Subject: [PATCH 421/458] Add a different note for the incompatible result

---
 .../ui/QuickCompatibilityFragment.kt          | 37 ++++++++++++-------
 app-unpriv/src/main/res/values/strings.xml    |  1 +
 2 files changed, 24 insertions(+), 14 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index 9b54640c0..943b72a66 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -4,6 +4,7 @@ import android.content.pm.PackageManager
 import android.icu.text.ListFormatter
 import android.os.Build
 import android.os.Bundle
+import android.se.omapi.Reader
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
@@ -17,8 +18,6 @@ import im.angry.openeuicc.util.EUICC_DEFAULT_ISDR_AID
 import im.angry.openeuicc.util.UnprivilegedEuiccContextMarker
 import im.angry.openeuicc.util.connectSEService
 import im.angry.openeuicc.util.decodeHex
-import im.angry.openeuicc.util.isSIM
-import im.angry.openeuicc.util.slotIndex
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.runBlocking
 
@@ -66,22 +65,26 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     }
 
     private fun onContinueToApp() {
-        runBlocking {
-            preferenceRepository.skipQuickAvailabilityFlow
-                .updatePreference(true)
-        }
         requireActivity().finish()
     }
 
     private fun onCompatibilityUpdate(result: CompatibilityResult) {
         conclusion.text = formatConclusion(result)
-        if (result.compatibility != Compatibility.COMPATIBLE) return
-        resultSlots.isVisible = true
-        resultSlots.text = getString(
-            R.string.quick_compatibility_result_slots,
-            ListFormatter.getInstance().format(result.slots)
-        )
-        resultNotes.isVisible = true
+        if (result.compatibility == Compatibility.COMPATIBLE) {
+            runBlocking {
+                preferenceRepository.skipQuickAvailabilityFlow
+                    .updatePreference(true)
+            }
+            resultSlots.isVisible = true
+            resultSlots.text = getString(
+                R.string.quick_compatibility_result_slots,
+                ListFormatter.getInstance().format(result.slots)
+            )
+            resultNotes.isVisible = true
+        } else {
+            resultNotes.isVisible = true
+            resultNotes.text = getString(R.string.quick_compatibility_result_notes_incompatible)
+        }
     }
 
     private suspend fun getCompatibilityCheckResult(): CompatibilityResult {
@@ -132,4 +135,10 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         appendLine("VERSION.RELEASE: ${Build.VERSION.RELEASE}")
         appendLine("VERSION.SDK_INT: ${Build.VERSION.SDK_INT}")
     }
-}
\ No newline at end of file
+}
+
+val Reader.isSIM: Boolean
+    get() = name.startsWith("SIM")
+
+val Reader.slotIndex: Int
+    get() = (name.replace("SIM", "").toIntOrNull() ?: 1)
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 9ab4d3d84..8671ae741 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -18,5 +18,6 @@
     <string name="quick_compatibility_not_compatible_but_usb">Your smartphone is not fully compatible with %s. However, you can still use a USB smart card reader for near-full functionality.</string>
     <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
+    <string name="quick_compatibility_result_notes_incompatible">Note: if you currently do not have any SIM card inserted, try the compatibility check again after inserting one. Any SIM card will do.</string>
     <string name="quick_compatibility_button_continue">Continue</string>
 </resources>
\ No newline at end of file

From 4c221f74ff30414f347c97c64f95fe2f47f2ad99 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:43:49 -0400
Subject: [PATCH 422/458] Don't do compatibility check in the main thread

---
 .../im/angry/openeuicc/ui/QuickCompatibilityFragment.kt     | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index 943b72a66..9f684d95a 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -18,8 +18,10 @@ import im.angry.openeuicc.util.EUICC_DEFAULT_ISDR_AID
 import im.angry.openeuicc.util.UnprivilegedEuiccContextMarker
 import im.angry.openeuicc.util.connectSEService
 import im.angry.openeuicc.util.decodeHex
+import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.withContext
 
 open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMarker {
     companion object {
@@ -60,7 +62,9 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     override fun onStart() {
         super.onStart()
         lifecycleScope.launch {
-            onCompatibilityUpdate(getCompatibilityCheckResult())
+            onCompatibilityUpdate(withContext(Dispatchers.IO) {
+                getCompatibilityCheckResult()
+            })
         }
     }
 

From 52cf68d43d68dc3e564b6d5b296547a58f0249e5 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:51:06 -0400
Subject: [PATCH 423/458] Show a different note when incompatible

---
 .../openeuicc/ui/QuickCompatibilityFragment.kt   | 16 ++++++++++++++++
 .../res/layout/fragment_quick_compatibility.xml  |  7 +++++++
 app-unpriv/src/main/res/values/strings.xml       |  1 +
 3 files changed, 24 insertions(+)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index 9f684d95a..c480a7857 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -9,6 +9,7 @@ import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
 import android.widget.Button
+import android.widget.CheckBox
 import android.widget.TextView
 import androidx.core.view.isVisible
 import androidx.fragment.app.Fragment
@@ -48,6 +49,10 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         requireView().requireViewById(R.id.quick_availability_result_notes)
     }
 
+    private val skipCheckBox: CheckBox by lazy {
+        requireView().requireViewById(R.id.quick_availability_skip)
+    }
+
     override fun onCreateView(
         inflater: LayoutInflater,
         container: ViewGroup?,
@@ -57,6 +62,15 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
             .text = formatDeviceInformation()
         requireViewById<Button>(R.id.quick_availability_button_continue)
             .setOnClickListener { onContinueToApp() }
+        // Can't use the lazy field yet
+        requireViewById<CheckBox>(R.id.quick_availability_skip).setOnCheckedChangeListener { compoundButton, b ->
+            if (compoundButton.isVisible) {
+                runBlocking {
+                    preferenceRepository.skipQuickAvailabilityFlow
+                        .updatePreference(b)
+                }
+            }
+        }
     }
 
     override fun onStart() {
@@ -75,6 +89,7 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     private fun onCompatibilityUpdate(result: CompatibilityResult) {
         conclusion.text = formatConclusion(result)
         if (result.compatibility == Compatibility.COMPATIBLE) {
+            // Don't show the message again, ever, if the result is compatible
             runBlocking {
                 preferenceRepository.skipQuickAvailabilityFlow
                     .updatePreference(true)
@@ -88,6 +103,7 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         } else {
             resultNotes.isVisible = true
             resultNotes.text = getString(R.string.quick_compatibility_result_notes_incompatible)
+            skipCheckBox.isVisible = true
         }
     }
 
diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
index c1b206ac1..729f83738 100644
--- a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -38,6 +38,13 @@
         android:text="@string/quick_compatibility_result_notes"
         android:visibility="gone" />
 
+    <CheckBox
+        android:id="@+id/quick_availability_skip"
+        android:visibility="gone"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="@string/quick_compatibility_skip" />
+
     <Button
         android:id="@+id/quick_availability_button_continue"
         android:layout_width="match_parent"
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 8671ae741..269e40bc1 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -20,4 +20,5 @@
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
     <string name="quick_compatibility_result_notes_incompatible">Note: if you currently do not have any SIM card inserted, try the compatibility check again after inserting one. Any SIM card will do.</string>
     <string name="quick_compatibility_button_continue">Continue</string>
+    <string name="quick_compatibility_skip">Don\'t show this message again</string>
 </resources>
\ No newline at end of file

From 0b4d065d4b1fa4b5f836e5861e2c0514993a3cfc Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:54:09 -0400
Subject: [PATCH 424/458] Adjust layout margin

---
 app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
index 729f83738..10c8bd8a5 100644
--- a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -49,6 +49,7 @@
         android:id="@+id/quick_availability_button_continue"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
+        android:layout_marginTop="10dp"
         android:text="@string/quick_compatibility_button_continue" />
 
 </LinearLayout>
\ No newline at end of file

From 0506475a85f18be9bf6b33f7517273b55d6f154e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 10:56:33 -0400
Subject: [PATCH 425/458] More quick availability -> quick compatibility

---
 .../openeuicc/ui/QuickCompatibilityFragment.kt | 18 +++++++++---------
 .../openeuicc/ui/UnprivilegedMainActivity.kt   |  2 +-
 .../util/UnprivilegedPreferenceRepository.kt   |  4 ++--
 .../layout/fragment_quick_compatibility.xml    | 12 ++++++------
 4 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index c480a7857..1e9e5ad74 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -38,19 +38,19 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     }
 
     private val conclusion: TextView by lazy {
-        requireView().requireViewById(R.id.quick_availability_conclusion)
+        requireView().requireViewById(R.id.quick_compatibility_conclusion)
     }
 
     private val resultSlots: TextView by lazy {
-        requireView().requireViewById(R.id.quick_availability_result_slots)
+        requireView().requireViewById(R.id.quick_compatibility_result_slots)
     }
 
     private val resultNotes: TextView by lazy {
-        requireView().requireViewById(R.id.quick_availability_result_notes)
+        requireView().requireViewById(R.id.quick_compatibility_result_notes)
     }
 
     private val skipCheckBox: CheckBox by lazy {
-        requireView().requireViewById(R.id.quick_availability_skip)
+        requireView().requireViewById(R.id.quick_compatibility_skip)
     }
 
     override fun onCreateView(
@@ -58,15 +58,15 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         container: ViewGroup?,
         savedInstanceState: Bundle?
     ): View = inflater.inflate(R.layout.fragment_quick_compatibility, container, false).apply {
-        requireViewById<TextView>(R.id.quick_availability_device_information)
+        requireViewById<TextView>(R.id.quick_compatibility_device_information)
             .text = formatDeviceInformation()
-        requireViewById<Button>(R.id.quick_availability_button_continue)
+        requireViewById<Button>(R.id.quick_compatibility_button_continue)
             .setOnClickListener { onContinueToApp() }
         // Can't use the lazy field yet
-        requireViewById<CheckBox>(R.id.quick_availability_skip).setOnCheckedChangeListener { compoundButton, b ->
+        requireViewById<CheckBox>(R.id.quick_compatibility_skip).setOnCheckedChangeListener { compoundButton, b ->
             if (compoundButton.isVisible) {
                 runBlocking {
-                    preferenceRepository.skipQuickAvailabilityFlow
+                    preferenceRepository.skipQuickCompatibilityFlow
                         .updatePreference(b)
                 }
             }
@@ -91,7 +91,7 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         if (result.compatibility == Compatibility.COMPATIBLE) {
             // Don't show the message again, ever, if the result is compatible
             runBlocking {
-                preferenceRepository.skipQuickAvailabilityFlow
+                preferenceRepository.skipQuickCompatibilityFlow
                     .updatePreference(true)
             }
             resultSlots.isVisible = true
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
index da75d6f16..47bc904f1 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/UnprivilegedMainActivity.kt
@@ -12,7 +12,7 @@ import kotlinx.coroutines.runBlocking
 class UnprivilegedMainActivity : MainActivity(), UnprivilegedEuiccContextMarker {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
-        if (runBlocking { !preferenceRepository.skipQuickAvailabilityFlow.first() }) {
+        if (runBlocking { !preferenceRepository.skipQuickCompatibilityFlow.first() }) {
             startActivity(Intent(this, QuickCompatibilityActivity::class.java))
         }
     }
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
index 193a2fac5..606685850 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/util/UnprivilegedPreferenceRepository.kt
@@ -5,10 +5,10 @@ import androidx.datastore.preferences.core.booleanPreferencesKey
 
 internal object UnprivilegedPreferenceKeys {
     // ---- Miscellaneous ----
-    val SKIP_QUICK_AVAILABILITY = booleanPreferencesKey("skip_quick_availability")
+    val SKIP_QUICK_COMPATIBILITY = booleanPreferencesKey("skip_quick_compatibility")
 }
 
 class UnprivilegedPreferenceRepository(context: Context) : PreferenceRepository(context) {
     // ---- Miscellaneous ----
-    val skipQuickAvailabilityFlow = bindFlow(UnprivilegedPreferenceKeys.SKIP_QUICK_AVAILABILITY, false)
+    val skipQuickCompatibilityFlow = bindFlow(UnprivilegedPreferenceKeys.SKIP_QUICK_COMPATIBILITY, false)
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
index 10c8bd8a5..c248dad13 100644
--- a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -8,7 +8,7 @@
     android:textAlignment="center">
 
     <TextView
-        android:id="@+id/quick_availability_conclusion"
+        android:id="@+id/quick_compatibility_conclusion"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_marginBottom="16dp"
@@ -17,7 +17,7 @@
         android:textStyle="bold" />
 
     <TextView
-        android:id="@+id/quick_availability_device_information"
+        android:id="@+id/quick_compatibility_device_information"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:fontFamily="monospace"
@@ -25,28 +25,28 @@
         android:textAlignment="center" />
 
     <TextView
-        android:id="@+id/quick_availability_result_slots"
+        android:id="@+id/quick_compatibility_result_slots"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_marginBottom="16dp"
         android:visibility="gone" />
 
     <TextView
-        android:id="@+id/quick_availability_result_notes"
+        android:id="@+id/quick_compatibility_result_notes"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="@string/quick_compatibility_result_notes"
         android:visibility="gone" />
 
     <CheckBox
-        android:id="@+id/quick_availability_skip"
+        android:id="@+id/quick_compatibility_skip"
         android:visibility="gone"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:text="@string/quick_compatibility_skip" />
 
     <Button
-        android:id="@+id/quick_availability_button_continue"
+        android:id="@+id/quick_compatibility_button_continue"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:layout_marginTop="10dp"

From eb006b8f19d1eb9879431006a5c8511ab4c29a0e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 11:13:26 -0400
Subject: [PATCH 426/458] i18n: Update translations

---
 app-unpriv/src/main/res/values-ja/strings.xml     |  9 +++++++++
 app-unpriv/src/main/res/values-zh-rCN/strings.xml | 10 ++++++++++
 app-unpriv/src/main/res/values-zh-rTW/strings.xml | 10 ++++++++++
 3 files changed, 29 insertions(+)

diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index c9443dc03..33db2ff9b 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -6,4 +6,13 @@
     <!-- Toast -->
     <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
     <string name="toast_prompt_to_enable_sim_toolkit">「%s」アプリを有効化してください</string>
+    <string name="quick_compatibility">互換性のチェック</string>
+    <string name="quick_compatibility_compatible">お使いのスマートフォンは %s 対応 SIM カードを管理できます</string>
+    <string name="quick_compatibility_not_compatible">お使いのスマートフォンは %s と互換性がありません</string>
+    <string name="quick_compatibility_not_compatible_but_usb">お使いのスマートフォンは %s と完全な互換性がありません。ただし、USBスマートカードリーダーを使用する場合、ほぼすべての機能を利用できます。</string>
+    <string name="quick_compatibility_result_slots">アクセス可能な SIM カードスロット: %s</string>
+    <string name="quick_compatibility_result_notes">注: これらの結果は参考用です。以上に記載されていない SIM スロットでも、SIM カードを挿入すれば利用できる可能性があります。</string>
+    <string name="quick_compatibility_result_notes_incompatible">注：現在 SIM カードが挿入されていない場合は、SIM カードを挿入してから再度互換性チェックをお試しください。どの SIM カードでも構いません。</string>
+    <string name="quick_compatibility_button_continue">つづく</string>
+    <string name="quick_compatibility_skip">このメッセージを再度表示しない</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-zh-rCN/strings.xml b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
index 5666fbb61..16a423899 100644
--- a/app-unpriv/src/main/res/values-zh-rCN/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
@@ -2,4 +2,14 @@
     <string name="compatibility_check">兼容性检查</string>
     <string name="open_sim_toolkit">打开 SIM 卡应用程序</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已拷贝到剪贴板</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">请启用您的“％s”应用程序</string>
+    <string name="quick_compatibility">简易兼容性检测</string>
+    <string name="quick_compatibility_compatible">您的手机可以管理兼容 %s 的卡片</string>
+    <string name="quick_compatibility_not_compatible">您的手机与 %s 不兼容</string>
+    <string name="quick_compatibility_not_compatible_but_usb">您的手机与 %s 不完全兼容，但可以使用 USB 读卡器获得几乎全部功能</string>
+    <string name="quick_compatibility_result_slots">可读取的 SIM 卡槽: %s</string>
+    <string name="quick_compatibility_result_notes">注意：以上结果仅供参考。即使某些卡槽没有被列举出来，插卡后也可能可用。</string>
+    <string name="quick_compatibility_result_notes_incompatible">注意：如果您目前没有插卡，请插任意 SIM 卡后重试兼容性检测。</string>
+    <string name="quick_compatibility_button_continue">继续</string>
+    <string name="quick_compatibility_skip">不再显示此消息</string>
 </resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-zh-rTW/strings.xml b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
index dcded790c..ece29dfc3 100644
--- a/app-unpriv/src/main/res/values-zh-rTW/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
@@ -2,4 +2,14 @@
     <string name="compatibility_check">相容性檢查</string>
     <string name="open_sim_toolkit">啟動 SIM 卡應用程式</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已複製到剪貼簿</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">請啟用您的“％s”應用程式</string>
+    <string name="quick_compatibility">簡易相容性檢測</string>
+    <string name="quick_compatibility_compatible">您的手機可以管理相容 %s 的卡片</string>
+    <string name="quick_compatibility_not_compatible">您的手機與 %s 不相容</string>
+    <string name="quick_compatibility_not_compatible_but_usb">您的手機與 %s 不完全相容，但可以使用 USB 讀卡機獲得幾乎全部功能</string>
+    <string name="quick_compatibility_result_slots">可讀取的 SIM 卡槽: %s</string>
+    <string name="quick_compatibility_result_notes">注意：以上結果僅供參考。即使某些卡槽沒有被列舉出來，插卡後也可能可用。</string>
+    <string name="quick_compatibility_result_notes_incompatible">注意：如果您目前沒有插卡，請插任何 SIM 卡後重試相容性檢測。</string>
+    <string name="quick_compatibility_button_continue">繼續</string>
+    <string name="quick_compatibility_skip">不再顯示此訊息</string>
 </resources>
\ No newline at end of file

From 8c982ae8902c4c10932ad64d2e08eaeb84869a0c Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 11:14:46 -0400
Subject: [PATCH 427/458] More quick availability -> quick compatibility

---
 .../angry/openeuicc/di/UnprivilegedUiComponentFactory.kt   | 2 +-
 .../im/angry/openeuicc/ui/QuickCompatibilityActivity.kt    | 7 +++----
 .../src/main/res/layout/activity_quick_compatibility.xml   | 2 +-
 3 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
index 73f33d1b5..3eb09c09f 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/di/UnprivilegedUiComponentFactory.kt
@@ -17,6 +17,6 @@ open class UnprivilegedUiComponentFactory : DefaultUiComponentFactory() {
     override fun createSettingsFragment(): Fragment =
         UnprivilegedSettingsFragment()
 
-    open fun createQuickAvailabilityFragment(): Fragment =
+    open fun createQuickCompatibilityFragment(): Fragment =
         QuickCompatibilityFragment()
 }
\ No newline at end of file
diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
index d83903b40..d5e599fdf 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityActivity.kt
@@ -1,6 +1,5 @@
 package im.angry.openeuicc.ui
 
-import android.content.Intent
 import android.os.Bundle
 import androidx.activity.enableEdgeToEdge
 import androidx.appcompat.app.AppCompatActivity
@@ -14,12 +13,12 @@ class QuickCompatibilityActivity : AppCompatActivity(), OpenEuiccContextMarker {
         enableEdgeToEdge()
         setContentView(R.layout.activity_quick_compatibility)
 
-        val quickAvailabilityFragment =
+        val quickCompatibilityFragment =
             (appContainer.uiComponentFactory as UnprivilegedUiComponentFactory)
-                .createQuickAvailabilityFragment()
+                .createQuickCompatibilityFragment()
 
         supportFragmentManager.beginTransaction()
-            .replace(R.id.quick_availability_container, quickAvailabilityFragment)
+            .replace(R.id.quick_compatibility_container, quickCompatibilityFragment)
             .commit()
     }
 }
diff --git a/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml b/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
index 42f3896f4..ae691d59d 100644
--- a/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/activity_quick_compatibility.xml
@@ -5,7 +5,7 @@
     android:layout_height="match_parent">
 
     <FrameLayout
-        android:id="@+id/quick_availability_container"
+        android:id="@+id/quick_compatibility_container"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
         app:layout_constraintBottom_toBottomOf="parent"

From 29b2cba673f73e4a69d408b1ffb953cf3ce76f0d Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 13:47:39 -0400
Subject: [PATCH 428/458] Use OMAPI access instead of ISD-R access to determine
 compatibility

...but still show ISD-R check results
---
 .../ui/QuickCompatibilityFragment.kt          | 23 +++++++++++++++----
 .../layout/fragment_quick_compatibility.xml   |  7 ++++++
 app-unpriv/src/main/res/values/strings.xml    |  2 ++
 3 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index 1e9e5ad74..d30521a98 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -33,7 +33,8 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
 
         data class CompatibilityResult(
             val compatibility: Compatibility,
-            val slots: List<String> = emptyList()
+            val slotsOmapi: List<String> = emptyList(),
+            val slotsIsdr: List<String> = emptyList()
         )
     }
 
@@ -45,6 +46,10 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         requireView().requireViewById(R.id.quick_compatibility_result_slots)
     }
 
+    private val resultSlotsIsdr: TextView by lazy {
+        requireView().requireViewById(R.id.quick_compatibility_result_slots_isdr)
+    }
+
     private val resultNotes: TextView by lazy {
         requireView().requireViewById(R.id.quick_compatibility_result_notes)
     }
@@ -97,8 +102,17 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
             resultSlots.isVisible = true
             resultSlots.text = getString(
                 R.string.quick_compatibility_result_slots,
-                ListFormatter.getInstance().format(result.slots)
+                ListFormatter.getInstance().format(result.slotsOmapi)
             )
+            resultSlotsIsdr.isVisible = true
+            resultSlotsIsdr.text = if (result.slotsIsdr.isEmpty()) {
+                getString(R.string.quick_compatibility_unknown)
+            } else {
+                getString(
+                    R.string.quick_compatibility_result_slots_isdr,
+                    ListFormatter.getInstance().format(result.slotsIsdr)
+                )
+            }
             resultNotes.isVisible = true
         } else {
             resultNotes.isVisible = true
@@ -112,6 +126,7 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         if (!service.isConnected) {
             return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
         }
+        val omapiSlots = service.readers.filter { it.isSIM }.map { it.slotIndex }
         val slots = service.readers.filter { it.isSIM }.mapNotNull { reader ->
             try {
                 // Note: we ONLY check the default ISD-R AID, because this test is for the _device_,
@@ -128,10 +143,10 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
                 null
             }
         }
-        if (slots.isEmpty()) {
+        if (omapiSlots.isEmpty()) {
             return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
         }
-        return CompatibilityResult(Compatibility.COMPATIBLE, slots = slots.map { "SIM$it" })
+        return CompatibilityResult(Compatibility.COMPATIBLE, slotsOmapi = omapiSlots.map { "SIM$it" }, slotsIsdr = slots.map { "SIM$it" })
     }
 
     open fun formatConclusion(result: CompatibilityResult): String {
diff --git a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
index c248dad13..a4203a37e 100644
--- a/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
+++ b/app-unpriv/src/main/res/layout/fragment_quick_compatibility.xml
@@ -31,6 +31,13 @@
         android:layout_marginBottom="16dp"
         android:visibility="gone" />
 
+    <TextView
+        android:id="@+id/quick_compatibility_result_slots_isdr"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginBottom="16dp"
+        android:visibility="gone" />
+
     <TextView
         android:id="@+id/quick_compatibility_result_notes"
         android:layout_width="wrap_content"
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 269e40bc1..25f765fb0 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -17,8 +17,10 @@
     <string name="quick_compatibility_not_compatible">Your smartphone is not compatible with %s</string>
     <string name="quick_compatibility_not_compatible_but_usb">Your smartphone is not fully compatible with %s. However, you can still use a USB smart card reader for near-full functionality.</string>
     <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
+    <string name="quick_compatibility_result_slots_isdr">ISD-R access: %s</string>
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
     <string name="quick_compatibility_result_notes_incompatible">Note: if you currently do not have any SIM card inserted, try the compatibility check again after inserting one. Any SIM card will do.</string>
     <string name="quick_compatibility_button_continue">Continue</string>
     <string name="quick_compatibility_skip">Don\'t show this message again</string>
+    <string name="quick_compatibility_unknown">Unknown</string>
 </resources>
\ No newline at end of file

From 1fd13634fc87a047d46c33263db22884b9bc5f7e Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 20 Jul 2025 14:19:51 -0400
Subject: [PATCH 429/458] i18n: Update new strings

---
 app-unpriv/src/main/res/values-ja/strings.xml     | 4 +++-
 app-unpriv/src/main/res/values-zh-rCN/strings.xml | 4 +++-
 app-unpriv/src/main/res/values-zh-rTW/strings.xml | 4 +++-
 app-unpriv/src/main/res/values/strings.xml        | 2 +-
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index 33db2ff9b..f3ff41f18 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -10,9 +10,11 @@
     <string name="quick_compatibility_compatible">お使いのスマートフォンは %s 対応 SIM カードを管理できます</string>
     <string name="quick_compatibility_not_compatible">お使いのスマートフォンは %s と互換性がありません</string>
     <string name="quick_compatibility_not_compatible_but_usb">お使いのスマートフォンは %s と完全な互換性がありません。ただし、USBスマートカードリーダーを使用する場合、ほぼすべての機能を利用できます。</string>
-    <string name="quick_compatibility_result_slots">アクセス可能な SIM カードスロット: %s</string>
+    <string name="quick_compatibility_result_slots">アクセス可能なスロット: %s</string>
+    <string name="quick_compatibility_result_slots_isdr">ISD-R アクセス: %s</string>
     <string name="quick_compatibility_result_notes">注: これらの結果は参考用です。以上に記載されていない SIM スロットでも、SIM カードを挿入すれば利用できる可能性があります。</string>
     <string name="quick_compatibility_result_notes_incompatible">注：現在 SIM カードが挿入されていない場合は、SIM カードを挿入してから再度互換性チェックをお試しください。どの SIM カードでも構いません。</string>
     <string name="quick_compatibility_button_continue">つづく</string>
     <string name="quick_compatibility_skip">このメッセージを再度表示しない</string>
+    <string name="quick_compatibility_unknown">不明</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-zh-rCN/strings.xml b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
index 16a423899..c4cf78148 100644
--- a/app-unpriv/src/main/res/values-zh-rCN/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
@@ -7,9 +7,11 @@
     <string name="quick_compatibility_compatible">您的手机可以管理兼容 %s 的卡片</string>
     <string name="quick_compatibility_not_compatible">您的手机与 %s 不兼容</string>
     <string name="quick_compatibility_not_compatible_but_usb">您的手机与 %s 不完全兼容，但可以使用 USB 读卡器获得几乎全部功能</string>
-    <string name="quick_compatibility_result_slots">可读取的 SIM 卡槽: %s</string>
+    <string name="quick_compatibility_result_slots">可读取的卡槽: %s</string>
+    <string name="quick_compatibility_result_slots_isdr">ISD-R 访问: %s</string>
     <string name="quick_compatibility_result_notes">注意：以上结果仅供参考。即使某些卡槽没有被列举出来，插卡后也可能可用。</string>
     <string name="quick_compatibility_result_notes_incompatible">注意：如果您目前没有插卡，请插任意 SIM 卡后重试兼容性检测。</string>
     <string name="quick_compatibility_button_continue">继续</string>
     <string name="quick_compatibility_skip">不再显示此消息</string>
+    <string name="quick_compatibility_unknown">未知</string>
 </resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values-zh-rTW/strings.xml b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
index ece29dfc3..3270c934c 100644
--- a/app-unpriv/src/main/res/values-zh-rTW/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
@@ -7,9 +7,11 @@
     <string name="quick_compatibility_compatible">您的手機可以管理相容 %s 的卡片</string>
     <string name="quick_compatibility_not_compatible">您的手機與 %s 不相容</string>
     <string name="quick_compatibility_not_compatible_but_usb">您的手機與 %s 不完全相容，但可以使用 USB 讀卡機獲得幾乎全部功能</string>
-    <string name="quick_compatibility_result_slots">可讀取的 SIM 卡槽: %s</string>
+    <string name="quick_compatibility_result_slots">可讀取的卡槽: %s</string>
+    <string name="quick_compatibility_result_slots_isdr">ISD-R 訪問: %s</string>
     <string name="quick_compatibility_result_notes">注意：以上結果僅供參考。即使某些卡槽沒有被列舉出來，插卡後也可能可用。</string>
     <string name="quick_compatibility_result_notes_incompatible">注意：如果您目前沒有插卡，請插任何 SIM 卡後重試相容性檢測。</string>
     <string name="quick_compatibility_button_continue">繼續</string>
     <string name="quick_compatibility_skip">不再顯示此訊息</string>
+    <string name="quick_compatibility_unknown">未知</string>
 </resources>
\ No newline at end of file
diff --git a/app-unpriv/src/main/res/values/strings.xml b/app-unpriv/src/main/res/values/strings.xml
index 25f765fb0..76d1c76de 100644
--- a/app-unpriv/src/main/res/values/strings.xml
+++ b/app-unpriv/src/main/res/values/strings.xml
@@ -16,7 +16,7 @@
     <string name="quick_compatibility_compatible">Your smartphone can manage %s-compatible cards</string>
     <string name="quick_compatibility_not_compatible">Your smartphone is not compatible with %s</string>
     <string name="quick_compatibility_not_compatible_but_usb">Your smartphone is not fully compatible with %s. However, you can still use a USB smart card reader for near-full functionality.</string>
-    <string name="quick_compatibility_result_slots">SIM card slots accessible: %s</string>
+    <string name="quick_compatibility_result_slots">Accessible slots: %s</string>
     <string name="quick_compatibility_result_slots_isdr">ISD-R access: %s</string>
     <string name="quick_compatibility_result_notes">Note: these results are for reference only. Even if a SIM slot is not listed above, it <i>may</i> be compatible as well once a SIM card is inserted.</string>
     <string name="quick_compatibility_result_notes_incompatible">Note: if you currently do not have any SIM card inserted, try the compatibility check again after inserting one. Any SIM card will do.</string>

From dfdd8948c5d9bf33635d7a2a8e50d37a4c32a304 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 21 Jul 2025 07:36:25 -0400
Subject: [PATCH 430/458] i18n: Fix string formatting

---
 app-unpriv/src/main/res/values-zh-rCN/strings.xml | 2 +-
 app-unpriv/src/main/res/values-zh-rTW/strings.xml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/app-unpriv/src/main/res/values-zh-rCN/strings.xml b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
index c4cf78148..cd66a435b 100644
--- a/app-unpriv/src/main/res/values-zh-rCN/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rCN/strings.xml
@@ -2,7 +2,7 @@
     <string name="compatibility_check">兼容性检查</string>
     <string name="open_sim_toolkit">打开 SIM 卡应用程序</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已拷贝到剪贴板</string>
-    <string name="toast_prompt_to_enable_sim_toolkit">请启用您的“％s”应用程序</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">请启用您的“%s”应用程序</string>
     <string name="quick_compatibility">简易兼容性检测</string>
     <string name="quick_compatibility_compatible">您的手机可以管理兼容 %s 的卡片</string>
     <string name="quick_compatibility_not_compatible">您的手机与 %s 不兼容</string>
diff --git a/app-unpriv/src/main/res/values-zh-rTW/strings.xml b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
index 3270c934c..ab64d6bd0 100644
--- a/app-unpriv/src/main/res/values-zh-rTW/strings.xml
+++ b/app-unpriv/src/main/res/values-zh-rTW/strings.xml
@@ -2,7 +2,7 @@
     <string name="compatibility_check">相容性檢查</string>
     <string name="open_sim_toolkit">啟動 SIM 卡應用程式</string>
     <string name="toast_ara_m_copied">ARA-M SHA-1 已複製到剪貼簿</string>
-    <string name="toast_prompt_to_enable_sim_toolkit">請啟用您的“％s”應用程式</string>
+    <string name="toast_prompt_to_enable_sim_toolkit">請啟用您的“%s”應用程式</string>
     <string name="quick_compatibility">簡易相容性檢測</string>
     <string name="quick_compatibility_compatible">您的手機可以管理相容 %s 的卡片</string>
     <string name="quick_compatibility_not_compatible">您的手機與 %s 不相容</string>

From c0cd7a25cf036d349594fe670fba3be0afa9ded6 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 21 Jul 2025 07:37:45 -0400
Subject: [PATCH 431/458] Fix text for ISD-R compatibility check

---
 .../openeuicc/ui/QuickCompatibilityFragment.kt   | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index d30521a98..f6af78d2c 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -105,14 +105,15 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
                 ListFormatter.getInstance().format(result.slotsOmapi)
             )
             resultSlotsIsdr.isVisible = true
-            resultSlotsIsdr.text = if (result.slotsIsdr.isEmpty()) {
-                getString(R.string.quick_compatibility_unknown)
-            } else {
+            resultSlotsIsdr.text =
                 getString(
                     R.string.quick_compatibility_result_slots_isdr,
-                    ListFormatter.getInstance().format(result.slotsIsdr)
+                    if (result.slotsIsdr.isEmpty()) {
+                        getString(R.string.quick_compatibility_unknown)
+                    } else {
+                        ListFormatter.getInstance().format(result.slotsIsdr)
+                    }
                 )
-            }
             resultNotes.isVisible = true
         } else {
             resultNotes.isVisible = true
@@ -146,7 +147,10 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         if (omapiSlots.isEmpty()) {
             return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
         }
-        return CompatibilityResult(Compatibility.COMPATIBLE, slotsOmapi = omapiSlots.map { "SIM$it" }, slotsIsdr = slots.map { "SIM$it" })
+        return CompatibilityResult(
+            Compatibility.COMPATIBLE,
+            slotsOmapi = omapiSlots.map { "SIM$it" },
+            slotsIsdr = slots.map { "SIM$it" })
     }
 
     open fun formatConclusion(result: CompatibilityResult): String {

From 1be6c25cb6f05a75028abaad8e2731a944fcf85a Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 23 Jul 2025 13:33:05 +0200
Subject: [PATCH 432/458] fix: lpac submodule (#206)

```
Fetching submodule libs/lpac-jni/src/main/jni/lpac
remote: Repository not found.
fatal: repository 'https://github.com/estkme/lpac/' not found
Errors during submodule fetch:
	libs/lpac-jni/src/main/jni/lpac
```

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/206
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .gitmodules | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitmodules b/.gitmodules
index f888959b8..863f18504 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,3 @@
 [submodule "libs/lpac-jni/src/main/jni/lpac"]
 	path = libs/lpac-jni/src/main/jni/lpac
-	url = https://github.com/estkme/lpac
+	url = https://github.com/estkme-group/lpac.git

From 797f3dc722d13d76ae94c0f910eed61ad92d738a Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 23 Jul 2025 13:33:36 +0200
Subject: [PATCH 433/458] chore: unified profile string ids style (#205)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/205
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../di/DefaultCustomizableTextProvider.kt     |  2 +-
 .../openeuicc/ui/EuiccManagementFragment.kt   |  6 +++---
 .../openeuicc/ui/ProfileRenameFragment.kt     |  2 +-
 .../src/main/res/layout/euicc_profile.xml     |  4 ++--
 .../main/res/menu/fragment_profile_rename.xml |  2 +-
 .../src/main/res/menu/profile_options.xml     |  8 +++----
 app-common/src/main/res/values-ja/strings.xml | 18 ++++++++--------
 .../src/main/res/values-zh-rCN/strings.xml    | 18 ++++++++--------
 .../src/main/res/values-zh-rTW/strings.xml    | 18 ++++++++--------
 app-common/src/main/res/values/strings.xml    | 21 ++++++++++---------
 10 files changed, 50 insertions(+), 49 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
index b49361123..76227fd3b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/di/DefaultCustomizableTextProvider.kt
@@ -8,7 +8,7 @@ open class DefaultCustomizableTextProvider(private val context: Context) : Custo
         get() = context.getString(R.string.no_euicc)
 
     override val profileSwitchingTimeoutMessage: String
-        get() = context.getString(R.string.enable_disable_timeout)
+        get() = context.getString(R.string.profile_switch_timeout)
 
     override fun formatInternalChannelName(logicalSlotId: Int): String =
         context.getString(R.string.channel_name_format, logicalSlotId)
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
index 3c94c6cda..016e96f8b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccManagementFragment.kt
@@ -253,7 +253,7 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
                     if (!isUsb) {
                         withContext(Dispatchers.Main) {
                             AlertDialog.Builder(requireContext()).apply {
-                                setMessage(R.string.switch_did_not_refresh)
+                                setMessage(R.string.profile_switch_did_not_refresh)
                                 setPositiveButton(android.R.string.ok) { dialog, _ ->
                                     dialog.dismiss()
                                     requireActivity().finish()
@@ -380,9 +380,9 @@ open class EuiccManagementFragment : Fragment(), EuiccProfilesChangedListener,
 
             state.setText(
                 if (profile.isEnabled) {
-                    R.string.enabled
+                    R.string.profile_state_enabled
                 } else {
-                    R.string.disabled
+                    R.string.profile_state_disabled
                 }
             )
             provider.text = profile.providerName
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
index c588254c1..281e62538 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/ProfileRenameFragment.kt
@@ -65,7 +65,7 @@ class ProfileRenameFragment : BaseMaterialDialogFragment(), EuiccChannelFragment
         super.onViewCreated(view, savedInstanceState)
         profileRenameNewName.editText!!.setText(currentName)
         toolbar.apply {
-            setTitle(R.string.rename)
+            setTitle(R.string.profile_rename)
             setNavigationOnClickListener {
                 if (!renaming) dismiss()
             }
diff --git a/app-common/src/main/res/layout/euicc_profile.xml b/app-common/src/main/res/layout/euicc_profile.xml
index 74c1d7a0c..021c53bd0 100644
--- a/app-common/src/main/res/layout/euicc_profile.xml
+++ b/app-common/src/main/res/layout/euicc_profile.xml
@@ -54,7 +54,7 @@
 
             <TextView
                 android:id="@+id/provider_label"
-                android:text="@string/provider"
+                android:text="@string/profile_provider"
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:layout_marginTop="6dp"
@@ -106,7 +106,7 @@
 
             <TextView
                 android:id="@+id/iccid_label"
-                android:text="@string/iccid"
+                android:text="@string/profile_iccid"
                 android:layout_width="wrap_content"
                 android:layout_height="wrap_content"
                 android:layout_marginTop="6dp"
diff --git a/app-common/src/main/res/menu/fragment_profile_rename.xml b/app-common/src/main/res/menu/fragment_profile_rename.xml
index bde850f1f..f55c56c0d 100644
--- a/app-common/src/main/res/menu/fragment_profile_rename.xml
+++ b/app-common/src/main/res/menu/fragment_profile_rename.xml
@@ -4,6 +4,6 @@
     <item
         android:id="@+id/ok"
         android:icon="@drawable/ic_check_black"
-        android:title="@string/rename"
+        android:title="@string/profile_rename"
         app:showAsAction="ifRoom"/>
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/profile_options.xml b/app-common/src/main/res/menu/profile_options.xml
index 6add53d5f..60722d61d 100644
--- a/app-common/src/main/res/menu/profile_options.xml
+++ b/app-common/src/main/res/menu/profile_options.xml
@@ -2,18 +2,18 @@
 <menu xmlns:android="http://schemas.android.com/apk/res/android">
     <item
         android:id="@+id/enable"
-        android:title="@string/enable"/>
+        android:title="@string/profile_enable"/>
 
     <item
         android:id="@+id/disable"
         android:visible="false"
-        android:title="@string/disable"/>
+        android:title="@string/profile_disable"/>
 
     <item
         android:id="@+id/rename"
-        android:title="@string/rename"/>
+        android:title="@string/profile_rename"/>
 
     <item
         android:id="@+id/delete"
-        android:title="@string/delete"/>
+        android:title="@string/profile_delete"/>
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index d51e2c79d..e631d520d 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -7,19 +7,19 @@
     <string name="help">ヘルプ</string>
     <string name="reload">スロットを再読み込み</string>
     <string name="channel_name_format">論理スロット %d</string>
-    <string name="enabled">有効済み</string>
-    <string name="disabled">無効済み</string>
-    <string name="provider">プロバイダー:</string>
+    <string name="profile_state_enabled">有効済み</string>
+    <string name="profile_state_disabled">無効済み</string>
+    <string name="profile_provider">プロバイダー:</string>
     <string name="profile_class">クラス:</string>
     <string name="profile_class_testing">テスト中</string>
     <string name="profile_class_provisioning">プロビジョニング</string>
     <string name="profile_class_operational">稼働中</string>
-    <string name="enable">有効化</string>
-    <string name="disable">無効化</string>
-    <string name="delete">削除</string>
-    <string name="rename">名前を変更</string>
-    <string name="enable_disable_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
-    <string name="switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
+    <string name="profile_enable">有効化</string>
+    <string name="profile_disable">無効化</string>
+    <string name="profile_delete">削除</string>
+    <string name="profile_rename">名前を変更</string>
+    <string name="profile_switch_timeout">eSIM チップがプロファイルの切り替えの待機中にタイムアウトしました。これはデバイスのモデムファームウェアのバグの可能性があります。機内モードに切り替えるかアプリを再起動、デバイスを再起動してください。</string>
+    <string name="profile_switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
     <string name="toast_profile_delete_confirm_text_mismatched">確認文字列が一致しません</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 32ced907c..b0938d3e4 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -6,16 +6,16 @@
     <string name="help">帮助</string>
     <string name="reload">重新加载卡槽</string>
     <string name="channel_name_format">逻辑卡槽 %d</string>
-    <string name="enabled">已启用</string>
-    <string name="disabled">已禁用</string>
-    <string name="provider">提供商:</string>
+    <string name="profile_state_enabled">已启用</string>
+    <string name="profile_state_disabled">已禁用</string>
+    <string name="profile_provider">提供商:</string>
     <string name="profile_class">类型:</string>
-    <string name="enable">启用</string>
-    <string name="disable">禁用</string>
-    <string name="delete">删除</string>
-    <string name="rename">重命名</string>
-    <string name="enable_disable_timeout">等待 eSIM 芯片切换配置文件时超时。这可能是您手机基带固件中的一个错误。请尝试切换飞行模式、重新启动应用程序或重新启动手机</string>
-    <string name="switch_did_not_refresh">操作成功, 但是您手机的基带拒绝刷新。您可能需要切换飞行模式或重新启动，以便使用新的配置文件。</string>
+    <string name="profile_enable">启用</string>
+    <string name="profile_disable">禁用</string>
+    <string name="profile_delete">删除</string>
+    <string name="profile_rename">重命名</string>
+    <string name="profile_switch_timeout">等待 eSIM 芯片切换配置文件时超时。这可能是您手机基带固件中的一个错误。请尝试切换飞行模式、重新启动应用程序或重新启动手机</string>
+    <string name="profile_switch_did_not_refresh">操作成功, 但是您手机的基带拒绝刷新。您可能需要切换飞行模式或重新启动，以便使用新的配置文件。</string>
     <string name="toast_profile_enable_failed">无法切换到新的 eSIM 配置文件。</string>
     <string name="toast_profile_delete_confirm_text_mismatched">输入的确认文本不匹配</string>
     <string name="toast_iccid_copied">已复制 ICCID 到剪贴板</string>
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 5136bf739..e0334c628 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -6,16 +6,16 @@
     <string name="help">幫助</string>
     <string name="reload">重新載入卡槽</string>
     <string name="channel_name_format">虛擬卡槽 %d</string>
-    <string name="enabled">已啟用</string>
-    <string name="disabled">已停用</string>
-    <string name="provider">電信業者:</string>
+    <string name="profile_state_enabled">已啟用</string>
+    <string name="profile_state_disabled">已停用</string>
+    <string name="profile_provider">電信業者:</string>
     <string name="profile_class">類型:</string>
-    <string name="enable">啟用</string>
-    <string name="disable">停用</string>
-    <string name="delete">刪除</string>
-    <string name="rename">重新命名</string>
-    <string name="enable_disable_timeout">等待 eSIM 切換設定檔時逾時。這可能是您手機基頻處理器韌體中的一個錯誤。請嘗試切換飛航模式、重新啟動應用程式或重新啟動手機</string>
-    <string name="switch_did_not_refresh">操作成功, 但是您手機的基頻處理器沒有重新整理。您可能需要切換飛航模式或重新啟動，以便使用新的設定檔。</string>
+    <string name="profile_enable">啟用</string>
+    <string name="profile_disable">停用</string>
+    <string name="profile_delete">刪除</string>
+    <string name="profile_rename">重新命名</string>
+    <string name="profile_switch_timeout">等待 eSIM 切換設定檔時逾時。這可能是您手機基頻處理器韌體中的一個錯誤。請嘗試切換飛航模式、重新啟動應用程式或重新啟動手機</string>
+    <string name="profile_switch_did_not_refresh">操作成功, 但是您手機的基頻處理器沒有重新整理。您可能需要切換飛航模式或重新啟動，以便使用新的設定檔。</string>
     <string name="toast_profile_enable_failed">無法切換到新的 eSIM 設定檔。</string>
     <string name="toast_profile_delete_confirm_text_mismatched">輸入的確認文字不匹配</string>
     <string name="toast_iccid_copied">已複製 ICCID 到剪貼簿</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 38bb97662..d52623887 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -11,23 +11,24 @@
     <string name="usb" translatable="false">USB</string>
     <string name="omapi" translatable="false">OpenMobile API (OMAPI)</string>
 
-    <string name="enabled">Enabled</string>
-    <string name="disabled">Disabled</string>
-    <string name="provider">Provider:</string>
+    <!-- Profile -->
+    <string name="profile_state_enabled">Enabled</string>
+    <string name="profile_state_disabled">Disabled</string>
+    <string name="profile_provider">Provider:</string>
     <string name="profile_class">Class:</string>
     <string name="profile_class_testing">Testing</string>
     <string name="profile_class_provisioning">Provisioning</string>
     <string name="profile_class_operational">Operational</string>
-    <string name="iccid" translatable="false">ICCID:</string>
+    <string name="profile_iccid" translatable="false">ICCID:</string>
     <string name="profile_sequence_number_format" translatable="false">#%d</string>
 
-    <string name="enable">Enable</string>
-    <string name="disable">Disable</string>
-    <string name="delete">Delete</string>
-    <string name="rename">Rename</string>
+    <string name="profile_enable">Enable</string>
+    <string name="profile_disable">Disable</string>
+    <string name="profile_delete">Delete</string>
+    <string name="profile_rename">Rename</string>
 
-    <string name="enable_disable_timeout">Timed out waiting for the eSIM chip to switch profiles. This may be a bug in your phone\'s modem firmware. Try toggling airplane mode, restarting the application, or rebooting the phone.</string>
-    <string name="switch_did_not_refresh">The operation was successful, but your phone\'s modem refused to refresh. You might need to toggle airplane mode or reboot in order to use the new profile.</string>
+    <string name="profile_switch_timeout">Timed out waiting for the eSIM chip to switch profiles. This may be a bug in your phone\'s modem firmware. Try toggling airplane mode, restarting the application, or rebooting the phone.</string>
+    <string name="profile_switch_did_not_refresh">The operation was successful, but your phone\'s modem refused to refresh. You might need to toggle airplane mode or reboot in order to use the new profile.</string>
 
     <string name="toast_profile_enable_failed">Cannot switch to new eSIM profile.</string>
     <string name="toast_profile_delete_confirm_text_mismatched">Confirmation string mismatch</string>

From e604f39e0d194c7b3f2c86e950eb6c46281bd1c0 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Wed, 23 Jul 2025 13:34:04 +0200
Subject: [PATCH 434/458] fix: use customizableTextProvider in
 getCompatibilityCheckResult (#203)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/203
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../openeuicc/ui/QuickCompatibilityFragment.kt  | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
index f6af78d2c..9b4173062 100644
--- a/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
+++ b/app-unpriv/src/main/java/im/angry/openeuicc/ui/QuickCompatibilityFragment.kt
@@ -127,8 +127,9 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         if (!service.isConnected) {
             return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
         }
-        val omapiSlots = service.readers.filter { it.isSIM }.map { it.slotIndex }
-        val slots = service.readers.filter { it.isSIM }.mapNotNull { reader ->
+        val readers = service.readers.filter(Reader::isSIM)
+        val omapiSlots = readers.mapNotNull(Reader::slotIndex)
+        val slots = readers.mapNotNull { reader ->
             try {
                 // Note: we ONLY check the default ISD-R AID, because this test is for the _device_,
                 // NOT the eUICC. We don't care what AID a potential eUICC might use, all we need to
@@ -147,10 +148,12 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
         if (omapiSlots.isEmpty()) {
             return CompatibilityResult(Compatibility.NOT_COMPATIBLE)
         }
+        val formatChannelName = appContainer.customizableTextProvider::formatInternalChannelName
         return CompatibilityResult(
             Compatibility.COMPATIBLE,
-            slotsOmapi = omapiSlots.map { "SIM$it" },
-            slotsIsdr = slots.map { "SIM$it" })
+            slotsOmapi = omapiSlots.map(formatChannelName),
+            slotsIsdr = slots.map(formatChannelName),
+        )
     }
 
     open fun formatConclusion(result: CompatibilityResult): String {
@@ -176,8 +179,8 @@ open class QuickCompatibilityFragment : Fragment(), UnprivilegedEuiccContextMark
     }
 }
 
-val Reader.isSIM: Boolean
+private inline val Reader.isSIM: Boolean
     get() = name.startsWith("SIM")
 
-val Reader.slotIndex: Int
-    get() = (name.replace("SIM", "").toIntOrNull() ?: 1)
\ No newline at end of file
+private inline val Reader.slotIndex: Int
+    get() = (name.replace("SIM", "").toIntOrNull() ?: 1) - 1 // 0-based index
\ No newline at end of file

From 7c2157daa432a2d15542e91ef3d72d19f8007ea3 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 28 Jul 2025 02:35:56 +0200
Subject: [PATCH 435/458] chore: cleanup short string ids (#207)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/207
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../core/DefaultEuiccChannelFactory.kt        |  4 +--
 .../angry/openeuicc/ui/EuiccInfoActivity.kt   | 12 ++++-----
 .../im/angry/openeuicc/ui/MainActivity.kt     |  2 +-
 .../openeuicc/ui/NotificationsActivity.kt     |  2 +-
 .../DownloadWizardSlotSelectFragment.kt       |  5 ++--
 .../java/im/angry/openeuicc/util/UiUtils.kt   |  4 +--
 .../main/res/menu/activity_isdr_aid_list.xml  |  2 +-
 .../src/main/res/menu/activity_main.xml       |  2 +-
 .../main/res/menu/activity_notifications.xml  |  2 +-
 app-common/src/main/res/values-ja/strings.xml | 16 ++++++------
 .../src/main/res/values-zh-rCN/strings.xml    | 16 ++++++------
 .../src/main/res/values-zh-rTW/strings.xml    | 16 ++++++------
 app-common/src/main/res/values/strings.xml    | 25 +++++++++++--------
 .../core/PrivilegedEuiccChannelFactory.kt     |  3 +--
 app/src/main/res/values-ja/strings.xml        |  2 +-
 app/src/main/res/values-zh-rCN/strings.xml    |  2 +-
 app/src/main/res/values-zh-rTW/strings.xml    |  2 +-
 app/src/main/res/values/strings.xml           |  2 +-
 18 files changed, 60 insertions(+), 59 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 0de99b563..87a0eea26 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -37,7 +37,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
         )
         try {
             return EuiccChannelImpl(
-                context.getString(R.string.omapi),
+                context.getString(R.string.channel_type_omapi),
                 port,
                 intrinsicChannelName = null,
                 OmapiApduInterface(
@@ -69,7 +69,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
     ): EuiccChannel? {
         try {
             return EuiccChannelImpl(
-                context.getString(R.string.usb),
+                context.getString(R.string.channel_type_usb),
                 FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
                 intrinsicChannelName = ccidCtx.productName,
                 UsbApduInterface(
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index 4a34edd56..bfbcbd872 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -36,7 +36,7 @@ private val RE_SAS = Regex(
 
 class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
     companion object {
-        private val YES_NO = Pair(R.string.yes, R.string.no)
+        private val YES_NO = Pair(R.string.euicc_info_yes, R.string.euicc_info_no)
     }
 
     private lateinit var swipeRefresh: SwipeRefreshLayout
@@ -69,7 +69,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         logicalSlotId = intent.getIntExtra("logicalSlotId", 0)
 
         val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-            getString(R.string.usb)
+            getString(R.string.channel_type_usb)
         } else {
             appContainer.customizableTextProvider.formatInternalChannelName(logicalSlotId)
         }
@@ -119,7 +119,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         channel.lpa.euiccInfo2?.let { info ->
             add(Item(R.string.euicc_info_sgp22_version, info.sgp22Version.toString()))
             add(Item(R.string.euicc_info_firmware_version, info.euiccFirmwareVersion.toString()))
-            add(Item(R.string.euicc_info_globalplatform_version, info.globalPlatformVersion.toString()))
+            add(Item(R.string.euicc_info_gp_version, info.globalPlatformVersion.toString()))
             add(Item(R.string.euicc_info_pp_version, info.ppVersion.toString()))
             info.sasAccreditationNumber.trim().takeIf(RE_SAS::matches)
                 ?.let { add(Item(R.string.euicc_info_sas_accreditation_number, it.uppercase())) }
@@ -131,14 +131,14 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             // FS.27 v2.0, Security Guidelines for UICC Profiles (Page 25 of 27, 2024-01-30)
             // https://www.gsma.com/solutions-and-impact/technologies/security/wp-content/uploads/2024/01/FS.27-Security-Guidelines-for-UICC-Credentials-v2.0-FINAL-23-July.pdf#page=25
             val resId = when {
-                signers.isEmpty() -> R.string.unknown // the case is not mp, but it's is not common
+                signers.isEmpty() -> R.string.euicc_info_unknown // the case is not mp, but it's is not common
                 PKID_GSMA_LIVE_CI.any(signers::contains) -> R.string.euicc_info_ci_gsma_live
                 PKID_GSMA_TEST_CI.any(signers::contains) -> R.string.euicc_info_ci_gsma_test
                 else -> R.string.euicc_info_ci_unknown
             }
             add(Item(R.string.euicc_info_ci_type, getString(resId)))
         }
-        val atr = channel.atr?.encodeHex() ?: getString(R.string.information_unavailable)
+        val atr = channel.atr?.encodeHex() ?: getString(R.string.euicc_info_unavailable)
         add(Item(R.string.euicc_info_atr, atr, copiedToastResId = R.string.toast_atr_copied))
     }
 
@@ -171,7 +171,7 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         fun bind(item: Item) {
             copiedToastResId = item.copiedToastResId
             title.setText(item.titleResId)
-            content.text = item.content ?: getString(R.string.unknown)
+            content.text = item.content ?: getString(R.string.euicc_info_unknown)
         }
     }
 
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
index 01d0ab2b9..b42f4cf19 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/MainActivity.kt
@@ -174,7 +174,7 @@ open class MainActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         // If USB readers exist, add them at the very last
         // We use a wrapper fragment to handle logic specific to USB readers
         usbDevice?.let {
-            val productName = it.productName ?: getString(R.string.usb)
+            val productName = it.productName ?: getString(R.string.channel_type_usb)
             newPages.add(Page(EuiccChannelManager.USB_CHANNEL_ID, productName) {
                 UsbCcidReaderFragment()
             })
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
index 21a2d4056..07d5f1329 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/NotificationsActivity.kt
@@ -60,7 +60,7 @@ class NotificationsActivity: BaseEuiccAccessActivity(), OpenEuiccContextMarker {
         // This is slightly different from the MainActivity logic
         // due to the length (we don't want to display the full USB product name)
         val channelTitle = if (logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-            getString(R.string.usb)
+            getString(R.string.channel_type_usb)
         } else {
             appContainer.customizableTextProvider.formatInternalChannelName(logicalSlotId)
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
index 28bc9f00e..8097058d3 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardSlotSelectFragment.kt
@@ -19,7 +19,6 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.map
 import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.launch
-import net.typeblog.lpac_jni.LocalProfileInfo
 
 class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardStepFragment() {
     companion object {
@@ -187,12 +186,12 @@ class DownloadWizardSlotSelectFragment : DownloadWizardActivity.DownloadWizardSt
             }
 
             title.text = if (item.logicalSlotId == EuiccChannelManager.USB_CHANNEL_ID) {
-                item.intrinsicChannelName ?: root.context.getString(R.string.usb)
+                item.intrinsicChannelName ?: root.context.getString(R.string.channel_type_usb)
             } else {
                 appContainer.customizableTextProvider.formatInternalChannelName(item.logicalSlotId)
             }
             eID.text = item.eID
-            activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.unknown)
+            activeProfile.text = item.enabledProfileName ?: root.context.getString(R.string.profile_no_enabled_profile)
             freeSpace.text = formatFreeSpace(item.freeSpace)
             checkBox.isChecked = adapter.currentSelectedIdx == idx
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
index a73d7fe05..c7c859d9f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/UiUtils.kt
@@ -102,8 +102,8 @@ fun <T : ActivityResultCaller> T.setupLogSaving(
 
             AlertDialog.Builder(context).apply {
                 setMessage(R.string.logs_saved_message)
-                setNegativeButton(R.string.no) { _, _ -> }
-                setPositiveButton(R.string.yes) { _, _ ->
+                setNegativeButton(android.R.string.cancel) { _, _ -> }
+                setPositiveButton(android.R.string.ok) { _, _ ->
                     val intent = Intent(Intent.ACTION_SEND).apply {
                         type = "text/plain"
                         clipData = ClipData.newUri(context.contentResolver, lastFileName, uri)
diff --git a/app-common/src/main/res/menu/activity_isdr_aid_list.xml b/app-common/src/main/res/menu/activity_isdr_aid_list.xml
index 32f178a99..99492d64b 100644
--- a/app-common/src/main/res/menu/activity_isdr_aid_list.xml
+++ b/app-common/src/main/res/menu/activity_isdr_aid_list.xml
@@ -9,7 +9,7 @@
 
     <item
         android:id="@+id/reset"
-        android:title="@string/reset"
+        android:title="@string/isdr_aid_list_restore_defaults"
         android:icon="@drawable/ic_refresh_black"
         app:showAsAction="ifRoom" />
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/menu/activity_main.xml b/app-common/src/main/res/menu/activity_main.xml
index 0e0029286..c15663f89 100644
--- a/app-common/src/main/res/menu/activity_main.xml
+++ b/app-common/src/main/res/menu/activity_main.xml
@@ -3,7 +3,7 @@
     xmlns:app="http://schemas.android.com/apk/res-auto">
     <item
         android:id="@+id/reload"
-        android:title="@string/reload"
+        android:title="@string/profile_reload_slots"
         android:icon="@drawable/ic_refresh_black"
         app:showAsAction="ifRoom" />
 
diff --git a/app-common/src/main/res/menu/activity_notifications.xml b/app-common/src/main/res/menu/activity_notifications.xml
index 87f96a66a..b80e06e77 100644
--- a/app-common/src/main/res/menu/activity_notifications.xml
+++ b/app-common/src/main/res/menu/activity_notifications.xml
@@ -4,6 +4,6 @@
     <item
         android:id="@+id/help"
         android:icon="@drawable/ic_help_black"
-        android:title="@string/help"
+        android:title="@string/notification_help"
         app:showAsAction="always" />
 </menu>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index e631d520d..946625fa5 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -2,10 +2,10 @@
 <resources>
     <string name="no_euicc">このアプリでアクセスできるリムーバブル eUICC カードがデバイス上で検出されていません。互換性のあるカード挿入または USB リーダーを接続してください。</string>
     <string name="no_profile">この eSIM にはプロファイルがありません。</string>
-    <string name="unknown">不明</string>
-    <string name="information_unavailable">情報がありません</string>
-    <string name="help">ヘルプ</string>
-    <string name="reload">スロットを再読み込み</string>
+    <string name="euicc_info_unknown">不明</string>
+    <string name="euicc_info_unavailable">情報がありません</string>
+    <string name="notification_help">ヘルプ</string>
+    <string name="profile_reload_slots">スロットを再読み込み</string>
     <string name="channel_name_format">論理スロット %d</string>
     <string name="profile_state_enabled">有効済み</string>
     <string name="profile_state_disabled">無効済み</string>
@@ -110,7 +110,7 @@
     <string name="euicc_info_fw_ver">製品ファームウェアバージョン</string>
     <string name="euicc_info_sgp22_version">SGP.22 バージョン</string>
     <string name="euicc_info_firmware_version">eUICC OS バージョン</string>
-    <string name="euicc_info_globalplatform_version">グローバルプラットフォームのバージョン</string>
+    <string name="euicc_info_gp_version">グローバルプラットフォームのバージョン</string>
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
     <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
@@ -118,8 +118,8 @@
     <string name="euicc_info_ci_gsma_live">GSMA ライブ CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA テスト CI</string>
     <string name="euicc_info_ci_unknown">不明な eSIM CI</string>
-    <string name="yes">はい</string>
-    <string name="no">いいえ</string>
+    <string name="euicc_info_yes">はい</string>
+    <string name="euicc_info_no">いいえ</string>
     <string name="logs_save">保存</string>
     <string name="logs_filename_template">%s のログ</string>
     <string name="developer_options_steps">開発者になるまであと %d ステップです。</string>
@@ -167,6 +167,6 @@
     <string name="pref_developer_euicc_memory_reset_desc">この操作は、デフォルトでは非表示になっている危険な操作です。代わりに、すべての構成ファイルを手動で削除することもできます。</string>
     <string name="pref_developer_refresh_after_switch">モデムに更新コマンドを送信</string>
     <string name="pref_developer_isdr_aid_list">ISD-R AID リストのカスタマイズ</string>
-    <string name="reset">リセット</string>
+    <string name="isdr_aid_list_restore_defaults">リセット</string>
     <string name="isdr_aid_list">ISD-R AID リスト</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index b0938d3e4..e947c6a89 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -2,9 +2,9 @@
 <resources>
     <string name="no_euicc">在此设备上未检测到此应用程序可访问的可插拔 eUICC 卡。请插入兼容卡或 USB 读卡器。</string>
     <string name="no_profile">此 eSIM 上还没有配置文件</string>
-    <string name="unknown">未知</string>
-    <string name="help">帮助</string>
-    <string name="reload">重新加载卡槽</string>
+    <string name="euicc_info_unknown">未知</string>
+    <string name="notification_help">帮助</string>
+    <string name="profile_reload_slots">重新加载卡槽</string>
     <string name="channel_name_format">逻辑卡槽 %d</string>
     <string name="profile_state_enabled">已启用</string>
     <string name="profile_state_disabled">已禁用</string>
@@ -132,7 +132,7 @@
     <string name="euicc_info_removable">可插拔</string>
     <string name="euicc_info_sgp22_version">SGP.22 版本</string>
     <string name="euicc_info_firmware_version">eUICC OS 版本</string>
-    <string name="euicc_info_globalplatform_version">GlobalPlatform 版本</string>
+    <string name="euicc_info_gp_version">GlobalPlatform 版本</string>
     <string name="euicc_info_sas_accreditation_number">SAS 认证号码</string>
     <string name="euicc_info_pp_version">Protected Profile 版本</string>
     <string name="euicc_info_free_nvram">NVRAM 剩余空间 (eSIM 存储容量)</string>
@@ -140,8 +140,8 @@
     <string name="euicc_info_ci_gsma_live">GSMA 生产环境 CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA 测试 CI</string>
     <string name="euicc_info_ci_unknown">未知 eSIM CI</string>
-    <string name="yes">是</string>
-    <string name="no">否</string>
+    <string name="euicc_info_yes">是</string>
+    <string name="euicc_info_no">否</string>
     <string name="developer_options_steps">还有 %d 步成为开发者</string>
     <string name="developer_options_enabled">你现在是开发者了！</string>
     <string name="pref_advanced_language">语言</string>
@@ -152,7 +152,7 @@
     <string name="pref_developer_unfiltered_profile_list_desc">在配置文件列表中包括非生产环境的配置文件</string>
     <string name="pref_developer_ignore_tls_certificate">无视 SM-DP+ 的 TLS 证书</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允许 RSP 服务器使用任意证书</string>
-    <string name="information_unavailable">无信息</string>
+    <string name="euicc_info_unavailable">无信息</string>
     <string name="toast_euicc_memory_reset_confirm_text_mismatched">输入的确认文本不匹配</string>
     <string name="toast_euicc_memory_reset_finitshed">此芯片已被擦除</string>
     <string name="task_euicc_memory_reset">正在擦除 eSIM 芯片</string>
@@ -167,6 +167,6 @@
     <string name="pref_developer_euicc_memory_reset_desc">此操作是默认隐藏的危险操作。作为替代方案，您可以手动删除所有配置文件。</string>
     <string name="pref_developer_refresh_after_switch">向基带发送刷新命令</string>
     <string name="pref_developer_isdr_aid_list">自定义 ISD-R AID 列表</string>
-    <string name="reset">重置</string>
+    <string name="isdr_aid_list_restore_defaults">重置</string>
     <string name="isdr_aid_list">ISD-R AID 列表</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index e0334c628..88cc0118d 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -2,9 +2,9 @@
 <resources>
     <string name="no_euicc">在此裝置上未檢測到此應用程式可訪問的可插拔 eUICC 卡。請插入相容卡或 USB 晶片讀卡機。</string>
     <string name="no_profile">此 eSIM 上還沒有設定檔</string>
-    <string name="unknown">未知</string>
-    <string name="help">幫助</string>
-    <string name="reload">重新載入卡槽</string>
+    <string name="euicc_info_unknown">未知</string>
+    <string name="notification_help">幫助</string>
+    <string name="profile_reload_slots">重新載入卡槽</string>
     <string name="channel_name_format">虛擬卡槽 %d</string>
     <string name="profile_state_enabled">已啟用</string>
     <string name="profile_state_disabled">已停用</string>
@@ -132,7 +132,7 @@
     <string name="euicc_info_removable">可插拔</string>
     <string name="euicc_info_sgp22_version">SGP.22 版本</string>
     <string name="euicc_info_firmware_version">eUICC OS 版本</string>
-    <string name="euicc_info_globalplatform_version">GlobalPlatform 版本</string>
+    <string name="euicc_info_gp_version">GlobalPlatform 版本</string>
     <string name="euicc_info_sas_accreditation_number">SAS 認證號碼</string>
     <string name="euicc_info_pp_version">Protected Profile 版本</string>
     <string name="euicc_info_free_nvram">NVRAM 剩餘空間 (eSIM 儲存容量)</string>
@@ -140,8 +140,8 @@
     <string name="euicc_info_ci_gsma_live">GSMA 生產環境 CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA 測試 CI</string>
     <string name="euicc_info_ci_unknown">未知 eSIM CI</string>
-    <string name="yes">是</string>
-    <string name="no">否</string>
+    <string name="euicc_info_yes">是</string>
+    <string name="euicc_info_no">否</string>
     <string name="developer_options_steps">還有 %d 步成為開發者</string>
     <string name="developer_options_enabled">您現在是開發者了！</string>
     <string name="pref_advanced_language">語言</string>
@@ -152,7 +152,7 @@
     <string name="pref_developer_unfiltered_profile_list_desc">在設定檔列表中包括非生產環境的設定檔</string>
     <string name="pref_developer_ignore_tls_certificate">忽略 SM-DP+ 的 TLS 證書</string>
     <string name="pref_developer_ignore_tls_certificate_desc">允許 RSP 伺服器使用任意證書</string>
-    <string name="information_unavailable">無資訊</string>
+    <string name="euicc_info_unavailable">無資訊</string>
     <string name="toast_euicc_memory_reset_confirm_text_mismatched">輸入的確認文字不匹配</string>
     <string name="toast_euicc_memory_reset_finitshed">此晶片已被擦除</string>
     <string name="task_euicc_memory_reset">正在擦除 eSIM 晶片</string>
@@ -167,6 +167,6 @@
     <string name="pref_developer_euicc_memory_reset_desc">此操作是預設隱藏的危險操作。作為替代方案，您可以手動刪除所有設定檔。</string>
     <string name="pref_developer_refresh_after_switch">向基帶發送刷新命令</string>
     <string name="pref_developer_isdr_aid_list">自訂 ISD-R AID 列表</string>
-    <string name="reset">重置</string>
+    <string name="isdr_aid_list_restore_defaults">重置</string>
     <string name="isdr_aid_list">ISD-R AID 列表</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index d52623887..e09da9f62 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -2,14 +2,15 @@
 <resources>
     <string name="no_euicc">No removable eUICC card accessible by this app is detected on this device. Insert a compatible card or a USB reader.</string>
     <string name="no_profile">No profiles (yet) on this eSIM.</string>
-    <string name="unknown">Unknown</string>
-    <string name="information_unavailable">Information Unavailable</string>
-    <string name="help">Help</string>
-    <string name="reload">Reload Slots</string>
+
+    <string name="notification_help">Help</string>
+
+    <string name="profile_reload_slots">Reload Slots</string>
+    <string name="profile_no_enabled_profile">Unknown</string>
 
     <string name="channel_name_format">Logical Slot %d</string>
-    <string name="usb" translatable="false">USB</string>
-    <string name="omapi" translatable="false">OpenMobile API (OMAPI)</string>
+    <string name="channel_type_usb" translatable="false">USB</string>
+    <string name="channel_type_omapi" translatable="false">OpenMobile API (OMAPI)</string>
 
     <!-- Profile -->
     <string name="profile_state_enabled">Enabled</string>
@@ -139,7 +140,7 @@
     <string name="euicc_info_isdr_aid" translatable="false">ISD-R AID</string>
     <string name="euicc_info_sgp22_version">SGP.22 Version</string>
     <string name="euicc_info_firmware_version">eUICC OS Version</string>
-    <string name="euicc_info_globalplatform_version">GlobalPlatform Version</string>
+    <string name="euicc_info_gp_version">GlobalPlatform Version</string>
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
     <string name="euicc_info_pp_version">Protected Profile Version</string>
     <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
@@ -156,8 +157,11 @@
     <string name="euicc_memory_reset_confirm_text">I CONFIRM TO ERASE THE CHIP WHOSE EID ENDS WITH %s AND UNDERSTAND THAT THIS IS IRREVERSIBLE</string>
     <string name="euicc_memory_reset_invoke_button">Erase</string>
 
-    <string name="yes">Yes</string>
-    <string name="no">No</string>
+    <!-- eUICC Info -->
+    <string name="euicc_info_yes">Yes</string>
+    <string name="euicc_info_no">No</string>
+    <string name="euicc_info_unknown">Unknown</string>
+    <string name="euicc_info_unavailable">Information Unavailable</string>
 
     <string name="logs_save">Save</string>
     <string name="logs_filename_template">Logs at %s</string>
@@ -165,10 +169,9 @@
     <string name="developer_options_steps">You are %d steps away from being a developer.</string>
     <string name="developer_options_enabled">You are now a developer!</string>
 
-    <string name="reset">Reset</string>
-
     <string name="isdr_aid_list">ISD-R AID List</string>
     <string name="isdr_aid_list_saved">Saved custom ISD-R AID list.</string>
+    <string name="isdr_aid_list_restore_defaults">Reset</string>
 
     <string name="pref_settings">Settings</string>
     <string name="pref_notifications">Notifications</string>
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 68eddefd1..978e886da 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -2,7 +2,6 @@ package im.angry.openeuicc.core
 
 import android.content.Context
 import android.util.Log
-import im.angry.openeuicc.OpenEuiccApplication
 import im.angry.openeuicc.R
 import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.first
@@ -32,7 +31,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
             )
             try {
                 return EuiccChannelImpl(
-                    context.getString(R.string.telephony_manager),
+                    context.getString(R.string.channel_type_telephony_manager),
                     port,
                     intrinsicChannelName = null,
                     TelephonyManagerApduInterface(
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
index acc1728fe..fbf5c53d6 100644
--- a/app/src/main/res/values-ja/strings.xml
+++ b/app/src/main/res/values-ja/strings.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="no_euicc_priv">このデバイスで eUICC が見つかりません。\nデバイスによってはアプリのメニューからデュアル SIM を有効化する必要があります。</string>
-    <string name="telephony_manager">TelephonyManager (特権)</string>
+    <string name="channel_type_telephony_manager">TelephonyManager (特権)</string>
     <string name="dsds">デュアル SIM</string>
     <string name="toast_dsds_switched">DSDS の状態が切り替わりました。モデムが再起動するまでお待ちください。</string>
     <string name="footer_mep">このスロットは MEP (Multiple Enabled Profiles) をサポートしています。この機能を有効化または無効化するには「スロットマッピングツール」を使用してください。</string>
diff --git a/app/src/main/res/values-zh-rCN/strings.xml b/app/src/main/res/values-zh-rCN/strings.xml
index d6befc2d2..acd9a6107 100644
--- a/app/src/main/res/values-zh-rCN/strings.xml
+++ b/app/src/main/res/values-zh-rCN/strings.xml
@@ -16,7 +16,7 @@
     <string name="lui_desc">您的设备支持 eSIM。要连接到移动网络，请下载运营商发布的 eSIM，或插入物理 SIM 卡。</string>
     <string name="lui_skip">跳过</string>
     <string name="lui_download">下载 eSIM</string>
-    <string name="telephony_manager">TelephonyManager (特权)</string>
+    <string name="channel_type_telephony_manager">TelephonyManager (特权)</string>
     <string name="pref_developer_telephony_manager_removable">全局使用 TelephonyManager</string>
     <string name="pref_developer_telephony_manager_removable_desc">在默认情况下，可移除 eUICC 将仅使用 OMAPI。这与非特权模式 (EasyEUICC) 一致。在某些设备上 OMAPI 可能存在问题 -- 选择此选项以强制使用 TelephonyManager。</string>
 </resources>
\ No newline at end of file
diff --git a/app/src/main/res/values-zh-rTW/strings.xml b/app/src/main/res/values-zh-rTW/strings.xml
index 10285d3cd..52b5aa84b 100644
--- a/app/src/main/res/values-zh-rTW/strings.xml
+++ b/app/src/main/res/values-zh-rTW/strings.xml
@@ -16,7 +16,7 @@
     <string name="lui_desc">您的裝置支援 eSIM。要連線到行動網路，請下載電信業者釋出的 eSIM，或插入實體 SIM 卡。</string>
     <string name="lui_skip">跳過</string>
     <string name="lui_download">下載 eSIM</string>
-    <string name="telephony_manager">TelephonyManager (特權)</string>
+    <string name="channel_type_telephony_manager">TelephonyManager (特權)</string>
     <string name="pref_developer_telephony_manager_removable">全域使用 TelephonyManager</string>
     <string name="pref_developer_telephony_manager_removable_desc">在預設情況下，可移除 eUICC 將僅使用 OMAPI。這與非特權模式 (EasyEUICC) 一致。在某些裝置上 OMAPI 可能有問題 -- 選擇此選項以強制使用 TelephonyManager。</string>
 </resources>
\ No newline at end of file
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index ddf17e40e..2c26bc3f1 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -1,7 +1,7 @@
 <resources>
     <string name="app_name" translatable="false">OpenEUICC</string>
     <string name="no_euicc_priv">No eUICC found on this device.\nOn some devices, you may need to enable dual SIM first in the menu of this app.</string>
-    <string name="telephony_manager">TelephonyManager (Privileged)</string>
+    <string name="channel_type_telephony_manager">TelephonyManager (Privileged)</string>
 
     <string name="dsds">Dual SIM</string>
 

From 72ec20f82431b34f4c1ba438b32379be4edd6838 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 10 Aug 2025 22:03:25 +0200
Subject: [PATCH 436/458] feat: 16k page sizes (#211)

see https://developer.android.com/guide/practices/page-sizes

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/211
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 libs/lpac-jni/src/main/jni/Application.mk | 3 ++-
 libs/lpac-jni/src/main/jni/lpac-jni.mk    | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/libs/lpac-jni/src/main/jni/Application.mk b/libs/lpac-jni/src/main/jni/Application.mk
index 21121965b..c1d3766d6 100644
--- a/libs/lpac-jni/src/main/jni/Application.mk
+++ b/libs/lpac-jni/src/main/jni/Application.mk
@@ -1,4 +1,5 @@
 APP_ABI := all
 APP_SHORT_COMMANDS := true
 APP_CFLAGS := -Wno-compound-token-split-by-macro
-APP_LDFLAGS := -Wl,--build-id=none -z muldefs
\ No newline at end of file
+APP_LDFLAGS := -Wl,--build-id=none -z muldefs
+APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true
diff --git a/libs/lpac-jni/src/main/jni/lpac-jni.mk b/libs/lpac-jni/src/main/jni/lpac-jni.mk
index c0bcee725..dad173c3c 100644
--- a/libs/lpac-jni/src/main/jni/lpac-jni.mk
+++ b/libs/lpac-jni/src/main/jni/lpac-jni.mk
@@ -1,4 +1,5 @@
 LOCAL_PATH := $(call my-dir)
+LOCAL_LDFLAGS += "-Wl,-z,max-page-size=16384"
 
 # function to find all *.c files under a directory
 define all-c-files-under

From deb0a372b14caacdf5d3e509135efb9b19c95f10 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 10 Aug 2025 22:07:10 +0200
Subject: [PATCH 437/458] feat: allow copy app version and source code url
 (#216)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/216
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/res/xml/pref_settings.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 690a12013..17505e1eb 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -96,12 +96,14 @@
         <Preference
             app:iconSpaceReserved="false"
             app:title="@string/pref_info_app_version"
+            app:enableCopying="true"
             app:key="pref_info_app_version" />
 
         <Preference
             app:iconSpaceReserved="false"
             app:title="@string/pref_info_source_code"
             app:summary="@string/pref_info_source_code_url"
+            app:enableCopying="true"
             app:key="pref_info_source_code">
             <intent
                 android:action="android.intent.action.VIEW"

From 3fed4b2bd62e3f8c1c3b9eb61daeadec39d40b41 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 10 Aug 2025 22:07:25 +0200
Subject: [PATCH 438/458] fix: aid list (#217)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/217
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 5f4aec442..464aeeecf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -50,9 +50,12 @@ internal object PreferenceConstants {
         # eUICC standard
         $EUICC_DEFAULT_ISDR_AID
 
-        # eSTK.me
+        # ESTKme AUX (deprecated, use SE0 instead)
         A06573746B6D65FFFFFFFF4953442D52
 
+        # ESTKme SE0
+        A06573746B6D65FFFF4953442D522030
+
         # eSIM.me
         A0000005591010000000008900000300
 

From a8b7482afb98236c591912dc24524da7543bbf59 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 10 Aug 2025 22:08:31 +0200
Subject: [PATCH 439/458] feat: version name suffix (#215)

see https://developer.android.com/build/build-variants

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/215
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-unpriv/build.gradle.kts                                 | 3 +++
 app/build.gradle.kts                                        | 3 +++
 .../src/main/kotlin/im/angry/openeuicc/build/Versioning.kt  | 6 +++---
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/app-unpriv/build.gradle.kts b/app-unpriv/build.gradle.kts
index 66a60b4ba..d59fe713d 100644
--- a/app-unpriv/build.gradle.kts
+++ b/app-unpriv/build.gradle.kts
@@ -27,6 +27,9 @@ android {
     }
 
     buildTypes {
+        defaultConfig {
+            versionNameSuffix = "-unpriv"
+        }
         release {
             isMinifyEnabled = false
             proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index b9c2100f8..69e0db599 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -23,6 +23,9 @@ android {
     }
 
     buildTypes {
+        defaultConfig {
+            versionNameSuffix = "-priv"
+        }
         release {
             isMinifyEnabled = false
             proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
diff --git a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
index 24f02358b..ef07c4302 100644
--- a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
+++ b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Versioning.kt
@@ -16,7 +16,7 @@ val Project.gitVersionCode: Int
                 standardOutput = stdout
             }
             stdout.toString("utf-8").trim('\n').toInt()
-        } catch (e: Exception) {
+        } catch (_: Exception) {
             0
         }
 
@@ -29,7 +29,7 @@ val Project.gitVersionName: String
                 standardOutput = stdout
             }
             stdout.toString("utf-8").trim('\n')
-        } catch (e: Exception) {
+        } catch (_: Exception) {
             "Unknown"
         }
 
@@ -38,7 +38,7 @@ class MyVersioningPlugin: Plugin<Project> {
         target.configure<BaseAppModuleExtension> {
             defaultConfig {
                 versionCode = target.gitVersionCode
-                versionName = target.gitVersionName
+                versionName = target.gitVersionName.removePrefix("unpriv-")
             }
 
             applicationVariants.all {

From 4d8b8e8fb5489dcab8b4c0419e75578aed8f1b71 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Fri, 15 Aug 2025 00:18:41 +0200
Subject: [PATCH 440/458] fix: update .gitignore to ignore all deployment
 target files (#222)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/222
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .idea/.gitignore                   |  2 +-
 .idea/deploymentTargetSelector.xml | 37 ------------------------------
 2 files changed, 1 insertion(+), 38 deletions(-)
 delete mode 100644 .idea/deploymentTargetSelector.xml

diff --git a/.idea/.gitignore b/.idea/.gitignore
index b7c2402ad..2e1299539 100644
--- a/.idea/.gitignore
+++ b/.idea/.gitignore
@@ -2,7 +2,7 @@
 /caches
 /libraries
 /assetWizardSettings.xml
-/deploymentTargetDropDown.xml
+/deploymentTarget*.xml
 /gradle.xml
 /misc.xml
 /modules.xml
diff --git a/.idea/deploymentTargetSelector.xml b/.idea/deploymentTargetSelector.xml
deleted file mode 100644
index e40be604b..000000000
--- a/.idea/deploymentTargetSelector.xml
+++ /dev/null
@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="deploymentTargetSelector">
-    <selectionStates>
-      <SelectionState runConfigName="app-unpriv">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app-unpriv.androidTest">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app-unpriv.main">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app-unpriv.unitTest">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app.unitTest">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app.androidTest">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="app.main">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="workspace.OpenEUICC.app-unpriv">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-      <SelectionState runConfigName="workspace.OpenEUICC.app">
-        <option name="selectionMode" value="DROPDOWN" />
-      </SelectionState>
-    </selectionStates>
-  </component>
-</project>
\ No newline at end of file

From 7e7f5c2b055e3c51aa95556cbfbda6e25aec3259 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Fri, 15 Aug 2025 21:06:23 -0400
Subject: [PATCH 441/458] feat: Magisk module builds on CI

Much of this is taken from AndroPlus's Magisk module repo, thanks!

There's still no release builds for privileged OpenEUICC and the Magisk
module; this is still intentional (for now). However, it is possible to
produce a release Magisk zip locally via the
`:app:assembleReleaseMagiskModule` task.
---
 .forgejo/workflows/build-debug.yml            | 15 +++-
 app/build.gradle.kts                          | 59 +++++++++++++++
 app/magisk/customize.sh                       |  9 +++
 app/magisk/module_installer.sh                | 33 +++++++++
 app/magisk/uninstall.sh                       |  1 +
 .../kotlin/im/angry/openeuicc/build/Magisk.kt | 74 +++++++++++++++++++
 6 files changed, 188 insertions(+), 3 deletions(-)
 create mode 100644 app/magisk/customize.sh
 create mode 100644 app/magisk/module_installer.sh
 create mode 100644 app/magisk/uninstall.sh
 create mode 100644 buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt

diff --git a/.forgejo/workflows/build-debug.yml b/.forgejo/workflows/build-debug.yml
index 660dabcb7..0818b8b56 100644
--- a/.forgejo/workflows/build-debug.yml
+++ b/.forgejo/workflows/build-debug.yml
@@ -33,14 +33,23 @@ jobs:
         uses: https://gitea.angry.im/actions/setup-android@v3
 
       - name: Build Debug APKs
-        run: ./gradlew --no-daemon assembleDebug
+        run: ./gradlew --no-daemon assembleDebug :app:assembleDebugMagiskModuleDir
 
       - name: Copy Artifacts
-        run: find . -name 'app*-debug.apk' -exec cp {} . \;
+        run: |
+          find . -name 'app*-debug.apk' -exec cp {} . \;
+          cp -r app/build/magisk/debug ./magisk-debug
 
-      - name: Upload Artifacts
+      - name: Upload APK Artifacts
         uses: https://gitea.angry.im/actions/upload-artifact@v3
         with:
           name: Debug APKs
           compression-level: 0
           path: app*-debug.apk
+
+      - name: Upload Magisk Artifacts
+        uses: https://gitea.angry.im/actions/upload-artifact@v3
+        with:
+          name: magisk-debug
+          compression-level: 0
+          path: magisk-debug
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 69e0db599..ddf92afd0 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -1,3 +1,4 @@
+import com.android.build.gradle.internal.api.ApkVariantOutputImpl
 import im.angry.openeuicc.build.*
 
 plugins {
@@ -48,4 +49,62 @@ dependencies {
     testImplementation("junit:junit:4.13.2")
     androidTestImplementation("androidx.test.ext:junit:1.1.5")
     androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
+}
+
+val modulePropsTemplate = mutableMapOf(
+    "id" to android.defaultConfig.applicationId!!,
+    "name" to "OpenEUICC",
+    "version" to android.defaultConfig.versionName!!,
+    "versionCode" to "${android.defaultConfig.versionCode}",
+    "author" to "OpenEUICC authors",
+    "description" to "OpenEUICC is an open-source app that provides system-level eSIM integration."
+)
+
+val moduleCustomizeScript = project.file("magisk/customize.sh").readText()
+    .replace("{APK_NAME}", "OpenEUICC")
+    .replace("{PKG_NAME}", android.defaultConfig.applicationId!!)
+
+val moduleUninstallScript = project.file("magisk/uninstall.sh").readText()
+    .replace("{PKG_NAME}", android.defaultConfig.applicationId!!)
+
+tasks.register<MagiskModuleDirTask>("assembleDebugMagiskModuleDir") {
+    variant = "debug"
+    appName = "OpenEUICC"
+    permsFile = project.rootProject.file("privapp_whitelist_im.angry.openeuicc.xml")
+    moduleInstaller = project.file("magisk/module_installer.sh")
+    moduleCustomizeScriptText = moduleCustomizeScript
+    moduleUninstallScriptText = moduleUninstallScript
+    moduleProp = modulePropsTemplate.let {
+        it["description"] = "(debug build) ${it["description"]}"
+        it["versionCode"] = "${(android.applicationVariants.find { it.name == "debug" }!!.outputs.first() as ApkVariantOutputImpl).versionCodeOverride}"
+        it
+    }
+    dependsOn("assembleDebug")
+}
+
+tasks.register<Zip>("assembleDebugMagiskModule") {
+    dependsOn("assembleDebugMagiskModuleDir")
+    from((tasks.getByName("assembleDebugMagiskModuleDir") as MagiskModuleDirTask).outputDir)
+    archiveFileName = "magisk-debug.zip"
+    destinationDirectory = project.layout.buildDirectory.dir("magisk")
+    entryCompression = ZipEntryCompression.STORED
+}
+
+tasks.register<MagiskModuleDirTask>("assembleReleaseMagiskModuleDir") {
+    variant = "release"
+    appName = "OpenEUICC"
+    permsFile = project.rootProject.file("privapp_whitelist_im.angry.openeuicc.xml")
+    moduleInstaller = project.file("magisk/module_installer.sh")
+    moduleCustomizeScriptText = moduleCustomizeScript
+    moduleUninstallScriptText = moduleUninstallScript
+    moduleProp = modulePropsTemplate
+    dependsOn("assembleRelease")
+}
+
+tasks.register<Zip>("assembleReleaseMagiskModule") {
+    dependsOn("assembleReleaseMagiskModuleDir")
+    from((tasks.getByName("assembleReleaseMagiskModuleDir") as MagiskModuleDirTask).outputDir)
+    archiveFileName = "magisk-release.zip"
+    destinationDirectory = project.layout.buildDirectory.dir("magisk")
+    entryCompression = ZipEntryCompression.STORED
 }
\ No newline at end of file
diff --git a/app/magisk/customize.sh b/app/magisk/customize.sh
new file mode 100644
index 000000000..707b401ca
--- /dev/null
+++ b/app/magisk/customize.sh
@@ -0,0 +1,9 @@
+TMP_FILE="$TMPDIR/{APK_NAME}"
+
+chmod u+x "$MODPATH/uninstall.sh"
+cp "$MODPATH/system/system_ext/{APK_NAME}/{APK_NAME}.apk" "$TMP_FILE"
+
+pm install -r "$TMP_FILE"
+rm -f "$TMP_FILE"
+
+pm grant "{PKG_NAME}" android.permission.READ_PHONE_STATE
\ No newline at end of file
diff --git a/app/magisk/module_installer.sh b/app/magisk/module_installer.sh
new file mode 100644
index 000000000..28b48e580
--- /dev/null
+++ b/app/magisk/module_installer.sh
@@ -0,0 +1,33 @@
+#!/sbin/sh
+
+#################
+# Initialization
+#################
+
+umask 022
+
+# echo before loading util_functions
+ui_print() { echo "$1"; }
+
+require_new_magisk() {
+  ui_print "*******************************"
+  ui_print " Please install Magisk v20.4+! "
+  ui_print "*******************************"
+  exit 1
+}
+
+#########################
+# Load util_functions.sh
+#########################
+
+OUTFD=$2
+ZIPFILE=$3
+
+mount /data 2>/dev/null
+
+[ -f /data/adb/magisk/util_functions.sh ] || require_new_magisk
+. /data/adb/magisk/util_functions.sh
+[ $MAGISK_VER_CODE -lt 20400 ] && require_new_magisk
+
+install_module
+exit 0
diff --git a/app/magisk/uninstall.sh b/app/magisk/uninstall.sh
new file mode 100644
index 000000000..1eb020010
--- /dev/null
+++ b/app/magisk/uninstall.sh
@@ -0,0 +1 @@
+pm uninstall "{PKG_NAME}"
\ No newline at end of file
diff --git a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt
new file mode 100644
index 000000000..6245d8c98
--- /dev/null
+++ b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt
@@ -0,0 +1,74 @@
+package im.angry.openeuicc.build
+
+import org.gradle.api.DefaultTask
+import org.gradle.api.provider.MapProperty
+import org.gradle.api.provider.Property
+import org.gradle.api.tasks.Input
+import org.gradle.api.tasks.InputDirectory
+import org.gradle.api.tasks.InputFile
+import org.gradle.api.tasks.OutputDirectory
+import org.gradle.api.tasks.TaskAction
+import java.io.File
+
+abstract class MagiskModuleDirTask : DefaultTask() {
+    @get:Input
+    abstract val variant : Property<String>
+
+    @get:Input
+    abstract val appName : Property<String>
+
+    @get:InputFile
+    abstract val permsFile : Property<File>
+
+    @get:InputFile
+    abstract val moduleInstaller : Property<File>
+
+    @get:Input
+    abstract val moduleCustomizeScriptText : Property<String>
+
+    @get:Input
+    abstract val moduleUninstallScriptText : Property<String>
+
+    @get:Input
+    abstract val moduleProp : MapProperty<String, String>
+
+    @InputDirectory
+    val inputDir = variant.map { project.layout.buildDirectory.dir("outputs/apk/${it}") }
+
+    @OutputDirectory
+    val outputDir = variant.map { project.layout.buildDirectory.dir("magisk/${it}") }
+
+    @TaskAction
+    fun build() {
+        val dir = outputDir.get().get()
+        project.mkdir(dir)
+        val systemExtDir = dir.dir("system/system_ext")
+        val permDir = dir.dir("system/system_ext/etc/permissions")
+        val appDir = systemExtDir.dir("priv-app/${appName.get()}")
+        val metaInfDir = dir.dir("META-INF/com/google/android")
+        project.mkdir(systemExtDir)
+        project.mkdir(metaInfDir)
+        project.mkdir(appDir)
+        project.mkdir(permDir)
+        project.copy {
+            into(appDir)
+            from(inputDir) {
+                include("app-${variant.get()}.apk")
+                rename("app-${variant.get()}.apk", "${appName.get()}.apk")
+            }
+        }
+        project.copy {
+            from(permsFile)
+            into(permDir)
+        }
+        project.copy {
+            from(moduleInstaller)
+            into(metaInfDir)
+            rename(".*", "update-binary")
+        }
+        dir.file("customize.sh").asFile.writeText(moduleCustomizeScriptText.get())
+        dir.file("uninstall.sh").asFile.writeText(moduleUninstallScriptText.get())
+        metaInfDir.file("updater-script").asFile.writeText("# MAGISK")
+        dir.file("module.prop").asFile.writeText(moduleProp.get().map { (k, v) -> "$k=$v" }.joinToString("\n"))
+    }
+}
\ No newline at end of file

From 27b7e50b9759e0295aaf85cffbd2bb1aa284be2b Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 17 Aug 2025 02:37:16 +0200
Subject: [PATCH 442/458] refactor: simplify developer options click handling
 and toast messages (#221)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/221
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 41 +++++++------------
 1 file changed, 15 insertions(+), 26 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 65541428e..509cf74cf 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -34,7 +34,7 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         // Show / hide developer preference based on whether it is enabled
         lifecycleScope.launch {
             preferenceRepository.developerOptionsEnabledFlow
-                .onEach { developerPref.isVisible = it }
+                .onEach(developerPref::setVisible)
                 .collect()
         }
 
@@ -100,41 +100,30 @@ open class SettingsFragment: PreferenceFragmentCompat() {
     @Suppress("UNUSED_PARAMETER")
     private fun onAppVersionClicked(pref: Preference): Boolean {
         if (developerPref.isVisible) return false
+
         val now = System.currentTimeMillis()
-        if (now - lastClickTimestamp >= 1000) {
-            numClicks = 1
-        } else {
-            numClicks++
-        }
+        numClicks = if (now - lastClickTimestamp >= 1000) 1 else numClicks + 1
         lastClickTimestamp = now
 
-        if (numClicks == 7) {
-            lifecycleScope.launch {
-                preferenceRepository.developerOptionsEnabledFlow.updatePreference(true)
-
-                lastToast?.cancel()
-                Toast.makeText(
-                    requireContext(),
-                    R.string.developer_options_enabled,
-                    Toast.LENGTH_SHORT
-                ).show()
-            }
-        } else if (numClicks > 1) {
-            lastToast?.cancel()
-            lastToast = Toast.makeText(
-                requireContext(),
-                getString(R.string.developer_options_steps, 7 - numClicks),
-                Toast.LENGTH_SHORT
-            )
-            lastToast!!.show()
+        lifecycleScope.launch {
+            preferenceRepository.developerOptionsEnabledFlow.updatePreference(numClicks >= 7)
         }
 
+        val toastText = when {
+            numClicks == 7 -> getString(R.string.developer_options_enabled)
+            numClicks > 1 -> getString(R.string.developer_options_steps, 7 - numClicks)
+            else -> return true
+        }
+
+        lastToast?.cancel()
+        lastToast = Toast.makeText(requireContext(), toastText, Toast.LENGTH_SHORT)
+        lastToast!!.show()
         return true
     }
 
     protected fun CheckBoxPreference.bindBooleanFlow(flow: PreferenceFlowWrapper<Boolean>) {
         lifecycleScope.launch {
-            flow.collect { isChecked = it }
+            flow.collect(::setChecked)
         }
 
         setOnPreferenceChangeListener { _, newValue ->

From 9e40232ed03dce58e35ca1758246d382ffec78a5 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 17 Aug 2025 02:45:48 +0200
Subject: [PATCH 443/458] feat: es10x mss as preference (#213)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/213
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../core/DefaultEuiccChannelFactory.kt        | 88 +++++++++----------
 .../angry/openeuicc/core/EuiccChannelImpl.kt  | 12 ++-
 .../im/angry/openeuicc/ui/SettingsFragment.kt | 20 ++++-
 .../angry/openeuicc/util/PreferenceUtils.kt   |  3 +
 app-common/src/main/res/values/strings.xml    | 10 +++
 app-common/src/main/res/xml/pref_settings.xml |  8 ++
 .../core/PrivilegedEuiccChannelFactory.kt     |  1 +
 7 files changed, 89 insertions(+), 53 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
index 87a0eea26..78a8c3f3f 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/DefaultEuiccChannelFactory.kt
@@ -21,7 +21,7 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
     override suspend fun tryOpenEuiccChannel(
         port: UiccPortInfoCompat,
         isdrAid: ByteArray
-    ): EuiccChannel? {
+    ): EuiccChannel? = try {
         if (port.portIndex != 0) {
             Log.w(
                 DefaultEuiccChannelManager.TAG,
@@ -35,58 +35,52 @@ open class DefaultEuiccChannelFactory(protected val context: Context) : EuiccCha
             DefaultEuiccChannelManager.TAG,
             "Trying OMAPI for physical slot ${port.card.physicalSlotIndex}"
         )
-        try {
-            return EuiccChannelImpl(
-                context.getString(R.string.channel_type_omapi),
+        EuiccChannelImpl(
+            context.getString(R.string.channel_type_omapi),
+            port,
+            intrinsicChannelName = null,
+            OmapiApduInterface(
+                seService!!,
                 port,
-                intrinsicChannelName = null,
-                OmapiApduInterface(
-                    seService!!,
-                    port,
-                    context.preferenceRepository.verboseLoggingFlow
-                ),
-                isdrAid,
-                context.preferenceRepository.verboseLoggingFlow,
-                context.preferenceRepository.ignoreTLSCertificateFlow,
-            ).also {
-                Log.i(DefaultEuiccChannelManager.TAG, "Is OMAPI channel, setting MSS to 60")
-                it.lpa.setEs10xMss(60)
-            }
-        } catch (_: IllegalArgumentException) {
-            // Failed
-            Log.w(
-                DefaultEuiccChannelManager.TAG,
-                "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex} with ISD-R AID: ${isdrAid.encodeHex()}."
-            )
-        }
-
-        return null
+                context.preferenceRepository.verboseLoggingFlow
+            ),
+            isdrAid,
+            context.preferenceRepository.verboseLoggingFlow,
+            context.preferenceRepository.ignoreTLSCertificateFlow,
+            context.preferenceRepository.es10xMssFlow,
+        )
+    } catch (_: IllegalArgumentException) {
+        // Failed
+        Log.w(
+            DefaultEuiccChannelManager.TAG,
+            "OMAPI APDU interface unavailable for physical slot ${port.card.physicalSlotIndex} with ISD-R AID: ${isdrAid.encodeHex()}."
+        )
+        null
     }
 
     override fun tryOpenUsbEuiccChannel(
         ccidCtx: UsbCcidContext,
         isdrAid: ByteArray
-    ): EuiccChannel? {
-        try {
-            return EuiccChannelImpl(
-                context.getString(R.string.channel_type_usb),
-                FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
-                intrinsicChannelName = ccidCtx.productName,
-                UsbApduInterface(
-                    ccidCtx
-                ),
-                isdrAid,
-                context.preferenceRepository.verboseLoggingFlow,
-                context.preferenceRepository.ignoreTLSCertificateFlow,
-            )
-        } catch (_: IllegalArgumentException) {
-            // Failed
-            Log.w(
-                DefaultEuiccChannelManager.TAG,
-                "USB APDU interface unavailable for ISD-R AID: ${isdrAid.encodeHex()}."
-            )
-        }
-        return null
+    ): EuiccChannel? = try {
+        EuiccChannelImpl(
+            context.getString(R.string.channel_type_usb),
+            FakeUiccPortInfoCompat(FakeUiccCardInfoCompat(EuiccChannelManager.USB_CHANNEL_ID)),
+            intrinsicChannelName = ccidCtx.productName,
+            UsbApduInterface(
+                ccidCtx
+            ),
+            isdrAid,
+            context.preferenceRepository.verboseLoggingFlow,
+            context.preferenceRepository.ignoreTLSCertificateFlow,
+            context.preferenceRepository.es10xMssFlow,
+        )
+    } catch (_: IllegalArgumentException) {
+        // Failed
+        Log.w(
+            DefaultEuiccChannelManager.TAG,
+            "USB APDU interface unavailable for ISD-R AID: ${isdrAid.encodeHex()}."
+        )
+        null
     }
 
     override fun cleanup() {
diff --git a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
index 2a33c2061..eaec5227b 100644
--- a/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/core/EuiccChannelImpl.kt
@@ -1,8 +1,9 @@
 package im.angry.openeuicc.core
 
 import im.angry.openeuicc.util.UiccPortInfoCompat
-import im.angry.openeuicc.util.decodeHex
 import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.coroutines.runBlocking
 import net.typeblog.lpac_jni.ApduInterface
 import net.typeblog.lpac_jni.LocalProfileAssistant
 import net.typeblog.lpac_jni.impl.HttpInterfaceImpl
@@ -15,7 +16,8 @@ class EuiccChannelImpl(
     override val apduInterface: ApduInterface,
     override val isdrAid: ByteArray,
     verboseLoggingFlow: Flow<Boolean>,
-    ignoreTLSCertificateFlow: Flow<Boolean>
+    ignoreTLSCertificateFlow: Flow<Boolean>,
+    es10xMssFlow: Flow<Int>,
 ) : EuiccChannel {
     override val slotId = port.card.physicalSlotIndex
     override val logicalSlotId = port.logicalSlotIndex
@@ -25,8 +27,10 @@ class EuiccChannelImpl(
         LocalProfileAssistantImpl(
             isdrAid,
             apduInterface,
-            HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow)
-        )
+            HttpInterfaceImpl(verboseLoggingFlow, ignoreTLSCertificateFlow),
+        ).also {
+            it.setEs10xMss(runBlocking { es10xMssFlow.first().toByte() })
+        }
 
     override val atr: ByteArray?
         get() = (apduInterface as? ApduInterfaceAtrProvider)?.atr
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
index 509cf74cf..7a717ac18 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/SettingsFragment.kt
@@ -8,6 +8,7 @@ import android.provider.Settings
 import android.widget.Toast
 import androidx.lifecycle.lifecycleScope
 import androidx.preference.CheckBoxPreference
+import androidx.preference.ListPreference
 import androidx.preference.Preference
 import androidx.preference.PreferenceCategory
 import androidx.preference.PreferenceFragmentCompat
@@ -16,7 +17,6 @@ import im.angry.openeuicc.util.*
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.flow.onEach
 import kotlinx.coroutines.launch
-import kotlinx.coroutines.runBlocking
 
 open class SettingsFragment: PreferenceFragmentCompat() {
     private lateinit var developerPref: PreferenceCategory
@@ -84,6 +84,9 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         requirePreference<CheckBoxPreference>("pref_developer_euicc_memory_reset")
             .bindBooleanFlow(preferenceRepository.euiccMemoryResetFlow)
 
+        requirePreference<ListPreference>("pref_developer_es10x_mss")
+            .bindIntFlow(preferenceRepository.es10xMssFlow, 63)
+
         requirePreference<Preference>("pref_developer_isdr_aid_list").apply {
             intent = Intent(requireContext(), IsdrAidListActivity::class.java)
         }
@@ -127,13 +130,26 @@ open class SettingsFragment: PreferenceFragmentCompat() {
         }
 
         setOnPreferenceChangeListener { _, newValue ->
-            runBlocking {
+            lifecycleScope.launch {
                 flow.updatePreference(newValue as Boolean)
             }
             true
         }
     }
 
+    private fun ListPreference.bindIntFlow(flow: PreferenceFlowWrapper<Int>, defaultValue: Int) {
+        lifecycleScope.launch {
+            flow.collect { value = it.toString() }
+        }
+
+        setOnPreferenceChangeListener { _, newValue ->
+            lifecycleScope.launch {
+                flow.updatePreference((newValue as String).toIntOrNull() ?: defaultValue)
+            }
+            true
+        }
+    }
+
     protected fun mergePreferenceOverlay(overlayKey: String, targetKey: String) {
         val overlayCat = requirePreference<PreferenceCategory>(overlayKey)
         val targetCat = requirePreference<PreferenceCategory>(targetKey)
diff --git a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
index 464aeeecf..2fef3db2c 100644
--- a/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/util/PreferenceUtils.kt
@@ -5,6 +5,7 @@ import androidx.datastore.core.DataStore
 import androidx.datastore.preferences.core.Preferences
 import androidx.datastore.preferences.core.booleanPreferencesKey
 import androidx.datastore.preferences.core.edit
+import androidx.datastore.preferences.core.intPreferencesKey
 import androidx.datastore.preferences.core.stringPreferencesKey
 import androidx.datastore.preferences.preferencesDataStore
 import androidx.fragment.app.Fragment
@@ -38,6 +39,7 @@ internal object PreferenceKeys {
     val IGNORE_TLS_CERTIFICATE = booleanPreferencesKey("ignore_tls_certificate")
     val EUICC_MEMORY_RESET = booleanPreferencesKey("euicc_memory_reset")
     val ISDR_AID_LIST = stringPreferencesKey("isdr_aid_list")
+    val ES10X_MSS = intPreferencesKey("es10x_mss")
 }
 
 const val EUICC_DEFAULT_ISDR_AID = "A0000005591010FFFFFFFF8900000100"
@@ -89,6 +91,7 @@ open class PreferenceRepository(private val context: Context) {
         PreferenceConstants.DEFAULT_AID_LIST,
         { Base64.getEncoder().encodeToString(it.encodeToByteArray()) },
         { Base64.getDecoder().decode(it).decodeToString() })
+    val es10xMssFlow = bindFlow(PreferenceKeys.ES10X_MSS, 63)
 
     protected fun <T> bindFlow(
         key: Preferences.Key<T>,
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index e09da9f62..ae0700b15 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -200,6 +200,16 @@
     <string name="pref_developer_ignore_tls_certificate_desc">Accept any TLS certificate used by the RSP server</string>
     <string name="pref_developer_euicc_memory_reset">Allow erasing eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">This is a dangerous operation and hidden by default. As an alternative, you can delete all profiles manually.</string>
+    <string name="pref_developer_es10x_mss">ES10x MSS</string>
+    <string name="pref_developer_es10x_mss_desc">Global ES10x MSS</string>
+    <string-array name="pref_developer_es10x_entry_keys">
+        <item>High Speed</item>
+        <item>Compatibility Mode</item>
+    </string-array>
+    <string-array name="pref_developer_es10x_entry_values" translatable="false">
+        <item>255</item>
+        <item>63</item>
+    </string-array>
     <string name="pref_developer_isdr_aid_list">Customize ISD-R AID list</string>
     <string name="pref_developer_isdr_aid_list_desc">Some brands of removable eUICCs may use their own non-standard ISD-R AID, rendering them inaccessible to third-party apps. We can attempt to use non-standard AIDs added in this list, but there is no guarantee that they will work.</string>
     <string name="pref_info">Info</string>
diff --git a/app-common/src/main/res/xml/pref_settings.xml b/app-common/src/main/res/xml/pref_settings.xml
index 17505e1eb..831b04dbc 100644
--- a/app-common/src/main/res/xml/pref_settings.xml
+++ b/app-common/src/main/res/xml/pref_settings.xml
@@ -81,6 +81,14 @@
             app:summary="@string/pref_developer_euicc_memory_reset_desc"
             app:title="@string/pref_developer_euicc_memory_reset" />
 
+        <ListPreference
+            app:iconSpaceReserved="false"
+            app:key="pref_developer_es10x_mss"
+            app:summary="@string/pref_developer_es10x_mss_desc"
+            app:title="@string/pref_developer_es10x_mss"
+            app:entries="@array/pref_developer_es10x_entry_keys"
+            app:entryValues="@array/pref_developer_es10x_entry_values" />
+
         <Preference
             app:iconSpaceReserved="false"
             app:key="pref_developer_isdr_aid_list"
diff --git a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
index 978e886da..876387fc0 100644
--- a/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
+++ b/app/src/main/java/im/angry/openeuicc/core/PrivilegedEuiccChannelFactory.kt
@@ -42,6 +42,7 @@ class PrivilegedEuiccChannelFactory(context: Context) : DefaultEuiccChannelFacto
                     isdrAid,
                     context.preferenceRepository.verboseLoggingFlow,
                     context.preferenceRepository.ignoreTLSCertificateFlow,
+                    context.preferenceRepository.es10xMssFlow,
                 )
             } catch (_: IllegalArgumentException) {
                 // Failed

From 915a05634b552e06cc30b48cda2da264fe5f75e4 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 17 Aug 2025 09:41:15 -0400
Subject: [PATCH 444/458] Add updateJson to Magisk module props

---
 app/build.gradle.kts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index ddf92afd0..40122270b 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -77,6 +77,7 @@ tasks.register<MagiskModuleDirTask>("assembleDebugMagiskModuleDir") {
     moduleProp = modulePropsTemplate.let {
         it["description"] = "(debug build) ${it["description"]}"
         it["versionCode"] = "${(android.applicationVariants.find { it.name == "debug" }!!.outputs.first() as ApkVariantOutputImpl).versionCodeOverride}"
+        it["updateJson"] = "https://openeuicc.com/magisk/magisk-debug.json"
         it
     }
     dependsOn("assembleDebug")

From cce247e74754d8579934d198aee1e76134ae0e6b Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Sep 2025 14:56:09 -0400
Subject: [PATCH 445/458] feat: Display simplified error messages when profile
 downloading fails

i18n pending

Co-Authored-By: septs <github@septs.pw>
---
 .../wizard/DownloadWizardProgressFragment.kt  |  55 ++++++-
 .../ui/wizard/SimplifiedErrorMessages.kt      | 154 ++++++++++++++++++
 .../res/layout/download_progress_item.xml     |  58 +++++--
 app-common/src/main/res/values/strings.xml    |  21 +++
 4 files changed, 269 insertions(+), 19 deletions(-)
 create mode 100644 app-common/src/main/java/im/angry/openeuicc/ui/wizard/SimplifiedErrorMessages.kt

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index 342a687f8..29e87b092 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -43,18 +43,36 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
 
     private data class ProgressItem(
         val titleRes: Int,
-        var state: ProgressState
+        var state: ProgressState,
+        var errorMessage: SimplifiedErrorMessages?,
     )
 
     private val progressItems = arrayOf(
-        ProgressItem(R.string.download_wizard_progress_step_preparing, ProgressState.NotStarted),
-        ProgressItem(R.string.download_wizard_progress_step_connecting, ProgressState.NotStarted),
+        ProgressItem(
+            R.string.download_wizard_progress_step_preparing,
+            ProgressState.NotStarted,
+            null
+        ),
+        ProgressItem(
+            R.string.download_wizard_progress_step_connecting,
+            ProgressState.NotStarted,
+            null
+        ),
         ProgressItem(
             R.string.download_wizard_progress_step_authenticating,
-            ProgressState.NotStarted
+            ProgressState.NotStarted,
+            null
         ),
-        ProgressItem(R.string.download_wizard_progress_step_downloading, ProgressState.NotStarted),
-        ProgressItem(R.string.download_wizard_progress_step_finalizing, ProgressState.NotStarted)
+        ProgressItem(
+            R.string.download_wizard_progress_step_downloading,
+            ProgressState.NotStarted,
+            null
+        ),
+        ProgressItem(
+            R.string.download_wizard_progress_step_finalizing,
+            ProgressState.NotStarted,
+            null
+        )
     )
 
     private val adapter = ProgressItemAdapter()
@@ -122,8 +140,13 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                         // Change the state of the last InProgress item to success (or error)
                         progressItems.forEachIndexed { index, progressItem ->
                             if (progressItem.state == ProgressState.InProgress) {
-                                progressItem.state =
-                                    if (state.downloadError == null) ProgressState.Done else ProgressState.Error
+                                if (state.downloadError == null) {
+                                    progressItem.state = ProgressState.Done
+                                } else {
+                                    progressItem.state = ProgressState.Error
+                                    progressItem.errorMessage =
+                                        SimplifiedErrorMessages.fromDownloadError(state.downloadError!!)
+                                }
                             }
 
                             adapter.notifyItemChanged(index)
@@ -197,9 +220,15 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
         private val progressBar =
             root.requireViewById<ProgressBar>(R.id.download_progress_icon_progress)
         private val icon = root.requireViewById<ImageView>(R.id.download_progress_icon)
+        private val errorTitle =
+            root.requireViewById<TextView>(R.id.download_progress_item_error_title)
+        private val errorSuggestion =
+            root.requireViewById<TextView>(R.id.download_progress_item_error_suggestion)
 
         fun bind(item: ProgressItem) {
             title.text = getString(item.titleRes)
+            errorTitle.visibility = View.GONE
+            errorSuggestion.visibility = View.GONE
 
             when (item.state) {
                 ProgressState.NotStarted -> {
@@ -222,6 +251,16 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                     progressBar.visibility = View.GONE
                     icon.setImageResource(R.drawable.ic_error_outline)
                     icon.visibility = View.VISIBLE
+
+                    if (item.errorMessage != null) {
+                        errorTitle.visibility = View.VISIBLE
+                        errorTitle.text = getString(item.errorMessage!!.titleResId)
+
+                        if (item.errorMessage!!.suggestResId != null) {
+                            errorSuggestion.visibility = View.VISIBLE
+                            errorSuggestion.text = getString(item.errorMessage!!.suggestResId!!)
+                        }
+                    }
                 }
             }
         }
diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/SimplifiedErrorMessages.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/SimplifiedErrorMessages.kt
new file mode 100644
index 000000000..8ce5740b9
--- /dev/null
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/SimplifiedErrorMessages.kt
@@ -0,0 +1,154 @@
+package im.angry.openeuicc.ui.wizard
+
+import androidx.annotation.StringRes
+import im.angry.openeuicc.common.R
+import net.typeblog.lpac_jni.LocalProfileAssistant
+import org.json.JSONObject
+import java.net.NoRouteToHostException
+import java.net.PortUnreachableException
+import java.net.SocketException
+import java.net.SocketTimeoutException
+import java.net.UnknownHostException
+import javax.net.ssl.SSLException
+
+enum class SimplifiedErrorMessages(
+    @StringRes val titleResId: Int,
+    @StringRes val suggestResId: Int?
+) {
+    ICCIDAlreadyInUse(
+        R.string.download_wizard_error_iccid_already,
+        R.string.download_wizard_error_suggest_profile_installed
+    ),
+    InsufficientMemory(
+        R.string.download_wizard_error_insufficient_memory,
+        R.string.download_wizard_error_suggest_insufficient_memory
+    ),
+    UnsupportedProfile(
+        R.string.download_wizard_error_unsupported_profile,
+        null
+    ),
+    CardInternalError(
+        R.string.download_wizard_error_card_internal_error,
+        null
+    ),
+    EIDNotSupported(
+        R.string.download_wizard_error_eid_not_supported,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    EIDMismatch(
+        R.string.download_wizard_error_eid_mismatch,
+        R.string.download_wizard_error_suggest_contact_reissue
+    ),
+    UnreleasedProfile(
+        R.string.download_wizard_error_profile_unreleased,
+        R.string.download_wizard_error_suggest_contact_reissue
+    ),
+    MatchingIDRefused(
+        R.string.download_wizard_error_matching_id_refused,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    ProfileRetriesExceeded(
+        R.string.download_wizard_error_profile_retries_exceeded,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    ConfirmationCodeMissing(
+        R.string.download_wizard_error_confirmation_code_missing,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    ConfirmationCodeRefused(
+        R.string.download_wizard_error_confirmation_code_refused,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    ConfirmationCodeRetriesExceeded(
+        R.string.download_wizard_error_confirmation_code_retries_exceeded,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    ProfileExpired(
+        R.string.download_wizard_error_profile_expired,
+        R.string.download_wizard_error_suggest_contact_carrier
+    ),
+    UnknownHost(
+        R.string.download_wizard_error_unknown_hostname,
+        null
+    ),
+    NetworkUnreachable(
+        R.string.download_wizard_error_network_unreachable,
+        R.string.download_wizard_error_suggest_network_unreachable
+    ),
+    TLSError(
+        R.string.download_wizard_error_tls_certificate,
+        null
+    );
+
+    companion object {
+        private val httpErrors = buildMap {
+            // Stage: AuthenticateClient
+            put("8.1" to "4.8", InsufficientMemory)
+            put("8.1.1" to "2.1", EIDNotSupported)
+            put("8.1.1" to "3.8", EIDMismatch)
+            put("8.2" to "1.2", UnreleasedProfile)
+            put("8.2.6" to "3.8", MatchingIDRefused)
+            put("8.8.5" to "6.4", ProfileRetriesExceeded)
+
+            // Stage: GetBoundProfilePackage
+            put("8.2.7" to "2.2", ConfirmationCodeMissing)
+            put("8.2.7" to "3.8", ConfirmationCodeRefused)
+            put("8.2.7" to "6.4", ConfirmationCodeRetriesExceeded)
+
+            // Stage: AuthenticateClient, GetBoundProfilePackage
+            put("8.8.5" to "4.10", ProfileExpired)
+        }
+
+        fun fromDownloadError(exc: LocalProfileAssistant.ProfileDownloadException) = when {
+            exc.lpaErrorReason != "ES10B_ERROR_REASON_UNDEFINED" -> fromLPAErrorReason(exc.lpaErrorReason)
+            exc.lastHttpResponse?.rcode == 200 -> fromHTTPResponse(exc.lastHttpResponse!!)
+            exc.lastHttpException != null -> fromHTTPException(exc.lastHttpException!!)
+            exc.lastApduResponse != null -> fromAPDUResponse(exc.lastApduResponse!!)
+            else -> null
+        }
+
+        private fun fromLPAErrorReason(reason: String) = when (reason) {
+            "ES10B_ERROR_REASON_UNSUPPORTED_CRT_VALUES" -> UnsupportedProfile
+            "ES10B_ERROR_REASON_UNSUPPORTED_REMOTE_OPERATION_TYPE" -> UnsupportedProfile
+            "ES10B_ERROR_REASON_UNSUPPORTED_PROFILE_CLASS" -> UnsupportedProfile
+            "ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_ICCID_ALREADY_EXISTS_ON_EUICC" -> ICCIDAlreadyInUse
+            "ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_INSUFFICIENT_MEMORY_FOR_PROFILE" -> InsufficientMemory
+            "ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_INTERRUPTION" -> CardInternalError
+            "ES10B_ERROR_REASON_INSTALL_FAILED_DUE_TO_PE_PROCESSING_ERROR" -> CardInternalError
+            else -> null
+        }
+
+        private fun fromHTTPResponse(httpResponse: net.typeblog.lpac_jni.HttpInterface.HttpResponse): SimplifiedErrorMessages? {
+            if (httpResponse.data.first().toInt() != '{'.code) return null
+            val response = JSONObject(httpResponse.data.decodeToString())
+            val statusCodeData = response.optJSONObject("header")
+                ?.optJSONObject("functionExecutionStatus")
+                ?.optJSONObject("statusCodeData")
+                ?: return null
+            val subjectCode = statusCodeData.optString("subjectCode")
+            val reasonCode = statusCodeData.optString("reasonCode")
+            return httpErrors[subjectCode to reasonCode]
+        }
+
+        private fun fromHTTPException(exc: Exception) = when (exc) {
+            is SSLException -> TLSError
+            is UnknownHostException -> UnknownHost
+            is NoRouteToHostException -> NetworkUnreachable
+            is PortUnreachableException -> NetworkUnreachable
+            is SocketTimeoutException -> NetworkUnreachable
+            is SocketException -> exc.message
+                ?.contains("Connection reset", ignoreCase = true)
+                ?.let { if (it) NetworkUnreachable else null }
+
+            else -> null
+        }
+
+        private fun fromAPDUResponse(resp: ByteArray): SimplifiedErrorMessages? {
+            val isSuccess = resp.size >= 2 &&
+                    resp[resp.size - 2] == 0x90.toByte() &&
+                    resp[resp.size - 1] == 0x00.toByte()
+            if (isSuccess) return null
+            return CardInternalError
+        }
+    }
+}
diff --git a/app-common/src/main/res/layout/download_progress_item.xml b/app-common/src/main/res/layout/download_progress_item.xml
index f1d0852e8..c59673b0d 100644
--- a/app-common/src/main/res/layout/download_progress_item.xml
+++ b/app-common/src/main/res/layout/download_progress_item.xml
@@ -1,30 +1,32 @@
 <?xml version="1.0" encoding="utf-8"?>
 <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
     android:layout_width="match_parent"
-    android:layout_height="wrap_content"
-    xmlns:app="http://schemas.android.com/apk/res-auto">
+    android:layout_height="wrap_content">
 
     <TextView
         android:id="@+id/download_progress_item_title"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
-        android:layout_margin="20dp"
+        android:layout_marginHorizontal="20dp"
         android:textSize="14sp"
-        app:layout_constraintTop_toTopOf="parent"
-        app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintBottom_toBottomOf="parent"
-        app:layout_constraintEnd_toStartOf="@id/download_progress_icon_container"
         app:layout_constrainedWidth="true"
-        app:layout_constraintHorizontal_bias="0.0" />
+        app:layout_constraintBottom_toBottomOf="@id/download_progress_icon_container"
+        app:layout_constraintEnd_toStartOf="@id/download_progress_icon_container"
+        app:layout_constraintHorizontal_bias="0.0"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="@id/download_progress_icon_container"
+        app:layout_constraintVertical_bias="0.5" />
 
     <FrameLayout
         android:id="@+id/download_progress_icon_container"
-        android:layout_margin="20dp"
         android:layout_width="30dp"
         android:layout_height="30dp"
-        app:layout_constraintTop_toTopOf="parent"
+        android:layout_margin="20dp"
         app:layout_constraintBottom_toBottomOf="parent"
-        app:layout_constraintEnd_toEndOf="parent">
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintTop_toTopOf="parent"
+        app:layout_constraintVertical_bias="0.0">
 
         <ProgressBar
             android:id="@+id/download_progress_icon_progress"
@@ -42,4 +44,38 @@
 
     </FrameLayout>
 
+    <TextView
+        android:id="@+id/download_progress_item_error_title"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="10dp"
+        android:layout_marginStart="20dp"
+        android:layout_marginEnd="20dp"
+        android:layout_marginBottom="10dp"
+        android:textColor="?attr/colorError"
+        android:textSize="12sp"
+        android:visibility="gone"
+        app:layout_constrainedWidth="true"
+        app:layout_constraintBottom_toTopOf="@id/download_progress_item_error_suggestion"
+        app:layout_constraintEnd_toStartOf="@id/download_progress_icon_container"
+        app:layout_constraintHorizontal_bias="0.0"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/download_progress_item_title" />
+
+    <TextView
+        android:id="@+id/download_progress_item_error_suggestion"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="20dp"
+        android:layout_marginEnd="20dp"
+        android:textColor="?attr/colorError"
+        android:textSize="12sp"
+        android:visibility="gone"
+        app:layout_constrainedWidth="true"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toStartOf="@id/download_progress_icon_container"
+        app:layout_constraintHorizontal_bias="0.0"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toBottomOf="@id/download_progress_item_title" />
+
 </androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index ae0700b15..3a9dda366 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -104,6 +104,27 @@
     <string name="download_wizard_diagnostics_last_apdu_exception">Last APDU exception:</string>
     <string name="download_wizard_diagnostics_save">Save</string>
     <string name="download_wizard_diagnostics_file_template">Diagnostics at %s</string>
+    <string name="download_wizard_error_iccid_already">This eSIM profile is already present on your eSIM chip.</string>
+    <string name="download_wizard_error_insufficient_memory">Your eSIM chip does not have sufficient memory left to download the profile.</string>
+    <string name="download_wizard_error_unsupported_profile">This eSIM profile is unsupported by your eSIM chip.</string>
+    <string name="download_wizard_error_card_internal_error">An error occurred in your eSIM chip.</string>
+    <string name="download_wizard_error_eid_not_supported">The EID of your device or eSIM chip is unsupported by your carrier.</string>
+    <string name="download_wizard_error_eid_mismatch">This eSIM profile has been downloaded on another device.</string>
+    <string name="download_wizard_error_profile_unreleased">This eSIM profile has been revoked.</string>
+    <string name="download_wizard_error_matching_id_refused">The activation code is invalid.</string>
+    <string name="download_wizard_error_profile_retries_exceeded">The maximum number of download attempts for the eSIM profile has been exceeded.</string>
+    <string name="download_wizard_error_confirmation_code_missing">Confirmation code is required to download this profile.</string>
+    <string name="download_wizard_error_confirmation_code_refused">The confirmation code you entered is invalid.</string>
+    <string name="download_wizard_error_profile_expired">This eSIM profile has expired.</string>
+    <string name="download_wizard_error_confirmation_code_retries_exceeded">The maximum number of download attempts for the confirmation code has been exceeded.</string>
+    <string name="download_wizard_error_unknown_hostname">Unknown SM-DP+ address</string>
+    <string name="download_wizard_error_network_unreachable">Network is unreachable</string>
+    <string name="download_wizard_error_tls_certificate">TLS certificate error, this eSIM profile is not supported</string>
+    <string name="download_wizard_error_suggest_profile_installed">You are trying to reinstall an already downloaded eSIM profile</string>
+    <string name="download_wizard_error_suggest_insufficient_memory">Please delete some unused eSIM profiles and try again</string>
+    <string name="download_wizard_error_suggest_contact_carrier">Please contact your carrier for assistance.</string>
+    <string name="download_wizard_error_suggest_contact_reissue">Please contact your carrier to reissue this eSIM profile.</string>
+    <string name="download_wizard_error_suggest_network_unreachable">Please try again after connecting to a different network (e.g. switching between Wi-Fi and data).</string>
 
     <string name="logs_saved_message">Logs have been saved to the selected path. Would you like to share the log through another app?</string>
 

From 7bae82daf9104c5682566cdeaf0dafb1cab58f4f Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Sun, 7 Sep 2025 21:28:05 +0200
Subject: [PATCH 446/458] chore: add nvram hint (#223)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/223
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt  | 8 +++++++-
 app-common/src/main/res/values-zh-rCN/strings.xml         | 1 +
 app-common/src/main/res/values/strings.xml                | 1 +
 3 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
index bfbcbd872..248afaf54 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/EuiccInfoActivity.kt
@@ -123,7 +123,13 @@ class EuiccInfoActivity : BaseEuiccAccessActivity(), OpenEuiccContextMarker {
             add(Item(R.string.euicc_info_pp_version, info.ppVersion.toString()))
             info.sasAccreditationNumber.trim().takeIf(RE_SAS::matches)
                 ?.let { add(Item(R.string.euicc_info_sas_accreditation_number, it.uppercase())) }
-            add(Item(R.string.euicc_info_free_nvram, info.freeNvram.let(::formatFreeSpace)))
+
+            val nvramText = buildString {
+                append(formatFreeSpace(info.freeNvram))
+                append(' ')
+                append(getString(R.string.euicc_info_free_nvram_hint))
+            }
+            add(Item(R.string.euicc_info_free_nvram, nvramText))
         }
         channel.lpa.euiccInfo2?.euiccCiPKIdListForSigning.orEmpty().let { signers ->
             // SGP.28 v1.0, eSIM CI Registration Criteria (Page 5 of 9, 2019-10-24)
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index e947c6a89..3865e7173 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -136,6 +136,7 @@
     <string name="euicc_info_sas_accreditation_number">SAS 认证号码</string>
     <string name="euicc_info_pp_version">Protected Profile 版本</string>
     <string name="euicc_info_free_nvram">NVRAM 剩余空间 (eSIM 存储容量)</string>
+    <string name="euicc_info_free_nvram_hint">（仅供参考）</string>
     <string name="euicc_info_ci_type">证书签发者 (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA 生产环境 CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA 测试 CI</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 3a9dda366..7d0898a9c 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -165,6 +165,7 @@
     <string name="euicc_info_sas_accreditation_number">SAS Accreditation Number</string>
     <string name="euicc_info_pp_version">Protected Profile Version</string>
     <string name="euicc_info_free_nvram">Free NVRAM (eSIM profile storage)</string>
+    <string name="euicc_info_free_nvram_hint">(for reference only)</string>
     <string name="euicc_info_ci_type">Certificate Issuer (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA Live CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA Test CI</string>

From acfeda8dc9ff251cce5511b6946541add6949999 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 7 Sep 2025 17:45:18 -0400
Subject: [PATCH 447/458] i18n: Translate new strings added recently

---
 app-common/src/main/res/values-ja/strings.xml | 24 +++++++++++++++++++
 .../src/main/res/values-zh-rCN/strings.xml    | 23 ++++++++++++++++++
 .../src/main/res/values-zh-rTW/strings.xml    | 24 +++++++++++++++++++
 app-common/src/main/res/values/strings.xml    |  2 +-
 4 files changed, 72 insertions(+), 1 deletion(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index 946625fa5..da9d7085b 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -6,6 +6,7 @@
     <string name="euicc_info_unavailable">情報がありません</string>
     <string name="notification_help">ヘルプ</string>
     <string name="profile_reload_slots">スロットを再読み込み</string>
+    <string name="profile_no_enabled_profile">未知</string>
     <string name="channel_name_format">論理スロット %d</string>
     <string name="profile_state_enabled">有効済み</string>
     <string name="profile_state_disabled">無効済み</string>
@@ -83,6 +84,7 @@
     <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
     <string name="download_wizard_diagnostics_save">保存</string>
     <string name="download_wizard_diagnostics_file_template">「%s」での診断</string>
+    <string name="download_wizard_error_suggest_network_unreachable">別のネットワークに接続し（例：Wi-Fi とデータを切り替える）、もう一度お試しください。</string>
     <string name="logs_saved_message">ログは共有したパスに保存されました。別のアプリで共有しますか？</string>
     <string name="profile_rename_new_name">新しいニックネーム</string>
     <string name="profile_rename_encoding_error">ニックネームを UTF-8 にエンコードできませんでした</string>
@@ -114,6 +116,7 @@
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
     <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
+    <string name="euicc_info_free_nvram_hint">（目安）</string>
     <string name="euicc_info_ci_type">証明書発行者 (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA ライブ CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA テスト CI</string>
@@ -150,6 +153,7 @@
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
     <string name="pref_developer_ignore_tls_certificate_desc">RSP サーバーで使用される TLS 証明書を受け入れます</string>
     <string name="pref_developer_isdr_aid_list_desc">一部のブランドの取り外し可能な eUICC では、独自の非標準 ISD-R AID が使用されている場合があり、サードパーティ アプリからアクセスできなくなります。アプリはこのリストに追加された非標準の AID の使用を試みる可能性がありますが、動作することは保証されません。</string>
+    <string name="pref_developer_es10x_mss_desc">グローバル ES10x MSS</string>
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
@@ -169,4 +173,24 @@
     <string name="pref_developer_isdr_aid_list">ISD-R AID リストのカスタマイズ</string>
     <string name="isdr_aid_list_restore_defaults">リセット</string>
     <string name="isdr_aid_list">ISD-R AID リスト</string>
+    <string name="download_wizard_error_iccid_already">この eSIM プロファイルはすでに eSIM チップに存在しています。</string>
+    <string name="download_wizard_error_insufficient_memory">eSIM チップには十分なメモリ容量が残っていません。</string>
+    <string name="download_wizard_error_unsupported_profile">この eSIM プロファイルは、ダウンロード先のeSIM チップではサポートされていません。</string>
+    <string name="download_wizard_error_card_internal_error">eSIMチップでエラーが発生しました。</string>
+    <string name="download_wizard_error_eid_not_supported">お使いのデバイスまたは eSIM チップの EID は、通信事業者によってサポートされていません。</string>
+    <string name="download_wizard_error_eid_mismatch">この eSIM プロファイルはすでに別のデバイスにダウンロードされています。</string>
+    <string name="download_wizard_error_profile_unreleased">この eSIM プロファイルはキャンセルされました。</string>
+    <string name="download_wizard_error_matching_id_refused">アクティベーションコードが無効です。</string>
+    <string name="download_wizard_error_profile_retries_exceeded">eSIM プロファイルのダウンロード試行回数の上限を超えました。</string>
+    <string name="download_wizard_error_confirmation_code_missing">このプロファイルをダウンロードするには確認コードが必要です。</string>
+    <string name="download_wizard_error_confirmation_code_refused">入力した確認コードは無効です。</string>
+    <string name="download_wizard_error_profile_expired">この eSIM プロファイルの有効期限が切れています。</string>
+    <string name="download_wizard_error_confirmation_code_retries_exceeded">確認コードのダウンロード試行回数の上限を超えました。</string>
+    <string name="download_wizard_error_unknown_hostname">不明なSM-DP+アドレス</string>
+    <string name="download_wizard_error_network_unreachable">ネットワークにアクセスできません</string>
+    <string name="download_wizard_error_tls_certificate">TLS証明書エラー。このeSIMプロファイルはサポートされていません</string>
+    <string name="download_wizard_error_suggest_profile_installed">すでにダウンロードしたeSIMプロファイルを再インストールしようとしています</string>
+    <string name="download_wizard_error_suggest_insufficient_memory">不要なeSIMプロファイルをいくつか削除して、もう一度お試しください</string>
+    <string name="download_wizard_error_suggest_contact_carrier">通信事業者にお問い合わせください。</string>
+    <string name="download_wizard_error_suggest_contact_reissue">この eSIM プロファイルを再発行するには、通信事業者にお問い合わせください。</string>
 </resources>
diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 3865e7173..4457e6d9e 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -5,6 +5,7 @@
     <string name="euicc_info_unknown">未知</string>
     <string name="notification_help">帮助</string>
     <string name="profile_reload_slots">重新加载卡槽</string>
+    <string name="profile_no_enabled_profile">未知</string>
     <string name="channel_name_format">逻辑卡槽 %d</string>
     <string name="profile_state_enabled">已启用</string>
     <string name="profile_state_disabled">已禁用</string>
@@ -46,6 +47,7 @@
     <string name="profile_download_imei">IMEI (可选)</string>
     <string name="profile_download_low_nvram_title">剩余空间不足</string>
     <string name="profile_download_low_nvram_message">当前芯片的剩余空间不足，可能导致配置下载失败。\n是否继续下载？</string>
+    <string name="download_wizard_error_suggest_network_unreachable">请连接到其他网络（例如在 Wi-Fi 和数据之间切换）后重试。</string>
     <string name="logs_saved_message">日志已保存到指定路径。需要通过其他 App 分享吗？</string>
     <string name="profile_rename_new_name">新昵称</string>
     <string name="profile_rename_encoding_error">无法将昵称编码为 UTF-8</string>
@@ -83,6 +85,7 @@
     <string name="pref_advanced_logs">日志</string>
     <string name="pref_advanced_logs_desc">查看应用程序的最新调试日志</string>
     <string name="pref_developer_isdr_aid_list_desc">某些品牌的可移除 eUICC 可能会使用自己的非标准 ISD-R AID，导致第三方应用无法访问。此 App 可以尝试使用此列表中添加的非标准 AID，但不能保证它们一定有效。</string>
+    <string name="pref_developer_es10x_mss_desc">全局 ES10x MSS</string>
     <string name="pref_info">信息</string>
     <string name="pref_info_app_version">App 版本</string>
     <string name="pref_info_source_code">源码</string>
@@ -170,4 +173,24 @@
     <string name="pref_developer_isdr_aid_list">自定义 ISD-R AID 列表</string>
     <string name="isdr_aid_list_restore_defaults">重置</string>
     <string name="isdr_aid_list">ISD-R AID 列表</string>
+    <string name="download_wizard_error_iccid_already">此 eSIM 配置文件已存在于您的 eSIM 芯片上。</string>
+    <string name="download_wizard_error_insufficient_memory">您的 eSIM 芯片没有足够的空间来下载配置文件。</string>
+    <string name="download_wizard_error_unsupported_profile">您的 eSIM 芯片不支持此 eSIM 配置文件。</string>
+    <string name="download_wizard_error_card_internal_error">eSIM 芯片错误。</string>
+    <string name="download_wizard_error_eid_not_supported">您的设备或 eSIM 芯片的 EID 不受您的运营商支持。</string>
+    <string name="download_wizard_error_eid_mismatch">此 eSIM 配置文件已被下载到另一台设备上。</string>
+    <string name="download_wizard_error_profile_unreleased">此 eSIM 配置文件已被撤销。</string>
+    <string name="download_wizard_error_matching_id_refused">激活码无效。</string>
+    <string name="download_wizard_error_profile_retries_exceeded">已超出 eSIM 配置文件的最大下载尝试次数。</string>
+    <string name="download_wizard_error_confirmation_code_missing">下载此配置文件需要确认码。</string>
+    <string name="download_wizard_error_confirmation_code_refused">您输入的确认码无效。</string>
+    <string name="download_wizard_error_profile_expired">此 eSIM 配置文件已过期。</string>
+    <string name="download_wizard_error_confirmation_code_retries_exceeded">已超出确认码的最大下载尝试次数。</string>
+    <string name="download_wizard_error_unknown_hostname">未知的 SM-DP+ 地址</string>
+    <string name="download_wizard_error_network_unreachable">网络不可达</string>
+    <string name="download_wizard_error_tls_certificate">TLS 证书错误，不支持此 eSIM 配置文件</string>
+    <string name="download_wizard_error_suggest_profile_installed">您正在尝试重新安装已下载的 eSIM 配置文件</string>
+    <string name="download_wizard_error_suggest_insufficient_memory">请删除一些未使用的 eSIM 配置文件，然后重试</string>
+    <string name="download_wizard_error_suggest_contact_carrier">请联系您的运营商寻求帮助。</string>
+    <string name="download_wizard_error_suggest_contact_reissue">请联系您的运营商重新签发此 eSIM 配置文件。</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values-zh-rTW/strings.xml b/app-common/src/main/res/values-zh-rTW/strings.xml
index 88cc0118d..ef6c842bc 100644
--- a/app-common/src/main/res/values-zh-rTW/strings.xml
+++ b/app-common/src/main/res/values-zh-rTW/strings.xml
@@ -5,6 +5,7 @@
     <string name="euicc_info_unknown">未知</string>
     <string name="notification_help">幫助</string>
     <string name="profile_reload_slots">重新載入卡槽</string>
+    <string name="profile_no_enabled_profile">未知</string>
     <string name="channel_name_format">虛擬卡槽 %d</string>
     <string name="profile_state_enabled">已啟用</string>
     <string name="profile_state_disabled">已停用</string>
@@ -46,6 +47,7 @@
     <string name="profile_download_imei">IMEI (可選)</string>
     <string name="profile_download_low_nvram_title">剩餘空間不足</string>
     <string name="profile_download_low_nvram_message">目前晶片的剩餘空間不足，可能導致配置下載失敗。\n是否繼續下載？</string>
+    <string name="download_wizard_error_suggest_network_unreachable">請連接到其他網路（例如在 Wi-Fi 和資料之間切換）後重試。</string>
     <string name="logs_saved_message">日誌已儲存到指定路徑。需要透過其他 App 分享嗎？</string>
     <string name="profile_rename_new_name">新名稱</string>
     <string name="profile_rename_encoding_error">無法將名稱編碼為 UTF-8</string>
@@ -83,6 +85,7 @@
     <string name="pref_advanced_disable_safeguard_removable_esim">允許 停用/刪除 已啟用的設定檔</string>
     <string name="pref_advanced_disable_safeguard_removable_esim_desc">預設情況下，此應用程式會阻止您停用可插拔 eSIM 中已啟用的設定檔。\n因為這樣做 <i>有時</i> 會導致無法存取。\n勾選此框以 <i>移除</i> 此保護措施。</string>
     <string name="pref_developer_isdr_aid_list_desc">某些品牌的可移除 eUICC 可能會使用自己的非標準 ISD-R AID，導致第三方應用程式無法存取。此 App 可以嘗試使用此清單中新增的非標準 AID，但不能保證它們一定有效。</string>
+    <string name="pref_developer_es10x_mss_desc">全局 ES10x MSS</string>
     <string name="pref_info">資訊</string>
     <string name="pref_info_app_version">App 版本</string>
     <string name="pref_info_source_code">原始碼</string>
@@ -136,6 +139,7 @@
     <string name="euicc_info_sas_accreditation_number">SAS 認證號碼</string>
     <string name="euicc_info_pp_version">Protected Profile 版本</string>
     <string name="euicc_info_free_nvram">NVRAM 剩餘空間 (eSIM 儲存容量)</string>
+    <string name="euicc_info_free_nvram_hint">（僅供參考）</string>
     <string name="euicc_info_ci_type">證書簽發者 (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA 生產環境 CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA 測試 CI</string>
@@ -169,4 +173,24 @@
     <string name="pref_developer_isdr_aid_list">自訂 ISD-R AID 列表</string>
     <string name="isdr_aid_list_restore_defaults">重置</string>
     <string name="isdr_aid_list">ISD-R AID 列表</string>
+    <string name="download_wizard_error_iccid_already">此 eSIM 設定檔已存在於您的 eSIM 晶片上。</string>
+    <string name="download_wizard_error_insufficient_memory">您的 eSIM 晶片沒有足夠的空間來下載設定檔。</string>
+    <string name="download_wizard_error_unsupported_profile">您的 eSIM 晶片不支援此 eSIM 設定檔。</string>
+    <string name="download_wizard_error_card_internal_error">eSIM 晶片錯誤。</string>
+    <string name="download_wizard_error_eid_not_supported">您的裝置或 eSIM 晶片的 EID 不受您的電信業者支援。</string>
+    <string name="download_wizard_error_eid_mismatch">此 eSIM 設定檔已被下載到另一台裝置上。</string>
+    <string name="download_wizard_error_profile_unreleased">此 eSIM 設定檔已被撤銷。</string>
+    <string name="download_wizard_error_matching_id_refused">啟用碼無效。</string>
+    <string name="download_wizard_error_profile_retries_exceeded">已超出 eSIM 設定檔的最大下載嘗試次數。</string>
+    <string name="download_wizard_error_confirmation_code_missing">下載此設定檔需要確認碼。</string>
+    <string name="download_wizard_error_confirmation_code_refused">您輸入的確認碼無效。</string>
+    <string name="download_wizard_error_profile_expired">此 eSIM 設定檔已過期。</string>
+    <string name="download_wizard_error_confirmation_code_retries_exceeded">已超出確認碼的最大下載嘗試次數。</string>
+    <string name="download_wizard_error_unknown_hostname">未知的 SM-DP+ 位址</string>
+    <string name="download_wizard_error_network_unreachable">網路不可達</string>
+    <string name="download_wizard_error_tls_certificate">TLS 憑證錯誤，不支援此 eSIM 設定檔</string>
+    <string name="download_wizard_error_suggest_profile_installed">您正在嘗試重新安裝已下載的 eSIM 設定文件</string>
+    <string name="download_wizard_error_suggest_insufficient_memory">請刪除一些未使用的 eSIM 設定文件，然後重試</string>
+    <string name="download_wizard_error_suggest_contact_carrier">請聯絡您的電信業者尋求協助。</string>
+    <string name="download_wizard_error_suggest_contact_reissue">請聯絡您的電信業者重新簽發此 eSIM 設定檔。</string>
 </resources>
\ No newline at end of file
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index 7d0898a9c..a7f2c10e1 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -222,7 +222,7 @@
     <string name="pref_developer_ignore_tls_certificate_desc">Accept any TLS certificate used by the RSP server</string>
     <string name="pref_developer_euicc_memory_reset">Allow erasing eUICC</string>
     <string name="pref_developer_euicc_memory_reset_desc">This is a dangerous operation and hidden by default. As an alternative, you can delete all profiles manually.</string>
-    <string name="pref_developer_es10x_mss">ES10x MSS</string>
+    <string name="pref_developer_es10x_mss" translatable="false">ES10x MSS</string>
     <string name="pref_developer_es10x_mss_desc">Global ES10x MSS</string>
     <string-array name="pref_developer_es10x_entry_keys">
         <item>High Speed</item>

From 0c98121c2aa844f1aff8d438193f9afc1849d110 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 8 Sep 2025 15:11:40 +0200
Subject: [PATCH 448/458] chore: ignore new file in dot-idea directory (#227)

![CleanShot 2025-09-08 at 15.51.35@2x](/attachments/8133796b-eebf-4162-b6c4-f66d9217b48d)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/227
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .idea/.gitignore | 21 +++++++--------------
 1 file changed, 7 insertions(+), 14 deletions(-)

diff --git a/.idea/.gitignore b/.idea/.gitignore
index 2e1299539..d2293f69b 100644
--- a/.idea/.gitignore
+++ b/.idea/.gitignore
@@ -1,14 +1,7 @@
-/shelf
-/caches
-/libraries
-/assetWizardSettings.xml
-/deploymentTarget*.xml
-/gradle.xml
-/misc.xml
-/modules.xml
-/navEditor.xml
-/runConfigurations.xml
-/workspace.xml
-/AndroidProjectSystem.xml
-
-**/*.iml
\ No newline at end of file
+*
+!/codeStyles/Project.xml
+!/codeStyles/codeStyleConfig.xml
+!/vcs.xml
+!/kotlinc.xml
+!/compiler.xml
+!/migrations.xml

From 472f9d05ac5470a28bb80fee725eb87711905ca6 Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 8 Sep 2025 15:12:26 +0200
Subject: [PATCH 449/458] chore: simplify progress item initialization and
 error message handling (#226)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/226
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 .../wizard/DownloadWizardProgressFragment.kt  | 53 ++++++-------------
 1 file changed, 16 insertions(+), 37 deletions(-)

diff --git a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
index 29e87b092..0048190b2 100644
--- a/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
+++ b/app-common/src/main/java/im/angry/openeuicc/ui/wizard/DownloadWizardProgressFragment.kt
@@ -7,6 +7,7 @@ import android.view.ViewGroup
 import android.widget.ImageView
 import android.widget.ProgressBar
 import android.widget.TextView
+import androidx.annotation.StringRes
 import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.DividerItemDecoration
 import androidx.recyclerview.widget.LinearLayoutManager
@@ -42,37 +43,17 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
     }
 
     private data class ProgressItem(
-        val titleRes: Int,
-        var state: ProgressState,
-        var errorMessage: SimplifiedErrorMessages?,
+        @StringRes val titleRes: Int,
+        var state: ProgressState = ProgressState.NotStarted,
+        var errorMessage: SimplifiedErrorMessages? = null,
     )
 
     private val progressItems = arrayOf(
-        ProgressItem(
-            R.string.download_wizard_progress_step_preparing,
-            ProgressState.NotStarted,
-            null
-        ),
-        ProgressItem(
-            R.string.download_wizard_progress_step_connecting,
-            ProgressState.NotStarted,
-            null
-        ),
-        ProgressItem(
-            R.string.download_wizard_progress_step_authenticating,
-            ProgressState.NotStarted,
-            null
-        ),
-        ProgressItem(
-            R.string.download_wizard_progress_step_downloading,
-            ProgressState.NotStarted,
-            null
-        ),
-        ProgressItem(
-            R.string.download_wizard_progress_step_finalizing,
-            ProgressState.NotStarted,
-            null
-        )
+        ProgressItem(R.string.download_wizard_progress_step_preparing),
+        ProgressItem(R.string.download_wizard_progress_step_connecting),
+        ProgressItem(R.string.download_wizard_progress_step_authenticating),
+        ProgressItem(R.string.download_wizard_progress_step_downloading),
+        ProgressItem(R.string.download_wizard_progress_step_finalizing)
     )
 
     private val adapter = ProgressItemAdapter()
@@ -156,9 +137,8 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                         refreshButtons()
                     }
 
-                    is EuiccChannelManagerService.ForegroundTaskState.InProgress -> {
+                    is EuiccChannelManagerService.ForegroundTaskState.InProgress ->
                         updateProgress(it.progress)
-                    }
 
                     else -> {}
                 }
@@ -252,14 +232,13 @@ class DownloadWizardProgressFragment : DownloadWizardActivity.DownloadWizardStep
                     icon.setImageResource(R.drawable.ic_error_outline)
                     icon.visibility = View.VISIBLE
 
-                    if (item.errorMessage != null) {
+                    item.errorMessage?.titleResId?.let {
                         errorTitle.visibility = View.VISIBLE
-                        errorTitle.text = getString(item.errorMessage!!.titleResId)
-
-                        if (item.errorMessage!!.suggestResId != null) {
-                            errorSuggestion.visibility = View.VISIBLE
-                            errorSuggestion.text = getString(item.errorMessage!!.suggestResId!!)
-                        }
+                        errorTitle.text = getString(it)
+                    }
+                    item.errorMessage?.suggestResId?.let {
+                        errorSuggestion.visibility = View.VISIBLE
+                        errorSuggestion.text = getString(it)
                     }
                 }
             }

From d46461bd2d8b27146c109a64895ede69a0b43773 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 8 Sep 2025 21:47:13 -0400
Subject: [PATCH 450/458] lpac-jni: Prevent potential C-side memory leak

---
 .../impl/LocalProfileAssistantImpl.kt         | 116 ++++++++++--------
 1 file changed, 65 insertions(+), 51 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 3674f4f19..90e20aa17 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -16,7 +16,7 @@ class LocalProfileAssistantImpl(
     isdrAid: ByteArray,
     rawApduInterface: ApduInterface,
     rawHttpInterface: HttpInterface
-): LocalProfileAssistant {
+) : LocalProfileAssistant {
     companion object {
         private const val TAG = "LocalProfileAssistantImpl"
     }
@@ -113,15 +113,17 @@ class LocalProfileAssistantImpl(
             while (curr != 0L) {
                 val state = LocalProfileInfo.State.fromString(LpacJni.profileGetStateString(curr))
                 val clazz = LocalProfileInfo.Clazz.fromString(LpacJni.profileGetClassString(curr))
-                ret.add(LocalProfileInfo(
-                    LpacJni.profileGetIccid(curr),
-                    state,
-                    LpacJni.profileGetName(curr),
-                    LpacJni.profileGetNickname(curr),
-                    LpacJni.profileGetServiceProvider(curr),
-                    LpacJni.profileGetIsdpAid(curr),
-                    clazz
-                ))
+                ret.add(
+                    LocalProfileInfo(
+                        LpacJni.profileGetIccid(curr),
+                        state,
+                        LpacJni.profileGetName(curr),
+                        LpacJni.profileGetNickname(curr),
+                        LpacJni.profileGetServiceProvider(curr),
+                        LpacJni.profileGetIsdpAid(curr),
+                        clazz
+                    )
+                )
                 curr = LpacJni.profilesNext(curr)
             }
 
@@ -134,18 +136,28 @@ class LocalProfileAssistantImpl(
         get() {
             val head = LpacJni.es10bListNotification(contextHandle)
             var curr = head
-            val ret = mutableListOf<LocalProfileNotification>()
-            while (curr != 0L) {
-                ret.add(LocalProfileNotification(
-                    LpacJni.notificationGetSeq(curr),
-                    LocalProfileNotification.Operation.fromString(LpacJni.notificationGetOperationString(curr)),
-                    LpacJni.notificationGetAddress(curr),
-                    LpacJni.notificationGetIccid(curr),
-                ))
-                curr = LpacJni.notificationsNext(curr)
+
+            try {
+                val ret = mutableListOf<LocalProfileNotification>()
+                while (curr != 0L) {
+                    ret.add(
+                        LocalProfileNotification(
+                            LpacJni.notificationGetSeq(curr),
+                            LocalProfileNotification.Operation.fromString(
+                                LpacJni.notificationGetOperationString(
+                                    curr
+                                )
+                            ),
+                            LpacJni.notificationGetAddress(curr),
+                            LpacJni.notificationGetIccid(curr),
+                        )
+                    )
+                    curr = LpacJni.notificationsNext(curr)
+                }
+                return ret.sortedBy { it.seqNumber }.reversed()
+            } finally {
+                LpacJni.notificationsFree(head)
             }
-            LpacJni.notificationsFree(head)
-            return ret.sortedBy { it.seqNumber }.reversed()
         }
 
     override val eID: String
@@ -158,34 +170,34 @@ class LocalProfileAssistantImpl(
             val cInfo = LpacJni.es10cexGetEuiccInfo2(contextHandle)
             if (cInfo == 0L) return null
 
-            val ret = EuiccInfo2(
-                Version(LpacJni.euiccInfo2GetSGP22Version(cInfo)),
-                Version(LpacJni.euiccInfo2GetProfileVersion(cInfo)),
-                Version(LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo)),
-                Version(LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo)),
-                LpacJni.euiccInfo2GetSasAcreditationNumber(cInfo),
-                Version(LpacJni.euiccInfo2GetPpVersion(cInfo)),
-                LpacJni.euiccInfo2GetFreeNonVolatileMemory(cInfo).toInt(),
-                LpacJni.euiccInfo2GetFreeVolatileMemory(cInfo).toInt(),
-                buildSet {
-                    var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForSigning(cInfo)
-                    while (cursor != 0L) {
-                        add(LpacJni.stringDeref(cursor))
-                        cursor = LpacJni.stringArrNext(cursor)
-                    }
-                },
-                buildSet {
-                    var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForVerification(cInfo)
-                    while (cursor != 0L) {
-                        add(LpacJni.stringDeref(cursor))
-                        cursor = LpacJni.stringArrNext(cursor)
-                    }
-                },
-            )
-
-            LpacJni.euiccInfo2Free(cInfo)
-
-            return ret
+            try {
+                return EuiccInfo2(
+                    Version(LpacJni.euiccInfo2GetSGP22Version(cInfo)),
+                    Version(LpacJni.euiccInfo2GetProfileVersion(cInfo)),
+                    Version(LpacJni.euiccInfo2GetEuiccFirmwareVersion(cInfo)),
+                    Version(LpacJni.euiccInfo2GetGlobalPlatformVersion(cInfo)),
+                    LpacJni.euiccInfo2GetSasAcreditationNumber(cInfo),
+                    Version(LpacJni.euiccInfo2GetPpVersion(cInfo)),
+                    LpacJni.euiccInfo2GetFreeNonVolatileMemory(cInfo).toInt(),
+                    LpacJni.euiccInfo2GetFreeVolatileMemory(cInfo).toInt(),
+                    buildSet {
+                        var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForSigning(cInfo)
+                        while (cursor != 0L) {
+                            add(LpacJni.stringDeref(cursor))
+                            cursor = LpacJni.stringArrNext(cursor)
+                        }
+                    },
+                    buildSet {
+                        var cursor = LpacJni.euiccInfo2GetEuiccCiPKIdListForVerification(cInfo)
+                        while (cursor != 0L) {
+                            add(LpacJni.stringDeref(cursor))
+                            cursor = LpacJni.stringArrNext(cursor)
+                        }
+                    },
+                )
+            } finally {
+                LpacJni.euiccInfo2Free(cInfo)
+            }
         }
 
     @Synchronized
@@ -201,8 +213,10 @@ class LocalProfileAssistantImpl(
         LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
 
     @Synchronized
-    override fun downloadProfile(smdp: String, matchingId: String?, imei: String?,
-                                 confirmationCode: String?, callback: ProfileDownloadCallback) {
+    override fun downloadProfile(
+        smdp: String, matchingId: String?, imei: String?,
+        confirmationCode: String?, callback: ProfileDownloadCallback
+    ) {
         val res = LpacJni.downloadProfile(
             contextHandle,
             smdp,

From 7db1c1ea9d3f313c15637de4b2c1f0b07b09b4fa Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 8 Sep 2025 21:48:41 -0400
Subject: [PATCH 451/458] lpac-jni: Add missing synchronized annotation

---
 .../java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 90e20aa17..21f2f4e1f 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -272,6 +272,7 @@ class LocalProfileAssistantImpl(
         }
     }
 
+    @Synchronized
     override fun euiccMemoryReset() {
         LpacJni.es10cEuiccMemoryReset(contextHandle)
     }

From 2cda633fd095666e0d4862bc457c6cafe78d7024 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Mon, 8 Sep 2025 21:58:53 -0400
Subject: [PATCH 452/458] lpac-jni: Convert all @Synchronized usage to a
 ReentrantLock

---
 .../impl/LocalProfileAssistantImpl.kt         | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
index 21f2f4e1f..ce097176d 100644
--- a/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
+++ b/libs/lpac-jni/src/main/java/net/typeblog/lpac_jni/impl/LocalProfileAssistantImpl.kt
@@ -11,6 +11,8 @@ import net.typeblog.lpac_jni.LocalProfileInfo
 import net.typeblog.lpac_jni.LocalProfileNotification
 import net.typeblog.lpac_jni.ProfileDownloadCallback
 import net.typeblog.lpac_jni.Version
+import java.util.concurrent.locks.ReentrantLock
+import kotlin.concurrent.withLock
 
 class LocalProfileAssistantImpl(
     isdrAid: ByteArray,
@@ -74,6 +76,10 @@ class LocalProfileAssistantImpl(
             }
     }
 
+    // Controls concurrency of every single method in this class, since
+    // the C-side is explicitly NOT thread-safe
+    private val lock = ReentrantLock()
+
     private val apduInterface = ApduInterfaceWrapper(rawApduInterface)
     private val httpInterface = HttpInterfaceWrapper(rawHttpInterface)
 
@@ -105,8 +111,7 @@ class LocalProfileAssistantImpl(
         }
 
     override val profiles: List<LocalProfileInfo>
-        @Synchronized
-        get() {
+        get() = lock.withLock {
             val head = LpacJni.es10cGetProfilesInfo(contextHandle)
             var curr = head
             val ret = mutableListOf<LocalProfileInfo>()
@@ -132,8 +137,7 @@ class LocalProfileAssistantImpl(
         }
 
     override val notifications: List<LocalProfileNotification>
-        @Synchronized
-        get() {
+        get() = lock.withLock {
             val head = LpacJni.es10bListNotification(contextHandle)
             var curr = head
 
@@ -161,12 +165,10 @@ class LocalProfileAssistantImpl(
         }
 
     override val eID: String
-        @Synchronized
-        get() = LpacJni.es10cGetEid(contextHandle)!!
+        get() = lock.withLock { LpacJni.es10cGetEid(contextHandle)!! }
 
     override val euiccInfo2: EuiccInfo2?
-        @Synchronized
-        get() {
+        get() = lock.withLock {
             val cInfo = LpacJni.es10cexGetEuiccInfo2(contextHandle)
             if (cInfo == 0L) return null
 
@@ -200,23 +202,22 @@ class LocalProfileAssistantImpl(
             }
         }
 
-    @Synchronized
-    override fun enableProfile(iccid: String, refresh: Boolean): Boolean =
+    override fun enableProfile(iccid: String, refresh: Boolean): Boolean = lock.withLock {
         LpacJni.es10cEnableProfile(contextHandle, iccid, refresh) == 0
+    }
 
-    @Synchronized
-    override fun disableProfile(iccid: String, refresh: Boolean): Boolean =
+    override fun disableProfile(iccid: String, refresh: Boolean): Boolean = lock.withLock {
         LpacJni.es10cDisableProfile(contextHandle, iccid, refresh) == 0
+    }
 
-    @Synchronized
-    override fun deleteProfile(iccid: String): Boolean =
+    override fun deleteProfile(iccid: String): Boolean = lock.withLock {
         LpacJni.es10cDeleteProfile(contextHandle, iccid) == 0
+    }
 
-    @Synchronized
     override fun downloadProfile(
         smdp: String, matchingId: String?, imei: String?,
         confirmationCode: String?, callback: ProfileDownloadCallback
-    ) {
+    ) = lock.withLock {
         val res = LpacJni.downloadProfile(
             contextHandle,
             smdp,
@@ -243,18 +244,17 @@ class LocalProfileAssistantImpl(
         }
     }
 
-    @Synchronized
-    override fun deleteNotification(seqNumber: Long): Boolean =
+    override fun deleteNotification(seqNumber: Long): Boolean = lock.withLock {
         LpacJni.es10bDeleteNotification(contextHandle, seqNumber) == 0
+    }
 
-    @Synchronized
-    override fun handleNotification(seqNumber: Long): Boolean =
+    override fun handleNotification(seqNumber: Long): Boolean = lock.withLock {
         LpacJni.handleNotification(contextHandle, seqNumber).also {
             Log.d(TAG, "handleNotification $seqNumber = $it")
         } == 0
+    }
 
-    @Synchronized
-    override fun setNickname(iccid: String, nickname: String) {
+    override fun setNickname(iccid: String, nickname: String) = lock.withLock {
         val encoded = try {
             Charsets.UTF_8.encode(nickname).array()
         } catch (e: CharacterCodingException) {
@@ -272,13 +272,13 @@ class LocalProfileAssistantImpl(
         }
     }
 
-    @Synchronized
     override fun euiccMemoryReset() {
-        LpacJni.es10cEuiccMemoryReset(contextHandle)
+        lock.withLock {
+            LpacJni.es10cEuiccMemoryReset(contextHandle)
+        }
     }
 
-    @Synchronized
-    override fun close() {
+    override fun close() = lock.withLock {
         if (!finalized) {
             LpacJni.euiccFini(contextHandle)
             LpacJni.destroyContext(contextHandle)

From bf30f1478c01c32c0093bb75ac128c6f7eb20842 Mon Sep 17 00:00:00 2001
From: Peter Cai <peter@typeblog.net>
Date: Sun, 14 Sep 2025 14:48:32 -0400
Subject: [PATCH 453/458] Update README.md

---
 README.md | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index f953f9ea5..740478afb 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ There are two variants of this project, OpenEUICC and EasyEUICC:
 Some side notes:
 1. When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
 2. Both variants support accessing eUICC chips through USB CCID readers, regardless of whether the chip contains the correct ARA-M hash to allow for unprivileged access. However, only `T=0` readers that use the standard [USB CCID protocol](https://en.wikipedia.org/wiki/CCID_(protocol)) are supported.
-3. Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases). For OpenEUICC, no official release is currently provided and only debug mode APKs can be found in the CI page.
+3. Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases). For OpenEUICC, no official release is currently provided and only debug mode APKs and Magisk modules can be found in the [CI page](https://gitea.angry.im/PeterCxy/OpenEUICC/actions).
 4. For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`.
 
 __This project is Free Software licensed under GNU GPL v3, WITHOUT the "or later" clause.__ Any modification and derivative work __MUST__ be released under the SAME license, which means, at the very least, that the source code __MUST__ be available upon request.
@@ -74,10 +74,7 @@ FAQs
 ===
 
 - Q: Do you provide prebuilt binaries for OpenEUICC?
-- A: Debug-mode APKs are available continuously as an artifact of the [Actions](https://gitea.angry.im/PeterCxy/OpenEUICC/actions) CI used by this project. However, these debug-mode APKs are **not** intended for inclusion inside system images, nor are they supported by the developer in any sense. If you are a custom ROM developer, either include the entire OpenEUICC repository in your AOSP source tree, or generate an APK using `gradle` and import that as a prebuilt system app. Note that you might want `privapp_whitelist_im.angry.openeuicc.xml` as well.
-
-- Q: AOSP's Settings app seems to be confused by OpenEUICC (for example, disabling / enabling profiles from the Networks page do not work properly)
-- A: When your device has internal eSIM chip(s) __and__ you have inserted a removable eSIM chip, the Settings app can misbehave since it was never designed for this scenario. __Please prefer using OpenEUICC's own management interface whenever possible.__ In the future, there might be an option to exclude removable SIMs from being reported to the Android system.
+- A: Debug-mode APKs and Magisk modules are available continuously as an artifact of the [Actions](https://gitea.angry.im/PeterCxy/OpenEUICC/actions) CI used by this project. However, these debug-mode APKs are **not** intended for inclusion inside system images, nor are they supported by the developer in any sense. If you are a custom ROM developer, either include the entire OpenEUICC repository in your AOSP source tree, or generate an APK using `gradle` and import that as a prebuilt system app. Note that you might want `privapp_whitelist_im.angry.openeuicc.xml` as well.
 
 - Q: Can EasyEUICC manage my phone's internal eSIM?
 - A: No. For EasyEUICC to work, the eSIM chip MUST proactively grant access via its ARA-M field.

From 525212c1b8889f68b8772bb4c2291eff5a7c63b1 Mon Sep 17 00:00:00 2001
From: reindex <reindex@noreply.gitea.angry.im>
Date: Mon, 22 Sep 2025 00:49:57 +0200
Subject: [PATCH 454/458] Update Japanese Language (#229)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

日本語を更新しといたよ。
間違ったところも修正済み。

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/229
Co-authored-by: reindex <reindex@noreply.gitea.angry.im>
Co-committed-by: reindex <reindex@noreply.gitea.angry.im>
---
 app-common/src/main/res/values-ja/strings.xml | 108 +++++++++---------
 app-unpriv/src/main/res/values-ja/strings.xml |  19 +--
 app/src/main/res/values-ja/strings.xml        |   5 +-
 3 files changed, 70 insertions(+), 62 deletions(-)

diff --git a/app-common/src/main/res/values-ja/strings.xml b/app-common/src/main/res/values-ja/strings.xml
index da9d7085b..b17197276 100644
--- a/app-common/src/main/res/values-ja/strings.xml
+++ b/app-common/src/main/res/values-ja/strings.xml
@@ -2,14 +2,13 @@
 <resources>
     <string name="no_euicc">このアプリでアクセスできるリムーバブル eUICC カードがデバイス上で検出されていません。互換性のあるカード挿入または USB リーダーを接続してください。</string>
     <string name="no_profile">この eSIM にはプロファイルがありません。</string>
-    <string name="euicc_info_unknown">不明</string>
-    <string name="euicc_info_unavailable">情報がありません</string>
     <string name="notification_help">ヘルプ</string>
     <string name="profile_reload_slots">スロットを再読み込み</string>
-    <string name="profile_no_enabled_profile">未知</string>
+    <string name="profile_no_enabled_profile">不明</string>
     <string name="channel_name_format">論理スロット %d</string>
-    <string name="profile_state_enabled">有効済み</string>
-    <string name="profile_state_disabled">無効済み</string>
+    <!-- Profile -->
+    <string name="profile_state_enabled">有効化済み</string>
+    <string name="profile_state_disabled">無効化済み</string>
     <string name="profile_provider">プロバイダー:</string>
     <string name="profile_class">クラス:</string>
     <string name="profile_class_testing">テスト中</string>
@@ -23,6 +22,8 @@
     <string name="profile_switch_did_not_refresh">操作は成功しましたが、デバイスのモデムが更新を拒否しました。新しいプロファイルを使用するには機内モードに切り替えるか、再起動する必要があります。</string>
     <string name="toast_profile_enable_failed">新しい eSIM プロファイルに切り替えることができません。</string>
     <string name="toast_profile_delete_confirm_text_mismatched">確認文字列が一致しません</string>
+    <string name="toast_euicc_memory_reset_confirm_text_mismatched">確認文字列が一致しません</string>
+    <string name="toast_euicc_memory_reset_finitshed">このチップは消去されました</string>
     <string name="toast_iccid_copied">ICCID をクリップボードにコピーしました</string>
     <string name="toast_sn_copied">シリアル番号をクリップボードにコピーしました</string>
     <string name="toast_eid_copied">EID をクリップボードにコピーしました</string>
@@ -39,14 +40,16 @@
     <string name="task_profile_delete_failure">eSIM プロファイルの削除に失敗しました</string>
     <string name="task_profile_switch">eSIM プロファイルを切り替え中</string>
     <string name="task_profile_switch_failure">eSIM プロファイルの切り替えに失敗しました</string>
+    <string name="task_euicc_memory_reset">eSIM チップを消去中</string>
+    <string name="task_euicc_memory_reset_failure">eSIM チップの消去に失敗しました</string>
     <string name="profile_download">新しい eSIM</string>
     <string name="profile_download_server">サーバー (RSP / SM-DP+)</string>
     <string name="profile_download_code">アクティベーションコード</string>
     <string name="profile_download_confirmation_code">確認コード (オプション)</string>
     <string name="profile_download_confirmation_code_required">確認コード (必須)</string>
     <string name="profile_download_imei">IMEI (オプション)</string>
-    <string name="profile_download_low_nvram_title">残り容量が少ない</string>
-    <string name="profile_download_low_nvram_message">残り容量が少ないため、ダウンロードに失敗する可能性があります。</string>
+    <string name="profile_download_low_nvram_title">残りの容量が少量です</string>
+    <string name="profile_download_low_nvram_message">残り容量が少ないため、このプロファイルのダウンロードに失敗する可能性があります。</string>
     <string name="profile_download_no_lpa_string">クリップボードに LPA コードがありません</string>
     <string name="profile_download_incorrect_lpa_string">解析できません</string>
     <string name="profile_download_incorrect_lpa_string_message">QR コードまたはクリップボードの内容を LPA コードとして解析できませんでした。</string>
@@ -84,7 +87,27 @@
     <string name="download_wizard_diagnostics_last_apdu_exception">最終の APDU 例外:</string>
     <string name="download_wizard_diagnostics_save">保存</string>
     <string name="download_wizard_diagnostics_file_template">「%s」での診断</string>
-    <string name="download_wizard_error_suggest_network_unreachable">別のネットワークに接続し（例：Wi-Fi とデータを切り替える）、もう一度お試しください。</string>
+    <string name="download_wizard_error_iccid_already">この eSIM プロファイルはすでに eSIM チップに存在します。</string>
+    <string name="download_wizard_error_insufficient_memory">eSIM チップにはプロファイルをダウンロードするのに必要なメモリが残っていません。</string>
+    <string name="download_wizard_error_unsupported_profile">この eSIM プロファイルは、eSIM チップではサポートされていません。</string>
+    <string name="download_wizard_error_card_internal_error">eSIM チップでエラーが発生しました。</string>
+    <string name="download_wizard_error_eid_not_supported">使用しているデバイスまたは eSIM チップの EID は、通信事業者によってサポートされていません。</string>
+    <string name="download_wizard_error_eid_mismatch">この eSIM プロファイルは、別のデバイスにダウンロードされています。</string>
+    <string name="download_wizard_error_profile_unreleased">この eSIM プロファイルは取り消されました。</string>
+    <string name="download_wizard_error_matching_id_refused">アクティベーションコードが無効です。</string>
+    <string name="download_wizard_error_profile_retries_exceeded">eSIM プロファイルのダウンロード試行回数の上限を超えました。</string>
+    <string name="download_wizard_error_confirmation_code_missing">このプロファイルをダウンロードするには確認コードが必要です。</string>
+    <string name="download_wizard_error_confirmation_code_refused">入力した確認コードは無効です。</string>
+    <string name="download_wizard_error_profile_expired">この eSIM プロファイルは有効期限が切れています。</string>
+    <string name="download_wizard_error_confirmation_code_retries_exceeded">確認コードのダウンロード試行回数の上限を超えました。</string>
+    <string name="download_wizard_error_unknown_hostname">不明な SM-DP+ アドレス</string>
+    <string name="download_wizard_error_network_unreachable">ネットワークにアクセスできません</string>
+    <string name="download_wizard_error_tls_certificate">TLS 証明書エラー、この eSIM プロファイルはサポートされていません</string>
+    <string name="download_wizard_error_suggest_profile_installed">ダウンロード済みの eSIM プロファイルを再インストールしようとしています</string>
+    <string name="download_wizard_error_suggest_insufficient_memory">未使用の eSIM プロファイルをいくつか削除して、再度お試しください</string>
+    <string name="download_wizard_error_suggest_contact_carrier">サポートについては、通信事業者にお問い合わせください。</string>
+    <string name="download_wizard_error_suggest_contact_reissue">この eSIM プロファイルを再発行するには、通信事業者にお問い合わせください。</string>
+    <string name="download_wizard_error_suggest_network_unreachable">別のネットワークに接続後 (例: Wi-Fi とデータを切り替え) を行った後に再度お試しください。</string>
     <string name="logs_saved_message">ログは共有したパスに保存されました。別のアプリで共有しますか？</string>
     <string name="profile_rename_new_name">新しいニックネーム</string>
     <string name="profile_rename_encoding_error">ニックネームを UTF-8 にエンコードできませんでした</string>
@@ -98,8 +121,8 @@
     <string name="profile_notifications_help">eSIM プロファイルはダウンロードや削除、有効化や無効化されたときに通信事業者に通知を送信できます。送信されるこれらの通知のキューはここにリストされます。\n\n設定では、各タイプの通知を自動的に送信するかどうかを指定できます。通知が送信された場合でもキューのスペースが不足していない限り、記録から自動的に削除されることはありません。\n\nここでは保留中の各通知を手動で送信または削除できます。</string>
     <string name="profile_notification_operation_download">ダウンロードしました</string>
     <string name="profile_notification_operation_delete">削除しました</string>
-    <string name="profile_notification_operation_enable">有効化しました</string>
-    <string name="profile_notification_operation_disable">無効化しました</string>
+    <string name="profile_notification_operation_enable">有効化済み</string>
+    <string name="profile_notification_operation_disable">無効化済み</string>
     <string name="profile_notification_process">処理</string>
     <string name="profile_notification_delete">削除</string>
     <string name="euicc_info">eUICC 情報</string>
@@ -116,18 +139,29 @@
     <string name="euicc_info_sas_accreditation_number">SAS 認定番号</string>
     <string name="euicc_info_pp_version">保護されたプロファイルのバージョン</string>
     <string name="euicc_info_free_nvram">NVRAM の空き容量 (eSIM プロファイルストレージ)</string>
-    <string name="euicc_info_free_nvram_hint">（目安）</string>
+    <string name="euicc_info_free_nvram_hint">(参照用)</string>
     <string name="euicc_info_ci_type">証明書発行者 (CI)</string>
     <string name="euicc_info_ci_gsma_live">GSMA ライブ CI</string>
     <string name="euicc_info_ci_gsma_test">GSMA テスト CI</string>
     <string name="euicc_info_ci_unknown">不明な eSIM CI</string>
+    <string name="euicc_memory_reset">eUICC を消去</string>
+    <string name="euicc_memory_reset_title">eUICC を消去</string>
+    <string name="euicc_memory_reset_message">このチップ上のすべてのプロファイルを削除することを確認してください。この操作は元に戻せないことを理解してください。\n\nEID: %1$s\n\n%2$s</string>
+    <string name="euicc_memory_reset_hint_text">確認のために「%s」を入力してください</string>
+    <string name="euicc_memory_reset_confirm_text">EID が %s で終わるチップを消去することを確認し、この操作は元に戻せないことを理解してください</string>
+    <string name="euicc_memory_reset_invoke_button">消去</string>
+    <!-- eUICC Info -->
     <string name="euicc_info_yes">はい</string>
     <string name="euicc_info_no">いいえ</string>
+    <string name="euicc_info_unknown">不明</string>
+    <string name="euicc_info_unavailable">情報がありません</string>
     <string name="logs_save">保存</string>
     <string name="logs_filename_template">%s のログ</string>
     <string name="developer_options_steps">開発者になるまであと %d ステップです。</string>
     <string name="developer_options_enabled">あなたは開発者になりました！</string>
-    <string name="isdr_aid_list_saved">カスタム ISD-R AID リストが保存されました</string>
+    <string name="isdr_aid_list">ISD-R AID リスト</string>
+    <string name="isdr_aid_list_saved">カスタム ISD-R AID リストを保存しました。</string>
+    <string name="isdr_aid_list_restore_defaults">リセット</string>
     <string name="pref_settings">設定</string>
     <string name="pref_notifications">通知</string>
     <string name="pref_notifications_desc">eSIM のプロファイル操作により、通信事業者に通知が送信されます。必要に応じてこの動作を微調整できます。</string>
@@ -139,7 +173,7 @@
     <string name="pref_notifications_switch_desc">プロファイルを<i>切り替え中</i>の通知を送信します\nこのタイプの通知は信頼できないことに注意してください。</string>
     <string name="pref_advanced">高度な設定</string>
     <string name="pref_advanced_disable_safeguard_removable_esim">プロファイルの無効化と削除を許可</string>
-    <string name="pref_advanced_disable_safeguard_removable_esim_desc">デフォルトでは、このアプリでデバイスに挿入された取り外し可能な eSIM の有効なプロファイルを無効化することを防いでいます。なぜなのかというと<i>時々</i>アクセスができなくなるからです。\nこのチェックボックスを ON にすることで、この保護機能を<i>解除</i>します。</string>
+    <string name="pref_advanced_disable_safeguard_removable_esim_desc">デフォルトでは、このアプリでデバイスに挿入されたリムーバブル eSIM の有効なプロファイルを無効化することを防いでいます。なぜなのかというと<i>時々</i>アクセスができなくなるからです。\nこのチェックボックスを ON にすることで、この保護機能を<i>解除</i>します。</string>
     <string name="pref_advanced_verbose_logging">詳細ログ</string>
     <string name="pref_advanced_verbose_logging_desc">詳細ログを有効化します。これには個人的な情報が含まれている可能性があります。この機能を ON にした後は、信頼できるユーザーとのみログを共有してください。</string>
     <string name="pref_advanced_language">言語</string>
@@ -147,50 +181,22 @@
     <string name="pref_advanced_logs">ログ</string>
     <string name="pref_advanced_logs_desc">アプリの最新デバッグログを表示します</string>
     <string name="pref_developer">開発者オプション</string>
-    <string name="pref_developer_refresh_after_switch_desc">プロファイルを切り替えた後にモデムに更新コマンドを送信するかどうか。クラッシュが発生する場合は、これを無効にしてみてください。</string>
+    <string name="pref_developer_refresh_after_switch">モデムに更新コマンドを送信</string>
+    <string name="pref_developer_refresh_after_switch_desc">プロファイルを切り替えた後にモデムに更新コマンドを送信するかどうかを設定します。クラッシュが発生する場合は、この機能を無効化してください。</string>
     <string name="pref_developer_unfiltered_profile_list">フィルタリングされていないプロファイル一覧を表示</string>
     <string name="pref_developer_unfiltered_profile_list_desc">非運用のプロファイルも含めます</string>
     <string name="pref_developer_ignore_tls_certificate">SM-DP+ TLS 証明書を無視する</string>
     <string name="pref_developer_ignore_tls_certificate_desc">RSP サーバーで使用される TLS 証明書を受け入れます</string>
-    <string name="pref_developer_isdr_aid_list_desc">一部のブランドの取り外し可能な eUICC では、独自の非標準 ISD-R AID が使用されている場合があり、サードパーティ アプリからアクセスできなくなります。アプリはこのリストに追加された非標準の AID の使用を試みる可能性がありますが、動作することは保証されません。</string>
+    <string name="pref_developer_euicc_memory_reset">eUICC の消去を許可</string>
+    <string name="pref_developer_euicc_memory_reset_desc">これは危険な操作であり、デフォルトでは非表示になっています。代わりとしてすべてのプロファイルを手動で削除することもできます。</string>
     <string name="pref_developer_es10x_mss_desc">グローバル ES10x MSS</string>
+    <string-array name="pref_developer_es10x_entry_keys">
+        <item>高速</item>
+        <item>互換モード</item>
+    </string-array>
+    <string name="pref_developer_isdr_aid_list">ISD-R AID リストをカスタマイズ</string>
+    <string name="pref_developer_isdr_aid_list_desc">一部ブランドのリムーバブル eUICC は独自の非標準な ISD-R AID を使用しているため、サードパーティー製アプリからアクセスできない場合があります。このリストに追加された非標準な AID の使用を試みますが、動作の保証はできません。</string>
     <string name="pref_info">情報</string>
     <string name="pref_info_app_version">アプリバージョン</string>
     <string name="pref_info_source_code">ソースコード</string>
-    <string name="toast_euicc_memory_reset_confirm_text_mismatched">確認文字列が一致しません</string>
-    <string name="toast_euicc_memory_reset_finitshed">このチップは消去されました</string>
-    <string name="task_euicc_memory_reset">eSIM チップを消去しています</string>
-    <string name="task_euicc_memory_reset_failure">eSIM チップの消去は失敗しました</string>
-    <string name="euicc_memory_reset">eSIM を消去する</string>
-    <string name="euicc_memory_reset_title">eSIM を消去する</string>
-    <string name="euicc_memory_reset_message">このチップ内のすべてのプロファイルを削除することをご確認してください。この操作は元に戻せないことをご理解してください。\n\nEID: %1$s\n\n%2$s</string>
-    <string name="euicc_memory_reset_hint_text">確認のため、ここに「%s」を入力してください</string>
-    <string name="euicc_memory_reset_confirm_text">EID が %s で終わるチップを消去することに同意します。これは元に戻せないことを理解しています。</string>
-    <string name="euicc_memory_reset_invoke_button">消去する</string>
-    <string name="pref_developer_euicc_memory_reset">eUICC の消去を可能にする</string>
-    <string name="pref_developer_euicc_memory_reset_desc">この操作は、デフォルトでは非表示になっている危険な操作です。代わりに、すべての構成ファイルを手動で削除することもできます。</string>
-    <string name="pref_developer_refresh_after_switch">モデムに更新コマンドを送信</string>
-    <string name="pref_developer_isdr_aid_list">ISD-R AID リストのカスタマイズ</string>
-    <string name="isdr_aid_list_restore_defaults">リセット</string>
-    <string name="isdr_aid_list">ISD-R AID リスト</string>
-    <string name="download_wizard_error_iccid_already">この eSIM プロファイルはすでに eSIM チップに存在しています。</string>
-    <string name="download_wizard_error_insufficient_memory">eSIM チップには十分なメモリ容量が残っていません。</string>
-    <string name="download_wizard_error_unsupported_profile">この eSIM プロファイルは、ダウンロード先のeSIM チップではサポートされていません。</string>
-    <string name="download_wizard_error_card_internal_error">eSIMチップでエラーが発生しました。</string>
-    <string name="download_wizard_error_eid_not_supported">お使いのデバイスまたは eSIM チップの EID は、通信事業者によってサポートされていません。</string>
-    <string name="download_wizard_error_eid_mismatch">この eSIM プロファイルはすでに別のデバイスにダウンロードされています。</string>
-    <string name="download_wizard_error_profile_unreleased">この eSIM プロファイルはキャンセルされました。</string>
-    <string name="download_wizard_error_matching_id_refused">アクティベーションコードが無効です。</string>
-    <string name="download_wizard_error_profile_retries_exceeded">eSIM プロファイルのダウンロード試行回数の上限を超えました。</string>
-    <string name="download_wizard_error_confirmation_code_missing">このプロファイルをダウンロードするには確認コードが必要です。</string>
-    <string name="download_wizard_error_confirmation_code_refused">入力した確認コードは無効です。</string>
-    <string name="download_wizard_error_profile_expired">この eSIM プロファイルの有効期限が切れています。</string>
-    <string name="download_wizard_error_confirmation_code_retries_exceeded">確認コードのダウンロード試行回数の上限を超えました。</string>
-    <string name="download_wizard_error_unknown_hostname">不明なSM-DP+アドレス</string>
-    <string name="download_wizard_error_network_unreachable">ネットワークにアクセスできません</string>
-    <string name="download_wizard_error_tls_certificate">TLS証明書エラー。このeSIMプロファイルはサポートされていません</string>
-    <string name="download_wizard_error_suggest_profile_installed">すでにダウンロードしたeSIMプロファイルを再インストールしようとしています</string>
-    <string name="download_wizard_error_suggest_insufficient_memory">不要なeSIMプロファイルをいくつか削除して、もう一度お試しください</string>
-    <string name="download_wizard_error_suggest_contact_carrier">通信事業者にお問い合わせください。</string>
-    <string name="download_wizard_error_suggest_contact_reissue">この eSIM プロファイルを再発行するには、通信事業者にお問い合わせください。</string>
 </resources>
diff --git a/app-unpriv/src/main/res/values-ja/strings.xml b/app-unpriv/src/main/res/values-ja/strings.xml
index f3ff41f18..0734ba3f0 100644
--- a/app-unpriv/src/main/res/values-ja/strings.xml
+++ b/app-unpriv/src/main/res/values-ja/strings.xml
@@ -1,20 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="compatibility_check">互換性のチェック</string>
+    <string name="compatibility_check">互換性の確認</string>
     <string name="open_sim_toolkit">SIM ツールキットを開く</string>
     <!-- Settings -->
     <!-- Toast -->
     <string name="toast_ara_m_copied">ARA-M SHA-1 をクリップボードにコピーしました</string>
     <string name="toast_prompt_to_enable_sim_toolkit">「%s」アプリを有効化してください</string>
-    <string name="quick_compatibility">互換性のチェック</string>
-    <string name="quick_compatibility_compatible">お使いのスマートフォンは %s 対応 SIM カードを管理できます</string>
-    <string name="quick_compatibility_not_compatible">お使いのスマートフォンは %s と互換性がありません</string>
-    <string name="quick_compatibility_not_compatible_but_usb">お使いのスマートフォンは %s と完全な互換性がありません。ただし、USBスマートカードリーダーを使用する場合、ほぼすべての機能を利用できます。</string>
-    <string name="quick_compatibility_result_slots">アクセス可能なスロット: %s</string>
+    <!-- Quick Compatibility -->
+    <string name="quick_compatibility">クイックで互換性を確認</string>
+    <string name="quick_compatibility_compatible">このデバイスで「%s」の対応カードを管理できます</string>
+    <string name="quick_compatibility_not_compatible">使用しているデバイスは「%s」と互換性がありません</string>
+    <string name="quick_compatibility_not_compatible_but_usb">使用しているデバイスは「%s」と完全に互換性がありません。ただし、USB スマートカードリーダーを使用すればほぼすべての機能を利用できます。</string>
+    <string name="quick_compatibility_result_slots">アクセス可能スロット: %s</string>
     <string name="quick_compatibility_result_slots_isdr">ISD-R アクセス: %s</string>
-    <string name="quick_compatibility_result_notes">注: これらの結果は参考用です。以上に記載されていない SIM スロットでも、SIM カードを挿入すれば利用できる可能性があります。</string>
-    <string name="quick_compatibility_result_notes_incompatible">注：現在 SIM カードが挿入されていない場合は、SIM カードを挿入してから再度互換性チェックをお試しください。どの SIM カードでも構いません。</string>
-    <string name="quick_compatibility_button_continue">つづく</string>
+    <string name="quick_compatibility_result_notes">注意: これらの結果は参考値です。上記に記載されていない SIM スロットでも、<i>SIM カードを挿入</i>すれば互換性がある場合があります。</string>
+    <string name="quick_compatibility_result_notes_incompatible">注意: 現在 SIM カードが挿入されていない場合は、SIM カードを挿入してから再度互換性の確認をお試しください。どの SIM カードでも構いません。</string>
+    <string name="quick_compatibility_button_continue">続行</string>
     <string name="quick_compatibility_skip">このメッセージを再度表示しない</string>
     <string name="quick_compatibility_unknown">不明</string>
 </resources>
diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml
index fbf5c53d6..920801c0a 100644
--- a/app/src/main/res/values-ja/strings.xml
+++ b/app/src/main/res/values-ja/strings.xml
@@ -17,6 +17,7 @@
     <string name="lui_desc">使用しているデバイスは eSIM をサポートしています。モバイルネットワークに接続するには通信事業者が発行した eSIM をダウンロードするか、物理 SIM を挿入してください。</string>
     <string name="lui_skip">スキップ</string>
     <string name="lui_download">eSIM をダウンロード</string>
-    <string name="pref_developer_telephony_manager_removable">TelephonyManagerをどこでも使用</string>
-    <string name="pref_developer_telephony_manager_removable_desc">デフォルトでは、非特権モード (EasyEUICC) と一致するように、取り外し可能な eUICC に対して OMAPI のみが試行されます。これは、一部のデバイスではうまく機能しない可能性があります。このオプションを選択する場合、取り外し可能な eUICC でも TelephonyManager を使用することになります。</string>
+    <!-- Preference -->
+    <string name="pref_developer_telephony_manager_removable">TelephonyManager を常に使用可能にする</string>
+    <string name="pref_developer_telephony_manager_removable_desc">デフォルトでは、非特権モード (EasyEUICC など) での動作と一致させるためにリムーバブル eUICC に対しては OMAPI のみを試行します。ただし、一部デバイスでは正常に動作しない場合があります。このオプションを選択するとリムーバブル eUICC でも TelephonyManager の使用が強制されます。</string>
 </resources>

From 0096b9005fb781b3970a066713b3591e94dbc97b Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 22 Sep 2025 00:50:16 +0200
Subject: [PATCH 455/458] chore: update ES10x MSS preference labels for clarity
 (#231)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/231
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 app-common/src/main/res/values-zh-rCN/strings.xml | 4 ++++
 app-common/src/main/res/values/strings.xml        | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/app-common/src/main/res/values-zh-rCN/strings.xml b/app-common/src/main/res/values-zh-rCN/strings.xml
index 4457e6d9e..7303d2d50 100644
--- a/app-common/src/main/res/values-zh-rCN/strings.xml
+++ b/app-common/src/main/res/values-zh-rCN/strings.xml
@@ -86,6 +86,10 @@
     <string name="pref_advanced_logs_desc">查看应用程序的最新调试日志</string>
     <string name="pref_developer_isdr_aid_list_desc">某些品牌的可移除 eUICC 可能会使用自己的非标准 ISD-R AID，导致第三方应用无法访问。此 App 可以尝试使用此列表中添加的非标准 AID，但不能保证它们一定有效。</string>
     <string name="pref_developer_es10x_mss_desc">全局 ES10x MSS</string>
+    <string-array name="pref_developer_es10x_entry_keys">
+        <item>最佳效率</item>
+        <item>最佳兼容性</item>
+    </string-array>
     <string name="pref_info">信息</string>
     <string name="pref_info_app_version">App 版本</string>
     <string name="pref_info_source_code">源码</string>
diff --git a/app-common/src/main/res/values/strings.xml b/app-common/src/main/res/values/strings.xml
index a7f2c10e1..39a762fe2 100644
--- a/app-common/src/main/res/values/strings.xml
+++ b/app-common/src/main/res/values/strings.xml
@@ -225,8 +225,8 @@
     <string name="pref_developer_es10x_mss" translatable="false">ES10x MSS</string>
     <string name="pref_developer_es10x_mss_desc">Global ES10x MSS</string>
     <string-array name="pref_developer_es10x_entry_keys">
-        <item>High Speed</item>
-        <item>Compatibility Mode</item>
+        <item>High Efficiency</item>
+        <item>Most Compatible</item>
     </string-array>
     <string-array name="pref_developer_es10x_entry_values" translatable="false">
         <item>255</item>

From 351567a972c9abb53d6c4c3631fe142886359fdb Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Mon, 22 Sep 2025 00:50:30 +0200
Subject: [PATCH 456/458] chore: improve variant compare (#230)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/230
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 README.md | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 740478afb..8a67e4138 100644
--- a/README.md
+++ b/README.md
@@ -4,14 +4,18 @@ A fully free and open-source Local Profile Assistant implementation for Android
 
 There are two variants of this project, OpenEUICC and EasyEUICC:
 
-|                               |                    OpenEUICC                    |     EasyEUICC     |
-|:------------------------------|:-----------------------------------------------:|:-----------------:|
-| Privileged                    |         Must be installed as system app         |        No         |
-| Internal eSIM                 |                    Supported                    |    Unsupported    |
-| External (Removable) eSIM     |                    Supported                    |     Supported     |
-| USB Readers                   |                    Supported                    |     Supported     |
-| Requires allowlisting by eSIM |                       No                        | Yes -- except USB |
-| System Integration            | Partial (carrier partner API unimplemented yet) |        No         |
+|                               |            OpenEUICC            |      EasyEUICC      |
+| :---------------------------- | :-----------------------------: | :-----------------: |
+| Privileged                    | Must be installed as system app |         No          |
+| Internal eSIM                 |            Supported            |     Unsupported     |
+| External eSIM [^1]            |            Supported            |      Supported      |
+| USB Readers                   |            Supported            |      Supported      |
+| Requires allowlisting by eSIM |               No                |  Yes -- except USB  |
+| System Integration            |          Partial [^2]           |         No          |
+| Minimum Android Version       |      Android 11 or higher       | Android 9 or higher |
+
+[^1]: Also known as "Removable eSIM"
+[^2]: Carrier Partner API unimplemented yet
 
 Some side notes:
 1. When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.

From b245a9c89338bb805d2791036ff19467059daf40 Mon Sep 17 00:00:00 2001
From: MasterOfStar <hzh4363703@live.com>
Date: Thu, 2 Oct 2025 14:24:51 +0200
Subject: [PATCH 457/458] fix magisk module bug (#234)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

部分设备magisk模块安装出现失败情况，对此进行修复
如图为在magisk27.1中无法安装

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/234
Co-authored-by: MasterOfStar <hzh4363703@live.com>
Co-committed-by: MasterOfStar <hzh4363703@live.com>
---
 app/magisk/customize.sh                                     | 2 +-
 buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/magisk/customize.sh b/app/magisk/customize.sh
index 707b401ca..3b57a55c9 100644
--- a/app/magisk/customize.sh
+++ b/app/magisk/customize.sh
@@ -1,7 +1,7 @@
 TMP_FILE="$TMPDIR/{APK_NAME}"
 
 chmod u+x "$MODPATH/uninstall.sh"
-cp "$MODPATH/system/system_ext/{APK_NAME}/{APK_NAME}.apk" "$TMP_FILE"
+cp "$MODPATH/system/system_ext/priv-app/{APK_NAME}/{APK_NAME}.apk" "$TMP_FILE"
 
 pm install -r "$TMP_FILE"
 rm -f "$TMP_FILE"
diff --git a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt
index 6245d8c98..e5ccfa35a 100644
--- a/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt
+++ b/buildSrc/src/main/kotlin/im/angry/openeuicc/build/Magisk.kt
@@ -68,7 +68,7 @@ abstract class MagiskModuleDirTask : DefaultTask() {
         }
         dir.file("customize.sh").asFile.writeText(moduleCustomizeScriptText.get())
         dir.file("uninstall.sh").asFile.writeText(moduleUninstallScriptText.get())
-        metaInfDir.file("updater-script").asFile.writeText("# MAGISK")
+        metaInfDir.file("updater-script").asFile.writeText("#MAGISK\n")
         dir.file("module.prop").asFile.writeText(moduleProp.get().map { (k, v) -> "$k=$v" }.joinToString("\n"))
     }
 }
\ No newline at end of file

From c74c1f309c0ba4080a0d1a1c565911958a5176dd Mon Sep 17 00:00:00 2001
From: septs <github@septs.pw>
Date: Thu, 2 Oct 2025 14:25:45 +0200
Subject: [PATCH 458/458] docs: enhance README formatting and clarity (#235)

Reviewed-on: https://gitea.angry.im/PeterCxy/OpenEUICC/pulls/235
Co-authored-by: septs <github@septs.pw>
Co-committed-by: septs <github@septs.pw>
---
 README.md | 56 +++++++++++++++++++++++++++++++++----------------------
 1 file changed, 34 insertions(+), 22 deletions(-)

diff --git a/README.md b/README.md
index 8a67e4138..80ab30027 100644
--- a/README.md
+++ b/README.md
@@ -18,17 +18,30 @@ There are two variants of this project, OpenEUICC and EasyEUICC:
 [^2]: Carrier Partner API unimplemented yet
 
 Some side notes:
-1. When privileged, OpenEUICC supports any eUICC chip that implements the SGP.22 standard, internal or external. However, there is __no guarantee__ that external (removable) eSIMs actually follow the standard. Please __DO NOT__ submit bug reports for non-functioning removable eSIMs. They are __NOT__ officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
-2. Both variants support accessing eUICC chips through USB CCID readers, regardless of whether the chip contains the correct ARA-M hash to allow for unprivileged access. However, only `T=0` readers that use the standard [USB CCID protocol](https://en.wikipedia.org/wiki/CCID_(protocol)) are supported.
-3. Prebuilt release-mode EasyEUICC apks can be downloaded [here](https://gitea.angry.im/PeterCxy/OpenEUICC/releases). For OpenEUICC, no official release is currently provided and only debug mode APKs and Magisk modules can be found in the [CI page](https://gitea.angry.im/PeterCxy/OpenEUICC/actions).
-4. For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted, include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`.
 
-__This project is Free Software licensed under GNU GPL v3, WITHOUT the "or later" clause.__ Any modification and derivative work __MUST__ be released under the SAME license, which means, at the very least, that the source code __MUST__ be available upon request.
+1. When privileged, OpenEUICC supports any eUICC chip that implements the [SGP.22] standard, internal or external.
+   However, there is **no guarantee** that external (removable) eSIMs actually follow the standard.
+   Please **DO NOT** submit bug reports for non-functioning removable eSIMs.
+   They are **NOT** officially supported unless they also support / are supported by EasyEUICC, the unprivileged variant.
+2. Both variants support accessing eUICC chips through USB CCID readers,
+   regardless of whether the chip contains the correct ARA-M hash to allow for unprivileged access.
+   However, only `T=0` readers that use the standard [USB CCID protocol][usb-ccid] are supported.
+3. Prebuilt release-mode EasyEUICC apks can be downloaded [here][releases].
+   For OpenEUICC, no official release is currently provided and only debug mode APKs and Magisk modules can be found in the [CI page][actions].
+4. For removable eSIM chip vendors: to have your chip supported by official builds of EasyEUICC when inserted,
+   include the ARA-M hash `2A2FA878BC7C3354C2CF82935A5945A3EDAE4AFA`.
 
-__If you are releasing a modification of this app, you are kindly asked to make changes to at least the app name and package name.__  
+[sgp.22]: https://www.gsma.com/solutions-and-impact/technologies/esim/gsma_resources/sgp-22-v2-2-2/ "SGP.22 v2.2.2"
+[usb-ccid]: https://en.wikipedia.org/wiki/CCID_%28protocol%29 "USB CCID Protocol"
+[releases]: https://gitea.angry.im/PeterCxy/OpenEUICC/releases "EasyEUICC Releases"
+[actions]: https://gitea.angry.im/PeterCxy/OpenEUICC/actions "OpenEUICC Actions"
 
-Building (Gradle)
-===
+**This project is Free Software licensed under GNU GPL v3, WITHOUT the "or later" clause.**
+Any modification and derivative work **MUST** be released under the SAME license, which means, at the very least, that the source code **MUST** be available upon request.
+
+**If you are releasing a modification of this app, you are kindly asked to make changes to at least the app name and package name.**
+
+# Building (Gradle)
 
 Make sure you have all submodules cloned and updated by running
 
@@ -61,8 +74,7 @@ For EasyEUICC:
 ./gradlew :app-unpriv:assembleRelease
 ```
 
-Building (AOSP)
-===
+# Building (AOSP)
 
 There are two ways to include OpenEUICC in your AOSP-based system image:
 
@@ -72,22 +84,22 @@ There are two ways to include OpenEUICC in your AOSP-based system image:
    - Compilation of this project is **only** tested against the latest AOSP release version. The app itself should be compatible with older AOSP versions, but the source may not compile against an older AOSP source tree.
 2. If compilation against AOSP source tree is not possible, consider [building with gradle](#building-gradle) and import the apk as a prebuilt.
    - No official `Android.bp` is provided for this case but it should be straightforward to write.
-   - You might want to include `privapp_whitelist_im.angry.openeuicc.xml` as well.
+   - You might want to include [`privapp_whitelist_im.angry.openeuicc.xml`] as well.
 
-FAQs
-===
+[`privapp_whitelist_im.angry.openeuicc.xml`]: privapp_whitelist_im.angry.openeuicc.xml "OpenEUICC Privapp Whitelist"
 
-- Q: Do you provide prebuilt binaries for OpenEUICC?
-- A: Debug-mode APKs and Magisk modules are available continuously as an artifact of the [Actions](https://gitea.angry.im/PeterCxy/OpenEUICC/actions) CI used by this project. However, these debug-mode APKs are **not** intended for inclusion inside system images, nor are they supported by the developer in any sense. If you are a custom ROM developer, either include the entire OpenEUICC repository in your AOSP source tree, or generate an APK using `gradle` and import that as a prebuilt system app. Note that you might want `privapp_whitelist_im.angry.openeuicc.xml` as well.
+# FAQs
 
-- Q: Can EasyEUICC manage my phone's internal eSIM?
-- A: No. For EasyEUICC to work, the eSIM chip MUST proactively grant access via its ARA-M field.
+- Q: Do you provide prebuilt binaries for OpenEUICC? \
+  A: Debug-mode APKs and Magisk modules are available continuously as an artifact of the [Actions] CI used by this project. However, these debug-mode APKs are **not** intended for inclusion inside system images, nor are they supported by the developer in any sense. If you are a custom ROM developer, either include the entire OpenEUICC repository in your AOSP source tree, or generate an APK using `gradle` and import that as a prebuilt system app. Note that you might want [`privapp_whitelist_im.angry.openeuicc.xml`] as well.
 
-- Q: Removable eSIMs? Are they a joke?
-- A: No, even though the name "removable embedded SIM" can sound like an oxymoron. In fact, there can be many advantages to these chips compared to fully embedded ones. For example, the ability to transfer eSIM profiles without carrier support or approval, or the ability to use eSIM on devices that do not and may never get the support, such as Wi-Fi hotspots.
+- Q: Can EasyEUICC manage my phone's internal eSIM? \
+  A: No. For EasyEUICC to work, the eSIM chip MUST proactively grant access via its ARA-M field.
 
-Copyright
-===
+- Q: Removable eSIMs? Are they a joke? \
+  A: No, even though the name "removable embedded SIM" can sound like an oxymoron. In fact, there can be many advantages to these chips compared to fully embedded ones. For example, the ability to transfer eSIM profiles without carrier support or approval, or the ability to use eSIM on devices that do not and may never get the support, such as Wi-Fi hotspots.
+
+# Copyright
 
 Everything except `libs/lpac-jni` and `art/`:
 
@@ -127,4 +139,4 @@ License along with this library; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 ```
 
-`art/`: Courtesy of [Aikoyori](https://github.com/Aikoyori), CC NC-SA 4.0.
\ No newline at end of file
+`art/`: Courtesy of [Aikoyori](https://github.com/Aikoyori), CC NC-SA 4.0.