Skip to content

[flutter_tools] Tool host/device port needs documentation and cleanup #114845

Closed as not planned

Description

@christopherfujino

A discussion that started with #114628 (comment) revealed a lot of confusion over --device-vmservice-port, --host-vmservice-port, and --dds-port. The conclusion was:

  • Application runs on device, it starts up a VM Service instance. This instance will broadcast on a port + auth code combo.
  • (Optional) If Host/Device are different machines, we forward the device port to a selected host port.
  • (Optional) If dds is enabled, dds connects to the selected host port, then broadcasts on the dds port

However, we should:

  1. verify this is how things currently work
  2. refactor to clean up, remove redundancy, and add validations
  3. document how it all works, in the code, the CLI help text and a standalone document.

Activity

  1. added
    toolAffects the "flutter" command-line tool. See also t: labels.
    c: contributor-productivityTeam-specific productivity, code health, technical debt.
    c: tech-debtTechnical debt, code quality, testing, etc.
    on Nov 7, 2022
  2. added
    P2Important issues not at the top of the work list
    on Nov 7, 2022
  3. github-actions commented on Jul 25, 2025

    @github-actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  4. locked as resolved and limited conversation to collaborators on Jul 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Important issues not at the top of the work listc: contributor-productivityTeam-specific productivity, code health, technical debt.c: tech-debtTechnical debt, code quality, testing, etc.team-toolOwned by Flutter Tool teamtoolAffects the "flutter" command-line tool. See also t: labels.triaged-toolTriaged by Flutter Tool team

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions