Rozdział 3: Używanie Lini Poleceń

3.1 Używanie programu MakeNSIS

Instalatory NSIS generowane są przez program MakeNSIS, poprzez skompilowanie skryptu NSIS (o rozszerzeniu .NSI) do pliku wykonywalnego. Środowisko Instalatora NSIS tak ustawia twój komputer, że możesz kompilować pliki skryptów .nsi poprzez kliknięcie prawym klawiszem myszy na tym pliku w eksploratorze Windows i wybranie opcji 'Kompiluj'.

Jeśli chcesz używać programu MakeNSIS poprzez linię poleceń, składnia polecenia wygląda następująco:

makensis [opcja | skrypt.nsi | - [...]]

3.1.1 Opcje

/LICENSE wyświetla stronę licencji.
Przełącznik /V poprzedzony liczbą z zakresu 0 oraz 4 ustawia odpowiedni sposób wyświetlania danych na wyjściu. 0=brak wyjścia, 1=tylko błędy, 2=ostrzeżenia oraz błędy, 3=informacje, ostrzeżenia oraz błędy, 4=wszystkie wyjścia.
Przełącznik /P poprzedzony liczbą z zakresu 0 oraz 5 ustawia priorytet procesu kompilatora. 0=bezczynny, 1=poniżej normalnego, 2=normalny (domyślny), 3=powyżej normalnego, 4=wysoki, 5=czasu rzeczywistego.
Przełącznik /O poprzedzony nazwą informuje kompilatora by wypisał log do pliku o tej nazwie (zamiast na ekran)
/PAUSE pauzuje makensis przed wyjściem, co jest użyteczne przy uruchamianiu bezpośrednio z Windows.
/NOCONFIG wyłącza dołączanie nsisconf.nsh. Bez tego parametru, domyślne opcje instalatora pobierane z nsisconf.nsh.
/CMDHELP wyświetla podstawowe informacje o używaniu poleceń (jeśli określone), lub wszystkich poleceń (jeśli polecenie nie jest określone).
/HDRINFO wyświetla na wyjściu informacje o opcjach jakie zostały użyte przy kompilacji makensis.
/NOCD wyłącza zmianę bieżącego katalogu na ten z pliku .nsi
Używając przełącznika /D raz lub kilka razy zostanie dodany do symboli do globalnie zdefiniowanej listy (Patrz !define).
Używając przełącznika /X raz lub kilka razy zostanie wykonany fragment kodu, który określisz. Na przykład: "/XAutoCloseWindow false"
Nadając skryptowi nazwę złożoną z (-) informujemy makensis, aby użył standardowego wejścia jako źródła.

3.1.2 Uwagi

Parametry przetwarzane są w kolejności. Zapis makensis /Ddef skrypt.nsi nie jest tym samym co makensis skrypt.nsi /Ddef.
Jeśli wybranych jest kilka skryptów, traktowane są one jako jeden połączony.
W systemach Windows 95, 98 oraz NT, priorytet procesu poniżej normalnego oraz powyżej normalnego nie są dostępne. W tych systemach, priorytet poniżej normalnego ustawia priorytet na bezczynny, zaś powyżej normalnego na wysoki.

3.1.3 Zmienne Środowiskowe

Makensis sprawdza liczbę zmiennych środowiskowych, które informują o lokalizacji elementów wymaganych do stworzenia instalatora. Do tych zmiennych zaliczamy:

NSISDIR, NSISCONFDIR - miejsca, do których instalowane są dane nsis oraz pliki konfiguracyjne. NSISDIR odzwierciedla zmienną skryptu ${NSISDIR}. Więcej informacji znajduje się tutaj: Stałe.
APPDATA (na platformie Windows) lub HOME (na innych platformach) - Lokalizacja pliku konfiguracyjnego użytkownika.

3.1.4 Przykłady

Podstawowe użycie:

makensis.exe mójskrypt.nsi

Tryb cichy:

makensis.exe /V1 mójskrypt.nsi

Ustawienie metody kompresji:

makensis.exe /X"SetCompressor /FINAL lzma" mójskrypt.nsi

Zmiana zachowania skryptu:

makensis.exe /DUSE_UPX /DVERSION=1.337 /DNO_IMAGES mójskrypt.nsi

Kolejność parametrów:

makensis /XSection zawartoscsekcji.nsi /XSectionEnd

3.2 Używanie Instalatora

Wygenerowane instalatory oraz deinstalatory akceptują kilka opcji poprzez linię poleceń. Opcje te dają użytkownikowi trochę większą kontrolę nad procesem instalacji.

3.2.1 Opcje Wspólne

/NCRC wyłącza sprawdzanie sum kontrolnych CRC, jeśli nie użyto polecenia CRCCheck force w skrypcie.
/S uruchamia instalatora lub deinstalatora w trybie cichym. Więcej informacji znajdziesz tutaj: Ciche Instalatory/Deinstalatory.
/D ustawia domyślny katalog instalacji ($INSTDIR), ignorując polecenia InstallDir oraz InstallDirRegKey. Musi to być ostatni parametr wpisany w lini poleceń i nie może zawierać żadnych znaków cudzysłowia, nawet w przypadku gdy ścieżka dostępu zawiera spacje.

3.2.2 Specyficzne Opcje Deinstalatora

_?= ustawia $INSTDIR. Także, zabrania deinstalatorowi kopiowania siebie do katalogu tymczasowego oraz jego uruchomienia z tej lokalizacji. Może być użyte wraz z poleceniem ExecWait, która oczekuje na zakończenie pracy deinstalatora. Musi to być ostatni parametr wpisany w lini poleceń i nie może zawierać żadnych znaków cudzysłowia, nawet w przypadku gdy ścieżka dostępu zawiera spacje.

3.2.3 Przykłady

installer.exe /NCRC

installer.exe /S

installer.exe /D=C:\Program Files\NSIS

installer.exe /NCRC /S /D=C:\Program Files\NSIS

uninstaller.exe /S _?=C:\Program Files\NSIS

# deinstalacja starszej wersji ExecWait '"$INSTDIR\uninstaller.exe" /S _?=$INSTDIR'

Poprzedni | Spis treści | Następny