5/3/2019 9:33 PM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

App Diagnostics #1 The new App Diagnostics APIs 5/3/2019 9:33 PM P4169 App Diagnostics #1 The new App Diagnostics APIs Andrew Whitechapel Program Manager © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

New diagnostic APIs What are they for? How are they different? Targeted app-profiling General-purpose tooling How are they different? Existing tools know about processes New APIs know additional UWP-specific information Can I use them now? Skeleton form in the Creators Edition Sneak-peek to the next release #MSBuild

Overview Introducing the new app diagnostics APIs What’s different between Creators Edition and the next release How the API hierarchy models the kernel and platform behavior Permissions and user settings Building a UWP Task Manager

The new app diagnostic APIs New APIs that provide information about running apps What apps are in memory Execution state, resource usage (memory, CPU, disk, energy) Background tasks Integrates and extends existing diagnostic APIs W.S.D.ProcessDiagnosticInfo, W.S.MemoryManager, W.AM.AppInfo W.M.D.PackageManager Enable an app to get information about any running app Permission gated by capability and settings

Creators Edition vs Next Release Get a list of running apps Minimal AppDiagnosticInfo AppUserModelId, PackageFamilyName, DisplayName, Description, Logo Next Release(s) Enhanced AppDiagnosticInfo Memory usage, Execution state, Energy quota state List of background tasks List of processes Closed loop: AppDiagnosticInfo  ProcessDiagnosticInfo Change notifications

Creators Edition

Creators Edition – API usage public ObservableCollection<RowInfo> rows = new ObservableCollection<RowInfo>(); private async void getData_Click(object sender, RoutedEventArgs e) { rows.Clear(); IList<AppDiagnosticInfo> apps = await AppDiagnosticInfo.RequestInfoAsync(); foreach (AppDiagnosticInfo app in apps) RowInfo row = new RowInfo() Logo = await GetLogoAsync(app), DisplayName = app.AppInfo.DisplayInfo.DisplayName, AppUserModelId = app.AppInfo.AppUserModelId }; rows.Add(row); } appListView.ItemsSource = rows;

Manifest capabilities <Package xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/ windows10/restrictedcapabilities" IgnorableNamespaces="uap mp rescap"> <!----> <Capabilities> <rescap:Capability Name="appDiagnostics" /> <rescap:Capability Name="packageQuery" /> </Capabilities> </Package>

Permissions and user settings

How the APIs model platform behavior

New and updated APIs

vNext – API usage DiagnosticPermission permission = await AppDiagnosticInfo.RequestPermissionAsync(); if (permission == DiagnosticPermission.Allowed) { IList<AppDiagnosticInfo> appDiagnostics = await AppDiagnosticInfo.RequestInfoAsync(); foreach(AppDiagnosticInfo appDiagnostic in appDiagnostics) IList<ResourceGroupInfo> groups = appDiagnostic.GetResourceGroups(); foreach (ResourceGroupInfo group in groups) MemoryReport memoryReport = group.GetMemoryReport(); Debug.WriteLine( "level={0}, limit={1}, private commit={2}, total commit={3}", memoryReport.CommitUsageLevel, memoryReport.CommitUsageLimit, memoryReport.PrivateCommitUsage, memoryReport.TotalCommitUsage); }

Building UWP Task Manager Add manifest capability Request permission to get info for apps Get a list of running processes either: a list of ProcessDiagnosticInfo or: a list of AppDiagnosticInfo For each process, get process-specific info For each packaged app, get app-specific info Poll for updates

Demo – UWP TaskManager Andrew Whitechapel 5/3/2019 9:33 PM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Conclusions New APIs to get diagnostic information for running apps Protected by capability, user consent, settings Process data and app data General-purpose diagnostic tools Targeted app profiling

Call to action Let attendees know what do to following this session. 5/3/2019 9:33 PM Call to action Let attendees know what do to following this session. Tell Attendees the URL where they can find your Github Code Use this slide to list resources, white papers, videos and links. Re-visit Build session recordings on Channel 9. Continue your education at Microsoft Virtual Academy online. #MSBuild © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

5/3/2019 9:33 PM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.