openEuler测试工具mugen框架使用教程：从环境配置到用例执行的完整流程

openEuler测试工具mugen框架使用教程：从环境配置到用例执行的完整流程

【免费下载链接】test-toolsThe repo contains tools for improve test efficiency项目地址: https://gitcode.com/openeuler/test-tools

前往项目官网免费下载：https://ar.openeuler.org/ar/

欢迎来到openEuler测试工具mugen框架的完整使用指南！🚀 作为openEuler社区开发的自动化测试框架，mugen为开发者提供了强大的测试能力，帮助确保openEuler操作系统和软件包的质量与稳定性。无论你是测试新手还是经验丰富的开发者，这篇教程都将带你全面了解mugen框架的使用方法。

什么是mugen测试框架？

mugen是openEuler社区开发的自动化测试框架，专门用于openEuler操作系统和软件包的测试验证。它提供了一套完整的测试解决方案，包括环境配置、测试用例编写、执行管理和结果分析等功能。通过mugen框架，开发者可以高效地进行功能测试、集成测试和回归测试，确保软件质量。

环境配置：搭建测试基础

1. 获取mugen框架

首先，你需要克隆mugen框架到本地环境：

git clone https://gitcode.com/openeuler/test-tools cd test-tools/Aops_Auto_Test/mugen

2. 安装依赖软件

mugen框架需要一些基础依赖包，执行以下命令进行安装：

bash dep_install.sh

对于嵌入式测试场景，可以使用：

bash dep_install.sh -e

3. 配置测试环境

配置测试环境是使用mugen框架的关键步骤。你需要设置测试机的连接信息：

bash mugen.sh -c --ip 192.168.0.10 --password openEuler12#$ --user root --port 22

参数说明：

• --ip：测试机的IP地址
• --password：测试机登录密码
• --user：测试机登录用户（默认为root）
• --port：SSH端口（默认为22）

配置完成后，会在./conf/env.json文件中生成环境配置信息：

{ "NODE": [ { "ID": 1, "LOCALTION": "local", "MACHINE": "physical", "FRAME": "aarch64", "NIC": "eth0", "MAC": "55:54:00:c8:a9:21", "IPV4": "192.168.0.10", "USER": "root", "PASSWORD": "openEuler12#$", "SSH_PORT": 22 } ] }

测试用例执行：三种运行模式

mugen框架支持多种测试用例执行方式，满足不同测试需求。

1. 执行所有测试用例

如果你想运行所有可用的测试用例，使用以下命令：

bash mugen.sh -a

如果需要查看详细的执行过程，可以启用调试模式：

bash mugen.sh -a -x

2. 执行指定测试套

针对特定的测试套执行测试：

bash mugen.sh -f testsuite_name

同样支持调试模式：

bash mugen.sh -f testsuite_name -x

3. 执行单个测试用例

如果只需要运行某个测试套中的特定测试用例：

bash mugen.sh -f testsuite_name -r testcase_name

调试模式：

bash mugen.sh -f testsuite_name -r testcase_name -x

测试用例编写：创建自定义测试

测试用例结构

mugen测试用例遵循标准的结构模板，包含四个主要函数：

#!/usr/bin/bash source ${OET_PATH}/libs/locallibs/common_lib.sh # 配置参数 function config_params() { LOG_INFO "开始配置测试参数" # 参数配置代码 LOG_INFO "参数配置完成" } # 测试环境准备 function pre_test() { LOG_INFO "开始准备测试环境" DNF_INSTALL "软件包名称" LOG_INFO "测试环境准备完成" } # 测试执行 function run_test() { LOG_INFO "开始执行测试" # 测试命令和验证 CHECK_RESULT $? 0 0 "测试点描述" LOG_INFO "测试执行完成" } # 环境恢复 function post_test() { LOG_INFO "开始恢复测试环境" DNF_REMOVE LOG_INFO "测试环境恢复完成" } main "$@"

常用公共函数

mugen框架提供了丰富的公共函数，简化测试用例编写：

日志输出函数：

LOG_INFO "信息日志" LOG_WARN "警告日志" LOG_DEBUG "调试日志" LOG_ERROR "错误日志"

结果检查函数：

CHECK_RESULT $1 $2 $3 $4 $5

参数说明：

• $1：实际测试结果
• $2：预期结果
• $3：比较模式（0：相等，1：不相等）
• $4：问题描述
• $5：退出模式（0：继续执行，1：中断退出）

软件包管理：

DNF_INSTALL "软件包列表" DNF_REMOVE

远程命令执行：

SSH_CMD "命令" $remote_ip $remote_password $remote_user $time_out $remote_port

组合测试：高级测试场景

mugen框架支持组合测试，可以灵活配置多个测试套和测试环境。

组合测试配置

创建组合测试配置文件（如embedded_ci_test.json）：

{ "export": { "FIND_TINY_DIR": "/home/openeuler/tmp_image/tiny" }, "env": [ { "type": "qemu", "name": "qemu_1", "kernal_img_path": "https://mirrors.nju.edu.cn/openeuler/openEuler-22.03-LTS-SP1/embedded_img/arm64/aarch64-std/zImage", "initrd_path": "https://mirrors.nju.edu.cn/openeuler/openEuler-22.03-LTS-SP1/embedded_img/arm64/aarch64-std/openeuler-image-qemu-aarch64-20221228125551.rootfs.cpio.gz", "qemu_type": "aarch64" } ], "combination": [ { "name": "normal_test", "testcases": [ { "testsuite": "embedded_os_basic_test" } ] } ], "execute": [ { "env": ["qemu_1"], "combination": "normal_test" } ] }

执行组合测试

生成并执行组合测试：

bash combination.sh embedded_ci_test

执行所有组合测试配置文件：

bash combination.sh --all

执行指定配置文件：

bash combination.sh -f /home/openeuler/test.json

测试用例调试技巧

1. 设置环境变量

在调试测试用例时，首先设置OET_PATH环境变量：

export OET_PATH=/path/to/mugen

2. 直接执行测试用例

设置环境变量后，可以直接在测试用例所在目录执行：

./oe_test_example.sh

3. 调试模式

使用-x参数启用调试模式，查看详细的执行过程：

bash mugen.sh -f testsuite -r testcase -x

4. 超时设置

默认测试用例超时时间为30分钟。如果需要调整，可以在测试用例中设置：

TIMEOUT="60m"

常见问题与解决方案

1. 远程命令执行卡住

问题现象：SSH远程执行命令时，测试用例卡住导致超时失败。

原因分析：SSH远程执行命令会等待命令的标准输出，直到命令运行结束。

解决方案：将标准输出重定向到/dev/null：

cmd > /dev/null 2>&1 &

2. 环境变量配置错误

问题现象：测试用例无法找到公共函数或依赖。

解决方案：确保正确设置OET_PATH环境变量，并在测试用例开头加载公共库：

source ${OET_PATH}/libs/locallibs/common_lib.sh

3. 测试环境准备失败

问题现象：pre_test函数中的软件包安装失败。

解决方案：检查网络连接和软件源配置，确保可以正常访问软件仓库。

测试结果分析

测试执行完成后，结果会保存在results目录中：

results/ ├── 2024-01-15-10-30-00/ # 测试执行时间戳目录 │ ├── logs/ # 详细日志文件 │ ├── report.html # HTML格式测试报告 │ └── summary.txt # 测试结果摘要

查看测试报告

测试报告包含以下信息：

• 测试用例执行状态（通过/失败）
• 执行时间统计
• 错误详细信息
• 测试覆盖率数据

最佳实践建议

1. 测试用例设计原则

• 独立性：每个测试用例应该独立运行，不依赖其他测试用例的状态
• 可重复性：测试用例应该在任何环境下都能重复执行并得到相同结果
• 原子性：每个测试用例只测试一个功能点
• 完整性：测试用例应该包含环境准备、测试执行和环境清理

2. 测试数据管理

• 使用临时文件进行测试，避免污染系统文件
• 测试完成后及时清理测试数据
• 对于需要持久化的测试数据，使用专门的测试目录

3. 错误处理

• 在测试用例中添加详细的错误日志
• 使用CHECK_RESULT函数进行结果验证
• 对于可能失败的操作，添加适当的错误处理逻辑

总结

openEuler测试工具mugen框架为openEuler生态系统的质量保障提供了强大的支持。通过本教程，你已经掌握了mugen框架的基本使用方法，包括环境配置、测试用例执行、自定义测试用例编写和组合测试配置。

记住，良好的测试实践是软件质量的重要保障。mugen框架不仅是一个测试工具，更是openEuler社区协作的重要平台。随着你对框架的深入使用，你将能够：

1. 提高测试效率：自动化执行大量测试用例
2. 确保软件质量：及时发现和修复问题
3. 促进协作：与社区开发者共享测试用例和经验
4. 持续改进：基于测试结果不断优化软件质量

现在就开始使用mugen框架，为openEuler生态系统的质量保障贡献你的力量吧！💪

如果你在使用的过程中遇到任何问题，可以参考框架文档或向openEuler社区寻求帮助。祝你在openEuler测试之旅中取得成功！

【免费下载链接】test-toolsThe repo contains tools for improve test efficiency项目地址: https://gitcode.com/openeuler/test-tools