SpeedOf.Me API - macOS Integration

This example demonstrates how to integrate the SpeedOf.Me speed test API into a macOS app using WKWebView.

How It Works

The SpeedOf.Me API is JavaScript-based, so macOS apps use WKWebView to:

Load an HTML page containing the speed test
Receive results via WKScriptMessageHandler

This is very similar to the iOS example, with macOS-specific UI adaptations.

Files

speedtest.html - HTML page to load in WKWebView
SpeedTestView.swift - SwiftUI app with WKWebView wrapper

Prerequisites

Xcode 15+
macOS 13+ (Ventura)
Your SpeedOf.Me API key and registered domain

Key Differences from iOS

Aspect	iOS	macOS
View wrapper	`UIViewRepresentable`	`NSViewRepresentable`
Make view	`makeUIView`	`makeNSView`
Update view	`updateUIView`	`updateNSView`
Window style	N/A	`.windowStyle(.titleBar)`

Quick Start

1. Create a New macOS App

In Xcode: File > New > Project > macOS > App (SwiftUI)

2. Add Files

Copy speedtest.html and SpeedTestView.swift to your project.

3. Configure API Credentials

SomApi.account = "YOUR_API_KEY";
SomApi.domainName = "your-domain.com";

App Sandbox Entitlements

For network access, add to your .entitlements file:

<key>com.apple.security.network.client</key>
<true/>

Window Configuration

WindowGroup {
    SpeedTestView()
        .frame(minWidth: 400, idealWidth: 450, minHeight: 500, idealHeight: 600)
}
.windowStyle(.titleBar)
.windowResizability(.contentMinSize)

Menu Bar App (Alternative)

@main
struct SpeedTestApp: App {
    var body: some Scene {
        MenuBarExtra("Speed Test", systemImage: "speedometer") {
            SpeedTestView()
                .frame(width: 350, height: 450)
        }
        .menuBarExtraStyle(.window)
    }
}

Distribution

Mac App Store

Archive your app in Xcode
Upload to App Store Connect
Requires Apple Developer account

Direct Distribution

Archive in Xcode
Export as "Developer ID" signed app
Notarize with Apple
Distribute via your website

Troubleshooting

WebView not loading: Check that HTML file is in bundle
Network requests blocked: Add com.apple.security.network.client entitlement
Window too small: Adjust minWidth/minHeight in frame modifier

Links

Back to macOS All Examples