Praktische handleiding
Bestaande WiX-projecten visueel bewerken
Gebruik je bestaande WiX-bronbestanden als uitgangspunt. Deze handleiding legt het verschil uit tussen bronbestanden openen in de browser en werken met een lokaal .wixpie-project. Daarna lees je wat je vóór het opslaan controleert.
1. Begin met een bekende werkende kopie
Commit je installer of maak een back-up voordat je gaat bewerken. Zoek het hoofdbronbestand .wxs, de gebruikte .wxi-includes, .wxl-taalbestanden, bestandspaden en eventuele WiX-extensies en preprocessorvariabelen van de bestaande build bij elkaar.
Controleer de namespace van het XML-hoofdelement om de bronfamilie vast te stellen. WiX 3 gebruikt http://schemas.microsoft.com/wix/2006/wi. WiX 5 gebruikt http://wixtoolset.org/schemas/v4/wxs. Houd bij je eerste visuele wijziging de huidige toolset aan, zodat een versiemigratie geen onderdeel wordt van dezelfde wijziging.
2. Open bronbestanden of een WixPie-project
Kies in een browsersessie File → Open files… en selecteer de .wxs- en .wxi-bronnen die je wilt openen. Kies waar gevraagd een passende editortemplate. Hiermee bewerk je documenten; de browser krijgt daarmee geen toegang tot alle bestanden waarnaar de installer verwijst.
Met de Windows Local Agent en extensie verbonden opent File → Open Project… een bestaand .wixpie-project. Een .wixpie-bestand bewaart WixPie-projectinstellingen. Een .wixproj is een MSBuild-project en heeft een ander formaat. Begin voor bestaand MSBuild-werk met de WiX-bronbestanden en bewaar de oorspronkelijke .wixproj en bouwconfiguratie.
3. Wijzig één eigenschap en bekijk de XML
Begin klein, bijvoorbeeld met de pakketnaam of één bewerkbare bestandseigenschap. Gebruik de beschikbare templatepagina’s en invoervelden en vergelijk het XML-voorbeeld met de oorspronkelijke bron. Controleer of de ID-verwijzingen en bestandspaden nog naar de bedoelde installerelementen wijzen.
De template bepaalt welke bewerkingen een visuele weergave hebben. Voor een geavanceerde aangepaste actie of een extensie-element kan een andere passende template of werk in de broncode nodig zijn. Controleer het resultaat en ga er niet van uit dat ieder deel van een willekeurig WiX-project een eigen gespecialiseerde editor heeft.
4. Houd includes, taalbestanden en bouwgegevens bij elkaar
Bewaar bij een lokaal .wixpie-project de bron- en installatiebestanden binnen de toegestane projectmap. Behoud relatieve include- en bestandspaden. Leg benodigde WiX-extensies en preprocessorvariabelen vast in de projectinstellingen en kies dezelfde toolset als voor de oorspronkelijke installer.
Een .wxl-bestand bevat taalgegevens in plaats van een normale installerboom. Bewaar het bij de bouwbestanden. Alleen bronbestanden in de browser selecteren vervangt niet de volledige lokale bouwomgeving, zeker niet wanneer een project afhankelijk is van includes of paden buiten de werkmap.
5. Sla op, vergelijk en bouw opnieuw
Gebruik Download current file voor een bewerkt browserdocument, of de lokale opslagopdrachten bij een agentproject. Bekijk het verschil in versiebeheer voordat je oorspronkelijke bestanden vervangt. Controleer ID’s, namespaces, verwijzingen, includes en het bronbestand waarin iedere wijziging hoort.
Bouw met de oorspronkelijke toolset en projectconfiguratie, of met een passend ingesteld agentproject. Test de installer in een aparte Windows-testomgeving, inclusief de upgrade- en verwijderstappen die voor jouw wijziging relevant zijn. Een geslaagde XML-import is het begin van die controle, niet het einde van een installerrelease.
Probeer deze werkwijze in WixPie
Open de browsereditor om een geschikte template te bekijken. Volg voor lokale bestanden en MSI-builds de installatie van de Local Agent en extensie op de downloadpagina.