RobotFramework - Mykonos

Introduction

Mykonos is a complete test automation tools for Android Device using Robot Framework and UI Automator (Python), it easy to learn because Mykonos use BDD syntax to write the test cases.

Installation

 pip install mykonos

Usage

• Download and Install the android emulator base on the guidance Genymotion or Android Emulator.
• Make sure emulator is available by checking with adb devices, for more detail info please check the adb command on ADB Shell guidance.
• Make sure Robot Framework is able to run by execute robot --version and it will get Robot Framework version as a result.
• Create a file (sample.robot).
• Import Mykonos Library on the Robot Framework Test Suite.
• Write test case base on Robot Framework guidance.

Code Example

Below is the sample test case for testing an Application Messaging (sample.robot).

*** Settings ***
Library                                           mykonos

*** Variables ***
${activity_apk}                                   com.android.messaging/com.android.messaging.ui.conversationlist.ConversationListActivity
${apk}                                            com.android.messaging
${sender_number}                                  0812345678
${message}                                        helllo
${emulator}                                       192.168.56.131:5555

*** keywords ***
Open Application
    Open App                                        devices_parallel=${emulator}     package=${activity_apk}

Click Icon Message
    Click Element                                   text=Messaging    devices_parallel=${emulator}

Click Icon New Message
    Click Element                                   resourceId=com.android.messaging:id/start_new_conversation_button   devices_parallel=${emulator}

Input Phone Number
    [Arguments]                                     ${input_phonenumber}
    Input Text                                      text=To    devices_parallel=${emulator}   input=${input_phonenumber}

Press Enter
    Press Keycode                                   keys=enter     devices_parallel=${emulator}

Input Message
    [Arguments]                                     ${input_message}
    Input Text                                      className=android.widget.EditText   devices_parallel=${emulator}   input=${input_message}

Click Send Message
    Click Element                                   resourceId=com.android.messaging:id/send_message_button    className=android.widget.ImageButton      devices_parallel=${emulator}

Close Application
    Close App                                       package=${apk}      devices_parallel=${emulator}

*** Test Cases ***
Test Case Input Phone Number on Application Messaging
    Open Application
    Click Icon New Message
    Input Phone Number                              ${sender_number}
    Press Enter
    Input Message                                   ${message}
    Click Send Message
    Close Application

Run The Test

Run the test case by execute robot sample.robot on your terminal.

Documentation Detail

Mykonos Documentation

Contribution

• Forks repo and clone to your local computer.
• Checkout the source code from development branch.
• Modified, create unit test and make sure the code is running well on local.
• Commit and pull request the changes to development branch.

Contributors

• Monica Danesa (Monica Danesa)
  
• Ahmad Andriana Khadafi (Andriana Khadafi)
• Ichsan Hariadi (Ichsan Hariadi)

Credit

Thanks to uiautomator's and thewife author to inspire us to make this library.