التعامل مع أخطاء واجهة برمجة التطبيقات eUICC

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تقدّم واجهات برمجة التطبيقات eUICC رموز خطأ لمساعدة التطبيقات والمستخدمين في تحديد المشاكل وحلّها المتعلّقة بتحميل ملفات eSIM الشخصية وتفعيلها وإيقافها وحذفها.

معالجة الأخطاء

عند حدوث خطأ أثناء استدعاء واجهة برمجة التطبيقات eUICC API، يتم توفير أسلوب استدعاء للنشاط في انتظار المراجعة وEXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE يتم استخدامه كمفتاح للحصول على رمز الخطأ التفصيلي. بدءًا من Android 11، يتم تضمين المفاتيح والقيم الأربعة التالية في النية الناتجة:

• 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).