Wix custom action binary options

Wskazówki Wix Porady Wix jest potężny i nie poleciłbym żadnego innego systemu budowania instalacji dla poważnych projektów. Nieskończenie konfigurowalny, skryptowalny, używa standardowych plików MSI, nie kosztuje nic, a może najlepiej, integruje się bezpośrednio z Visual Studio. Zarówno sam Wix, jak i system MSI, który został zbudowany, wprowadzają szereg dziwactw, a krzywa uczenia się jest ładna, dość stroma. A potem uczą się właściwego sposobu myślenia: jeden plik na komponent, najlepiej dodawany ręcznie. Oto kilka różnych wskazówek, które nie są zbyt zaawansowane, ale warte poznania. Referencje projektu Referencje do innych projektów w tym rozwiązaniu są być może najważniejszą rzeczą związaną z korzystaniem z Wix i tym, co sprawia, że ​​jest tak wspaniały w użyciu. Dodanie referencji jest proste: projekty, do których się odwołujesz, zostaną zbudowane za pomocą instalatora i w tej samej konfiguracji (debugrelease cokolwiek). Zajmuje się natychmiast problemami związanymi z budową zamówień. Także referencje mają właściwości. Możesz ustawić Wix, aby automatycznie zbierać pliki, które należą do projektu za pomocą HEAT. Może być użyteczne, jeśli twój projekt zawiera informacje COM, które HEAT może przetwarzać, chociaż w większości przypadków korzystałem z HEAT z wstępnych etapów tworzenia, aby zebrać rzeczy, takie jak katalog pełen plików dokumentacji. Nie miałem też szczęścia przy korzystaniu z HEAT przy samodzielnej rejestracji macierzystych serwerów. exe. Naprawdę redukuje zakodowane informacje i radzi sobie ze ścieżkami w stosunku do twojego instalatora. Wersja pliku wersji instalatora, wersja w nazwie produktu Korzystając ze specjalnej zmiennej (bind. FileVersion.), Możesz ustawić instalator tak, aby miał tę samą wersję co określony plik, do którego się odwołuje. Lubię również dołączać wersję do nazwy produktu, więc jest jasne, co jest instalowane, i mając nazwę produktu jako makro, które można ponownie wykorzystać w instalatorze. Dla wyjaśnienia Ive zdefiniowałem PRODUCT w kodzie tutaj, ale lepiej jest zrobić to w opcjach projektu: w ten sposób makro jest globalne dla wszystkich plików w projekcie. Dodawanie plików jako odnośników W przeciwieństwie do Visual C, jeśli dodasz istniejący plik do projektu Wix, kopiuje go. Dodanie pliku jako linku jest niezwykle proste, jeśli nie masz zwyczaju zignorowania dodatkowych opcji przycisku Ok w oknie dialogowym Typowe artykuły. to jest. ComponentGroups i Katalogi Jedną z denerwujących rzeczy w schemacie Wix jest to, że nie możesz mieć ComponentGroup wewnątrz elementu DirectoryRef i na odwrót. Zarówno elementy ComponentGroup, jak i DirectoryRef mają krytyczne znaczenie dla większych projektów, w których funkcja może współdzielić grupy składników, które z kolei są definiowane w różnych plikach. Oznacza to, że masz tendencję do oglądania kodu takiego jak Uwaga, że ​​grupa składników musi zawierać komponentRef dla każdego komponentu innymi słowami, dla każdego dodanego komponentu musisz edytować plik w dwóch miejscach, co jest denerwujące. Na szczęście, od wersji 3, Wix obsługuje atrybut Directory dla komponentów: Much schludniejszy. Jedyną wadą jest to, że katalog musi być powtarzany dla każdego komponentu. ale w praktyce nie znajduję tak dużego problemu. W końcu jest zawsze funkcją findreplace. Element MajorUpgrade Aktualizacje, aktualizacje i poprawki są jedną z najbardziej złożonych części tworzenia MSI. Używam tylko głównych aktualizacji (które odinstalowuję, a następnie ponownie instaluję produkt) z następujących powodów: wymagają one, aby identyfikator GUID identyfikatora produktu był zmieniany dla każdej wersji, co jest łatwe w Wix poprzez jego ustawienie. Zwolnienie mniejszych aktualizacji oznacza, że ​​identyfikator produktu musi być aktualizowany w niektórych przypadkach, ale nie w innych, co oznacza bardziej skomplikowany przepływ pracy. Pozwalają one na używanie automatycznie generowanych identyfikatorów GUID dla komponentów, co nie tylko sprawia, że ​​tworzenie plików wx jest mniej kłopotliwe, ale także umożliwia zbieranie danych HEAT jako etap wstępnej kompilacji, który jest ponownie uruchamiany dla każdej kompilacji instalator. Duże uaktualnienia pozwalają na przetasowanie wszystkich składników funkcji instalatora, co ułatwia udoskonalanie instalatora wraz z postępem prac. Oczywiście wadą jest to, że musisz rozprowadzać duży plik MSI nawet w przypadku prostych aktualizacji. Wix 3.5 wprowadził element MajorUpgrade. który jest łatwiejszy w użyciu niż rozkoszowanie się osobnymi elementami wersji Upgrade i Upgrade. Oto jak go używam (zauważ, że PRODUCT jest makrem zdefiniowanym w opcjach projektu): Uważaj: atrybut Id elementu Product musi być ustawiony na Pamiętaj także atrybut AllowSameVersionUprades. Instalatory MSI ignorują czwartą cyfrę wersji produktu. Domyślnie instalatory MSI, których różnią się tylko czwartą wersją wersji, zostaną zainstalowane obok siebie. Prowadzi to do mylących sytuacji z powtarzającymi się wpisami w programach addremove itp. Ustawiając AllowSameVersionUprades na true, te wersje będą instalowane jeden na drugim jak zwykle, z efektem ubocznym, który można obniżyć do wersji z niższą czwartą cyfrą. W przypadku systemów wersjonowania, w których czwarta cyfra to na przykład numer oddziału, może to być rzeczywiście pozytywna sprawa. Zauważ, że AllowSameVersionUpgradesyes generuje ostrzeżenie ICE61. Aby go wyłączyć, dodaj go do zignorowanych sprawdzeń ICE we właściwościach projektu Wix (w Ustawieniach narzędzia). Trudno jest stworzyć nietrywialny instalator, nie ignorując przy tym co najmniej kilku ostrzeżeń ICE, zwłaszcza gdy zaangażowane są moduły scalające firm zewnętrznych. Wyłącz projekty Wix w kompilacjach debugujących Projekty Wix mogą zająć dużo czasu i nie są naprawdę potrzebne. Proponuję wyładowanie ich lub ich folderu rozwiązania (kliknij prawym przyciskiem myszy - Zwolnij projekty w folderze rozwiązania), gdy nie są potrzebne. Mogą być całkowicie wyłączone w trybie debugowania, przechodząc do okna konfiguracji rozwiązania i wyłączając je dla DebugAll Platforms. Wix i Team Foundation Server Zbudowanie zespołu Praca z zespołem TFS Konstrukcja może być uciążliwa, a uzyskanie dobrej gry z Wix wymagało pewnych eksperymentów, ale nie jest to trudne: Upewnij się, że projekty Wix zostaną zbudowane dla konfiguracji, której chcesz użyć. Domyślnie i denerwująco, projekty Wix są budowane tylko dla platformy Mixed Platforms, a nie Win32. Upewnij się, że twoje serwery kompilacji ustawione są na używanie platform mieszanych lub włączaj projekty Wix dla Win32. Upewnij się, że Wix jest zainstalowany w twoim systemie (systemach) budowania. Początkowo chciałem tego uniknąć i postępować zgodnie z opisanymi tutaj krokami. sprawdzanie Wix w drzewie źródłowym. Miało to jednak kilka poważnych wad: konieczność edycji każdego pliku. wixproj, a kompilacja binariów Wix nie działała dobrze, gdy nadszedł czas na oczyszczenie:. Zarejestruj Microsoft. Deployment. WindowsInstaller. dll z GAC, inaczej Team Build nie będzie mógł go jakoś znaleźć. Uruchom wiersz polecenia VS2017 jako administrator: C: Program Files (x86) Instalator Windows XML v3.5pingacutil - i Microsoft. Deployment. WindowsInstaller. dll Microsoft (R) Global Assembly Cache Utility. Wersja 4.0.30319.1 Prawa autorskie (c) Microsoft Corporation. Wszelkie prawa zastrzeżone. Składowanie zostało pomyślnie dodane do pamięci podręcznej Jedną wadą jest to, że katalog plików wyjściowych projektu Wix jest ignorowany, a instalatory zostaną zrzucone pośród wszystkich innych plików binarnych. Można go rozwiązać za pomocą kroku po kompilacji, jeśli jesteś tak pochłonięty. Przycisk UAC na przycisku Instaluj Domyślnie instalatorzy Wix pytają o uprawnienia administratora po naciśnięciu przycisku Instaluj w systemach z włączonym UAC, ale nie pokazuj osłony UAC na przycisku. Ustawiając atrybut InstallScope elementu Package na perMachine. Tarcza może wyglądać tak: Niestety, nie można instalować żadnych zestawów ustawień InstallScope i InstallPrivilege, aby prosić tylko o uprawnienia administratora, gdy są one rzeczywiście wymagane, w zależności od katalogu instalacyjnego. W obecnej wersji instalatory perUser po prostu zostaną uszkodzone po zainstalowaniu, na przykład w katalogu Program Files, podczas gdy instalatory perMachine zawsze pytają o prawa administratora. TARGETDIR i partycja systemowa Podczas próby instalacji w podkatalogu root systemu (np. C: application), może się wydawać, że w coś takiego jak TARGETDIR odnosi się do partycji systemowej, ponieważ ProgramFilesFolder jest zawsze podawany jako dziecko TARGETDIR . W przeciwnym razie TARGETDIR jest partycją z największą ilością wolnego miejsca na dysku. Może to być nawet partycja na zewnętrznym dysku twardym. Aby ustawić go na prawdziwą partycję systemową, użyj poniższego podejścia: Element SetDirectory jest wymagany, ponieważ próba użycia WindowsVolume bezpośrednio skutkuje podpisem MSI podpisywania Jeśli podpiszesz pliki MSI, theyll dostanie ładny profesjonalny monit UAC, który sprawdzi pakiet jako twój . Po uzyskaniu klucza do podpisywania kodu w formacie. pfx, podpisanie MSI jest łatwe do wykonania jako etap post-build projektu Wix. Upewnij się, że przekazałeś opis pakietu, w przeciwnym razie w monitorze UAC pojawi się zmasakrowana nazwa pliku tymczasowego z powodu działania msiexec. Na przykład: Debugowanie działań niestandardowych Jednym z łatwych sposobów debugowania niestandardowych działań dll jest utworzenie od niego okna komunikatu za pomocą wywołania Windows MessageBox, a następnie dołączenie debuggera. Upewnij się, że dana czynność niestandardowa została wbudowana w tryb debugowania, jeśli korzystasz z odniesień do projektu, aby uwzględnić niestandardową bibliotekę akcji, kompilacja debugowania projektu Wix będzie zawierała również wersję debugowania biblioteki dll. Niech odrodzi się okno komunikatu w pobliżu miejsca, w którym chcesz debugować, i dołącz debager programu Visual Studio. Zwróć uwagę, że podczas uruchamiania 32-bitowej niestandardowej akcji w 64-bitowej wersji systemu Windows, nowa instancja msiexec zostanie uruchomiona, aby uruchomić urząd CA, zaznacz pole wyboru Pokaż procesy od wszystkich użytkowników, aby ją znaleźć. Po dołączeniu debugera umieść punkt przerwania, wciśnij klawisz F5, aby wznowić, kliknij OK w oknie komunikatu i jesteś w biznesie. Utworzono: 18 stycznia 2017 Zmodyfikowano: 12 lutego 2017 Tworzenie bazy danych Aby utworzyć bazę danych SQL, potrzebujemy najpierw użytkownika z odpowiednimi danymi uwierzytelniającymi. Nazwa użytkownika i hasło są przechowywane we właściwościach, możesz użyć zwykłych elementów interfejsu użytkownika lub działań niestandardowych, aby je ustawić. Zauważ, że jest to ten sam tag użytkownika, którego użyliśmy do utworzenia nowego konta użytkownika, ale został użyty wewnątrz znacznika komponentu. Poza dowolnym komponentem nie utworzy użytkownika, a jedynie zdefiniuje poświadczenia dla innych operacji, które będą używane. Ponieważ znaczniki, a także funkcjonalność SQL, są obecne w modułach rozszerzeń, musimy wspomnieć o nich w tagu otwierającym pliku źródłowego: Ponadto, ponieważ należą one do ich własnej przestrzeni nazw, musimy je udekorować podczas użytkowania: samo utworzenie bazy danych przechodzi na komponent, jak zwykle. SqlDatabase odnosi się do poprzedniej deklaracji użytkownika, określa nazwę bazy danych, serwer i instancję. Brak określenia Serwera spowoduje jego instalację na Serwerze SQL uruchomionym na maszynie docelowej. Inne atrybuty określają sposób postępowania w różnych sytuacjach. ConfirmOverwrite określa, co zrobić, jeśli baza danych już istnieje i CreateOnInstall. CreateOnUninstall. DropOnInstall. oraz atrybuty DropOnUninstall określają wymagane zachowanie podczas instalacji i deinstalacji. Zagnieżdżony znacznik SqlScript określa, co zrobić z pustą utworzoną właśnie bazą danych. Możemy tutaj wykonać dowolny poprawny skrypt SQL, znajdujący się w oddzielnym pliku. Atrybut BinaryKey zapewni odsyłacz do pliku skryptu. sql. Inne atrybuty określają zachowanie w przypadku wystąpienia błędu (ContinueOnError) lub określają, kiedy wykonać skrypt (ExecuteOnInstall, ExecuteOnUninstall, RollbackOnInstall, RollbackOnUninstall). Przy obecnym więcej niż jednym skrypcie do wykonania można je zsekwencjonować za pomocą atrybutu Sekwencja. Pozostaje tylko dołączyć plik. sql: plik, do którego się odnosi, będzie zawierał zwykłe polecenia SQL do utworzenia tabeli bazy danych: Podczas budowania pakietu instalacyjnego musisz połączyć go z odpowiednimi modułami WiX: Możesz pobrać kompletny SampleSQL . O FireGiant Teraz możesz zainstalować z ufnością. FireGiant broni cię z dokładnym wsparciem twórców WiX. Ponieważ nie ma pytań, na które nie możemy odpowiedzieć lub problemów, których nie możemy rozwiązać, możesz bez problemu uwolnić pełną funkcjonalność WiX. copy 2018 FIREGIANTDodawanie działania niestandardowego Ten przykład pokazuje, jak utworzyć niestandardową akcję binarną o nazwie quotFooActionquot. Typowym przykładem jest niestandardowa akcja dll, która uruchamia notepad. exe lub inną aplikację jako część ich instalacji. Zanim zaczniesz, będziesz potrzebował przykładowej biblioteki dll, która ma punkt początkowy o nazwie: quotFooEntryPointquot. Ta próbka zakłada, że ​​już przejrzałeś temat Tworzenie rozszerzenia szkieletu. Krok 1: Utwórz fragment Możesz bezpośrednio odwołać się do akcji niestandardowej w tym samym pliku źródłowym, co definicja produktu. Nie spowoduje to jednak użycia tej samej niestandardowej akcji w innym miejscu. Zamiast więc umieszczać definicję akcji niestandardowej w tym samym pliku źródłowym, należy zastosować nieco modułowość i utworzyć nowy plik źródłowy w celu zdefiniowania niestandardowej akcji o nazwie quotca. wxsquot. Okay, to wszystko. Dokonano edycji pliku źródłowego quotca. wxsquot. Ten mały kod powinien się skompilować, ale nie będzie się łączyć. Pamiętaj, że linkowanie wymaga sekcji z wpisami. Sam ltFragmentgt nie jest sekcją wejścia. Przejdź do następnego kroku, aby połączyć plik źródłowy. Krok 2: Dodaj niestandardową akcję Musielibyśmy połączyć ten plik źródłowy z plikiem źródłowym zawierającym ltProductgt lub ltModulegt, aby pomyślnie zakończyć. Te trzy linie to wszystko, czego potrzebujesz, aby dodać do pliku źródłowego pakietu Windows Installer, aby wywołać funkcję CustomAction quotFooActionquot. Teraz, gdy mamy dwa pliki do połączenia, nasze wywołanie light. exe staje się nieco bardziej skomplikowane. Oto kroki kompilacji, łącza i instalacji. Teraz jako część twojej instalacji, cokolwiek quotFooActionquot ma wykonać, powinieneś się wydarzyć po akcji InstallFiles.