Device tests for the native bridges, the Rust backend, real SQLite, real FFmpeg and on-device rendering. They need an Android emulator or device, or an iOS simulator. CI formats and analyzes this folder but does not run it.

Running

Run one suite on a device:

flutter test integration_test/network_playback_test.dart -d emulator-5554

Add --dart-define=NAME=value for the gated suites below. Android Gradle builds the Rust backend automatically; for iOS run bash scripts/build_rust_backend.sh ios and (cd ios && pod install) first.

Avoid flutter test integration_test for the whole folder: the three aggregate files import other suites, so those suites run twice.

Performance Driver

Suites that import integration_test/performance_probe.dart measure engine frame timings and store results in the binding's reportData. To save the report on the host, run the suite through integration_test/performance_driver.dart:

MORNYE_PERFORMANCE_REPORT=build/perf/mornye.json \
  flutter drive --profile --keep-app-running -d emulator-5554 \
  --driver=integration_test/performance_driver.dart \
  --target=integration_test/mornye_performance_test.dart

MORNYE_PERFORMANCE_REPORT (host environment variable) selects the JSON output; the default is /tmp/mornye-performance.json. Screenshots are written as PNG files beside it.
Use --profile on Android and --debug on iOS simulators.
Pass --keep-app-running; otherwise flutter drive uninstalls the app when it finishes.
Use a dedicated emulator for measurements.
Reports retain the 60 Hz fields and add frame_budgets for 60, 90, 120 Hz and the display's reported refresh rate. These compare engine phase times to each budget; they do not claim the display actually ran at all those rates.
Run material_performance_test.dart through the same driver for Material lyrics and artwork transitions with the same fixtures and gestures as the Mornye suites, plus seek playback, dragging and paused idle in both styles.
Use player_performance_test.dart to compare lyrics, artwork and seek in both styles in a single build.

Emulators and Fixtures

Android emulators reach the host loopback as 10.0.2.2; iOS simulators use 127.0.0.1.
SMB suites need a fixture server on the host: python3 scripts/smb3_fixture_server.py (Samba 4, port 1445 by default) or scripts/smb2_fixture_server.py (impacket). See NETWORK_STORAGE.md.
discord_sdk_test.dart needs the staged Discord Social SDK (third_party/mornye_discord/README.md).
download_queue_access_failure_test.dart uses SAF storage on Android and app storage on iOS.

Build-Time Defines

Define	Suite	Effect
`SMB_TEST_URL`	`network_smb_test.dart`	SMB URL, for example `smb://10.0.2.2:1445/MUSIC/`; skipped when empty
`SMB_TEST_URL`	`network_audio_analysis_test.dart`	Analyse a file on SMB; when empty, a local FFmpeg-made FLAC is used
`TEST_SMB_ADDRESS`	`network_smb_file_actions_test.dart`	SMB address of `smb2_fixture_server.py --deletion`; skipped when empty
`REPLAYGAIN_COMPLETION_BASELINE`	`album_replaygain_completion_test.dart`	Records a baseline run and skips the album-gain assertions
`GLASS_PREVIEW`	`mornye_liquid_glass_test.dart`	Holds the Home screen for 25 s for manual viewing
`MORNYE_GLASS_FOCUS`	`mornye_rendering_performance_test.dart`	Measures only clarity 0.6 and 1.0
`MORNYE_GLASS_FLAT_BACKDROP`	`mornye_glass_visual_test.dart`	Flat surfaces instead of the generated stripes and grid
`DOWNLOAD_GLASS_LEVEL`	`mornye_download_picker_test.dart`	Forces `flat`, `frosted` or `liquid`
`DOWNLOAD_BRIGHTNESS`	`mornye_download_picker_test.dart`	Runs only `light` or `dark`
`DOWNLOAD_QUALITY_COUNT`	`mornye_download_picker_test.dart`	Number of fixture quality options (default 16)
`DOWNLOAD_PRELOAD_GLASS`, `DOWNLOAD_WARMUP_GLASS` (default true), `DOWNLOAD_SHELL_GLASS`	`mornye_download_picker_test.dart`	Glass preload, warm-up and shell glass toggles
`DOWNLOAD_TRACE_FIRST_OPEN`, `DOWNLOAD_FIRST_OPEN_ONLY`	`mornye_download_picker_test.dart`	Trace the first opening; stop after it

Suite Index

Aggregates (each runs other suites as groups):

File	Runs
`collection_batch_write_test.dart`	`playlist_batch_write_test.dart`, `loved_batch_write_test.dart`
`mornye_performance_test.dart`	The rendering, screens, artwork and lyrics Mornye performance suites; driver target
`material_performance_test.dart`	Material lyrics/artwork and shared seek scenarios in both styles; driver target
`player_performance_test.dart`	Shared lyrics, artwork and seek scenarios for Material and Mornye; driver target
`remaining_optimization_test.dart`	Collection restore, history staging, library staging, cache maintenance, collection workers, queue workers, backup archive

Support files (not tests): performance_driver.dart (host driver) and performance_probe.dart (PerformanceTestBinding, PerformanceProbe).

Suites:

File	Exercises
`album_replaygain_completion_test.dart`	Full-queue album ReplayGain completion, with the native worker on Android
`album_replaygain_readiness_test.dart`	Album readiness checks for large queues
`automix_analysis_test.dart`	Native decoding for AutoMix beats; Auto and crossfade playback
`automix_effects_test.dart`	Bundled FFmpeg supports every AutoMix transition effect
`collection_remove_batch_test.dart`	Removing 2000 tracks from a collection; rollback and retry
`desktop_ffmpeg_bundle_test.dart`	macOS only (`-d macos`, after `bash scripts/fetch_desktop_ffmpeg.sh`): the app finds ffmpeg and ffprobe in its bundle, converts a generated tone to FLAC through soxr and to MP3, Opus, AAC and ALAC, and probes the FLAC
`desktop_playback_deck_test.dart`	macOS only (`-d macos`): the default deck plays a generated tone, applies an EQ preset and in-app volume, pauses
`discord_sdk_test.dart`	Native Discord SDK initialize, stop and restart
`download_cancel_dispatch_test.dart`	Native cancel and clear of queued IDs; invalid batches
`download_lossless_container_test.dart`	Foreground queue finalizes lossless M4A without provider hints
`download_output_container_test.dart`	Foreground queue handles each returned container and extension
`download_queue_access_failure_test.dart`	A denied output folder fails only the queued requests
`download_queue_selection_test.dart`	Enqueuing large track and playlist selections; persistence rollback
`download_queue_workers_test.dart`	Queue restore with bounded real sqflite reads
`download_retry_dispatch_test.dart`	Resetting idle cancellation flags across chunks
`download_scheduler_admission_test.dart`	Scheduler admission of slots from large queues
`extension_storage_recovery_test.dart`	Unreadable extension settings; secure storage written with old defaults
`library_collections_workers_test.dart`	Large playlist search pages and metadata-only playlist copies
`library_paging_performance_test.dart`	Long-scroll Library paging on real SQLite (performance)
`loved_batch_write_test.dart`	Love All add and remove on real SQLite
`lyrics_file_access_test.dart`	Embedding, sidecar and export of lyrics outside Downloads
`lyrics_timing_test.dart`	Native lyrics parser timing cases
`mornye_artwork_performance_test.dart`	Mornye player panel transitions and artwork cache (performance)
`mornye_download_picker_test.dart`	Mornye download picker glass and queue feedback (performance)
`mornye_glass_visual_test.dart`	Native Mornye glass poses and layers, with screenshots
`mornye_liquid_glass_test.dart`	Liquid glass lens and drag behavior
`mornye_lyrics_performance_test.dart`	Word-synced lyrics and manual scrolling (performance)
`mornye_menu_presentation_test.dart`	Anchored glass menu presentation (performance)
`mornye_rendering_performance_test.dart`	Mornye rendering at several glass clarities (performance)
`mornye_screens_performance_test.dart`	Mornye screens with 2000-track data (performance)
`native_backup_archive_test.dart`	Native ZIP backup routes, old archive formats, compression parity
`native_cache_maintenance_test.dart`	Native cover cache budget, pruning and sweep
`native_collection_restore_test.dart`	Native collection restore, exact rows, atomic rejection
`native_data_jobs_test.dart`	`runNativeDataJob` operations against the production parsers and schema
`native_history_snapshot_test.dart`	Native history staging and publication through its owner
`native_library_staging_test.dart`	Native library scan staging, publication, retries and cancellation
`network_audio_analysis_test.dart`	Network audio cards with real FFmpeg and Rust analysers
`network_playback_test.dart`	Native player prepare and seek through the network proxy
`network_scan_overhead_test.dart`	Network scan component costs; failed output never published
`network_scan_speed_test.dart`	Native WebDAV scan latency overlap
`network_smb_file_actions_test.dart`	SMB file deletion keeps siblings (needs a fixture)
`network_smb_listing_test.dart`	Preparing large SMB listings
`network_smb_test.dart`	SMB3 listing and seek ranges (needs a fixture)
`network_webdav_encoding_test.dart`	WebDAV parent URI encodings and encoded album listing
`playlist_batch_write_test.dart`	Playlist publication parity, rollback and recovery on real SQLite
`playlist_deletion_batch_test.dart`	Deleting many playlists with shared tracks
`queue_candidate_selection_test.dart`	Selecting queued candidates by pattern
`queue_index_read_test.dart`	Queue selectors and sparse progress after removals
`queue_persistence_snapshot_test.dart`	Queue snapshot persistence, rollback and reload
`queue_progress_selection_test.dart`	Selecting active items in large queues
`queue_removal_test.dart`	Removing completed items; notifier publish and persist

All files listed here live in integration_test/. Shared fixtures and benchmarks come from test/support/.