Cutaway 1.2.0

What's new

Cutaway 1.2.0 speaks protocol 1.2. It works with apps that include CutawayServer 1.0 or 1.1; the features marked below need CutawayServer 1.2.0.

Environment (needs CutawayServer 1.2)

• Override the app’s appearance, text size (XS to AX5), layout direction and size classes from the Environment button in the toolbar or View › Environment. ⇧⌘A toggles light and dark.
• After a change, Cutaway waits for the app to redraw and refreshes the whole tree. Reset gives the app its own environment back, and so does closing the inspection.
• Archives remember the overrides and name them under the window’s title.

Your source code

• File › Link Project Folder… connects an app to its Xcode project; Settings › Projects lists the folders. Cutaway only reads them.
• Open in Xcode (⌥⌘O) jumps from the app’s own classes to their declarations, in Swift or Objective-C.
• Colors are named after the asset catalog’s color sets they match, and text shows the string catalog key it came from.
• Edit › Copy LLDB Command copies a command that prints the selected object, or stops when its frame changes.

Attributes

• Dynamic colors show their light and dark values side by side.
• An Accessibility section; text styles, drawn and truncated lines, images, index paths and item counts in one row each.
• Values that refer to other views, such as a stack view’s arranged subviews, are chips you can point at and click.

Your app’s own details (needs CutawayServer 1.2)

• An App section with the attribute groups your app adds, editable like any other.
• Colors your app registers are shown by name.
• Views your app marks start collapsed in the list, and views it excludes are hatched instead of captured.
• Virtual nodes: parts of the interface a view draws itself, such as the bars of a chart, appear in the tree with their own icon and a dashed outline.

Also

• Hold ⌥ over a row of the layer list to measure to that layer.
• A layer with a thousand attributes shows them at once, and screenshots arrive faster: about 1.4 s instead of 3.8 s for 5,000 layers.
• The documentation is now a website, nothingsh.github.io/Cutaway, in English and Simplified Chinese; Help opens it.

Installing

Download Cutaway-1.2.0.dmg, open it and drag Cutaway to Applications.

Cutaway is not notarized by Apple. The first time it is opened, macOS says it cannot
verify the developer: open System Settings › Privacy & Security and choose
Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Cutaway.app.

Checksums (SHA-256)

0fa1128a0f165c3c7434991bf4da8df626475315153cbf2a98c0b83ab8c18b8a  Cutaway-1.2.0.dmg
e75e0d54517a0ef7bdfc17864a2cbfb8797c4d353e8d4b27ad0026501181be34  Cutaway-1.2.0.zip

Cutaway 1.1.0

What's new

Cutaway 1.1.0 speaks protocol 1.1. It works with apps that include CutawayServer 1.0, and shows everything below with CutawayServer 1.1.0.

Attributes

• One list in five sections by purpose: Content, Appearance, Layout, Behavior and Object. Related attributes such as a border's width and color share one row; the constraints end the Layout section; Object holds the classes, the addresses (with copy buttons) and the owners.
• Values are shown as they are meant: units (pt, %), checkboxes, segmented controls for short enumerations, insets as a box, colors with their system names, and a value that has no effect is faded with the reason in its tooltip.
• A value outside the limits the app reports is never sent. The field stays open with a red outline and the reason under the row; Esc or leaving the field puts the value back. Numbers are typed, not dragged.
• A filter under the header, section headers that stay in view while the list scrolls, Option-click to fold every section, and a row of the layer's ancestors to jump to.
• The other end of a constraint is a chip with its icon and name. Point at a constraint to mark its other end in the preview, or turn on Show Constraint Ends (⇧⌘K) to mark them all.

Hierarchy

• Each layer has an icon: the color is its kind (window, text, control, image, scrolling, bar, …), the glyph its class, filled for the app's own classes and outlined for the system's.
• Guides show nesting, the ancestors of the row at the top stay pinned while you scroll, and the hovered row and the hovered layer in the preview follow each other.
• Select Parent (⌘↑) and Select First Child (⌘↓).

Preview and window

• The app's name, device and progress sit in a capsule on the left of the toolbar, which also opens the app list, refreshes and saves.
• A tag beside the selected layer names it and shows its size.
• Borders can be off, plain or colored by kind, optionally only for the app's own classes: in the preview's menu, under View › Borders, in Settings and in archives.
• The app list groups simulators and USB devices, selects the first app that can be inspected, and takes the arrow keys and Return.
• An appearance setting: system, light or dark.

Also

• Archives keep the new fields and fall back to the settings for what they lack; see Resources/ARCHIVE.md.
• The README in every language describes the new interface.

Installing

Download Cutaway-1.1.0.dmg, open it and drag Cutaway to Applications.

Cutaway is not notarized by Apple. The first time it is opened, macOS says it cannot
verify the developer: open System Settings › Privacy & Security and choose
Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Cutaway.app.

Checksums (SHA-256)

e92f53541edf31a13e283f6235e41a3074f8d44259380aae7382bb687834df35  Cutaway-1.1.0.dmg
344eb19ee9e4b8169c8f78328a430e5275172571f87066823745cdeaa4a4cbb2  Cutaway-1.1.0.zip

Cutaway 1.0.0

Installing

Download Cutaway-1.0.0.dmg, open it and drag Cutaway to Applications.

Cutaway is not notarized by Apple. The first time it is opened, macOS says it cannot
verify the developer: open System Settings › Privacy & Security and choose
Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Cutaway.app.

Checksums (SHA-256)

007e32b946cb2b58ed56516598be9bbd3156e39428b3360932826237488b1655  Cutaway-1.0.0.dmg
8e435cc92b8b553f78a1a035f996e9b0b3355d176f7033fd7e7327c5562fa69b  Cutaway-1.0.0.zip