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 résultant :

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

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

  • Le code d'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 les SubjectCode[5.2.6.1] et ReasonCode[5.2.6.2] de la 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 les SubjectCode[5.2.6.1] et ReasonCode[5.2.6.2] de la 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 des erreurs spécifiques individuellement. 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 compatibles

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