Compilazione di app per dispositivi UWP

Articolo
03/17/2023

I produttori di dispositivi possono creare un'app per dispositivi UWP che funge da complementare al dispositivo. Questo argomento descrive i componenti di un'app per dispositivi UWP, i passaggi di base per crearne uno e l'ordine in cui è necessario inviare i metadati dell'app e del dispositivo rispettivamente al dashboard di Microsoft Store e al dashboard hardware di Windows Dev Center. Per un'analisi più dettagliata di ogni passaggio, vedi Procedura dettagliata per la creazione di un'app per dispositivi UWP.

Blocchi predefiniti

Al livello più semplice, un'app per dispositivi UWP è un'app UWP associata a un dispositivo specifico tramite i metadati del dispositivo. Esistono quattro componenti per un'app per dispositivi UWP: un dispositivo, un'app, un pacchetto di metadati del dispositivo e un driver di dispositivo. Non è necessario usare i metadati del dispositivo per accedere a un dispositivo periferico usando le API del protocollo del dispositivo (USB, HID, Bluetooth GATT e Bluetooth RFCOMM). È tuttavia necessario usare i metadati del dispositivo per abilitare funzionalità speciali, ad esempio l'installazione automatica, AutoPlay e l'aggiornamento del dispositivo.

Componente	Descrizione
Dispositivo	Si tratta del dispositivo fisico. I dispositivi periferici sono esterni all'enclosure PC. I dispositivi interni sono dispositivi che risiedono all'interno o sono integrati con l'enclosure PC.
App	Un'app per dispositivi UWP è un'app UWP che fornisce un'esperienza utente personalizzata per il dispositivo, consentendo all'utente di accedere alle funzionalità esclusive del dispositivo. Un'app per dispositivi contiene un file denominato StoreManifest.xml che specifica l'ID esperienza. L'ID esperienza è un GUID che identifica in modo univoco un pacchetto di metadati del dispositivo.
Metadati dei dispositivi	Si tratta di una versione estesa di qualsiasi pacchetto di metadati del dispositivo già creato per Windows 7. In Windows 8.1 i metadati del dispositivo creano un collegamento tra il dispositivo e l'app. Tale collegamento viene identificato nell'ID esperienza. Oltre al contenuto dell'interfaccia utente per il PC (nome del modello localizzabile, descrizione e icone fotorealistica) il pacchetto di metadati del dispositivo specifica la configurazione autoPlay e quale app ha il privilegio di accedere al dispositivo. Windows scarica automaticamente i metadati del dispositivo dal servizio Internet metadati di Windows (WMIS).
Driver	Tutte le app per dispositivi UWP usano driver, indirettamente, per accedere ai dispositivi. Ad esempio, le API del protocollo di dispositivo Windows Runtime, introdotte in Windows 8.1, usano driver predefiniti per consentire alla tua app di comunicare tramite USB, HID e Bluetooth. Per altre info sui driver usati da queste API, vedi Passaggio 1: Creare un'app per dispositivi UWP.

Importante

L'accesso ai dispositivi che usano driver personalizzati richiede l'approvazione di Microsoft. Per altre info, vedi Guida alla progettazione di app per dispositivi UWP per dispositivi specializzati interni al PC.

Flusso di lavoro per lo sviluppo

Esistono sei passaggi per creare un'app per dispositivi UWP, presupponendo che il dispositivo sia già stato creato e inviato i driver necessari al dashboard hardware. Fare clic sui collegamenti per altri dettagli su ogni passaggio.

the device app development workflow.

Passaggio 1: Creare l'app. Associare l'app a Microsoft Store, sviluppare l'app e testarla.

Passaggio 2: Creare i metadati del dispositivo. Usare la Creazione guidata metadati dispositivo per associare l'app al dispositivo, creare un pacchetto di metadati del dispositivo e creare un file StoreManifest.xml (che specifica l'ID esperienza).

Passaggio 3: Aggiungere un ID esperienza all'app. Incorporare il file StoreManifest.xml nell'app.

Se l'app è un'app con privilegi e non è configurata per l'installazione automatica, il passaggio 3 non è obbligatorio.

Passaggio 4: Testare i metadati del dispositivo (localmente).Step 4: Test the device metadata (localmente). Usare la Creazione guidata metadati dispositivo per convalidare e distribuire i metadati del dispositivo nella workstation di sviluppo locale.

Passaggio 5: Inviare l'app al dashboard di Microsoft Store. Usa il dashboard per confermare i dettagli di vendita e indicare ai tester che l'app è un'app per dispositivi UWP.

Se l'app è un'app con privilegi e non è configurata per l'installazione automatica, è possibile inviare l'app al dashboard di Microsoft Store dopo il passaggio 6. Per altre info, vedi Sequenza di invio di app con privilegi.

Passaggio 6: Inviare i metadati del dispositivo al dashboard hardware di Windows Dev Center. Inviare manualmente i pacchetti di metadati del dispositivo o usare la Creazione guidata metadati dispositivo per creare un pacchetto di invio in blocco che è possibile inviare al dashboard hardware.

Sequenza di invio standard

La prima volta che invii i metadati dell'app e del dispositivo ai vari dashboard, gli eventi devono verificarsi in una sequenza specifica. La tabella seguente mostra anche quando inviare un driver di dispositivo, se applicabile.

Sequence	Descrizione	Prima di continuare...
1	Inviare il driver di dispositivo al dashboard hardware.	Attendere che il driver sia disponibile da Windows Update.
2	Inviare l'app al dashboard di Microsoft Store.	Attendere l'accettazione e fino a quando l'app non è attiva in Microsoft Store.
3	Inviare i metadati del dispositivo al dashboard hardware. L'app deve trovarsi in Microsoft Store prima che i metadati possano passare la convalida nel dashboard hardware.	Attendere 10 giorni per l'accettazione e la distribuzione.
4	Fine: gli utenti possono trarre vantaggio da tutte le funzionalità dell'app per dispositivi di Microsoft Store. Tieni presente che le funzionalità dell'app per dispositivi come l'installazione automatica, AutoPlay e l'aggiornamento del dispositivo non funzioneranno finché l'utente non ha i metadati del dispositivo e l'app nel PC. Se l'app richiede un driver non fornito da Microsoft, tale driver dovrà essere presente anche per il funzionamento dell'app.

Sequenza di invio di app con privilegi

In alcuni casi, le app per dispositivi UWP non devono essere attive in Microsoft Store prima di inviare i metadati del dispositivo. Quando l'app per dispositivi UWP:

Viene specificato come app con privilegi
Non è configurato per l'installazione automatica

Se questo vale per la tua app, puoi inviare i metadati del dispositivo al dashboard hardware prima di inviare l'app per dispositivi UWP al dashboard di Microsoft Store. In questi casi, non è necessario aggiungere l'ID esperienza all'app; specificare l'app come app con privilegi nei metadati del dispositivo è sufficiente per rendere effettive i privilegi.

Le app per dispositivi UWP per stampanti e fotocamere vengono installate automaticamente. Pertanto, questi tipi di app per dispositivi UWP devono seguire la sequenza di invio standard e essere inviati a Microsoft Store prima dell'invio dei metadati del dispositivo.

Limiti delle app per dispositivi UWP

I produttori di dispositivi sono limitati nel numero di app UWP che possono essere specificate nei metadati del dispositivo per l'installazione automatica e il privilegio dell'app. Ad esempio, i produttori di dispositivi periferici (IHD) possono inviare fino a un'app configurata per l'installazione automatica e fino a un'app specificata come app con privilegi. Un IHV può inviare un'app che soddisfi entrambe le limitazioni o due app, con ogni riunione solo una delle limitazioni.

Importante

Non esiste alcun limite al numero totale di app per dispositivi UWP che un produttore di dispositivi può inviare a Microsoft Store; questi limiti si applicano solo a un singolo pacchetto di metadati del dispositivo.

Gli operatori di telefonia mobile e gli OEM hanno limiti diversi per il numero di app che possono specificare nei metadati del dispositivo. Per altre info, gli OEM devono contattare il rappresentante OEM Microsoft.

In ogni pacchetto di metadati del dispositivo si applicano i limiti seguenti: