DirectX Installation with Web Installer - Revision history

Anders: Reverted edits by 79.162.3.49 to last version by Seg telltale

2010-03-15T17:04:04Z

Reverted edits by 79.162.3.49 to last version by Seg telltale

@@ Line 22: / Line 22: @@
 The obvious flaw is when a user has unreliable Internet access. The web installer isn't very smart and will take a long time to exit if the Internet doesn't exist for the end user. You will need to introduce messaging to the user that explains the update will work best with Internet access.
-<span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">==Installing DirectX== The process of using the web installer is the following: # Copy the Web Installer onto the user's TEMP folder. # Run the installer from the TEMP folder. # Wait till DirectX is done updating. # Remove the locally stored installer from the TEMP folder. To start, you will need to declare the following variable early in the NSIS script: <highlight-nsis>Var DirectXSetupError</highlight-nsis> To make things easier on yourself, create a new Section for DirectX.</span> == Instalacja DirectX == proces przy uÅ¼yciu instalatora internetowej jest nastÄ™pujÄ…cy: # Copy Web Installer na uÅ¼ytkownika folderze TEMP. # Uruchom instalator z folderu Temp. # Zaczekaj, aÅ¼ DirectX dokonuje aktualizacji. # UsuniÄ™cie przechowywanej lokalnie instalatora z folderu Temp. Aby rozpoczÄ…Ä‡, naleÅ¼y zadeklarowaÄ‡ nastÄ™pujÄ…cÄ… zmiennÄ… na poczÄ…tku skryptu NSIS: <highlight-nsis> Var DirectXSetupError </ highlight-nsis> Aby uÅ‚atwiÄ‡ ich na siebie, tworzÄ… nowÄ… sekcjÄ™ dla DirectX.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">NSIS will run the section while installing.</span> NSIS bÄ™dzie dziaÅ‚aÅ‚ punkt podczas instalacji.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">The placement of the section could go anywhere, but it's highly recommended that DirectX be ''the last install section'' after everything else is complete.</span> Umieszczanie sekcji moÅ¼na przejÅ›Ä‡ w dowolnym miejscu, ale bardzo zalecane DirectX byÄ‡''ostatnio zainstalowaÄ‡ sekcji''po wszystko, co jest kompletna.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">This is incase DirectX fails, your software will be installed. If you use component install UI, DirectX will show up as an entry.</span> To jest okrywaÄ‡ DirectX nie, program zostanie zainstalowany. Przypadku korzystania z czÄ™Å›ci instalacji interfejsu DirectX bÄ™dÄ… wyÅ›wietlane jako wejÅ›cia.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">You can force on with "SectionIn RO", or leave out if you wish the user to have the option to run the DirectX install. <highlight-nsis>Section "DirectX Install" SEC_DIRECTX SectionIn RO SetOutPath "$TEMP" File "dxwebsetup.exe" DetailPrint "Running DirectX Setup..." ExecWait '"$TEMP\dxwebsetup.exe" /Q' $DirectXSetupError DetailPrint "Finished DirectX Setup" Delete "$TEMP\dxwebsetup.exe" SetOutPath "$INSTDIR" SectionEnd</highlight-nsis> '''Note:''' I redeclare the '''SetOutPath''' to $INSTDIR.</span> MoÅ¼esz Å¼ycie z "SectionIn RO" lub pominÄ…Ä‡, jeÅ›li chcesz, aby uÅ¼ytkownik miaÅ‚ moÅ¼liwoÅ›Ä‡ uruchomienia instalacji DirectX. <highlight-nsis> Sekcji "Instalacja DirectX" SEC_DIRECTX SectionIn RO SetOutPath "$ temp" File "dxwebsetup. exe "DetailPrint" Running DirectX Setup ... "ExecWait" $ temp \ dxwebsetup.exe "/ Q" $ DirectXSetupError DetailPrint "ZakoÅ„czono DirectX Setup" Delete "$ temp \ dxwebsetup.exe" SetOutPath "$ INSTDIR" SectionEnd </ highlight -nsis>'' 'Uwaga:''' I redeclare'' 'SetOutPath''' to $ INSTDIR.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">This way shortcuts and other functions using SetOutPath won't get messed up.</span> Ten sposÃ³b skrÃ³tÃ³w i innych funkcji za pomocÄ… SetOutPath nie bÄ™dzie zawiedli.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">Alter this line accordingly. The variable $DirectXSetupError is used to force NSIS to pause while the DirectX setup is running.</span> Alter tej linii w zwiÄ…zku. ZmiennÄ… $ DirectXSetupError sÅ‚uÅ¼y do obowiÄ…zujÄ…cych NSIS wstrzymaÄ‡ konfiguracji DirectX jest uruchomiony.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">You can use the error code to further script error handling, but a variable is required to be there in order for NSIS to wait. I've also included '''DetailPrint''' lines to display the DirectX status in the install logs.</span> MoÅ¼esz uÅ¼yÄ‡ kodu bÅ‚Ä™du do dalszej obrÃ³bki bÅ‚Ä…d skryptu, ale zmienna wymagana jest tam w celu NSIS czekaÄ‡. Ive 'takÅ¼e''' DetailPrint'' 'linii do wyÅ›wietlania statusu DirectX zainstalowaÄ‡ dziennikÃ³w.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">These strings can be localized to your liking.</span> Takie Å‚aÅ„cuchy mogÄ… byÄ‡ zlokalizowane do swoich potrzeb.</span>
+==Installing DirectX==
 ==See Also==

79.162.3.49: /* Installing DirectX */

2010-03-13T20:55:43Z

Installing DirectX

@@ Line 22: / Line 22: @@
 The obvious flaw is when a user has unreliable Internet access. The web installer isn't very smart and will take a long time to exit if the Internet doesn't exist for the end user. You will need to introduce messaging to the user that explains the update will work best with Internet access.
-==Installing DirectX==
+<span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">==Installing DirectX== The process of using the web installer is the following: # Copy the Web Installer onto the user's TEMP folder. # Run the installer from the TEMP folder. # Wait till DirectX is done updating. # Remove the locally stored installer from the TEMP folder. To start, you will need to declare the following variable early in the NSIS script: <highlight-nsis>Var DirectXSetupError</highlight-nsis> To make things easier on yourself, create a new Section for DirectX.</span> == Instalacja DirectX == proces przy uÅ¼yciu instalatora internetowej jest nastÄ™pujÄ…cy: # Copy Web Installer na uÅ¼ytkownika folderze TEMP. # Uruchom instalator z folderu Temp. # Zaczekaj, aÅ¼ DirectX dokonuje aktualizacji. # UsuniÄ™cie przechowywanej lokalnie instalatora z folderu Temp. Aby rozpoczÄ…Ä‡, naleÅ¼y zadeklarowaÄ‡ nastÄ™pujÄ…cÄ… zmiennÄ… na poczÄ…tku skryptu NSIS: <highlight-nsis> Var DirectXSetupError </ highlight-nsis> Aby uÅ‚atwiÄ‡ ich na siebie, tworzÄ… nowÄ… sekcjÄ™ dla DirectX.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">NSIS will run the section while installing.</span> NSIS bÄ™dzie dziaÅ‚aÅ‚ punkt podczas instalacji.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">The placement of the section could go anywhere, but it's highly recommended that DirectX be ''the last install section'' after everything else is complete.</span> Umieszczanie sekcji moÅ¼na przejÅ›Ä‡ w dowolnym miejscu, ale bardzo zalecane DirectX byÄ‡''ostatnio zainstalowaÄ‡ sekcji''po wszystko, co jest kompletna.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">This is incase DirectX fails, your software will be installed. If you use component install UI, DirectX will show up as an entry.</span> To jest okrywaÄ‡ DirectX nie, program zostanie zainstalowany. Przypadku korzystania z czÄ™Å›ci instalacji interfejsu DirectX bÄ™dÄ… wyÅ›wietlane jako wejÅ›cia.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">You can force on with "SectionIn RO", or leave out if you wish the user to have the option to run the DirectX install. <highlight-nsis>Section "DirectX Install" SEC_DIRECTX SectionIn RO SetOutPath "$TEMP" File "dxwebsetup.exe" DetailPrint "Running DirectX Setup..." ExecWait '"$TEMP\dxwebsetup.exe" /Q' $DirectXSetupError DetailPrint "Finished DirectX Setup" Delete "$TEMP\dxwebsetup.exe" SetOutPath "$INSTDIR" SectionEnd</highlight-nsis> '''Note:''' I redeclare the '''SetOutPath''' to $INSTDIR.</span> MoÅ¼esz Å¼ycie z "SectionIn RO" lub pominÄ…Ä‡, jeÅ›li chcesz, aby uÅ¼ytkownik miaÅ‚ moÅ¼liwoÅ›Ä‡ uruchomienia instalacji DirectX. <highlight-nsis> Sekcji "Instalacja DirectX" SEC_DIRECTX SectionIn RO SetOutPath "$ temp" File "dxwebsetup. exe "DetailPrint" Running DirectX Setup ... "ExecWait" $ temp \ dxwebsetup.exe "/ Q" $ DirectXSetupError DetailPrint "ZakoÅ„czono DirectX Setup" Delete "$ temp \ dxwebsetup.exe" SetOutPath "$ INSTDIR" SectionEnd </ highlight -nsis>'' 'Uwaga:''' I redeclare'' 'SetOutPath''' to $ INSTDIR.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">This way shortcuts and other functions using SetOutPath won't get messed up.</span> Ten sposÃ³b skrÃ³tÃ³w i innych funkcji za pomocÄ… SetOutPath nie bÄ™dzie zawiedli.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">Alter this line accordingly. The variable $DirectXSetupError is used to force NSIS to pause while the DirectX setup is running.</span> Alter tej linii w zwiÄ…zku. ZmiennÄ… $ DirectXSetupError sÅ‚uÅ¼y do obowiÄ…zujÄ…cych NSIS wstrzymaÄ‡ konfiguracji DirectX jest uruchomiony.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">You can use the error code to further script error handling, but a variable is required to be there in order for NSIS to wait. I've also included '''DetailPrint''' lines to display the DirectX status in the install logs.</span> MoÅ¼esz uÅ¼yÄ‡ kodu bÅ‚Ä™du do dalszej obrÃ³bki bÅ‚Ä…d skryptu, ale zmienna wymagana jest tam w celu NSIS czekaÄ‡. Ive 'takÅ¼e''' DetailPrint'' 'linii do wyÅ›wietlania statusu DirectX zainstalowaÄ‡ dziennikÃ³w.</span> <span onmouseover="_tipon(this)" onmouseout="_tipoff()"><span class="google-src-text" style="direction: ltr; text-align: left">These strings can be localized to your liking.</span> Takie Å‚aÅ„cuchy mogÄ… byÄ‡ zlokalizowane do swoich potrzeb.</span>
 ==See Also==

Seg telltale: Created page with 'The following is for NSIS installations that need DirectX and you assume the user to be connected to the Internet. While this isn't completely full-proof, it's better than adding…'

2009-08-10T22:06:27Z

Created page with 'The following is for NSIS installations that need DirectX and you assume the user to be connected to the Internet. While this isn't completely full-proof, it's better than adding…'

New page

The following is for NSIS installations that need DirectX and you assume the user to be connected to the Internet. While this isn't completely full-proof, it's better than adding over 100mb to your install file.

For off-line installers, especially when distributed via DVD, CD-ROM or other fixed media, see [[DirectX Installation for Fixed Media]].

==Prerequisites==

Obtain the latest [http://www.microsoft.com/DOWNLOADS/details.aspx?FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 DirectX End-User Runtime Web Installer] from Microsoft. It's very small as it dynamically pulls the content it needs when run.

This script also assumes the NSIS installer is requesting Admin privileges in the form of '''RequestExecutionLevel''' ''admin''.

==About the Web Installer==

When you run the Web installer, the installer will do the following:

# Examine the user's current DirectX install.
# Obtain a list of all available DirectX files from the Microsoft servers.
# Compare the local install with the latest available.
# Download files not existent on the user computer.
# Install the new files.
# Clean up the existing DirectX install.

The obvious flaw is when a user has unreliable Internet access. The web installer isn't very smart and will take a long time to exit if the Internet doesn't exist for the end user. You will need to introduce messaging to the user that explains the update will work best with Internet access.

==Installing DirectX==

The process of using the web installer is the following:

# Copy the Web Installer onto the user's TEMP folder.
# Run the installer from the TEMP folder.
# Wait till DirectX is done updating.
# Remove the locally stored installer from the TEMP folder.

To start, you will need to declare the following variable early in the NSIS script:

<highlight-nsis>Var DirectXSetupError</highlight-nsis>

To make things easier on yourself, create a new Section for DirectX. NSIS will run the section while installing. The placement of the section could go anywhere, but it's highly recommended that DirectX be ''the last install section'' after everything else is complete. This is incase DirectX fails, your software will be installed.

If you use component install UI, DirectX will show up as an entry. You can force on with "SectionIn RO", or leave out if you wish the user to have the option to run the DirectX install.

<highlight-nsis>Section "DirectX Install" SEC_DIRECTX

SectionIn RO

SetOutPath "$TEMP"
File "dxwebsetup.exe"
DetailPrint "Running DirectX Setup..."
ExecWait '"$TEMP\dxwebsetup.exe" /Q' $DirectXSetupError
DetailPrint "Finished DirectX Setup"

Delete "$TEMP\dxwebsetup.exe"

SetOutPath "$INSTDIR"

SectionEnd</highlight-nsis>

'''Note:''' I redeclare the '''SetOutPath''' to $INSTDIR. This way shortcuts and other functions using SetOutPath won't get messed up. Alter this line accordingly.

The variable $DirectXSetupError is used to force NSIS to pause while the DirectX setup is running. You can use the error code to further script error handling, but a variable is required to be there in order for NSIS to wait.

I've also included '''DetailPrint''' lines to display the DirectX status in the install logs. These strings can be localized to your liking.

==See Also==

* [http://msdn.microsoft.com/library/bb174600(VS.85).aspx Installing DirectX with DirectSetup]
* [http://msdn.microsoft.com/directx/ DirectX SDK Documentation]

[[Category:DirectX|Installation with Web Installer, DirectX]]
[[Category:Code_Examples]]