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
Sviluppo applicazioni x-plat con .NET MAUI
Usare gateway dedicati con Azure Cosmos DB per migliorare le prestazioni
Accesso sicuro ai secrets attraverso i file in Azure Container Apps
Creare moduli CSS in React
Sfruttare l'output cache di ASP.NET Core 7 con i controller
Configurare policy CORS in Azure Container Apps
Workflow di continuous deployment tramite pull request label in GitHub
Load test di ASP.NET Core con k6
Elencare le container images installate in un cluster di Kubernetes
Organizzare i moduli sfruttando CommonJS
.NET 7 Live Q&A
Definire la durata dell'output cache in ASP.NET Core 7
I più letti di oggi
- Usare un KeyedService di default in ASP.NET Core 8
- .NET Conference Italia 2023 - Milano e Online
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!
- Registrare servizi multipli tramite chiavi in ASP.NET Core 8
- Creare dei grafici con OWC
- Ottimizzare le prestazioni di ASP.NET Core con la Cache distribuita su SQL Server