Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yagiz/bagel
a little native network debugging tool for iOS
https://github.com/yagiz/bagel
alamofire debug ios network network-traffic swift
Last synced: about 10 hours ago
JSON representation
a little native network debugging tool for iOS
- Host: GitHub
- URL: https://github.com/yagiz/bagel
- Owner: yagiz
- License: apache-2.0
- Created: 2017-05-12T11:22:19.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T10:54:06.000Z (4 months ago)
- Last Synced: 2024-12-31T07:07:12.236Z (about 10 hours ago)
- Topics: alamofire, debug, ios, network, network-traffic, swift
- Language: Swift
- Homepage:
- Size: 9.52 MB
- Stars: 4,386
- Watchers: 50
- Forks: 322
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bagel
Bagel is a little native iOS network debugger. It's not a proxy debugger so you don't have to mess around with certificates, proxy settings etc. As long as your iOS devices and your Mac are in the same network, you can view the network traffic of your apps seperated by the devices or simulators.
## Preview
## Installation
#### Install Mac App
- Clone the repo.
- Install pods.
- Build and archive the project.
#### Install iOS Client
#### CocoaPods
```shhttps://img.shields.io/badge/version-1.3.1-blue.svg?style=flat
pod 'Bagel', '~> 1.4.0'
```
##### Carthage
```sh
github "yagiz/Bagel" "1.4.0"
```
##### Accio
```swift
.package(url: "https://github.com/yagiz/Bagel.git", .upToNextMajor(from: "1.4.0")),
```
### Usage
Most basic usage is to start Bagel iOS before any network operation.
```swift
//import Bagel
Bagel.start()
```
Since Bagel exposes every request info to the public it would be better if you disable it for the store versions. You can use the below snippet to do it:
```swift
//import Bagel
#if DEBUG
Bagel.start()
#endif
```
### Configuring Bagel
By default, Bagel gets your project name and device information. Desktop client uses these informations to separate projects and devices. You can configure these if you wish:
```swift
let bagelConfig = BagelConfiguration()
bagelConfig.project.projectName = "Custom Project Name"
bagelConfig.device.deviceName = "Custom Device Name"
bagelConfig.device.deviceDescription = "Custom Device Description"
Bagel.start(bagelConfig)
```
Bagel framework communicates with the desktop client by using Bonjour protocol. You can also configure these Netservice parameters. Default values are:
```swift
let bagelConfig = BagelConfiguration()
bagelConfig.netservicePort = 43434
bagelConfig.netserviceDomain = ""
bagelConfig.netserviceType = "_Bagel._tcp"
bagelConfig.netserviceName = ""
Bagel.start(bagelConfig)
```
If you change Netservice parameters in your app, you should also change them on desktop client.
License
----
Apache