Nocca
english / korean

INTRODUCTION

With Nocca, you can easily make Test script based on Appium by recording the sequence of GUI actions.


With Nocca, you can easily make Test script based on Appium by recording the sequence of GUI actions. you can replay the actions in Nocca to compare and examine and export the recorded data into Appium script. To make you free from building and managing complex mobile farm, you can upload your recorded data into AppTest.ai(mobile test cloud service, coming soon) and test on multiple mobile devices with a few clicks.

Nocca records the test app's activity by using Android's Accessiblity and Input Event(/dev/input/eventx). Nocca is directly accessing android's input event device(/dev/input/eventx) which requires Nocca to have strong previlege beyond normal app permission. To maximize the capability and to overcome test recording and replaying limitation, we recommend to use nocca on root privileges phones. Otherwise, in normal phone, you have to use Input Event Daemon with adb connected in USB.

* Information
- Nocca only records the events of the app you have designated to test. Also, Except for Script Export & upload feature, Nocca has no feature for sending information out of device.
- Any password entered during recording session, will never be saved. When password is required in replay session, it will be asked again every time.

* Nocca's Access Permission Requirement
- Accessiblity Permission is required to receive and to record Accessibility Event.
- Draw over on other apps access is required to activate the drawing events on the test app.
- Media Projection is required to capture the screenshot.
- Storage Access is required to save XML, screenshot, and Appium script export.
- Internet Access is required only for exporting recorded data to AppTest.ai service.


btn_google_down

DOCUMENTATION


1. Using Input Event Daemon

We assume you have correctly installed and configured Android SDK on your PC.

(Android adb shell command is only usable when your device and PC is connected with USB/Network)

We assume terminal enviroment (i.e. Linux) where Shell script can be run.


1) Download Input Event Daemon

Download : event_daemon.zip


2) Decompression

apptest_ai_recorder_ied_1


3) Installation & Execution

apptest_ai_recorder_ied_2

When the installation is completed, you can check with following command from terminal:
adb shell "ps | grep event_daemon"
* When you restart your phone, please make sure to start Input Event Daemon manually.



2. Recording

1) Grant permissions

- Accessiblity Permission is required to receive and to record Accessibility Event.
- Draw over on other apps access is required to activate the drawing events on the test app.
- Media Projection is required to capture the screenshot.

apptest_ai_recorder_record_1
apptest_ai_recorder_record_2
apptest_ai_recorder_record_3
apptest_ai_recorder_record_4
apptest_ai_recorder_record_5
apptest_ai_recorder_record_6
apptest_ai_recorder_record_7


2) Choose target app & Start recording

apptest_ai_recorder_record_8
apptest_ai_recorder_record_9
apptest_ai_recorder_record_10
apptest_ai_recorder_record_11


3) Stop recording

When you want to stop recording, you press volume up/down button.

apptest_ai_recorder_record_12
apptest_ai_recorder_record_13
apptest_ai_recorder_record_14


3. Replay

When you want to stop replay, you press back/home button.

apptest_ai_recorder_replay_1
apptest_ai_recorder_record_2
apptest_ai_recorder_record_3


4. Export & Execute Appium Script

1) Export

You can save Screenshot, captured XML, and Appium Script into your device storage(i.e. sd card).

Storage Access is needed to save XML, screenshot, and Appium script export.

apptest_ai_recorder_export_1
apptest_ai_recorder_export_2
apptest_ai_recorder_export_3
apptest_ai_recorder_export_4


2) Turn on USB MTP enabled to copy file to PC.

When you want to download the exported file from device storage to your PC, your PC and the device are connected with USB with MTP mode.

apptest_ai_recorder_export_mtp_1
apptest_ai_recorder_export_mtp_2
apptest_ai_recorder_export_mtp_3
apptest_ai_recorder_export_mtp_4


3) When you device USB is MTP mode, you can access (i.e. list, upload, download) the device storage from your PC.

apptest_ai_recorder_export_mtp_5


4) Open File Browser. Then browse to device storage, and you will find Download directory.

apptest_ai_recorder_export_mtp_6


5) Exported folder will be located Under Download directory.

apptest_ai_recorder_export_mtp_7


6) Screenshot, Captured XML, and Appium Script will be located in Exported folder.

apptest_ai_recorder_export_mtp_8


7) When you edit the Appium Script, You will see following data. Your password for the security reason is not saved during recording session.

Thus exported script doesn't know the password and will not work on later password challege if it exists. If you don't want this, please configure PASSWORD environment variable with your app's password.

apptest_ai_recorder_export_script_1

apptest_ai_recorder_export_script_2


8) Replay the recorded session with Appium Script

Now, run Appium and run the Appium Script. It will replay any actions that you recorded previously.

apptest_ai_recorder_export_script_3