1 Setup Project készítése Szabadi Tamás

Miről lesz szó? Setup project készítése egy már meglévő, lefordított programhoz Setup project készítése egy már meglévő, lefordított programhoz Specifikus Setup project készítése egy általunk készített projecthez Specifikus Setup project készítése egy általunk készített projecthez ClickOnce ClickOnce 2

3 Tulajdonságok Windows 95 óta elérhető Windows 95 óta elérhető Alkalmazások által használt állományokat egyetlen csomagba gyúrták – könnyű szállíthatóság Alkalmazások által használt állományokat egyetlen csomagba gyúrták – könnyű szállíthatóság Önjavítás (repair) lehetősége Önjavítás (repair) lehetősége Rollback (Egy adatbázison nyitott tranzakció keretében végzett módosítások visszavonása, és ezen keresztül a módosítások megkezdése előtti állapot visszaállítása.) Rollback (Egy adatbázison nyitott tranzakció keretében végzett módosítások visszavonása, és ezen keresztül a módosítások megkezdése előtti állapot visszaállítása.) Output:.msi – telepítés indítása (szükséges adminisztrátor jog!) Output:.msi – telepítés indítása (szükséges adminisztrátor jog!)

1. Készítsünk egy setup project alkalmazást egy már elkészített, lefordított programhoz. 4

5

6 ProductName átírása RemovePreviousVersion := true, segítségünkre lehet későbbi új verzió létrehozásakor (törli az előző verziót)

7 Adjuk hozzá a programunk exe-jét az Application Folder -hez (minden exe- beli változtatás esetén fordítsuk újra a setup project-et!) Adjuk hozzá a programunk exe-jét az Application Folder -hez (minden exe- beli változtatás esetén fordítsuk újra a setup project-et!) Adjuk hozzá a szükséges config, illetve icon file-okat Adjuk hozzá a szükséges config, illetve icon file-okat Application Folder property: DefaultLocation alapból: [ProgramFilesFolder] [Manufacturer]\[ProductName] Application Folder property: DefaultLocation alapból: [ProgramFilesFolder] [Manufacturer]\[ProductName]

8 Függőségek automatikus érzékelése (.NET Framework telepítésére nem kerül sor!) Függőségek automatikus érzékelése (.NET Framework telepítésére nem kerül sor!).NET Framework nélkül a Setup project nem telepít semmilyen.NET application-t!.NET Framework nélkül a Setup project nem telepít semmilyen.NET application-t! AlwaysCreate property legyen true (pl shortcut készítéshez) AlwaysCreate property legyen true (pl shortcut készítéshez)

9 Shortcut készítés User’s Desktop – jobbklikk – Create New Shortcut A dialogban válasszuk ki az Application Folder- beli exe-t

10 Az installer ne hozza létre minden release-nél a Shortcut-ot! Az installer ne hozza létre minden release-nél a Shortcut-ot! Condition = FILEEXISTS1<>"Shortcut to RunOnceOnlyCS.exe„ Condition = FILEEXISTS1<>"Shortcut to RunOnceOnlyCS.exe„ Transitive property legyen true (minden installnál és reinstallnál értékelje ki a Condition –t) Transitive property legyen true (minden installnál és reinstallnál értékelje ki a Condition –t) Icon kép: Shortcut Icon property–jénél adjuk meg Icon kép: Shortcut Icon property–jénél adjuk meg

11 Shortcut készítés a Start menübe User’s Programs menüben a kívánt könyvtárszerkezet létrehozása User’s Programs menüben a kívánt könyvtárszerkezet létrehozása Az előbbiek szerint egy új shortcut készítése Az előbbiek szerint egy új shortcut készítése

12 Verzió Verzió megadása a Setup project property –jében Verzió megadása a Setup project property –jében Update-eljük a ProductCode –ot, különben nem fog működni megfelelően a régi verzió eltávolítása, illetve az új telepítése Megjegyzés: NE változtassuk meg manuálisan az UpgradeCode – ot, különben telepítés előtt szükséges a régi verzió eltávolítása „Unrecoverable build error” esetén: „regsvr32 ole32.dll”

13 2. Új Probléma – specifikus setup project Új ablak Új ablak Választható Asztal ikon, Start menü, Quick Launch ikon Választható Asztal ikon, Start menü, Quick Launch ikon

Előkészületek 1. Készítsük el a projectünket, amihez az installshield-et szeretnénk készíteni. 2. Adjunk hozzá a solution-höz egy új setup projectet 3. Készítsük el az ikonok megfelelő helyre helyezéséért felelős formot, ezt fogjuk felhasználni a setup project során ! 14

15 Speciális könyvtárak elérése Speciális könyvtárak: Desktop, My Documents, Start Up, stb…) Speciális könyvtárak: Desktop, My Documents, Start Up, stb…) System.Environment.GetFolderPath( ) segít elérni a speciális könyvtárakat System.Environment.GetFolderPath( ) segít elérni a speciális könyvtárakat Paramétere: Environment.SpecialFolder (pl Desktop, Programs, ApplicationData) Paramétere: Environment.SpecialFolder (pl Desktop, Programs, ApplicationData) Készítsük el az ikonokat elhelyező programot (shortcut.exe) Készítsük el az ikonokat elhelyező programot (shortcut.exe)

16 A kód – Desktop ikon // Create shortcut on Desktop if(cbDesktop.Checked==true){ File.Move(Application.StartupPath+ File.Move(Application.StartupPath+ "\\Shortcut to Test.lnk", "\\Shortcut to Test.lnk", Environment.GetFolderPath( Environment.GetFolderPath( Environment.SpecialFolder.Desktop).Trim( )+ Environment.SpecialFolder.Desktop).Trim( )+ "\\Shortcut to Test.lnk"); "\\Shortcut to Test.lnk");}

17 A kód – Start menü ikon // Create shortcut in programs menu. if(cbStartMenu.Checked==true){ File.Move(Application.StartupPath+"\\Test1.lnk", File.Move(Application.StartupPath+"\\Test1.lnk", Environment.GetFolderPath( Environment.GetFolderPath( Environment.SpecialFolder.Programs).Trim( )+ Environment.SpecialFolder.Programs).Trim( )+ "\\Test.lnk"); "\\Test.lnk");}

18 A kód – Quick Launch ikon // Create shortcut in Quick Launch Toolbar if(cbQuickLaunch.Checked==true){ File.Move(Application.StartupPath+ File.Move(Application.StartupPath+ "\\Test2.lnk",Environment.GetFolderPath( "\\Test2.lnk",Environment.GetFolderPath( Environment.SpecialFolder.ApplicationData)+ Environment.SpecialFolder.ApplicationData)+ "\\Microsoft\\Internet Explorer\\" + "\\Microsoft\\Internet Explorer\\" + "Quick Launch\\Test.lnk"); "Quick Launch\\Test.lnk");}

19 A projektünkhöz hozzáadott Setup Project-hez adjuk hozzá a projektünk output-ját

20 Válasszuk ki a ‘Primary output’-ot a dialog ablakból

21 A csatolt.exe a következőképpen néz ki A csatolt.exe a következőképpen néz ki Készítsünk parancsikont a primary outputhoz (jobbklikk) Készítsünk parancsikont a primary outputhoz (jobbklikk)

22 Elkészült az ikonunk Elkészült az ikonunk Custom Action beállításai Custom Action beállításai

23 A Custom Action ablakban többféle Action-t beállíthatunk. Nekünk most az ‘install’-ra lesz szükségünk. A Custom Action ablakban többféle Action-t beállíthatunk. Nekünk most az ‘install’-ra lesz szükségünk. Adjunk hozzá egy Custom Action –t. Adjunk hozzá egy Custom Action –t.

24 Válasszuk ki az Application Folder-t, majd Add File Válasszuk ki az Application Folder-t, majd Add File

25 Válasszuk ki az előre megírt Shortcut.exe –t, ami az ikonok megfelelő helyre történő berakásáért felelős formot valósítja meg. Válasszuk ki az előre megírt Shortcut.exe –t, ami az ikonok megfelelő helyre történő berakásáért felelős formot valósítja meg.

26 Sikerült elhelyezni a Shortcut.exe –t az Install Custom Action –ben Sikerült elhelyezni a Shortcut.exe –t az Install Custom Action –ben Állítsuk át a Shortcut.exe InstallerClass property-jét false- ra. Állítsuk át a Shortcut.exe InstallerClass property-jét false- ra.

27 3. The Magic of ClickOnce Webről indítható, telepíthető alkalmazások Webről indítható, telepíthető alkalmazások Minden induláskor ellenőrzi, hogy elérhető-e frissítés, és ha igen, telepíti azt. Minden induláskor ellenőrzi, hogy elérhető-e frissítés, és ha igen, telepíti azt. Elkészítése rendkívül könnyű, és fájdalommentes Elkészítése rendkívül könnyű, és fájdalommentes

28 Példa Smart Client készítése Készítsünk egy új almalmazást Készítsünk egy új almalmazást Adjunk hozzá egy naptárat Adjunk hozzá egy naptárat

29 Fordítsuk le a Smart Client windows alkalmazásunkat! (Build / Build SmartClient) Fordítsuk le a Smart Client windows alkalmazásunkat! (Build / Build SmartClient) Tegyük közzé az alkalmazásunkat (Build / Publish SmartClient) Tegyük közzé az alkalmazásunkat (Build / Publish SmartClient)

30 Publish Lehetőségek: Merevlemez Merevlemez Megosztott könyvtár Megosztott könyvtár FTP szerver FTP szerver Webszerver Webszerver

31 A példánkban használjunk webszervert

32 Beállíthatjuk, hogy a felhasználó offline is használhassa-e az alkalmazásunkat. Beállíthatjuk, hogy a felhasználó offline is használhassa-e az alkalmazásunkat.

33 Meg kell jelölnünk az alkalmazásunkat (azonosításhoz)! Új kulcs készítése Új kulcs készítése Kódolt kulcs készítése Kódolt kulcs készítése Key Provider használata Key Provider használata

34 Kész a publikálásra a programunk ! Kész a publikálásra a programunk ! Finish után bejön a weboldal, ahol telepíthetjük az alkalmazásunkat Finish után bejön a weboldal, ahol telepíthetjük az alkalmazásunkat

35 A fenti oldalon telepíthetjük az alkalmazásunkat. A fenti oldalon telepíthetjük az alkalmazásunkat.

36 Biztonsági figyelmeztetés – Biztosan telepítjük az alkalmazást? Biztonsági figyelmeztetés – Biztosan telepítjük az alkalmazást?

37 Sikeresen feltelepült az alkalmazásunk Sikeresen feltelepült az alkalmazásunk Bekerült a Start menübe Bekerült a Start menübe

38 A clickonce erőssége Az alkalmazások frissítése Az alkalmazások frissítése Módosítsuk az alkalmazásunkat egy TimePicker controllal Módosítsuk az alkalmazásunkat egy TimePicker controllal

39 Módosítás után hajtsuk végre újra a publikálási lépéseket Módosítás után hajtsuk végre újra a publikálási lépéseket Következő indításnál a felhasználót értesíti a program a frissítések elérhetőségéről! Következő indításnál a felhasználót értesíti a program a frissítések elérhetőségéről!

40 A felhasználónak ezután is lehetősége van visszaállítani az előző verziót (Control Panel - Add/Remove programs) A felhasználónak ezután is lehetősége van visszaállítani az előző verziót (Control Panel - Add/Remove programs)

41 VÉGE ! Felhasznált oldalak: