Sourcetrail

Note importante : Ce projet a été archivé par les auteurs et mainteneurs originaux de Sourcetrail à la fin de l'année 2021. Si vous souhaitez en savoir plus sur cette décision, lisez la suite sur notre blog.

Sourcetrail est un explorateur de code source gratuit et open-source multiplateforme qui vous aide à devenir productif sur un code source inconnu.

Windows:

Linux:

Liens

• Téléchargement
• Guide de démarrage rapide
• Documentation
• Journal des modifications

Sourcetrail est :

• gratuit
• fonctionne hors ligne
• fonctionne sur Windows, macOS et Linux
• prend en charge C, C++, Java et Python
• offre un SDK (SourcetrailDB) pour écrire des extensions de langage personnalisées

Sourcetrail sur Patreon

Le développement open-source et les versions logicielles régulières sont rendus possibles entièrement grâce au soutien de ces formidables mécènes !

Utiliser Sourcetrail

Pour installer Sourcetrail sur votre machine, vous pouvez soit télécharger la version correspondant à votre système d'exploitation depuis notre liste de Versions et l'installer sur votre machine, soit utiliser l'un des gestionnaires de paquets suivants :

• Utilisez le paquet Chocolatey avec choco install sourcetrail

Après l'installation, suivez notre Guide de démarrage rapide pour découvrir Sourcetrail.

Comment signaler des problèmes

Vous pouvez poster toutes vos demandes de fonctionnalités et rapports de bugs sur notre suivi des problèmes.

Signalement

Utilisez le modèle suivant :

• version de la plateforme :
• version de Sourcetrail :
• description du problème :
• étapes pour reproduire le problème :

Soutien

Si vous souhaitez soutenir une demande de fonctionnalité ou si vous avez le même bug qu'un autre utilisateur a déjà signalé, faites-le nous savoir :

• publiez un commentaire avec « +1 » sur le problème
• ou envoyez un email à [email protected] avec l'ID du problème

Comment contribuer

• Veuillez lire et suivre les étapes dans le fichier CONTRIBUTING.md.
• Vous pouvez chercher des problèmes étiquetés good first issue pour trouver des tâches initiales à aborder.
• Si vous cherchez plus d'informations sur le développement de Sourcetrail, veuillez consulter notre wiki.

Comment compiler

La compilation de Sourcetrail nécessite plusieurs dépendances sur votre machine. Cependant, notre configuration basée sur CMake permet de désactiver le support de l'indexation pour des langages spécifiques, ce qui réduit le nombre de dépendances au minimum.

Compilation de l'application de base

Outils requis

• CMake v3.12 (requis pour Windows, Linux et macOS)

  • Raison : Utilisé pour générer une configuration de compilation pour votre système de build.
  • Téléchargement : https://cmake.org/download

• Git (requis pour Windows, Linux et macOS)

  • Raison : Utilisé pour le contrôle de version et pour générer automatiquement le numéro de version de Sourcetrail à partir des commits et des tags.
  • Téléchargement : https://git-scm.com/download
  • Remarques : Assurez-vous que git est ajouté à votre variable d'environnement PATH avant d'exécuter CMake

• Visual Studio (requis pour Windows)

  • Raison : Utilisé pour compiler Sourcetrail.
  • Téléchargement : https://visualstudio.microsoft.com/downloads/

• ccache (optionnel pour Linux et macOS)

  • Raison : Utilisé pour accélérer les recompilations s'il est trouvé dans PATH.
  • Téléchargement : https://ccache.dev/download.html

Dépendances requises

• Boost 1.67

  • Raison : Utilisé pour l'accès au système de fichiers et la communication inter-processus.
  • Téléchargement précompilé pour Windows : https://sourceforge.net/projects/boost/files/boost-binaries/
  • Compilation pour Unix :

    $ ./bootstrap.sh --with-libraries=filesystem,program_options,system,date_time
    $ ./b2 --link=static --variant=release --threading=multi --runtime-link=static --cxxflags=-fPIC
    

• Qt 5.12.3

  • Raison : Utilisé pour le rendu de l'interface graphique et pour lancer des processus supplémentaires (d'indexation).
  • Téléchargement précompilé : http://download.qt.io/official_releases/qt/

Compilation

Sous Windows

• Pour configurer votre environnement de compilation, exécutez :

  $ git clone https://github.com/CoatiSoftware/Sourcetrail.git
  $ cd Sourcetrail
  $ mkdir -p build/win64
  $ cd build/win64
  $ cmake -G "Visual Studio 15 2017 Win64" -DBOOST_ROOT=<path/to/boost_1_67_0> -DQt5_DIR=<path/to/Qt/version/platform/compiler/lib/cmake/Qt5> ../..
  

  Astuce : Si vous utilisez l'interface graphique CMake, nous vous recommandons d'activer le mode avancé. Vous devrez peut-être également ajouter certaines définitions via le bouton "Add Entry".

• Après avoir généré la configuration de compilation, ouvrez simplement le fichier Sourcetrail.sln généré par CMake et compilez le projet Sourcetrail.

Sous Unix

• Pour configurer votre environnement de compilation, exécutez :

  $ cd Sourcetrail
  $ mkdir -p build/Release
  $ cd build/Release
  $ cmake -DCMAKE_BUILD_TYPE="Release" -DBOOST_ROOT=<path/to/boost_1_67_0> -DQt5_DIR=<path/to/Qt/version/platform/compiler/lib/cmake/Qt5> ../..
  

• Lancez maintenant la compilation avec :

  $ make Sourcetrail
  

Exécution

• Exécutez Sourcetrail depuis le répertoire de compilation. Pendant l'exécution, Sourcetrail a besoin des ressources de bin/app/data et bin/app/user. CMake crée des liens symboliques dans le répertoire de compilation qui rendent ces répertoires accessibles.

Activer le support des langages C/C++

Dépendances requises

• LLVM/Clang 11.0.0
  • Raison : Utilisé pour exécuter le préprocesseur sur le code source indexé, construire et parcourir un arbre syntaxique abstrait et générer des messages d'erreur.
  • Compilation : Assurez-vous de vérifier le bon tag : git checkout llvmorg-11.0.0
  • Compilation sous Windows : Suivez ces étapes pour compiler le projet. Exécutez la commande cmake exactement comme décrit.
  • Compilation sous Unix : Suivez ce guide d'installation pour compiler le projet. Assurez-vous de compiler avec -DLLVM_ENABLE_RTTI=ON.

Compilation