Gestire gli errori dell'API eUICC

Le API eUICC forniscono codici di errore per aiutare le app e gli utenti a risolvere i problemi relativi al scaricamento, all'abilitazione, alla disattivazione ed all'eliminazione dei profili eSIM.

Gestire gli errori

Quando si verifica un errore durante la chiamata all'API eUICC, viene fornito un callback di intent in attesa e EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE viene utilizzato come chiave per ottenere il codice di errore dettagliato. A partire da Android 11, le seguenti quattro chiavi e valori sono inclusi nell'intent risultante:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: fornisce informazioni su cosa non ha funzionato. ad esempio il download o l'eliminazione di un profilo eSIM. Questo campo non è mai vuoto.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Informazioni sul motivo dell'errore. Ad esempio, la richiesta è scaduta o il dispositivo è bloccato dall'operatore. Questo campo non viene compilato nei seguenti casi:

  • Il codice dell'operazione è OPERATION_SMDX_SUBJECT_REASON_CODE.
  • L'errore è di basso livello, ad esempio IOException o InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: viene utilizzato con EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE, che insieme forniscono SubjectCode[5.2.6.1] e ReasonCode[5.2.6.2] da GSMA (SGP.22 v2.2). Questo campo viene compilato solo quando il codice operazione è OPERATION_SMDX_SUBJECT_REASON_CODE.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: viene utilizzato con EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE, che insieme forniscono SubjectCode[5.2.6.1] e ReasonCode[5.2.6.2] da GSMA (SGP.22 v2.2). Questo campo viene compilato solo quando il codice operazione è OPERATION_SMDX_SUBJECT_REASON_CODE.

Questi quattro valori consentono al chiamante dell'API eUICC di gestire singolarmente errori specifici. Di seguito è riportato un esempio di come gestire questi errori.

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.
}

Combinazioni di operazioni e codici di errore supportate

La seguente tabella descrive la combinazione supportata di operazioni e codici di errore restituiti dall'assistente per i profili locali (LPA).