טיפול בשגיאות ב-eUICC API

ממשקי ה-API של eUICC מספקים קודי שגיאה כדי לעזור לאפליקציות ולמשתמשים לפתור בעיות שקשורות להורדה, להפעלה, להשבתה ולמחיקה של פרופילי eSIM.

טיפול בשגיאות

אם מתרחשת שגיאה במהלך קריאה ל-eUICC API, מוחזרת קריאה חוזרת (callback) של intent בהמתנה, וEXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE משמש כמפתח לקבלת קוד השגיאה המפורט. החל מ-Android 11, ארבעת המפתחות והערכים הבאים נכללים ב-Intent שמתקבל:

• ‫EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: מידע על מה שהשתבש. לדוגמה, הורדה או מחיקה של פרופיל eSIM. השדה הזה אף פעם לא ריק.

• ‫EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: מידע על הסיבה להתרחשות השגיאה. לדוגמה, אם חלף הזמן הקצוב לתגובה לבקשה או שהמכשיר נעול על ידי ספק הסלולר. השדה הזה לא מאוכלס במקרים הבאים:

  • קוד הפעולה הוא OPERATION_SMDX_SUBJECT_REASON_CODE.
  • השגיאה היא שגיאה ברמה נמוכה, כמו IOException או InterruptedException.

• ‫EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: משמש עם EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE, ושניהם ביחד מספקים את SubjectCode[5.2.6.1] ו-ReasonCode[5.2.6.2] מ-GSMA‏ (SGP.22 v2.2). השדה הזה מאוכלס רק כשקוד הפעולה הוא OPERATION_SMDX_SUBJECT_REASON_CODE.

• ‫EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: משמש עם EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE, ושניהם ביחד מספקים את SubjectCode[5.2.6.1] ו-ReasonCode[5.2.6.2] מ-GSMA‏ (SGP.22 v2.2). השדה הזה מאוכלס רק כשקוד הפעולה הוא OPERATION_SMDX_SUBJECT_REASON_CODE.

ארבעת הערכים האלה מאפשרים לשולח הקריאה ל-eUICC API לטפל בשגיאות ספציפיות בנפרד. בדוגמה הבאה אפשר לראות איך לטפל בשגיאות האלה.

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

שילובים נתמכים של פעולות וקודי שגיאה

בטבלה הבאה מתוארת השילוב הנתמך של פעולות וקודי שגיאה שמוחזרים מהכלי המקומי לניהול פרופילים (LPA).