Condividi tramite

App di Windows 8.1 Store: Specificare le risorse predefinite installate in un dispositivo

  • Articolo

 

Si applica a Windows e Windows Phone

Quando un utente installa un'app, il sistema operativo del dispositivo tenta di identificare e installare varie risorse dell'app, ad esempio le stringhe dell'interfaccia utente e immagini nella risoluzione specifica, appropriate per il dispositivo in cui viene installata l'app. Ad esempio, è possibile che un'app contenga stringhe in spagnolo che possono essere installate nei dispositivi impostati su impostazioni locali appropriate. Tuttavia, l'app potrebbe non avere risorse appropriate per tutti i dispositivi e le impostazioni locali a disposizione degli utenti. In questi casi, per impostazione predefinita il sistema operativo del dispositivo dell'utente installa le risorse appropriate per il computer di sviluppo, le relative impostazioni locali e altre impostazioni. Se desideri che nel dispositivo vengano installate altre risorse, puoi specificarle aggiungendo un file di configurazione. In alternativa, se lo preferisci, puoi modificare direttamente il file di progetto.

Opzione 1: Aggiungere un file di configurazione alla soluzione

  1. In Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto dell'app, scegli Aggiungi, quindi Nuovo elemento.

  2. Nella finestra di dialogo Aggiungi nuovo elemento fai clic su File XML, assegna al file il nome priconfig.default.xml, quindi fai clic su Aggiungi.

  3. Sostituisci il contenuto del file con il codice XML riportato di seguito.

    <default>
  <qualifier name="Language" value=Value />
  <qualifier name="Contrast" value=Value />
  <qualifier name="Scale" value=Value />
  <qualifier name="HomeRegion" value=Value />
  <qualifier name="TargetSize" value=Value />
  <qualifier name="LayoutDirection" value=Value />
  <qualifier name="DXFeatureLevel" value=Value />
  <qualifier name="Configuration" value=Value />
  <qualifier name="AlternateForm" value=Value />
</default>

    Nel passaggio successivo sostituirai i segnaposto Value con qualificatori delle risorse validi. Vedi Procedura: Come assegnare nomi alle risorse con i qualificatori (App dello Store scritte in C#/VB/C++ e XAML) o Procedura: Come assegnare nomi alle risorse con i qualificatori (app dello Store scritte in JavaScript e HTML).

  4. Sostituisci ogni segnaposto Value con un qualificatore delle risorse valido.

    Nell'esempio seguente viene illustrato l'aspetto del codice XML dopo la sostituzione dei segnaposto Value con qualificatori delle risorse validi.

    <default>
  <qualifier name="Language" value="en-us" />
  <qualifier name="Contrast" value="standard" />
  <qualifier name="Scale" value="120" />
  <qualifier name="HomeRegion" value="001" />
  <qualifier name="TargetSize" value="256" />
  <qualifier name="LayoutDirection" value="LTR" />
  <qualifier name="DXFeatureLevel" value="DX9" />
  <qualifier name="Configuration" value="" />
  <qualifier name="AlternateForm" value="" />
</default>

  5. Salva e chiudi il file priconfig.default.xml.

  6. In Esplora soluzioni fai clic sul file priconfig.default.xml.

  7. Nella finestra Proprietà modifica i valori delle proprietà seguenti in base al linguaggio del progetto.

    • Per i progetti in C# e VB imposta la proprietà Azione di compilazione su Nessuna.

    • Per i progetti in JavaScript imposta la proprietà Azione pacchetto su Nessuna.

    • Per i progetti in C++ imposta la proprietà Contenuto su False.

  8. Scegli Compila soluzione dal menu Compila.

  9. Nella cartella ProjectFolder**\obj\**ReleaseConfiguration apri il file priconfig.xml in Blocco note.

  10. Verifica che i qualificatori aggiunti siano presenti nel file.

Ridenominazione del file default.xml

Puoi assegnare qualsiasi nome al file di configurazione. Se assegni un nome diverso da priconfig.default xml, tuttavia, devi aggiungere una proprietà di compilazione al file di progetto.

  1. In Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto dell'app, quindi fai clic su Scarica progetto.

  2. Fai nuovamente clic con il pulsante destro del mouse sul progetto, quindi scegli ModificaNomeApp**.csproj** o ModificaNomeApp**.vbproj**.

  3. Nel file di progetto aggiungi la riga seguente di codice XML tra i tag di apertura e chiusura del primo elemento <PropertyGroup>.

    <AppxPriConfigXmlDefaultSnippetPath>FilePath</AppxPriConfigXmlDefaultSnippetPath>

    Importante

    Sostituisci FilePath con il percorso del file di configurazione, incluso il nome del file.

  4. Salva e chiudi il file di progetto.

  5. In Esplora soluzioni fai clic con il pulsante destro del mouse sul progetto, fai clic su Ricarica progetto, quindi compila la soluzione.

Opzione 2: Modificare il file di progetto (avanzata)

  1. Apri il file di progetto dell'app nel Blocco note.

  2. Nel file di progetto aggiungi la riga seguente di codice XML tra i tag di apertura e chiusura del primo elemento <PropertyGroup>. Questo codice XML identifica le risorse che il sistema operativo del dispositivo installerà se l'app non dispone delle risorse appropriate per particolari dispositivi, impostazioni locali o altre impostazioni.

    <AppxDefaultResourceQualifiers>Language=ValueContrast=Value|Scale=Value|HomeRegion=Value|TargetSize=Value|
     LayoutDirection=Value|DXFeatureLevel=Value|Configuration=Value|AlternateForm=Value</AppxDefaultResourceQualifiers>

    Nel passaggio successivo sostituirai i segnaposto Value con qualificatori delle risorse validi. Ad esempio, imposterai il qualificatore Language sul moniker {DefaultResourceLanguage}. Quando crei il pacchetto dell'app, Visual Studio sostituisce il moniker con il valore della proprietà Lingua predefinita che puoi impostare nella scheda Applicazione della finestra di progettazione del manifesto. In alternativa, puoi impostare il qualificatore della lingua su un valore specifico delle impostazioni locali, ad esempio en-us. Vedi Procedura: Come assegnare nomi alle risorse con i qualificatori (App dello Store scritte in C#/VB/C++ e XAML) o Procedura: Come assegnare nomi alle risorse con i qualificatori (app dello Store scritte in JavaScript e HTML).

  3. Sostituisci ogni segnaposto Value con un qualificatore delle risorse valido.

    Nell'esempio seguente viene illustrato l'aspetto del codice XML dopo la sostituzione dei segnaposto Value con qualificatori delle risorse validi.

    <AppxDefaultResourceQualifiers>Language={DefaultResourceLanguage}|Contrast=high|Scale=140|HomeRegion=419|TargetSize=256|
     LayoutDirection=LTR|DXFeatureLevel=DX10|Configuration=|AlternateForm=altform-msft-phonetic</AppxDefaultResourceQualifiers>

  4. Salva e chiudi il file di progetto. A questo punto, ricarica il file di progetto in Visual Studio.

  5. Compila la soluzione.

  6. Nella cartella ProjectFolder**\obj\**ReleaseConfiguration apri il file priconfig.xml in Blocco note.

  7. Verifica che i qualificatori aggiunti siano presenti nel file.

Vedere anche

Definizione delle risorse delle app (app che usano C#/VB/C++ e XAML)
Definizione delle risorse delle app (app che usano JavaScript e HTML)
App di Windows 8.1 Store: Assicurarsi che le risorse siano installate in un dispositivo indipendentemente dal fatto che il dispositivo le richieda
Bundle dell’app
Come decidere se generare un bundle di app
Pacchetti di risorse
Sistema gestione risorse