📱 Appium Test Suite for Samsung Calculator

This project is an automated UI test suite written in Java using Appium, JUnit 5, and Maven. It tests basic arithmetic operations on the Samsung Calculator app pre-installed on Samsung Android devices.

✨ Features

• 🚀 Appium setup using UiAutomator2
• ✅ Tests for addition, subtraction, multiplication, division, and error handling
• 🧪 Reusable utility methods for key actions
• 🔧 Configuration via environment variables

---

🛠 Prerequisites

Ensure the following tools are installed and configured:

• Java 11+
• Maven
• Appium Server
• Node.js
• Android SDK + Emulator
• Samsung Calculator app installed on a real or virtual Samsung device (version 12.3.05.8 or higher)

---

📦 Installation

Clone the repository:

git clone https://github.com/Artenes/appium-calculator-tests.git
cd appium-calculator-tests

Install dependencies:

mvn clean install

---

🔧 Environment Setup

Before running the tests, set these environment variables:

Variable Name	Description	Example
CALC_TEST_APPIUM_SERVER_URL	Appium server URL	http://127.0.0.1:4723/

Linux/macOS

export CALC_TEST_APPIUM_SERVER_URL="http://127.0.0.1:4723/"

Windows (CMD)

set CALC_TEST_APPIUM_SERVER_URL=http://127.0.0.1:4723/

---

▶️ Running the Tests

Start your Appium server in a separate terminal:

appium

Then run the tests with Maven:

mvn test

---

📂 Project Structure

src/
└── test/
    └── java/
        └── org/
            └── example/
                └── MainTest.java

---

✅ Test Cases Included

• testAddition() – Verifies 2 + 2 = 4
• testSubtraction() – Verifies 8 - 3 = 5
• testMultiplication() – Verifies 6 × 7 = 42
• testDivision() – Verifies 8 ÷ 2 = 4
• testDivisionByZero() – Tests division by 0 behavior
• testClearButton() – Tests the clear button resets input

---

📘 Notes

• Only works on Samsung devices that have the stock Calculator app (com.sec.android.app.popupcalculator)
• Tests use implicit waits for basic synchronization
• Tests can be extended to include scientific functions or history features if available

---

🧑‍💻 Author

Artenes Junior Gomes Nogueira

• GitHub: https://github.com/Artenes
• LinkedIn: https://linkedin.com/in/artenes

---

📄 License

This project is open-source and available under the MIT License.