Développement plugins

Construire et installer

Linux

• Générez le code du noyau Stellarium selon la page Compilation on Linux. Assurez-vous que l'accumulation de sous-répertoire sont nommés builds/unix.
• Définissez la variable d'environnement STELROOT pour le chemin de l'arbre stellarium source, par exemple:

export STELROOT=/home/bob/stellarium

• Changement de l'endroit où vous avez le code source de plugin installé, assurez-un sous-répertoire builds/Unix et le changement dans ce.

cd /home/bob/stel-plugins/PluginName
mkdir -p builds/unix
cd builds/unix

• Run cmake, en précisant le type de build pour être le même que celui qui a été utilisé pour construire le code du noyau (Debug ou Release). Ensuite, lancez make

cmake -DCMAKE_BUILD_TYPE=Debug ../..
make

• Pour l'installer, tapez simplement:

make install

Cela mettra les fichiers pour le plugin dans ~/.stellarium/modules/PluginName

Windows

• Générez le code du noyau Stellarium selon la page Windows Build Instructions. Assurez-vous que l'accumulation de sous-répertoire est appelé builds/msys.
• Définissez la variable d'environnement STELROOT pour être le chemin de l'arbre stellarium source, par exemple:

export STELROOT=/c/msys/1.0/home/bob/stellarium

• Changer l'endroit où vous avez le code source de plugin installé, assurez-un sous-répertoire builds/msys et le changement dans.

cd /c/msys/1.0/home/bob/stel-plugins
mkdir -p builds/msys
cd builds/msys

• Run cmake, en précisant le type de build d'être la même que celle qui a été utilisé pour construire le code du noyau (Debug ou Release). Ensuite, lancez make

cmake -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Debug ../..
make

• Plusieurs des plugins ont un fichier nommé installer.iss dans le répertoire principal. Ceci peut être utilisé avec le générateur d'installation INNO pour générer un installeur windows pour le plugin.

Ecrire des Plugins

Si vous êtes un développeur, et j'aimerais avoir un aller à la rédaction de votre propre plugin Stellarium, les ressources suivantes pourraient être utiles:

• La page "Plugins" dans la documentation 'Stellarium's online developers'
• Le code source du plugin existant dans la subversion, parcourir par ici
• La liste de diffusion stellarium pubdevel - s'il vous plaît à honoraires libres pour vous abonner et poser des questions là

Erreur d'enchaînement dynamique sous Windows

Si un plugin utilise une classe qui hérite d'une classe qui contient le Stellarium Q OBJET macro (par exemple, une fenêtre de dialogue qui hérite StelDialog), Stellarium refusera de le charger sur Windows, retournant un accès non valide à l'erreur d'emplacement mémoire La solution est de copier la classe parente (par exemple, StelDialog) aux sources du plugin et renommez-le de manière appropriée.

Des conseils sur la manière de résoudre cette question par une autre voie serait très appréciée.