SimpleCalculatorJavaAndroid — README (українською, без коду)

Це репозиторій простого калькулятора на Java + XML (Views). Нижче інструкції, як отримати проєкт з GitHub, відкрити в Android Studio, зібрати й запустити. Наприкінці — короткий перелік відмінностей від початкового макета.

---

1) Де лежить проєкт

Репозиторій: https://github.com/Lion6477/SimpleCalculatorJavaAndroid

---

2) Як завантажити проєкт

Варіант A — через ZIP

1. Кнопка «Code» → «Download ZIP».
2. Розпакуй архів у зручну теку (напр., Документи/AndroidProjects/SimpleCalculatorJavaAndroid).

Варіант B — через Git

1. Переконайся, що встановлено Git.
2. Створи порожню теку для проєктів.
3. Клонуй репозиторій у цю теку (git clone <URL репозиторію>).

---

3) Як відкрити в Android Studio

1. Запусти Android Studio → «Open» → обери теку SimpleCalculatorJavaAndroid.
2. Дочекайся синхронізації Gradle. Якщо з’явиться діалог про встановлення відсутніх компонентів SDK — погоджуйся.
3. Переконайся, що Gradle JDK = Embedded JDK 17 (Settings → Build Tools → Gradle).

---

4) Збірка і запуск

1. У верхньому меню: «File → Sync Project with Gradle Files», потім «Build → Make Project».
2. Створи емулятор (AVD): Tools → Device Manager → Create device → будь-який Pixel → обери системний образ x86_64 (Android 14/15). • Graphics: ANGLE (D3D11) або Software. • Перший запуск краще робити Cold Boot (через меню ⋮ у Device Manager).
3. У тулбарі обери конфігурацію «app», праворуч вибери створений AVD, натисни Run.
4. Для фізичного телефону: увімкни Developer options → USB debugging, підключи USB-кабель і обери пристрій у тулбарі.

---

5) Часті питання / діагностика

• Емулятор не стартує або чорний екран: зроби Wipe Data + Cold Boot; у Device Manager встанови Graphics = ANGLE (D3D11) або Software; використовуй саме x86_64-образ.
• Помилка про Java: проєкт налаштовано під Java 17 — у Studio перевір Gradle JDK = 17.
• Кнопки не працюють або падіння застосунку: переконайся, що запускається саме цей проєкт (не старий), і що застосунок інсталювався з нуля (Uninstall → Run).

---

6) Відмінності від початкового коду (що було зроблено)

1. Правильні одиниці виміру: заміна pt на dp (розміри) і sp (шрифти) за гайдлайнами Android.
2. Екран калькулятора: поле виводу зроблено некерованим з клавіатури (без курсора і без фокусу), правильне вирівнювання праворуч і коректна робота ваги (висота через 0dp + layout_weight).
3. Повний набір кнопок: додано відсутні кнопки (4, 5, 7, 8, 9), що усуває можливі падіння через відсутні id.
4. Одна узгоджена сітка: впорядковано TableLayout з рівномірним розтягуванням колонок; кнопка «0» ширша для зручності; прибрані випадкові змішані верстки наприкінці.
5. Логіка калькулятора: реалізовано повний цикл обчислень (+, −, ×, ÷, =) із проміжними підрахунками при послідовних операціях, зміна знака, крапка з одним входженням, захист від ділення на нуль ( показ «Error» і блок до AC), приємне форматування (цілі без «.0»).
6. Інфраструктура проєкту: прибрано залежність від Compose/Kotlin; залишено чистий Java + Views; маніфест містить правильну launch-активність і тему Material без ActionBar; налаштовано сучасні SDK-цілі.
7. Рекомендації з емулятора: x86_64-образи, Graphics = ANGLE/Software, Cold Boot — як частина інструкцій, щоби прибрати початкові проблеми зі стартом.

---

7) Критерії приймання (для перевірки роботи)

• Запуск застосунку без помилок на AVD або фізичному пристрої.
• Коректна робота операцій: додавання, віднімання, множення, ділення, «=».
• Коректний ввод цифр і крапки (не більше однієї крапки на число, автоматичне «0.» при початку з крапки).
• Кнопки AC і +/− працюють очікувано.
• При діленні на нуль — «Error», подальший ввід блокується до натискання AC.