Fr/$FG HOME: Difference between revisions

La [[Fr/Les variables d'environnement|variable d'environnement]] <code>'''$FG_HOME'''</code>  est un '''paramètre''' indiquant l'emplacement principal où sont stockées les données [[Fr/FlightGear|FlightGear]] spécifiques à l'utilisateur (et non les données de l'application). <code>$FG_HOME</code> est un emplacement important où sont écrites les données FlightGear. <code>$FG_HOME</code> est également l'emplacement où sont écrites, par défaut, les grandes quantités de données téléchargées par FlightGear, telles que les données [[Fr/TerraSync|TerraSync]] sur les paysages ou les données sur les avions.  

Le répertoire <code>$FG_HOME</code> stocke les informations entre les sessions. Ces informations concernent, par exemple, la configuration/les préférences, les propriétés marquées avec l'attribut <code>user-archive</code> et les paramètres spécifiques aux avions (à l'aide de la classe d'aide aux données dans <code>aircraft.nas</code>). <code>$FG_HOME</code> est également l'emplacement du [[Navdata cache|cache de données de navigation]] basé sur SQLite.

== Common paths ==

You can determine the location of your <code>$FG_HOME</code> by using the [[property browser]] and checking the value of <code>/sim/fg-home</code>, but the usual paths are shown below.

You can also use the [[Nasal Console]] to print out <code>$FG_HOME</code>:

<syntaxhighlight lang="nasal">

The <code>/sim/</code> property subtree is also the place where you can find other folders, such as <code>fg-root</code>, <code>fg-scenery</code> and the current working directory (<code>fg-current</code>).

=== Linux ===

<code>~/.fgfs/</code>

=== Mac OS X ===

<code>~/Library/Application Support/FlightGear</code> (`~/Library` is a hidden folder by default. In versions of macOS newer than 10.12, you can use the shortcut `Cmd + Shift + .` to view hidden folders. For older versions, see [http://www.mikesel.info/show-hidden-files-mac-os-x-10-7-lion/])

As all future FlightGear versions will take their preferences from here, it is a good idea to have their access available easily.

Desktop/Finder/Go/Go to Folder is where you need to start.

When given the option, input: <code>~/Library/Application Support/FlightGear</code>

It is probably a good idea to have <code>~/Library/Application Support/FlightGear</code> saved on a Stickies note just in case you forget it.

If you want/need to refer to any of these files frequently, you could make an alias of a file, or the whole folder, and place it somewhere easier to access. TerraSync data is stored in <code>$FG_HOME/TerraSync</code> in the default configuration, see [[TerraSync]] for details.

=== Windows ===

==== FlightGear 2020.3 and later ====

<code>%userprofile%\FlightGear</code>

<code>%userprofile%</code> is the directory that contains the [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/bb776892(v=vs.85) Windows user profile] ([http://web.archive.org/web/20210320110758/https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/bb776892%28v=vs.85%29 perm])<code>.</code>Ways to find the<code>%userprofile%</code> directory: 1). Press <code>Windows key+R</code>or bring up the RUN box. Type <code>%userprofile%</code> to open. 2). In command prompt, type <code>cd</code> <code>%userprofile%</code>

<code>%userprofile%</code> is<code>%homedrive%\Users\''User name''</code> by default. Usually on most peoples systems: <Code>%homedrive%</Code> is C:\.  

For example if your user profile was called <code>MyUserProfile</code>, it would most often be located under <code>C:\Users\MyUserProfile</code> . Then the path to <code>$FG_HOME</code> would be <code>C:\Users\MyUserProfile\FlightGear.</code>

In 2020.3.x the [[FlightGear Qt launcher|qt-launcher]] will notify users who have data in the old location under <code>%userprofile%\Documents\FlightGear</code>, and prompt users to move files to the new location under <code>%userprofile%\FlightGear</code>.

==== FlightGear 3.0 and later ====

<code>%userprofile%\Documents\FlightGear</code>

<code>%userprofile%</code> is <code>%homedrive%\Users\''User name''</code> by default, and <Code>%homedrive%</code> is usually C:\.

==== Before FlightGear 3.0 ====

<code>%APPDATA%</code> is another environment variable that depends on your Windows version. On XP and older, it can be found under <code>C:\Documents and Settings\''User name''\Application Data</code>. On Vista and later it can be found under <code>C:\Users\''User name''\AppData\Roaming</code>. The folder is hidden by default. See [http://windows.microsoft.com/en-US/windows-vista/show-hidden-files these instructions] to show the folder.

As one user once said, "When in doubt delete <code>$FG_HOME</code>". Many problems, including corrupted databases, broken [[TerraSync]] and many others can be fixed by deleting <code>fgfs_0.txt</code>, <code>fgfs.txt</code>, <code>terrasync_cache</code>, and the [[Navdata cache|navdata cache]].

When you encounter problems, try deleting the files, but '''always''' keep the <code>[[Commonly used debugging tools#fgfs.log|fgfs.log]]</code> and <code>fgfs_0.log</code> log files to help in troubleshooting.

== Power Users ==

Note you can also override FG_HOME in the environment, to have totally distinct installs - this would be my recommend approach to running multiple versions in parallel.

(The installers will always replace the stable / dev version as other commenters pointed out, so you can't use those so easily, you need to copy files around - I'm nota Windows expert so I don't know if there something that could be changed or improved here)

Sharing of aircraft / scenery is entirely about which paths are configured, BTW. However, one final caveat is that having multiple instances both running TerraSync, using the same terrasync dir, would likely act a bit funny. It ought to actually work, but it might download some things twice, and it's not a tested or supported configuration for the moment.<ref>{{cite web

  |url    =  https://forum.flightgear.org/viewtopic.php?p=304170#p304170

  |title  =  <nowiki> Re: Is it possible to install multiple instanes of FG in Win </nowiki>  

  |author =  <nowiki> zakalawe </nowiki>  

  |script_version = 0.40

Using the same [[TerraSync|TerraSyn]]<nowiki/>c directory can save a lot of downloading and disk space. You can use the --terrasync-dir=path [[Command line options|command line]] option. For example --terrasync-dir=C:\Path\to\my\separate\terrasync\folder\TerraSync. It's possible to add this option in the <code>Settings > Additional Settings</code> section of the [[qt-launcher]].

== Related content ==