Създаване на калкулатор на бакшиши на Kotlin: как работи?

Разказваме как да създадете просто приложение за изчисляване на бакшиши на езика Kotlin. По-точно, Kotlin 1.3.21, Android 4, Android Studio 3. Статията ще бъде интересна предимно за тези, които започват своя път в разработката на Android приложения. Тя позволява да разберете какво и как работи вътре в приложението.

Този калкулатор ще е полезен, когато трябва да се изчисли сумата на бакшишите от компания, решила да прекара време в ресторант или кафе. Разбира се, не всички и не винаги оставят за бакшиш, това е повече западна традиция, но процесът на разработка на такова приложение е интересен по всяко време.

Напомняме: за всички читатели на "Хабра" — отстъпка от 10 000 рубли при записване на всякакъв курс на Skillbox с промокод "Хабр".

Skillbox препоръчва: Практически курс Мобилен разработчик PRO.

Ето как изглежда приложението в процес на работа:

Вие въвеждате желания процент от общата сума, броя на участниците в срещата и получавате резултата — сумата на бакшишите, които трябва да оставите.

Започваме

Пълният интерфейс на приложението изглежда по следния начин:




Първото действие — зареждане на основата на проекта. Отваряме я в Android Studio 3.0 или по-късно. Изграждаме и стартираме проекта и виждаме бял екран. Всичко е наред, така и трябва да бъде.

Действията на потребителя са записани в проекта в хронологичен ред, за да бъде всичко ясно. За да го прегледате, отворете View -> Tool Windows -> TODO.

Изучаваме проекта и отваряме colors.xml, за да оценим цветната палитра. В strings.xml са разположени текстовите данни (надписи), а в styles.xml има няколко шаблона за шрифтове.

Разработка на раздела разходи

Отваряме activity_main.xml и добавяме разположения код в LinearLayout (#1):

Сега можем да настроим стила на директорията values или да поиграем с цветовете, използвайки инструмента material.io.

В момента проектът изглежда така:

Както виждате, разходите се изчисляват въз основа на данните, които въвежда потребителят.

Разработка на раздела сметки

Добавяме кода, разположен по-долу, в LinearLayout след Expense Section (#2):

<! — TODO #3: Build Bill Section →
 
…

Затваряме LinearLayout след списъка с TODOs и след това добавяме новия код, разположен в LinearLayout (#3):

Тъй като основната задача на приложението е изчисляването на индивидуалните разходи за всеки от участниците в ресторантските вечери, основно значение има costPerPersonTextView.

EditText ограничава въвеждането на данни до един ред, а за този параметър трябва да бъде зададен тип NumberDecimal inputType.

Стартираме проекта за тест и въвеждаме параметрите за общите щети (разбитите чаши, чинии и т.н.)

Разработване на раздела „Хора и бакшиши“

За да добавим опция за избор на обема на бакшишите, поставяме следния код в новия раздел LinearLayout (#4):

Тази част от кода е необходима за точното изчисление на сумата на бакшишите. Дефолтната стойност на текста е 20. ImageButtons са снабдени с иконки в папката с права за запис.

Изцяло копираме раздела и добавяме следното (#5):

• ImageButton ids (subtractPeopleButton, addPeopleButton)
• TextView ids (numberOfPeopleStaticText, numberOfPeopleTextView)
• DefaultText за numberOfPeopleTextView (трябва да бъде 4).

Сега при стартиране на приложението имаме възможност да добавим сумата на сметката, също така работят бутоните „Добави/Вземи“, но все още нищо не се случва.

Добавяне на Views

Отваряме MainActivity.kt и добавяме това в функцията initViews (#6):

private fun initViews() {
        expensePerPersonTextView = findViewById(R.id.expensePerPersonTextView)
        billEditText = findViewById(R.id.billEditText)
 
addTipButton = findViewById(R.id.addTipButton)
        tipTextView = findViewById(R.id.tipTextView)
        subtractTipButton = findViewById(R.id.subtractTipButton)
 
addPeopleButton = findViewById(R.id.addPeopleButton)
        numberOfPeopleTextView = findViewById(R.id.numberOfPeopleTextView)
        subtractPeopleButton = findViewById(R.id.subtractPeopleButton)
 
//TODO #8: Связываем кнопки с слушателем
 
//TODO #16: Связываем EditText с TextWatcher
 
}

Довършваме бутоните

За да добавим поддръжка на кликвания на бутоните, внедряваме View.OnClickListener на ниво клас (#7):

class MainActivity: AppCompatActivity(), View.OnClickListener {

Сега не можем да компилираме проекта, трябва да извършим още няколко действия (#8):

override fun onClick(v: View?) {
        when (v?.id) {
            R.id.addTipButton -> incrementTip()
            R.id.subtractTipButton -> decrementTip()
            R.id.addPeopleButton -> incrementPeople()
            R.id.subtractPeopleButton -> decrementPeople()
        }
    }

Що се отнася до бутоните и превключвателите, в Kotlin всичко е организирано много добре! Добавяме следния код във всички функции за увеличаване и намаляване
(#9 –#12):

private fun incrementTip() {
        if (tipPercent != MAX_TIP) {
            tipPercent += TIP_INCREMENT_PERCENT
            tipTextView.text = String.format("%d%%", tipPercent)
        }
    }
 
private fun decrementTip() {
        if (tipPercent != MIN_TIP) {
            tipPercent -= TIP_INCREMENT_PERCENT
            tipTextView.text = String.format("%d%%", tipPercent)
        }
    }
 
private fun incrementPeople() {
        if (numberOfPeople != MAX_PEOPLE) {
            numberOfPeople += PEOPLE_INCREMENT_VALUE
            numberOfPeopleTextView.text = numberOfPeople.toString()
        }
    }
 
private fun decrementPeople() {
        if (numberOfPeople != MIN_PEOPLE) {
            numberOfPeople -= PEOPLE_INCREMENT_VALUE
            numberOfPeopleTextView.text = numberOfPeople.toString()
        }
    }

Тук кодът защитава функциите за увеличаване с максималните стойности (MAX_TIP & MAX_PEOPLE). Освен това, кодът защитава функциите за намаляване с минимума (MIN_TIP & MIN_PEOPLE).

Сега свързваме бутоните със слушателите в функцията initViews (#13):

private fun initViews() {
 
...
 
addTipButton.setOnClickListener(this)
        subtractTipButton.setOnClickListener(this)
 
addPeopleButton.setOnClickListener(this)
        subtractPeopleButton.setOnClickListener(this)
 
//TODO #15: Свързваме EditText с TextWatcher
}

Сега можем да добавяме общи разходи, бакшиши и брой участници в срещата. А сега най-важното...

Раздел за изчисляване на разходите

Този код изчислява разходите (#14):

private fun calculateExpense() {
 
val totalBill = billEditText.text.toString().toDouble()
 
val totalExpense = ((HUNDRED_PERCENT + tipPercent) / HUNDRED_PERCENT) * totalBill
        val individualExpense = totalExpense / numberOfPeople
 
expensePerPersonTextView.text = String.format("$%.2f", individualExpense)
 
}

А тук се извиква функция, която позволява да вземем предвид броя на хората в компанията и да изчислим бакшиша (#15):

private fun incrementTip() {
 
…
 
}
 
private fun decrementTip() {
 
…
 
}
 
private fun incrementPeople() {
 
…
 
}
 
private fun decrementPeople() {
 
…
 
}

Стартираме приложението. Изглежда и работи отлично. Но може да бъде и по-добре.

Ако се опитате да премахнете сумата на сметката и след това да увеличите броя на подсказките или приятелите, приложението ще срине, тъй като все още няма проверка за нулева стойност на разходите. Освен това, ако се опитате да промените сумата на сметката, разходите няма да бъдат актуализирани.

Финални стъпки

Добавяне на TextWatcher (#16):

class MainActivity: AppCompatActivity(), View.OnClickListener, TextWatcher {

След това вграждаме слушател в billEditText (#17):

billEditText.addTextChangedListener(this)

Освен това добавяме код за изпълнение на TextWatcher (#18):

override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {
        if (!billEditText.text.isEmpty()) {
            calculateExpense()
        }
    }
override fun afterTextChanged(s: Editable?) {}

    override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}

А сега всичко работи перфектно! Поздравления, написахте собствен «Калкулатор на бакшиши» на Kotlin.

Skillbox препоръчва:

• Двугодишен практически курс „Аз съм Веб-разработчик PRO“.
• Онлайн курс „C# разработчик“.
• Практически годишен курс «PHP разработчик от 0 до PRO».

Източник: habr.com