Hi, All
FGDATA with submodules offers a new feature. The install scripts.
Inspired in the methodology we implemented for terraGIT, and making a great usage of the <tag></tag> specifications in the aircraft.xml files, FGDATA with submodules now offers the possibility of installing collections or set of aircrafts in an easy and extensible manner.
SET up
To begin, install the FGDATA with submodules repository
Code: Select all
git clone git@gitlab.com:flightgear-fs/fgdata.git
OR, if you already have a copy of FGDATA with submodules (from either gitlab or sourceforge), simply
Code: Select all
git pull
This will bring you a copy of fgdata by the FGMEMBERS team which, unlike the official FGDATA has the ability to be expanded by installing any aircraft available in FGMEMBERS.
Simply, allow the directory obtained fgdata to be the flightgear root directory ($FG_ROOT), either by using a terminal during launching --fg-root=/path/to/fgdata/with/submodules, or with any launcher you use, including the Qt5 launcher.
Using the Installation scripts
in a git-bash terminal, enter the root directory of your fresh fgdata installation
Code: Select all
cd fgdata
Initially, your FGDATA copy will contain ONLY the ufo.
You will be in control of which aircrafts to install or deinstall; for which the install scripts will be your help
you can use the install/aircraft AcftName script to install one aircraft.
Simply
Code: Select all
install/aircraft extra500
per example, or any aircraftName.
Note that you can activate the flag -a or --allow-nongpl, to install a non GPL aircraft, like
Code: Select all
install/aircraft Optica -a
Removing an aircraft from your FGDATA is equally as simple, just use the correspoding deinstall script
Code: Select all
deinstall/aircraft Optica -a
The install/hangar scripts
In addition to install/aircraft, we have install/hangar available
A hangar will allow aircrafts from a hangar to be installed or de-installed rapidly and efficiently, examples
Code: Select all
install/hangar jwocky --allow-nongpl
[/size]
Therefore, you can use this method to fully install fgaddon hangar (the FGMEMBERS versions of these aircraft) as follows
Code: Select all
install/hangar fgaddon --allow-nongpl
deinstallation works as expected too
Code: Select all
deinstall/hangar jmaverick
[size=150]Installing aircrafts by <tag>
The script install/tag allows you to install/deinstall aircrafts sharing the same tags, examples
Code: Select all
install/tag bizjet
install/tag jet --allow-nongpl
install/tag 1910s
deinstall/tag mitsubishi -a
(a list of all tags currently available: https://gitlab.com/flightgear-fs/fgdata ... stall/tags)
Extending the install scripts via collections
Collections is any list of Aircrafts per line
You can create your own collection and adding the file either in install/collections/ or install/collections-nongpl respectively.
Once the list exists, example:
https://gitlab.com/flightgear-fs/fgdata ... ollections
You can use the install script as follows
Code: Select all
install/collection iahmcol-favorites -a
The collection base-legacy contains the aircrafts that were downloaded by default in versions before FG3.x, and thus
Code: Select all
install/collection base-legacy
Will give you that legacy experience, per example
Code: Select all
deinstall/collection iahmcol-favorites -a
would be an example of using such list via deinstall, too