Удаленная отладка XBOX приложений WinUI 2 (UWP) WebView2

Чтобы использовать средства разработки Microsoft Edge для отладки приложения WebView2 WinUI 2 (UWP), используйте удаленную отладку. Удаленная отладка необходима для приложений WebView2 WinUI 2 (UWP), так как в настоящее время встроенные средства разработки не могут быть запущены в приложении WebView2 WinUI 2 (UWP) с подписью магазина.

Удаленное подключение Средств разработки к приложению XBOX WebView2 WinUI 2 (UWP)

Удаленно подключите Средства разработки Microsoft Edge к приложению XBOX WebView2 WinUI 2 (UWP) следующим образом:

1. В Microsoft Edge перейдите по адресу edge://inspect. Откроется страница Проверка с помощью средств разработчика Edge :

   

2. Включите режим разработчика на XBOX. См. XBOX активацию в режиме одного разработчика.

3. В Microsoft Edge перейдите по адресу https://<System IP>:11443, где <System IP> заменяется XBOX IP-адресом ОС системы. На вкладке Портал устройств Windows отобразится страница Подтверждение параметров безопасности:

   

4. Нажмите кнопку Продолжить с незащищенным подключением . Появится ошибка SSL-сертификата NET::ERR__CERT_AUTHORITY_INVALID:

   

5. Нажмите кнопку Дополнительно. Появится сообщение "Сервер не смог доказать...":

   

6. Щелкните ссылку<System IP> Продолжить (небезопасный), где <System IP> заменяется ip-адресом системной ОС XBOX. откроется портал устройств XBOX:

   

7. Перейдите в https://<System IP>:11443/config/rootcertificate, где <System IP> заменяется ip-адресом системной ОС XBOX. При этом скачивается rootcertificate.cer файл:

   

8. Откройте скачанный rootcertificate.cer файл. Откроется диалоговое окно предупреждения системы безопасности:

   

9. Нажмите кнопку Открыть . Откроется диалоговое окно Сертификат :

   

10. Нажмите кнопку Установить сертификат . Откроется диалоговое окно "Добро пожаловать в мастер импорта сертификатов":

    

11. Нажмите кнопку Текущий пользователь и нажмите кнопку Далее . Откроется мастер импорта сертификатов:

    

12. Выберите параметр Поместить все сертификаты в следующее хранилище, нажмите кнопку Обзор и выберите Доверенные корневые центры сертификации.

13. Нажмите кнопку Далее . Откроется диалоговое окно "Предупреждение системы безопасности ":

    

14. Нажмите кнопку Да .

15. Перезапустите Microsoft Edge.

16. Перейдите по адресу https://<System IP>:11443, где <System IP> заменяется IP-адресом XBOX системной ОС, и убедитесь, что подключение указано как безопасное (то есть URL-адрес HTTPS):

    

17. В проекте приложения задайте следующую переменную, чтобы настроить приложение WebView2 WinUI 2 (UWP) для удаленной отладки.

    Чтобы включить удаленную отладку, в проекте должна быть задана переменная среды. Эту переменную необходимо задать перед созданием экземпляра CoreWebView2 , а также перед заданием WebView2.Source свойства или вызовом WebView2.EnsureCoreWebView2Async метода .

    "WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging"
    

    Например, если вы используете пример приложения UWP WebView2, можно задать переменную среды, добавив следующую строку в Browser.xaml.cs файл:

    Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
    

    Строка нумеруется 33 на этом снимке экрана в конструкторе Browser() под элементом #endif , который заключает в оболочку существующую SetEnvironmentVariable инструкцию:

    

18. Разверните приложение в XBOX с помощью XBOX Device Portal и запустите приложение.

19. Перейдите по адресу edge://inspect.

20. В текстовом поле Подключиться к удаленному устройству Windows введите https://<System IP>:11443, где <System IP> заменяется ip-адресом XBOX системной ОС, а затем нажмите кнопку Подключиться к устройству.

21. Убедитесь, что вы успешно можете подключиться, чтобы отлаживаемый элемент управления WebView2 с именем Edge был указан под именем компьютера:

    

22. В нижней части элемента управления Edge WebView2 щелкните ссылку проверка . Microsoft Edge DevTools откроется для элемента управления WebView2:

    

Теперь вы можете использовать Средства разработки Microsoft Edge для проверки и отладки элемента управления WebView2 в приложении XBOX WebView2 WinUI 2 (UWP).

См. также

• Удаленная отладка приложений WebView2 WinUI 2 (UWP)