Använda sammansättningar sida vid sida

Använd följande procedur för att utveckla ett nytt program, eller uppdatera ett befintligt program, för att använda sida vid sida-sammansättningar tillgängliga från Microsoft eller andra sida vid sida-sammansättningsutgivare. En lista över de sida-vid-sida-sammansättningar som för närvarande tillhandahålls av Microsoft finns i Microsoft sida vid sida-sammansättningar som stöds. Observera att programmet måste köras på åtminstone Windows XP för att installera sammansättningarna som parallell-sammansättningar. Mer information finns i riktlinjer för att skapa sammansättningar sida vid sida.

Om du vill lägga till en sida vid sida-sammansättning i ett program

1. Identifiera de sammansättningar sida vid sida som krävs för ditt program. Från och med Windows XP installeras dessa sida vid sida-sammansättningar och deras sammansättningsmanifest med operativsystemet men är inte globalt registrerade.

2. Använd en XML-redigerare för att skapa ett programmanifest. Se exempelprogrammanifestet nedan. För mer information, se Application Manifests i Manifestfiler-referens.

3. Ange attributvärden i DEF-kontextsammansättningIdentitet underelement i programmanifestet som unikt definierar programmet. Mer information om DEF-kontexten assemblyIdentityfinns i Application Manifests.

4. Om assemblyn innehåller några beroende assemblies, ange attributvärden i motsvarande REF-context assemblyIdentity underelementen i applikationsmanifestet. Mer information om referenskontexten assemblyIdentityfinns i Application Manifests.

   <dependentAssembly>
     <assemblyIdentity type="win32"
                       name="Microsoft.Windows.SampleAssembly"
                       version="6.0.0.0" processorArchitecture="x86"
                       publicKeyToken="a5aaf5ba15723d5"/>
   

5. Du kan inkludera programmanifestet i programmets binära körbara huvudfil.

   I det här fallet lägger du även till följande rad i programhuvudfilen:

   CREATEPROCESS\_MANIFEST\_RESOURCE\_ID RT\_MANIFEST "YourApp.exe.manifest"

   Alternativt kan du placera en separat manifestfil i samma katalog som programmets körbara fil. Operativsystemet läser först in manifestet från filsystemet och kontrollerar sedan resursavsnittet i den körbara filen. Filsystemversionen har företräde.

6. Delade sammansättningar ska installeras med hjälp av Windows Installer version 2.0. Skapa ett Windows Installer-paket enligt beskrivningen i Hur installerar jag Win32-sammansättningar för delning sida vid sida i Windows XP?.

7. Privata sammansättningar kan installeras med hjälp av Windows Installer version 2.0. Skapa ett Windows Installer-paket enligt beskrivningen i Hur installerar jag Win32-sammansättningar för privat användning av ett program i Windows XP?. Du kan också använda andra installationsprogram för att kopiera en privat sammansättning och dess manifest till samma mapp som programmets körbara fil.

8. Testa programmet för att säkerställa resultatet. Observera att testdatorn inte bör ha sammansättningen sida vid sida registrerad.

9. Distribuera ditt program eller uppdatera som ett Windows Installer-paket.

Exempel på programmanifest

Följande är ett exempel på ett programmanifest:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32" name="Microsoft.Windows.mysampleapp" version="1.0.0.0" processorArchitecture="x86"/>
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="Microsoft.Windows.SampleAssembly" version="6.0.0.0" processorArchitecture="x86" publicKeyToken="a5aaf5ba15723d5"/>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="Microsoft.Tools.MyPrivateDll" version="2.5.0.0" processorArchitecture="x86"/>
    </dependentAssembly>
  </dependency>
</assembly>