Umgang mit eUICC API-Fehlern

Die eUICC-APIs enthalten Fehlercodes, die Apps und Nutzern bei der Behebung von Problemen im Zusammenhang mit dem Herunterladen, Aktivieren, Deaktivieren und Löschen von eSIM-Profilen helfen.

Fehler behandeln

Wenn beim Aufrufen der eUICC API ein Fehler auftritt, wird ein PendingIntent-Callback bereitgestellt und EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE als Schlüssel für den detaillierten Fehlercode verwendet. Ab Android 11 sind die folgenden vier Schlüssel und Werte im resultierenden Intent enthalten:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: Enthält Informationen dazu, was schiefgelaufen ist. Beispiele: Herunterladen oder Löschen eines eSIM-Profils. Dieses Feld ist nie leer.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Informationen dazu, warum der Fehler aufgetreten ist. Beispiel: Die Anfrage hat das Zeitlimit überschritten oder das Gerät ist an einen Mobilfunkanbieter gebunden. Dieses Feld wird in den folgenden Fällen nicht ausgefüllt:

  • Der Vorgangscode lautet OPERATION_SMDX_SUBJECT_REASON_CODE.
  • Der Fehler ist ein Low-Level-Fehler wie IOException oder InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: Wird mit EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE verwendet, um SubjectCode[5.2.6.1] und ReasonCode[5.2.6.2] von GSMA (SGP.22 v2.2) bereitzustellen. Dieses Feld wird nur ausgefüllt, wenn der Vorgangscode OPERATION_SMDX_SUBJECT_REASON_CODE ist.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: Wird mit EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE verwendet, um SubjectCode[5.2.6.1] und ReasonCode[5.2.6.2] von GSMA (SGP.22 v2.2) bereitzustellen. Dieses Feld wird nur ausgefüllt, wenn der Vorgangscode OPERATION_SMDX_SUBJECT_REASON_CODE ist.

Mithilfe dieser vier Werte kann der Aufrufer der eUICC-API bestimmte Fehler einzeln behandeln. 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 aus Vorgang und Fehlercode

In der folgenden Tabelle werden die unterstützten Kombinationen von Vorgangs- und Fehlercodes beschrieben, die vom Assistenten für das lokale Profil (Local Profile Assistant, LPA) zurückgegeben werden.