TcknViewLibraryProject - TcknView

Android için TCKN (TC Kimlik No) kontrolü yapan kütüphane projesi.

TC Kimlik No Doğrulama Algoritması

• Kural-1: Tüm karakterleri rakam olmalıdır.
• Kural-2: TC Kimlik numarası 11 basamaktan oluşmalıdır.
• Kural-3: İlk hanesi 0 olamaz.
• Kural-4: İlk 9 basamak arasındaki algoritma, 10. basmağı vermelidir.
• İşlem: 1. 3. 5. 7. ve 9. hanelerin toplamının 7 katından, 2. 4. 6. ve 8. hanelerin toplamı çıkartıldığında, elde edilen sonucun 10′a bölümünden kalan, yani Mod10′u bize 10. haneyi verir.
• Kural-5: İlk 10 basamak arasındaki algoritma, 11. basamağı vermelidir.
• İşlem: 1. 2. 3. 4. 5. 6. 7. 8. 9. ve 10. hanelerin toplamından elde edilen sonucun 10′a bölümünden (Mod 10) kalan, bize 11. haneyi verir.

Kullanımı

Xml

<com.egemenmede.tcknviewlibrary.TcknView
        android:id="@+id/tcknView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/tckn_hint" />

Java

tcknView = findViewById(R.id.tcknView);
tcknView.checkTextChangedListener(new TextWatcher() {
    @Override
    public void beforeTextChanged(CharSequence charSequence, int i, int i1, int i2) {
        // beforeTextChanged
    }

    @Override
    public void onTextChanged(CharSequence charSequence, int i, int i1, int i2) {
        String txtInput = charSequence.toString();

        if (tcknView.getFirstValueZeroStatus(txtInput) && tcknView.isVisibleErrorMessege()){
                //DEFAULT: tcknView.setError(tcknView.getDefaultErrorMessege());
                tcknView.setError(getString(R.string.tckn_rule3_messege));
        }else{
            if (tcknView.getNumberOfChrs(txtInput) != 0) {
                tcknView.setError(String.format(getString(R.string.tckn_number_of_chrs), tcknView.getNumberOfChrs(txtInput)));
            }
            if (tcknView.getNumberOfChrs(txtInput) == tcknView.getChrCount() || tcknView.getNumberOfChrs(txtInput) == 0) {
                tcknView.setErrorEnabled(false);
            }
            if (txtInput.length() >= tcknView.getChkCount() && tcknView.getRuleFourStatus(txtInput).equals(false) && tcknView.isVisibleErrorMessege()){
                //DEFAULT: tcknView.setError(tcknView.getDefaultErrorMessege());
                tcknView.setError(getString(R.string.tckn_rule4_messege));
            }
            if (txtInput.length() >= tcknView.getChrCount() && tcknView.getRuleFiveStatus(txtInput).equals(false) && tcknView.isVisibleErrorMessege()){
                //DEFAULT: tcknView.setError(tcknView.getDefaultErrorMessege());
                tcknView.setError(getString(R.string.tckn_rule5_messege));
            }
        }

    }

    @Override
    public void afterTextChanged(Editable editable) {
        // afterTextChanged
    }
});

İstenirse XML içerisinden ya da kod içerisinde 2 özelliği üzerinde parametrik olarak değişiklik yapılabilir.

tckn:visibleErrorMessege="true"
tckn:defaultErrorMessege="Default Message"

İsterseniz TC Kimlik No Doğrulama Algoritması içerisindeki her bir hata şekli için ayrı ayrı mesajlar verebildiğiniz gibi, hepsi için tek bir mesaj da verebilirsiniz.

Bunun için defaultErrorMessege parametresine istediğiniz mesajı verebilirsiniz. Oluşacak hataların gösterilmesi ya da gösterilmemesini istiyorsanız visibleErrorMessegeparametresinin değerini true veya false olarak verebilirsiniz.

XML içerisinde hiç bir parametre belirtilmemişse varsayılan değerleri true ve Default Message dır.

string.xml

<resources>
    <string name="app_name">TcknView</string>
    <string name="tckn_default_error_messege">Geçersiz TCKN Numarası</string>
    <string name="tckn_hint">TC Kimlik Numarası</string>
    <string name="tckn_rule3_messege">İlk hanesi 0 olamaz.</string>
    <string name="tckn_rule2_messege">TC Kimlik numarası 11 basamaktan oluşmalıdır.</string>
    <string name="tckn_rule4_messege">İlk 9 basamak arasındaki algoritma, 10. basamağı vermelidir.</string>
    <string name="tckn_rule5_messege">İlk 10 basamak arasındaki algoritma, 11. basamağı vermelidir.</string>
    <string name="tckn_number_of_chrs">Kalan karakter sayısı: %1$d</string>
</resources>

Her hata türü için farklı bir mesaj vermek isterseniz yukarıdaki gibi hata mesajlarını değiştirebilirsiniz.

style.xml

<style name="DefaultTcknStyle">
    <item name="visibleErrorMessege">true</item>
    <item name="defaultErrorMessege">@string/tckn_default_error_messege</item>
</style>

XML içerisinde her hangi bir parametre belirtmediğinizde alınacak varsayılan değerleri de buradan değiştirebilirsiniz.

Kurulum

Kütüphaneyi Android projenizde kullanmak için aşağıdakileri gradle dosyalarınıza eklemelisiniz.

Project build.gradle altında

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}

Module:app build.gradle altında

dependencies {
  implementation "com.google.android.material:material:1.0.0"
  implementation 'com.github.egemenmede:TcknViewLibraryProject:1.0.0'
}

Kütüphane Destek

Kütüphane minimum Android 4.1 (API level 16)'dan, Android 10 (API level 29)'a kadar sorunsuz çalışmaktadır.