Behandlung von eUICC-API-Fehlern

Die eUICC APIs bietet Fehlercodes , um Hilfe zu Anwendungen und Benutzer beim Beheben von Problemen im Zusammenhang mit dem Herunterladen Aktivieren, Deaktivieren und Löschen von eSIM Profilen.

Umgang mit Fehlern

Wenn ein Fehler auftritt , während die eUICC API aufrufen, wird eine anhängige Absicht Rückruf zur Verfügung gestellt und EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE wird für das Erhalten der detaillierten Fehlercode als Schlüssel verwendet. Ab Android 11 sind die folgenden vier Schlüssel und Werte im resultierenden Intent enthalten:

Diese vier Werte ermöglichen es dem Aufrufer der eUICC-API, spezifische Fehler individuell zu behandeln. Im Folgenden finden Sie ein Beispiel für die Behandlung dieser Fehler.

int operationCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
int errorCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
String smdxSubjectCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE)
String smdxReasonCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE)

if (operationCode == OPERATION_DOWNLOAD && errorCode == ERROR_CARRIER_LOCKED) {
  // handle specific error i.e tries to download but the device is carrier locked
} else if (operationCode == OPERATION_SMDX) {
  // handle all SM-DP+/SM-DS errors
} else if (errorCode == ERROR_TIME_OUT) {
  // handle all types of time out issues, regardless of operation.
} else if ("8.1".equals(smdxSubjectCode) && "3.1".equals(smdxReasonCode)) {
  // handle specific subject code and reason code: 8.1 and 4.1 means insufficient memory.
}

Unterstützte Betriebs- und Fehlercodekombinationen

Die folgende Tabelle beschreibt die unterstützte Kombination von Vorgangs- und Fehlercodes, die vom lokalen Profilassistenten (LPA) zurückgegeben werden.

Kombinationen von Betriebs- und Fehlercodes
Betriebscode Fehlercode Beschreibung
OPERATION_SYSTEM Unzutreffend Ein interner Fehler ist aufgetreten. Zum Beispiel wurde der Faden unterbrochen oder ein IOException Fehler aufgetreten ist .
OPERATION_SIM_SLOT Unzutreffend Beim Ausführen einer SIM-Slot-Operation ist ein interner Fehler aufgetreten.
ERROR_TIME_OUT Zeitüberschreitung beim Versuch, einen SIM-Slot-Vorgang auszuführen.
ERROR_EUICC_MISSING Auf dem Gerät ist kein eUICC verfügbar oder aktiv.
OPERATION_EUICC_CARD Unzutreffend Beim Ausführen einer eUICC-Operation ist ein interner Fehler aufgetreten.
ERROR_UNSUPPORTED_VERSION eUICC (Chip)-Version und EuiccCard (Software)-Version sind nicht kompatibel.
ERROR_EUICC_MISSING Im Gerät ist keine SIM-Karte vorhanden. Beispielsweise kann die LPA die SIM-Karte nicht erkennen.
OPERATION_SMDX Unzutreffend Beim Ausführen einer SM-DP+/SM-DS-Operation ist ein interner Fehler aufgetreten.
ERROR_ADDRESS_MISSING Keine SM-DP+ Adresse zum Herunterladen des Profils.
ERROR_INVALID_CONFIRMATION_CODE Beim Parsen des Aktivierungscodes ist ein Fehler aufgetreten (ungültiges Format).
ERROR_CERTIFICATE_ERROR Keystore- oder Zertifikatsfehler bei Verwendung in TLS-Verbindung zur Überprüfung.
ERROR_NO_PROFILES_AVAILABLE Keine Profile von SM-DP+ verfügbar.
ERROR_CONNECTION_ERROR Verbindung zum Server kann nicht hergestellt werden.
ERROR_INVALID_RESPONSE Ungültige Antwort vom SM-DP+/SM-DS-Server.
OPERATION_SWITCH Unzutreffend Beim Ausführen einer Schaltbetätigung ist ein interner Fehler aufgetreten.
ERROR_CARRIER_LOCKED Profilwechsel nicht zulässig, da das Gerät vom Mobilfunkanbieter gesperrt ist (SIM-gesperrt).
OPERATION_DOWNLOAD Unzutreffend Beim Ausführen eines Download-Vorgangs ist ein interner Fehler aufgetreten.
ERROR_DISALLOWED_BY_PPR Die Rules Authorization Table auf der eUICC ist null oder der Download ist durch die Profilrichtlinienregel nicht zulässig.
ERROR_INVALID_ACTIVATION_CODE Beim Parsen des Aktivierungscodes (ungültiges Format) oder beim Versuch, ohne Aktivierungscode herunterzuladen, ist ein Fehler aufgetreten.
ERROR_CARRIER_LOCKED Download nicht zulässig, da das Gerät vom Mobilfunkanbieter gesperrt (SIM-gesperrt) ist.
ERROR_INCOMPATIBLE_CARRIER Der Netzbetreiber steht auf der schwarzen Liste und die LPA kann kein Profil von SM-DP+/SM-DS herunterladen.
ERROR_OPERATION_BUSY Das Herunterladen des Profils wird ausgeführt und es sind keine anderen Aktionen zulässig, die Änderungen des SIM-Status auslösen könnten.
OPERATION_METADATA Unzutreffend Beim Ausführen der Metadatenoperation ist ein interner Fehler aufgetreten.
ERROR_INVALID_ACTIVATION_CODE Die Abonnementmetadaten sind leer oder der Aktivierungscode in den Abonnementmetadaten ist leer oder ungültig.
ERROR_INCOMPATIBLE_CARRIER Der Netzbetreiber steht auf der schwarzen Liste und die LPA kann das Profil dieses Netzbetreibers nicht von SM-DP+/SM-DS herunterladen.
OPERATION_EUICC_GSMA Unzutreffend Beim Ausführen einer eUICC GSMA-Operation ist ein interner Fehler aufgetreten.
ERROR_INSTALL_PROFILE Fehler mit eUICC beim Versuch, das Profil zu installieren. Beispielsweise ist das Profil bereits vorhanden oder die ICCID stimmt nicht überein.
ERROR_EUICC_INSUFFICIENT_MEMORY Fehler mit eUICC beim Versuch, das Profil zu installieren. Nicht genügend Speicher auf der eUICC.
ERROR_DISALLOWED_BY_PPR Fehler mit eUICC beim Versuch, das Profil zu installieren. Von der Profilrichtlinienregel nicht zulässig.
OPERATION_APDU Unzutreffend Beim Ausführen einer APDU-Operation ist ein interner Fehler aufgetreten.
OPERATION_HTTP 1-999 Fehlercode ist ein HTTP-Fehlerwert.
Betriebscode Betreffcode Ursachencode Beschreibung
OPERATION_SMDX_SUBJECT_REASON_CODE String enthält 3 durch Punkt getrennte Ziffern ohne führende Nullen. Zum Beispiel 8.1.1 . String enthält 3 durch Punkt getrennte Ziffern ohne führende Nullen. Zum Beispiel 3.8 . SubjectCode[5.2.6.1] und ReasonCode[5.2.6.2] von GSMA (SGP.22 v2.2). Zum Beispiel kann ein SubjectCode von 8.1.1 und eine Reason von 3.8 bedeutet , dass das EID gebunden an ein anderes Gerät.