airtest.core.setting中个参数说明

1. DEBUG

• 作用: 启用调试模式

• 默认值: False

• 说明:
  开启后会输出更多调试日志，帮助开发者定位问题，但可能影响运行效率。

---

2. LOG_DIR

• 作用: 日志目录路径

• 默认值: None

• 说明:
  指定测试日志的保存目录。若为None，则默认保存在当前运行目录的./log文件夹中。

---

3. LOG_FILE

• 作用: 日志文件名

• 默认值: "log.txt"

• 说明:
  所有运行日志（包括操作记录和错误信息）会写入此文件。

---

4. RESIZE_METHOD

• 作用: 图像缩放策略

• 默认值: cocos_min_strategy

• 说明:
  指定设备分辨率适配策略。cocos_min_strategy是专为Cocos引擎设计的缩放策略，适用于不同分辨率设备的UI适配。可替换为其他策略（如android_min_strategy）。

---

5. CVSTRATEGY

• 作用: 图像匹配算法优先级

• 默认值:

  • OpenCV 3.4.2 ~ 4.4.0: ["mstpl", "tpl", "brisk"]

  • 其他版本: ["mstpl", "tpl", "sift", "brisk"]

• 说明:
  定义图像识别算法的执行顺序：

  • mstpl: 多尺度模板匹配（默认优先）

  • tpl: 普通模板匹配

  • sift/brisk/orb: 特征点匹配算法
    注意：SIFT/SURF算法因专利问题在某些OpenCV版本中不可用。

---

6. KEYPOINT_MATCHING_PREDICTION

• 作用: 关键点匹配预测

• 默认值: True

• 说明:
  启用后，通过关键点匹配时会预测目标位置，加速查找过程。

---

7. THRESHOLD

• 作用: 图像匹配置信度阈值

• 默认值: 0.7

• 范围: [0, 1]

• 说明:
  匹配结果置信度超过此阈值才视为成功。值越大匹配越严格，但可能漏识别。

---

8. THRESHOLD_STRICT

• 作用: 严格模式置信度阈值

• 默认值: None（继承THRESHOLD）

• 说明:
  专用于assert_exists等严格断言，通常设置更高的阈值（如0.8）。

---

9. OPDELAY

• 作用: 操作延迟时间

• 默认值: 0.1秒

• 说明:
  单次点击、滑动等操作后的等待时间，避免操作过快导致设备响应延迟。

---

10. FIND_TIMEOUT

• 作用: 元素查找超时时间

• 默认值: 20秒

• 说明:
  在超时时间内持续尝试查找元素，超时后抛出异常。

---

11. FIND_TIMEOUT_TMP

• 作用: 临时查找超时时间

• 默认值: 3秒

• 说明:
  用于快速检查元素是否存在的场景（如exists()函数）。

---

12. PROJECT_ROOT

• 作用: 项目根目录

• 默认值: 从环境变量PROJECT_ROOT获取，否则为空

• 说明:
  用于using语句导入其他脚本时的路径解析。

---

13. SNAPSHOT_QUALITY

• 作用: 截图质量

• 默认值: 10

• 范围: 1-100

• 说明:
  控制JPEG截图压缩质量（Pillow库参数），值越高图片越清晰，但文件体积越大。

---

14. IMAGE_MAXSIZE

• 作用: 截图最大尺寸限制

• 默认值: 从环境变量IMAGE_MAXSIZE获取，否则为None

• 说明:
  限制截图长宽不超过指定值（如1200表示截图尺寸≤1200x1200），避免内存占用过高。

---

15. SAVE_IMAGE

• 作用: 是否保存截图

• 默认值: True

• 说明:
  若为True，测试过程中的截图会保存到日志目录，便于调试；设为False可减少磁盘占用。