eUICC API hatalarını ele alma

eUICC API'leri uygulamaların ve kullanıcıların eSIM profillerini indirme, etkinleştirme, devre dışı bırakma ve silme ile ilgili sorunları gidermelerine yardımcı olmak için hata kodları sağlar.

Hataları işleme

eUICC API çağrılırken bir hata oluşursa bekleyen intent geri çağırması sağlanır ve ayrıntılı hata kodunu alma anahtarı olarak EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE kullanılır. Android 11'den itibaren aşağıdaki dört anahtar ve değer, sonuç amacına dahil edilmiştir:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: Ne tür bir hata oluştuğu hakkında bilgi sağlar. Örneğin, eSIM profili indirme veya silme. Bu alan hiçbir zaman boş değildir.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Hatanın neden oluştuğuyla ilgili bilgiler. Örneğin, istek zaman aşımına uğradıysa veya cihaz operatör kilitliyse. Aşağıdaki durumlarda bu alan doldurulmaz:

  • İşlem kodu: OPERATION_SMDX_SUBJECT_REASON_CODE.
  • Hata, IOException veya InterruptedException gibi düşük düzeyde bir hatadır.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE ile birlikte kullanılır. Bu iki parametre birlikte GSMA'dan (SGP.22 v2.2) SubjectCode[5.2.6.1] ve ReasonCode[5.2.6.2] değerlerini sağlar. Bu alan yalnızca işlem kodu OPERATION_SMDX_SUBJECT_REASON_CODE olduğunda doldurulur.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE ile birlikte kullanılır. Bu iki parametre birlikte GSMA'dan (SGP.22 v2.2) SubjectCode[5.2.6.1] ve ReasonCode[5.2.6.2] değerlerini sağlar. Bu alan yalnızca işlem kodu OPERATION_SMDX_SUBJECT_REASON_CODE olduğunda doldurulur.

Bu dört değer, eUICC API çağrısı yapan kişinin belirli hataları ayrı ayrı ele almasına olanak tanır. Aşağıda, bu hataların nasıl ele alınacağına dair bir örnek verilmiştir.

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

Desteklenen işlem ve hata kodu kombinasyonları

Aşağıdaki tabloda, yerel profil asistanı (LPA) tarafından döndürülen işlem ve hata kodlarının desteklenen kombinasyonu açıklanmaktadır.