Makefile

SHELL := /bin/bash

.DEFAULT_GOAL := help

FLUTTER ?= flutter
DART ?= dart
CARGO ?= cargo
DEVICE ?=
TEST ?=
PLATFORM ?=
ENV_FILE ?=
XCARCHIVE_PATH ?=
APP_PATH ?=
DMG_ARM64_PATH ?=
DMG_AMD64_PATH ?=
TAP_REPO_PATH ?=

.PHONY: help deps pub-get run run-device analyze test test-one coverage \
	test-cla gen gen-build gen-build-clean gen-l10n gen-proto build build-android build-ios \
	build-ios-nosign build-macos build-linux build-windows clean \
	release-macos-dmg package-dmg sync-homebrew-cask monitor-dev

help:
	@printf '%s\n' \
		'Usage: make <target> [VAR=value]' \
		'' \
		'Common targets:' \
		'  deps               Install Dart/Flutter dependencies' \
		'  run                Run app on default device' \
		'  run-device         Run app on a specific device: make run-device DEVICE=<id>' \
		'  analyze            Run static analysis for lib/, test/ and integration_test/' \
		'  test               Run all tests' \
		'  test-one           Run a single test: make test-one TEST=test/unit/server/disk_test.dart' \
		'  coverage           Run tests with coverage output' \
		'  test-cla           Test the CLA check in .github/workflows/cla.yml (needs node)' \
		'' \
		'Code generation:' \
		'  gen                Run build_runner and gen-l10n' \
		'  gen-build          Run build_runner build' \
		'  gen-build-clean    Clear the build cache, then run build_runner build' \
		'  gen-l10n           Regenerate localization files' \
		'  gen-proto          Regenerate the tombstone protobuf reader (needs protoc)' \
		'' \
		'Build targets:' \
		'  build              Build via fl_build: make build PLATFORM=<android|ios|macos|linux|windows>' \
		'  build-android      Build Android package' \
		'  build-ios          Build iOS package' \
		'  build-ios-nosign   Build an unsigned iOS ipa (_NoSign.ipa, needs re-signing)' \
		'  build-macos        Build macOS package' \
		'  build-linux        Build Linux package' \
		'  build-windows      Build Windows package' \
		'  clean              Run flutter clean' \
		'' \
		'Monitor:' \
		'  monitor-dev        Run monitor backend + panel dev server (vite on :3000, API on :3770)' \
		'' \
		'Release scripts:' \
		'  release-macos-dmg  Run scripts/release/release-macos-dmg.sh (one DMG per architecture)' \
		'                     Optional: make release-macos-dmg ENV_FILE=.env.release' \
		'                     Optional: RELEASE_ARCHS="arm64" to rebuild one architecture' \
		'  package-dmg        Run scripts/release/package-dmg-from-xcarchive.sh' \
		'                     Example: make package-dmg APP_PATH="/path/Server Box.app"' \
		'                     Example: make package-dmg XCARCHIVE_PATH=/path/Runner.xcarchive' \
		'  sync-homebrew-cask Generate ~/proj/homebrew-cask/Casks/s/server-box.rb from both DMGs' \
		'                     Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"' \
		'                     Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive' \
		'                     Example: make sync-homebrew-cask \' \
		'                       DMG_ARM64_PATH=build/artifacts/ServerBox-1.0.1-arm64.dmg \' \
		'                       DMG_AMD64_PATH=build/artifacts/ServerBox-1.0.1-amd64.dmg'

deps pub-get:
	$(FLUTTER) pub get

run:
	$(FLUTTER) run

run-device:
	@if [ -z "$(DEVICE)" ]; then \
		echo 'DEVICE is required. Example: make run-device DEVICE=<id>'; \
		exit 1; \
	fi
	$(FLUTTER) run -d $(DEVICE)

analyze:
	$(FLUTTER) analyze lib test integration_test

test:
	$(CARGO) build -p sbm_ffi
	$(FLUTTER) test

test-one:
	@if [ -z "$(TEST)" ]; then \
		echo 'TEST is required. Example: make test-one TEST=test/unit/server/disk_test.dart'; \
		exit 1; \
	fi
	$(CARGO) build -p sbm_ffi
	$(FLUTTER) test $(TEST)

coverage:
	$(CARGO) build -p sbm_ffi
	$(FLUTTER) test --coverage

test-cla:
	node scripts/cla_workflow_test.js

gen: gen-build gen-l10n

gen-build:
	$(DART) run build_runner build

# For a build cache that no longer matches the tree — after a merge that adds
# generated sources, most of all. A stale `.dart_tool/build/asset_graph.json`
# does not report anything: the build stops mid-phase at 0% CPU and waits
# forever, because the failure it hits is swallowed by the step awaiting it.
gen-build-clean:
	$(DART) run build_runner clean
	$(DART) run build_runner build

gen-l10n:
	$(FLUTTER) gen-l10n

# Not part of `gen`: the schema is a vendored file that changes when a new
# Android release changes it, which is on the order of once a year, and this
# needs protoc and protoc_plugin installed. Run it after updating
# third_party/proto.
gen-proto:
	@command -v protoc >/dev/null || { echo 'protoc is not installed'; exit 1; }
	$(DART) pub global activate protoc_plugin
	# `protoc` looks for its Dart backend as a `protoc-gen-dart` executable on
	# PATH, and `pub global activate` installs that into the pub cache's `bin`
	# — which is not on PATH unless the user has put it there. Without this the
	# line above succeeds and this one fails with `protoc-gen-dart: program not
	# found`, naming a plugin nothing asked for by that name.
	PATH="$${PUB_CACHE:-$$HOME/.pub-cache}/bin:$$PATH" \
		protoc --dart_out=lib/src/proto -I third_party/proto third_party/proto/tombstone.proto

build:
	@if [ -z "$(PLATFORM)" ]; then \
		echo 'PLATFORM is required. Example: make build PLATFORM=android'; \
		exit 1; \
	fi
	$(DART) run fl_build -p $(PLATFORM)

build-android:
	$(DART) run fl_build -p android

build-ios:
	$(DART) run fl_build -p ios

build-ios-nosign:
	$(FLUTTER) build ios --release --no-codesign
	bash scripts/release/package-unsigned-ipa.sh

build-macos:
	$(DART) run fl_build -p macos

build-linux:
	$(DART) run fl_build -p linux

build-windows:
	$(DART) run fl_build -p windows

clean:
	$(FLUTTER) clean

release-macos-dmg:
	@if [ -n "$(ENV_FILE)" ]; then \
		SERVERBOX_RELEASE_ENV_FILE="$(ENV_FILE)" bash scripts/release/release-macos-dmg.sh; \
	else \
		bash scripts/release/release-macos-dmg.sh; \
	fi

package-dmg:
	@if [ -z "$(APP_PATH)" ] && [ -z "$(XCARCHIVE_PATH)" ]; then \
		echo 'APP_PATH or XCARCHIVE_PATH is required.'; \
		echo 'Example: make package-dmg APP_PATH="/path/Server Box.app"'; \
		echo 'Example: make package-dmg XCARCHIVE_PATH=/path/Runner.xcarchive'; \
		exit 1; \
	fi
	@if [ -n "$(APP_PATH)" ]; then \
		APP_PATH="$(APP_PATH)" bash scripts/release/package-dmg-from-xcarchive.sh; \
	else \
		XCARCHIVE_PATH="$(XCARCHIVE_PATH)" bash scripts/release/package-dmg-from-xcarchive.sh; \
	fi

sync-homebrew-cask:
	@if [ -z "$(APP_PATH)" ] && [ -z "$(XCARCHIVE_PATH)" ] && [ -z "$(DMG_ARM64_PATH)$(DMG_AMD64_PATH)" ]; then \
		echo 'APP_PATH, XCARCHIVE_PATH, or DMG_ARM64_PATH + DMG_AMD64_PATH is required.'; \
		echo 'Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"'; \
		echo 'Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive'; \
		echo 'Example: make sync-homebrew-cask DMG_ARM64_PATH=build/artifacts/ServerBox-1.0.1-arm64.dmg DMG_AMD64_PATH=build/artifacts/ServerBox-1.0.1-amd64.dmg'; \
		exit 1; \
	fi
	@if [ -n "$(APP_PATH)" ]; then \
		APP_PATH="$(APP_PATH)" DMG_ARM64_PATH="$(DMG_ARM64_PATH)" DMG_AMD64_PATH="$(DMG_AMD64_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
	elif [ -n "$(XCARCHIVE_PATH)" ]; then \
		XCARCHIVE_PATH="$(XCARCHIVE_PATH)" DMG_ARM64_PATH="$(DMG_ARM64_PATH)" DMG_AMD64_PATH="$(DMG_AMD64_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
	else \
		DMG_ARM64_PATH="$(DMG_ARM64_PATH)" DMG_AMD64_PATH="$(DMG_AMD64_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
	fi

# Backend from monitor/ (finds config/db there); panel via vite dev server on
# :3000 with /api proxied to :3770. Ctrl-C stops both.
monitor-dev:
	@if [ ! -d monitor/frontend/node_modules ]; then \
		echo '==> Installing panel dependencies'; \
		cd monitor/frontend && npm ci; \
	fi
	@echo '==> Panel: http://localhost:3000  API: http://localhost:3770'
	@trap 'kill 0' INT TERM EXIT; \
	(cd monitor && cargo run -p server_box_monitor -- serve) & \
	(cd monitor/frontend && npm run dev) & \
	wait