Skip to content

AppleTrace 2.1.0

Latest

Choose a tag to compare

@everettjf everettjf released this 11 Nov 18:46
· 2 commits to master since this release
4897518

Added

  • appletrace summary: per-span count, total, self, mean, p50, p95 and max
    durations for one or more runs, as a table or JSON (-o saves a baseline).
  • appletrace diff: compares two traces or summaries span by span and exits
    with status 2 when a span regressed by more than --threshold and
    --min-delta (--metric, --only, --fail-on-missing, --json). See
    docs/ci-performance-gates.md.
  • TraceStatistics, TraceStatisticsBuilder and TraceComparison in
    AppleTraceKit.
  • Swift async spans (withAsyncSpan, @Traced on async functions) record
    the current task's name (Swift 6.2 named tasks, OS 26 and later) as their
    task argument. C: APTAsyncBeginWithTask().
  • Binary fragments gain a T record carrying that task name; appletrace merge and merge.py attach it to the async begin that follows.

Verified

  • Swift tests (36), Python tests (27), scripts/test_ci_gates.sh, and the
    Swift demo app recorded three times against three times on an iOS 27.2
    Simulator: unchanged code passes with --metric p50 --threshold 20% --min-delta 2ms, and runs recorded under load are flagged.

Assets

  • appletrace-2.1.0-macos.zip — the appletrace CLI (universal macOS binary, ad-hoc signed; if Gatekeeper blocks it, run xattr -d com.apple.quarantine appletrace or build with swift build -c release --product appletrace)
  • appletrace.xcframework.zip — Objective-C framework (iOS device arm64/arm64e, iOS Simulator arm64/x86_64)
  • appletrace-loader_2.1.0_iphoneos-arm64.deb — jailbreak loader, rootless
  • appletrace-loader_2.1.0_iphoneos-arm64e.deb — jailbreak loader, roothide
  • SHA256SUMS

Swift Package Manager: .package(url: "https://github.com/everettjf/appletrace.git", from: "2.1.0")

Guide: Performance gates in CI