app-testing-appium

🚀 Appium Testing Guide For project Finna

🛠️ Environment Setup

  1. Copy .env.example to create either:
    • .env.ios for iOS testing
    • .env.android for Android testing
    • or both if testing both platforms

🐳 Running Tests with Docker Appium Host (Recommended)

Using this method enables you to skip the Appium setup process

📋 Requirements

🔧 Environment Configuration

  1. In .env.android, set:
    • APK_PATH: Absolute path of your Android APK file
    • MAILOSAUR_ID: Your Mailosaur server ID
    • MAILOSAUR_KEY: Your Mailosaur API key

🛠️ Setting Up Android Tools

If you don’t have Android Studio installed, you’ll need Android SDK platform tools:

🔌 Connect Device and Run Test

  1. 📱 Connect Android Device
    • 📶 Enable wireless debugging on your Android device
    • 🌐 Connect device via Wi-Fi following Android’s wireless setup guide
    • ✅ Verify connection by running: adb devices
  2. 🚢 Start Docker Container
    • 🖥️ Run ./docker-start.sh on MAC/Linux or ./docker_start.ps1 on Windows to build and start the docker container
    • 🔍 Verify container is running: docker ps (look for appium-android)

  3. 🔗 Run docker exec -it appium-android adb devices to verify that connected devices on host machine is also connected to the docker container.

  4. 🧪 Run Android test cases on connected device: 
    npm run android

📊 Viewing Test Reports

Reports are autogenerated after every test run:

💻 Running Tests with Appium on Local Machine (Android/iOS)

🚧 Section to be completed

💡 Pro Tips