Umgang mit eUICC API-Fehlern

Die eUICC-APIs liefern Fehlercodes, mit denen Apps und Nutzer Probleme beim Herunterladen, Aktivieren, Deaktivieren und Löschen von eSIM-Profilen beheben können.

Fehler verarbeiten

Wenn beim Aufrufen der eUICC API ein Fehler auftritt, wird ein ausstehender Intent-Callback bereitgestellt und EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE als Schlüssel verwendet, um den detaillierten Fehlercode abzurufen. 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. Beispiel: 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 ist OPERATION_SMDX_SUBJECT_REASON_CODE.
  • Der Fehler ist ein Fehler auf niedriger Ebene, z. B. IOException oder InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: Wird mit EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE verwendet, um zusammen den 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 ist OPERATION_SMDX_SUBJECT_REASON_CODE.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: Wird mit EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE verwendet, um zusammen den 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 ist OPERATION_SMDX_SUBJECT_REASON_CODE.

Mit diesen vier Werten kann der Aufrufer der eUICC API bestimmte Fehler einzeln 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 Kombinationen von Vorgangs- und Fehlercodes

In der folgenden Tabelle werden die unterstützten Kombinationen von Vorgangs- und Fehlercodes beschrieben, die vom lokalen Profilassistenten (Local Profile Assistant, LPA) zurückgegeben werden.