Documentation / Develop
Develop
The Developer SDK is the hub for working on Aphotic: one page that points at each subsystem’s guide. The most used pages:
- Contributor Workflow — what runs on your daily machine, what runs in the dev VM, what CI runs on the PR
- Dev VM — build a disposable test machine on libvirt or Proxmox, and hand the setup to your own agent
- Build a Plugin, with the plugin SDK guide in the plugins repo
- CLI Reference — every
aphoticcommand
The loop on a checkout: tools/ci/local.sh before every push, and a
windowless QT_QPA_PLATFORM=offscreen qs -p <component.qml> probe for QML
changes — never qs -p . on a live desktop, it maps a second bar.
Plugin manifests declare capabilities next to code. A [harness.<id>] table
needs the harness-hook capability, and aphotic plugin validate warns when
the table ships without it. aphotic agent harnesses merges manifest
descriptors with the drop-ins in ~/.config/aphotic/harnesses/, and plugin
install, remove, enable and disable rerun the merge.