Podrobné pokyny: Použití vlastní akce pro zobrazení zprávy při instalaci

Následující návod demonstruje použití vlastní akce k přijmutí vstupu uživatele a jeho předání do okna se zprávou, které se zobrazí během instalace. Jedná se o jednoduchou demonstraci vlastních akcí, které jsou užitečné pro mnoho dalších úkolů. Vlastní akce může například přijmout jako uživatelský vstup umístění souboru Setup.exe a použít to ke spuštění aplikace po jeho instalaci.

Tento návod ukazuje, jak pomocí vlastní akce předat data do dynamické vlastnosti, jak používat instalační třídu a vlastnost CustomActionData.

Vytvoření vlastní akce

1. V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).

2. V dialogovém okně Nový projekt, v podokně Typ projektu, vyberte Visual Basic a poté vyberte položku Knihovna tříd v podokně Šablony. Do pole Název zadejte PassData.

   Projekt je přidán do okna Průzkumník řešení.

Vytvoření instalační třídy

1. V nabídce Projekt klikněte na Přidat třídu.

   V dialogovém okně Přidat novou položku vyberte Instalační třída. Přijměte výchozí název.

2. Když se instalační třída zobrazí na návrhové ploše, klikněte pravým tlačítkem myši na návrhovou plochu a klikněte na Zobrazit kód, čímž zobrazíte obsah souboru v editoru kódu .

3. Přidejte následující proceduru k přepsání procedur Install, Commit, Rollback a Uninstall základní třídy.

   Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary)
       MyBase.Install(stateSaver)
       Dim myInput As String = Me.Context.Parameters.Item("Message")
       If myInput Is Nothing Then
           myInput = "There was no message specified"
       End If
       MsgBox(myInput)
   End Sub
   
   Public Overrides Sub Commit(ByVal savedState As System.Collections.IDictionary)
       MyBase.Commit(savedState)
   End Sub
   
   Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary)
       MyBase.Rollback(savedState)
   End Sub
   
   Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary)
       MyBase.Uninstall(savedState)
   End Sub
   

   public override void Install(System.Collections.IDictionary stateSaver)
   {
       base.Install(stateSaver);
       string myInput = Context.Parameters["message"];
       if (myInput == null)
       {
           myInput = "There was no message specified";
       }
       MessageBox.Show(myInput);
   }
   
   public override void Commit(IDictionary savedState)
   {
       base.Commit(savedState);
   }
   
   public override void Rollback(IDictionary savedState)
   {
       base.Rollback(savedState);
   }
   
   public override void Uninstall(IDictionary savedState)
   {
       base.Uninstall(savedState);
   }
   

   Poznámka

   Pokud zadáte Public Overrides, tak následně zadejte mezeru a technologie IntelliSense vám poskytne seznam metod a vlastností; ze seznamu můžete vybrat Install, čímž získáte úplnou deklaraci.

4. V Aplikaci Solution Explorer, klepněte pravým tlačítkem myši Class1 kód souboru a vyberte Odstranit (protože je zbytečné).

Vytvoření projektu nasazení

1. V nabídce Soubor přejděte na Přidat a klikněte na Nový projekt.

2. V dialogovém okně Přidat nový projekt, v podokně Typ projektu rozbalte uzel Ostatní typy projektu a Instalace a nasazení, pak zvolte Projektu nasazení v podokně Šablony. Do pole Název zadejte PassData Installer.

3. V okně Vlastnosti vyberte vlastnost ProductName a zadejte PassData.

   Vyberte také vlastnost Manufacturer a zadejte My Company.

4. V okně Editor systému souborů vyberte uzel Složka aplikace. V nabídce Akce ukažte na Přidat a potom klikněte na Výstup projektu.

5. V dialogovém okně Přidat skupinu výstupů projektu vyberte primární výstup pro projekt PassData.

   V editoru Editor systému souborů se zobrazí Primární výstup z PassData (Aktivní).

Přidání vlastní akce

1. V okně Průzkumník řešení vyberte projekt PassData Installer. V nabídce Zobrazení přejděte na Editor a potom klikněte na Vlastní akce.

2. V editoru Editor vlastních akcí vyberte uzel Instalovat (nejvyšší úrovně) . V nabídce Akce klikněte na Přidat vlastní akci.

3. V dialogovém okně Select item in Project dvakrát klikněte na Složka aplikace.

4. Vyberte primární výstup (aktivní) PassData na uzel instalace přidat vlastní akci PassData.

5. V okně Vlastnosti vyberte vlastnost CustomActionData a zadejte /Message="[MESSAGE]".

6. Ujistěte se, že je vlastnost InstallerClass nastavena na True (to je výchozí nastavení).

Přizpůsobení uživatelského rozhraní instalace

1. V okně Průzkumník řešení vyberte projekt instalace. V nabídce Zobrazit přejděte na Editor a klikněte na Uživatelské rozhraní.

2. V okně Editor uživatelského rozhraní vyberte uzel Spustit pod uzlem Instalovat. V nabídce Akce klikněte na Přidat dialog.

3. V dialogovém okně Přidat dialog vyberte dialog Textboxes (A).

4. V nabídce Akce klikněte na Posunout nahoru. Opakujte, dokud nebude dialogové okno Textboxes (A) nad uzlem Instalační složka.

5. V okně Vlastnosti vyberte vlastnost BannerText a zadejte:

   Jaká je vaše zpráva?

6. Vyberte vlastnost BodyText a zadejte:

   Zde zadejte zprávu.

7. Vyberte vlastnost Edit1Label a zadejte:

   Zpráva:

8. Vyberte vlastnost Edit1Property a zadejte:

   MESSAGE

9. Vyberte vlastnosti Edit2Visible, Edit3Visible a Edit4Visible a nastavte je na False.

10. V nabídce Sestavení klikněte na Sestavit Pass Data Installer.

Instalace na vašem vývojovém počítači

• V okně Průzkumník řešení vyberte projekt PassData Installer. V nabídce Projekt klikněte na Instalovat.

  Toto spustí instalační program na vašem vývojovém počítači. V Co je zpráva? dialogové okno instalace, typ Hello World!.

  Poznámka

  Chcete-li spustit instalační program, musíte mít na vašem počítači oprávnění pro instalaci.

Nasazení na jiný počítač

1. V aplikaci Průzkumník Windows přejděte do adresáře s vaším projektem a najděte sestavený instalační program. Výchozí nastavení konfigurace projektu je buď Debug nebo Release.

2. Zkopírujte Pass Data Installer.msi, Setup.exe a všechny ostatní soubory a podadresáře v tomto adresáři na jiný počítač.

   Poznámka

   Chcete-li provést instalaci na počítač, který není v síti, zkopírujte soubory na tradiční médium, jako je například disk CD-ROM.

   Na cílovém počítači dvakrát klikněte na soubor Setup.exe, čímž spustíte instalační program. V Co je zpráva? dialogové okno instalace, typ Hello World!.

   Poznámka

   Chcete-li spustit instalační program, musíte mít na vašem počítači oprávnění pro instalaci.

Testování instalace

• Spusťte aplikaci a ověřte, že textové pole obsahuje text "Ahoj světe!", který jste zadali během instalace.

Odinstalace aplikace

1. V systému Windows Ovládací Panel, poklepejte na Přidat nebo odebrat programy nebo programy a funkce.

2. Vyberte Instalační PassData a na Odebrat nebo Odinstalace, klepněte na tlačítko OK zavřete dialogové okno.

   Tip

   Chcete-li aplikaci odinstalovat z vašeho vývojového počítače, v nabídce Projekt klikněte na tlačítko Odinstalovat.

Viz také

Odkaz

vlastnost CustomActionData

Další zdroje

Správa vlastních akcí při nasazení