Gestire gli errori dell'API eUICC

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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 e 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 operazione è OPERATION_SMDX_SUBJECT_REASON_CODE.
  • L'errore è un errore di basso livello, ad esempio IOException o InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: 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: 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 all'utente che chiama l'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).