https://github.com/heckj/mpcf-testbench

Tooling for benchmarking Multipeerconnectivity framework on apple platforms
https://github.com/heckj/mpcf-testbench

ios macos peer-to-peer swift5 swiftui tvos

Last synced: 19 days ago
JSON representation

Tooling for benchmarking Multipeerconnectivity framework on apple platforms

• Host: GitHub
• URL: https://github.com/heckj/mpcf-testbench
• Owner: heckj
• License: mit
• Created: 2020-04-13T00:12:29.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-08-26T15:57:43.000Z (about 2 years ago)
• Last Synced: 2024-10-10T19:41:14.800Z (about 1 month ago)
• Topics: ios, macos, peer-to-peer, swift5, swiftui, tvos
• Language: Swift
• Homepage:
• Size: 227 KB
• Stars: 7
• Watchers: 3
• Forks: 3
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MPCF-TestBench

[![Actions Status](https://github.com/heckj/MPCF-TestBench/workflows/CI/badge.svg)](https://github.com/heckj/MPCF-TestBench/actions)

[![license](https://img.shields.io/badge/license-mit-brightgreen.svg)](https://en.wikipedia.org/wiki/MIT_License)

![swift-5.2](https://img.shields.io/badge/Swift-5.2-orange.svg "Swift 5.2")

![@heckj](https://img.shields.io/badge/[email protected]?style=flat "Twitter: @heckj")

I was curious how "fast" [MultipeerConnectivity](http://developer.apple.com/documentation/multipeerconnectivity/) operates.

MultipeerConnectivity does a lot of "magic" in a really nice way: peer to peer advertising,

supporting delegated connects, and transfer of data. And it operates seamlessly over multiple transports - bluetooth

and wifi, focusing on connecting "nearby" peers - while hiding a lot of that detail away.

There are some really interesting wrappers over the top of it as well, such as [MultipeerKit](https://multipeerkit.rambo.codes) ([github repo](https://github.com/insidegui/MultipeerKit)).

This repository, with it's workspace and targets, is how I'm answering that question.

I found other repositories that worked MultipeerConnectivity to create benchmarks, but most of them are

dated and didn't directly compile. This is written with Swift 5, simple UI with SwiftUI, and has targets

building for macOS, iOS, and tvOS.

There are two sides to this "benchmark generator app": a reflector and a test runner.

- The reflector broadcasts that it's open to chat and reflects back any data sent to it.

- The test runner is the UI that can be used to trigger data sends and collects data about how it's operating.

It's up to you - running the benchmark - to configure your devices appropriately if you want to see differences in transport modes.

Because MultipeerConnectivity works over bluetooth or wifi, and seamlessly across both - and iOS doesn't provide

mechanisms to control what's on and off, I'm leaving that to the user setup if that's a dimension you want to gather

measurements against.

The project includes 3 reflector targets and 2 test-runner targets.

Reflector

- macOS

- iOS

- tvOS

Test Runner

- macOS

- iOS

## Command Line Builds

### Development setup

    brew bundle

investigating the workspace:

    xcodebuild -list -workspace MPCF-TestBench.xcworkspace

schemes:

    MPCF-Reflector-ios

    MPCF-Reflector-mac

    MPCF-Reflector-tvOS

    MPCF-TestRunner-ios

    MPCF-TestRunner-mac

### building the projects on the command line

    xcodebuild -workspace MPCF-TestBench.xcworkspace \

    -scheme MPCF-Reflector-ios \

    -destination 'platform=iOS Simulator,OS=13.4,name=iPhone 8'

    xcodebuild -workspace MPCF-TestBench.xcworkspace \

    -scheme MPCF-TestRunner-ios \

    -destination 'platform=iOS Simulator,OS=13.4,name=iPhone 8'

    xcodebuild -workspace MPCF-TestBench.xcworkspace \

    -scheme MPCF-Reflector-mac

    xcodebuild -workspace MPCF-TestBench.xcworkspace \

    -scheme MPCF-TestRunner-mac

    xcodebuild -workspace MPCF-TestBench.xcworkspace \

    -scheme MPCF-Reflector-tvOS \

    -destination 'platform=tvOS Simulator,OS=13.4,name=Apple TV'

### linting the code

    brew bundle

    swift format lint --configuration .swift-format-config -r .