رسیدگی به خطاهای «میانای برنامه‌سازی کاربردی eUICC»

واسط‌های برنامه‌نویسی کاربردی eUICC کدهای خطا را ارائه می‌دهند تا به برنامه‌ها و کاربران در عیب‌یابی مشکلات مربوط به بارگیری، فعال‌سازی، غیرفعال‌سازی، و حذف نمایه‌های سیم‌کارت داخلی کمک کنند.

مدیریت کردن خطاها

وقتی هنگام فراخوانی «میانای برنامه‌سازی کاربردی eUICC» خطایی رخ می‌دهد، یک برگشت هدف معلقه ارائه می‌شود و EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE به‌عنوان کلید دریافت کد خطای دقیق استفاده می‌شود. از Android 11، چهار کلید و مقدار زیر در هدف نتیجه گنجانده شده است:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: اطلاعاتی درباره اینکه چه چیزی اشتباه بوده است ارائه می‌دهد. برای مثال، بارگیری یا حذف نمایه سیم‌کارت داخلی. این فیلد هرگز خالی نیست.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: اطلاعات درباره دلیل بروز خطا. برای مثال، درخواست زمان‌بندی شده است یا دستگاه قفل شرکت مخابراتی دارد. این فیلد در موارد زیر درج نمی‌شود:

  • کد عملیات OPERATION_SMDX_SUBJECT_REASON_CODE است.
  • خطا از نوع خطای سطح پایین مانند IOException یا InterruptedException است.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: با EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE استفاده می‌شود که با هم «کد موضوع» [5.2.6.1] و «کد دلیل» [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 استفاده می‌شود که با هم «کد موضوع» [5.2.6.1] و «کد دلیل» [5.2.6.2] را از GSMA (SGP.22 v2.2) ارائه می‌دهند. این فیلد فقط زمانی تکمیل می‌شود که کد عملیات OPERATION_SMDX_SUBJECT_REASON_CODE باشد.

این چهار مقدار به فراخواننده میانای برنامه‌سازی کاربردی eUICC اجازه می‌دهد خطاهای خاص را به‌طور جداگانه مدیریت کند. در زیر مثالی از نحوه رسیدگی به این خطاها آورده شده است.

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) را شرح می‌دهد.