Makefile

# ============================================================================
# SENTRY COCOA SDK MAKEFILE
# ============================================================================
# This Makefile provides automation for building, testing, and developing
# the Sentry Cocoa SDK. Run 'make help' to see all available commands.
# ============================================================================

.DEFAULT_GOAL := help

# ============================================================================
# CONFIGURATION
# ============================================================================

# Xcode scheme used to build Sentry SDK
XCODE_SCHEME = Sentry

# iOS Simulator OS version (defaults to '18.4', can be overridden via IOS_SIMULATOR_OS=latest)
IOS_SIMULATOR_OS ?= 18.4

# iOS Simulator device name (defaults to 'iPhone 16 Pro', can be overridden via IOS_DEVICE_NAME='iPhone 15 Pro')
IOS_DEVICE_NAME ?= iPhone 16 Pro

# tvOS Simulator OS version (defaults to 'latest', can be overridden via TVOS_SIMULATOR_OS=18.5)
TVOS_SIMULATOR_OS ?= latest

# tvOS Simulator device name (defaults to 'Apple TV', can be overridden via TVOS_DEVICE_NAME='Apple TV 4K')
TVOS_DEVICE_NAME ?= Apple TV

# visionOS Simulator OS version (defaults to 'latest', can be overridden via VISIONOS_SIMULATOR_OS=2.0)
VISIONOS_SIMULATOR_OS ?= latest

# visionOS Simulator device name (defaults to 'Apple Vision Pro', can be overridden via VISIONOS_DEVICE_NAME='Apple Vision Pro')
VISIONOS_DEVICE_NAME ?= Apple Vision Pro

# watchOS Simulator OS version (defaults to 'latest', can be overridden via WATCHOS_SIMULATOR_OS=11.0)
WATCHOS_SIMULATOR_OS ?= latest

# watchOS Simulator device name (defaults to 'Apple Watch SE 3 (44mm)', can be overridden via WATCHOS_DEVICE_NAME='Apple Watch Ultra 3 (49mm)')
WATCHOS_DEVICE_NAME ?= Apple Watch SE 3 (44mm)

# Current git reference name
GIT-REF := $(shell git rev-parse --abbrev-ref HEAD)

# Reduce build and test output for agents while retaining raw xcodebuild logs.
FOR_AGENTS ?= false
export FOR_AGENTS
XCBEAUTIFY_OUTPUT_FLAGS = $(if $(filter true,$(FOR_AGENTS)),--quieter --disable-logging,--preserve-unbeautified)

# ============================================================================
# SETUP
# ============================================================================

## Setup the project by installing dependencies, pre-commit hooks, rbenv, and bundler
#
# Sets up a fresh machine for development by chaining the install tasks.
# Generates Xcode projects via xcode-ci.
# Safe to re-run if you need to reinitialize dependencies or hooks.
.PHONY: init
init: init-local init-ci-build init-ci-format xcode-ci

## Setup local development environment
#
# Installs Homebrew, dependencies, pre-commit hooks, rbenv, bundler, and updates tooling versions.
.PHONY: init-local
init-local:
	which brew || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
	brew update && brew bundle
	pre-commit install
	rbenv install --skip-existing
	rbenv exec gem update bundler
	rbenv exec bundle install
	# Install the tools needed to update tooling versions locally
	"$(MAKE)" init-ci-build init-ci-format
	./scripts/update-tooling-versions.sh

## Install CI build dependencies
#
# Installs tools needed for CI build tasks using Brewfile-ci-build.
.PHONY: init-ci-build
init-ci-build:
	brew update && brew bundle --file Brewfile-ci-build

## Install CI format dependencies
#
# Installs tools needed to run CI format tasks locally using Brewfile-ci-format.
.PHONY: init-ci-format
init-ci-format:
	brew update && brew bundle --file Brewfile-ci-format

## Update tooling versions
#
# Updates tooling versions to match CI requirements.
.PHONY: update-versions
update-versions:
	./scripts/update-tooling-versions.sh

## Check tooling versions
#
# Verifies that local tooling versions match CI requirements.
.PHONY: check-versions
check-versions:
	./scripts/check-tooling-versions.sh

## Check SentryCrash imports
#
# CI ratchet that ensures the number of direct SentryCrash header imports
# from SDK source files does not increase beyond the established baseline.
.PHONY: check-sentrycrash-imports
check-sentrycrash-imports:
	@./scripts/check-sentrycrash-imports.sh

## Check changelog files for duplicate section headings
#
# Fails when a version block (including Unreleased) repeats a section heading
# such as ### Features. Requires markdownlint-cli2 from Brewfile.
.PHONY: check-changelog
check-changelog:
	./scripts/check-changelog.sh

# ============================================================================
# BUILDING
# ============================================================================

## Build all platforms
#
# Convenience target that invokes all platform build targets.
# See build-ios, build-macos, build-catalyst, build-tvos, build-visionos, build-watchos for more details.
.PHONY: build
build: build-ios build-macos build-catalyst build-tvos build-visionos build-watchos

## Build iOS target
#
# Builds the Sentry SDK for iOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-ios
build-ios:
	@echo "--> Building for iOS"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--configuration Debug

## Build macOS target
#
# Builds the Sentry SDK for macOS.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-macos
build-macos:
	@echo "--> Building for macOS"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--configuration Debug

## Build Catalyst target
#
# Builds the Sentry SDK for Mac Catalyst.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-catalyst
build-catalyst:
	@echo "--> Building for Catalyst"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--configuration Debug

## Build tvOS target
#
# Builds the Sentry SDK for tvOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-tvos
build-tvos:
	@echo "--> Building for tvOS"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--configuration Debug

## Build visionOS target
#
# Builds the Sentry SDK for visionOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-visionos
build-visionos:
	@echo "--> Building for visionOS"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--configuration Debug

## Build watchOS target
#
# Builds the Sentry SDK for watchOS Simulator.
# Note: Tests are not available for watchOS as XCTest is not supported on watchOS.
# Outputs logs and uses xcbeautify for formatted output.
.PHONY: build-watchos
build-watchos:
	@echo "--> Building for watchOS"
	set -o pipefail && NSUnbufferedIO=YES xcrun xcodebuild build \
		-workspace Sentry.xcworkspace \
		-scheme $(XCODE_SCHEME) \
		-destination 'platform=watchOS Simulator,OS=$(WATCHOS_SIMULATOR_OS),name=$(WATCHOS_DEVICE_NAME)' \
		-configuration Debug \
		CODE_SIGNING_ALLOWED="NO" 2>&1 | tee raw-build-output.log | xcbeautify $(XCBEAUTIFY_OUTPUT_FLAGS)

## Build all platforms with SDK_V10 flag
#
# Convenience target that invokes all V10 platform build targets.
.PHONY: build-v10
build-v10: build-ios-v10 build-macos-v10 build-catalyst-v10 build-tvos-v10 build-visionos-v10 build-watchos-v10

## Build iOS target with SDK_V10 flag
#
# Builds the Sentry SDK for iOS Simulator using the DebugV10 configuration.
.PHONY: build-ios-v10
build-ios-v10:
	@echo "--> Building V10 for iOS"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryV10 \
		--configuration DebugV10

## Build macOS target with SDK_V10 flag
#
# Builds the Sentry SDK for macOS using the DebugV10 configuration.
.PHONY: build-macos-v10
build-macos-v10:
	@echo "--> Building V10 for macOS"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryV10 \
		--configuration DebugV10

## Build Catalyst target with SDK_V10 flag
#
# Builds the Sentry SDK for Mac Catalyst using the DebugV10 configuration.
.PHONY: build-catalyst-v10
build-catalyst-v10:
	@echo "--> Building V10 for Catalyst"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryV10 \
		--configuration DebugV10 \
		--xcconfig Tests/Configuration/SentryV10Catalyst.xcconfig

## Build tvOS target with SDK_V10 flag
#
# Builds the Sentry SDK for tvOS Simulator using the DebugV10 configuration.
.PHONY: build-tvos-v10
build-tvos-v10:
	@echo "--> Building V10 for tvOS"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryV10 \
		--configuration DebugV10

## Build visionOS target with SDK_V10 flag
#
# Builds the Sentry SDK for visionOS Simulator using the DebugV10 configuration.
.PHONY: build-visionos-v10
build-visionos-v10:
	@echo "--> Building V10 for visionOS"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryV10 \
		--configuration DebugV10

## Build watchOS target with SDK_V10 flag
#
# Builds the Sentry SDK for watchOS Simulator using the DebugV10 configuration.
.PHONY: build-watchos-v10
build-watchos-v10:
	@echo "--> Building V10 for watchOS"
	set -o pipefail && NSUnbufferedIO=YES xcrun xcodebuild build \
		-workspace Sentry.xcworkspace \
		-scheme SentryV10 \
		-destination 'platform=watchOS Simulator,OS=$(WATCHOS_SIMULATOR_OS),name=$(WATCHOS_DEVICE_NAME)' \
		-configuration DebugV10 \
		CODE_SIGNING_ALLOWED="NO" 2>&1 | tee raw-build-output.log | xcbeautify $(XCBEAUTIFY_OUTPUT_FLAGS)

## Build all platforms
#
# Convenience target that invokes all non-V10 platform build targets.
# See build-objc-ios, build-objc-macos, build-objc-catalyst, build-objc-tvos,
# build-objc-visionos, and build-objc-watchos for more details.
.PHONY: build-objc
build-objc: build-objc-ios build-objc-macos build-objc-catalyst build-objc-tvos build-objc-visionos build-objc-watchos

## Build Objective-C iOS target
#
# Builds the SentryObjC wrapper for iOS Simulator.
.PHONY: build-objc-ios
build-objc-ios:
	@echo "--> Building SentryObjC for iOS"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build Objective-C macOS target
#
# Builds the SentryObjC wrapper for macOS.
.PHONY: build-objc-macos
build-objc-macos:
	@echo "--> Building SentryObjC for macOS"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build Objective-C Catalyst target
#
# Builds the SentryObjC wrapper for Mac Catalyst.
.PHONY: build-objc-catalyst
build-objc-catalyst:
	@echo "--> Building SentryObjC for Catalyst"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build Objective-C tvOS target
#
# Builds the SentryObjC wrapper for tvOS Simulator.
.PHONY: build-objc-tvos
build-objc-tvos:
	@echo "--> Building SentryObjC for tvOS"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build Objective-C visionOS target
#
# Builds the SentryObjC wrapper for visionOS Simulator.
.PHONY: build-objc-visionos
build-objc-visionos:
	@echo "--> Building SentryObjC for visionOS"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build Objective-C watchOS target
#
# Builds the SentryObjC wrapper for watchOS Simulator.
.PHONY: build-objc-watchos
build-objc-watchos:
	@echo "--> Building SentryObjC for watchOS"
	./scripts/sentry-xcodebuild.sh \
		--platform watchOS \
		--os $(WATCHOS_SIMULATOR_OS) \
		--device "$(WATCHOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjC \
		--configuration Debug

## Build SentryObjC for all platforms with SDK_V10 flag
#
# Convenience target that invokes all V10 platform build targets.
.PHONY: build-objc-v10
build-objc-v10: build-objc-ios-v10 build-objc-macos-v10 build-objc-catalyst-v10 build-objc-tvos-v10 build-objc-visionos-v10 build-objc-watchos-v10

## Build iOS target with SDK_V10 flag
#
# Builds the Sentry SDK for iOS Simulator using the DebugV10 configuration.
.PHONY: build-objc-ios-v10
build-objc-ios-v10:
	@echo "--> Building V10 for iOS"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10

## Build macOS target with SDK_V10 flag
#
# Builds the Sentry SDK for macOS using the DebugV10 configuration.
.PHONY: build-objc-macos-v10
build-objc-macos-v10:
	@echo "--> Building SentryObjC V10 for macOS"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10

## Build Catalyst target with SDK_V10 flag
#
# Builds the Sentry SDK for Mac Catalyst using the DebugV10 configuration.
.PHONY: build-objc-catalyst-v10
build-objc-catalyst-v10:
	@echo "--> Building SentryObjC V10 for Catalyst"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10 \
		--xcconfig Tests/Configuration/SentryV10Catalyst.xcconfig

## Build tvOS target with SDK_V10 flag
#
# Builds the Sentry SDK for tvOS Simulator using the DebugV10 configuration.
.PHONY: build-objc-tvos-v10
build-objc-tvos-v10:
	@echo "--> Building SentryObjC V10 for tvOS"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10

## Build visionOS target with SDK_V10 flag
#
# Builds the Sentry SDK for visionOS Simulator using the DebugV10 configuration.
.PHONY: build-objc-visionos-v10
build-objc-visionos-v10:
	@echo "--> Building SentryObjC V10 for visionOS"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10

## Build watchOS target with SDK_V10 flag
#
# Builds the Sentry SDK for watchOS Simulator using the DebugV10 configuration.
.PHONY: build-objc-watchos-v10
build-objc-watchos-v10:
	@echo "--> Building SentryObjC V10 for watchOS"
	./scripts/sentry-xcodebuild.sh \
		--platform watchOS \
		--os $(WATCHOS_SIMULATOR_OS) \
		--device "$(WATCHOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command build \
		--scheme SentryObjCV10 \
		--configuration DebugV10

## Build XCFramework validation sample
#
# Builds the XCFramework validation sample project to verify XCFramework integration.
.PHONY: build-xcframework-sample
build-xcframework-sample:
	xcodebuild -project "Samples/XCFramework-Validation/XCFramework.xcodeproj" -configuration Release CODE_SIGNING_ALLOWED="NO" build

## Build Sentry-Dynamic XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-dynamic
#   make build-xcframework-dynamic SDKS=iphonesimulator
.PHONY: build-xcframework-dynamic
build-xcframework-dynamic:
	@echo "--> Creating Sentry-Dynamic xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "Sentry" --suffix "-Dynamic" --mach-o-type "mh_dylib" --sdks "$(SDKS)" --excluded-archs "arm64e"
	./scripts/validate-xcframework.sh --xcframework "Sentry-Dynamic.xcframework"
	./scripts/compress-xcframework.sh --xcframework "Sentry-Dynamic.xcframework"

## Build Sentry-Dynamic-WithARM64e XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-dynamic-arm64e
#   make build-xcframework-dynamic-arm64e SDKS=iphonesimulator
.PHONY: build-xcframework-dynamic-arm64e
build-xcframework-dynamic-arm64e:
	@echo "--> Creating Sentry-Dynamic-WithARM64e xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "Sentry" --suffix "-Dynamic-WithARM64e" --mach-o-type "mh_dylib" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "Sentry-Dynamic-WithARM64e.xcframework"
	./scripts/compress-xcframework.sh --xcframework "Sentry-Dynamic-WithARM64e.xcframework"

## Build Sentry (static) XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-static
#   make build-xcframework-static SDKS=iphonesimulator
.PHONY: build-xcframework-static
build-xcframework-static:
	@echo "--> Creating Sentry-Static xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "Sentry" --mach-o-type "staticlib" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "Sentry.xcframework"
	./scripts/compress-xcframework.sh --xcframework "Sentry.xcframework"

## Build SentrySwiftUI XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-swiftui
#   make build-xcframework-swiftui SDKS=iphonesimulator
.PHONY: build-xcframework-swiftui
build-xcframework-swiftui:
	@echo "--> Creating SentrySwiftUI xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "SentrySwiftUI" --mach-o-type "mh_dylib" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "SentrySwiftUI.xcframework"
	./scripts/compress-xcframework.sh --xcframework "SentrySwiftUI.xcframework"

## Build Sentry-WithoutUIKitOrAppKit XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-without-uikit
#   make build-xcframework-without-uikit SDKS=iphonesimulator
.PHONY: build-xcframework-without-uikit
build-xcframework-without-uikit:
	@echo "--> Creating Sentry-WithoutUIKitOrAppKit xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "Sentry" --suffix "-WithoutUIKitOrAppKit" --mach-o-type "mh_dylib" --configuration-suffix "WithoutUIKit" --sdks "$(SDKS)" --excluded-archs "arm64e"
	./scripts/validate-xcframework.sh --xcframework "Sentry-WithoutUIKitOrAppKit.xcframework"
	./scripts/compress-xcframework.sh --xcframework "Sentry-WithoutUIKitOrAppKit.xcframework"

## Build Sentry-WithoutUIKitOrAppKit-WithARM64e XCFramework
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-without-uikit-arm64e
#   make build-xcframework-without-uikit-arm64e SDKS=iphonesimulator
.PHONY: build-xcframework-without-uikit-arm64e
build-xcframework-without-uikit-arm64e:
	@echo "--> Creating Sentry-WithoutUIKitOrAppKit-WithARM64e xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-variant.sh --scheme "Sentry" --suffix "-WithoutUIKitOrAppKit-WithARM64e" --mach-o-type "mh_dylib" --configuration-suffix "WithoutUIKit" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "Sentry-WithoutUIKitOrAppKit-WithARM64e.xcframework"
	./scripts/compress-xcframework.sh --xcframework "Sentry-WithoutUIKitOrAppKit-WithARM64e.xcframework"

## Build SentryObjC-Static XCFramework locally for one or more SDKs
#
# Builds SentryObjC as a static xcframework via SPM archive + libtool.
# Output lands in SentryObjC-Static.xcframework.
#
# SDKS is a comma-separated list of SDK names. Defaults to all SDKS.
#
# Examples:
#   make build-xcframework-sentryobjc-static SDKS=iphonesimulator
#   make build-xcframework-sentryobjc-static SDKS=iphoneos,iphonesimulator
.PHONY: build-xcframework-sentryobjc-static
build-xcframework-sentryobjc-static:
	@echo "--> Creating SentryObjC-Static xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-sentryobjc.sh --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "SentryObjC-Static.xcframework"
	./scripts/compress-xcframework.sh --xcframework "SentryObjC-Static.xcframework"

## Build SentryObjC-Dynamic XCFramework locally for one or more SDKs
#
# Builds SentryObjC as a dynamic xcframework via SPM archive + swiftc relink.
# Output lands in SentryObjC-Dynamic.xcframework.
#
# SDKS is a comma-separated list of SDK names. Defaults to all SDKS.
#
# Examples:
#   make build-xcframework-sentryobjc-dynamic SDKS=iphonesimulator
#   make build-xcframework-sentryobjc-dynamic SDKS=iphoneos,iphonesimulator
.PHONY: build-xcframework-sentryobjc-dynamic
build-xcframework-sentryobjc-dynamic:
	@echo "--> Creating SentryObjC-Dynamic xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-sentryobjc.sh --sdks "$(SDKS)" --variant dynamic
	./scripts/validate-xcframework.sh --xcframework "SentryObjC-Dynamic.xcframework"
	./scripts/compress-xcframework.sh --xcframework "SentryObjC-Dynamic.xcframework"

## Build V10 Dynamic XCFramework
#
# Builds the V10 SDK as a dynamic xcframework. Overrides the arm64e xcconfig
# restriction for tvOS, watchOS, and Mac Catalyst, which exists only to work
# around an Xcode UI bug that does not affect xcodebuild.
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-v10-dynamic
#   make build-xcframework-v10-dynamic SDKS=iphoneos
.PHONY: build-xcframework-v10-dynamic
build-xcframework-v10-dynamic:
	@echo "--> Creating SentryV10-Dynamic xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-v10.sh --suffix "-Dynamic" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "SentryV10-Dynamic.xcframework"
	framework_paths="$$(find "SentryV10-Dynamic.xcframework" -type d -name Sentry.framework -print)"; \
	if [ -z "$$framework_paths" ]; then \
		echo "No Sentry.framework found in SentryV10-Dynamic.xcframework"; \
		exit 1; \
	fi; \
	printf '%s\n' "$$framework_paths" | while IFS= read -r framework_path; do \
		./scripts/verify-v10-sentrycrash-framework.sh --framework-path "$$framework_path" || exit 1; \
	done
	./scripts/compress-xcframework.sh --xcframework "SentryV10-Dynamic.xcframework"

## Build V10 Static XCFramework
#
# Builds the V10 SDK as a static xcframework. Overrides the arm64e xcconfig
# restriction for tvOS, watchOS, and Mac Catalyst, which exists only to work
# around an Xcode UI bug that does not affect xcodebuild.
#
# SDKS is a comma-separated list of SDK names (default: all).
#
# Examples:
#   make build-xcframework-v10-static
#   make build-xcframework-v10-static SDKS=iphoneos
.PHONY: build-xcframework-v10-static
build-xcframework-v10-static:
	@echo "--> Creating SentryV10 Static xcframework (SDKs: $(SDKS))"
	./scripts/build-xcframework-v10.sh --mach-o-type "staticlib" --sdks "$(SDKS)"
	./scripts/validate-xcframework.sh --xcframework "SentryV10.xcframework"
	framework_paths="$$(find "SentryV10.xcframework" -type d -name Sentry.framework -print)"; \
	if [ -z "$$framework_paths" ]; then \
		echo "No Sentry.framework found in SentryV10.xcframework"; \
		exit 1; \
	fi; \
	printf '%s\n' "$$framework_paths" | while IFS= read -r framework_path; do \
		./scripts/verify-v10-sentrycrash-framework.sh --framework-path "$$framework_path" || exit 1; \
	done
	./scripts/compress-xcframework.sh --xcframework "SentryV10.xcframework"

# ============================================================================
# SAMPLE APPS
# ============================================================================

## Build all sample apps
#
# Builds all sample apps for every supported platform.
.PHONY: build-samples
build-samples: \
	build-sample-DistributionSample \
	build-sample-iOS-ObjectiveC \
	build-sample-iOS-ObjectiveC-Dynamic \
	build-sample-iOS-ObjectiveC-Static \
	build-sample-iOS-ObjectiveCpp-NoModules \
	build-sample-iOS-Swift \
	build-sample-iOS-Swift6 \
	build-sample-iOS-SwiftUI \
	build-sample-iOS-SwiftUI-SPM \
	build-sample-iOS-SwiftUI-Widgets \
	build-sample-iOS15-SwiftUI \
	build-sample-macOS-CLI-Xcode \
	build-sample-macOS-Swift \
	build-sample-macOS-SwiftUI \
	build-sample-macOS-SwiftUI-SPM \
	build-sample-SDK-Size \
	build-sample-SessionReplay-CameraTest \
	build-sample-SPM \
	build-sample-tvOS-Swift \
	build-sample-tvOS-SwiftUI-SPM \
	build-sample-visionOS-Swift \
	build-sample-visionOS-SwiftUI-SPM \
	build-sample-watchOS-Swift \
	build-sample-watchOS-SwiftUI-SPM

## Build the iOS-SwiftUI-SPM sample app
#
# Builds the iOS SentrySPM sample app for the iOS Simulator.
.PHONY: build-sample-iOS-SwiftUI-SPM
build-sample-iOS-SwiftUI-SPM:
	xcodegen --spec Samples/iOS-SwiftUI-SPM/iOS-SwiftUI-SPM.yml
	set -o pipefail && xcodebuild \
		-project "Samples/iOS-SwiftUI-SPM/iOS-SwiftUI-SPM.xcodeproj" \
		-scheme iOS-SwiftUI-SPM \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the watchOS-SwiftUI-SPM sample app
#
# Builds the watchOS SentrySPM sample app for the watchOS Simulator.
.PHONY: build-sample-watchOS-SwiftUI-SPM
build-sample-watchOS-SwiftUI-SPM:
	xcodegen --spec Samples/iOS-SwiftUI-SPM/iOS-SwiftUI-SPM.yml
	set -o pipefail && xcodebuild \
		-project "Samples/iOS-SwiftUI-SPM/iOS-SwiftUI-SPM.xcodeproj" \
		-scheme watchOS-SwiftUI-SPM \
		-destination 'platform=watchOS Simulator,OS=$(WATCHOS_SIMULATOR_OS),name=$(WATCHOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the tvOS-SwiftUI-SPM sample app
#
# Builds the tvOS SentrySPM sample app for the tvOS Simulator.
.PHONY: build-sample-tvOS-SwiftUI-SPM
build-sample-tvOS-SwiftUI-SPM:
	xcodegen --spec Samples/tvOS-SwiftUI-SPM/tvOS-SwiftUI-SPM.yml
	set -o pipefail && xcodebuild \
		-project "Samples/tvOS-SwiftUI-SPM/tvOS-SwiftUI-SPM.xcodeproj" \
		-scheme tvOS-SwiftUI-SPM \
		-destination 'platform=tvOS Simulator,OS=$(TVOS_SIMULATOR_OS),name=$(TVOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the macOS-SwiftUI-SPM sample app
#
# Builds the macOS SentrySPM sample app.
.PHONY: build-sample-macOS-SwiftUI-SPM
build-sample-macOS-SwiftUI-SPM:
	xcodegen --spec Samples/macOS-SwiftUI-SPM/macOS-SwiftUI-SPM.yml
	set -o pipefail && xcodebuild \
		-project "Samples/macOS-SwiftUI-SPM/macOS-SwiftUI-SPM.xcodeproj" \
		-scheme macOS-SwiftUI-SPM \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the macOS-CLI-Xcode sample (command-line tool, SentrySPM with NoUIFramework)
#
# Builds the macOS CLI sample that uses SentrySPM without UIKit/AppKit linkage.
.PHONY: build-sample-macOS-CLI-Xcode
build-sample-macOS-CLI-Xcode:
	xcodegen --spec Samples/macOS-CLI-Xcode/macOS-CLI-Xcode.yml
	set -o pipefail && xcodebuild \
		-project "Samples/macOS-CLI-Xcode/macOS-CLI-Xcode.xcodeproj" \
		-scheme macOS-CLI-Xcode \
		-configuration Debug \
		-destination 'platform=macOS' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the visionOS-SwiftUI-SPM sample app
#
# Builds the visionOS SentrySPM sample app for the visionOS Simulator.
.PHONY: build-sample-visionOS-SwiftUI-SPM
build-sample-visionOS-SwiftUI-SPM:
	xcodegen --spec Samples/visionOS-SwiftUI-SPM/visionOS-SwiftUI-SPM.yml
	set -o pipefail && xcodebuild \
		-project "Samples/visionOS-SwiftUI-SPM/visionOS-SwiftUI-SPM.xcodeproj" \
		-scheme visionOS-SwiftUI-SPM \
		-destination 'platform=visionOS Simulator,OS=$(VISIONOS_SIMULATOR_OS),name=$(VISIONOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-ObjectiveCpp-NoModules sample app
#
# Builds the ObjC++ without-modules sample that uses SentryObjC (#6342).
# Uses #import <SentryObjC/SentryObjC.h> for ObjC++ without -fmodules.
.PHONY: build-sample-iOS-ObjectiveCpp-NoModules
build-sample-iOS-ObjectiveCpp-NoModules:
	xcodegen --spec Samples/iOS-ObjectiveCpp-NoModules/iOS-ObjectiveCpp-NoModules.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-ObjectiveCpp-NoModules \
		-configuration Debug \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-Swift sample app
#
# Builds the iOS-Swift sample app for the iOS Simulator.
.PHONY: build-sample-iOS-Swift
build-sample-iOS-Swift:
	xcodegen --spec Samples/iOS-Swift/iOS-Swift.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-Swift \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-Swift6 sample app
#
# Builds the iOS-Swift6 sample app for the iOS Simulator.
.PHONY: build-sample-iOS-Swift6
build-sample-iOS-Swift6:
	xcodegen --spec Samples/iOS-Swift6/iOS-Swift6.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-Swift6 \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-SwiftUI sample app
#
# Builds the iOS-SwiftUI sample app for the iOS Simulator.
.PHONY: build-sample-iOS-SwiftUI
build-sample-iOS-SwiftUI:
	xcodegen --spec Samples/iOS-SwiftUI/iOS-SwiftUI.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-SwiftUI \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-SwiftUI-Widgets sample app
#
# Builds the iOS-SwiftUI-Widgets sample app for the iOS Simulator.
.PHONY: build-sample-iOS-SwiftUI-Widgets
build-sample-iOS-SwiftUI-Widgets:
	xcodegen --spec Samples/iOS-SwiftUI-Widgets/iOS-SwiftUI-Widgets.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-SwiftUI-Widgets \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-ObjectiveC sample app
#
# Builds the iOS-ObjectiveC sample app for the iOS Simulator.
.PHONY: build-sample-iOS-ObjectiveC
build-sample-iOS-ObjectiveC:
	xcodegen --spec Samples/iOS-ObjectiveC/iOS-ObjectiveC.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS-ObjectiveC \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-ObjectiveC-Dynamic sample app
#
# Builds the iOS-ObjectiveC-Dynamic sample app for the iOS Simulator.
# This sample uses the pre-built SentryObjC-Dynamic xcframework via SPM.
.PHONY: build-sample-iOS-ObjectiveC-Dynamic
build-sample-iOS-ObjectiveC-Dynamic:
	xcodegen --spec Samples/iOS-ObjectiveC-Dynamic/iOS-ObjectiveC-Dynamic.yml
	set -o pipefail && xcodebuild \
		-project "Samples/iOS-ObjectiveC-Dynamic/iOS-ObjectiveC-Dynamic.xcodeproj" \
		-scheme iOS-ObjectiveC-Dynamic \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS-ObjectiveC-Static sample app
#
# Builds the iOS-ObjectiveC-Static sample app for the iOS Simulator.
# This sample uses the pre-built SentryObjC-Static xcframework via SPM.
.PHONY: build-sample-iOS-ObjectiveC-Static
build-sample-iOS-ObjectiveC-Static:
	xcodegen --spec Samples/iOS-ObjectiveC-Static/iOS-ObjectiveC-Static.yml
	set -o pipefail && xcodebuild \
		-project "Samples/iOS-ObjectiveC-Static/iOS-ObjectiveC-Static.xcodeproj" \
		-scheme iOS-ObjectiveC-Static \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the iOS15-SwiftUI sample app
#
# Builds the iOS15-SwiftUI sample app for the iOS Simulator.
.PHONY: build-sample-iOS15-SwiftUI
build-sample-iOS15-SwiftUI:
	xcodegen --spec Samples/iOS15-SwiftUI/iOS15-SwiftUI.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme iOS15-SwiftUI \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the SessionReplay-CameraTest sample app
#
# Builds the SessionReplay-CameraTest sample app for the iOS Simulator.
.PHONY: build-sample-SessionReplay-CameraTest
build-sample-SessionReplay-CameraTest:
	xcodegen --spec Samples/SessionReplay-CameraTest/SessionReplay-CameraTest.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme SessionReplay-CameraTest \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the macOS-Swift sample app
#
# Builds the macOS-Swift sample app.
.PHONY: build-sample-macOS-Swift
build-sample-macOS-Swift:
	xcodegen --spec Samples/macOS-Swift/macOS-Swift.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme macOS-Swift \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the macOS-SwiftUI sample app
#
# Builds the macOS-SwiftUI sample app.
.PHONY: build-sample-macOS-SwiftUI
build-sample-macOS-SwiftUI:
	xcodegen --spec Samples/macOS-SwiftUI/macOS-SwiftUI.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme macOS-SwiftUI \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the tvOS-Swift sample app
#
# Builds the tvOS-Swift sample app for the tvOS Simulator.
.PHONY: build-sample-tvOS-Swift
build-sample-tvOS-Swift:
	xcodegen --spec Samples/tvOS-Swift/tvOS-Swift.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme tvOS-Swift \
		-destination 'platform=tvOS Simulator,OS=$(TVOS_SIMULATOR_OS),name=$(TVOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the visionOS-Swift sample app
#
# Builds the visionOS-Swift sample app for the visionOS Simulator.
.PHONY: build-sample-visionOS-Swift
build-sample-visionOS-Swift:
	xcodegen --spec Samples/visionOS-Swift/visionOS-Swift.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme visionOS-Swift \
		-destination 'platform=visionOS Simulator,OS=$(VISIONOS_SIMULATOR_OS),name=$(VISIONOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the watchOS-Swift sample app
#
# Builds the watchOS-Swift sample app for the watchOS Simulator.
.PHONY: build-sample-watchOS-Swift
build-sample-watchOS-Swift:
	xcodegen --spec Samples/watchOS-Swift/watchOS-Swift.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme 'watchOS-Swift WatchKit App' \
		-destination 'platform=watchOS Simulator,OS=$(WATCHOS_SIMULATOR_OS),name=$(WATCHOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the SPM sample app
#
# Builds the SPM sample app.
.PHONY: build-sample-SPM
build-sample-SPM:
	xcodegen --spec Samples/SPM/SPM.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme SPM \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the DistributionSample app
#
# Builds the DistributionSample app.
.PHONY: build-sample-DistributionSample
build-sample-DistributionSample:
	xcodegen --spec Samples/DistributionSample/DistributionSample.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme DistributionSample \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

## Build the SDK-Size sample app
#
# Builds the SDK-Size sample app for the iOS Simulator.
.PHONY: build-sample-SDK-Size
build-sample-SDK-Size:
	xcodegen --spec Samples/SDK-Size/SDK-Size.yml
	set -o pipefail && xcodebuild \
		-workspace Sentry.xcworkspace \
		-scheme SDK-Size \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" build | xcbeautify --preserve-unbeautified

# ============================================================================
# TESTING
# ============================================================================

## Run all platform tests
#
# Convenience target that invokes all platform test targets.
# See test-ios, test-macos, test-catalyst, test-tvos, test-visionos, test-watchos for more details.
.PHONY: test
test: test-ios test-macos test-catalyst test-tvos test-visionos test-watchos

## Run iOS tests
#
# Runs unit tests for iOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-ios
#   make test-ios ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-ios ONLY_TESTING=SentryTests/SentryHttpTransportTests,SentryTests/SentryHubTests
#   make test-ios ONLY_TESTING=SentryTests/SentryHttpTransportTests/testFlush_WhenNoInternet
#   make test-ios TEST_SCHEME=SentryObjCTests
#   make test-ios TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-ios
test-ios:
	@echo "--> Running iOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run macOS tests
#
# Runs unit tests for macOS.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-macos
#   make test-macos ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-macos TEST_SCHEME=SentryObjCTests
#   make test-macos TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-macos
test-macos:
	@echo "--> Running macOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run Catalyst tests
#
# Runs unit tests for Mac Catalyst.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-catalyst
#   make test-catalyst ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-catalyst TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-catalyst
test-catalyst:
	@echo "--> Running Catalyst tests"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run tvOS tests
#
# Runs unit tests for tvOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-tvos
#   make test-tvos ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-tvos TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-tvos
test-tvos:
	@echo "--> Running tvOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run visionOS tests
#
# Runs unit tests for visionOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-visionos
#   make test-visionos ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-visionos TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-visionos
test-visionos:
	@echo "--> Running visionOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run watchOS tests
#
# Runs unit tests for watchOS Simulator.
# Outputs logs and uses xcbeautify for formatted output.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Optional: TEST_SCHEME=SchemeName to override the default Xcode scheme (default: Sentry)
# Examples:
#   make test-watchos
#   make test-watchos ONLY_TESTING=SentryTests/SentryHttpTransportTests
#   make test-watchos TEST_PLAN=Sentry_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-watchos
test-watchos:
	@echo "--> Running watchOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform watchOS \
		--os $(WATCHOS_SIMULATOR_OS) \
		--device "$(WATCHOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--configuration Test \
		$(if $(TEST_SCHEME),--scheme "$(TEST_SCHEME)") \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run all platform tests with SDK_V10 flag
#
# Convenience target that invokes all V10 platform test targets.
.PHONY: test-v10
test-v10: test-ios-v10 test-macos-v10 test-catalyst-v10 test-tvos-v10 test-visionos-v10 test-watchos-v10

## Run iOS tests with SDK_V10 flag
#
# Runs unit tests for iOS Simulator using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-ios-v10
#   make test-ios-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-ios-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-ios-v10
test-ios-v10:
	@echo "--> Running V10 iOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform iOS \
		--os $(IOS_SIMULATOR_OS) \
		--device "$(IOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run macOS tests with SDK_V10 flag
#
# Runs unit tests for macOS using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-macos-v10
#   make test-macos-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-macos-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-macos-v10
test-macos-v10:
	@echo "--> Running V10 macOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform macOS \
		--os latest \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run Catalyst tests with SDK_V10 flag
#
# Runs unit tests for Mac Catalyst using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-catalyst-v10
#   make test-catalyst-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-catalyst-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-catalyst-v10
test-catalyst-v10:
	@echo "--> Running V10 Catalyst tests"
	./scripts/sentry-xcodebuild.sh \
		--platform Catalyst \
		--os latest \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		--xcconfig Tests/Configuration/SentryV10Catalyst.xcconfig \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run tvOS tests with SDK_V10 flag
#
# Runs unit tests for tvOS Simulator using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-tvos-v10
#   make test-tvos-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-tvos-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-tvos-v10
test-tvos-v10:
	@echo "--> Running V10 tvOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform tvOS \
		--os $(TVOS_SIMULATOR_OS) \
		--device "$(TVOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run visionOS tests with SDK_V10 flag
#
# Runs unit tests for visionOS Simulator using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-visionos-v10
#   make test-visionos-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-visionos-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-visionos-v10
test-visionos-v10:
	@echo "--> Running V10 visionOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform visionOS \
		--os $(VISIONOS_SIMULATOR_OS) \
		--device "$(VISIONOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run watchOS tests with SDK_V10 flag
#
# Runs unit tests for watchOS Simulator using the SentryV10 scheme.
#
# Optional: ONLY_TESTING=Target/ClassName to run specific test class(es)
# Examples:
#   make test-watchos-v10
#   make test-watchos-v10 ONLY_TESTING=SentryTestsV10/SentryHttpTransportTests
#   make test-watchos-v10 TEST_PLAN=SentryV10_TestServer   # needs `make -C test-server start-debug`
.PHONY: test-watchos-v10
test-watchos-v10:
	@echo "--> Running V10 watchOS tests"
	./scripts/sentry-xcodebuild.sh \
		--platform watchOS \
		--os $(WATCHOS_SIMULATOR_OS) \
		--device "$(WATCHOS_DEVICE_NAME)" \
		--ref $(GIT-REF) \
		--command test \
		--scheme SentryV10 \
		--configuration TestV10 \
		$(if $(TEST_PLAN),--test-plan "$(TEST_PLAN)") \
		--only-testing "$(ONLY_TESTING)"

## Run critical UI tests
#
# Runs important UI test suites for validation.
.PHONY: test-ui-critical
test-ui-critical:
	./scripts/test-ui-critical.sh

## Run all sample UI tests
#
# Runs UI tests for all sample apps with UI test suites.
.PHONY: test-samples-ui
test-samples-ui: \
	test-sample-iOS-Swift-ui \
	test-sample-iOS-SwiftUI-ui \
	test-sample-iOS-Swift6-ui \
	test-sample-iOS-ObjectiveC-ui \
	test-sample-macOS-Swift-ui \
	test-sample-tvOS-Swift-ui

## Run iOS-Swift sample UI tests
#
# Generates the iOS-Swift project and runs its UI tests.
.PHONY: test-sample-iOS-Swift-ui
test-sample-iOS-Swift-ui: xcode-ci-iOS-Swift
	@echo "--> Running iOS-Swift UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme iOS-Swift \
		-testPlan iOS-Swift_Base \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" \
		'ARCHS=$$(ARCHS_STANDARD)' 2>&1 | xcbeautify --preserve-unbeautified

## Run iOS-SwiftUI sample UI tests
#
# Generates the iOS-SwiftUI project and runs its UI tests.
.PHONY: test-sample-iOS-SwiftUI-ui
test-sample-iOS-SwiftUI-ui: xcode-ci-iOS-SwiftUI
	@echo "--> Running iOS-SwiftUI UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme iOS-SwiftUI \
		-testPlan iOS-SwiftUI_Base \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" \
		'ARCHS=$$(ARCHS_STANDARD)' 2>&1 | xcbeautify --preserve-unbeautified

## Run iOS-Swift6 sample UI tests
#
# Generates the iOS-Swift6 project and runs its UI tests.
.PHONY: test-sample-iOS-Swift6-ui
test-sample-iOS-Swift6-ui: xcode-ci-iOS-Swift6
	@echo "--> Running iOS-Swift6 UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme iOS-Swift6 \
		-testPlan iOS-Swift6_Base \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" \
		'ARCHS=$$(ARCHS_STANDARD)' 2>&1 | xcbeautify --preserve-unbeautified

## Run iOS-ObjectiveC sample UI tests
#
# Generates the iOS-ObjectiveC project and runs its UI tests.
.PHONY: test-sample-iOS-ObjectiveC-ui
test-sample-iOS-ObjectiveC-ui: xcode-ci-iOS-ObjectiveC
	@echo "--> Running iOS-ObjectiveC UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme iOS-ObjectiveC \
		-testPlan iOS-ObjectiveC_Base \
		-destination 'platform=iOS Simulator,OS=$(IOS_SIMULATOR_OS),name=$(IOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" \
		'ARCHS=$$(ARCHS_STANDARD)' 2>&1 | xcbeautify --preserve-unbeautified

## Run macOS-Swift sample UI tests
#
# Generates the macOS-Swift project and runs its UI tests.
#
# Unlike the simulator based UI tests, these run natively on the host, where AMFI
# kills any bundle whose signature doesn't match its contents. Skipping code signing
# leaves the XCTest runner with the stale seal it ships with, so macOS refuses to
# launch it ("... is damaged and can't be opened"). The "-" identity selects ad-hoc
# signing, which keeps the bundles valid without requiring a certificate on CI.
.PHONY: test-sample-macOS-Swift-ui
test-sample-macOS-Swift-ui: xcode-ci-macOS-Swift
	@echo "--> Running macOS-Swift UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme macOS-Swift \
		-testPlan macOS-Swift_Base \
		CODE_SIGNING_ALLOWED="YES" \
		CODE_SIGNING_REQUIRED="YES" \
		CODE_SIGN_STYLE="Manual" \
		CODE_SIGN_IDENTITY="-" \
		DEVELOPMENT_TEAM="" 2>&1 | xcbeautify --preserve-unbeautified

## Run tvOS-Swift sample UI tests
#
# Generates the tvOS-Swift project and runs its UI tests.
.PHONY: test-sample-tvOS-Swift-ui
test-sample-tvOS-Swift-ui: xcode-ci-tvOS-Swift
	@echo "--> Running tvOS-Swift UI tests"
	set -o pipefail && xcodebuild test \
		-workspace Sentry.xcworkspace \
		-scheme tvOS-Swift \
		-testPlan tvOS-Swift_Base \
		-destination 'platform=tvOS Simulator,OS=$(TVOS_SIMULATOR_OS),name=$(TVOS_DEVICE_NAME)' \
		CODE_SIGNING_ALLOWED="NO" 2>&1 | xcbeautify --preserve-unbeautified

# ============================================================================
# LINTING & FORMATTING
# ============================================================================

# Get staged Swift files
STAGED_SWIFT_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep '\.swift$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged Markdown, JSON, and YAML files
STAGED_DPRINT_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep -E '\.(md|json|ya?ml)$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged Markdown files
STAGED_MARKDOWN_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep '\.md$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged changelog files
STAGED_CHANGELOG_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep -E '^CHANGELOG(_V10)?\.md$$')

# Get staged JSON files
STAGED_JSON_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep '\.json$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged YAML files
STAGED_YAML_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep -E '\.ya?ml$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged Objective-C, Objective-C++, C, and C++ files
STAGED_CLANG_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep -E '\.(h|hpp|c|cpp|m|mm)$$' | awk '{printf "\"%s\" ", $$0}')

# Get staged Objective-C header files
STAGED_OBJC_HEADER_FILES := $(shell git diff --cached --diff-filter=d --name-only | grep '\.h$$' | awk '{printf "\"%s\" ", $$0}')

# Message for the allHeaderFields banned-pattern lint, aligned with the SwiftLint
# rule in PR #8387 (rule id avoid_all_header_fields).
AVOID_ALL_HEADER_FIELDS_MSG := Double-check how you use allHeaderFields / allHTTPHeaderFields (https://developer.apple.com/documentation/foundation/httpurlresponse/allheaderfields). Reading all headers is fine, but their subscript is case-sensitive while HTTP/2 and HTTP/3 lowercase field names, so a single-header lookup can silently miss the header (see \#8322). For a lookup, use value(forHTTPHeaderField:) or the HTTPURLResponse.value(forHTTPHeaderFieldCaseInsensitive:) extension in HTTPURLResponse+Sentry.swift. If your usage is intentional, suppress this rule with a comment explaining why.

## Check Objective-C header files for bare 'id' usage without SENTRY_SWIFT_MIGRATION_ID
#
# Standalone target so CI can run this check without a macOS runner.
.PHONY: check-objc-id-usage
check-objc-id-usage:
	ruby ./scripts/check-objc-id-usage.rb -r Sources/Sentry

## Check Objective-C sources for banned patterns (e.g. case-sensitive header lookups)
#
# Standalone target so CI can run this check without a macOS runner.
.PHONY: check-objc-banned-patterns
check-objc-banned-patterns:
	./scripts/check-objc-banned-pattern.sh --path Sources \
		--rule avoid_all_header_fields --pattern 'all(HTTP)?HeaderFields' \
		--message "$(AVOID_ALL_HEADER_FIELDS_MSG)"

## Run linting checks on all files
#
# Runs SwiftLint, Clang-Format checks, Objective-C id usage checks, Objective-C banned-pattern checks, changelog checks, actionlint, and dprint checks without modifying files.
.PHONY: lint
lint:
	@echo "--> Running Swiftlint and Clang-Format"
	./scripts/check-clang-format.py -r Sources Tests
	"$(MAKE)" check-objc-id-usage
	"$(MAKE)" check-objc-banned-patterns
	swiftlint --strict --quiet
	dprint check "**/*.{md,json,yaml,yml}"
	"$(MAKE)" check-changelog
	actionlint

## Run linting checks on staged files only
#
# Runs SwiftLint, Clang-Format checks, Objective-C id usage checks, Objective-C banned-pattern checks, changelog checks, and dprint checks on staged files only.
.PHONY: lint-staged
lint-staged:
	@echo "--> Running Swiftlint, dprint, and Clang-Format on staged files"
	@if [ -n "$(STAGED_CLANG_FILES)" ]; then \
		./scripts/check-clang-format.py $(STAGED_CLANG_FILES); \
	fi
	@if [ -n "$(STAGED_OBJC_HEADER_FILES)" ]; then \
		ruby ./scripts/check-objc-id-usage.rb $(STAGED_OBJC_HEADER_FILES); \
	fi
	@if [ -n "$(STAGED_CLANG_FILES)" ]; then \
		for f in $(STAGED_CLANG_FILES); do \
			./scripts/check-objc-banned-pattern.sh --path "$$f" \
				--rule avoid_all_header_fields --pattern 'all(HTTP)?HeaderFields' \
				--message "$(AVOID_ALL_HEADER_FIELDS_MSG)" || exit 1; \
		done; \
	fi
	@if [ -n "$(STAGED_SWIFT_FILES)" ]; then \
		swiftlint --strict --quiet $(STAGED_SWIFT_FILES); \
	fi
	@if [ -n "$(STAGED_DPRINT_FILES)" ]; then \
		dprint check --allow-no-files $(STAGED_DPRINT_FILES); \
	fi
	@if [ -n "$(STAGED_CHANGELOG_FILES)" ]; then \
		"$(MAKE)" check-changelog; \
	fi

## Format all files
#
# Runs all formatting tasks for Swift, Objective-C, Markdown, JSON, and YAML files.
.PHONY: format
# @$(MAKE) -j runs the sub-targets in parallel (they are independent), which speeds
# things up (~40% faster in some quick tests, though the exact gain depends on the machine).
format:
	@$(MAKE) -j format-clang format-swift-all format-markdown format-json format-yaml

## Format Objective-C, C, and C++ files
#
# Formats all Objective-C, Objective-C++, C, and C++ files using clang-format.
.PHONY: format-clang
# Runs clang-format in parallel. -n 32 batches the files (32 per invocation) and
# -P runs the batches concurrently. With more than 32 files xargs just runs more
# batches until all are processed - nothing is dropped; without -n, all files go
# to a single process and -P has nothing to parallelize.
# getconf _NPROCESSORS_ONLN is the CPU core count (macOS + Linux); 8 is a fallback.
format-clang:
	@find . -type f \( -name "*.h" -or -name "*.hpp" -or -name "*.c" -or -name "*.cpp" -or -name "*.m" -or -name "*.mm" \) -and \
		! \( -path "**.build/*" -or -path "**Build/*"  -or -path "**/libs/**" -or -path "**/Pods/**" -or -path "**/*.xcarchive/*" \) \
		-print0 | xargs -0 -P $(shell getconf _NPROCESSORS_ONLN 2>/dev/null || echo 8) -n 32 clang-format -i -style=file

## Format staged Objective-C, C, and C++ files
#
# Formats only staged Objective-C, Objective-C++, C, and C++ files using clang-format.
.PHONY: format-clang-staged
format-clang-staged:
	@if [ -n "$(STAGED_CLANG_FILES)" ]; then \
		clang-format -i -style=file $(STAGED_CLANG_FILES); \
	fi

## Format all Swift files
#
# Formats all Swift files using SwiftLint auto-fix.
.PHONY: format-swift-all
format-swift-all:
	@echo "Running swiftlint --fix on all files"
	swiftlint --fix --quiet

## Format staged Swift files
#
# Formats only staged Swift files using SwiftLint auto-fix.
.PHONY: format-swift-staged
format-swift-staged:
	@echo "Running swiftlint --fix on staged files"
	swiftlint --fix --quiet $(STAGED_SWIFT_FILES)

## Format Markdown files
#
# Formats all Markdown files using dprint.
.PHONY: format-markdown
format-markdown:
	dprint fmt "**/*.md"

## Format staged Markdown files
#
# Formats only staged Markdown files using dprint.
.PHONY: format-markdown-staged
format-markdown-staged:
	@if [ -n "$(STAGED_MARKDOWN_FILES)" ]; then \
		dprint fmt --allow-no-files $(STAGED_MARKDOWN_FILES); \
	fi

## Format JSON files
#
# Formats all JSON files using dprint.
.PHONY: format-json
format-json:
	dprint fmt "**/*.json"

## Format staged JSON files
#
# Formats only staged JSON files using dprint.
.PHONY: format-json-staged
format-json-staged:
	@if [ -n "$(STAGED_JSON_FILES)" ]; then \
		dprint fmt --allow-no-files $(STAGED_JSON_FILES); \
	fi

## Format YAML files
#
# Formats all YAML and YML files using dprint.
.PHONY: format-yaml
format-yaml:
	dprint fmt --allow-no-files "**/*.{yaml,yml}"

## Format staged YAML files
#
# Formats only staged YAML and YML files using dprint.
.PHONY: format-yaml-staged
format-yaml-staged:
	@if [ -n "$(STAGED_YAML_FILES)" ]; then \
		dprint fmt --allow-no-files $(STAGED_YAML_FILES); \
	fi

# ============================================================================
# ANALYSIS
# ============================================================================

## Analyze repository language trends
#
# Uses github-linguist to compute the language breakdown at monthly intervals.
# Produces an interactive HTML chart (language-trends.html) and opens it in the browser.
# The linguist gem is managed via Bundler in scripts/analyze-languages/.
# Optionally pass SINCE=YYYY-MM-DD to set the start date (default: 2019-01-01).
.PHONY: analyze-languages
analyze-languages:
	./scripts/analyze-languages/analyze-languages.sh $(if $(SINCE),--since $(SINCE))

## Run static analysis
#
# Runs Xcode's static analyzer and reports any issues found.
# Outputs HTML reports to the analyzer directory.
.PHONY: analyze
analyze:
	rm -rf analyzer
	set -o pipefail && NSUnbufferedIO=YES xcodebuild analyze \
		-workspace Sentry.xcworkspace \
		-scheme Sentry \
		-configuration Release \
		CLANG_ANALYZER_OUTPUT=html \
		CLANG_ANALYZER_OUTPUT_DIR=analyzer \
		CODE_SIGNING_ALLOWED="NO" 2>&1 | xcbeautify --preserve-unbeautified
	@if [[ -n `find analyzer -name "*.html"` ]]; then \
		echo "Analyzer found issues:"; \
		find analyzer -name "*.html"; \
		exit 1; \
	fi

# ============================================================================
# CODE GENERATION
# ============================================================================

## Generate public API documentation
#
# Updates the public API documentation from source code.
.PHONY: generate-public-api
generate-public-api:
	./scripts/update-api.sh

# ============================================================================
# VERSION MANAGEMENT
# ============================================================================

## Remove expectedSignature attributes from XCFramework project
#
# Removes expectedSignature attributes from XCFramework project for CI builds.
# These attributes are developer-specific and cause issues in CI environments.
.PHONY: strip-xcframework-expected-signature
strip-xcframework-expected-signature:
	sed -i '' 's/expectedSignature = "[^"]*"; //g' Samples/XCFramework-Validation/XCFramework.xcodeproj/project.pbxproj


# ============================================================================
# VALIDATION
# ============================================================================

## Validate XCFramework symbol consistency across architectures
#
# Checks that exported ObjC class symbols are identical across all architectures
# within each fat binary. Catches resilient value type drift that causes
# x86_64-specific linker failures.
#
# Usage:
#   make validate-xcframework-symbols XCFRAMEWORK=SentryObjC-Dynamic.xcframework
.PHONY: validate-xcframework-symbols
validate-xcframework-symbols:
	@echo "--> Validating XCFramework symbol consistency"
	./scripts/validate-xcframework-symbols.sh --xcframework "$(XCFRAMEWORK)"

# ============================================================================
# XCODE PROJECT GENERATION
# ============================================================================

## Generate Xcode projects and open workspace
#
# Generates all sample Xcode projects and opens the workspace in Xcode.
.PHONY: xcode
xcode: xcode-ci
	open Sentry.xcworkspace

## Generate all sample Xcode projects
#
# Generates Xcode projects for all sample apps using xcodegen.
# Run a specific sample with make xcode-ci-<name>, e.g. make xcode-ci-iOS-Swift.
.PHONY: xcode-ci
xcode-ci: xcode-ci-SPM \
	xcode-ci-SessionReplay-CameraTest \
	xcode-ci-iOS-ObjectiveC \
	xcode-ci-iOS-ObjectiveC-Dynamic \
	xcode-ci-iOS-ObjectiveC-Static \
	xcode-ci-iOS-ObjectiveCpp-NoModules \
	xcode-ci-iOS-Swift \
	xcode-ci-iOS-Swift6 \
	xcode-ci-iOS-SwiftUI \
	xcode-ci-iOS-SwiftUI-SPM \
	xcode-ci-iOS-SwiftUI-Widgets \
	xcode-ci-iOS15-SwiftUI \
	xcode-ci-macOS-CLI-Xcode \
	xcode-ci-macOS-Swift \
	xcode-ci-macOS-SwiftUI \
	xcode-ci-macOS-SwiftUI-SPM \
	xcode-ci-tvOS-Swift \
	xcode-ci-tvOS-SwiftUI-SPM \
	xcode-ci-visionOS-Swift \
	xcode-ci-visionOS-SwiftUI-SPM \
	xcode-ci-watchOS-Swift \
	xcode-ci-DistributionSample \
	xcode-ci-SDK-Size \
	xcode-ci-SwiftUITestSample \
	xcode-ci-SwiftUICrashTest

.PHONY: xcode-ci-SPM
xcode-ci-SPM:
	xcodegen --spec Samples/SPM/SPM.yml

.PHONY: xcode-ci-SessionReplay-CameraTest
xcode-ci-SessionReplay-CameraTest:
	xcodegen --spec Samples/SessionReplay-CameraTest/SessionReplay-CameraTest.yml

.PHONY: xcode-ci-iOS-ObjectiveC
xcode-ci-iOS-ObjectiveC:
	xcodegen --spec Samples/iOS-ObjectiveC/iOS-ObjectiveC.yml

.PHONY: xcode-ci-iOS-ObjectiveC-Dynamic
xcode-ci-iOS-ObjectiveC-Dynamic:
	xcodegen --spec Samples/iOS-ObjectiveC-Dynamic/iOS-ObjectiveC-Dynamic.yml

.PHONY: xcode-ci-iOS-ObjectiveC-Static
xcode-ci-iOS-ObjectiveC-Static:
	xcodegen --spec Samples/iOS-ObjectiveC-Static/iOS-ObjectiveC-Static.yml

.PHONY: xcode-ci-iOS-ObjectiveCpp-NoModules
xcode-ci-iOS-ObjectiveCpp-NoModules:
	xcodegen --spec Samples/iOS-ObjectiveCpp-NoModules/iOS-ObjectiveCpp-NoModules.yml

.PHONY: xcode-ci-iOS-Swift
xcode-ci-iOS-Swift:
	xcodegen --spec Samples/iOS-Swift/iOS-Swift.yml

.PHONY: xcode-ci-iOS-Swift6
xcode-ci-iOS-Swift6:
	xcodegen --spec Samples/iOS-Swift6/iOS-Swift6.yml

.PHONY: xcode-ci-iOS-SwiftUI
xcode-ci-iOS-SwiftUI:
	xcodegen --spec Samples/iOS-SwiftUI/iOS-SwiftUI.yml

.PHONY: xcode-ci-iOS-SwiftUI-SPM
xcode-ci-iOS-SwiftUI-SPM:
	xcodegen --spec Samples/iOS-SwiftUI-SPM/iOS-SwiftUI-SPM.yml

.PHONY: xcode-ci-iOS-SwiftUI-Widgets
xcode-ci-iOS-SwiftUI-Widgets:
	xcodegen --spec Samples/iOS-SwiftUI-Widgets/iOS-SwiftUI-Widgets.yml

.PHONY: xcode-ci-iOS15-SwiftUI
xcode-ci-iOS15-SwiftUI:
	xcodegen --spec Samples/iOS15-SwiftUI/iOS15-SwiftUI.yml

.PHONY: xcode-ci-macOS-CLI-Xcode
xcode-ci-macOS-CLI-Xcode:
	xcodegen --spec Samples/macOS-CLI-Xcode/macOS-CLI-Xcode.yml

.PHONY: xcode-ci-macOS-Swift
xcode-ci-macOS-Swift:
	xcodegen --spec Samples/macOS-Swift/macOS-Swift.yml

.PHONY: xcode-ci-macOS-SwiftUI
xcode-ci-macOS-SwiftUI:
	xcodegen --spec Samples/macOS-SwiftUI/macOS-SwiftUI.yml

.PHONY: xcode-ci-macOS-SwiftUI-SPM
xcode-ci-macOS-SwiftUI-SPM:
	xcodegen --spec Samples/macOS-SwiftUI-SPM/macOS-SwiftUI-SPM.yml

.PHONY: xcode-ci-tvOS-Swift
xcode-ci-tvOS-Swift:
	xcodegen --spec Samples/tvOS-Swift/tvOS-Swift.yml

.PHONY: xcode-ci-tvOS-SwiftUI-SPM
xcode-ci-tvOS-SwiftUI-SPM:
	xcodegen --spec Samples/tvOS-SwiftUI-SPM/tvOS-SwiftUI-SPM.yml

.PHONY: xcode-ci-visionOS-Swift
xcode-ci-visionOS-Swift:
	xcodegen --spec Samples/visionOS-Swift/visionOS-Swift.yml

.PHONY: xcode-ci-visionOS-SwiftUI-SPM
xcode-ci-visionOS-SwiftUI-SPM:
	xcodegen --spec Samples/visionOS-SwiftUI-SPM/visionOS-SwiftUI-SPM.yml

.PHONY: xcode-ci-watchOS-Swift
xcode-ci-watchOS-Swift:
	xcodegen --spec Samples/watchOS-Swift/watchOS-Swift.yml

.PHONY: xcode-ci-DistributionSample
xcode-ci-DistributionSample:
	xcodegen --spec Samples/DistributionSample/DistributionSample.yml

.PHONY: xcode-ci-SDK-Size
xcode-ci-SDK-Size:
	xcodegen --spec Samples/SDK-Size/SDK-Size.yml

.PHONY: xcode-ci-SwiftUITestSample
xcode-ci-SwiftUITestSample:
	xcodegen --spec TestSamples/SwiftUITestSample/SwiftUITestSample.yml

.PHONY: xcode-ci-SwiftUICrashTest
xcode-ci-SwiftUICrashTest:
	xcodegen --spec TestSamples/SwiftUICrashTest/SwiftUICrashTest.yml

# ============================================================================
# HELP & DOCUMENTATION
# ============================================================================

# Reusable awk script for detailed help output
define HELP_DETAIL_AWK
BEGIN { summary = ""; detailsCount = 0; printed = 0; lookingForDeps = 0 } \
/^## / { summary = substr($$0, 4); delete details; detailsCount = 0; next } \
/^#($$| )/ { \
	if (summary != "") { \
		line = $$0; \
		if (substr(line,1,2)=="# ") detailLine = substr(line,3); else detailLine = ""; \
		details[detailsCount++] = detailLine; \
	} \
	if (lookingForDeps && $$0 !~ /^#/) { lookingForDeps = 0 } \
	next \
} \
/^\.PHONY: / && summary != "" { \
	for (i = 2; i <= NF; i++) { \
		if ($$i == T) { \
			found = 1; \
			lookingForDeps = 1; \
			break \
		} \
	} \
	if (!found) { summary = ""; detailsCount = 0; delete details } \
	next \
} \
lookingForDeps && /^[A-Za-z0-9_.-]+[ \t]*:/ && $$0 !~ /^\.PHONY:/ && $$0 !~ /^\t/ && index($$0,"=")==0 { \
	raw = $$0; \
	split(raw, parts, ":"); \
	tn = parts[1]; \
	if (tn == T) { \
		depStr = substr(raw, index(raw, ":")+1); \
		gsub(/^[ \t]+|[ \t]+$$/, "", depStr); \
		firstDep = depStr; \
		split(depStr, depParts, /[ \t]+/); \
		if (length(depParts[1]) > 0) firstDep = depParts[1]; \
		lookingForDeps = 0; \
	} \
	next \
} \
found && !lookingForDeps { \
	printf "%s\n\n", summary; \
	for (j = 0; j < detailsCount; j++) { \
		if (length(details[j]) > 0) printf "%s\n", details[j]; else print ""; \
	} \
	print ""; \
	printf "Usage:\n"; \
	printf "  make %s\n", T; \
	printed = 1; \
	found = 0; summary = ""; detailsCount = 0; delete details; firstDep = ""; \
	next \
} \
END { if (!printed) { printf "No detailed help found for target: %s\n", T } }
endef

## Show this help message with all available commands
#
# Displays a formatted list of all available make targets with descriptions.
# Commands are organized by topic for easy navigation.
.PHONY: help
help:
	@if [ -n "$(name)" ]; then \
		"$(MAKE)" --no-print-directory help-target name="$(name)"; \
	else \
		echo "=============================================="; \
		echo "🚀 SENTRY COCOA SDK DEVELOPMENT COMMANDS"; \
		echo "=============================================="; \
		echo ""; \
		awk 'BEGIN { summary = ""; n = 0; maxlen = 0 } \
		/^## / { summary = substr($$0, 4); delete details; detailsCount = 0; next } \
		/^\.PHONY: / && summary != "" { \
			for (i = 2; i <= NF; i++) { \
				targets[n] = $$i; \
				summaries[n] = summary; \
				if (length($$i) > maxlen) maxlen = length($$i); \
				n++; \
			} \
			summary = ""; next \
		} \
		END { \
			for (i = 0; i < n; i++) { \
				printf "\033[36m%-*s\033[0m %s\n", maxlen, targets[i], summaries[i]; \
			} \
		}' $(MAKEFILE_LIST); \
		echo ""; \
		echo "💡 Use 'make <command>' to run any command above."; \
		echo "📖 For detailed help on a command, run: make help-<command>  (e.g., make help-build-ios)"; \
		echo "📖 Or: make help name=<command>      (e.g., make help name=build-ios)"; \
		echo ""; \
	fi

.PHONY: help-% help-target
help-%:
	@target="$*"; \
	awk -v T="$$target" '$(HELP_DETAIL_AWK)' $(MAKEFILE_LIST)

help-target:
	@[ -n "$(name)" ] || { echo "Usage: make help name=<target>"; exit 1; }; \
	awk -v T="$(name)" '$(HELP_DETAIL_AWK)' $(MAKEFILE_LIST)