Added a Makefile file to handle the development lifecycle in the project.

2026-07-25 11:48:09 +02:00
parent f04a5ea7df
commit f6645d2613
2 changed files with 77 additions and 0 deletions
@@ -0,0 +1,61 @@
+# Development lifecycle front door for the play-date package. All logic
+# lives in SwiftPM, Scripts/, and the example's own Makefile; the targets
+# here only dispatch. Run `make` or `make help` for the list.
+#
+# `build`, `test`, `docs`, and `consumer-test` need only Xcode's toolchain
+# (plus the one-time `make setup`). `embedded` and the example targets
+# additionally need the device toolchains described in the README.
+
+.DEFAULT_GOAL := help
+
+EXAMPLE_DIR := Examples/HelloPlaydate
+
+# The embedded check needs a swift.org snapshot toolchain. Pick up the
+# standard install location automatically (matching Examples/swift.mk);
+# override with `make embedded SWIFT_BIN=/path/to/swift`.
+SWIFT_LATEST := $(HOME)/Library/Developer/Toolchains/swift-latest.xctoolchain/usr/bin/swift
+SWIFT_BIN ?= $(if $(wildcard $(SWIFT_LATEST)),$(SWIFT_LATEST),swift)
+
+.PHONY: help setup build test outdated upgrade embedded consumer-test check docs docs-preview example example-run clean
+
+help: ## List the available targets
+	@grep -E '^[a-zA-Z_-]+:.*## ' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*## "}; {printf "  %-15s %s\n", $$1, $$2}'
+
+setup: ## One-time: point the "playdate" pkg-config module at the SDK
+	Scripts/install-pkgconfig.sh
+
+build: ## Build the bindings for the host
+	swift build
+
+test: ## Run the host-runnable unit tests
+	swift test
+
+outdated: ## Show the dependency updates that `make upgrade` would apply
+	swift package update --dry-run
+
+upgrade: ## Update the SwiftPM dependencies to their latest allowed versions
+	swift package update
+
+embedded: ## Compile-only device check (Embedded Swift, armv7em-none-none-eabi)
+	SWIFT_BIN="$(SWIFT_BIN)" Scripts/build-embedded.sh
+
+consumer-test: ## Build and run a scratch package depending on play-date
+	Scripts/consumer-test.sh
+
+check: build test embedded consumer-test ## Everything CI runs: build, test, embedded, consumer-test
+
+docs: ## Generate the DocC documentation archive
+	swift package generate-documentation --target PlayDate
+
+docs-preview: ## Preview the DocC documentation in a local web server
+	swift package --disable-sandbox preview-documentation --target PlayDate
+
+example: ## Build the HelloPlaydate example (device + simulator pdx)
+	$(MAKE) -C $(EXAMPLE_DIR)
+
+example-run: ## Build the example and open it in the Playdate Simulator
+	$(MAKE) -C $(EXAMPLE_DIR) run
+
+clean: ## Remove build products of the package and the example
+	rm -rf .build
+	$(MAKE) -C $(EXAMPLE_DIR) clean