Condividi tramite

Generazione di componenti del pacchetto MSIX

Questo articolo illustra come generare componenti del pacchetto MSIX per la creazione di pacchetti dell'applicazione tramite strumenti da riga di comando (senza usare Visual Studio o MSIX Packaging Tool).

Per creare manualmente un pacchetto dell'app, è necessario creare un file manifesto del pacchetto, aggiungere i componenti del pacchetto e quindi eseguire lo strumento da riga di comando MakeAppx.exe per generare un pacchetto MSIX.

Per prima cosa, prepararsi per l'imballaggio.

Se non lo hai ancora fatto, esamina questa sezione su ciò che è necessario conoscere prima di preparare il pacchetto dell'applicazione.

Creare un manifesto del pacchetto

Creare un file, denominarlo appxmanifest.xmle quindi aggiungerlo al file XML.

Si tratta di un modello di base che contiene gli elementi e gli attributi necessari per il pacchetto. I valori verranno aggiunti a questi nella sezione successiva.

<?xml version="1.0" encoding="utf-8"?>
<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap10="http://schemas.microsoft.com/appx/manifest/uap/windows10/10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities">
  <Identity Name="" Version="" Publisher="" ProcessorArchitecture="" />
  <Properties>
    <DisplayName></DisplayName>
    <PublisherDisplayName></PublisherDisplayName>
    <Description></Description>
    <Logo></Logo>
  </Properties>
  <Resources>
    <Resource Language="" />
  </Resources>
  <Dependencies>
    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="" MaxVersionTested="" />
  </Dependencies>
  <Capabilities>
    <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application Id="" Executable=""
      uap10:RuntimeBehavior="packagedClassicApp"
      uap10:TrustLevel="mediumIL">
      <uap:VisualElements DisplayName="" Description=""	Square150x150Logo=""
        Square44x44Logo="" BackgroundColor="" />
    </Application>
  </Applications>
</Package>

Annotazioni

Se il pacchetto viene installato nei sistemi precedenti a Windows 10 versione 2004 (10.0; Build 19041), quindi usare l'attributo EntryPoint anziché uap10:RuntimeBehavior e uap10:TrustLevel. Per altri dettagli ed esempi, vedi uap10 è stato introdotto in Windows 10 versione 2004 (10.0; Build 19041).

Compilare gli elementi a livello di pacchetto del file

Compilare questo modello con informazioni che descrivono il pacchetto.

Informazioni sull'identità

Ecco un esempio di elemento Identity con testo segnaposto per gli attributi. È possibile impostare l'attributo ProcessorArchitecture su x64 , x86 , arm (ad esempio arm a 32 bit), arm64 o neutral

<Identity Name="MyCompany.MySuite.MyApp"
          Version="1.0.0.0"
          Publisher="CN=MyCompany, O=MyCompany, L=MyCity, S=MyState, C=MyCountry"
			    ProcessorArchitecture="x64">

Annotazioni

Se hai riservato il nome dell'applicazione in Microsoft Store, puoi ottenere il nome e il server di pubblicazione usando il Centro per i partner. Se si prevede di trasferire localmente l'applicazione in altri sistemi, è possibile specificare nomi personalizzati per questi, purché il nome dell'editore scelto corrisponda al nome del certificato usato per firmare l'app.

Proprietà

L'elemento Properties dispone di 3 elementi figlio obbligatori. Di seguito è riportato un esempio di nodo Proprietà con testo segnaposto per gli elementi. DisplayName è il nome della tua applicazione che riservi nello Store per le app caricate.

<Properties>
  <DisplayName>MyApp</DisplayName>
  <PublisherDisplayName>MyCompany</PublisherDisplayName>
  <Logo>images\icon.png</Logo>
</Properties>

Risorse

Di seguito è riportato un esempio di nodo Risorse .

<Resources>
  <Resource Language="en-us" />
</Resources>

Dipendenze

Per le app desktop per cui si crea un pacchetto, impostare sempre l'attributo Name su Windows.Desktop.

<Dependencies>
<TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.14316.0" MaxVersionTested="10.0.15063.0" />
</Dependencies>

Capacità

Per un pacchetto che contiene una o più app con attendibilità totale, è necessario dichiarare la runFullTrust funzionalità con restrizioni, come illustrato di seguito. Per informazioni dettagliate e una definizione dell'app "full-trust", cercare "Full Trust Permission Level" (Livello di autorizzazione di attendibilità completa) nelle dichiarazioni di funzionalità dell'app.

<Capabilities>
  <rescap:Capability Name="runFullTrust"/>
</Capabilities>

Compilare gli elementi a livello di applicazione

Compilare questo modello con informazioni che descrivono l'app.

Elemento dell'applicazione

Per le app desktop per cui si crea un pacchetto, configurare l'elemento Application come segue:

<Applications>
  <Application Id="MyApp" Executable="MyApp.exe"
		 uap10:RuntimeBehavior="packagedClassicApp"
     uap10:TrustLevel="mediumIL">
   </Application>
</Applications>

Annotazioni

Se il pacchetto viene installato nei sistemi precedenti a Windows 10 versione 2004 (10.0; Build 19041), quindi usare l'attributo EntryPoint anziché uap10:RuntimeBehavior e uap10:TrustLevel. Per altri dettagli ed esempi, vedi uap10 è stato introdotto in Windows 10 versione 2004 (10.0; Build 19041).

Elementi visivi

Ecco un esempio di nodo VisualElements .

<uap:VisualElements
	BackgroundColor="#464646"
	DisplayName="My App"
	Square150x150Logo="images\icon.png"
	Square44x44Logo="images\small_icon.png"
	Description="A useful description" />

(Facoltativo) Aggiungere asset senza placcatura basati sulla destinazione

Gli asset basati sulla destinazione sono destinati a icone e riquadri visualizzati nella barra delle applicazioni di Windows, nella visualizzazione attività, ALT+TAB, snap-assist e nell'angolo inferiore destro dei riquadri Start. Altre informazioni sono disponibili qui.

  1. Ottenere le immagini 44x44 corrette e quindi copiarle nella cartella che contiene le immagini (ad esempio Asset).

  2. Per ogni immagine 44x44, creare una copia nella stessa cartella e aggiungere .targetsize-44_altform-unplated al nome del file. È necessario avere due copie di ogni icona, ognuna denominata in modo specifico. Ad esempio, dopo aver completato il processo, la cartella assets potrebbe contenere MYAPP_44x44.png e MYAPP_44x44.targetsize-44_altform-unplated.png.

    Annotazioni

    In questo esempio, l'icona denominata MYAPP_44x44.png è l'icona a cui si farà riferimento nell'attributo Square44x44Logo logo del pacchetto MSIX.

  3. Nel file manifesto, impostare il BackgroundColor per rendere trasparenti tutte le icone.

  4. Passare alla sottosezione successiva per generare un nuovo file dell'indice di risorse del pacchetto.

Generare un file PRI (Package Resource Index) usando MakePri

Se si creano asset basati su destinazione come descritto nella sezione precedente o si modifica uno degli asset visivi dell'applicazione dopo aver creato il pacchetto, sarà necessario generare un nuovo file PRI.

In base al percorso di installazione dell'SDK, questo è il percorso in cui MakePri.exe si trova nel PC Windows:

  • x86: C:\Programmi (x86)\Windows Kits\10\bin\<numero di versione>\x86\makepri.exe
  • x64: C:\Programmi (x86)\Windows Kits\10\bin\<numero> di build\x64\makepri.exe

Non esiste alcuna versione arm di questo strumento.

  1. Aprire un prompt dei comandi o una finestra di PowerShell.

  2. Passare alla cartella radice del pacchetto e quindi creare un file priconfig.xml eseguendo il comando <path>\makepri.exe createconfig /cf priconfig.xml /dq en-US.

  3. Creare i file resources.pri usando il comando <path>\makepri.exe new /pr <PHYSICAL_PATH_TO_FOLDER> /cf <PHYSICAL_PATH_TO_FOLDER>\priconfig.xml.

    Ad esempio, il comando per l'applicazione potrebbe essere simile al seguente: <path>\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml.

  4. Creare un pacchetto dell'applicazione usando le istruzioni nel passaggio successivo.

Testare l'applicazione prima del confezionamento

È possibile distribuire l'applicazione non in pacchetto e testarla prima di creare pacchetti o firmare. A tale scopo, eseguire il cmdlet seguente da una finestra di PowerShell. Assicurati di passare il file manifest dell'applicazione che si trova nella radice della directory del pacchetto, insieme a tutti gli altri componenti del pacchetto.

Add-AppxPackage –Register AppxManifest.xml

Una volta completata questa operazione. L'app andrebbe distribuita sul sistema ed è possibile testarla per assicurarsi che tutto funzioni prima del confezionamento. Per aggiornare i file .exe o .dll dell'app, sostituire i file esistenti nel pacchetto con quelli nuovi, aumentare il numero di versione in AppxManifest.xmle quindi eseguire di nuovo il comando precedente.

Creare un pacchetto con i tuoi componenti in un MSIX

Il passaggio successivo consiste nell'usare MakeAppx.exe per generare un pacchetto MSIX per l'applicazione. Makeappx.exe è incluso in Windows SDK e, se è installato Visual Studio, è possibile accedervi facilmente tramite il prompt dei comandi per gli sviluppatori per Visual Studio.

Vedere Creare un pacchetto MSIX o un bundle con lo strumento di MakeAppx.exe

Annotazioni

Un'applicazione in pacchetto viene sempre eseguita come utente interattivo e qualsiasi unità in cui si installa l'applicazione in pacchetto deve essere formattata in formato NTFS.