Skip to content

Commit ce223a8

Browse files
uuf-327918-dev-mode-config (#5116)
1 parent dec49a8 commit ce223a8

File tree

6 files changed

+27
-20
lines changed

6 files changed

+27
-20
lines changed

hub/apps/get-started/enable-your-device-for-development.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,12 @@ ms.topic: article
1111

1212
![Enable your devices for development](./images/developer-poster.png)
1313

14-
> [!IMPORTANT]
15-
> If you're not creating your own applications on your PC, you don't need to enable Developer Mode. If you're trying to fix an issue with your computer, check out [Windows help](/windows).
14+
If you're writing software with Visual Studio, you *will* need to enable Developer Mode on both the development PC and on any devices you'll use to test your code.
1615

17-
If you're using your computer for ordinary day-to-day activities (such as gaming, web browsing, email, or Office apps), you *don't* need to activate Developer Mode, and in fact, you shouldn't activate it. The rest of the information on this page won't matter to you, and you can safely get back to whatever you were doing. Thanks for stopping by!
18-
19-
## Developer Mode
16+
> [!NOTE]
17+
> If you're using your computer for ordinary day-to-day activities (such as gaming, web browsing, email, or Office apps), there is no need to activate Developer Mode. If you're trying to fix an issue with your computer, check out [Windows help](/windows).
2018
21-
If you're writing software with Visual Studio on a computer for the first time, you *will* need to enable Developer Mode on both the development PC and on any devices you'll use to test your code. Opening a Windows project when Developer Mode *isn't* enabled will either open the **For developers** settings page, or cause the following dialog to appear in Visual Studio:
19+
Opening a Windows project when Developer Mode *isn't* enabled will either open the **For developers** settings page, or cause the following dialog to appear in Visual Studio:
2220

2321
![Enable Developer Mode dialog](./images/enable-developer-mode-dialog.jpg)
2422

@@ -43,7 +41,7 @@ To enable Developer Mode, or access other settings:
4341
4442
### Developer Mode features
4543

46-
Developer Mode replaces the Windows 8.1 requirements for a developer license. In addition to sideloading, the Developer Mode setting enables debugging and additional deployment options. This includes starting an SSH service to allow deployment to this device. In order to stop this service, you need to disable Developer Mode.
44+
Developer Mode replaces the requirements for a developer license. In addition to sideloading, the Developer Mode setting enables debugging and additional deployment options. This includes starting an SSH service to allow deployment to this device. In order to stop this service, you need to disable Developer Mode.
4745

4846
When you enable Developer Mode on desktop, a package of features is installed, including:
4947

uwp/debug-test-perf/device-portal-desktop.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,24 +23,28 @@ You can use the WDP for the following:
2323

2424
## Set up Windows Device Portal on a Desktop device
2525

26-
### Turn on developer mode
26+
### Turn on Developer Mode
2727

28-
Starting in Windows 10, version 1607, some of the newer features for desktop are only available when developer mode is enabled. For information about how to enable developer mode, see [Enable your device for development](/windows/apps/get-started/enable-your-device-for-development).
28+
You can enable Developer Mode in the **For developers** section of **Settings** (Settings -> System -> For developers). Starting in Windows 10, version 1607, some newer features for desktop are only available when developer mode is enabled.
29+
30+
:::image type="content" source="images/device-portal/device-portal-desk-settings-developer-mode.PNG" alt-text="Screenshot of the Settings -> System -> For developers window showing Developer Mode enabled.":::
2931

3032
> [!IMPORTANT]
3133
> Sometimes, due to network or compatibility issues, developer mode won't install correctly on your device. See the [relevant section of Enable your device for development](/windows/apps/get-started/enable-your-device-for-development#failure-to-install-developer-mode-package) for help troubleshooting these issues.
3234
3335
### Turn on Windows Device Portal
3436

35-
You can enable WDP in the **For developers** section of **Settings** (Settings -> Privacy & security -> For developers). When you enable it, you must also create a corresponding username and password. Do not use your Microsoft account or other Windows credentials.
37+
You can enable WDP in the **For developers** section of **Settings** (Settings -> System -> For developers).
38+
39+
:::image type="content" source="images/device-portal/device-portal-desk-settings-install.PNG" alt-text="Screenshot of the Settings -> System -> For developers window that shows the Install Windows Developer Mode package dialog after enabling Device Portal.":::
3640

37-
![Windows Device Portal section of the Settings app](images/device-portal/device-portal-desk-settings.png)
41+
Once WDP is enabled, you will see URIs at the bottom of the Device Portal section. Take note of the port number appended to the end of the listed URLs: this number is randomly generated when WDP is enabled but should remain consistent between reboots of the desktop.
3842

39-
Once WDP is enabled, you will see web links at the bottom of the section. Take note of the port number appended to the end of the listed URLs: this number is randomly generated when WDP is enabled but should remain consistent between reboots of the desktop.
43+
:::image type="content" source="images/device-portal/device-portal-desk-settings.PNG" alt-text="Screenshot of the Settings -> System -> For developers window that shows the Device Portal settings available after being enabled.":::
4044

41-
These links offer two ways to connect to WDP: over the local network (including VPN) or through the local host. Once you connect, it should look something like this:
45+
These links offer two ways to connect to WDP: over the local network (including VPN) or through the local host.
4246

43-
![Windows Device Portal](images/device-portal/device-portal-example.png)
47+
:::image type="content" source="images/device-portal/device-portal-example.png" alt-text="Screenshot of the Windows Device Portal":::
4448

4549
### Turn off Windows Device Portal
4650

uwp/debug-test-perf/device-portal.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Windows Device Portal overview
33
description: Learn how the Windows Device Portal lets you configure and manage your device remotely over a network or USB connection.
4-
ms.date: 01/28/2022
4+
ms.date: 01/15/2025
55
ms.topic: article
66
ms.localizationpriority: medium
77
---
@@ -25,24 +25,29 @@ Each device family provides a version of the WDP, but features and setup vary ba
2525

2626
These are the basic steps for all devices.
2727

28-
1. Enable Developer Mode and Device Portal on your device (Settings -> Privacy & security -> For developers).
28+
1. Enable Developer Mode (Settings -> System -> For developers).
2929

30-
2. Connect your device and PC through a local network or with USB.
30+
:::image type="content" source="images/device-portal/device-portal-desk-settings-developer-mode.PNG" alt-text="Screenshot of the Settings -> System -> For developers window showing Developer Mode enabled.":::
3131

32-
3. Navigate to the Device Portal page in your browser. This table shows the ports and protocols used by each device family.
32+
2. Enable Device Portal on your device (Settings -> System -> For developers).
33+
34+
:::image type="content" source="images/device-portal/device-portal-desk-settings.PNG" alt-text="Screenshot of the Settings -> System -> For developers window that shows the Device Portal settings available after being enabled.":::
35+
36+
3. Connect your device and PC through a local network or with USB.
37+
38+
4. Navigate to the Device Portal page in your browser. This table shows the ports and protocols used by each device family.
3339

3440
The following table includes device-specific details for the WDP.
3541

3642
> [!NOTE]
37-
> Windows Mixed Reality runs on regular desktop, so its the same portal as Desktop.
43+
> Windows Mixed Reality runs on regular desktop, so it's the same portal as Desktop.
3844
3945
Device family | On by default? | HTTP | HTTPS | USB | Instructions |
4046
--------------|----------------|------|-------|-----|--------------|
4147
Desktop and IoT Enterprise| Enable inside Dev Mode | 50080\* | 50043\* | N/A | [Device Portal for Desktop or IoT Enterprise device](device-portal-desktop.md#set-up-windows-device-portal-on-a-desktop-device) |
4248
Xbox | Enable inside Dev Mode | Disabled | 11443 | N/A | [Device Portal for Xbox](../xbox-apps/device-portal-xbox.md) |
4349
HoloLens | Yes, in Dev Mode | 80 (default) | 443 (default) | `http://127.0.0.1:10080` | [Device Portal for HoloLens](/windows/mixed-reality/develop/platform-capabilities-and-apis/using-the-windows-device-portal) |
4450
IoT Core| Yes, in Dev Mode | 8080 | Enable via regkey | N/A | [Device Portal for IoT Core](/windows/iot-core/manage-your-device/DevicePortal) |
45-
Phone | Enable inside Dev Mode | 80| 443 | `http://127.0.0.1:10080` | [Device Portal for Mobile](device-portal-mobile.md) |
4651

4752
\* This is not always the case, as Device Portal on desktop claims ports in the ephemeral range (>50,000) to prevent collisions with existing port claims on the device. To learn more, see the [Registry-based configuration](device-portal-desktop.md#registry-based-configuration) section in [Windows Device Portal for Desktop](device-portal-desktop.md).
4853

82.4 KB
Loading
221 KB
Loading
41.4 KB
Loading

0 commit comments

Comments
 (0)