Framework for Mobile test automation (Native app and Browser) on Android and IOS devices 📱

1. Install Java JDK8 and IntelliJ IDEA
2. Install NodeJS
3. Install Android studio
4. Install Appium Server using npm (CLI) command npm install -g appium. Appium server version 1.22.1

Command to check the installed appium version: `appium --version`

5. Add below Android SDK path in the environment variable

    - ANDROID_HOME = <path to Sdk folder>
    - %ANDROID_HOME%\tools
    - %ANDROID_HOME%\tools\bin
    - %ANDROID_HOME%\platform-tools

6. Install Appium desktop
7. Install Appium Inspector

1. Install Homebrew
2. Install NodeJS
3. Install Java JDK8 and IntelliJ IDEA
4. Install Appium server using npm (CLI) or Appium desktop client
5. Install Android studio
6. Install Appium Inspector
7. Set JAVA_HOME and ANDROID_HOME environment variables

1. Install appium-doctor using command npm install -g appium-doctor
2. To view the list of available options appium-doctor --help

To check Android set up `appium-doctor --android`
To check ios set up `appium-doctor --ios`

1. Open Android Studio.
2. Click on Tools -> AVD Manager -> Create Virtual Device -> Select the device and OS version -> Finish.
3. Once Virtual device is created, click on Launch this AVD in the emulator.
4. Command to view the list of devices attached adb devices

1. Connect Android real device to the machine(Desktop/Laptop)
2. Turn on the developer options in android mobile
3. Enable USB debugging
4. Run command adb devices in cmd prompt to check whether the device is recognised

1. Download Vysor

1. Open command prompt, go to <sdk emulator path>

Command to stard AVD: `emulator -avd <avd_name>`
Command to stop/kill AVD: `adb -e emu kill`

1. Copy the .apk file and paste it in the path - <path to sdk platform-tools>
2. Open the cmd terminal from the directory where APK file is placed and enter command adb install <apk filename>

If the app is already installed on your device then we can make use of appPackage and appActivity to launch the app

Option 1 :

1. Open the app on the device, for which appPackage and appActivity is required.
2. Open powershell and enter command adb shell dumpsys window | grep -E 'mCurrentFocus|mFocusedApp' NOTE: This command may not work for newer Android OS (10 or 11). In that case, use command: adb shell "dumpsys activity activities | grep mResumedActivity"

Option 2 : Install APK info app to retrieve appPackage and appActivity for the app installed in your device

1. Go to the path - <path to sdk folder>\tools\bin\
2. click on uiautomatorviewer
3. On the UI Automator Viewer, click on Device Screenshot (uiautomator dump). Ui automator will capture the screenshot of current open screen in the device.

1. Start the Appium Server and connect with Real device/Emulator.
2. Open Appium Inspector app and provide the appium server details and Desired Capabilities.

3. Click on Start session which will start the appium inspector with layout shown below.

Type url `chrome://inspect/#devices` in the desktop chrome browser and start inspecting element

Add below lines in the Desired capabilities

capability.setCapability(AndroidMobileCapabilityType.AVD, "Pixel_3a");
capability.setCapability(AndroidMobileCapabilityType.AVD_LAUNCH_TIMEOUT, "180000");

Start appium server using command appium --allow-insecure chromedriver_autodownload

Add below line in the AppiumServiceBuilder

AppiumServiceBuilder builder = new AppiumServiceBuilder();
builder.withArgument(GeneralServerFlag.ALLOW_INSECURE, "chromedriver_autodownload");

Use AppiumServiceBuilder and AppiumDriverLocalService to start the server programmatically Set environment variable APPIUM_HOME = <path to npm folder>\node_modules\appium\build\lib where main.js file is present

👉 Supports Android and iOS Real Devices and Emulators.

👉 Ability to start and stop the appium server on run-time. Configurable through config.properties

👉 Supports capturing appium server logs on run-time.

👉 Page object model design.

👉 Supports parallel and sequential execution of tests.

👉 Ability to capture screen(video) recording of tests on Android and iOS. Configurable through config.properties

👉 Supports capturing screenshots for passed/failed/skipped steps which is configurable through config.properties

👉 Ability to retry failed tests which is configurable through config.properties

👉 Customised exception handling to provide the exceptions in a meaningful way.

👉 Custom framework annotation to provide author name and category for each test.

👉 Supports utilities to read test data from excel workbook and provides data to each test based on the test name.

👉 Run test using command mvn test -Dsurefire.suiteXmlFiles=<provide the testng xml to execute>

👉 Create or Select the required testng xml -> Right click and select Run