Microsoft rilascia l'anteprima della libreria 3 dell'interfaccia utente di Windows 4

WinUI è un livello dell'interfaccia utente che contiene controlli e stili moderni per la creazione di app Windows, sia desktop che UWP. In quanto livello dell'interfaccia utente nativo in Windows, incarna Fluent Design, conferendo a ciascuna app di Windows l'aspetto raffinato che gli utenti si aspettano.

[lwptoc title=”WinUI Library 3 Preview 4″ width=”40%” float=”destra”]

WinUI 3 è l'ultima versione del framework WinUI, disponibile entro la fine dell'anno. Espande notevolmente WinUI in un framework UX completo, rendendo WinUI disponibile per tutti i tipi di app Windows, da Win32 a UWP, per l'uso come livello dell'interfaccia utente. Quando sarà pronta, ogni app di Windows potrà sfruttare i suoi controlli moderni che funzionano indipendentemente dalla versione di Windows su cui sono in esecuzione.

Rilasciato oggi, Anteprima di WinUI 3 4 è una versione di anteprima della stabilità che include correzioni di bug critici e altri miglioramenti generali per il framework.

Funzionalità introdotte in Preview 4

• Parità con WinUI 2.5 (include il controllo InfoBar, nuove funzionalità in ProgressRing e NavigationView e correzioni di bug)
• Funzionalità personalizzate della barra del titolo: nuove API Window.ExtendsContentIntoTitleBar e Window.SetTitleBar che consentono agli sviluppatori di creare barre del titolo personalizzate nelle app desktop.
• Supporto per VirtualSurfaceImageSource

Nuove funzionalità e funzionalità introdotte nelle precedenti anteprime di WinUI 3

Le seguenti caratteristiche e capacità sono state introdotte in WinUI 3 Preview 1-3 e continuano a essere supportate in WinUI 3 Preview 4.

• Possibilità di creare app desktop con WinUI, incluso .NET 5 per le app Win32
• Pennello RadialeGradiente
• Aggiornamenti TabView
• Aggiornamenti del tema scuro
• Miglioramenti e aggiornamenti a visualizzazione web2
  • Supporto per DPI elevati
  • Supporto per ridimensionamento e spostamento delle finestre
  • Aggiornato per scegliere come target una versione più recente di Edge
  • Non è più necessario fare riferimento a un pacchetto Nuget specifico di WebView2
• SwapChainPanel
• Supporto principale MRT
  • Ciò rende le app più veloci e leggere all'avvio e fornisce una ricerca delle risorse più rapida.
• Supporto ARM64
• Trascina e rilascia all'interno e all'esterno delle app
• RenderTargetBitmap (attualmente solo contenuto XAML, nessun contenuto SwapChainPanel)
• Supporto cursore personalizzato
• Ingresso fuori filo
• Miglioramenti alla nostra esperienza con strumenti / sviluppatori:
  • Live Visual Tree, Hot Reload, Live Property Explorer e strumenti simili
  • Intellisense per WinUI 3
• Miglioramenti richiesti per la migrazione open source

Per ulteriori informazioni sui vantaggi di WinUI 3 e sulla roadmap di WinUI, vedere il Roadmap della libreria dell'interfaccia utente di Windows su GitHub.

Elenco di bug corretti in Anteprima 4

Di seguito è riportato un elenco di bug relativi agli utenti che il team ha corretto dall'anteprima 3. C'è stato anche molto lavoro in corso sulla stabilizzazione e sul miglioramento dei nostri test.

• Questa versione ha adottato una nuova versione di CS/WinRT e Windows SDK, che ha corretto i seguenti bug:
  • Arresto anomalo durante l'associazione a una proprietà URI utilizzando {Binding}
  • Le funzioni C#/WinRT Marshal non interagiscono correttamente con .NET 5
• WinUI 3 si arresta in modo anomalo durante l'esecuzione su Windows Insider Builds
  • Grazie a più contributori della community per aver segnalato questo bug su GitHub!
• WebView2 non applica la lingua/locale dell'app host a CoreWebView2Environment
• Il controllo DataGrid di Windows Community Toolkit arresta in modo anomalo l'app all'avvio/quando vengono visualizzate le barre di scorrimento
  • Grazie a più contributori della community per aver segnalato questo bug su GitHub!
• Il rendering della pagina va in cattivo stato quando cambia la modalità di visualizzazione
• Arresto anomalo durante l'utilizzo di Language ComboBox in CalendarView
• WinUI 3 Desktop: impossibile uscire da WebView2
• WinUI 3 Desktop: TreeView con TreeViewNodes derivati ​​si arresta in modo anomalo
• WinUI 3 Desktop: impossibile inserire testo in TextBox all'interno di ContentDialog
• WinUI 3 Desktop: ALT e F6 non funzionano
• Il vecchio SwapChainPanel rimosso viene visualizzato sopra il nuovo SwapChain
• WinUI 3 Desktop: impossibile scorrere con il trackpad
• Arresto anomalo durante l'utilizzo del controllo NavigationView con più finestre sullo stesso thread
• Problema di accessibilità: mostra lo stato attivo direttamente all'avvio dell'app desktop WinUI
• Violazione di accesso durante lo scorrimento in DataGrid
• WinUI 3 Desktop: il ciclo delle schede non funziona
• Trascina e rilascia su GridView non riesce nell'applicazione desktop con WinUI Xaml Islands
• Problema di accessibilità: impossibile scorrere con i tasti Pagina su/Pagina giù su WinUI 3 Desktop
• WebView2 ha dimensioni della finestra di visualizzazione errate
• Arresto anomalo di WebView2 al clic dopo l'apertura di MenuFlyout
• WinUI 3 Desktop: il tentativo di far cadere DropDownButton o il riquadro a comparsa di SplitButton provoca l'arresto anomalo dell'app
• WebView2: il doppio clic con il pulsante destro del mouse provoca un arresto anomalo
• Facendo clic su un ToggleSplitButton, l'applicazione si arresta in modo anomalo
• WinUI 3 Desktop: finestra vuota DesktopWindowXamlSource visibile sulla barra delle applicazioni
• WinUI 3 Desktop: DataGrid non visualizzato
• WinUI 3 Desktop: impossibile trascinare i file sulla griglia
• WinUI 3 Desktop: arresto anomalo di ItemsRepeater in WinUI 3 Preview 2
• AccessViolationException generata durante l'aggiornamento delle associazioni
• WinUI 3 Desktop: l'app si arresta in modo anomalo durante lo scorrimento NavigationView
• ItemsControl non viene aggiornato durante l'aggiunta o la rimozione dinamica di elementi nella sua raccolta ItemsSource.
• Compilare l'errore C2760 in App.xaml.gh se è abilitata la modalità di conformità C++

Limitazioni e problemi noti

La versione Preview 4 è semplicemente un'anteprima con bug, limitazioni e altri problemi con gli scenari relativi alle app desktop particolarmente nuovi.

Gli elementi seguenti sono alcuni dei problemi noti con WinUI 3 Preview 4.

Strumenti di sviluppo

• Sono supportate solo le app C# e C++/WinRT
• Le app desktop supportano .NET 5 e C# 9 e devono essere inserite in un pacchetto in un'app MSIX
• Le app UWP supportano .NET Native e C# 7.3
• Gli strumenti per sviluppatori e Intellisense potrebbero non funzionare correttamente in Visual Studio versione 16.8.
• Nessun supporto per la progettazione XAML
• Le nuove app C++/CX non sono supportate, tuttavia le tue app esistenti continueranno a funzionare (passa a C++/WinRT il prima possibile)
• Il supporto per più finestre nelle app desktop è in corso, ma non è ancora completo e stabile.
  • Segnala un bug nel nostro repository se trovi nuovi problemi o regressioni con comportamento multi-finestra.
• La distribuzione desktop senza pacchetto non è supportata
• Quando si esegue un'app desktop con F5, assicurarsi di eseguire il progetto di packaging. Premendo F5 sul progetto dell'app verrà eseguita un'app decompressa, che WinUI 3 non supporta ancora.

Funzionalità della piattaforma mancanti

• Supporto Xbox
• Supporto HoloLens
• Popup finestrati
  • Più in particolare, la ShouldConstrainToRootBounds la proprietà agisce sempre come se fosse impostata su true, indipendentemente dal valore dell'immobile.
• Supporto per l'inchiostrazione
• Acrilico
• MediaElement e MediaPlayerElement
• MapControl
• RenderTargetBitmap per SwapChainPanel e contenuto non XAML
• SwapChainPanel non supporta la trasparenza
• Global Reveal utilizza il comportamento di fallback, un pennello solido
• Isole XAML non è supportata in questa versione
• Le librerie dell'ecosistema di terze parti non funzioneranno completamente
• Gli IME non funzionano

Problemi noti

• Alt+F4 non chiude le finestre dell'app desktop.
• A causa di modifiche con CoreWindow, le seguenti API WinRT potrebbero non funzionare più con Desktop app come previsto:
  • ApplicationView e tutte le API correlate non funzioneranno più.
  • CoreApplicationView e tutte le API correlate non funzioneranno più.
  • Tutti GetForCurrentView Le API potrebbero non essere supportate, ad esempio CoreInputView.GetForCurrentView.
  • CoreWindow.GetForCurrentThread ora restituirà null.

  Per ulteriori informazioni sull'utilizzo delle API WinRT nell'app desktop WinUI 3, vedere API di Windows Runtime disponibili per le app desktop.

• Evento Windows.UI.ViewManagement.UISettings.ColorValuesChanged non è più supportato nelle app desktop. Ciò potrebbe causare problemi se lo utilizzi per rilevare le modifiche nei temi di Windows.
• Questa versione include alcune API sperimentali. Questi non sono stati testati a fondo dal team e potrebbero presentare problemi sconosciuti. Per favore segnalare un bug sul nostro repository in caso di problemi.
• In precedenza, per ottenere un'istanza di CompositionCapabilities si chiamava CompositionCapabilites.GetForCurrentView(). Tuttavia, le capacità restituite da questa chiamata lo erano non dipendente dalla vista. Per affrontare e riflettere questo, abbiamo eliminato la statica GetForCurrentView() in questa versione, quindi ora puoi creare un Capacità di composizione oggetto direttamente.
• Per le app UWP C#: il framework WinUI 3 è un set di componenti WinRT che possono essere usati da C++ (usando C++/WinRT) o C#. Quando si usa C#, sono disponibili due versioni di .NET, a seconda del modello dell'app: quando si usa WinUI 3 in un'app UWP si usa .NET Native; quando si utilizza in un'app desktop si utilizza .NET 5 (e C#/WinRT). Quando si utilizza C# per un'app WinUI 3 in UWP, esistono alcune differenze di spazio dei nomi API rispetto a C# in un'app desktop WinUI 3 o C# App WinUI 2: alcuni tipi sono in a Microsoft namespace piuttosto che a System spazio dei nomi. Ad esempio, piuttosto che il INotifyPropertyChanged interfaccia essendo nel System.ComponentModel namespace, è nel Microsoft.UI.Xaml.Data namespace. Ciò si applica a:
  • INotifyPropertyChanged (e relativi tipi)
  • INotifyCollectionChanged
  • ICommand

  I System le versioni dello spazio dei nomi esistono ancora, ma non possono essere utilizzate con WinUI 3. Ciò significa che ObservableCollection non funziona così com'è nelle app UWP WinUI 3 C#. Per una soluzione alternativa, vedere il Raccolte Interop campione nel  Esempio di raccolta di controlli XAML.

Cosa verrà dopo?

Gli sviluppatori possono dare un'occhiata ai dettagli di Microsoft roadmap delle funzionalità per vedere quando funzionalità specifiche verranno introdotte in WinUI 3.

Installa WinUI 3 Anteprima 4

WinUI 3 Preview 4 include modelli di progetto di Visual Studio per iniziare a creare app con un'interfaccia utente basata su WinUI e un pacchetto NuGet che contiene le librerie WinUI. Per installare WinUI 3 Preview 4, attenersi alla seguente procedura.

Toolkit della comunità di Windows

Se stai utilizzando Windows Community Toolkit, scarica l'ultima versione.

A parte il limiti e problemi noti, la creazione di un'app usando i progetti WinUI è simile alla creazione di un'app UWP con XAML e WinUI 2.x. Pertanto, la maggior parte del documentazione di orientamento per le app UWP e il Windows.UI Sono applicabili gli spazi dei nomi WinRT in Windows SDK.

Per ulteriori informazioni su come iniziare con i modelli di progetto WinUI, vedere gli articoli seguenti:

• Inizia con WinUI 3 per le app desktop
• Inizia con WinUI 3 per le app UWP

Presto sarà disponibile una documentazione di riferimento dell'API per questa versione, ma nel frattempo gli sviluppatori possono consultare la Documentazione di riferimento dell'API WinUI 3 per Preview 3.

Se hai creato un progetto utilizzando WinUI 3 Preview 3, puoi aggiornare il tuo progetto per utilizzare Preview 4. Vedi il Repository WinUI GitHub per le istruzioni dettagliate.

Per sfruttare le ultime funzionalità degli strumenti aggiunte in WinUI 3 Preview 4 come Hot Reload, Live Visual Tree e Live Property Explorer, è necessario utilizzare l'ultima versione di anteprima di Visual Studio con l'ultima anteprima di WinUI 3 e assicurarsi di abilitare Strumenti WinUI nelle funzionalità di anteprima di Visual Studio, come descritto in istruzioni qui.

Galleria controlli XAML (ramo WinUI 3 Preview 4)

Vedere la WinUI 3 Anteprima 4 ramo della Galleria dei controlli XAML per un'app di esempio che include tutti i controlli e le funzionalità di WinUI 3 Preview 4.

Esempio dell'app WinUI 3 Preview 4 XAML Controls Gallery

Questa versione di anteprima di WinUI 3 è pensata per una valutazione anticipata e per raccogliere feedback dalla comunità degli sviluppatori. Dovrebbe NON essere utilizzato per le app di produzione. Microsoft continuerà a distribuire versioni di anteprima di WinUI 3 nel 2021, seguite dalla prima versione ufficiale supportata a marzo 2021.

Si prega di utilizzare il repository GitHub WinUI per fornire feedback e registrare suggerimenti e problemi.