Skip to content

Building

Alejandro Mora edited this page Nov 12, 2026 · 1 revision

Building

You need the .NET 10 SDK and the MAUI workload (dotnet workload install maui), plus Xcode for Apple targets and the Android SDK for Android.

Tests

dotnet test --project Readout.Tests

With --coverlet, the tests also measure code coverage of Readout.Core and Readout.Mcp and write a Cobertura report to TestResults/coverage (settings in Readout.Tests/testconfig.json). CI does this on every push and shows the numbers in the run's summary.

dotnet test --project Readout.Tests --coverlet --results-directory TestResults/coverage

The app

dotnet build Readout -f net10.0-ios
dotnet build Readout -f net10.0-maccatalyst
dotnet build Readout -f net10.0-android

On Windows, -f net10.0-windows10.0.19041.0. The Linux build is a separate project that builds anywhere, without the MAUI workload (see Linux):

dotnet build Readout.Linux

Without a meter

Simulators and emulators have no Bluetooth. Debug builds running on one use the simulated meter when you scan (set READOUT_FAKE_BLE=1 to do that anywhere). Every build also has Try the demo meter on the connect screen.

Running on a device

Script What
./deploy-ios.sh Builds and installs on a physical iPhone. Device names come from .devices (git-ignored).
./deploy-mac.sh Builds and launches the Mac app (--log follows its output).
./deploy-windows.ps1 Builds and launches the Windows app (Debug, unpackaged), replacing a running copy.
./deploy-esp.sh Builds and flashes the FS9721 bridge to an ESP32 on USB.

Per-machine settings stay out of git: Directory.Build.local.props (Mac Debug code signing; see the .example next to it) and .devices (iPhone UDIDs for deploy-ios.sh).

For store packages, see Publishing.

Readout

Home


Developing

Platforms

Reference (in the repo)

Clone this wiki locally