🚀 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

• 🤖 Android device running OS 11 or newer
• 📦 Android APK file
• 📨 Mailosaur account credentials. Required for successful user signup test cases

🔧 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:

• 📥 Download from Android's official website
• 🍺 Or install via Homebrew: brew install android-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:

• 🌐 Local access:
  • Run npm run android-report to view Android reports
  • Run npm run ios-report to view iOS reports
• 🔗 Remote access:
  • 🤖 Remote Android Report
  • 🍎 Remote iOS Report

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

🚧 Section to be completed

💡 Pro Tips

• 🔒 Always keep your .env files secure and out of version control
• 🔄 Ensure you have the latest versions of Docker and Appium
• 📱 Test on multiple device configurations for comprehensive coverage