Как сделать буквы заглавными в editText?

Ваша проблема связана с TextWatcher, а не с логикой того, что вы пишете. Блок кода ниже вызывает проблему (endless cycle begins when i'm setting validated data back to the edittext becouse it calls method ontextCahnged() again)

if (hasChanged) {
    String newText = sb.toString();
    textHeading.setText(capitalize(newText)); // <<<<<< This line is culprit which is calling Watcher's method again and again.
    textHeading.setSelection(currentSelection);
}

Чтобы решить эту проблему, вам необходимо выполнить следующие шаги

1. Удалить наблюдателя из EditText
2. Установить текст
3. Добавьте Наблюдателя в EditText.

Для получения дополнительной информации прочитайте Как я могу изменить текст EditText без запуска Text Watcher?

Есть много способов сделать это:

1- Использование общих утилит

Библиотека: http://commons.apache.org/proper/commons-lang/

StringUtils.capitalize(..)

2- Пользовательским методом

public static String upperCaseFirst(String value) {

        // Convert String to char array.
        char[] array = value.toCharArray();
        // Modify first element in array.
        array[0] = Character.toUpperCase(array[0]);
        // Return string.
        return new String(array);
    }

3- Из общего апача

Библиотека: http://commons.apache.org/proper/commons-lang/

WordUtils.capitalize(java.lang.String)

Теперь вы можете назначить эту строку в поле ввода.

Вы можете установить тип ввода (EditText) на TYPE_CLASS_TEXT | TYPE_TEXT_FLAG_CAP_CHARACTERS.

ИЛИ

Установите android:inputType="textCapSentences" в свой EditText.

Вы можете перейти по этой ссылке https://developer.android.com/reference/android/text/InputFilter.AllCaps

Вы можете использовать следующий InputFilter.AllCaps

или это

android:inputType="textCapCharacters"

Почему бы не использовать флаг? Я изменил ваш код, добавив флаг boolean setManually.

boolean setManually = false;
@Override
        public void onTextChanged(CharSequence s, int start, int before, int count) {
            Log.d("qwer", "onTextChanged: " + s + " " + start + " " + before + " " + count);
            if (setManually) {
                 setManually = false;
                  return;
            }

            String originalText = s.toString();
            int originalTextLength = originalText.length();
            int currentSelection = textHeading.getSelectionStart();

            StringBuilder sb = new StringBuilder();
            boolean hasChanged = false;
            for (int i = 0; i < originalTextLength; i++) {
                char currentChar = originalText.charAt(i);
                if (isAllowed(currentChar) && i < 21) {
                    sb.append(currentChar);
                } else {
                    hasChanged = true;
                    textHeading.setError("Please insert current letters");
                }
            }
            if (hasChanged) {
                String newText = sb.toString();
                 setManually = true;
                textHeading.setText(capitalize(newText));
                textHeading.setSelection(currentSelection);
            }
        }

Вы можете просто использовать в XML

android:inputType="textCapCharacters"

нет необходимости писать код для заглавной буквы.

Попробуйте так:

  String originalText = s.toString().toUpperCase();

or

if (hasChanged) {
            String newText = sb.toString().toUpperCase();
            textHeading.setText(newText);
            textHeading.setSelection(currentSelection);
        }