Gérer les erreurs de l'API eUICC

Les API eUICC fournissent des codes d'erreur pour aider les applications et les utilisateurs à résoudre les problèmes liés au téléchargement, à l'activation, à la désactivation et à la suppression des profils eSIM.

Gérer les erreurs

Lorsqu'une erreur se produit lors de l'appel de l'API eUICC, un rappel d'intent en attente est fourni et EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE est utilisé comme clé pour obtenir le code d'erreur détaillé. À partir d'Android 11, les quatre clés et valeurs suivantes sont incluses dans l'intent obtenu :

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE : fournit des informations sur ce qui s'est mal passé. (téléchargement ou suppression d'un profil eSIM, par exemple). Ce champ n'est jamais vide.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE : informations sur la cause de l'erreur. Par exemple, la demande a expiré ou l'appareil est verrouillé par l'opérateur. Ce champ n'est pas renseigné dans les cas suivants :

  • Le code de l'opération est OPERATION_SMDX_SUBJECT_REASON_CODE.
  • L'erreur est une erreur de bas niveau, telle que IOException ou InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE : Utilisé avec EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE, qui fournissent ensemble SubjectCode[5.2.6.1] et ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Ce champ n'est renseigné que lorsque le code d'opération est OPERATION_SMDX_SUBJECT_REASON_CODE.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE : Utilisé avec EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE, qui fournissent ensemble SubjectCode[5.2.6.1] et ReasonCode[5.2.6.2] de GSMA (SGP.22 v2.2). Ce champ n'est renseigné que lorsque le code d'opération est OPERATION_SMDX_SUBJECT_REASON_CODE.

Ces quatre valeurs permettent à l'appelant de l'API eUICC de gérer individuellement des erreurs spécifiques. Voici un exemple de gestion de ces erreurs.

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

Combinaisons d'opérations et de codes d'erreur acceptées

Le tableau suivant décrit la combinaison d'opérations et de codes d'erreur compatibles renvoyés par l'assistant de profil local (LPA).