Skip to content

v0.2.0 — Configurable Android and Flutter preview

Latest

Choose a tag to compare

@skyjjgw skyjjgw released this 21 Oct 11:33

Configurable Android and Flutter projects

  • Configure your own APK, application ID, launch Activity, app directory and monorepo source watchers. No fixed Starcompanion/Operit2 package or project layout.
  • Windows, macOS and Linux command/path handling; Flutter launches the native Dart executable without a shell.
  • Set hotReload: false to install, launch and mirror an existing Android APK without Flutter SDK, VM polling or Dart watchers.
  • Optional trusted prepareExecutable / prepareArgs replaces mandatory PowerShell execution. A prebuilt APK needs no project scripts.
  • Default renderer preserves the app's own settings; explicit GPU/software fallbacks remain available.
  • Existing loopback-only listener, Host/Origin/token checks and native DSH sidebar integration are retained.

Upgrade notes

0.1.x users must configure applicationId and their actual app layout explicitly. See configuration and migration. The old PowerShell adapter is retained only as an opt-in Windows helper. SDKs, APKs and scrcpy are external prerequisites. Use a running emulator; physical phones and rotated-screen controls are outside the verified scope.

Verification

  • 18 tests pass on all six CI jobs: Windows/macOS/Linux × Node 22.19.0/24. Workflow.
  • Real Windows emulator test with a newly generated independent Flutter app (dev.skymoni.previewqa.preview_counter) and no preparation hook: APK install/launch, scrcpy video, Flutter attach and save-triggered hot reload (1 successful reload; visible text changed).
  • Android-only mode verified with the same APK: launch/video work, hot reload is disabled, no Flutter attachment is started. The disposable QA app is not part of the release.
  • Idle lifecycle tests check that disposal releases the listening port without starting Android.
  • Fresh official DSH 0.2.1-rc.2 CLI install into an isolated profile passes with install scripts disabled; the resolved profile includes the Android preview bundle. Configuration using the actual host Schemastery 3.18.5, plugin apply/discovery and idle disposal also pass. The user's active profile is unchanged.
  • macOS/Linux real-emulator sessions were not tested locally. Passing platform tests do not verify every driver, ABI or video codec environment.

Artifact: dsh-plugin-android-preview-0.2.0.tgz

SHA-256: 0a488701f39d4fd6519ba53c42638830c3704a1901d1391d71f8a0f45049b2af