Git Product home page Git Product logo

androiddebugtools's Introduction

Android Debug工具

简介

  1. Android Debug工具内置多线程的微型服务器，在同一个局域网中可以使用浏览器直接访问其内容。因此可以通过浏览器来操作当前App的行为以及adb等服务。
  2. 目前实现了查看当前App数据库以及SD卡内容。
  3. Android Debug工具提供了极高的拓展方式，可以通过Rest风格的Api来拓展，亦可以把它当成一个简单的静态资源服务器。
  4. 由于Android性能有限，不建议负载太大的工作，更不能保证高并发。建议在开发环境使用，生产酌情使用。
  5. 服务器暂时只支持支持GET和POST两种方式。

技术栈

Android 端无任何依赖，全部原生代码完成。

  • Android：使用Java通过Socket方式实现HTTP协议的服务端。
  • Web：使用Angular。

使用方法

体验

  1. 下载apk安装包，安装到手机。
  2. 点击数据库添加数据和获取SD卡权限
  3. 启动App，下拉通知栏
  4. 打开你的浏览器，按照3的操作步骤体验吧

集成

Android Debug工具完全无代码侵入性，意味着你只需添加依赖，无需编写任何代码即可以体验基础功能。

  • 添加依赖 debugImplementation 'io.lecon.debugtools:debugtools:1.0.5'

接口开放

本地接口

Android端微型服务器使用Json方式传递数据，内置静态服务器，非常适合前后端分离。内置功能包含：

  1. 路由注册
  2. 文件下载
  3. 静态服务
        if (urlSplit.length > 1) {
            // error-demo
            if ("error".equals(urlSplit[1])) {
                Route errorRoute = new ErrorRoute();
                Result process = errorRoute.process(request);
                response = new JsonResponse(process);
                return response;
            }

            if ("db".equals(urlSplit[1])) {
                Route dbRoute = new DbRoute(mContext);
                Result process = dbRoute.process(request);
                response = new JsonResponse(process);
                return response;
            }

            if ("disk".equals(urlSplit[1])) {
                Route diskRoute = new DiskRoute(mContext);
                Result process = diskRoute.process(request);
                response = new JsonResponse(process);
                return response;
            }

            //SimpleHTTPServer
            if ("file".equals(urlSplit[1])) {
                return new ByteResponse(Utils.loadFileContent(requestURI.split("file")[1]));
            }
        }
        //资源处理
        return new ByteResponse(Utils.loadAssetContent(WEB_FOLDER + requestURI, mContext.getAssets()));

其中，第3-20行是内置路由规则，error处理了错误异常的Response，db处理了内置数据库查看工具的Api，disk处理了SDcard查看工具的Api，这三个路由返回结果都是Json方式。

file是下载工具，通过这个Api可以下载Sdcard内任何有权限的文件，遇到目录则压缩后下载。

如果匹配不到，那么就到Assets目录下面匹配静态资源，他可以根据文件类型自动匹配Content-Type。所以如果想输出静态Html那么就放到这个匹配规则里边。

Api

目前此工具提供数据库查看和SD卡查看两种功能，这两个功能通过Restful风格提供。下面开放的Api

数据库工具

列出数据库
http://127.0.0.1:8089/db/listDatabase

方法：GET 参数：无 响应：

{
    "success": true,
    "message": "ok",
    "obj": [
        {
            "name": "Contact.db",
            "path": "/data/user/0/cn.liucl.unitedebugtoolsclient/databases/Contact.db"
        },
        {
            "name": "Car.db",
            "path": "/data/user/0/cn.liucl.unitedebugtoolsclient/databases/Car.db"
        }
    ]
}
列出表
http://127.0.0.1:8089/db/listTable?dbName=Car.db

方法：GET 参数：dbName 响应：

{
    "success": true,
    "message": "ok",
    "obj": [
        "cars"
    ]
}
查询数据
http://127.0.0.1:8089/db/query?dbName=Car.db&tableName=cars

方法：GET 参数：

参数 描述
dbName 数据库名称
tableName 表名
condition 查询条件
limit 查询多少条
offset 偏移量

响应：

{
    "success": true,
    "message": "ok",
    "obj": {
        "columns": [
            {
                "columnName": "id",
                "isPrimary": true
            },
            {
                "columnName": "name",
                "isPrimary": false
            },
            {
                "columnName": "color",
                "isPrimary": false
            },
            {
                "columnName": "mileage",
                "isPrimary": false
            }
        ],
        "list": [
            {
                "id": 1,
                "name": "name_0",
                "color": "RED",
                "mileage": 10.449999809265137
            },
            {
                "id": 2,
                "name": "name_1",
                "color": "RED",
                "mileage": 11.449999809265137
            },
            {
                "id": 3,
                "name": "name_2",
                "color": "RED",
                "mileage": 12.449999809265137
            },
            {
                "id": 4,
                "name": "name_3",
                "color": "RED",
                "mileage": 13.449999809265137
            }
        ],
        "pageInfo": {
            "count": 50
        }
    }
}
插入数据
http://127.0.0.1:8089/db/insert

方法：POST 参数：

参数 描述
dbName 数据库名
tableName 表名
newValue 插入值的json

响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}
更新数据
http://127.0.0.1:8089/db/update

方法：POST 参数：

参数 描述
dbName 数据库名
tableName 表名
condition 条件
newValue 新值

响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}
删除数据
http://127.0.0.1:8089/db/delete

方法：GET 参数：

参数 描述
dbName 数据库名
tableName 表名
condition 条件

响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}
查看当前数据库版本号
http://127.0.0.1:8089/db/version

方法：GET 参数：

参数 描述
dbName 数据库名

响应：

{
    "success": true,
    "message": "ok",
    "obj": {
        "version":20
    }
}
查看表数据个数
http://127.0.0.1:8089/db/count

方法：GET 参数：

参数 描述
dbName 数据库名
tableName 表名
condition 条件

响应：

{
    "success": true,
    "message": "ok",
    "obj": {
        "count":50
    }
}

SDCard工具

查看当前目录下所有文件和文件夹
127.0.0.1:8089/disk/list?type=sdcard&/data/io.lecon/

方法：GET 参数：

参数 描述
type sdcard、inner SD卡还是App内部存储
path 要列出的目录

响应：

{
    "success": true,
    "message": "ok",
    "obj": [
        {
            "filename": "log",
            "isFolder": true,
            "size": 0,
            "permission": "rwx",
            "realPath": "/storage/emulated/0/data/io.lecon/log"
        }
    ]
}
重命名
127.0.0.1:8089/disk/rename?type=inner&/data/io.lecon/

方法：GET 参数：

参数 描述
type sdcard、inner SD卡还是App内部存储
path 要列出的目录

响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}
删除当前目录下所有文件和文件夹
127.0.0.1:8089/disk/delete?type=sdcard&/data/io.lecon/

方法：GET 参数：

参数 描述
type sdcard、inner SD卡还是App内部存储
path 要列出的目录

响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}

其他

下载

遇到文件下载，遇见文件夹压缩后下载

127.0.0.1:8089/file/you/file/path

方法：GET 参数：无 响应：

{
    "success": true,
    "message": "ok",
    "obj": null
}

androiddebugtools's People

Contributors

leconio avatar

Watchers

avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.