eUICC API-Fehler verarbeiten

Die eUICC-APIs Fehlercodes angeben, um Apps und Nutzern bei der Behebung von Problemen eSIM-Profile herunterladen, aktivieren, deaktivieren und löschen

Fehler verarbeiten

Wenn beim Aufrufen der eUICC API ein Fehler auftritt, ist ein ausstehender Intent-Callback bereitgestellt und EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE wird als Schlüssel zum Abrufen des detaillierten Fehlercodes verwendet. Ab sind die folgenden vier Schlüssel und Werte im resultierenden Intent enthalten:

Mit diesen vier Werten kann der Aufrufer der eUICC API bestimmte Fehler verarbeiten individuell anpassen. Im Folgenden finden Sie ein Beispiel für den Umgang mit diesen Fehlern.

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 Kombinationen von Operationen und Fehlercodes

In der folgenden Tabelle wird die unterstützte Kombination aus Operation und Fehlercodes, die vom lokalen Profilassistenten (LPA) zurückgegeben werden

Vorgangs- und Fehlercode-Kombinationen
<ph type="x-smartling-placeholder"></ph> Vorgangscode <ph type="x-smartling-placeholder"></ph> Fehlercode Beschreibung
OPERATION_SYSTEM Nicht zutreffend Es ist ein interner Fehler aufgetreten. Beispielsweise wurde der Thread unterbrochen oder IOException Fehler aufgetreten.
OPERATION_SIM_SLOT Nicht zutreffend Beim Ausführen eines SIM-Steckplatzvorgangs ist ein interner Fehler aufgetreten.
ERROR_TIME_OUT Zeitüberschreitung beim Ausführen eines SIM-Steckplatzvorgangs.
ERROR_EUICC_MISSING Auf dem Gerät ist keine eUICC verfügbar oder aktiv.
OPERATION_EUICC_CARD Nicht zutreffend Beim Ausführen eines eUICC-Vorgangs ist ein interner Fehler aufgetreten.
ERROR_UNSUPPORTED_VERSION eUICC-Version (Chip) und EuiccCard-Version (Software) sind nicht kompatibel sind.
ERROR_EUICC_MISSING Im Gerät ist keine SIM-Karte vorhanden. Beispielsweise kann der LPA in der SIM-Karte.
OPERATION_SMDX Nicht zutreffend Beim Ausführen eines SM-DP+/SM-DS-Vorgangs 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 Schlüsselspeicher- oder Zertifikatsfehler bei Verwendung in TLS-Verbindung für Ü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 Nicht zutreffend Beim Wechsel ist ein interner Fehler aufgetreten.
ERROR_CARRIER_LOCKED Dürfen das Profil nicht wechseln, weil das Gerät vom Mobilfunkanbieter gesperrt ist (SIM) gesperrt).
OPERATION_DOWNLOAD Nicht zutreffend Beim Ausführen eines Downloadvorgangs ist ein interner Fehler aufgetreten.
ERROR_DISALLOWED_BY_PPR Die Tabelle zur Regelautorisierung in der eUICC ist null oder der Download ist aufgrund der Regel der Profilrichtlinie nicht zugelassen.
ERROR_INVALID_ACTIVATION_CODE Beim Parsen des Aktivierungscodes ist ein Fehler aufgetreten (ungültiges Format) oder ohne Aktivierungscode herunterladen.
ERROR_CARRIER_LOCKED Download nicht erlaubt, da das Gerät vom Mobilfunkanbieter gesperrt ist (SIM-Karte) gesperrt).
ERROR_INCOMPATIBLE_CARRIER Der Netzbetreiber befindet sich auf der Sperrliste und der LPA kann kein Profil von SM-DP+/SM-DS.
ERROR_OPERATION_BUSY Das Profil wird heruntergeladen und keine andere Aktion, die die SIM auslösen könnte Statusänderungen sind zulässig.
OPERATION_METADATA Nicht zutreffend Beim Metadatenvorgang ist ein interner Fehler aufgetreten.
ERROR_INVALID_ACTIVATION_CODE Die Abo-Metadaten sind leer oder der Aktivierungscode im Abometadaten sind leer oder ungültig.
ERROR_INCOMPATIBLE_CARRIER Der Netzbetreiber steht auf der Sperrliste und die LPA kann die von SM-DP+/SM-DS.
OPERATION_EUICC_GSMA Nicht zutreffend Beim Ausführen eines eUICC GSMA-Vorgangs ist ein interner Fehler aufgetreten.
ERROR_INSTALL_PROFILE Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Zum Beispiel hat das Profil existiert bereits oder die ICCID stimmt nicht überein.
ERROR_EUICC_INSUFFICIENT_MEMORY Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Nicht genügend Arbeitsspeicher auf dem eUICC.
ERROR_DISALLOWED_BY_PPR Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Nicht zulässig gemäß Regel der Profilrichtlinie.
OPERATION_APDU Nicht zutreffend Beim Ausführen eines APDU-Vorgangs ist ein interner Fehler aufgetreten.
OPERATION_HTTP 1-999 Fehlercode ist ein HTTP-Fehlerwert.
<ph type="x-smartling-placeholder"></ph> Vorgangscode <ph type="x-smartling-placeholder"></ph> Themencode <ph type="x-smartling-placeholder"></ph> Ursachencode Beschreibung
OPERATION_SMDX_SUBJECT_REASON_CODE String enthält 3 Ziffern, die durch einen Punkt getrennt sind, ohne vorangestellte Nullen. Für Beispiel: 8.1.1. String enthält 3 Ziffern, die durch einen Punkt getrennt sind, ohne vorangestellte Nullen. Für Beispiel: 3.8. SubjectCode[5.2.6.1] und ReasonCode[5.2.6.2] von GSMA (SGP.22 v2.2). Für der SubjectCode 8.1.1 und der ReasonCode „3.8“ steht für die EID. an ein anderes Gerät gebunden ist.