Sourcetrail

महत्वपूर्ण नोट: यह प्रोजेक्ट 2021 के अंत तक Sourcetrail के मूल लेखकों और अनुरक्षकों द्वारा संग्रहित कर लिया गया था। यदि आप इस निर्णय के बारे में अधिक जानना चाहते हैं, तो हमारे ब्लॉग पर और पढ़ें।

Sourcetrail एक मुफ़्त और ओपन-सोर्स क्रॉस-प्लेटफ़ॉर्म सोर्स एक्सप्लोरर है जो आपको अपरिचित सोर्स कोड पर उत्पादक बनने में मदद करता है।

Windows:

Linux:

लिंक

• डाउनलोड
• त्वरित आरंभ मार्गदर्शिका
• दस्तावेज़ीकरण
• परिवर्तन लॉग

Sourcetrail है:

• मुफ़्त
• ऑफ़लाइन काम करता है
• विंडोज, मैकओएस और लिनक्स पर चलता है
• C, C++, Java और Python का समर्थन करता है
• कस्टम भाषा एक्सटेंशन लिखने के लिए एक SDK (SourcetrailDB) प्रदान करता है

Patreon पर Sourcetrail

ओपन-सोर्स विकास और नियमित सॉफ्टवेयर रिलीज़ पूरी तरह से इन शानदार संरक्षकों के समर्थन से संभव हुए हैं!

Sourcetrail का उपयोग

अपनी मशीन पर Sourcetrail सेटअप करने के लिए, आप रिलीज़ की हमारी सूची से अपने ऑपरेटिंग सिस्टम के लिए संबंधित बिल्ड डाउनलोड कर सकते हैं और इसे अपनी मशीन पर इंस्टॉल कर सकते हैं, या निम्नलिखित पैकेज मैनेजरों में से एक का उपयोग कर सकते हैं:

• choco install sourcetrail के साथ Chocolatey पैकेज का उपयोग करें

आपकी स्थापना पूर्ण होने के बाद, Sourcetrail से परिचित होने के लिए हमारी त्वरित आरंभ मार्गदर्शिका का पालन करें।

समस्याओं की रिपोर्ट कैसे करें

आप अपने सभी फीचर अनुरोध और बग रिपोर्ट हमारे इश्यू ट्रैकर पर पोस्ट कर सकते हैं।

रिपोर्टिंग

निम्नलिखित टेम्पलेट का उपयोग करें:

• प्लेटफ़ॉर्म संस्करण:
• Sourcetrail संस्करण:
• समस्या का विवरण:
• समस्या को दोहराने के चरण:

समर्थन

यदि आप किसी विशेष फीचर अनुरोध का समर्थन करना चाहते हैं या आपके पास वही बग है जो किसी अन्य उपयोगकर्ता ने पहले ही रिपोर्ट कर दिया है, तो कृपया हमें बताएं:

• इश्यू पर "+1" के साथ एक टिप्पणी पोस्ट करें
• या इश्यू आईडी के साथ [email protected] पर एक ईमेल भेजें

योगदान कैसे करें

• कृपया CONTRIBUTING.md फ़ाइल में दिए गए चरणों को पढ़ें और उनका पालन करें।
• आप कुछ प्रारंभिक कार्यों को हल करने के लिए अच्छा पहला इश्यू लेबल वाले इश्यू देख सकते हैं।
• यदि आप Sourcetrail सॉफ्टवेयर विकास के बारे में अधिक जानकारी ढूंढ रहे हैं, तो कृपया हमारे विकी देखें।

कैसे बनाएं

Sourcetrail बनाने के लिए आपकी मशीन पर कई निर्भरताएँ होना आवश्यक है। हालाँकि, हमारा CMake-आधारित सेटअप विशिष्ट भाषाओं के लिए इंडेक्सिंग समर्थन को अक्षम करने की अनुमति देता है जो निर्भरताओं की संख्या को न्यूनतम कर देता है।

आधार अनुप्रयोग का निर्माण

आवश्यक उपकरण

• CMake v3.12 (Windows, Linux और MacOS के लिए आवश्यक)

  • कारण: आपके बिल्ड सिस्टम के लिए बिल्ड कॉन्फ़िगरेशन उत्पन्न करने के लिए उपयोग किया जाता है
  • डाउनलोड: https://cmake.org/download

• Git (Windows, Linux और MacOS के लिए आवश्यक)

  • कारण: संस्करण नियंत्रण और कमिट और टैग से स्वचालित रूप से Sourcetrail संस्करण संख्या उत्पन्न करने के लिए उपयोग किया जाता है
  • डाउनलोड: https://git-scm.com/download
  • टिप्पणी: सुनिश्चित करें कि CMake चलाने से पहले git आपके PATH पर्यावरण चर में जोड़ा गया है।

• Visual Studio (Windows के लिए आवश्यक)

  • कारण: Sourcetrail बनाने के लिए उपयोग किया जाता है
  • डाउनलोड: https://visualstudio.microsoft.com/downloads/

• ccache (Linux और MacOS के लिए वैकल्पिक)

  • कारण: यदि PATH में पाया जाता है तो पुनर्निर्माण को गति देने के लिए उपयोग किया जाता है
  • डाउनलोड: https://ccache.dev/download.html

आवश्यक निर्भरताएँ

• Boost 1.67

  • कारण: फ़ाइल सिस्टम एक्सेस और इंटरप्रोसेस संचार के लिए उपयोग किया जाता है
  • Windows के लिए पूर्व-निर्मित डाउनलोड: https://sourceforge.net/projects/boost/files/boost-binaries/
  • Unix के लिए निर्माण:
    root@kitploit:~

    $ ./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

  • कारण: GUI रेंडर करने और अतिरिक्त (इंडेक्सर) प्रक्रियाओं को शुरू करने के लिए उपयोग किया जाता है।
  • पूर्व-निर्मित डाउनलोड: http://download.qt.io/official_releases/qt/

निर्माण

विंडोज पर

• अपना बिल्ड वातावरण सेट करने के लिए चलाएँ:

  root@kitploit:~

  $ 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> ../..
  

  संकेत: यदि आप CMake GUI का उपयोग कर रहे हैं, तो हम अनुशंसा करते हैं कि आप उन्नत मोड सक्रिय करें। साथ ही आपको "Add Entry" बटन के माध्यम से कुछ परिभाषाएँ जोड़ने की आवश्यकता हो सकती है।

• बिल्ड कॉन्फ़िगरेशन उत्पन्न करने के बाद, बस CMake द्वारा उत्पन्न Sourcetrail.sln फ़ाइल खोलें और Sourcetrail प्रोजेक्ट बनाएँ।

Unix पर

• अपना बिल्ड वातावरण सेट करने के लिए चलाएँ:
  root@kitploit:~

  $ 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> ../..
  

• अब इसके साथ बिल्ड शुरू करें:
  root@kitploit:~

  $ make Sourcetrail
  

चलाना

• बिल्ड निर्देशिका के अंदर से Sourcetrail चलाएँ। निष्पादन के दौरान Sourcetrail को bin/app/data और bin/app/user से संसाधनों की आवश्यकता होती है। CMake बिल्ड निर्देशिका के अंदर सिम्लिंक बनाता है जो इन निर्देशिकाओं को सुलभ बनाते हैं।

C/C++ भाषा समर्थन सक्षम करें

आवश्यक निर्भरताएँ

• LLVM/Clang 11.0.0
  • कारण: अनुक्रमित स्रोत कोड पर प्रीप्रोसेसर चलाने, एक एब्सट्रैक्ट सिंटैक्स ट्री बनाने और पार करने और त्रुटि संदेश उत्पन्न करने के लिए उपयोग किया जाता है।
  • निर्माण: सही टैग चेकआउट करना सुनिश्चित करें: git checkout llvmorg-11.0.0
  • Windows के लिए निर्माण: प्रोजेक्ट बनाने के लिए इन चरणों का पालन करें। cmake कमांड बिल्कुल वैसे ही चलाएँ जैसे वर्णित है।
  • Unix के लिए निर्माण: प्रोजेक्ट बनाने के लिए इस स्थापना मार्गदर्शिका का पालन करें। -DLLVM_ENABLE_RTTI=ON के साथ बिल्ड करना सुनिश्चित करें।

निर्माण

• CMake को इन अतिरिक्त विकल्पों के साथ चलाएँ:
  root@kitploit:~

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

• Sourcetrail को ऊपर वर्णित अनुसार बनाएँ।

Java भाषा समर्थन सक्षम करें

आवश्यक निर्भरताएँ

• JDK 1.8

  • कारण: Java इंडेक्सर बनाने और इसे JNI के माध्यम से C++ कोड से कॉल करने योग्य बनाने के लिए उपयोग किया जाता है।
  • टिप्पणी: सुनिश्चित करें कि <jdk_root>/bin आपके PATH पर्यावरण चर में उपलब्ध है और JAVA_HOME पर्यावरण चर सेट है:
    root@kitploit:~

    JAVA_HOME=<path/to/Java>/jdk1.x.x_xxx
    

• Maven

  • कारण: Sourcetrail के स्वचालित परीक्षणों में उपयोग किया जाता है।
  • टिप्पणी: सुनिश्चित करें कि .../apache-maven-x.x.x/bin आपके PATH पर्यावरण चर में उपलब्ध है और M2_HOME और MAVEN_HOME दोनों पर्यावरण चर सेट हैं:
    root@kitploit:~

    M2_HOME=.../apache-maven-x.x.x
    MAVEN_HOME=.../apache-maven-x.x.x
    

निर्माण

• CMake को इन अतिरिक्त विकल्पों के साथ चलाएँ:
  root@kitploit:~

  -DBUILD_JAVA_LANGUAGE_PACKAGE=ON
  

• Sourcetrail को ऊपर वर्णित अनुसार बनाएँ।

Python भाषा समर्थन सक्षम करें

आवश्यक उपकरण

• 7z (Windows के लिए आवश्यक)
  • कारण: पूर्व-निर्मित SourcetrailPythonIndexer को निकालने के लिए उपयोग किया जाता है जो बिल्ड निष्पादन के दौरान स्वचालित रूप से डाउनलोड होता है।

निर्माण

• CMake को इन अतिरिक्त विकल्पों के साथ चलाएँ:
  root@kitploit:~

  -DBUILD_PYTHON_LANGUAGE_PACKAGE=ON
  

• Sourcetrail को ऊपर वर्णित अनुसार बनाएँ।

तैनाती पैकेज बनाना

विंडोज

आवश्यक उपकरण

• Visual Studio (Windows के लिए आवश्यक)

  • कारण: Sourcetrail Windows इंस्टॉलर बनाने के लिए उपयोग किया जाता है।
  • टिप्पणी: .Net desktop development वर्कलोड स्थापित करना सुनिश्चित करें।
  • डाउनलोड: https://visualstudio.microsoft.com/downloads/

• Wix 3.11

  • कारण: sourcetrail.msi Windows इंस्टॉलर बनाने के लिए उपयोग किया जाता है।
  • टिप्पणी: सुनिश्चित करें कि <path/to>/WiX Toolset v3.11/bin आपके PATH पर्यावरण चर में जोड़ा गया है।
  • डाउनलोड: https://wixtoolset.org/releases/

• Visual Studio के लिए Wix एक्सटेंशन

  • कारण: Visual Studio बिल्ड वातावरण से Wix चलाने के लिए उपयोग किया जाता है।
  • डाउनलोड: https://marketplace.visualstudio.com/items?itemName=WixToolset.WixToolsetVisualStudio2017Extension

• JRE

  • कारण: पैकेज के साथ आने वाले java नमूना प्रोजेक्ट को इंडेक्स करने के लिए उपयोग किया जाता है।

• WinRAR

  • कारण: इंस्टॉलर और पोर्टेबल पैकेज के लिए अंतिम ज़िप फ़ाइलें बनाने के लिए उपयोग किया जाता है।
  • टिप्पणी: सुनिश्चित करें कि <path/to>/WinRAR आपके पर्यावरण चर में जोड़ा गया है।

निर्माण

• अपने Visual Studio के लिए डेवलपर कमांड प्रॉम्प्ट से ./script/deploy_windows.sh चलाएँ। स्क्रिप्ट एक 64बिट बिल्ड उत्पन्न करेगी और इसे एक पोर्टेबल .zip फ़ाइल और एक Wix-आधारित Windows इंस्टॉलर में पैकेज करेगी, प्रत्येक।

macOS

निर्माण के बाद, बिल्ड निर्देशिका के अंदर bundle_install.sh स्क्रिप्ट चलाएँ जो एक Sourcetrail.app बंडल बनाएगी और एक Sourcetrail_<version>.dmg कंटेनर उत्पन्न करेगी।

Linux

मुख्य निर्देशिका से ./setup/Linux/createPackages.sh चलाएँ, जो मुख्य निर्देशिका में एक .tar.gz और एक .AppImage पैकेज दोनों बनाता है। पैकेजिंग linuxdeployqt पर निर्भर करती है।

परीक्षण कैसे चलाएँ

Sourcetrail का स्वचालित परीक्षण सूट Catch2 द्वारा संचालित है। परीक्षण चलाने के लिए, बस Sourcetrail_test बाइनरी निष्पादित करें। निष्पादित करने से पहले, कृपया सुनिश्चित करें कि कार्यशील निर्देशिका ./bin/test पर सेट है।

लाइसेंस

Sourcetrail GNU सामान्य सार्वजनिक लाइसेंस संस्करण 3 के तहत लाइसेंस प्राप्त है।

ट्रेडमार्क

"Sourcetrail" नाम Coati Software द्वारा स्वामित्व वाला एक ट्रेडमार्क है और GNU GPLv3 के तहत लाइसेंस प्राप्त संपत्तियों में शामिल नहीं है।