Skip to content

peek 0.3.0

Latest

Choose a tag to compare

@kimikr kimikr released this 19 Nov 22:26

Install / update

curl -fsSL https://raw.githubusercontent.com/kimikr/peek/main/scripts/install.sh | sh
peek doctor

On the phone, install Peek-0.3.0.ipa with SideStore or AltStore, or add it to LiveContainer. Check it with sha256sum -c Peek-0.3.0.ipa.sha256. The 0.2 app still talks to this script (same protocol), but the menu's "Erase saved data and quit" needs the 0.3.0 app.

Everything below was checked on an iPhone (iOS 27, Peek inside LiveContainer), with real apps: MensaDresden, bev17 and a SwiftData app opened from its .xcodeproj.

New

  • Tests on the phone: XCUITest. peek test now runs UI tests too: taps, typing, swipes, pinch, rotation, system alerts, launch arguments and environment, and other apps (launch, activate, terminate). --once exits with the result, --junit FILE writes a report, --filter picks tests. A failing UI test prints the app's element tree.
  • Xcode projects. peek dev App.xcodeproj (or its folder) builds the app target as a package: classic groups and Xcode 16 folders, Swift package products, local packages, the Debug Swift settings, and unit and UI test targets for peek test.
  • SwiftData. @Model, @Query, #Predicate, @Attribute, @Relationship, @Transient, #Unique, #Index and @ModelActor build on Linux: peek ships its own SwiftData macros and builds them once. Each project gets a store of its own; the Peek menu erases it.
  • Asset catalogs are compiled to Assets.car, dark and @1x/@2x/@3x variants included, also inside dependencies, by peek's own actool (built on AssetKit).
  • Breakpoints. // peek:break a, b.count stops the app at that line and shows the values and call stack on the phone; // peek:log a, b prints them.
  • Languages. peek dev --language de shows the app's strings in another language, right to left for Arabic and Hebrew.
  • Your app's Bundle.main. Its Info.plist keys and the resources it reads from the main bundle (url(forResource:), UIImage(named:) with any name) come from your app.
  • Crashes print their call stack, for Objective-C exceptions and for crashes such as a Swift runtime trap.

Fixes

  • Text("key") and SwiftGen strings show translations instead of keys; SWIFT_PACKAGE is defined like SwiftPM does.
  • Sources in a linked folder, asset names with non-ASCII letters, struct App: SwiftUI.App, @main @MainActor struct …, and #Preview inside #if build.
  • Projects whose default actor isolation is MainActor build with all of the above.
  • A failed signing no longer leaves an unsigned library that was served from then on; certificate installs are atomic.
  • The server refuses badly signed requests before reading their body, drops idle clients and caps concurrent requests. Two peek runs on one project no longer share a build folder.

Known limits

  • A dependency (not the previewed target) with a string catalog can't be built on Linux (SwiftPM cannot be told the strings' encoding there).
  • @Attribute(.transformable(by:)) with a transformer class of your own crashes inside SwiftData.
  • With --language, dates and numbers keep the phone's format and plurals show their "other" form.
  • Log output from the phone is signed but not encrypted, and replies are not yet bound to their requests. Both change with the next protocol version.