Mobly 项目技术文档

Mobly 项目技术文档

mobly E2E test framework for tests with complex environment requirements. 项目地址: https://gitcode.com/gh_mirrors/mo/mobly

1. 安装指南

1.1 系统要求

Mobly 需要 Python 3.11 或更高版本。支持以下操作系统：

• Ubuntu 14.04+
• MacOS 10.6+
• Windows 7+

1.2 系统依赖

在安装 Mobly 之前，请确保系统已安装以下依赖项：

• adb（推荐版本 1.0.40+）
• python3.11+

1.3 安装方式

1.3.1 通过 pip 安装

你可以通过 pip 安装 Mobly 的发布版本：

pip install mobly

1.3.2 从源码安装

如果你想使用最新的开发版本，可以通过源码安装：

git clone https://github.com/google/mobly.git
cd mobly
pip install -e .

如果你的系统有特定的权限限制，可能需要使用 sudo 执行上述命令。

2. 项目使用说明

2.1 概述

Mobly 是一个基于 Python 的测试框架，专门用于支持需要多设备、复杂环境或自定义硬件设置的测试用例。以下是一些示例用例：

• 两台设备之间的 P2P 数据传输
• 三台手机之间的会议通话
• 可穿戴设备与手机的交互
• 物联网设备之间的交互
• 使用特殊设备测试设备的 RF 特性
• 通过控制手机、基站和 eNBs 测试 LTE 网络

Mobly 可以支持多种类型的设备和设备，并且可以轻松地将你自己的设备或自定义设备/服务集成到 Mobly 中。

2.2 教程

Mobly 提供了多个教程，帮助你快速上手：

• Mobly 101 - 简单的测试示例，帮助你开始使用 Mobly。
• Mobly Instrumentation Runner Tutorial - 如何使用 Mobly 的 Android 插桩测试运行器运行 Android 插桩测试。
• Mobly AndroidDevice Service - 创建自定义服务以附加到 Mobly 的 AndroidDevice 控制器。

3. 项目 API 使用文档

3.1 Mobly Snippet

Mobly Snippet 项目允许用户更好地控制 Android 设备。

3.1.1 Mobly Snippet Lib

Mobly Snippet Lib 用于从主机端 Mobly 测试触发自定义设备端代码。你可以使用现有的 Android 库，如 UI Automator 和 Espresso。

3.1.2 Mobly Bundled Snippets

Mobly Bundled Snippets 是一组 Snippets，允许 Mobly 测试通过公开简化版本的公共 Android API 来控制 Android 设备，适合测试使用。

4. 项目安装方式

4.1 通过 pip 安装

pip install mobly

4.2 从源码安装

git clone https://github.com/google/mobly.git
cd mobly
pip install -e .

通过以上步骤，你可以轻松安装并开始使用 Mobly 进行多设备和复杂环境的测试。

mobly E2E test framework for tests with complex environment requirements. 项目地址: https://gitcode.com/gh_mirrors/mo/mobly