Téléchargement Sourcetrail - Téléchargement du code source Sourcetrail

Sourcetrail

Python

2021.4.19

Télécharger

Sentier source

Remarque importante : ce projet a été archivé par les auteurs et responsables d'origine de Sourcetrail avant la fin de 2021. Si vous souhaitez en savoir plus sur cette décision, lisez-en davantage sur notre blog.

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

Fenêtres :

Linux :

Links

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

"Sourcetrail User Interface"

SourceTrail est :

gratuit
travailler hors ligne
fonctionnant sous Windows, macOS et Linux
prenant en charge C, C++, Java et Python
proposant un SDK (SourcetrailDB) pour écrire des extensions de langage personnalisées

Sourcetrail sur Patreon

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

Utiliser SourceTrail

Pour configurer Sourcetrail sur votre machine, vous pouvez soit télécharger la version correspondante pour votre système d'exploitation à partir de notre liste de versions et l'installer sur votre machine, soit utiliser l'un des gestionnaires de packages suivants :

Utilisez le package Chocolatey avec choco install sourcetrail

Une fois votre installation terminée, suivez notre guide de démarrage rapide pour découvrir Sourcetrail.

Comment signaler des problèmes

Vous pouvez publier toutes vos demandes de fonctionnalités et rapports de bogues sur notre outil de suivi des problèmes.

Rapports

Utilisez le modèle suivant :

version plateforme :
Version SourceTrail :
description du problème :
étapes pour reproduire le problème :

Justificatif

Si vous souhaitez prendre en charge une certaine demande de fonctionnalité ou si vous rencontrez le même bug qu'un autre utilisateur a déjà signalé, veuillez nous le faire savoir :

poster un commentaire avec "+1" sur le problème
ou envoyez un e-mail à [email protected] avec l'ID du problème

Comment contribuer

Veuillez lire et suivre les étapes du fichier CONTRIBUTING.md.
Vous souhaiterez peut-être rechercher les problèmes qualifiés de bon premier problème pour trouver quelques tâches initiales à accomplir.
Si vous recherchez plus d'informations sur le développement du logiciel Sourcetrail, veuillez vous référer à notre wiki.

Comment construire

La création de Sourcetrail nécessite la mise en place de plusieurs dépendances sur votre machine. Cependant, notre configuration basée sur CMake permet de désactiver la prise en charge de l'indexation pour des langues spécifiques, ce qui réduit le nombre de dépendances au minimum.

Création 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 build pour votre système de build
- Télécharger : https://cmake.org/download
Git (obligatoire pour Windows, Linux et MacOS)
- Raison : Utilisé pour le contrôle de version et pour générer automatiquement le numéro de version Sourcetrail à partir des commits et des balises
- Télécharger : https://git-scm.com/download
- Remarques : Assurez-vous git est ajouté à votre variable d'environnement PATH avant d'exécuter CMake
Visual Studio (obligatoire pour Windows)
- Raison : Utilisé pour construire Sourcetrail
- Télécharger : https://visualstudio.microsoft.com/downloads/
ccache (facultatif pour Linux et MacOS)
- Raison : Utilisé pour accélérer les reconstructions si trouvé dans PATH
- Télécharger : 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 interprocessus
- Téléchargement prédéfini pour Windows : https://sourceforge.net/projects/boost/files/boost-binaries/
- Construction pour Unix :
```
 $ ./bootstrap.sh --with-libraries=filesystem,program_options,system,date_time
$ ./b2 --link=static --variant=release --threading=multi --runtime-link=static --cxxflags=-fPIC
```
Qt5.12.3
- Raison : Utilisé pour le rendu de l'interface graphique et pour démarrer des processus supplémentaires (indexeur).
- Téléchargement prédéfini : http://download.qt.io/official_releases/qt/

Bâtiment

Sous Windows

Pour configurer votre environnement de build, 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 des définitions via le bouton « Ajouter une entrée ».
Après avoir généré la configuration de build, ouvrez simplement le fichier Sourcetrail.sln généré par CMake et créez le projet Sourcetrail.

Sous Unix

Pour configurer votre environnement de build, 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> ../..

Maintenant, démarrez la construction avec :
```
 $ make Sourcetrail
```

En cours d'exécution

Exécutez Sourcetrail à partir du répertoire de construction. 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 construction qui rendent ces répertoires accessibles.

Activer la prise en charge du langage 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 de syntaxe abstraite et générer des messages d'erreur.
- Construction : Assurez-vous de vérifier la bonne balise : git checkout llvmorg-11.0.0
- Création pour Windows : suivez ces étapes pour générer le projet. Exécutez la commande cmake exactement comme décrit.
- Building for Unix : suivez ce guide d'installation pour construire le projet. Assurez-vous de construire avec -DLLVM_ENABLE_RTTI=ON .

Bâtiment

Exécutez CMake avec ces options supplémentaires :

 -DClang_DIR=<path/to/llvm_build>/lib/cmake/clang
-DBUILD_CXX_LANGUAGE_PACKAGE=ON

Créez Sourcetrail comme décrit ci-dessus.

Activer la prise en charge du langage Java

Dépendances requises

JDK 1.8
- Raison : Utilisé pour construire l'indexeur Java et le rendre appelable depuis le code C++ via JNI.
- Remarques : Assurez-vous que <jdk_root>/bin est disponible dans votre variable d'environnement PATH et que la variable d'environnement JAVA_HOME est définie :
```
 JAVA_HOME=<path/to/Java>/jdk1.x.x_xxx
```
Maven
- RAISON : Utilisé dans les tests automatisés de Sourcetrail.
- Remarques : Assurez-vous que .../apache-maven-xxx/bin est disponible dans votre variable d'environnement PATH et que les variables d'environnement M2_HOME et MAVEN_HOME sont définies :
```
 M2_HOME=.../apache-maven-x.x.x
MAVEN_HOME=.../apache-maven-x.x.x
```

Bâtiment

Exécutez CMake avec ces options supplémentaires :
```
 -DBUILD_JAVA_LANGUAGE_PACKAGE=ON
```
Créez Sourcetrail comme décrit ci-dessus.

Activer la prise en charge du langage Python

Outils requis

7z (obligatoire pour Windows)
- RAISON : utilisé pour extraire le SourcetrailPythonIndexer prédéfini qui est téléchargé automatiquement lors de l'exécution de la construction.

Bâtiment

Exécutez CMake avec ces options supplémentaires :
```
 -DBUILD_PYTHON_LANGUAGE_PACKAGE=ON
```
Créez Sourcetrail comme décrit ci-dessus.

Création du package de déploiement

Fenêtres

Outils requis

Visual Studio (obligatoire pour Windows)
- Raison : Utilisé pour créer le programme d’installation de Sourcetrail Windows.
- Remarques : Assurez-vous d'installer la charge de travail .Net desktop development .
- Télécharger : https://visualstudio.microsoft.com/downloads/
Wix 3.11
- Raison : Utilisé pour construire le programme d’installation Windows sourcetrail.msi .
- Remarques : Assurez-vous d'ajouter <path/to>/WiX Toolset v3.11/bin à votre variable d'environnement PATH .
- Télécharger : https://wixtoolset.org/releases/
Extension Wix pour Visual Studio
- Raison : Utilisé pour exécuter Wix à partir de l'environnement de build Visual Studio.
- Télécharger : https://marketplace.visualstudio.com/items?itemName=WixToolset.WixToolsetVisualStudio2017Extension
JRE
- Raison : utilisé pour indexer l’exemple de projet Java fourni avec le package.
WinRAR
- Raison : Utilisé pour créer les fichiers zip finaux pour le programme d'installation et le package portable.
- Remarques : Assurez-vous d'ajouter <path/to>/WinRAR à votre variable d'environnement PATH .

Bâtiment

Exécutez ./script/deploy_windows.sh à partir de votre invite de commande de développeur pour Visual Studio. Le script qui générera une version 64 bits et la conditionnera dans un fichier .zip portable et un programme d'installation Windows basé sur Wix, chacun.

macOS

Après la construction, exécutez le script bundle_install.sh dans le répertoire de construction qui créera un bundle Sourcetrail.app et générera un conteneur Sourcetrail_<version>.dmg .

Linux

Exécutez ./setup/Linux/createPackages.sh à partir du répertoire principal, ce qui crée à la fois un .tar.gz et un package .AppImage dans le répertoire principal. L'emballage dépend de Linuxdeployqt.

Comment exécuter les tests

La suite de tests automatisés de Sourcetrail est optimisée par Catch2. Pour exécuter les tests, exécutez simplement le binaire Sourcetrail_test . Avant d'exécuter, assurez-vous de définir le répertoire de travail sur ./bin/test .