README.md

README

Pre-Requirements

Run the CI setup script from the OpenSwiftUI repository root. It checks out the local package dependencies used by the generated Example project.

# From OpenSwiftUI/Example
../Scripts/CI/darwin_setup_build.sh

OpenCoreGraphics and OpenObservation are resolved through the OpenSwiftUI package dependency.

Configure AttributeGraph Backend

Since OpenAttributeGraph is not yet completed, you need to configure an AG backend before building.

This example defaults to Apple's private AttributeGraph framework through mise.toml.

Or use the Compute module:

export OPENSWIFTUI_OPENATTRIBUTESHIMS_COMPUTE=1
export OPENSWIFTUI_OPENATTRIBUTESHIMS_COMPUTE_USE_BINARY=1

Generate Project

The recommended setup path is the local setup script:

./setup.sh

The script trusts and installs the tools declared by Example/mise.toml, then runs Tuist through mise exec so the pinned Tuist version is used.

To run the steps manually:

mise trust mise.toml
mise install
mise exec -- tuist install
mise exec -- tuist generate --no-open

By default, the generated Debug Example targets include LookInsideServer. You can switch the debug inspector server before running tuist install and tuist generate:

# Default
export OPENSWIFTUI_EXAMPLE_LOOKINSIDE_SERVER=1
export OPENSWIFTUI_EXAMPLE_LOOKIN_SERVER=0

# Use Lookin instead
export OPENSWIFTUI_EXAMPLE_LOOKINSIDE_SERVER=0
export OPENSWIFTUI_EXAMPLE_LOOKIN_SERVER=1

# Disable both
export OPENSWIFTUI_EXAMPLE_LOOKINSIDE_SERVER=0
export OPENSWIFTUI_EXAMPLE_LOOKIN_SERVER=0

Do not enable both server variables at the same time.

Example

A OpenSwiftUI/SwiftUI App lifecycle example.

• Choose SwiftUIDebug configuration to run with SwiftUI
• Choose OpenSwiftUIDebug configuration to run with OpenSwiftUI

HostingExample

A UIKit/AppKit hosting example that manually sets up the application lifecycle and window using UIHostingView / NSHostingView.

• Choose SwiftUIDebug configuration to run with SwiftUI
• Choose OpenSwiftUIDebug configuration to run with OpenSwiftUI