Piattaforma predefinita per le app di Windows

Questo articolo fornisce informazioni per gli sviluppatori di app di Windows su come eseguire l'integrazione con la piattaforma app predefinita in Windows e su come indirizzare gli utenti a modificare le impostazioni predefinite delle app in Windows 11.

La piattaforma predefinita dell'app consente agli sviluppatori di registrare le proprie app per supportare i tipi di file e di collegamento in Windows in supporto di due scenari principali:

• Consentire agli utenti di specificare le app usate da Windows per aprire tipi di file o tipi di collegamento specifici usando l'esperienza utente delle app predefinite in Impostazioni.
• Consentire agli sviluppatori di facilitare l'avvio da app a app richiamando un file o un tipo di collegamento.

Esperienza dell'app predefinita per gli utenti finali

Windows 11 consente agli utenti di modificare le app predefinite tramite Impostazioni di Windows e altre interfacce utente di sistema.

• Windows richiederà automaticamente all'utente quando apre un file o un tipo di collegamento quando viene installata una nuova app registrata per tale file o tipo di collegamento.
• Le app possono anche indirizzare l'utente a Impostazioni per modificare le impostazioni predefinite dell'app, guidando gli utenti attraverso questo processo usando richieste o documentazione in-app.

Impostazioni predefinite dell'app per sviluppatori di app

La tua app può registrarsi per diventare il gestore predefinito per un file e i tipi di collegamento. Sia le applicazioni desktop di Windows che le app WinUI possono essere registrate come gestore predefinito. Se l'utente sceglie l'app come gestore predefinito, Windows attiverà l'app quando viene richiamato quel tipo di file o collegamento.

Linee guida migliori per la piattaforma delle applicazioni predefinite per gli sviluppatori

• Usa l'URI ms-settings:defaultapps per avviare direttamente la pagina Impostazioni app predefinite o la pagina dell'app all'interno di App predefinite. Per altre informazioni, vedere Avviare la pagina Impostazioni app predefinite.
• Invitare gli utenti in modo ponderato. Utilizza messaggi contestuali quando l'app apre un tipo di file supportato, ma non è predefinito.
• Fornire istruzioni chiare: includere screenshot o guide dettagliate nell'app o nel sito di supporto.
• Rispetta la scelta dell'utente: evitare richieste aggressive o notifiche ripetute.
• Registrarsi per un tipo solo se si prevede di dover gestire tutti i lanci per quel tipo. Ad esempio, se l'app deve usare solo il tipo di file internamente, non è necessario eseguire la registrazione per essere il gestore predefinito. Se scegli di eseguire la registrazione per un tipo, devi fornire all'utente finale la funzionalità prevista quando l'app viene attivata per quel tipo.

Usare i tipi di collegamento predefiniti dell'app per eseguire avvii tra app

Le app possono essere consegnate a un'altra app, chiamando Launcher.LaunchUriAsync , ad esempio, per indicare a Windows di avviare l'app predefinita configurata dall'utente per il tipo di collegamento specificato.

Le applicazioni possono indirizzare Windows a utilizzare le impostazioni predefinite configurate dall'utente richiamando uno schema URI noto, ad esempio https:.

Le app possono scegliere in modo esplicito un'altra app da avviare se conoscono il tipo di collegamento registrato nella piattaforma predefinita dell'app, ad esempio ms-settings:.

Gli schemi URI possono essere uno standard ufficiale, documentato pubblicamente o proprietario. Ad esempio:

• https: è documentato come schema permanente da Internet Assigned Numbers Authority come RFC8615.
• Spotify documenta pubblicamente uno spotify: schema, vedi GLI URI e gli ID di Spotify.
• Altri schemi possono essere proprietari e creerebbero un'esperienza end-to-end compromessa per l'utente se un'app esegue la registrazione ed è impostata come predefinita per uno schema URI che non è in grado di implementare.

Eseguire la registrazione per i tipi di file e collegamento

Tutte le app possono partecipare alla piattaforma predefinita dell'app registrando i tipi supportati. Le app in pacchetto possono usare l'elemento uap:FileTypeAssociation nel file dello schema del manifesto del pacchetto dell'app per dichiarare i tipi di file supportati. Altri meccanismi di associazione file sono supportati per le app non in pacchetto. Per altre informazioni, vedere Tipi di file e associazioni di file e linee guida per associazioni di file e programmi predefiniti.

Gestire l'attivazione

Quando viene avviata un'app di Windows, Windows fornisce informazioni all'app che consente di determinare che è stata avviata da un'associazione di file o una chiamata al tipo di collegamento. Per altre informazioni, vedere Gestire l'attivazione dei file in un'app di Windows e Gestire l'attivazione URI con un'app di Windows.

Considerazioni sulla sicurezza per la piattaforma predefinita dell'app

Per proteggere le scelte predefinite dell'app degli utenti dalla modifica delle impostazioni da malware senza che l'utente sia a conoscenza, Windows richiede che le impostazioni predefinite dell'app siano impostate tramite l'interfaccia utente di sistema di Windows.

• Windows non consente modifiche a livello di codice alle app predefinite senza l'interazione dell'utente nell'interfaccia utente di sistema. Per altre informazioni, vedere Impostazioni predefinite delle app negli ambienti gestiti
• I dati delle impostazioni utente per le impostazioni predefinite dell'app vengono offuscati negli archivi dati del Registro di sistema. Le modifiche basate sul Registro di sistema non sono supportate per le app.
• I dati delle impostazioni utente per le impostazioni predefinite dell'app sono protetti da un driver di filtro di Windows (UCPD.sys) che impedisce alle app di scrivere i dati predefiniti dell'app.
• Le app possono interrogare quale app è l'impostazione predefinita per un tipo specifico. Per altre informazioni, vedere IApplicationAssociationRegistration::QueryCurrentDefault.
• Le app distribuite da Microsoft Store devono rispettare i criteri di Microsoft Store, in particolare la sezione 10.2.8 che richiede che le app usino solo metodi supportati per aggiornare le impostazioni di Windows, incluse le impostazioni predefinite dell'app.

Impostazioni predefinite delle app negli ambienti gestiti

In un PC gestito gli amministratori IT possono controllare le impostazioni predefinite delle app tramite i criteri. La piattaforma predefinita dell'app fornisce criteri di gruppo e di Gestione dei Dispositivi Mobili (MDM) per facilitare questi scenari di gestione. Questi criteri funzionano anche con i profili utente mobili per supportare ambienti più complessi. Le soluzioni che non usano questi criteri potrebbero non funzionare correttamente a causa delle considerazioni sulla sicurezza indicate in precedenza. Per altre informazioni, vedere ApplicationDefaults Policy CSP (Provider di servizi di configurazione dei criteri applicationdefaults) e Deploy roaming user profiles (Distribuire profili utente mobili)