Freigeben über

Generieren von MSIX-Paketkomponenten

  • Artikel

In diesem Artikel wird gezeigt, wie Sie MSIX-Paketkomponenten zum Packen Ihrer Anwendung mithilfe von Befehlszeilentools (ohne Visual Studio oder msIX Packaging Tool) generieren.

Um Ihre App manuell zu verpacken, müssen Sie eine Paketmanifestdatei erstellen, die Paketkomponenten hinzufügen und dann das MakeAppx.exe Befehlszeilentool ausführen, um ein MSIX-Paket zu generieren.

Zuerst die Vorbereitung zum Verpacken

Falls Sie es noch nicht getan haben, lesen Sie diesen Abschnitt über was Sie wissen müssen, bevor Sie Ihre Anwendung verpacken.

Erstellen eines Paketmanifests

Erstellen Sie eine Datei, benennen Sie sie appxmanifest.xml, und fügen Sie ihr dann diesen XML-Code hinzu.

Es ist eine einfache Vorlage, die die Elemente und Attribute enthält, die Ihr Paket benötigt. Wir fügen diesen Werte im nächsten Abschnitt hinzu.

<?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>

Hinweis

Wenn Ihr Paket auf Systemen installiert wird, die älter als Windows 10, Version 2004 (10.0; Build 19041) sind, verwenden Sie das EntryPoint-Attribut anstelle von uap10:RuntimeBehavior und uap10:TrustLevel. Weitere Details und Beispiele siehe uap10 wurde in Windows 10, Version 2004 (10.0; Build 19041) eingeführt.

Füllen Sie die Elemente auf Paketebene ihrer Datei aus.

Füllen Sie diese Vorlage mit Informationen aus, die Ihr Paket beschreiben.

Identitätsinformationen

Hier ist ein Beispiel für ein Identity-Element mit Platzhaltertext für die Attribute. Sie können das ProcessorArchitecture Attribut auf x64 , x86 , arm (d. h. 32-Bit-ARM) festlegen, arm64 oder neutral

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

Hinweis

Wenn Sie Ihren Anwendungsnamen im Microsoft Store reserviert haben, können Sie den Namen und den Publisher mithilfe des Partner Centers abrufen. Wenn Sie beabsichtigen, Ihre Anwendung auf andere Systeme querzuladen, können Sie ihre eigenen Namen für diese angeben, solange der von Ihnen ausgewählte Herausgebername mit dem Namen des Zertifikats übereinstimmt, das Sie zum Signieren Ihrer App verwenden.

Eigenschaften

Das Properties-Element verfügt über 3 erforderliche untergeordnete Elemente. Hier ist ein Beispiel für einen Eigenschaftenknoten mit Platzhaltertext für die Elemente. Der DisplayName ist der Name Ihrer Anwendung, die Sie im Store reservieren, für Apps, die in den Store hochgeladen werden.

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

Ressourcen

Hier ist ein Beispiel für einen Ressourcen-Knoten.

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

Abhängigkeiten

Legen Sie für Desktop-Apps, für die Sie ein Paket erstellen, immer das Name Attribut auf Windows.Desktop.

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

Fähigkeiten

Für ein Paket, das mindestens eine voll vertrauenswürdige App enthält, müssen Sie die runFullTrust eingeschränkte Funktion wie unten dargestellt deklarieren. Für vollständige Details und eine Definition der voll vertrauenswürdigen App suchen Sie in App-Funktionsdeklarationen nach der Berechtigungsstufe "Voll vertrauenswürdig".

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

Ausfüllen der Elemente auf Anwendungsebene

Füllen Sie diese Vorlage mit Informationen aus, die Ihre App beschreiben.

Anwendungselement

Konfigurieren Sie für Desktop-Apps, für die Sie ein Paket erstellen, das Application-Element wie folgt:

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

Hinweis

Wenn Ihr Paket auf Systemen installiert wird, die älter als Windows 10, Version 2004 (10.0; Build 19041) sind, verwenden Sie das EntryPoint-Attribut anstelle von uap10:RuntimeBehavior und uap10:TrustLevel. Weitere Details und Beispiele finden Sie unter uap10 wurde in Windows 10, Version 2004 (10.0; Build 19041) eingeführt.

Visuelle Elemente

Hier ist ein Beispiel für einen VisualElements-Knoten .

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

(Optional) Zielbasierte Ressourcen ohne Anpassung hinzufügen

Zielbasierte Ressourcen gelten für Symbole und Kacheln, die in der Windows-Taskleiste, in der Aufgabenansicht, über ALT+TAB, in der Andockhilfe und in der unteren rechten Ecke von Startkacheln angezeigt werden. Weitere Informationen dazu finden Sie hier.

  1. Rufen Sie die richtigen 44 x 44 Bilder ab, und kopieren Sie sie dann in den Ordner, der Ihre Bilder enthält (d. h. Assets).

  2. Erstellen Sie für jedes 44x44-Bild eine Kopie im selben Ordner, und fügen Sie .targetsize-44_altform-unplated an den Dateinamen an. Sie sollten über zwei Kopien jedes Symbols verfügen, die jeweils auf eine bestimmte Weise benannt sind. Nach Abschluss des Vorgangs kann Ihr Assets-Ordner z. B. MYAPP_44x44.png und MYAPP_44x44.targetsize-44_altform-unplated.png enthalten.

    Hinweis

    In diesem Beispiel ist das Symbol mit dem Namen MYAPP_44x44.png das Symbol, auf das Sie im Square44x44Logo Logo-Attribut Ihres MSIX-Pakets verweisen.

  3. Legen Sie in der Manifestdatei das BackgroundColor Symbol für jedes Symbol fest, das Sie transparent machen.

  4. Fahren Sie mit dem nächsten Unterabschnitt fort, um eine neue Paketressourcenindexdatei zu generieren.

Generieren einer PRI-Datei (Package Resource Index) mithilfe von MakePri

Wenn Sie zielbasierte Ressourcen erstellen, wie im obigen Abschnitt beschrieben, oder Sie die visuellen Ressourcen Ihrer Anwendung ändern, nachdem Sie das Paket erstellt haben, müssen Sie eine neue PRI-Datei generieren.

Basierend auf Ihrem Installationspfad des SDK befindet sich MakePri.exe auf Ihrem Windows-PC:

  • x86: C:\Programme (x86)\Windows Kits\10\bin\<buildnummer>\x86\makepri.exe
  • x64: C:\Programme (x86)\Windows Kits\10\bin\<buildnummer>\x64\makepri.exe

Es gibt keine ARM-Version dieses Tools.

  1. Öffnen Sie ein Eingabeaufforderungs- oder PowerShell-Fenster.

  2. Ändern Sie das Verzeichnis in den Stammordner des Pakets, und erstellen Sie dann eine priconfig.xml Datei, indem Sie den Befehl <path>\makepri.exe createconfig /cf priconfig.xml /dq en-USausführen.

  3. Erstellen Sie die "resources.pri"-Datei(n) mithilfe des Befehls <path>\makepri.exe new /pr <PHYSICAL_PATH_TO_FOLDER> /cf <PHYSICAL_PATH_TO_FOLDER>\priconfig.xml.

    Der Befehl für Ihre Anwendung könnte z. B. wie folgt aussehen: <path>\makepri.exe new /pr c:\MYAPP /cf c:\MYAPP\priconfig.xml.

  4. Packen Sie Ihre Anwendung mithilfe der Anweisungen im nächsten Schritt.

Testen Der Anwendung vor dem Verpacken

Sie können Ihre entpackte Anwendung bereitstellen und vor dem Packen oder Signieren testen. Führen Sie dazu das folgende Cmdlet aus einem PowerShell-Fenster aus. Stellen Sie sicher, dass Sie die Manifestdatei Ihrer Anwendung, die sich im Stammverzeichnis Ihres Paketverzeichnisses befindet, zusammen mit allen anderen Paketkomponenten übergeben:

Add-AppxPackage –Register AppxManifest.xml

Sobald dies erledigt ist. Ihre App sollte auf dem System bereitgestellt werden, und Sie können sie testen, um sicherzustellen, dass alles vor dem Verpacken funktioniert. Um die .exe- oder .dll Dateien Ihrer App zu aktualisieren, ersetzen Sie die vorhandenen Dateien in Ihrem Paket durch die neuen, erhöhen Sie die Versionsnummer in AppxManifest.xml, und führen Sie dann den obigen Befehl erneut aus.

Verpacken Sie Ihre Komponenten in ein MSIX

Der nächste Schritt besteht darin, MakeAppx.exe zum Generieren eines MSIX-Pakets für Ihre Anwendung zu verwenden. Makeappx.exe ist im Windows SDK enthalten, und wenn Sie Visual Studio installiert haben, kann über die Entwickler-Eingabeaufforderung für Visual Studio problemlos darauf zugegriffen werden.

Siehe Erstellen eines MSIX-Pakets oder -Bündels mit dem tool MakeAppx.exe

Hinweis

Eine verpackte Anwendung wird immer als interaktiver Benutzer ausgeführt, und jedes Laufwerk, auf dem Sie Ihre verpackte Anwendung installieren, muss im NTFS-Format formatiert sein.