eUICC API hatalarını işleme

eUICC API'leri, uygulamaların ve kullanıcıların eSIM profillerinin indirilmesi, etkinleştirilmesi, devre dışı bırakılması ve silinmesiyle ilgili sorunları gidermesine yardımcı olmak için hata kodları sağlar.

Hataları işleme

eUICC API çağrılırken bir hata oluştuğunda bekleyen amaç geri çağrısı sağlanır ve ayrıntılı hata kodunu almak için anahtar olarak EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE kullanılır. Android 11'den itibaren, sonuçtaki amaçta aşağıdaki dört anahtar ve değer yer alır:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: Neyin yanlış gittiği hakkında bilgi verir. Örneğin, eSIM profili indirme veya silme. Bu alan asla boş değildir.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Hataya neden olan durumla ilgili bilgiler. Örneğin, istek zaman aşımına uğradı veya cihaz operatör tarafından kilitlendi. Bu alan aşağıdaki durumlarda doldurulmaz:

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

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE ile birlikte kullanılır. Bu iki alan, 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 alan, 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'yi çağıranın belirli hataları ayrı ayrı işlemesine 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ından (LPA) döndürülen desteklenen işlem ve hata kodu kombinasyonu açıklanmaktadır.