1# wukong 2## Introduction 3 4OpenHarmony stability testing automation tool simulates disorderly user behavior to stress test the stability of OpenHarmony systems and applications.<br> 5 6wukong component architecture diagram<br> 7<br> 8 9Submodule responsibilities within the component：<br> 101. Command line parsing: allows you to obtain and parse parameters on the command line.<br> 112. Running environment management: Initialize the overall wukong running environment according to the command line.<br> 123. System interface management: Check and get the specified mgr, register controller and dfx faultlog callback functions.<br> 134. Random event generation: Generate a random sequence with a specified number of seeds through the random function to generate events.<br> 145. Event injection: Inject events into the system based on supported event types, relying on subsystems such as Windows, multimode, and security.<br> 156. Exception capture and processing/report generation: The DFX subsystem obtains anomaly information in operation and records logs to generate reports.<br> 16 17## Directory 18 19``` 20├── wukong # wukong main code file 21| └── common # Provides application control capabilities, random event injection capabilities, multi-mode event injection capabilities 22| └── component_event # Define the ability, page, Component tree to provide the ability to add nodes, traverse the tree, find child nodes by NodeId, etc 23| └── input_factory # Realize the screen click, slide, drag, keyboard and other events injection ability 24| └── report # Monitor abnormal information, collect, collect statistics, and display it 25| └── shell_command # Used to create a command line map, parse the command line parameters, and execute the command line 26| └── test_flow 27│ └── include # Defining Header files 28│ └── src 29│ ├── random_test_flow.cpp # Inherited from TestFlow, is the execution flow of random tests 30│ ├── special_test_flow.cpp # Inherited from TestFlow, is the execution flow of sequential specific tests 31│ ├── test_flow.cpp # Check whether the command line parameters conform to specifications 32│ ── BUILD.gn # Store the configuration of wukong construction, including construction object, method, dependency, hardware architecture, and file format 33│ ── README_zh.md # The readme file 34``` 35 36## Constraints 37 381. wukong began presetting after system version 3.2<br> 392. 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：<br> 40 2.1. Build a way 41 ``` 42 ./build.sh --product-name rk3568 --build-target wukong 43 ``` 44 2.2. push 45 ``` 46 hdc_std shell mount -o rw,remount / 47 hdc_std file send wukong / 48 hdc_std shell chmod a+x /wukong 49 hdc_std shell mv /wukong /bin/ 50 ``` 51 52## Directions for use 53 54### Function Features and Command Description 55 56 57| Command | Description | Note | 58| -------------- | ---------------------------------------------- | ------------- | 59| wukong version | Get wukong version information | -v, --version | 60| wukong help | Get wukong help information | | 61| wukong appinfo | Query support pulling up the application bundleName and the corresponding mainAbility name | | 62| wukong special | wukong special test | | 63| wukong exec | wukong randomly tests | | 64 65 66### wukong special description 67 68| Command | Features | Required | Note | 69| :------------------ | ---------------------- | ---- | :------------------ | 70| -h, --help | Get help information for the current test. | No | Specialized test help information. | 71| -k, --spec_insomnia | Sleep wake-up special test. | No | - | 72| -c, --count | Set the Number of executions. | No | The default is 10 times. | 73| -i, --interval | Set the execution interval. | No | Unit ms, default 1500ms. | 74| -S, --swap | Sliding test. | No | - | 75| -s, --start[x,y] | Set the slide test start coordinates. | No | - | 76| -e, --end[x,y] | Set the slide test end coordinates. | No | - | 77| -b, --bilateral | Set the round-trip swipe. | No | By default, there is no round-trip swipe. | 78| -t, --touch[x,y] | Click test. | No | - | 79| -T, --time | Set the total test time. | No | Unit minutes, the default is 10 minutes. | 80| -C, --component | The control sequentially traverses the test. | No | You need to set the test app name. | 81 82#### Example of wukong Special test 83```bash 84> hdc_std shell 85# wukong special -C [bundlename] -p 86``` 87Specific test example parsing： 88| Command | Parameter Value | Description | 89| -------------- | -------------- | ---------------------------------------------- | 90| wukong special | | The main commands. | 91| -C [bundlename] |[bundlename]| Control to sequentially traverse the test parameter Settings, bundlename is the name of the test application. | 92| -p | | Represents a screenshot. | 93 94### wukong random description 95 96| Command | Features | Required | Note | 97| --------------- | ------------------------------------ | ---- | ---------------------------------------- | 98| -h,--help | Get help information for the current test. | No | Random test help information. | 99| -c,--count | Set the Number of executions, conflicts with -T. | No | The number of units, the default is 10 times. | 100| -i,--interval | Set the execution interval. | No | Unit ms, default 1500ms. | 101| -s,--seed | Set the Random Seed. | No | Configuring the same random seed results in the same random event sequence. | 102| -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). | 103| -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). | 104| -a,--appswitch | Set the app random pull-up test scale. | No | The default 10%. | 105| -t,--touch | Set the screen random touch test ratio. | No | The default 10%. | 106| -S,--swap | Set the screen random swap test scale. | No | The default 3%. | 107| -m,--mouse | Set the screen randommou test ratio. | No | The default 1%. | 108| -k,--keyboard | Set the screen random keyboard test ratio. | No | The default 2%. | 109| -H,--hardkey | Set the random hardkey test scale. | No | The default 4%. | 110| -C, --component | Set the Random Control Test Scale. | No | The default 70%. | 111| -T,--time | Set the total test time, conflicts with -c. | No | Unit minutes, the default is 10 minutes. | 112 113> Instructions: Configuring the same random seed results in the same sequence of random events 114 115#### Example of wukong exec random test 116```bash 117> hdc_std shell 118# wukong exec -s 10 -i 1000 -a 0.28 -t 0.72 -c 100 119``` 120Random test example parsing： 121| Command | Parameter Value | Description | 122| -------------- | -------------- | ---------------------------------------------- | 123| wukong exec | | The main command. | 124| -s | 10 | Parameter set random seed, 10 is the seed value. | 125| -i | 1000 | Parameter Settings apply pull up interval, 1000 unit ms. | 126| -a | 0.28 | Parameter Settings Apply random pull up test ratio 28%. | 127| -t | 0.72 | Parameter Settings Screen random touch test proportion is 72%. | 128| -c | 100 | Parameter Setting The number of execution times is 100. | 129 130## Release notes 131 1323.2.0.0 Release content: Preset wukong supports the following functions:<br> 1331. 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.<br> 1342. Support random injection of events, support random injection of controls, support sleep and wake up special tests, support control sequence traversal screenshots special tests.<br> 1353. Supports wukong run log printing.<br> 1364. White and blacklist applications are supported.
