build-deps

Build plugin dependencies from local SDK checkouts and replace the pre-built binaries under plugin-dev/Source/ThirdParty/. Use when testing unreleased SDK changes.

Steps

1. Select dependencies to build

Determine which dependencies to build from conversation context:

Dependency	Flag	Path parameter	Env var fallback	Notes
sentry-native	-Native	-NativePath	SENTRY_NATIVE_PATH	Builds for host platform: Windows/Linux (Crashpad + Native backends), macOS (Native backend)
sentry-cocoa	-Cocoa	-CocoaPath	SENTRY_COCOA_PATH	macOS host only; produces iOS + Mac artifacts
sentry-java	-Java	-JavaPath	SENTRY_JAVA_PATH	Gradle build; also downloads the matching sentry-native NDK release
crash reporter	-CrashReporter	-CrashReporterPath	SENTRY_CRASH_REPORTER_PATH	.NET build for host platform

-All builds everything supported on the host platform.

2. Verify source paths

For each selected dependency, check that its env var is set (verify non-empty only, never print values; on Windows use [System.Environment]::GetEnvironmentVariable('VAR_NAME')) or that an explicit path parameter was provided. If missing, ask the user for the repository path and pass it via the corresponding path parameter.

3. Run the build

Execute from the repo root:

pwsh ./scripts/build-deps.ps1 -All                                        # everything for host platform
pwsh ./scripts/build-deps.ps1 -Cocoa -Java                                # specific SDKs
pwsh ./scripts/build-deps.ps1 -Native -NativePath "/path/to/sentry-native" # explicit source path

The build can take longer than the default command timeout — run it in the background and monitor its output, or raise the timeout accordingly.

4. Clean stale build artifacts

UnrealBuildTool does not reliably detect ThirdParty binary changes, so after a successful deps rebuild remove the plugin Binaries/Intermediate directories to avoid linking against stale binaries:

REPO=$(git rev-parse --show-toplevel)
rm -rf "$REPO/plugin-dev/Binaries" "$REPO/plugin-dev/Intermediate"

sample/Plugins/sentry is a symlink to plugin-dev, so the plugin artifacts live in plugin-dev/ itself.

5. Rebuild the project

Suggest running /ue-build so the project is recompiled against the freshly built dependencies.