La Universal Windows Platform introduce il concetto di "codice adattivo", ovvero la capacità che ha il nostro codice di determinare a runtime la presenza di eventi, classi e metodi in base al device o piattaforma su cui la nostra applicazione è in esecuzione.
Queste potenti funzionalità di feature detection possono essere sfruttate utilizzando i metodi statici esposti dalla classe ApiInformation contenuta nel namespace Windows.Foundation.Metadata.
Di seguito vediamo degli esempi di utilizzo di alcuni dei metodi esposti dalla classe ApiInformation.
Controllare la presenza di una classe
Per controllare l'esistenza di una classe è necessario utilizzare il metodo IsTypePresent che prende in input il fullname della classe di cui vogliamo verificare l'esistenza, e ha come output un booleano che indica il risultato della richiesta.
var type = typeof(Windows.Devices.Geolocation.Geolocator).FullName; if(Windows.Foundation.Metadata.ApiInformation.IsTypePresent(type)) { // Do stuff with Geolocator }
Controllare la presenza di un evento
Per verificare se un evento esiste o meno all'interno di una classe è necessario utilizzare il metodo IsEventPresent. Come nel caso precedente anche qua passiamo in input il fullname della classe, aggiungendo però come secondo parametro il nome dell'evento di cui vogliamo verificare l'esistenza.
var type = typeof(Windows.Devices.Geolocation.Geolocator).FullName; if(Windows.Foundation.Metadata.ApiInformation.IsEventPresent(type, "PositionChanged")) { // Subscribe to event }
Controllare l'esistenza di un metodo
Qualora volessimo controllare l'esistenza di un metodo ci è sufficiente utilizzare il metodo IsMethodPresent. Come nel caso precedente dobbiamo passare in input la classe da interrogare e il nome del metodo. La funzione IsMethodPresent, tuttavia, ha una particolarità che permette di individuare in maniera più puntuale il metodo che ci interessa, infatti tramite un overload è persino possibile specificare il numero di parametri che tale metodo dovrebbe avere.
var type = typeof(Windows.Devices.Geolocation.Geolocator).FullName; if (Windows.Foundation.Metadata.ApiInformation.IsMethodPresent(type,"GetGeopositionAsync")) { // Get method disregarding its number of parameters } var type = typeof(Windows.Devices.Geolocation.Geolocator).FullName; if (Windows.Foundation.Metadata.ApiInformation.IsMethodPresent(type, "GetGeopositionAsync", 2)) { // GetGeopositionAsync must have 2 input params }
Controllare la presenza di un ApiContract
Per ApiContract intendiamo un insieme di classi, interfacce, enumerazioni e strutture che sono logicamente raggruppate tra loro poiché, nel complesso, concorrono tutte a fornire un determinato tipo di funzionalità.
In Windows 10 ogni API fa parte di un Contract e la lista completa può essere consultata a questo indirizzo http://aspit.co/a63 . Per verificare l'esistenza di un particolare ApiContract utilizziamo il metodo IsApiContractPresent.
var type = typeof(Windows.Foundation.UniversalApiContract).FullName; if (Windows.Foundation.Metadata.ApiInformation.IsApiContractPresent(type, 1)) { // APIs available }
Anche questo metodo ha a disposizione due overload. Il primo (quello predefinito) prende come input il fullname dell'ApiContract e la major version del contratto. Il secondo, oltre ai due parametri precedentemente descritti, richiede anche la minor version. Questa granularità nel controllo ci permette di selezionare accuratamente il set di API a cui vogliamo far riferimento, evitandoci spiacevoli inconvenienti qualora, a seguito di una nuova major release dell'OS, le API da noi utilizzate dovessero subire dei cambiamenti.
Conclusioni
Nello script di questa settimana abbiamo descritto brevemente alcune delle funzionalità di feature detection disponibili nella Universal Windows Platform, mostrando come sia più immediato e semplice questo tipo di approccio rispetto a quello classico basato sulla versione del sistema operativo.
Per una lista di tutti i metodi esposti dalla classe ApiInformation possiamo fare riferimento alla documentazione ufficiale su MSDN alla pagina http://aspit.co/a64 .
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Migliorare la scalabilità delle Azure Function con il Flex Consumption
Ottimizzazione dei block template in Angular 17
Configurare il nome della run di un workflow di GitHub in base al contesto di esecuzione
Eseguire le GitHub Actions offline
Utilizzare il metodo CountBy di LINQ per semplificare raggruppamenti e i conteggi
Routing statico e PreRendering in una Blazor Web App
Supportare lo HierarchyID di Sql Server in Entity Framework 8
Implementare l'infinite scroll con QuickGrid in Blazor Server
Utilizzare il nuovo modello GPT-4o con Azure OpenAI
Filtrare i dati di una QuickGrid in Blazor con una drop down list
Testare l'invio dei messaggi con Event Hubs Data Explorer
Autenticarsi in modo sicuro su Azure tramite GitHub Actions