Kea2-python 0.3.5__tar.gz → 1.0.0__tar.gz

{kea2_python-0.3.5 → kea2_python-1.0.0}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.3.5
+Version: 1.0.0
 Summary: A python library for supporting and customizing automated UI testing for mobile apps
 Author-email: Xixian Liang <xixian@stu.ecnu.edu.cn>
 Requires-Python: >=3.8
@@ -64,11 +64,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 **The ability of the three features in Kea2**
 
-|  | **Feature 1** | **Feature 2** | **Feature 3** |
-| --- | --- | --- | ---- |
-| **Finding crashes** | :+1: | :+1: | :+1: |
-| **Finding crashes in deep states** |  | :+1: | :+1: |
-| **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
+|                                                  | **Feature 1** | **Feature 2** | **Feature 3** |
+| ------------------------------------------------ | ------------- | ------------- | ------------- |
+| **Finding crashes**                              | :+1:          | :+1:          | :+1:          |
+| **Finding crashes in deep states**               |               | :+1:          | :+1:          |
+| **Finding non-crashing functional (logic) bugs** |               |               | :+1:          |
 
 ## Kea2's Users
 
@@ -78,6 +78,10 @@ Kea2 (and its idea) has been used/integrated by
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform
 
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
 Please let us know and willing to hear your feedback/questions if you are also using Kea2.
@@ -115,6 +119,15 @@ Upgrade Kea2 to its latest version if you already installed Kea2 before:
 ```bash
 python3 -m pip install -U kea2-python
 ```
+> If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
+
+Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python==0.3.6
+```
+
+
+
 
 ## Quick Test
 
@@ -145,9 +158,8 @@ Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issue
 
 Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
-
 ```bash
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
+kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
 To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
@@ -196,7 +208,7 @@ You can find the full example in script `quicktest.py`, and run this script with
 
 ```bash
 # Launch Kea2 and load one single script quicktest.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d propertytest discover -p quicktest.py
 ```
 
 ## Feature 3(运行增强版Fastbot：加入自动断言)
@@ -220,7 +232,7 @@ In a social media app, message sending is a common feature. On the message sendi
 <div align="center">
     The expected behavior (the upper figure) and the buggy behavior (the lower figure).
 </div>
-    
+​    
 
 For the preceding always-holding property, we can write the following script to validate the functional correctness: when there is an `input_box` widget on the message sending page, we can type any non-empty string text into the input box and assert `send_button` should always exists.
 
@@ -243,9 +255,37 @@ For the preceding always-holding property, we can write the following script to
 
 You can run this example by using the similar command line in Feature 2.
 
+## Feature 4 (Experimental feature, 实验中，脚本与遍历的混合测试)
+
+> This feature is still under development. We are looking forward to your feedback! Contact us if you're interested in this feature.
+
+Kea2 supports reusing existing Ui test Scripts. We are inspired by the idea that: *The existing Ui test scripts usually cover important app functionalities and can reach deep app states. Thus, they can be used as good "guiding scripts" to drive Fastbot to explore important and deep app states.*
+
+For example, you may already have some existing Ui test scripts "login and add a friend", This feature allows you to use the existing script, set some breakpoints (i.e., interruptable points) in the script, and launch Fastbot to explore the app after every breakpoint. By using this feature, you can do the login first and then launch Fastbot to explore the app after login. Which helps Fastbot to explore deep app states. (fastbot can't do login by itself easily).
+
+### Example
+
+See [guide_scripts.py](guide_scripts.py) for a full example.
+
+By the decorator `@interruptable`, you can mark the testcase as "interruptable" so that Kea2 can recognize this script and launch fuzzing test after it returns. 
+
+Since the state of app is probably unpredicted after fuzzing tests, Kea2 provides a `common_teardown` function to clean up the environment between previous script and next script. The function can be manually specified in `configs/teardown.py`.
+
+You can find the full example in `guide_scripts.py`, `property_omninotes.py`  and `configs/teardown.py` .  You can run one of the following commands:
+
+```bash
+# Guide with guide_scripts.py and launch fuzzing test after every script.
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py 
+
+# Guide with guide_scripts.py and launch fuzzing test after every script(check properties during fuzzing).
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py propertytest discover -p quickstart2.py
+```
+
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.
+Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+
+If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
 
 The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
 
@@ -253,14 +293,19 @@ The reports support both single test runs and merged analysis of multiple test s
 
 ## Documentations（更多文档）
 
+
+### :blue_book: [User Manual](docs/manual_en.md) (Important!)
 You can find the [user manual](docs/manual_en.md), which includes:
 - Examples of using Kea2 on WeChat (in Chinese);
 - How to define Kea2's scripts and use the decorators (e.g., `@precondition`、`@prob`、`@max_tries`);
 - How to run Kea2 and Kea2's command line options
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
+
+### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -275,13 +320,13 @@ Some blogs on Kea/Kea2 (in Chinese):
   <summary>Kea2的性质是什么含义？Kea2意义和价值是什么？</summary>
 
     kea2 其实是一个工具，它是python+u2+fastbot的集合体。 它本身更像是一台装好了发动机和轮子的汽车底盘。
-
+    
     性质是苏老师他们团队提出的一个概念， 转换到测试领域的实际工作中，性质对应的是最小单位的功能（原子级功能），性质的依赖条件很少或没有，它可以自身运行。一个典型的性质就是登录，它仅仅具有输入用户名，输入密码，提交。再举个例子，给视频点个赞，也就是简单的两三步。就是一个性质。
-
+    
     性质与kea2结合的意义是在于解决过去使用appium过重的问题。用appium去测试一个性质通常要写很多行的代码，引导界面到达性质的位置。但使用kea2，就只需要编写性质，如何到其所在的位置是交给fastbot和它的学习算法来搞定的。 
-
+    
     kea2另个重大的价值是，它解决了上述思想所需要的技术支撑，比appium更轻量的UI编写方式，fastbot编写性质的能力不足，以及无法编写逻辑和断言。整体上是保留了fastbot以往的优秀品质，完善了其不足和短板。
-
+    
     简而言之，需要做传统的编排型的功能测试，仍然使用appium，使用kea2也行，但你感觉不到它的价值。本身有需要做混沌测试，模糊测试，兼容性测试。那么强烈，强烈推荐kea2。kea2更偏探索性测试而非编排型。
 </details>
 
@@ -344,6 +389,10 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
+### Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.3.5 → kea2_python-1.0.0}/Kea2_python.egg-info/SOURCES.txt

@@ -16,10 +16,13 @@ kea2/fastbotManager.py
 kea2/keaUtils.py
 kea2/kea_launcher.py
 kea2/logWatcher.py
+kea2/mixin.py
 kea2/report_merger.py
 kea2/resultSyncer.py
 kea2/u2Driver.py
 kea2/utils.py
+kea2/version_manager.py
+kea2/assets/config_version.json
 kea2/assets/fastbot-thirdpart.jar
 kea2/assets/framework.jar
 kea2/assets/kea2-thirdpart.jar
@@ -32,6 +35,7 @@ kea2/assets/fastbot_configs/max.fuzzing.strings
 kea2/assets/fastbot_configs/max.schema.strings
 kea2/assets/fastbot_configs/max.strings
 kea2/assets/fastbot_configs/max.tree.pruning
+kea2/assets/fastbot_configs/teardown.py
 kea2/assets/fastbot_configs/widget.block.py
 kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so
 kea2/assets/fastbot_libs/armeabi-v7a/libfastbot_native.so

{kea2_python-0.3.5 → kea2_python-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.3.5
+Version: 1.0.0
 Summary: A python library for supporting and customizing automated UI testing for mobile apps
 Author-email: Xixian Liang <xixian@stu.ecnu.edu.cn>
 Requires-Python: >=3.8
@@ -64,11 +64,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 **The ability of the three features in Kea2**
 
-|  | **Feature 1** | **Feature 2** | **Feature 3** |
-| --- | --- | --- | ---- |
-| **Finding crashes** | :+1: | :+1: | :+1: |
-| **Finding crashes in deep states** |  | :+1: | :+1: |
-| **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
+|                                                  | **Feature 1** | **Feature 2** | **Feature 3** |
+| ------------------------------------------------ | ------------- | ------------- | ------------- |
+| **Finding crashes**                              | :+1:          | :+1:          | :+1:          |
+| **Finding crashes in deep states**               |               | :+1:          | :+1:          |
+| **Finding non-crashing functional (logic) bugs** |               |               | :+1:          |
 
 ## Kea2's Users
 
@@ -78,6 +78,10 @@ Kea2 (and its idea) has been used/integrated by
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform
 
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
 Please let us know and willing to hear your feedback/questions if you are also using Kea2.
@@ -115,6 +119,15 @@ Upgrade Kea2 to its latest version if you already installed Kea2 before:
 ```bash
 python3 -m pip install -U kea2-python
 ```
+> If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
+
+Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python==0.3.6
+```
+
+
+
 
 ## Quick Test
 
@@ -145,9 +158,8 @@ Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issue
 
 Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
-
 ```bash
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
+kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
 To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
@@ -196,7 +208,7 @@ You can find the full example in script `quicktest.py`, and run this script with
 
 ```bash
 # Launch Kea2 and load one single script quicktest.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d propertytest discover -p quicktest.py
 ```
 
 ## Feature 3(运行增强版Fastbot：加入自动断言)
@@ -220,7 +232,7 @@ In a social media app, message sending is a common feature. On the message sendi
 <div align="center">
     The expected behavior (the upper figure) and the buggy behavior (the lower figure).
 </div>
-    
+​    
 
 For the preceding always-holding property, we can write the following script to validate the functional correctness: when there is an `input_box` widget on the message sending page, we can type any non-empty string text into the input box and assert `send_button` should always exists.
 
@@ -243,9 +255,37 @@ For the preceding always-holding property, we can write the following script to
 
 You can run this example by using the similar command line in Feature 2.
 
+## Feature 4 (Experimental feature, 实验中，脚本与遍历的混合测试)
+
+> This feature is still under development. We are looking forward to your feedback! Contact us if you're interested in this feature.
+
+Kea2 supports reusing existing Ui test Scripts. We are inspired by the idea that: *The existing Ui test scripts usually cover important app functionalities and can reach deep app states. Thus, they can be used as good "guiding scripts" to drive Fastbot to explore important and deep app states.*
+
+For example, you may already have some existing Ui test scripts "login and add a friend", This feature allows you to use the existing script, set some breakpoints (i.e., interruptable points) in the script, and launch Fastbot to explore the app after every breakpoint. By using this feature, you can do the login first and then launch Fastbot to explore the app after login. Which helps Fastbot to explore deep app states. (fastbot can't do login by itself easily).
+
+### Example
+
+See [guide_scripts.py](guide_scripts.py) for a full example.
+
+By the decorator `@interruptable`, you can mark the testcase as "interruptable" so that Kea2 can recognize this script and launch fuzzing test after it returns. 
+
+Since the state of app is probably unpredicted after fuzzing tests, Kea2 provides a `common_teardown` function to clean up the environment between previous script and next script. The function can be manually specified in `configs/teardown.py`.
+
+You can find the full example in `guide_scripts.py`, `property_omninotes.py`  and `configs/teardown.py` .  You can run one of the following commands:
+
+```bash
+# Guide with guide_scripts.py and launch fuzzing test after every script.
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py 
+
+# Guide with guide_scripts.py and launch fuzzing test after every script(check properties during fuzzing).
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py propertytest discover -p quickstart2.py
+```
+
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.
+Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+
+If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
 
 The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
 
@@ -253,14 +293,19 @@ The reports support both single test runs and merged analysis of multiple test s
 
 ## Documentations（更多文档）
 
+
+### :blue_book: [User Manual](docs/manual_en.md) (Important!)
 You can find the [user manual](docs/manual_en.md), which includes:
 - Examples of using Kea2 on WeChat (in Chinese);
 - How to define Kea2's scripts and use the decorators (e.g., `@precondition`、`@prob`、`@max_tries`);
 - How to run Kea2 and Kea2's command line options
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
+
+### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -275,13 +320,13 @@ Some blogs on Kea/Kea2 (in Chinese):
   <summary>Kea2的性质是什么含义？Kea2意义和价值是什么？</summary>
 
     kea2 其实是一个工具，它是python+u2+fastbot的集合体。 它本身更像是一台装好了发动机和轮子的汽车底盘。
-
+    
     性质是苏老师他们团队提出的一个概念， 转换到测试领域的实际工作中，性质对应的是最小单位的功能（原子级功能），性质的依赖条件很少或没有，它可以自身运行。一个典型的性质就是登录，它仅仅具有输入用户名，输入密码，提交。再举个例子，给视频点个赞，也就是简单的两三步。就是一个性质。
-
+    
     性质与kea2结合的意义是在于解决过去使用appium过重的问题。用appium去测试一个性质通常要写很多行的代码，引导界面到达性质的位置。但使用kea2，就只需要编写性质，如何到其所在的位置是交给fastbot和它的学习算法来搞定的。 
-
+    
     kea2另个重大的价值是，它解决了上述思想所需要的技术支撑，比appium更轻量的UI编写方式，fastbot编写性质的能力不足，以及无法编写逻辑和断言。整体上是保留了fastbot以往的优秀品质，完善了其不足和短板。
-
+    
     简而言之，需要做传统的编排型的功能测试，仍然使用appium，使用kea2也行，但你感觉不到它的价值。本身有需要做混沌测试，模糊测试，兼容性测试。那么强烈，强烈推荐kea2。kea2更偏探索性测试而非编排型。
 </details>
 
@@ -344,6 +389,10 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
+### Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.3.5 → kea2_python-1.0.0}/README.md

@@ -49,11 +49,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 **The ability of the three features in Kea2**
 
-|  | **Feature 1** | **Feature 2** | **Feature 3** |
-| --- | --- | --- | ---- |
-| **Finding crashes** | :+1: | :+1: | :+1: |
-| **Finding crashes in deep states** |  | :+1: | :+1: |
-| **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
+|                                                  | **Feature 1** | **Feature 2** | **Feature 3** |
+| ------------------------------------------------ | ------------- | ------------- | ------------- |
+| **Finding crashes**                              | :+1:          | :+1:          | :+1:          |
+| **Finding crashes in deep states**               |               | :+1:          | :+1:          |
+| **Finding non-crashing functional (logic) bugs** |               |               | :+1:          |
 
 ## Kea2's Users
 
@@ -63,6 +63,10 @@ Kea2 (and its idea) has been used/integrated by
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform
 
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
 Please let us know and willing to hear your feedback/questions if you are also using Kea2.
@@ -100,6 +104,15 @@ Upgrade Kea2 to its latest version if you already installed Kea2 before:
 ```bash
 python3 -m pip install -U kea2-python
 ```
+> If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
+
+Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python==0.3.6
+```
+
+
+
 
 ## Quick Test
 
@@ -130,9 +143,8 @@ Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issue
 
 Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
-
 ```bash
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
+kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
 To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
@@ -181,7 +193,7 @@ You can find the full example in script `quicktest.py`, and run this script with
 
 ```bash
 # Launch Kea2 and load one single script quicktest.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d propertytest discover -p quicktest.py
 ```
 
 ## Feature 3(运行增强版Fastbot：加入自动断言)
@@ -205,7 +217,7 @@ In a social media app, message sending is a common feature. On the message sendi
 <div align="center">
     The expected behavior (the upper figure) and the buggy behavior (the lower figure).
 </div>
-    
+​    
 
 For the preceding always-holding property, we can write the following script to validate the functional correctness: when there is an `input_box` widget on the message sending page, we can type any non-empty string text into the input box and assert `send_button` should always exists.
 
@@ -228,9 +240,37 @@ For the preceding always-holding property, we can write the following script to
 
 You can run this example by using the similar command line in Feature 2.
 
+## Feature 4 (Experimental feature, 实验中，脚本与遍历的混合测试)
+
+> This feature is still under development. We are looking forward to your feedback! Contact us if you're interested in this feature.
+
+Kea2 supports reusing existing Ui test Scripts. We are inspired by the idea that: *The existing Ui test scripts usually cover important app functionalities and can reach deep app states. Thus, they can be used as good "guiding scripts" to drive Fastbot to explore important and deep app states.*
+
+For example, you may already have some existing Ui test scripts "login and add a friend", This feature allows you to use the existing script, set some breakpoints (i.e., interruptable points) in the script, and launch Fastbot to explore the app after every breakpoint. By using this feature, you can do the login first and then launch Fastbot to explore the app after login. Which helps Fastbot to explore deep app states. (fastbot can't do login by itself easily).
+
+### Example
+
+See [guide_scripts.py](guide_scripts.py) for a full example.
+
+By the decorator `@interruptable`, you can mark the testcase as "interruptable" so that Kea2 can recognize this script and launch fuzzing test after it returns. 
+
+Since the state of app is probably unpredicted after fuzzing tests, Kea2 provides a `common_teardown` function to clean up the environment between previous script and next script. The function can be manually specified in `configs/teardown.py`.
+
+You can find the full example in `guide_scripts.py`, `property_omninotes.py`  and `configs/teardown.py` .  You can run one of the following commands:
+
+```bash
+# Guide with guide_scripts.py and launch fuzzing test after every script.
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py 
+
+# Guide with guide_scripts.py and launch fuzzing test after every script(check properties during fuzzing).
+kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 500 --max-step 15 --driver-name d unittest discover -p guide_scripts.py propertytest discover -p quickstart2.py
+```
+
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.
+Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+
+If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
 
 The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
 
@@ -238,14 +278,19 @@ The reports support both single test runs and merged analysis of multiple test s
 
 ## Documentations（更多文档）
 
+
+### :blue_book: [User Manual](docs/manual_en.md) (Important!)
 You can find the [user manual](docs/manual_en.md), which includes:
 - Examples of using Kea2 on WeChat (in Chinese);
 - How to define Kea2's scripts and use the decorators (e.g., `@precondition`、`@prob`、`@max_tries`);
 - How to run Kea2 and Kea2's command line options
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
+
+### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -260,13 +305,13 @@ Some blogs on Kea/Kea2 (in Chinese):
   <summary>Kea2的性质是什么含义？Kea2意义和价值是什么？</summary>
 
     kea2 其实是一个工具，它是python+u2+fastbot的集合体。 它本身更像是一台装好了发动机和轮子的汽车底盘。
-
+    
     性质是苏老师他们团队提出的一个概念， 转换到测试领域的实际工作中，性质对应的是最小单位的功能（原子级功能），性质的依赖条件很少或没有，它可以自身运行。一个典型的性质就是登录，它仅仅具有输入用户名，输入密码，提交。再举个例子，给视频点个赞，也就是简单的两三步。就是一个性质。
-
+    
     性质与kea2结合的意义是在于解决过去使用appium过重的问题。用appium去测试一个性质通常要写很多行的代码，引导界面到达性质的位置。但使用kea2，就只需要编写性质，如何到其所在的位置是交给fastbot和它的学习算法来搞定的。 
-
+    
     kea2另个重大的价值是，它解决了上述思想所需要的技术支撑，比appium更轻量的UI编写方式，fastbot编写性质的能力不足，以及无法编写逻辑和断言。整体上是保留了fastbot以往的优秀品质，完善了其不足和短板。
-
+    
     简而言之，需要做传统的编排型的功能测试，仍然使用appium，使用kea2也行，但你感觉不到它的价值。本身有需要做混沌测试，模糊测试，兼容性测试。那么强烈，强烈推荐kea2。kea2更偏探索性测试而非编排型。
 </details>
 
@@ -329,6 +374,10 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
+### Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.3.5 → kea2_python-1.0.0}/kea2/__init__.py

@@ -1 +1 @@
-from .keaUtils import KeaTestRunner, precondition, prob, max_tries, Options
+from .keaUtils import KeaTestRunner, precondition, prob, max_tries, Options, interruptable,HybridTestRunner,kea2_breakpoint

kea2_python-1.0.0/kea2/assets/config_version.json

@@ -0,0 +1,16 @@
+{
+  "compatibility infos": [
+    {
+      "name": "previous version",
+      "description": "The default initial version, <=0.3.6",
+      "from": "0.0.0",
+      "to": "0.3.6"
+    },
+    {
+      "name": "Hybrid test version 1.0.0",
+      "description": "Hybrid test was added in version 1.0.0. hybrid_test_config.py is required.",
+      "from": "1.0.0",
+      "to": ""
+    }
+  ]
+}

kea2_python-1.0.0/kea2/assets/fastbot_configs/teardown.py

@@ -0,0 +1,18 @@
+from uiautomator2 import Device
+import time
+
+
+class HybridTestCase:
+    d: Device
+
+PACKAGE_NAME = "it.feio.android.omninotes.alpha"
+MAIN_ACTIVITY = "it.feio.android.omninotes.MainActivity"
+
+
+def setUp(self: HybridTestCase):
+    self.d.app_start(PACKAGE_NAME, MAIN_ACTIVITY)
+    time.sleep(2)
+
+
+def tearDown(self: HybridTestCase):
+    self.d.app_stop(PACKAGE_NAME)

{kea2_python-0.3.5 → kea2_python-1.0.0}/kea2/assets/quicktest.py

@@ -9,9 +9,27 @@ from kea2.u2Driver import U2Driver
 class Omni_Notes_Sample(unittest.TestCase):
 
     def setUp(self):
-        self.d = u2.connect()
+        self.d = u2.connect() 
+    
+    @prob(0.2)
+    @precondition(
+        lambda self: self.d(description="Navigate up").exists
+    )
+    def test_goBack(self):
+        print("Navigate back")
+        self.d(description="Navigate up").click()
+        sleep(0.5)
+    
+    @prob(0.2)
+    @precondition(
+        lambda self: self.d(description="drawer closed").exists
+    )
+    def test_openDrawer(self):
+        print("Open drawer")
+        self.d(description="drawer closed").click()
+        sleep(0.5)
 
-    @prob(0.7)  # The probability of executing the function when precondition is satisfied.
+    @prob(0.5)  # The probability of executing the function when precondition is satisfied.
     @precondition(
         lambda self: self.d(text="Omni Notes Alpha").exists
         and self.d(text="Settings").exists
@@ -45,6 +63,7 @@ class Omni_Notes_Sample(unittest.TestCase):
         assertion:
             The search input box is still being opened
         """
+        print("rotate the device")
         self.d.set_orientation("l")
         sleep(2)
         self.d.set_orientation("n")