geesawra.industries/hydraulophone
An unofficial YouTube Music app for iPhone, iPad, and Mac.
0
0
set shell := ["bash", "-euo", "pipefail", "-c"]
project := "Hydraulophone.xcodeproj"
scheme := "Hydraulophone"
xcode_developer_dir := "/Applications/Xcode.app/Contents/Developer"
simulator_device := env_var_or_default("HYDRAULOPHONE_SIMULATOR", "iPhone 18 Pro")
simulator_os := env_var_or_default("HYDRAULOPHONE_SIMULATOR_OS", "27.0")
simulator_destination := "platform=iOS Simulator,name=" + simulator_device + ",OS=" + simulator_os
simulator_derived_data := ".build/ios-simulator"
device_derived_data := ".build/ios-device"
mac_derived_data := ".build/mac"
default: check
# Regenerate the Xcode project from the checked-in project specification.
generate:
./Scripts/generate-project --force
# Explicit alias for replacing the existing generated project.
regenerate: generate
# Build recipes create the project and generated config only when absent.
[private]
_ensure-project:
@if [[ ! -d '{{project}}' ]]; then ./Scripts/generate-project; fi
@if [[ ! -f .build/generated/LastFMBuildConfiguration.swift ]]; then python3 Scripts/generate_lastfm_build_configuration.py; fi
# Run Swift-format's strict source linter over app, core, and test code.
lint:
swift format lint --recursive --strict Sources Tests
# Run the package-level fixture tests without requiring a live InnerTube request.
test:
swift test
# Compile the universal iPhone/iPad app for a generic simulator destination.
compile: _ensure-project
DEVELOPER_DIR={{xcode_developer_dir}} xcodebuild build -project {{project}} -scheme {{scheme}} -destination 'generic/platform=iOS Simulator' CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES
# Build and launch the Mac Catalyst app with its Keychain entitlement.
mac: _ensure-project
#!/usr/bin/env bash
set -euo pipefail
export DEVELOPER_DIR="{{xcode_developer_dir}}"
development_team="${HYDRAULOPHONE_DEVELOPMENT_TEAM:-}"
if [[ -z "$development_team" ]]; then
development_team="$(python3 Scripts/read_development_team.py)"
fi
build_args=(
build
-project "{{project}}"
-scheme "{{scheme}}"
-destination 'platform=macOS,variant=Mac Catalyst'
-derivedDataPath "{{mac_derived_data}}"
"DEVELOPMENT_TEAM=${development_team}"
"CODE_SIGN_IDENTITY=Apple Development"
CODE_SIGN_STYLE=Automatic
CODE_SIGNING_REQUIRED=YES
CODE_SIGNING_ALLOWED=YES
)
if [[ "${HYDRAULOPHONE_ALLOW_PROVISIONING_UPDATES:-1}" == "1" ]]; then
build_args+=(-allowProvisioningUpdates)
fi
xcodebuild "${build_args[@]}"
open -n -a "$PWD/{{mac_derived_data}}/Build/Products/Debug-maccatalyst/Hydraulophone.app"
# Package an unnotarized Apple Silicon DMG with the existing development identity.
# Infers the signing team like `just mac`; preserves the Keychain entitlement.
dmg version build: _ensure-project
DEVELOPER_DIR={{quote(xcode_developer_dir)}} python3 Scripts/release_macos.py {{quote(version)}} {{quote(build)}}
# Backwards-compatible alias for the compile recipe.
build: compile
# Build, install, and launch on a simulator; includes the bundled public playback key.
simulator: _ensure-project
#!/usr/bin/env bash
set -euo pipefail
public_jnn_key="${SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY:-}"
if [[ -z "$public_jnn_key" ]]; then
public_jnn_key="$(python3 Scripts/read_public_jnn_key.py)"
fi
devicehub_app="{{xcode_developer_dir}}/../Applications/DeviceHub.app"
simulator_app="{{xcode_developer_dir}}/Applications/Simulator.app"
if [[ -x "$devicehub_app/Contents/MacOS/DeviceHub" ]]; then
open "$devicehub_app" >/dev/null 2>&1 || true
elif [[ -x "$simulator_app/Contents/MacOS/Simulator" ]]; then
open "$simulator_app" >/dev/null 2>&1 || true
fi
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl boot "{{simulator_device}}" 2>/dev/null || true
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl bootstatus "{{simulator_device}}" -b
DEVELOPER_DIR={{xcode_developer_dir}} xcodebuild build -project {{project}} -scheme {{scheme}} -destination '{{simulator_destination}}' -derivedDataPath '{{simulator_derived_data}}' CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl install "{{simulator_device}}" "{{simulator_derived_data}}/Build/Products/Debug-iphonesimulator/Hydraulophone.app"
SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY="$public_jnn_key" DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl launch --terminate-running-process "{{simulator_device}}" com.hydraulophone.app
# Build and launch the CarPlay-enabled app, then point to Device Hub's menu search.
carplay-simulator: simulator
@printf 'CarPlay Simulator is integrated into Device Hub in Xcode 27. Use Device Hub Help > search for “CarPlay” to locate the connection command for the selected iPhone simulator.\n'
# Install and launch on a connected iPhone, bundling the attributed public playback key.
# Infers its Team ID from local Apple Development certificates.
device-install: _ensure-project
#!/usr/bin/env bash
set -euo pipefail
export DEVELOPER_DIR="{{xcode_developer_dir}}"
device_id="$(python3 Scripts/select_connected_iphone.py)"
printf 'Using iPhone: %s\n' "$device_id"
public_jnn_key="${DEVICECTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY:-}"
if [[ -z "$public_jnn_key" ]]; then
public_jnn_key="$(python3 Scripts/read_public_jnn_key.py)"
fi
export DEVICECTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY="$public_jnn_key"
device_entitlements="Resources/Hydraulophone.Device.entitlements"
case "${HYDRAULOPHONE_DEVICE_CARPLAY:-0}" in
0) ;;
1) device_entitlements="Resources/Hydraulophone.entitlements" ;;
*) printf 'HYDRAULOPHONE_DEVICE_CARPLAY must be 0 or 1.\n' >&2; exit 2 ;;
esac
if /usr/libexec/PlistBuddy -c 'Print :com.apple.developer.carplay-audio' "$device_entitlements" 2>/dev/null | grep -qx true; then
printf 'Including CarPlay entitlement for device build.\n'
else
printf 'Omitting CarPlay entitlement for device build.\n'
fi
development_team="${HYDRAULOPHONE_DEVELOPMENT_TEAM:-}"
if [[ -z "$development_team" ]]; then
development_team="$(python3 Scripts/read_development_team.py)"
fi
build_args=(build -project "{{project}}" -scheme "{{scheme}}" -destination "platform=iOS,id=${device_id}" -derivedDataPath "{{device_derived_data}}")
build_args+=("DEVELOPMENT_TEAM=${development_team}")
build_args+=("CODE_SIGN_ENTITLEMENTS=${device_entitlements}")
if [[ "${HYDRAULOPHONE_ALLOW_PROVISIONING_UPDATES:-1}" == "1" ]]; then
build_args+=(-allowProvisioningUpdates)
fi
xcodebuild "${build_args[@]}"
app_path="{{device_derived_data}}/Build/Products/Debug-iphoneos/Hydraulophone.app"
xcrun devicectl device install app --device "$device_id" "$app_path"
xcrun devicectl device process launch --terminate-existing --device "$device_id" com.hydraulophone.app
# Relaunch the installed app with its public playback key and stream its debug console.
device-console:
#!/usr/bin/env bash
set -euo pipefail
export DEVELOPER_DIR="{{xcode_developer_dir}}"
device_id="$(python3 Scripts/select_connected_iphone.py)"
public_jnn_key="${DEVICECTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY:-}"
if [[ -z "$public_jnn_key" ]]; then
public_jnn_key="$(python3 Scripts/read_public_jnn_key.py)"
fi
export DEVICECTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY="$public_jnn_key"
xcrun devicectl device process launch --console --terminate-existing --device "$device_id" com.hydraulophone.app
# Build and launch deterministic fixture data without reading Keychain or
# making any network request. Useful for safe accessibility inspection.
simulator-offline: _ensure-project
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl boot "{{simulator_device}}" 2>/dev/null || true
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl bootstatus "{{simulator_device}}" -b
DEVELOPER_DIR={{xcode_developer_dir}} xcodebuild build -project {{project}} -scheme {{scheme}} -destination '{{simulator_destination}}' -derivedDataPath '{{simulator_derived_data}}' CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl install "{{simulator_device}}" "{{simulator_derived_data}}/Build/Products/Debug-iphonesimulator/Hydraulophone.app"
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl launch --terminate-running-process "{{simulator_device}}" com.hydraulophone.app -HydraulophoneOfflineFixture
# Run the test target on an installed iPhone simulator.
simulator-test: _ensure-project
DEVELOPER_DIR={{xcode_developer_dir}} xcodebuild test -project {{project}} -scheme {{scheme}} -destination '{{simulator_destination}}' CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=
# Run the bounded, opt-in authenticated search/playlists/playback diagnostic.
# This target requires a real Keychain session already present in the app.
simulator-smoke: _ensure-project
#!/usr/bin/env bash
set -euo pipefail
log_file="${HYDRAULOPHONE_SMOKE_LOG:-.build/simulator-smoke.log}"
smoke_args=(-HydraulophoneLiveSmoke)
smoke_high="${HYDRAULOPHONE_SMOKE_HIGH:-0}"
if [[ "${HYDRAULOPHONE_SMOKE_EXTENDED:-0}" == "1" ]]; then
smoke_args+=(-HydraulophoneExtendedSmoke)
fi
if [[ "$smoke_high" == "1" ]]; then
smoke_args+=(-HydraulophoneHighPlayerSmoke)
fi
if [[ "${HYDRAULOPHONE_SMOKE_CATALOG:-0}" == "1" ]]; then
smoke_args=(-HydraulophoneCatalogSmoke)
fi
if [[ "${HYDRAULOPHONE_SMOKE_TRACK_ACTIONS:-0}" == "1" ]]; then
smoke_args=(-HydraulophoneLiveSmoke -HydraulophoneTrackActionsSmoke)
fi
if [[ "${HYDRAULOPHONE_SMOKE_PERSONAL_MIXES:-0}" == "1" ]]; then
smoke_args=(-HydraulophoneLiveSmoke -HydraulophonePersonalMixesSmoke)
fi
if [[ "${HYDRAULOPHONE_SMOKE_LISTENING_QUALITY:-0}" == "1" ]]; then
smoke_args=(-HydraulophoneLiveSmoke -HydraulophoneListeningQualitySmoke)
fi
if [[ "${HYDRAULOPHONE_SMOKE_DOWNLOADS:-0}" == "1" ]]; then
smoke_args=(-HydraulophoneLiveSmoke -HydraulophoneDownloadSmoke)
if [[ "${HYDRAULOPHONE_DOWNLOAD_QUALITY:-high}" == "standard" ]]; then
smoke_args+=(-HydraulophoneDownloadStandard)
fi
fi
mkdir -p "$(dirname "$log_file")"
: > "$log_file"
log_pid=""
app_launched=0
cleanup() {
local exit_status=$?
if [[ "$exit_status" -ne 0 && "$app_launched" -eq 1 ]]; then
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl terminate "{{simulator_device}}" com.hydraulophone.app 2>/dev/null || true
fi
if [[ -n "$log_pid" ]]; then
kill "$log_pid" 2>/dev/null || true
wait "$log_pid" 2>/dev/null || true
fi
printf 'Smoke log: %s\n' "$log_file"
}
cancel() {
exit 130
}
trap 'cleanup' EXIT
trap 'cancel' INT TERM
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl boot "{{simulator_device}}" 2>/dev/null || true
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl bootstatus "{{simulator_device}}" -b
DEVELOPER_DIR={{xcode_developer_dir}} xcodebuild build -project {{project}} -scheme {{scheme}} -destination '{{simulator_destination}}' -derivedDataPath '{{simulator_derived_data}}' CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl install "{{simulator_device}}" "{{simulator_derived_data}}/Build/Products/Debug-iphonesimulator/Hydraulophone.app"
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl spawn "{{simulator_device}}" log stream --style compact --level debug --predicate 'subsystem == "com.hydraulophone"' >"$log_file" 2>&1 &
log_pid=$!
sleep 1
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl launch --terminate-running-process "{{simulator_device}}" com.hydraulophone.app "${smoke_args[@]}"
app_launched=1
deadline_seconds=180
if [[ "$smoke_high" == "1" ]]; then
deadline_seconds=300
fi
deadline=$((SECONDS + deadline_seconds))
while (( SECONDS < deadline )); do
if grep -q 'smoke outcome=cancelled' "$log_file"; then
printf 'Smoke outcome: cancelled\n'
exit 1
fi
if grep -q 'smoke outcome=inconclusive' "$log_file"; then
printf 'Smoke outcome: inconclusive (required evidence was unavailable)\n'
exit 2
fi
if grep -q 'smoke outcome=failure' "$log_file"; then
printf 'Smoke outcome: failure\n'
exit 1
fi
if grep -q 'smoke outcome=skipped' "$log_file"; then
printf 'Smoke outcome: skipped (authenticated session is required)\n'
exit 2
fi
if [[ "$smoke_high" == "1" ]] && grep -q 'smoke outcome=success mode=high' "$log_file"; then
printf 'Smoke outcome: High success\n'
exit 0
fi
if [[ "$smoke_high" != "1" ]] && grep -q 'smoke outcome=success' "$log_file"; then
printf 'Smoke outcome: success\n'
exit 0
fi
sleep 1
done
printf 'Smoke outcome: timeout after %s seconds\n' "$deadline_seconds"
exit 1
# Opt-in sustained playback, pause/resume, seek, and next-track check.
simulator-smoke-extended:
HYDRAULOPHONE_SMOKE_EXTENDED=1 just simulator-smoke
# Run production High Opus playback, proof generation, exact-time unbuffered
# seeks, pause/resume, and High/Standard quality switches. Requires an
# authenticated simulator Keychain session. The public JNN key is loaded from
# the attributed public client key in Config/ unless explicitly supplied in the environment.
simulator-smoke-high:
#!/usr/bin/env bash
set -euo pipefail
public_jnn_key="${SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY:-}"
if [[ -z "$public_jnn_key" ]]; then
public_jnn_key="$(python3 Scripts/read_public_jnn_key.py)"
fi
SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY="$public_jnn_key" HYDRAULOPHONE_SMOKE_HIGH=1 just simulator-smoke
# Opt-in, read-only catalog first/continuation-page checks; no media playback.
simulator-smoke-catalog:
HYDRAULOPHONE_SMOKE_CATALOG=1 just simulator-smoke
# Opt-in, read-only search -> linked artist -> linked album navigation check.
simulator-smoke-track-actions:
HYDRAULOPHONE_SMOKE_TRACK_ACTIONS=1 just simulator-smoke
# Opt-in, read-only Home -> personal mix -> track continuation check.
simulator-smoke-personal-mixes:
HYDRAULOPHONE_SMOKE_PERSONAL_MIXES=1 just simulator-smoke
# Opt-in normalization, successor caching and bundled-key playback diagnostic.
simulator-smoke-listening-quality:
HYDRAULOPHONE_SMOKE_LISTENING_QUALITY=1 just simulator-smoke
# Opt-in single-track download, local artwork, offline playback/seek and restore.
# Set HYDRAULOPHONE_DOWNLOAD_QUALITY=standard to check AAC instead of Opus.
simulator-smoke-downloads:
#!/usr/bin/env bash
set -euo pipefail
public_jnn_key="${SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY:-}"
if [[ -z "$public_jnn_key" ]]; then
public_jnn_key="$(python3 Scripts/read_public_jnn_key.py)"
fi
SIMCTL_CHILD_HYDRAULOPHONE_PUBLIC_JNN_KEY="$public_jnn_key" HYDRAULOPHONE_SMOKE_DOWNLOADS=1 just simulator-smoke
# Run the opt-in XCUITest navigation loop. It never captures screenshots.
simulator-smoke-ui: _ensure-project
DEVELOPER_DIR={{xcode_developer_dir}} TEST_RUNNER_HYDRAULOPHONE_LIVE_UI=1 xcodebuild test -project {{project}} -scheme {{scheme}} -destination '{{simulator_destination}}' -only-testing:HydraulophoneUITests/HydraulophoneLiveSmokeUITests/testLiveAuthenticatedSearchPlaylistPlayback CODE_SIGN_IDENTITY=- CODE_SIGNING_REQUIRED=YES CODE_SIGNING_ALLOWED=YES CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=
# Follow Hydraulophone's focused authentication logs from the configured simulator.
simulator-logs:
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl spawn "{{simulator_device}}" log stream --style compact --level info --predicate 'subsystem == "com.hydraulophone"'
# Read only recent Hydraulophone subsystem messages; credentials are not logged.
simulator-logs-recent:
DEVELOPER_DIR={{xcode_developer_dir}} xcrun simctl spawn "{{simulator_device}}" log show --info --last 15m --style compact --predicate 'subsystem == "com.hydraulophone"'
# Run the fast checks and simulator-compilable app build.
check: lint test compile