pub.dev

adb_utils

0.4.7desodre/adb_utils ↗New releases in your daily digest, changelog included.

A Dart library for interacting with ADB (Android Debug Bridge) server and devices.

Last release 1 months ago
22 Aug 2026
Release timing varies
gaps range from 2 weeks to 3 months
Most releases are documented
notes for 12 of 14 stable releases
Nothing withdrawn
no release was ever pulled
5 months old
14 releases · first in 2026

Release timeline

14 releases since 2026

2026

20262026

One column per month.

Releases

0.4.722 Aug 2026
feat(sync): implemented the native LIST protocol command in AdbSync to read remote directories.
feat(sync): implemented the native LIST protocol command in AdbSync to read remote directories.

feat(models): introduced the strongly typed AdbDirEntry model with built-in Unix file-mode decoding (permissionsOctal/permissionsString, isDirectory, isFile, isLink) and safe UTC timestamps.

test: added a dedicated unit-test suite at test/sync_list_test.dart to validate model parsing and mock socket-server protocol exchanges (success, sentinel filtering, and FAIL/error handling).
Open source →
0.4.620 May 2026
fix(phantom): replaced Logcat-based dynamic port discovery with a deterministic file handshake in app-private storage (context.filesDir/phantom_ports.
fix(phantom): replaced Logcat-based dynamic port discovery with a deterministic file handshake in app-private storage (context.filesDir/phantom_ports.json).

fix(phantom): the Dart client now reads and cleans the handshake file using run-as com.example.phantom_agent to avoid sandbox permission errors on /data/local/tmp and /tmp.

fix(phantom): instrumentation now starts asynchronously without relying on shell redirection, improving compatibility across real devices and emulators.

test(phantom): updated phantom_client_test.dart expectations for run-as file polling and cleanup.

chore(phantom): refreshed embedded Phantom APK artifacts and regenerated phantom_binaries.dart.

0.4.420 May 2026

feat(logging): added structured Smart Logs with package:logging, including hierarchical loggers per device/Phantom serial and configurable global logg

feat(logging): added structured Smart Logs with package:logging, including hierarchical loggers per device/Phantom serial and configurable global logging bootstrap.
feat(observability): added contextual telemetry (FINE, INFO, WARNING, SEVERE) for shell execution, Phantom startup, dynamic-port discovery, and TCP forwarding.
feat(shell-smart-trace): non-zero shell2 exit codes now emit SEVERE smart traces with command, exit code, and sanitized output.
fix(phantom): hardened dynamic port discovery with Logcat cleanup, polling retries/fallbacks, and improved resilience in noisy multi-device environments.
fix(tests): stabilized integration suites by isolating destructive scenarios, improving environment gating, and converting transient infrastructure failures into contextual skips where appropriate.
docs: synchronized adb_utils and phantom_agent documentation with the dynamic-port architecture (ServerSocket(0) + adb forward) and updated troubleshooting guidance.

Open source →

0.4.319 May 2026

feat(phantom): embedded Phantom APK binaries in Dart source through Base64, removing the runtime dependency on local APK paths.

feat(phantom): embedded Phantom APK binaries in Dart source through Base64, removing the runtime dependency on local APK paths.
feat(phantom): refactored PhantomClient.startAgent() to install embedded binaries through safe temporary files created at runtime.
feat(phantom): added the AdbDevice.phantom extension for ergonomic usage (await device.phantom.startAgent();).
build(tooling): added tool/generate_base64_apks.dart to regenerate lib/src/phantom/phantom_binaries.dart.
docs: updated the README, docs, and examples for the new no-path Phantom startup flow.

Open source →

0.4.019 May 2026

(chore) deploy 0.4.0 version.

Open source →

Additional notes

feat(phantom): added PhantomClient.startVideoStream() for raw H.264 streaming.
- Automatically configures adb forward tcp:9009 -> tcp:9009.
- Opens a native Socket on 127.0.0.1:9009 and returns it as Stream<List<int>>.
- Added API docs clarifying the stream contains raw H.264 NAL units.
feat(reporting): added automated HTML test reporting utilities.
- Added TestResult model (lib/src/reporting/test_result.dart).
- Added HtmlReporter (lib/src/reporting/html_reporter.dart) with summary cards and failure evidence blocks (mensagemErro + stackTrace in <pre><code>).
- Added sequential test wrapper TestRunner (lib/src/reporting/test_runner.dart).
- Exported reporting APIs in lib/adb_utils.dart.
- Added demo runner at bin/test_runner.dart that writes report.html.
test(reporting): dart test now generates report.html automatically.
- Added test/helpers/reporting_test.dart to capture per-test results and failures.
- Integrated reporting helper in unit and integration suites:
  - test/adb_utils_test.dart
  - test/phantom_client_test.dart
  - test/integration/server_test.dart
  - test/integration/device_test.dart
test(phantom): added coverage for startVideoStream() forwarding and byte streaming behavior.

Open source →

0.3.118 May 2026

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Open source →

Additional notes

feat(ui_hierarchy): added typed UI hierarchy model and package export.
- Added UiHierarchy, UiNode, and Bounds in lib/src/models/ui_hierarchy.dart.
- Exported ui_hierarchy.dart from the main barrel (adb_utils.dart).
feat(phantom): added dumpWindowHierarchy() to parse XML directly into UiHierarchy.
security: hardened shell/socket surfaces.
- Added package-name validation in appInfo() and uninstall().
- Added URL validation/sanitization in openBrowser().
- Added Phantom socket connect/response timeouts, response size cap, empty-response check, and strict port-range validation.
test: added security-focused tests and hierarchy parsing coverage.
docs: updated README with Phantom + UiHierarchy usage.

Open source →

0.3.018 May 2026

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Open source →

Additional notes

feat(phantom): added PhantomClient to orchestrate UiAutomator agent lifecycle and TCP communication.
- Added startAgent(targetApkPath, agentApkPath) with APK push, install, force-stop, background instrumentation start, and port forwarding.
- Added JSON socket communication flow with robust chunked response handling.
- Added dumpWindow() and clickByText() high-level actions.
test(phantom): added focused unit tests for startAgent, JSON payload exchange, dumpWindow(), and clickByText().
chore(phantom): added bundled APK artifacts for the phantom flow:
- lib/src/phantom/apks/agent.apk
- lib/src/phantom/apks/target.apk

Open source →

0.2.230 Apr 2026

feat(adb_sync): fully implemented file transfer operations via the ADB SYNC protocol.

feat(adb_sync): fully implemented file transfer operations via the ADB SYNC protocol.
- Added pull(): download files using memory-efficient streaming.
- Added readBytes() and readText(): read remote file contents directly into memory.
- Added stat(): query remote file size, mode, and modification time.

Open source →