magnax 1.0.0__tar.gz

magnax-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 ~ now MagnaX . Rafa Chen
+
+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.

magnax-1.0.0/MANIFEST.in

@@ -0,0 +1,8 @@
+recursive-include magnax/public *.html *.js *.css *.png *.py *.json
+recursive-include magnax/report *.html *.js *.css *.png *.py *.json *.log
+recursive-include magnax/static *.html *.js *.css *.png *.py
+recursive-include magnax/templates *.html *.js *.css *.png *.py
+recursive-include magnax/view *.html *.js *.css *.png *.py
+recursive-include magnax/public/adb *
+recursive-include magnax/public/scrcpy *
+recursive-include magnax/public/report_template *

magnax-1.0.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: magnax
+Version: 1.0.0
+Summary: MagnaX - Real-time collection tool for Android/iOS performance data.
+Home-page: https://github.com/smart-test-ti/MagnaX
+Author: Rafa Chen
+Author-email: Rafa Chen <rafacheninc@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/smart-test-ti/MagnaX
+Project-URL: Repository, https://github.com/smart-test-ti/MagnaX
+Project-URL: Documentation, https://github.com/smart-test-ti/MagnaX#readme
+Project-URL: Issues, https://github.com/smart-test-ti/MagnaX/issues
+Keywords: android,ios,performance,testing,monitoring,apm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=3.1.0
+Requires-Dist: requests>=2.28.2
+Requires-Dist: loguru
+Requires-Dist: fire
+Requires-Dist: tqdm
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: pyfiglet
+Requires-Dist: psutil
+Requires-Dist: opencv-python
+Requires-Dist: pymobiledevice3>=2.0.0
+Requires-Dist: py-ios-device>=2.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+<p align="center">
+  <a>English</a> | <a href="./README.zh.md">中文</a> | <a href="./FAQ.md">FAQ</a> | <a href="https://mp.weixin.qq.com/s?__biz=MzkxMzYyNDM2NA==&mid=2247484506&idx=1&sn=b7eb6de68f84bed03001375d08e08ce9&chksm=c17b9819f60c110fd14e652c104237821b95a13da04618e98d2cf27afa798cb45e53cf50f5bd&token=1402046775&lang=zh_CN&poc_token=HKmRi2WjP7gf9CVwvLWQ2cRhrUR3wmbB9-fNZdD4" target="__blank">使用文档</a>
+</p>
+
+<p align="center">
+<a href="#">
+<img src="https://cdn.nlark.com/yuque/0/2024/png/153412/1715927541315-fb4f7662-d8bb-4d3e-a712-13a3c3073ac8.png?x-oss-process=image%2Fformat%2Cwebp" alt="MagnaX" width="100">
+</a>
+<br>
+</p>
+<p align="center">
+<a href="https://pypi.org/project/magnax/" target="__blank"><img src="https://img.shields.io/pypi/v/magnax" alt="magnax preview"></a>
+<a href="https://pepy.tech/project/magnax" target="__blank"><img src="https://static.pepy.tech/personalized-badge/magnax?period=total&units=international_system&left_color=grey&right_color=orange&left_text=downloads"></a>
+
+<br>
+</p>
+
+## 🔎Preview
+
+MagnaX - Real-time collection tool for Android/iOS performance data.
+
+Quickly locate and analyze performance issues to improve application performance and quality. No need for ROOT/jailbreak, plug and play.
+
+![10 161 9 178_50003__platform=Android lan=en (1)](https://github.com/smart-test-ti/MagnaX/assets/24454096/61a0b801-23b4-4711-8215-51cd7bc9dc04)
+
+## 📦Requirements
+
+- Install Python 3.10 + (supports up to Python 3.14) [**Download**](https://www.python.org/downloads/)
+- Install adb and configure environment variables (MagnaX's  adb may not necessarily fit your computer) [**Download**](https://developer.android.com/studio/releases/platform-tools)
+
+💡 If Windows users need to test iOS, install and start iTunes. [**Documentation**](https://github.com/alibaba/taobao-iphone-device)
+
+💡 For iOS 17+ devices, you need to start the pymobiledevice3 tunnel service first:
+
+```shell
+# macOS/Linux (requires sudo)
+sudo python3 -m pymobiledevice3 remote start-tunnel
+
+# Or run as a background daemon
+sudo python3 -m pymobiledevice3 remote tunneld
+```
+
+## 📥Installation
+
+### default
+
+```shell
+pip install -U magnax    (pip install magnax==version)
+```
+
+### mirrors
+
+```shell
+pip install -i  https://mirrors.ustc.edu.cn/pypi/web/simple -U magnax
+```
+
+💡 If your network is unable to download through [pip install -U magnax], please try using mirrors to download, but the download of MagnaX may not be the latest version.
+
+## 🚀Quickstart
+
+### default
+
+```shell
+python -m magnax
+```
+
+### customize
+
+```shell
+python -m magnax --host=ip --port=port
+```
+
+## 🏴󠁣󠁩󠁣󠁭󠁿Python API
+
+```python
+# magnax version : >= 2.8.5
+from magnax.public.apm import AppPerformanceMonitor
+from magnax.public.common import Devices
+
+d = Devices()
+processList = d.getPid(deviceId='ca6bd5a5', pkgName='com.bilibili.app.in') # for android
+print(processList) # ['{pid}:{packagename}',...]
+
+apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in',platform='Android', deviceId='ca6bd5a5', surfaceview=True, 
+                            noLog=False, pid=None, record=False, collect_all=False, duration=0)
+# apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in', platform='iOS') only supports one device
+# surfaceview： False = gfxinfo (Developer - GPU rendering mode - adb shell dumpsys gfxinfo)
+# noLog : False (Save test data to log file)
+
+# ************* Collect a performance parameter ************* #
+cpu = apm.collectCpu() # %
+memory = apm.collectMemory() # MB
+memory_detail = apm.collectMemoryDetail() # MB
+network = apm.collectNetwork(wifi=True) # KB
+fps = apm.collectFps() # HZ
+battery = apm.collectBattery() # level:% temperature:°C current:mA voltage:mV power:w
+gpu = apm.collectGpu() # %
+disk = apm.collectDisk()
+thermal = apm.collectThermal()
+# ************* Collect all performance parameter ************* #
+ 
+if __name__ == '__main__':
+  apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in',platform='Android', deviceId='ca6bd5a5', surfaceview=True, 
+                              noLog=False, pid=None, record=False, collect_all=True, duration=0)
+  # apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in', platform='iOS',  deviceId='xxxx', noLog=False, record=False, collect_all=True, duration=0)
+  #duration: running time (second)
+  #record: record android screen
+  apm.collectAll(report_path=None) # report_path='/test/report.html'
+
+# in other python file
+from magnax.public.apm import initPerformanceService  
+
+initPerformanceService.stop() # stop magnax
+```
+
+## 🏴󠁣󠁩󠁣󠁭󠁿Service API
+
+### Start the service in the background
+
+```
+# magnax version >= 2.1.5
+
+macOS/Linux: nohup python3 -m magnax &
+Windows: start /min python3 -m magnax &
+```
+
+### Request performance data from api
+
+```shell
+Android: http://{ip}:{port}/apm/collect?platform=Android&deviceid=ca6bd5a5&pkgname=com.bilibili.app.in&target=cpu
+iOS: http://{ip}:{port}/apm/collect?platform=iOS&pkgname=com.bilibili.app.in&target=cpu
+
+target in ['cpu','memory','memory_detail','network','fps','battery','gpu']
+```
+
+## 🔥Features
+
+* **No ROOT/Jailbreak:** No need of Root for Android devices, Jailbreak for iOS devices. Efficiently solving the test and analysis challenges in Android & iOS performance.
+* **Data Integrality:** We provide the data about CPU, GPU, Memory, Battery, Network,FPS, Jank, etc., which you may easy to get.
+* **Beautiful Report:** A beautiful and detailed report analysis, where to store, visualize, edit, manage, and download all the test cases collected with MagnaX no matter where you are or when is it.
+* **Useful Monitoring Settings:** Support setting alarm values, collecting duration, and accessing mobile devices on other PC machines during the monitoring process.
+* **PK Model:** Supports simultaneous comparative testing of two mobile devices.
+
+  - 🌱2-devices: test the same app on two different phones.
+  - 🌱2-apps: test two different apps on two phones with the same configuration.
+* **Collect In Python/API:** Support Python and API to collect performance data, helping users easily integrate into automated testing processes.
+
+## Develop
+
+* https://github.com/pallets/flask
+* https://github.com/tabler/tabler
+
+### Dependencies
+
+| Package | Purpose |
+|---|---|
+| flask >= 3.1.0 | Web framework |
+| loguru | Logging |
+| openpyxl >= 3.1.0 | Excel report export (.xlsx) |
+| pymobiledevice3 >= 2.0.0 | iOS device control |
+| py-ios-device >= 2.0.0 | iOS performance data collection |
+| fire | CLI argument parsing |
+| psutil | System process utilities |
+| opencv-python | Screen recording |
+
+### Debug
+
+* Remove `magnax.` prefix in import paths
+
+```python
+# example
+from magnax.view.apis import api
+# change to
+from view.apis import api
+```
+
+* Run debug server
+
+```shell
+cd magnax
+python debug.py
+```
+
+## Browser
+
+<img src="https://cdn.nlark.com/yuque/0/2023/png/153412/1677553244198-96ce5709-f33f-4038-888f-f330d1f74450.png" alt="Chrome" width="50px" height="50px" />
+
+## Terminal
+
+- windows: PowerShell
+- macOS：iTerm2 (https://iterm2.com/)
+
+## 💕Thanks
+
+- https://github.com/doronz88/pymobiledevice3
+- https://github.com/YueChen-C/py-ios-device
+- https://github.com/Genymobile/scrcpy

magnax-1.0.0/README.md

@@ -0,0 +1,197 @@
+<p align="center">
+  <a>English</a> | <a href="./README.zh.md">中文</a> | <a href="./FAQ.md">FAQ</a> | <a href="https://mp.weixin.qq.com/s?__biz=MzkxMzYyNDM2NA==&mid=2247484506&idx=1&sn=b7eb6de68f84bed03001375d08e08ce9&chksm=c17b9819f60c110fd14e652c104237821b95a13da04618e98d2cf27afa798cb45e53cf50f5bd&token=1402046775&lang=zh_CN&poc_token=HKmRi2WjP7gf9CVwvLWQ2cRhrUR3wmbB9-fNZdD4" target="__blank">使用文档</a>
+</p>
+
+<p align="center">
+<a href="#">
+<img src="https://cdn.nlark.com/yuque/0/2024/png/153412/1715927541315-fb4f7662-d8bb-4d3e-a712-13a3c3073ac8.png?x-oss-process=image%2Fformat%2Cwebp" alt="MagnaX" width="100">
+</a>
+<br>
+</p>
+<p align="center">
+<a href="https://pypi.org/project/magnax/" target="__blank"><img src="https://img.shields.io/pypi/v/magnax" alt="magnax preview"></a>
+<a href="https://pepy.tech/project/magnax" target="__blank"><img src="https://static.pepy.tech/personalized-badge/magnax?period=total&units=international_system&left_color=grey&right_color=orange&left_text=downloads"></a>
+
+<br>
+</p>
+
+## 🔎Preview
+
+MagnaX - Real-time collection tool for Android/iOS performance data.
+
+Quickly locate and analyze performance issues to improve application performance and quality. No need for ROOT/jailbreak, plug and play.
+
+![10 161 9 178_50003__platform=Android lan=en (1)](https://github.com/smart-test-ti/MagnaX/assets/24454096/61a0b801-23b4-4711-8215-51cd7bc9dc04)
+
+## 📦Requirements
+
+- Install Python 3.10 + (supports up to Python 3.14) [**Download**](https://www.python.org/downloads/)
+- Install adb and configure environment variables (MagnaX's  adb may not necessarily fit your computer) [**Download**](https://developer.android.com/studio/releases/platform-tools)
+
+💡 If Windows users need to test iOS, install and start iTunes. [**Documentation**](https://github.com/alibaba/taobao-iphone-device)
+
+💡 For iOS 17+ devices, you need to start the pymobiledevice3 tunnel service first:
+
+```shell
+# macOS/Linux (requires sudo)
+sudo python3 -m pymobiledevice3 remote start-tunnel
+
+# Or run as a background daemon
+sudo python3 -m pymobiledevice3 remote tunneld
+```
+
+## 📥Installation
+
+### default
+
+```shell
+pip install -U magnax    (pip install magnax==version)
+```
+
+### mirrors
+
+```shell
+pip install -i  https://mirrors.ustc.edu.cn/pypi/web/simple -U magnax
+```
+
+💡 If your network is unable to download through [pip install -U magnax], please try using mirrors to download, but the download of MagnaX may not be the latest version.
+
+## 🚀Quickstart
+
+### default
+
+```shell
+python -m magnax
+```
+
+### customize
+
+```shell
+python -m magnax --host=ip --port=port
+```
+
+## 🏴󠁣󠁩󠁣󠁭󠁿Python API
+
+```python
+# magnax version : >= 2.8.5
+from magnax.public.apm import AppPerformanceMonitor
+from magnax.public.common import Devices
+
+d = Devices()
+processList = d.getPid(deviceId='ca6bd5a5', pkgName='com.bilibili.app.in') # for android
+print(processList) # ['{pid}:{packagename}',...]
+
+apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in',platform='Android', deviceId='ca6bd5a5', surfaceview=True, 
+                            noLog=False, pid=None, record=False, collect_all=False, duration=0)
+# apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in', platform='iOS') only supports one device
+# surfaceview： False = gfxinfo (Developer - GPU rendering mode - adb shell dumpsys gfxinfo)
+# noLog : False (Save test data to log file)
+
+# ************* Collect a performance parameter ************* #
+cpu = apm.collectCpu() # %
+memory = apm.collectMemory() # MB
+memory_detail = apm.collectMemoryDetail() # MB
+network = apm.collectNetwork(wifi=True) # KB
+fps = apm.collectFps() # HZ
+battery = apm.collectBattery() # level:% temperature:°C current:mA voltage:mV power:w
+gpu = apm.collectGpu() # %
+disk = apm.collectDisk()
+thermal = apm.collectThermal()
+# ************* Collect all performance parameter ************* #
+ 
+if __name__ == '__main__':
+  apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in',platform='Android', deviceId='ca6bd5a5', surfaceview=True, 
+                              noLog=False, pid=None, record=False, collect_all=True, duration=0)
+  # apm = AppPerformanceMonitor(pkgName='com.bilibili.app.in', platform='iOS',  deviceId='xxxx', noLog=False, record=False, collect_all=True, duration=0)
+  #duration: running time (second)
+  #record: record android screen
+  apm.collectAll(report_path=None) # report_path='/test/report.html'
+
+# in other python file
+from magnax.public.apm import initPerformanceService  
+
+initPerformanceService.stop() # stop magnax
+```
+
+## 🏴󠁣󠁩󠁣󠁭󠁿Service API
+
+### Start the service in the background
+
+```
+# magnax version >= 2.1.5
+
+macOS/Linux: nohup python3 -m magnax &
+Windows: start /min python3 -m magnax &
+```
+
+### Request performance data from api
+
+```shell
+Android: http://{ip}:{port}/apm/collect?platform=Android&deviceid=ca6bd5a5&pkgname=com.bilibili.app.in&target=cpu
+iOS: http://{ip}:{port}/apm/collect?platform=iOS&pkgname=com.bilibili.app.in&target=cpu
+
+target in ['cpu','memory','memory_detail','network','fps','battery','gpu']
+```
+
+## 🔥Features
+
+* **No ROOT/Jailbreak:** No need of Root for Android devices, Jailbreak for iOS devices. Efficiently solving the test and analysis challenges in Android & iOS performance.
+* **Data Integrality:** We provide the data about CPU, GPU, Memory, Battery, Network,FPS, Jank, etc., which you may easy to get.
+* **Beautiful Report:** A beautiful and detailed report analysis, where to store, visualize, edit, manage, and download all the test cases collected with MagnaX no matter where you are or when is it.
+* **Useful Monitoring Settings:** Support setting alarm values, collecting duration, and accessing mobile devices on other PC machines during the monitoring process.
+* **PK Model:** Supports simultaneous comparative testing of two mobile devices.
+
+  - 🌱2-devices: test the same app on two different phones.
+  - 🌱2-apps: test two different apps on two phones with the same configuration.
+* **Collect In Python/API:** Support Python and API to collect performance data, helping users easily integrate into automated testing processes.
+
+## Develop
+
+* https://github.com/pallets/flask
+* https://github.com/tabler/tabler
+
+### Dependencies
+
+| Package | Purpose |
+|---|---|
+| flask >= 3.1.0 | Web framework |
+| loguru | Logging |
+| openpyxl >= 3.1.0 | Excel report export (.xlsx) |
+| pymobiledevice3 >= 2.0.0 | iOS device control |
+| py-ios-device >= 2.0.0 | iOS performance data collection |
+| fire | CLI argument parsing |
+| psutil | System process utilities |
+| opencv-python | Screen recording |
+
+### Debug
+
+* Remove `magnax.` prefix in import paths
+
+```python
+# example
+from magnax.view.apis import api
+# change to
+from view.apis import api
+```
+
+* Run debug server
+
+```shell
+cd magnax
+python debug.py
+```
+
+## Browser
+
+<img src="https://cdn.nlark.com/yuque/0/2023/png/153412/1677553244198-96ce5709-f33f-4038-888f-f330d1f74450.png" alt="Chrome" width="50px" height="50px" />
+
+## Terminal
+
+- windows: PowerShell
+- macOS：iTerm2 (https://iterm2.com/)
+
+## 💕Thanks
+
+- https://github.com/doronz88/pymobiledevice3
+- https://github.com/YueChen-C/py-ios-device
+- https://github.com/Genymobile/scrcpy

magnax-1.0.0/magnax/__init__.py

@@ -0,0 +1,3 @@
+# -*- encoding: utf-8 -*-
+
+__version__ = '1.0.0'

magnax-1.0.0/magnax/__main__.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+MagnaX - Real-time performance monitoring tool for Android/iOS apps.
+
+Usage:
+    magnax [--host=HOST] [--port=PORT]
+    python -m magnax [--host=HOST] [--port=PORT]
+
+Examples:
+    magnax                          # Start with default settings (localhost:50003)
+    magnax --host=0.0.0.0 --port=8080  # Custom host and port
+"""
+
+import fire
+from magnax.web import main as web_main
+
+
+def main():
+    """Entry point for the magnax command."""
+    fire.Fire(web_main)
+
+
+if __name__ == '__main__':
+    main()

magnax-1.0.0/magnax/debug.py

@@ -0,0 +1,65 @@
+import multiprocessing
+import subprocess
+import time
+import os
+import webbrowser
+import requests
+import socket
+import psutil
+import sys
+from view.apis import api
+from view.pages import page
+from loguru import logger
+from flask import Flask
+from pyfiglet import Figlet
+from magnax import __version__
+
+app = Flask(__name__, template_folder='templates', static_folder='static')
+app.register_blueprint(api)
+app.register_blueprint(page)
+
+
+def ip() -> str:
+    try:
+        ip = socket.gethostbyname(socket.gethostname())
+    except:
+        ip = '127.0.0.1'    
+    return ip
+
+def listen(port):
+    net_connections = psutil.net_connections()
+    conn = [c for c in net_connections if c.status == "LISTEN" and c.laddr.port == port]
+    if conn:
+        pid = conn[0].pid
+        logger.warning('Port {} is used by process {}'.format(port, pid))
+        logger.info('you can start magnax : python -m magnax --host={ip} --port={port}')
+        return False
+    return True
+
+def status(host: str, port: int):
+    r = requests.get('http://{}:{}'.format(host, port), timeout=2.0)
+    flag = (True, False)[r.status_code == 200]
+    return flag
+
+
+def open_url(host: str, port: int):
+    flag = True
+    while flag:
+        logger.info('start magnax server ...')
+        f = Figlet(font="slant", width=300)
+        print(f.renderText("MAGNAX {}".format(__version__)))
+        flag = status(host, port)
+    webbrowser.open('http://{}:{}/?platform=Android&lan=en'.format(host, port), new=2)
+    logger.info('Running on http://{}:{}/?platform=Android&lan=en (Press CTRL+C to quit)'.format(host, port))
+
+
+def start(host: str, port: int):
+    logger.info('Running on http://{}:{}/?platform=Android&lan=en (Press CTRL+C to quit)'.format(host, port))
+    app.run(host=host, port=port, debug=True)
+
+def main(host=ip(), port=50003):
+    start(host, port)      
+
+
+if __name__ == '__main__':
+    main()

magnax-1.0.0/magnax/public/__init__.py

@@ -0,0 +1 @@
+

magnax-1.0.0/magnax/public/adb.py

@@ -0,0 +1,96 @@
+#!/usr/bin/python
+# encoding=utf-8
+
+"""
+@Author  :  Lijiawei
+@Date    :  2022/6/19
+@Desc    :  adb line.
+@Update  :  2022/7/14 by Rafa chen
+"""
+import os
+import platform
+import stat
+import subprocess
+
+STATICPATH = os.path.dirname(os.path.realpath(__file__))
+DEFAULT_ADB_PATH = {
+    "Windows": os.path.join(STATICPATH, "adb", "windows", "adb.exe"),
+    "Darwin": os.path.join(STATICPATH, "adb", "mac", "adb"),
+    "Linux": os.path.join(STATICPATH, "adb", "linux", "adb"),
+    "Linux-x86_64": os.path.join(STATICPATH, "adb", "linux", "adb"),
+    "Linux-armv7l": os.path.join(STATICPATH, "adb", "linux_arm", "adb"),
+}
+
+
+def make_file_executable(file_path):
+    """
+    If the path does not have executable permissions, execute chmod +x
+    :param file_path:
+    :return:
+    """
+    if os.path.isfile(file_path):
+        mode = os.lstat(file_path)[stat.ST_MODE]
+        executable = True if mode & stat.S_IXUSR else False
+        if not executable:
+            os.chmod(file_path, mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+        return True
+    return False
+
+
+def builtin_adb_path():
+    """
+    Return built-in adb executable path
+
+    Returns:
+        adb executable path
+
+    """
+    system = platform.system()
+    machine = platform.machine()
+    adb_path = DEFAULT_ADB_PATH.get('{}-{}'.format(system, machine))
+    proc = subprocess.Popen('adb devices', stdout=subprocess.PIPE, shell=True)
+    result = proc.stdout.read()
+    if not isinstance(result, str):
+        result = str(result, 'utf-8')
+    if result and "command not found" not in result:
+        adb_path = "adb"
+        return adb_path
+
+    if not adb_path:
+        adb_path = DEFAULT_ADB_PATH.get(system)
+    if not adb_path:
+        raise RuntimeError("No adb executable supports this platform({}-{}).".format(system, machine))
+
+    # overwrite uiautomator adb
+    if "ANDROID_HOME" in os.environ:
+        del os.environ["ANDROID_HOME"]
+    if system != "Windows":
+        # chmod +x adb
+        make_file_executable(adb_path)
+    return adb_path
+
+
+class ADB(object):
+
+    def __init__(self):
+        self.adb_path = builtin_adb_path()
+
+    def shell(self, cmd, deviceId):
+        run_cmd = f'{self.adb_path} -s {deviceId} shell {cmd}'
+        result = subprocess.Popen(run_cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE).communicate()[
+            0].decode("utf-8").strip()
+        return result
+    
+    def tcp_shell(self, deviceId, cmd):
+        run_cmd = f'{self.adb_path} -s {deviceId} {cmd}'
+        result = os.system(run_cmd)
+        return result
+
+    def shell_noDevice(self, cmd):
+        run_cmd = f'{self.adb_path} {cmd}'
+        result = os.system(run_cmd)
+        return result    
+
+
+
+adb = ADB()