Le API eUICC forniscono codici di errore per aiutare le app e gli utenti a risolvere i problemi relativi al download, all'attivazione, alla disattivazione e all'eliminazione dei profili eSIM.
Gestione degli errori
Quando si verifica un errore durante la chiamata all'API eUICC, viene fornito un callback dell'intento in sospeso e EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE
viene utilizzato come chiave per ottenere il codice di errore dettagliato. A partire da Android 11, nell'intento risultante sono inclusi i quattro valori e chiavi seguenti:
-
EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE
: fornisce informazioni su cosa è andato storto. Ad esempio, scaricando o eliminando un profilo eSIM. Questo campo non è mai vuoto. EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE
: informazioni sul motivo per cui si è verificato l'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 è un errore di basso livello come
IOException
oInterruptedException
.
- Il codice dell'operazione è
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
: utilizzato conEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
, che insieme forniscono ObjectCode[5.2.6.1] e ReasonCode[5.2.6.2] da GSMA (SGP.22 v2.2). Questo campo viene popolato solo quando il codice operazione èOPERATION_SMDX_SUBJECT_REASON_CODE
.EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
: utilizzato conEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
, che insieme forniscono ObjectCode[5.2.6.1] e ReasonCode[5.2.6.2] da GSMA (SGP.22 v2.2). Questo campo viene popolato solo quando il codice operazione èOPERATION_SMDX_SUBJECT_REASON_CODE
.
Questi quattro valori consentono al chiamante dell'API eUICC di gestire errori specifici individualmente. 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 profilo locale (LPA).
Combinazioni di operazioni e codici di errore | |||
---|---|---|---|
Codice operazione | Codice di errore | Descrizione | |
OPERATION_SYSTEM | Non applicabile | Si è verificato un errore interno. Ad esempio, il thread è stato interrotto o si è verificato un errore IOException . | |
OPERATION_SIM_SLOT | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione sullo slot SIM. | |
ERROR_TIME_OUT | Timeout durante il tentativo di eseguire un'operazione sullo slot SIM. | ||
ERROR_EUICC_MISSING | Nessun eUICC è disponibile o attivo sul dispositivo. | ||
OPERATION_EUICC_CARD | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione eUICC. | |
ERROR_UNSUPPORTED_VERSION | La versione eUICC (chip) e la versione EuiccCard (software) non sono compatibili. | ||
ERROR_EUICC_MISSING | Nel dispositivo non è disponibile alcuna scheda SIM. Ad esempio, l'LPA non è in grado di rilevare la scheda SIM. | ||
OPERATION_SMDX | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione SM-DP+/SM-DS. | |
ERROR_ADDRESS_MISSING | Nessun indirizzo SM-DP+ per scaricare il profilo. | ||
ERROR_INVALID_CONFIRMATION_CODE | Si è verificato un errore durante l'analisi del codice di attivazione (formato non valido). | ||
ERROR_CERTIFICATE_ERROR | Errore dell'archivio chiavi o del certificato quando utilizzato nella connessione TLS per la verifica. | ||
ERROR_NO_PROFILES_AVAILABLE | Nessun profilo disponibile da SM-DP+. | ||
ERROR_CONNECTION_ERROR | Impossibile creare una connessione al server. | ||
ERROR_INVALID_RESPONSE | Risposta non valida dal server SM-DP+/SM-DS. | ||
OPERATION_SWITCH | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione di commutazione. | |
ERROR_CARRIER_LOCKED | Non è consentito cambiare profilo perché il dispositivo è bloccato dall'operatore (SIM bloccata). | ||
OPERATION_DOWNLOAD | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione di download. | |
ERROR_DISALLOWED_BY_PPR | La tabella di autorizzazione delle regole su eUICC è nulla oppure il download non è consentito dalla regola della policy del profilo. | ||
ERROR_INVALID_ACTIVATION_CODE | Si è verificato un errore durante l'analisi del codice di attivazione (formato non valido) o durante il tentativo di download senza codice di attivazione. | ||
ERROR_CARRIER_LOCKED | Download non consentito perché il dispositivo è bloccato dall'operatore (SIM bloccata). | ||
ERROR_INCOMPATIBLE_CARRIER | L'operatore è nella lista nera e LPA non può scaricare un profilo da SM-DP+/SM-DS. | ||
ERROR_OPERATION_BUSY | Il download del profilo è in corso e non sono consentite altre azioni che potrebbero attivare modifiche allo stato della SIM. | ||
OPERATION_METADATA | Non applicabile | Si è verificato un errore interno durante l'esecuzione dell'operazione sui metadati. | |
ERROR_INVALID_ACTIVATION_CODE | I metadati dell'abbonamento sono vuoti oppure il codice di attivazione all'interno dei metadati dell'abbonamento è vuoto o non valido. | ||
ERROR_INCOMPATIBLE_CARRIER | L'operatore è nella lista nera e LPA non può scaricare il profilo di questo operatore da SM-DP+/SM-DS. | ||
OPERATION_EUICC_GSMA | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione GSMA eUICC. | |
ERROR_INSTALL_PROFILE | Errore con eUICC durante il tentativo di installazione del profilo. Ad esempio, il profilo esiste già o l'ICCID non corrisponde. | ||
ERROR_EUICC_INSUFFICIENT_MEMORY | Errore con eUICC durante il tentativo di installazione del profilo. Memoria insufficiente sull'eUICC. | ||
ERROR_DISALLOWED_BY_PPR | Errore con eUICC durante il tentativo di installazione del profilo. Non consentito dalla regola dei criteri del profilo. | ||
OPERATION_APDU | Non applicabile | Si è verificato un errore interno durante l'esecuzione di un'operazione APDU. | |
OPERATION_HTTP | 1-999 | Il codice di errore è un valore di errore HTTP. | |
Codice operazione | Codice oggetto | Codice motivo | Descrizione |
OPERATION_SMDX_SUBJECT_REASON_CODE | La stringa contiene 3 cifre separate da punto, senza zeri iniziali. Ad esempio, 8.1.1 . | La stringa contiene 3 cifre separate da punto senza zeri iniziali. Ad esempio, 3.8 . | ObjectCode[5.2.6.1] e ReasonCode[5.2.6.2] da GSMA (SGP.22 v2.2). Ad esempio, un ObjectCode di 8.1.1 e un ReasonCode di 3.8 significa che l'EID è associato a un altro dispositivo. |