Bagel v1.4 releases: a little native network debugging tool for iOS

by do son · Published May 27, 2019 · Updated October 22, 2020

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 separated by the devices or simulators.

Changelog v1.4

iOS 13 status code fix
Minor improvements

Installation

Install Mac App

Clone the repo: git clone https://github.com/yagiz/Bagel.git
Install pods.
Build and archive the project.

Install iOS Client

CocoaPods

pod 'Bagel', '~>  1.3.2'

Carthage

github "yagiz/Bagel" "1.3.2"

Usage

Most basic usage is to start Bagel iOS before any network operation.

//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:

//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:

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 the Bonjour protocol. You can also configure these Netservice parameters. Default values are:

let bagelConfig = BagelConfiguration()

bagelConfig.netservicePort = 43434
bagelConfig.netserviceDomain = ""
bagelConfig.netserviceType = "_Bagel._tcp"
bagelConfig.netserviceName = ""

Bagel.start(bagelConfig)