Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ripperhe/debugo

一个可能有点用的 iOS 调试工具~
https://github.com/ripperhe/debugo

debug debugging debugging-tool ios objective-c suspension tool uiwindow

Last synced: 6 days ago
JSON representation

一个可能有点用的 iOS 调试工具~

Awesome Lists containing this project

README

        



# Debugo

[![Version](https://img.shields.io/cocoapods/v/Debugo.svg?style=flat)](https://cocoapods.org/pods/Debugo)
[![License](https://img.shields.io/cocoapods/l/Debugo.svg?style=flat)](https://cocoapods.org/pods/Debugo)
[![Platform](https://img.shields.io/cocoapods/p/Debugo.svg?style=flat)](https://cocoapods.org/pods/Debugo)

Debugo 是一款致力于 iOS Debugging 的实用工具,集成和启用都非常简单。以 Debug 为宗旨,自然要做到尽量简单,尽量避免 Debug 工具而导致 Bug 的情况。后续应该还会加入一些新的功能~

- [x] **方便** 一行代码即可启用
- [x] **安全** 内部做了控制,仅在 **DEBUG** 模式可以启用,携带上线无压力
- [x] **灵活** 可添加自定义指令和工具

## Features

* 指令
* 快捷添加代码块,点击指令列表的 `Cell` 执行
* 支持多人协作,根据 User 自动优先显示当前用户的指令
* 文件
* 支持查看沙盒和 Bundle 的文件
* 支持预览数据库及其他大部分文件
* 支持利用 `AirDrop` 分享文件
* 支持设置文件捷径,快速直达经常查看的文件
* App 信息
* 查看 Bundle 信息
* 查看设备信息
* 查看编译信息([需配置脚本 🚀](https://github.com/ripperhe/Debugo/blob/master/docs/build-info.md))
* 快速登录
* 简单配置之后,可一键登录
* 调用一句代码即可缓存账号
* Apple 内部神器
* 集成苹果内部工具 `UIDebuggingInformationOverlay`
* [查看使用方法 🚀](http://ryanipete.com/blog/ios/swift/objective-c/uidebugginginformationoverlay/)
* 触摸监听
* 监听手势触摸
* 用于手机录屏时能够看到手指的操作
* UIView 背景色
* 快速显示顶部控制器视图的背景色
* 多种渲染方式
* CocoaPods
* 查看工程安装的 pod 库([需配置脚本 🚀](https://github.com/ripperhe/Debugo/blob/master/docs/build-info.md))
* 查看 pod 库的最新版本

## Snapshot

| 指令 | 文件 | APP 信息 |
|:---: |:---:| :---: |
| ![](docs/_media/debugo_action.png) | ![](docs/_media/debugo_file.png) | ![](docs/_media/debugo_appinfo.png )|

| 快速登录 | Apple 内部神器 | 触摸监听 |
|:---: |:---:| :---: |
| ![](docs/_media/debugo_account.png) | ![](docs/_media/debugo_apple.png) | ![](docs/_media/debugo_touch.png )|

| UIView 背景色 | CocoaPods | 工具总览 |
|:---: |:---:| :---: |
| ![](docs/_media/debugo_uiviewcolor.png) | ![](docs/_media/debugo_pod.png) | ![](docs/_media/debugo_plugin.png )|

## Example

克隆或下载仓库到本地,进入到 Example/Debugo-Example-ObjectiveC 文件夹,打开 `Debugo-Example-ObjectiveC.xcworkspace` 运行即可。

## Requirements

iOS 8.0+

## Dependency

本框架内部借鉴了很多框架,但是真正依赖的只有一个框架:

* [FMDB (>= 2.7.2)](https://github.com/ccgus/fmdb)

## Installation

本仓库支持 CocoaPods 安装,在工程的 Podfile 文件添加如下代码:

```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
pod 'Debugo',
end
```

## Usage For Objective-C

导入头文件

```objectivec
#import
```

启用

```objectivec
[Debugo fireWithConfiguration:^(DGConfiguration * _Nonnull configuration) {
// 配置 configuration,定制你的需求
}];
```

更多详细的使用方法可下载 Demo 查看

## Thanks

开发框架的灵感,以及一些现成的代码很多都源于 GitHub 网站上的开源框架,感谢以下项目和文章的作者:

* [Alpha](https://github.com/Legoless/Alpha)
* [FileBrowser](https://github.com/marmelroy/FileBrowser)
* [GetGitInfo](https://github.com/y500/GetGitInfo)
* [DebuggingOverlay](https://gist.github.com/IMcD23/1fda47126429df43cc989d02c1c5e4a0)
* [DatabaseVisual](https://github.com/YanPengImp/DatabaseVisual)
*
*
*
* ...

## Author

ripperhe, [email protected]

## License

Debugo 基于 MIT 协议,详细请查看 LICENSE 文件。