wukong

Introduction

OpenHarmony stability testing automation tool simulates disorderly user behavior to stress test the stability of OpenHarmony systems and applications.

wukong component architecture diagram

Submodule responsibilities within the component：

1. Command line parsing: allows you to obtain and parse parameters on the command line.
   
2. Running environment management: Initialize the overall wukong running environment according to the command line.
   
3. System interface management: Check and get the specified mgr, register controller and dfx faultlog callback functions.
   
4. Random event generation: Generate a random sequence with a specified number of seeds through the random function to generate events.
   
5. Event injection: Inject events into the system based on supported event types, relying on subsystems such as Windows, multimode, and security.
   
6. Exception capture and processing/report generation: The DFX subsystem obtains anomaly information in operation and records logs to generate reports.
   

Directory

├── wukong                              # wukong main code file
|   └── common                          # Provides application control capabilities, random event injection capabilities, multi-mode event injection capabilities
|   └── component_event                 # Define the ability, page, Component tree to provide the ability to add nodes, traverse the tree, find child nodes by NodeId, etc
|   └── input_factory                   # Realize the screen click, slide, drag, keyboard and other events injection ability    
|   └── report                          # Monitor abnormal information, collect, collect statistics, and display it
|   └── shell_command                   # Used to create a command line map, parse the command line parameters, and execute the command line              
|   └── test_flow                                  
│       └── include                     # Defining Header files
│       └── src                     
│           ├── random_test_flow.cpp    # Inherited from TestFlow, is the execution flow of random tests
│           ├── special_test_flow.cpp   # Inherited from TestFlow, is the execution flow of sequential specific tests
│           ├── focus_test_flow.cpp     # Inherited from TestFlow, is the execution flow of focus specific tests
│           ├── test_flow.cpp           # Check whether the command line parameters conform to specifications
│   ── BUILD.gn                         # Store the configuration of wukong construction, including construction object, method, dependency, hardware architecture, and file format
│   ── README_zh.md                     # The readme file

Constraints

1. wukong began presetting after system version 3.2
   
2. Versions of wukong prior to version 3.2 do not compile with the version. When using wukong, you need to compile and push it to the OpenHarmony device under test. The procedure is as follows：
   2.1. Build a way

   ./build.sh --product-name rk3568 --build-target wukong
   

   2.2. push

   hdc_std shell mount -o rw,remount /
   hdc_std file send wukong /
   hdc_std shell chmod a+x /wukong
   hdc_std shell mv /wukong /bin/
   

Directions for use

Function Features and Command Description

Command	Description	Note
wukong version	Get wukong version information	-v, --version
wukong help	Get wukong help information
wukong appinfo	Query support pulling up the application bundleName and the corresponding mainAbility name
wukong special	wukong special test
wukong exec	wukong randomly tests
wukong focus	wukong focus tests

wukong special description

Command	Features	Required	Note
-h, --help	Get help information for the current test.	No	Specialized test help information.
-k, --spec_insomnia	Sleep wake-up special test.	No	-
-c, --count	Set the Number of executions.	No	The default is 10 times.
-i, --interval	Set the execution interval.	No	Unit ms, default 1500ms.
-S, --swap	Sliding test.	No	-
-s, --start[x,y]	Set the slide test start coordinates.	No	-
-e, --end[x,y]	Set the slide test end coordinates.	No	-
-b, --bilateral	Set the round-trip swipe.	No	By default, there is no round-trip swipe.
-t, --touch[x,y]	Click test.	No	-
-T, --time	Set the total test time.	No	Unit minutes, the default is 10 minutes.
-p, --screenshot	Screenshot of control testing.	No	-
-C, --component	The control sequentially traverses the test.	No	You need to set the test app name.

Example of wukong Special test

> hdc_std shell
# wukong special -C [bundlename] -p

Specific test example parsing：

Command	Parameter Value	Description
wukong special		The main commands.
-C [bundlename]	[bundlename]	Control to sequentially traverse the test parameter Settings, bundlename is the name of the test application.
-p		Represents a screenshot.

wukong random description

Command	Features	Required	Note
-h,--help	Get help information for the current test.	No	Random test help information.
-c,--count	Set the Number of executions, conflicts with -T.	No	The number of units, the default is 10 times.
-i,--interval	Set the execution interval.	No	Unit ms, default 1500ms.
-s,--seed	Set the Random Seed.	No	Configuring the same random seed results in the same random event sequence.
-b,--bundle[bundlename,......,bundlename]	Set the list of allowed applications for this test, and the -p conflict.	No	By default, test all apps for the current device (app names separated by commas).
-p,--prohibit[bundlename,......,bundlename]	Set the list of prohibited apps for this test, which conflicts with -b.	No	By default, no applications are prohibited (application names are separated by commas).
-d,--page[page,……,page]	Set the list of prohibited pages for this test	Np	The system default prohibits pages/system pages (page names separated by commas).
-a,--appswitch	Set the app random pull-up test scale.	No	The default 10%.
-t,--touch	Set the screen random touch test ratio.	No	The default 10%.
-S,--swap	Set the screen random swap test scale.	No	The default 3%.
-m,--mouse	Set the screen randommou test ratio.	No	The default 1%.
-k,--keyboard	Set the screen random keyboard test ratio.	No	The default 2%.
-H,--hardkey	Set the random hardkey test scale.	No	The default 2%.
-r,--rotate	Set the random rotate test scale.	No	The default 2%.
-C, --component	Set the Random Control Test Scale.	No	The default 70%.
-I, --screenshot	Screenshot of control testing.	No	-
-T,--time	Set the total test time, conflicts with -c.	No	Unit minutes, the default is 10 minutes.
-U, -uri	Sets the URI of the page where an app is launched.	No	-
-x, -uriType	Sets the URI type of the page where an app is launched.	No	-
-K, -knuckle	Set the knuckle knock test ratio.	No	Default is 0.
-f, -finger	Set the number of fingers for tests such as swipe and knuckle knock.	No	Supports configuring 1-4 fingers, format: -f 1,0.5,2,0.5
-P, -pinch	Set the pinch test ratio.	No	Default is 0.
-D, -direction	Set the swipe direction.	No	Supports configuring four methods: up (u), down (d), left (l), right (r), format: -D u,0.25,d,0.25,l,0.25,r,0.25
-o, -pause	Set whether pausing is supported during the swipe process.	No	-
-w, -crown	Set the watch crown operation test ratio.	No	Only supported on watches, default is 0.
-g, -gestures	Set the gesture operation test ratio.	No	Only supported on watches, default is 0.
-l, -idle	Set the idle operation test ratio.	No	Only supported on watches, default is 0.
-j, -keypress	Set the key press operation test ratio.	No	Only supported on watches, default is 0.
-F, -float	Set the split-screen and floating window test ratio for apps.	No	Default is 0.
-W, -browser	Set the browser operation test ratio.	No	Default is 0.

Instructions: Configuring the same random seed results in the same sequence of random events

Example of wukong exec random test

> hdc_std shell
# wukong exec -s 10 -i 1000 -a 0.28 -t 0.72 -c 100

Random test example parsing：

Command	Parameter Value	Description
wukong exec		The main command.
-s	10	Parameter set random seed, 10 is the seed value.
-i	1000	Parameter Settings apply pull up interval, 1000 unit ms.
-a	0.28	Parameter Settings Apply random pull up test ratio 28%.
-t	0.72	Parameter Settings Screen random touch test proportion is 72%.
-c	100	Parameter Setting The number of execution times is 100.

wukong random description

Command	Features	Required	Note
-n,--numberfocus	Set focus number for components.	No
-f, --focustypes	Set the component type to focus on.	No	"," to split if more than one.
Other params are same as exec.

Release notes

3.2.0.0 Release content: Preset wukong supports the following functions:

1. Support the whole machine application pull up, set the random seed, set the application pull up interval, set the application pull up times, support the query application pull up bundle name and ability name.
   
2. Support random injection of events, support random injection of controls, support sleep and wake up special tests, support control sequence traversal screenshots special tests.
   
3. Supports wukong run log printing.
   
4. White and blacklist applications are supported.