Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 20 additions & 0 deletions src/development/add-to-app/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,3 +62,23 @@ Select the device on which the Flutter module runs so `flutter attach` filters f


[debugging functionalities]: {{site.url}}/testing/debugging

### Wireless Debugging

You can debug your app wirelessly on an iOS device
using `flutter attach`:

1. Ensure that your device is wirelessly connected to Xcode
as described in the [MacOS installation guide][].
1. Open **Xcode > Product > Scheme > Edit Scheme**
1. Select the **Arguments** tab
1. Add either `--observatory-host=0.0.0.0` for IPv4,
or `--observatory-host=::0` for IPv6 as launch argument
<!-- TO DO: add info on wifi networks -->

![Wireless Port][]{:.mw-100}



[MacOS installation guide]: {{site.url}}/get-started/install/macos#deploy-to-ios-devices
[Wireless Port]: {{site.url}}/assets/images/docs/development/add-to-app/debugging/wireless-port.png
31 changes: 31 additions & 0 deletions src/get-started/install/_ios-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,34 @@ and an Apple Developer account. If your app is using Flutter plugins,
you will also need the third-party CocoaPods dependency manager.

<ol markdown="1">
<li markdown="1">
<a name="connect"></a>
To set up physical device deployment in Xcode,
connect your device to the USB port on your
computer.

<li markdown="1">
<a name="wireless"></a>
[Optional] To leverage wireless debugging, ensure that
your device is on the same network as your computer
and that the device has a set passcode.

While the device is attached, open **Xcode > Window > Devices and Simulators**.
Select your phone, and check **Connect via Network.**

![Wireless Connect][]{:.mw-100}

Once the network icon appears next to the device name,
you can unplug your device from USB.

Sometimes it takes longer to find network devices.
If you don't see your device listed when using `flutter run`,
try extending the timeout: `flutter run --device-timeout 5`.

For additional help troubleshooting,
check out [Apple's Developer Forums][]. For setting up
wireless debugging with `flutter attach`,
checkout [Debugging your add-to-app module][].

<li markdown="1">

Expand Down Expand Up @@ -186,3 +214,6 @@ or clicking the Run button in Xcode.
[Xcode account add]: {{site.url}}/assets/images/docs/setup/xcode-account.png
[Apple Silicon Mac]: https://support.apple.com/en-us/HT211814
[Developer Mode]: https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device
[Apple's Developer Forums]: {{site.apple-dev}}/forums/
[Debugging your add-to-app module]: {{site.url}}/development/add-to-app/debugging/#wireless-debugging
[Wireless Connect]: {{site.url}}/assets/images/docs/setup/wireless-connect.png