u2-webview 0.1.0__tar.gz

u2_webview-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YuYoungG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

u2_webview-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: u2_webview
+Version: 0.1.0
+Summary: An extension for uiautomator2 to support WebView automation via DrissionPage
+Home-page: https://github.com/YuYoungG/uiautomator2-webview
+Author: YuYoungG
+Author-email: younggg2218@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uiautomator2>=2.16.0
+Requires-Dist: DrissionPage>=4.1.0
+Requires-Dist: adbutils>=0.11.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# u2_webview
+
+**u2_webview** 是一个专为 `uiautomator2` 定制的混合应用（Hybrid App）自动化扩展库。它通过集成 `DrissionPage` ，实现了对移动端 WebView 的“无驱动”（Driverless）接管。
+
+##  核心优势
+
+- **免驱动接管 (Driverless)**：不同于传统的 Selenium/Appium，本库无需下载、配置或匹配特定版本的 `chromedriver`。它通过 CDP 协议直接与 WebView 通信，彻底告别驱动版本不匹配的烦恼。
+- **Flask 扩展模式设计**：遵循 Flask 插件设计哲学，支持“应用工厂”模式，实现与 `uiautomator2.Device` 实例的完全解耦。
+- **高性能通信**：基于 `adbutils` 建立高效的端口转发隧道，确保 H5 操作的高响应速度与稳定性。
+- **API 极简**：只需一个属性 `.current_page`，即可像操作浏览器一样操作手机内的 H5 页面。
+
+##  环境要求
+
+- **Python**: 3.8 或更高版本
+- **Android 设备**: 需开启 ADB 调试
+- **被测 App**: WebView 必须开启调试模式（`setWebContentsDebuggingEnabled(true)`）
+
+##  安装
+
+通过 PyPI 直接安装：
+
+```
+pip install u2_webview
+```
+
+或者从源码本地安装（开发模式）：
+
+```
+git clone [https://github.com/YuYoungG/uiautomator2-webview.git](https://github.com/YuYoungG/uiautomator2-webview.git)
+cd uiautomator2-webview
+pip install -e .
+```
+
+##  使用指南
+
+本库支持两种初始化模式，以适配不同的框架架构。
+
+### 1. 基础用法 (直接绑定)
+
+适用于简单的脚本测试。
+
+```
+import uiautomator2 as u2
+from u2_webview import Webview
+
+# 连接设备
+d = u2.connect()
+
+# 实例化扩展并绑定设备
+webview = Webview(d)
+
+# 访问 H5 页面属性 (会自动触发 attach)
+print(f"当前 H5 标题: {webview.current_page.title}")
+
+# 使用 DrissionPage 语法进行操作
+webview.current_page.ele('text:登录').click()
+
+# 测试结束，清理资源
+webview.detach()
+```
+
+### 2. 工厂模式用法 (推荐用于大型框架)
+
+类似于 Flask 的 `init_app` 模式，适合在设备对象尚未完全确定时预定义扩展。
+
+```
+from u2_webview import Webview
+import uiautomator2 as u2
+
+# 全局预定义扩展对象
+webview = Webview()
+
+def run_test(serial):
+    d = u2.connect(serial)
+    
+    # 在运行时绑定具体设备
+    webview.init_device(d)
+    
+    # 接管并操作
+    page = webview.current_page
+    page.actions.move_to('.slider').click()
+    
+    webview.detach()
+```
+
+##  核心 API 参考
+
+### `Webview(d=None)`
+
+构造函数。可选参数 `d` 为 `uiautomator2.connect()` 返回的对象。
+
+### `webview.init_device(d)`
+
+将扩展实例绑定到特定的 `uiautomator2` 设备对象。
+
+### `webview.attach(timeout=20)`
+
+手动建立与手机 WebView 的调试连接。成功后返回 `DrissionPage.Chromium` 对象。
+
+### `webview.current_page` (Property)
+
+**核心属性**。获取当前活跃的标签页对象（`ChromiumTab`）。
+
+- *注：若未连接，访问此属性将自动调用 `attach()`。*
+
+### `webview.detach()`
+
+断开 CDP 连接并移除 ADB 端口转发映射，释放系统资源。
+
+##  常见问题
+
+**Q: 为什么找不到 WebView Socket？**
+
+1. 请确认 App 已经进入了包含 H5 的 Activity。
+2. 请确认 App 源码中开启了 WebView 调试：`WebView.setWebContentsDebuggingEnabled(true);`。如果是第三方 App，可能需要使用 Xposed 模块（如 WebViewDebugHook）强制开启。
+
+**Q: 是否支持多设备并行？** 支持。每个 `Webview` 实例在初始化时都会自动分配一个独立的本地空闲端口，多台手机同时运行不会发生冲突。
+
+##  开源协议
+
+本项目采用 [MIT License](https://opensource.org/licenses/MIT) 协议。
+
+**贡献与支持**: 欢迎提交 Issue 或 Pull Request 来完善本项目。

u2_webview-0.1.0/README.md

@@ -0,0 +1,123 @@
+# u2_webview
+
+**u2_webview** 是一个专为 `uiautomator2` 定制的混合应用（Hybrid App）自动化扩展库。它通过集成 `DrissionPage` ，实现了对移动端 WebView 的“无驱动”（Driverless）接管。
+
+##  核心优势
+
+- **免驱动接管 (Driverless)**：不同于传统的 Selenium/Appium，本库无需下载、配置或匹配特定版本的 `chromedriver`。它通过 CDP 协议直接与 WebView 通信，彻底告别驱动版本不匹配的烦恼。
+- **Flask 扩展模式设计**：遵循 Flask 插件设计哲学，支持“应用工厂”模式，实现与 `uiautomator2.Device` 实例的完全解耦。
+- **高性能通信**：基于 `adbutils` 建立高效的端口转发隧道，确保 H5 操作的高响应速度与稳定性。
+- **API 极简**：只需一个属性 `.current_page`，即可像操作浏览器一样操作手机内的 H5 页面。
+
+##  环境要求
+
+- **Python**: 3.8 或更高版本
+- **Android 设备**: 需开启 ADB 调试
+- **被测 App**: WebView 必须开启调试模式（`setWebContentsDebuggingEnabled(true)`）
+
+##  安装
+
+通过 PyPI 直接安装：
+
+```
+pip install u2_webview
+```
+
+或者从源码本地安装（开发模式）：
+
+```
+git clone [https://github.com/YuYoungG/uiautomator2-webview.git](https://github.com/YuYoungG/uiautomator2-webview.git)
+cd uiautomator2-webview
+pip install -e .
+```
+
+##  使用指南
+
+本库支持两种初始化模式，以适配不同的框架架构。
+
+### 1. 基础用法 (直接绑定)
+
+适用于简单的脚本测试。
+
+```
+import uiautomator2 as u2
+from u2_webview import Webview
+
+# 连接设备
+d = u2.connect()
+
+# 实例化扩展并绑定设备
+webview = Webview(d)
+
+# 访问 H5 页面属性 (会自动触发 attach)
+print(f"当前 H5 标题: {webview.current_page.title}")
+
+# 使用 DrissionPage 语法进行操作
+webview.current_page.ele('text:登录').click()
+
+# 测试结束，清理资源
+webview.detach()
+```
+
+### 2. 工厂模式用法 (推荐用于大型框架)
+
+类似于 Flask 的 `init_app` 模式，适合在设备对象尚未完全确定时预定义扩展。
+
+```
+from u2_webview import Webview
+import uiautomator2 as u2
+
+# 全局预定义扩展对象
+webview = Webview()
+
+def run_test(serial):
+    d = u2.connect(serial)
+    
+    # 在运行时绑定具体设备
+    webview.init_device(d)
+    
+    # 接管并操作
+    page = webview.current_page
+    page.actions.move_to('.slider').click()
+    
+    webview.detach()
+```
+
+##  核心 API 参考
+
+### `Webview(d=None)`
+
+构造函数。可选参数 `d` 为 `uiautomator2.connect()` 返回的对象。
+
+### `webview.init_device(d)`
+
+将扩展实例绑定到特定的 `uiautomator2` 设备对象。
+
+### `webview.attach(timeout=20)`
+
+手动建立与手机 WebView 的调试连接。成功后返回 `DrissionPage.Chromium` 对象。
+
+### `webview.current_page` (Property)
+
+**核心属性**。获取当前活跃的标签页对象（`ChromiumTab`）。
+
+- *注：若未连接，访问此属性将自动调用 `attach()`。*
+
+### `webview.detach()`
+
+断开 CDP 连接并移除 ADB 端口转发映射，释放系统资源。
+
+##  常见问题
+
+**Q: 为什么找不到 WebView Socket？**
+
+1. 请确认 App 已经进入了包含 H5 的 Activity。
+2. 请确认 App 源码中开启了 WebView 调试：`WebView.setWebContentsDebuggingEnabled(true);`。如果是第三方 App，可能需要使用 Xposed 模块（如 WebViewDebugHook）强制开启。
+
+**Q: 是否支持多设备并行？** 支持。每个 `Webview` 实例在初始化时都会自动分配一个独立的本地空闲端口，多台手机同时运行不会发生冲突。
+
+##  开源协议
+
+本项目采用 [MIT License](https://opensource.org/licenses/MIT) 协议。
+
+**贡献与支持**: 欢迎提交 Issue 或 Pull Request 来完善本项目。

u2_webview-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

u2_webview-0.1.0/setup.py

@@ -0,0 +1,28 @@
+# 文件：setup.py
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="u2_webview",
+    version="0.1.0",
+    description="An extension for uiautomator2 to support WebView automation via DrissionPage",
+    author="YuYoungG",
+    author_email="younggg2218@gmail.com",
+    packages=find_packages(),
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/YuYoungG/uiautomator2-webview",
+    install_requires=[                      # 依赖的其他库
+        "uiautomator2>=2.16.0",
+        "DrissionPage>=4.1.0",
+        "adbutils>=0.11.0"
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.8",
+)

u2_webview-0.1.0/u2_webview/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding:utf-8 -*-
+from .core import Webview
+
+__version__ = "0.1.0"

u2_webview-0.1.0/u2_webview/core.py

@@ -0,0 +1,111 @@
+# -*- coding:utf-8 -*-
+import time
+import re
+import socket
+import atexit
+import traceback
+from adbutils import adb
+from DrissionPage import Chromium, ChromiumOptions
+
+class Webview:
+    """
+    u2_webview 扩展类
+    设计参考 Flask Extension 模式：支持预初始化和延迟绑定设备
+    """
+    def __init__(self, d=None):
+        self.d = None
+        self.browser = None
+        self.local_port = None
+        self._socket_name = None
+        
+        # 如果初始化时传入了设备，则直接绑定
+        if d is not None:
+            self.init_device(d)
+
+    def init_device(self, d):
+        """
+        将扩展绑定到具体的 uiautomator2 Device 实例上
+        """
+        self.d = d
+        # 自动获取一个当前实例专用的空闲端口
+        self.local_port = self._get_free_port()
+        
+        # 注册进程退出时的清理
+        atexit.register(self.detach)
+
+    def _get_free_port(self):
+        """获取本地空闲端口"""
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+            s.bind(('localhost', 0))
+            return s.getsockname()[1]
+
+    def _find_webview_socket(self, timeout=15):
+        """侦测手机内 WebView 调试接口"""
+        if not self.d:
+            raise RuntimeError("扩展尚未绑定设备，请先调用 init_device(d)")
+            
+        start_time = time.time()
+        while time.time() - start_time < timeout:
+            try:
+                # grep -a 处理二进制干扰
+                output = self.d.shell("cat /proc/net/unix | grep -a devtools_remote").output.strip()
+                if output:
+                    lines = output.splitlines()
+                    for line in reversed(lines):
+                        match = re.search(r'webview_devtools_remote_\d+', line) or \
+                                re.search(r'chrome_devtools_remote_\d+', line)
+                        if match:
+                            return match.group(0)
+            except Exception:
+                traceback.print_exc()
+            time.sleep(0.5)
+        return None
+
+    def attach(self, timeout=20):
+        """建立连接（核心行为）"""
+        if self.browser:
+            return self.browser
+
+        if not self.d:
+            raise RuntimeError("请先通过 Webview(d) 或 init_device(d) 绑定设备")
+
+        socket_name = self._find_webview_socket(timeout=timeout)
+        if not socket_name:
+            raise RuntimeError("❌ 未检测到 WebView Socket，请确认 App 已进入 H5 页面并开启调试")
+
+        # 建立 ADB 隧道
+        try:
+            device = adb.device(serial=self.d.serial)
+            device.forward(f"tcp:{self.local_port}", f"localabstract:{socket_name}")
+        except Exception:
+            traceback.print_exc()
+
+        # 连接 DrissionPage
+        try:
+            co = ChromiumOptions()
+            co.set_address(f'127.0.0.1:{self.local_port}')
+            self.browser = Chromium(addr_or_opts=co)
+            return self.browser
+        except Exception:
+            traceback.print_exc()
+
+    @property
+    def current_page(self):
+        """
+        懒加载获取页面。
+        如果在未 attach 的情况下访问该属性，会自动触发 attach 逻辑。
+        """
+        if not self.browser:
+            self.attach()
+        return self.browser.latest_tab
+
+    def detach(self):
+        """断开链接清理资源"""
+        if self.browser:
+            self.browser = None
+        if self.d and self.local_port:
+            try:
+                device = adb.device(serial=self.d.serial)
+                device.forward_remove(f"tcp:{self.local_port}")
+            except Exception:
+                traceback.print_exc()

u2_webview-0.1.0/u2_webview.egg-info/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: u2_webview
+Version: 0.1.0
+Summary: An extension for uiautomator2 to support WebView automation via DrissionPage
+Home-page: https://github.com/YuYoungG/uiautomator2-webview
+Author: YuYoungG
+Author-email: younggg2218@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uiautomator2>=2.16.0
+Requires-Dist: DrissionPage>=4.1.0
+Requires-Dist: adbutils>=0.11.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# u2_webview
+
+**u2_webview** 是一个专为 `uiautomator2` 定制的混合应用（Hybrid App）自动化扩展库。它通过集成 `DrissionPage` ，实现了对移动端 WebView 的“无驱动”（Driverless）接管。
+
+##  核心优势
+
+- **免驱动接管 (Driverless)**：不同于传统的 Selenium/Appium，本库无需下载、配置或匹配特定版本的 `chromedriver`。它通过 CDP 协议直接与 WebView 通信，彻底告别驱动版本不匹配的烦恼。
+- **Flask 扩展模式设计**：遵循 Flask 插件设计哲学，支持“应用工厂”模式，实现与 `uiautomator2.Device` 实例的完全解耦。
+- **高性能通信**：基于 `adbutils` 建立高效的端口转发隧道，确保 H5 操作的高响应速度与稳定性。
+- **API 极简**：只需一个属性 `.current_page`，即可像操作浏览器一样操作手机内的 H5 页面。
+
+##  环境要求
+
+- **Python**: 3.8 或更高版本
+- **Android 设备**: 需开启 ADB 调试
+- **被测 App**: WebView 必须开启调试模式（`setWebContentsDebuggingEnabled(true)`）
+
+##  安装
+
+通过 PyPI 直接安装：
+
+```
+pip install u2_webview
+```
+
+或者从源码本地安装（开发模式）：
+
+```
+git clone [https://github.com/YuYoungG/uiautomator2-webview.git](https://github.com/YuYoungG/uiautomator2-webview.git)
+cd uiautomator2-webview
+pip install -e .
+```
+
+##  使用指南
+
+本库支持两种初始化模式，以适配不同的框架架构。
+
+### 1. 基础用法 (直接绑定)
+
+适用于简单的脚本测试。
+
+```
+import uiautomator2 as u2
+from u2_webview import Webview
+
+# 连接设备
+d = u2.connect()
+
+# 实例化扩展并绑定设备
+webview = Webview(d)
+
+# 访问 H5 页面属性 (会自动触发 attach)
+print(f"当前 H5 标题: {webview.current_page.title}")
+
+# 使用 DrissionPage 语法进行操作
+webview.current_page.ele('text:登录').click()
+
+# 测试结束，清理资源
+webview.detach()
+```
+
+### 2. 工厂模式用法 (推荐用于大型框架)
+
+类似于 Flask 的 `init_app` 模式，适合在设备对象尚未完全确定时预定义扩展。
+
+```
+from u2_webview import Webview
+import uiautomator2 as u2
+
+# 全局预定义扩展对象
+webview = Webview()
+
+def run_test(serial):
+    d = u2.connect(serial)
+    
+    # 在运行时绑定具体设备
+    webview.init_device(d)
+    
+    # 接管并操作
+    page = webview.current_page
+    page.actions.move_to('.slider').click()
+    
+    webview.detach()
+```
+
+##  核心 API 参考
+
+### `Webview(d=None)`
+
+构造函数。可选参数 `d` 为 `uiautomator2.connect()` 返回的对象。
+
+### `webview.init_device(d)`
+
+将扩展实例绑定到特定的 `uiautomator2` 设备对象。
+
+### `webview.attach(timeout=20)`
+
+手动建立与手机 WebView 的调试连接。成功后返回 `DrissionPage.Chromium` 对象。
+
+### `webview.current_page` (Property)
+
+**核心属性**。获取当前活跃的标签页对象（`ChromiumTab`）。
+
+- *注：若未连接，访问此属性将自动调用 `attach()`。*
+
+### `webview.detach()`
+
+断开 CDP 连接并移除 ADB 端口转发映射，释放系统资源。
+
+##  常见问题
+
+**Q: 为什么找不到 WebView Socket？**
+
+1. 请确认 App 已经进入了包含 H5 的 Activity。
+2. 请确认 App 源码中开启了 WebView 调试：`WebView.setWebContentsDebuggingEnabled(true);`。如果是第三方 App，可能需要使用 Xposed 模块（如 WebViewDebugHook）强制开启。
+
+**Q: 是否支持多设备并行？** 支持。每个 `Webview` 实例在初始化时都会自动分配一个独立的本地空闲端口，多台手机同时运行不会发生冲突。
+
+##  开源协议
+
+本项目采用 [MIT License](https://opensource.org/licenses/MIT) 协议。
+
+**贡献与支持**: 欢迎提交 Issue 或 Pull Request 来完善本项目。

u2_webview-0.1.0/u2_webview.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+u2_webview/__init__.py
+u2_webview/core.py
+u2_webview.egg-info/PKG-INFO
+u2_webview.egg-info/SOURCES.txt
+u2_webview.egg-info/dependency_links.txt
+u2_webview.egg-info/requires.txt
+u2_webview.egg-info/top_level.txt

u2_webview-0.1.0/u2_webview.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

u2_webview-0.1.0/u2_webview.egg-info/requires.txt

@@ -0,0 +1,3 @@
+uiautomator2>=2.16.0
+DrissionPage>=4.1.0
+adbutils>=0.11.0

u2_webview-0.1.0/u2_webview.egg-info/top_level.txt

@@ -0,0 +1 @@
+u2_webview