Come usare un file personalizzato per passare informazioni OEM (HTML)
[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]
Sviluppa un'app che utilizza un file personalizzato per passare informazioni dall'OEM all'app.
Nelle app che crei per la distribuzione OEM puoi utilizzare un file personalizzato per passare informazioni dall'OEM all'app. Per passare informazioni dall'OEM all'app devi creare un file Custom.data nella cartella microsoft.system.package.metadata. Questo nome di file ha un significato specifico per il sistema operativo e viene automaticamente conservato durante gli aggiornamenti del sistema operativo. Gli OEM possono utilizzare questo file per passare gli indentificatori dei clienti, in modo che le app sappiano quando sono state distribuite dagli OEM. Puoi avere un solo file Custom.data per app. Le app devono essere in grado di cercare e leggere questo file correttamente. I distributori trattano il file come dati non affidabili.
Cosa sapere
Tecnologie
Prerequisiti
- Hai bisogno dello strumento Gestione e manutenzione immagini distribuzione (DISM) per aggiungere il pacchetto dell'app con il file di dati personalizzato.
Istruzioni
Passaggio 1: Crea un file personalizzato e aggiungilo alla cartella di metadati del pacchetto
Puoi progettare la tua app affinché utilizzi qualsiasi formato scelto per i dati personalizzati. Ad esempio, puoi utilizzare XML, un file di testo oppure un altro tipo di file per organizzare i dati. Ti consigliamo di tenere in considerazione il modo in cui puoi testare e validare il file. Ad esempio, puoi creare uno schema XML per validare un file XML.
Puoi specificare qualsiasi tipo di file con qualunque nome di file per i dati personalizzati. Quando aggiungi il pacchetto dell'app con il file di dati personalizzato utilizzando lo strumento DISM, DISM rinomina in Custom.data il file personalizzato e lo salva nella cartella microsoft.system.package.metadata.
Nota Il file di dati personalizzato non può essere modificato dall'app. È una risorsa di sola lettura.
Passaggio 2: Accesso al file di dati personalizzato per un'app
Puoi accedere al file Custom.data per un'app dal tuo codice utilizzando le API di Windows per ottenere informazioni sul pacchetto corrente. Ad esempio:
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(
"microsoft.system.package.metadata\\custom.data")
Per maggiori informazioni sullo sviluppo con la proprietà Package.Current, vedi Guida introduttiva: Query sulle informazioni del manifesto del pacchetto app.
Per maggiori informazioni sull'accesso dai file custom.data attraverso IStorageFolder.GetFileAsync e sull'utilizzo di oggetti StorageFile, vedi Accesso a file e dati.
Argomenti correlati
Guida introduttiva: Query sulle informazioni del manifesto del pacchetto app