Difference between revisions of "SDK Installation (FSX)"

From FSDeveloper Wiki
Jump to: navigation, search
m (Installation)
m (Rollout FS versions)
 
(194 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 
{{Infobox-Applicable-FSVersion
 
{{Infobox-Applicable-FSVersion
 +
| FS2020 = unknown
 
| FSXI = false
 
| FSXI = false
 +
| P3D4 = unknown
 +
| P3D3 = unknown
 +
| P3D2 = unknown
 +
| P3D = unknown
 +
| FSW = false
 +
| FSXSE = false
 
| FSXA = true
 
| FSXA = true
 
| FSX = true
 
| FSX = true
 
| FS2004 = false
 
| FS2004 = false
 
| FS2002 = false
 
| FS2002 = false
| FS2000 = unknown
+
| XP11 = false
| FS98 = unknown
+
| XP10 = false
 +
| XP9 = false
 +
 
 
}}
 
}}
 
{{:Transclusion-SDK-Oneline-Installation}}
 
{{:Transclusion-SDK-Oneline-Installation}}
Line 13: Line 22:
 
The majority of the tools are command-line based, but some are accessible via the in-game '''Tools''' menu, (not the GUI).
 
The majority of the tools are command-line based, but some are accessible via the in-game '''Tools''' menu, (not the GUI).
 
<br>
 
<br>
* '''Print out this page, and work from that.'''
 
* Read through thoroughly before commencing installation.
 
* Ensure you've followed '''ALL''' instructions before you request assistance.
 
 
<br>
 
<br>
 +
 +
== Availability ==
 +
* The SDK is available in '''FSX Deluxe''' only, (not '''FSX Standard''').
 +
* '''FSX Standard''' users can obtain the SDK, by purchasing and installing '''FSX Acceleration''', (or '''FSX Gold''' - Contains both Deluxe & Acceleration).
 +
 +
 
== Prerequisites ==
 
== Prerequisites ==
=== Availability ===
+
 
* The [[SDK]] is available in the '''[[FSX]] Deluxe''' package only, (not on '''FSX Standard''').
+
=== Essential Components ===
* Purchasers of '''[[FSX]] Standard''' can obtain the SDK by purchasing and installing '''[[FSX]] Acceleration'''.
+
Before installing the SDK, certain essential components need to be present on your PC.
* '''[[FSX]] Deluxe''' users must as a minimum have the RTM FSX SDK installed before attempting to upgrade to the SDK Service Packs.
+
 
 +
 
 +
If you have ''correctly'' installed FSX on your PC, (i.e. using the ''Administrator'' account),
 +
<br>
 +
the FSX installer mechanism checked for their presence,
 +
<br>
 +
and if nescessary, installed them prior to performing the FSX install.
 +
<br>
 +
You should still run ''Windows Update'' before installing the SDK.
 +
 
 +
 
 +
 
 +
If you are installing the SDK on a PC without FSX installed,
 +
<br>
 +
there are '''4 non-optional tasks''' you must perform first -
 
<br>
 
<br>
* FSX must not be running whilst installing the SDK.
 
* After editing either fsx.CFG or dll.xml, FSX must be restarted, (they're only read on FSX launch).
 
=== .NET v2 ===
 
Several tools '''require''' Microsoft .NET Framework Version 2.0 ''to be installed '''first'''''.
 
 
<br>
 
<br>
Download from -
 
[http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displaylang=en Microsoft Downloads - .NET Framework Version 2.0]
 
  
After installing ''.NET v 2'', (and rebooting if required), ensure you then run Windows Update to obtain subsequent patches.
+
==== .NET 2.0 ====
 +
''Microsoft .NET Framework Version '''2.0''' must be installed '''first''''', (an FSX prerequisite).
 
<br>
 
<br>
Then reinstall/repair the SDK.
+
Download the redistributable appropriate to your operating system :
 +
* '''x86''' - [http://www.microsoft.com/en-us/download/details.aspx?id=1639 Microsoft Downloads - .NET Framework Version 2.0 (x86) ] (includes SPs)
 +
* '''x64''' - [http://www.microsoft.com/en-us/download/details.aspx?id=6523 Microsoft Downloads - .NET Framework Version 2.0 (x64)]
  
'''Please note -'''
+
'''Please note''':
 +
<br>
 +
All ''.NET'' versions are '''supplemental'''
 +
<br>
 +
they are '''not replacement''' versions !
 +
<br>
 +
<br>
 +
 
 +
==== VC2005 Redist ====
 +
The ''Microsoft Visual C++ 2005 Redistributable Package'' must be installed first, (an FSX prerequisite).
 +
<br>
 +
Download from:
 +
[http://www.microsoft.com/en-us/download/details.aspx?id=3387 Microsoft Downloads - VC++ 2005 Redistributable]
 +
<br>
 +
<br>
 +
 
 +
==== XML4 ====
 +
''XML4''  must be installed first, (an FSX prerequisite).
 +
<br>
 +
Download from:
 +
[http://www.microsoft.com/downloads/details.aspx?FamilyID=7f6c0cb4-7a5e-4790-a7cf-9e139e6819c0&displaylang=en Microsoft Downloads - MS XML4] (includes SPs)
 +
 
 +
'''Please note''':
 +
<br>
 +
''MSXML'' versions are '''supplemental'''
 +
<br>
 +
they are '''not replacement''' versions !
 +
<br>
 +
<br>
 +
 
 +
=== Windows Update ===
 +
<span style="background-color:yellow;color:black;">''Windows Update'' '''must''' then run to obtain any subsequent patches,
 +
<br>
 +
before attempting to install/reinstall/repair the SDK or apply any Service Packs.</span>
 
<br>
 
<br>
''.NET v 3'' is '''supplemental''' to ''.NET v 2'',
 
 
<br>
 
<br>
it is not a replacement version !
 
  
 
== Installation ==
 
== Installation ==
 +
* Users must have Administrator privileges to install the SDK, (particularly important on Vista or later).
 +
* ''FSX Deluxe'' users must as a minimum have installed the FSX RTM SDK, before attempting to upgrade to the SDK Service Packs.
 +
* FSX must not be running whilst installing the SDK, or any Service Packs.
 +
* FSX must be restarted after editing either fsx.CFG or dll.xml, (as they're only read on FSX launch).
 +
* Do not copy SDK-DLLs into your FSX modules folder, (it's totally unnecessary).
 +
* When installing/upgrading/repairing the SDK, there is no need whatsoever to uninstall/reinstall the ''FSX game''.
 +
 +
 
=== Versions ===
 
=== Versions ===
The FSX '''simulator''' has '''Service Packs.'''
+
''Service Packs'' are available for both the ''FSX game'' and ''FSX SDK''.
 +
 
 +
 
  
The FSX '''SDK''' has '''Service Packs.'''
+
<span style="background-color:yellow;color:black; font-size:150%;">You '''must''' install the appropriate '''SDK SP''' version,
 +
<br>
 +
which corresponds to your '''FSX game SP''' version.</span>
  
{| class="h1" style="background:#FF0000" border="1"
 
|--
 
| style="font-size:200%;" |<br>&nbsp;&nbsp;&nbsp;You MUST install  <br><br>&nbsp;&nbsp;&nbsp;the appropriate SDK Service Pack version <br><br>&nbsp;&nbsp;&nbsp;to match your FSX Service Pack version. &nbsp;&nbsp;&nbsp;<br><br>
 
|}
 
  
  
Find your installed FSX version in the FSX column, read the matching SDK column/row details.
+
Find your installed<span style="background-color:yellow;color:black;"> FSX version </span>in the FSX column,  
 +
<br>read the matching<span style="background-color:yellow;color:black;"> SDK version </span>column/row details.
 
{| class="prettytable" style="background:#f2f2f2" border="0"
 
{| class="prettytable" style="background:#f2f2f2" border="0"
 
|--
 
|--
| style="background:#FF0000; font-size:200%;" | '''FSX'''
+
| style="background:yellow; font-size:120%;" | '''FSX version'''
| style="background:#808080; font-size:100%;" | '''ID#'''
+
| style="background:#B0B0B0; font-size:120%;" | '''Version ID#'''
| style="background:#FF0000; font-size:200%;" | '''SDK'''
+
| style="background:yellow; font-size:120%;" | '''SDK version'''
| style="background:#808080; font-size:100%;" | '''Availability'''
+
| style="background:#B0B0B0; font-size:120%;" | '''Availability'''
| style="background:#808080;" | '''Installer'''
+
| style="background:#B0B0B0; font-size:120%;" | '''Installer'''
| style="background:#808080;" | '''Location'''
+
| style="background:#B0B0B0; font-size:120%;" | '''Location'''
 
|-
 
|-
| style="background:#F8EABA;" | RTM
+
| style="background:#F8EABA;" | '''RTM (Deluxe)'''
 
| style="background:#F8EABA;" | 10.0.60905
 
| style="background:#F8EABA;" | 10.0.60905
| style="background:#F8EABA;" | RTM
+
| style="background:#F8EABA;" | '''RTM'''
| style="background:#F8EABA;" | Retail
+
| style="background:#F8EABA;" | Retail only
 
| style="background:#F8EABA;" | sdk.msi
 
| style="background:#F8EABA;" | sdk.msi
 
| style="background:#F8EABA;" | FSX RTM disk 1, SDK sub-folder
 
| style="background:#F8EABA;" | FSX RTM disk 1, SDK sub-folder
Line 72: Line 135:
 
| style="background:#F8EABA;" |  
 
| style="background:#F8EABA;" |  
 
| style="background:#F8EABA;" |  
 
| style="background:#F8EABA;" |  
| style="background:#F8EABA;" | SP1
+
| style="background:#F8EABA;" | '''SP1'''
 
| style="background:#F8EABA;" | Discontinued
 
| style="background:#F8EABA;" | Discontinued
 
| style="background:#F8EABA;" | N/A
 
| style="background:#F8EABA;" | N/A
 
| style="background:#F8EABA;" | Standalone
 
| style="background:#F8EABA;" | Standalone
|--
 
|
 
|
 
|
 
|
 
 
|-
 
|-
|
+
| '''SP1'''
|
 
|
 
|
 
|-
 
| SP1
 
 
| 10.0.61355<br>(Russian: 10.0.61357)
 
| 10.0.61355<br>(Russian: 10.0.61357)
| SP1A
+
| '''SP1A'''
| [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=24910e66-96b0-4543-9b4a-647b7e28f212 Download * (166Mb)]
+
| [https://www.dropbox.com/s/qmda3pt27fdao9z/FS_X_SDK_SP1a.zip?dl=0 Download (192Mb)] *
| fsx_sdk_sp1a.exe
+
| fsx_sdk_sp1a.zip
| Standalone '''(Updated)'''
+
| Standalone
|-
 
|
 
|
 
|
 
|
 
|-
 
|
 
|
 
|
 
|
 
 
|-
 
|-
| style="background:#C0C090;" | SP2
+
| style="background:#C0C090;" | '''SP2'''
 
| style="background:#C0C090;" | 10.0.61472
 
| style="background:#C0C090;" | 10.0.61472
| style="background:#C0C090;" | SP2
+
| style="background:#C0C090;" | '''SP2'''
| style="background:#C0C090;" | [http://download.microsoft.com/download/3/C/A/3CAD9417-A0BE-4892-9224-4A4479F9F633/sdk.msi Download * (211Mb)]
+
| style="background:#C0C090;" | [http://download.microsoft.com/download/3/C/A/3CAD9417-A0BE-4892-9224-4A4479F9F633/sdk.msi Download (211Mb)] *
 
| style="background:#C0C090;" | sdk.msi
 
| style="background:#C0C090;" | sdk.msi
| style="background:#C0C090;" | Standalone '''(Updated)'''
+
| style="background:#C0C090;" | Standalone
 
|-
 
|-
| style="background:#C0C090;" | Acceleration
+
| style="background:#C0C090;" | '''Acceleration'''
 
| style="background:#C0C090;" | 10.0.61637
 
| style="background:#C0C090;" | 10.0.61637
| style="background:#C0C090;" | SP2/XPack
+
| style="background:#C0C090;" | '''SP2/XPack'''
| style="background:#C0C090;" | Retail
+
| style="background:#C0C090;" | Retail only
 
| style="background:#C0C090;" | sdk.msi
 
| style="background:#C0C090;" | sdk.msi
 
| style="background:#C0C090;" | FSX Acceleration disk, SDK sub-folder
 
| style="background:#C0C090;" | FSX Acceleration disk, SDK sub-folder
Line 120: Line 163:
  
 
'''*''' May also be available on magazine cover discs.
 
'''*''' May also be available on magazine cover discs.
=== Version Notes ===
 
You must as a minimum have the FSX RTM SDK installed
 
<br>
 
before attempting to upgrade to the SDK Service Packs.
 
  
==== RTM FSX Users ====
+
 
To install the RTM FSX SDK -
+
==== FSX Deluxe RTM users ====
 +
To install the SDK for FSX RTM:
 
# FSX must not be running.
 
# FSX must not be running.
 
# Browse the '''FSX Deluxe Edition disk 1'''
 
# Browse the '''FSX Deluxe Edition disk 1'''
 
# Open the '''SDK''' sub-folder
 
# Open the '''SDK''' sub-folder
 
# Double-click the '''setup.exe'''
 
# Double-click the '''setup.exe'''
# Tell it where to install.
+
# Tell it where to install
<br>
 
 
Default installation location is '''C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK'''
 
Default installation location is '''C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK'''
  
==== Acceleration/SP2 Users ====
 
The SDK supplied with the Acceleration package includes the SP2 SDK, plus Acceleration specific data.
 
<br>
 
A prior version of the SDK must be present on your PC before upgrading to SDK SP2.
 
 
The additional copy of SDK SP1a is only provided on the Acceleration disk, to allow you to do so.
 
 
==== SP2 (non-Acceleration) Users ====
 
Before attempting upgrading to SDK SP2,
 
the SDK '''must''' be at '''SP1a''' level.
 
 
If not, you will need to upgrade to SDK SP1a first.
 
<br>
 
You must have installed the SDK versions in the correct sequence, (see table above).
 
 
=== All Users ===
 
'''Do not copy SDK-DLLs into your FSX modules folder''', (it's totally unnescessary).
 
 
== Documentation ==
 
'''RTM''', '''SP1''', & '''SP1a''' documentation is supplied in '''html''' format, with each folder containing the relevant html file(s).
 
 
'''SP2''' documentation is supplied in '''chm''' format, as a single compiled html file, '''fsxsdk.chm'''.<br>
 
located by default in '''C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK'''
 
 
If your SDK is still in HTML format,
 
<br>
 
rather than the Windows Help File format, (CHM),
 
<br>
 
then you've installed SDK SP1a, and not SDK SP2.
 
 
== Configuration ==
 
If you had installed both FSX & SDK to their default locations,
 
<br>
 
as a quick indicator that the SDK is correctly installed,
 
<br>
 
the OPT should now be available from the FSX Tools menu.
 
 
If you had installed either FSX or the SDK to a non-default location,
 
<br>
 
you should run '''configsdk.exe''' located in the SDK root folder.
 
 
'''N.B.'''
 
<br>
 
Running configsdk.exe will only correct the registry paths.
 
<br>
 
It will not update/correct the user's '''dll.xml''' file, (see FSX in-game Tools menu below).
 
 
== FSX in-game Tools menu ==
 
The Tools menu is accessed from within a flight, (not the main GUI).
 
  
The only SDK tools available in-game, are the Object placement tool, 3 traffic tools, and the effects tool.
 
  
All other tools are run/started from outside the sim GUI.
+
<span style="background-color:yellow;color:black;">Before applying any ''Service Packs'',
 
<br>
 
<br>
Look in the root of where you'd installed the SDK, or
+
you should copy the '''GMax installer folder''' to another location, (outwith SDK folder tree),
 
<br>
 
<br>
Start -> All Programs -> Microsoft Games -> Microsoft Flight Simulator X SDK -> Flight Simulator X SDK
+
as applying the ''SP'' will delete the '''GMax installer folder'''.</span>
 
 
If having correctly followed '''all''' the above instructions,
 
and the '''Tools''' menu is still not displaying,
 
there are 3 aspects you need to investigate -
 
* Addons
 
* dll.xml
 
* fsx.CFG
 
All changes must be made with FSX shut down.
 
 
 
=== Addons ===
 
'''Incorrect addon versions may prevent the Tools menu from loading entirely.'''
 
{| class="h1" style="background:#FF0000" border="1"
 
|--
 
| style="font-size:200%;" |<br>&nbsp;&nbsp;&nbsp;You MUST install  <br><br>&nbsp;&nbsp;&nbsp;ALL the appropriate Addon updates <br><br>&nbsp;&nbsp;&nbsp;to match your SDK Service Pack version. &nbsp;&nbsp;&nbsp;<br><br>
 
|}
 
 
 
Ensure you are using the latest version of any addons, (e.g. FSUIPC).<br>
 
Important particularly when you upgrade FSX to a newer service pack.
 
  
If the '''Tools''' menu still doesn't load -
 
* '''Remove all addon entries'''.
 
* Ensure the MS SDK tools load.
 
* One by one, re-apply your addons, checking each time to confirm the '''Tools''' menu is still present.
 
  
=== dll.xml ===
+
==== FSX Deluxe SP1 users ====
If the FSX Tools menu option is still not displaying,
+
To install the SDK for FSX SP1:
you may need to edit dll.xml manually, to -
+
# Download FSX SDK SP1A
* include the full paths for the SDK entries.
+
# Install the FSX Deluxe RTM SDK (see instructions above)
* set disabled to false
+
# Install the FSX SDK SP1A that you downloaded
* remove all addon entries.
 
  
Any changes will not be reflected till next time you start FSX.
 
  
==== Location ====
+
==== FSX Deluxe SP2 users ====
{| class="h1" style="background:#FF0000" border="1"
+
'''For standalone SP2 users only !'''  
|--
 
| style="font-size:200%;" |<br>&nbsp;&nbsp;&nbsp;There are several example/backup '''dll.xml''' files &nbsp;&nbsp;&nbsp;<br><br>&nbsp;&nbsp;&nbsp;located in the -&nbsp;&nbsp;&nbsp;<br><br>&nbsp;&nbsp;&nbsp;- SDK subfolders, (4 example dll.xml)<br><br>&nbsp;&nbsp;&nbsp;- FSX root folder, (default dll.xml backup copy).&nbsp;&nbsp;&nbsp;<br><br>&nbsp;&nbsp;&nbsp;IGNORE THOSE - They are irrelevant.<br>&nbsp;&nbsp;&nbsp;
 
|}
 
<br>
 
'''There is only one relevant dll.xml '''
 
<br>
 
'''dll.xml file is located in your ''%APPDATA%'' folder '''
 
<br>
 
'''that's the same location as your ''fsx.cfg'', at''' -
 
<br>
 
<br>
 
{| class="prettytable" style="background:#f2f2f2" border="0"
 
|--
 
| style="background:#808080;" | '''OS'''
 
| style="background:#808080;" | '''dll.xml location'''
 
|--
 
| style="background:#F8EABA;" | XP
 
| style="background:#F8EABA;" | C:\Documents and Settings\USERNAME\Application Data\Microsoft\FSX\
 
|--
 
| style="background:#C0C090;" | Vista
 
| style="background:#C0C090;" | C:\Users\USERNAME\AppData\Roaming\Microsoft\FSX\
 
|--
 
| style="background:#F8EABA;" | Win7
 
| style="background:#F8EABA;" | C:\Users\USERNAME\AppData\Roaming\Microsoft\FSX\
 
|}
 
 
<br>
 
<br>
 +
(All Acceleration Pack users please see instructions below at ''FSX Acceleration Pack Users'').
  
==== Editing ====
+
To install the SDK for FSX SP2:
You must use a '''text editor''', e.g. Notepad, or an XML editor.
+
# Download FSX SDK SP2
 +
# Install the FSX Deluxe RTM SDK (see instructions above)
 +
# Install the FSX SDK SP1A (see instructions above)
 +
# Install the FSX SDK SP2 that you downloaded
  
You must not use ''Word'' or ''Wordpad'' as they will corrupt the file.
 
  
==== Paths ====
+
==== FSX Acceleration Pack OR FSX Gold Pack users ====
The defined paths must be correct.
+
To install the SDK for FSX Acceleration Pack '''OR''' FSX Gold Pack:
 +
# Install the '''RTM SDK''' from '''FSX Deluxe Edition disk 1''', (see 3.1.1 FSX Deluxe RTM users  instructions above).
 +
# Insert your '''Acceleration Pack DVD'''.
 +
# Browse to the subfolder called '''SDK\SP1a\'''
 +
# Install the '''SDK SP1A''' from there using '''fsx_sdk_sp1a.exe''', (dated 26/09/2007, size 165,569KB).
 +
# Browse to the folder called '''SDK\'''
 +
# Install the '''Acceleration SP2/XPack SDK''' using '''sdk.msi''', (dated 06/10/2007, size 216,929KB).
  
Remark: If you had copies of the SDK-DLLs installed in your FSX modules folder you will have to copy the new versions manually after installation of the SDK SP2.
 
  
===== Default Installation Location =====
+
==== FSX Standard users who've installed Acceleration Pack ====
A '''relative path''' e.g.
+
'''For FSX Standard users only !'''
<br>
 
..\Microsoft Flight Simulator X SDK\SDK\Mission Creation Kit\object_placement.dll
 
  
is relative to the FSX default location -
+
Do '''not''' use the '''downloadable''' SDK SP1A version, (it ''supposedly'' doesn't contain the nescessary components).
<br>
 
C:\Program Files\Microsoft Games\Microsoft Flight Simulator X
 
  
===== Non-Default Installation Location =====
+
To install the SDK for FSX Acceleration Pack:
If either FSX or the SDK is installed to a non-standard location<br>
+
# Insert your '''Acceleration Pack DVD'''.
then use a '''full path''' (aka absolute path). e.g.
+
# Browse to the subfolder called '''SDK\SP1a\'''
 +
# Install the '''SDK SP1A''' from there using '''fsx_sdk_sp1a.exe''', (dated 26/09/2007, size 165,569KB).
 +
# Browse to the folder called '''SDK\'''
 +
# Install the '''Acceleration SP2/XPack SDK''' using '''sdk.msi''', (dated 06/10/2007, size 216,929KB).
 
<br>
 
<br>
C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK\Mission Creation Kit\Object_Placement.dll
 
  
If you'd installed the SDK to your '''F:''' drive,
+
=== Important ===
then the '''full path''' would be -
+
Do not attempt to install the original retail version of the ''Flight Simulator X SDK'' over an updated ''SDK'', as unpredictable results can occur. 
 
<br>
 
<br>
'''F:\'''Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK\Mission Creation Kit\Object_Placement.dll
+
See the troubleshooting link below.
 
 
==== Disabled ====
 
Each of the 3 SDK tools need to be set as follows.
 
<pre>
 
<Disabled>False</Disabled>
 
<ManualLoad>False</ManualLoad>
 
</pre>
 
 
 
=== fsx.CFG ===
 
{{:Ambox-Content-WIP}}
 
DRAFT SECTION
 
 
 
 
 
==== Trusted ====
 
On initial install of the SDK,
 
then subsequent first FSX run,
 
you are prompted whether to trust/allow each of the 3 SDK in-game tools to run.
 
 
 
Did you ever say no ?
 
 
 
 
 
 
 
Please open your fsx.cfg in a text editor.
 
 
 
Look for the '''[Trusted]''' section
 
find the 3 tools entries,
 
these may appear multiple times, (one for each SDK version).
 
 
 
These are the entries for mine.
 
<pre>
 
C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK\Mission Creation Kit\Object_Placement.dll.LONGSTRING=1
 
C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK\Environment Kit\Traffic Toolbox SDK\traffictoolbox.dll.LONGSTRING=1
 
C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK\SDK\Environment Kit\Special Effects SDK\visualfxtool.dll.LONGSTRING=1
 
</pre>
 
Where LONGSTRING is a 'meaningless' alphanumeric string.
 
<br>
 
The final value should be '''=1'''
 
 
 
Is it ?
 
<br>
 
If not, change it to '''=1'''
 
 
 
Fire up FSX.
 
<br>
 
Do the tools now display ?
 
 
 
==== Vista users ====
 
If that doesn't work,
 
 
<br>
 
<br>
it may possible be that part of your fsx.CFG is corrupted,
 
 
<br>
 
<br>
(contains an inappropriate character).
 
 
Try renaming your fsx.cfg
 
<br>
 
to fsx_TODAYSDATE.cfg
 
 
Fire up FSX,
 
<br>
 
it'll rebuild the fsx.CFG
 
<br>
 
and prompt for the required permissions.
 
 
 
 
 
 
The 1's not sticking.
 
 
It's because Vista treats all ''.cfg'' files as being ''system'' files.
 
 
It opens a copy, and then saves your edited/changed file to somewhere else, (personal folders).
 
 
Next time you open fsx.CFG,
 
Vista is giving you the original.
 
 
  
{| class="h1" style="background:#FF0000" border="1"
+
== Troubleshooting ==
|--
+
For all troubleshooting and repair processes,
| style="font-size:200%;" |<br>&nbsp;&nbsp;&nbsp;Go back and read it again ! &nbsp;&nbsp;&nbsp;<br>&nbsp;&nbsp;&nbsp;
 
|}
 
 
 
== Still having problems ? ==
 
You can post a request for assistance to the FSDeveloper forums
 
<br>
 
but before doing so
 
 
<br>
 
<br>
'''we need some basic information about your system'''.
+
please see -  [[SDK_Installation_(FSX)_-_Troubleshooting]]
  
  
Please download [http://www.interkultur.de/gossmann/FSD/ADE-Check.zip Martin Gossman's '''ADE-Checker''']
+
<span style="background-color:red;color:yellow; font-size:150%;">DO NOT post any help request in the FSDeveloper forums
 
 
Run ADE-Checker
 
 
<br>
 
<br>
and it will generate an output about your PC configuration
+
BEFORE you've completed the '''[[SDK_Installation_(FSX)_-_Troubleshooting]]''' process. </span>
<br>
 
allowing us to identify which/if any components are installed/missing.
 
 
 
Please save the report and post it to this forum. (Link to be added)
 
  
 
== Related ==
 
== Related ==
=== Internal ===
 
 
{{Template:Navbox-SDK (FSX)-Related}}
 
{{Template:Navbox-SDK (FSX)-Related}}
 
=== External ===
 
Placeholder text
 
  
 
[[Category:Aircraft Design]]  
 
[[Category:Aircraft Design]]  

Latest revision as of 09:36, 28 March 2020

How to install the SDK for FSX/FSXA.

The Software Development Kit (SDK) is a set of development tools which allow you to develop, create or modify content for the simulation.
The majority of the tools are command-line based, but some are accessible via the in-game Tools menu, (not the GUI).

Availability

  • The SDK is available in FSX Deluxe only, (not FSX Standard).
  • FSX Standard users can obtain the SDK, by purchasing and installing FSX Acceleration, (or FSX Gold - Contains both Deluxe & Acceleration).


Prerequisites

Essential Components

Before installing the SDK, certain essential components need to be present on your PC.


If you have correctly installed FSX on your PC, (i.e. using the Administrator account),
the FSX installer mechanism checked for their presence,
and if nescessary, installed them prior to performing the FSX install.
You should still run Windows Update before installing the SDK.


If you are installing the SDK on a PC without FSX installed,
there are 4 non-optional tasks you must perform first -

.NET 2.0

Microsoft .NET Framework Version 2.0 must be installed first, (an FSX prerequisite).
Download the redistributable appropriate to your operating system :

Please note:
All .NET versions are supplemental
they are not replacement versions !

VC2005 Redist

The Microsoft Visual C++ 2005 Redistributable Package must be installed first, (an FSX prerequisite).
Download from: Microsoft Downloads - VC++ 2005 Redistributable

XML4

XML4 must be installed first, (an FSX prerequisite).
Download from: Microsoft Downloads - MS XML4 (includes SPs)

Please note:
MSXML versions are supplemental
they are not replacement versions !

Windows Update

Windows Update must then run to obtain any subsequent patches,
before attempting to install/reinstall/repair the SDK or apply any Service Packs.


Installation

  • Users must have Administrator privileges to install the SDK, (particularly important on Vista or later).
  • FSX Deluxe users must as a minimum have installed the FSX RTM SDK, before attempting to upgrade to the SDK Service Packs.
  • FSX must not be running whilst installing the SDK, or any Service Packs.
  • FSX must be restarted after editing either fsx.CFG or dll.xml, (as they're only read on FSX launch).
  • Do not copy SDK-DLLs into your FSX modules folder, (it's totally unnecessary).
  • When installing/upgrading/repairing the SDK, there is no need whatsoever to uninstall/reinstall the FSX game.


Versions

Service Packs are available for both the FSX game and FSX SDK.


You must install the appropriate SDK SP version,
which corresponds to your FSX game SP version.


Find your installed FSX version in the FSX column,
read the matching SDK version column/row details.

FSX version Version ID# SDK version Availability Installer Location
RTM (Deluxe) 10.0.60905 RTM Retail only sdk.msi FSX RTM disk 1, SDK sub-folder
SP1 Discontinued N/A Standalone
SP1 10.0.61355
(Russian: 10.0.61357)
SP1A Download (192Mb) * fsx_sdk_sp1a.zip Standalone
SP2 10.0.61472 SP2 Download (211Mb) * sdk.msi Standalone
Acceleration 10.0.61637 SP2/XPack Retail only sdk.msi FSX Acceleration disk, SDK sub-folder

* May also be available on magazine cover discs.


FSX Deluxe RTM users

To install the SDK for FSX RTM:

  1. FSX must not be running.
  2. Browse the FSX Deluxe Edition disk 1
  3. Open the SDK sub-folder
  4. Double-click the setup.exe
  5. Tell it where to install

Default installation location is C:\Program Files\Microsoft Games\Microsoft Flight Simulator X SDK


Before applying any Service Packs,
you should copy the GMax installer folder to another location, (outwith SDK folder tree),
as applying the SP will delete the GMax installer folder.


FSX Deluxe SP1 users

To install the SDK for FSX SP1:

  1. Download FSX SDK SP1A
  2. Install the FSX Deluxe RTM SDK (see instructions above)
  3. Install the FSX SDK SP1A that you downloaded


FSX Deluxe SP2 users

For standalone SP2 users only !
(All Acceleration Pack users please see instructions below at FSX Acceleration Pack Users).

To install the SDK for FSX SP2:

  1. Download FSX SDK SP2
  2. Install the FSX Deluxe RTM SDK (see instructions above)
  3. Install the FSX SDK SP1A (see instructions above)
  4. Install the FSX SDK SP2 that you downloaded


FSX Acceleration Pack OR FSX Gold Pack users

To install the SDK for FSX Acceleration Pack OR FSX Gold Pack:

  1. Install the RTM SDK from FSX Deluxe Edition disk 1, (see 3.1.1 FSX Deluxe RTM users instructions above).
  2. Insert your Acceleration Pack DVD.
  3. Browse to the subfolder called SDK\SP1a\
  4. Install the SDK SP1A from there using fsx_sdk_sp1a.exe, (dated 26/09/2007, size 165,569KB).
  5. Browse to the folder called SDK\
  6. Install the Acceleration SP2/XPack SDK using sdk.msi, (dated 06/10/2007, size 216,929KB).


FSX Standard users who've installed Acceleration Pack

For FSX Standard users only !

Do not use the downloadable SDK SP1A version, (it supposedly doesn't contain the nescessary components).

To install the SDK for FSX Acceleration Pack:

  1. Insert your Acceleration Pack DVD.
  2. Browse to the subfolder called SDK\SP1a\
  3. Install the SDK SP1A from there using fsx_sdk_sp1a.exe, (dated 26/09/2007, size 165,569KB).
  4. Browse to the folder called SDK\
  5. Install the Acceleration SP2/XPack SDK using sdk.msi, (dated 06/10/2007, size 216,929KB).


Important

Do not attempt to install the original retail version of the Flight Simulator X SDK over an updated SDK, as unpredictable results can occur.
See the troubleshooting link below.

Troubleshooting

For all troubleshooting and repair processes,
please see - SDK_Installation_(FSX)_-_Troubleshooting


DO NOT post any help request in the FSDeveloper forums
BEFORE you've completed the SDK_Installation_(FSX)_-_Troubleshooting process.

Related