Important

We are currently a small number of developers active on the project. As such, we cannot answer and tag all of the opened issues immediately, but we do notice and read them. Good bug reports provide us important feedback, which we thank you for and always appreciate.

பிழை அறிக்கை வழிகாட்டி

இந்த வழிகாட்டி ஜாமியில் நீங்கள் சந்திக்கும் பிழைகள் மற்றும் சிக்கல்களை அறிக்கை செய்வதற்கான படிப்படியான வழிமுறைகளை உள்ளடக்கியது.

உங்கள் சூழலை அமைக்கவும்

  • தரவு இழப்பு ஏற்பட தயாராக இருங்கள். உங்கள் கணக்கை காப்புப் பிரதி எடுக்கவும், உங்கள் கணக்கை முடிந்தவரை பல சாதனங்களுடன் இணைக்கவும்.

  • ஜாமி இன் சமீபத்திய பதிப்பை (அல்லது ஒரு பீட்டா பதிப்பை) நிறுவவும். பழைய பதிப்புகளுடன் பிழைகள் / சிக்கல்களை அறிக்கை செய்வது குறைவாக பயனுள்ளதாக இருக்கும், மேலும் இது ஏற்கனவே புதிய பதிப்புகளில் சரிசெய்யப்பட்டிருக்கலாம்.

ஒரு பிக் எப்படி புகாரளிக்க வேண்டும்

  1. நீங்கள் ஏற்கனவே ஒரு கணக்கு இல்லை என்றால் [ஜாமி GitLab]https://git.jami.net/users/sign_up) ஒரு கணக்கை உருவாக்கவும்.

  2. உங்கள் பிரச்சினையை வெளியிட சரியான திட்டத்தை தேர்ந்தெடுக்கவும்ஃ

    • ஆண்ட்ராய்டு கிளையன்ட்

    • Qt வாடிக்கையாளர்

    • IOS கிளையன்ட்

    • macOS கிளையன்ட் (கிட்லாப்-project) Qt கிளையன்ட் <jami-client-qt>)

    • {gitlab-project}`ஜாமி திட்டம் பொதுவாக (அல்லது உங்களுக்கு உறுதியாக தெரியாவிட்டால்)

    • [நீங்கள் என்ன செய்கிறீர்கள் என்று உங்களுக்குத் தெரிந்தால் மற்ற திட்டங்களில் ஒன்றைத் தேர்வு செய்யலாம்]https://git.jami.net)

  3. உங்களுக்கு பல சிக்கல்கள் இருந்தால், தனித்தனியாக பிழை அறிக்கைகளை தாக்கல் செய்யவும். அவ்வாறு அவற்றை கண்காணிப்பது மிகவும் எளிதாக இருக்கும்.

  4. தலைப்பு பிழை ஒரு வெளிப்படையான சுருக்கம் ஆகும் (எ. கா.: தலைப்பு பட்டியில் சின்னம் அளவு காரணமாக மிக பெரியது)

  5. பிழைகளை மீண்டும் உருவாக்க வேண்டிய படிகளை கண்டுபிடிக்கவும்ஃ

    • அதை மீண்டும் உருவாக்க உங்களுக்கு துல்லியமான படிகள் இருந்தால் (அதிசிறந்தது!) நீங்கள் ஒரு பயனுள்ள பிழை அறிக்கையை உருவாக்க உங்கள் வழியில் இருக்கிறீர்கள்.

    • நீங்கள் அவ்வப்போது மீண்டும் மீண்டும் எழுத முடிந்தாலும், குறிப்பிட்ட படிகளை பின்பற்றிய பின்பு அல்ல, தயவுசெய்து மற்றவர்கள் அதை புரிந்து கொள்ளவும் அதை மீண்டும் உருவாக்கவும் உதவும் வகையில், இந்த பிரச்சினை பற்றி கூடுதல் தகவல்களை வழங்கவும்.

    • If you can not reproduce the problem, there may be little chance of it being reasonably fixable. If you do report it, please try your best to provide as much information/clues about its occurrence as possible.

  6. உங்கள் மென்பொருள் புதுப்பிக்கப்பட்டதா என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள்.

  7. சுற்றுச்சூழலில் இருந்து தனிமைப்படுத்தப்பட்டு இனப்பெருக்கம் செய்ய முயற்சிக்கவும் (அதாவது பல சாதனங்களில் சோதனை).

  8. பின்வருவனவற்றை குறிப்பிடுவதன் மூலம் உங்கள் சூழலை விவரிக்கவும்ஃ

    • OS பதிப்பு

    • துல்லியமான சாதன மாதிரி (மொபைல் சாதனங்களுக்கு முக்கியமானது)

    • நீங்கள் ஒரு பெட்டா பதிப்பைப் பயன்படுத்தினால்

    • what build you are using (F-Droid, Play Store, App Store, from dl.jami.net, your own build, etc.). If you have built your own version of Jami, please specify the exact Jami Daemon version and client version (you can obtain it using jamid -v and jami -v; but note that our packages are updated quite often) and the Git commit.

    • network conditions:

      • are both devices on the same local network?

      • Different networks?

      • Is one or both behind NAT?

      • Are you using LTE?

      • Are you using WiFi?

    • other elements if needed:

      • SIP provider,

      • hardware,

      • etc.

தெளிவான சுருக்கத்தை எழுதுதல்

10 வார்த்தைகளை பயன்படுத்தி பிழைகளை எப்படி விவரிக்கலாம்? இது உங்கள் பிழை அறிக்கையின் முதல் பகுதி ஒரு டெவலப்பர் பார்ப்பார்.

ஒரு நல்ல சுருக்கம் பிழை அறிக்கையை விரைவாகவும் தனித்துவமாகவும் அடையாளம் காண வேண்டும். அது பிரச்சினையை விளக்க வேண்டும், உங்கள் முன்மொழியப்பட்ட தீர்வை அல்ல.

Good: "Cancelling a file transfer crashes Jami"
Bad: "Software crashes"
Good: "All calls hang up after 32 seconds"
Bad: "Not able to call my friends"

இனப்பெருக்கம் செய்ய வேண்டிய துல்லியமான படிகளை எழுதுதல்

  • ஒரு டெவலப்பர் எப்படி தனது சாதனத்தில் பிழைகளை மீண்டும் உருவாக்க முடியும்?

    பிழை அறிக்கையின் மிக முக்கியமான பகுதியாக பிழைகளை மீண்டும் உருவாக்க வேண்டிய படிகள் உள்ளன. ஒரு டெவலப்பர் பிழையை மீண்டும் உருவாக்க முடிந்தால், பிழை சரிசெய்யப்படும். படிகள் தெளிவாக இல்லாவிட்டால், பிழை சரிசெய்யப்பட்டதா என்பதை கூட அறிய முடியாது. சில பிழைகள் உங்களுக்கு வெளிப்படையாகத் தோன்றலாம் என்பதை நாங்கள் முழுமையாக அறிவோம், ஆனால் அவை உங்கள் சூழலுடன் தொடர்புடையவை. நீங்கள் துல்லியமாக இருப்பதால், பிழையை விரைவாக சரிசெய்ய முடியும்.

  • பிழை அறிக்கையில் என்ன சேர்க்க வேண்டும்?

    நீங்கள் விரும்பியபடி பிழைகளை மீண்டும் உருவாக்க முடியுமா அல்லது இல்லை என்பதைக் குறிப்பிடுங்கள். ஒவ்வொரு அடியின் நோக்கத்திற்காக ஜாமி உடனான தொடர்பு முறையை விவரிக்கவும். உங்கள் படிகளைத் தொடர்ந்து, கவனிக்கப்பட்ட (உண்மையான) விளைவை மற்றும் எதிர்பார்க்கப்பட்ட விளைவை துல்லியமாக விவரிக்கவும். உண்மைகளை (பரிசீலனைகள்) கணிப்புகளிலிருந்து தெளிவாக பிரிக்கவும்.

Good

நான் எப்போதும் இந்த படிகளை பின்பற்றி இனப்பெருக்கம் செய்ய முடியும்ஃ

1. Start Jami by clicking on the desktop icon
2. Start a new conversation with anyone
3. Click the file transfer icon

Expected results: A window opens and asks me to choose a file to send.
Actual results: When I click the file transfer icon, nothing happens.

Bad

Try to transfer a file.
It doesn't work.

பெற்ற முடிவு

தயவுசெய்து பின்வருவனவற்றை உள்ளிடவும்ஃ

  • ஜாமி டேமன் (ஜாமிட் அல்லது லிபஜாமி அல்லது லிபரிங்) மற்றும் கிளையன் டிபக் பதிவுகள்.

  • ஒரு தயாரிப்பு இருந்தால், மையம் குப்பை.

எதிர்பார்த்த முடிவு

அது எதிர்பார்த்த அல்லது விரும்பிய நடத்தை பற்றிய விவரமாகும்.

கூடுதல் தகவல்களை வழங்குதல்

பெரும்பாலான பிழை அறிக்கைகளுக்கு பின்வரும் தகவல்கள் கோரப்படுகின்றன. எதிர்பார்த்த முடிவுகளின் கீழ் இந்த தகவலை வழங்குவதன் மூலம் நீங்கள் நேரத்தை மிச்சப்படுத்தலாம்.

பதிவுகள்

Qt அடிப்படையிலான ஜாமி கிளையண்ட் (GNU/Linux, Windows, macOS)

Go to the General settings. In the Troubleshoot section, you can click on "Open logs", where you will be able to get statistics ("Show stats") or start recording information via "Receive logs". Then you can just copy the result and explain your scenario.

GNU/Linux இல்

பாரம்பரிய பதிவுகள் (இயல்புநிலை பதிவுகள் மட்டுமே >= எச்சரிக்கை பதிவு செய்யப்படுகின்றன):

journalctl --since "24h ago" | grep jami

Full log: The Jami client (GUI) and daemon are separate processes. To obtain logs from both processes, start each process manually, one at a time.

  1. எந்த ஜாமி கிளையன் அல்லது டேமன் நிகழ்வுகள் இயங்கும் என்பதை உறுதிப்படுத்தவும்ஃ ஒரு முனையத்தில் ps aux கிராப் ஜாமி இயக்கி சரிபார்க்கவும்.

    • ஜாமி இன்னும் ஓடிக் கொண்டிருக்கலாம், ஜன்னல்கள் திறக்கப்படாவிட்டாலும், உங்கள் விருப்பங்களைப் பொறுத்து.

    • கிளையன் அல்லது டேமன் இயங்குகிறதா என்றால், kill PID ஐப் பயன்படுத்தி அவற்றை முடக்குங்கள்.

  2. ஒரு முனையத்தில், jamid -d -c உடன் டேமனைத் தொடங்கவும்

    • இந்த செயல்படுத்தக்கூடியது வழக்கமாக PATH இல் இல்லை, மேலும் டெபியன்/டிரிஸ்கல்/புபுண்டு தொகுப்புகளில், அது /usr/lib/x86_64-linux-gnu/jamid -d -c அல்லது /usr/libexec/jamid -d -c இல் அமைந்துள்ளது.

  3. In another terminal, start the client, using jami -d.

பின்னோக்கிப் பார்க்க, நீங்கள் GDB உள்ளே நிரலை இயக்கலாம்ஃ

gdb -ex run --args jami -d, or gdb -ex run --args /usr/libexec/jamid -cd, depending on the component you need to debug.

அது செயலிழக்கும் போது, நீங்கள் bt (அல்லது இன்னும் சிறப்பாக, thread bt அனைத்தையும் பயன்படுத்தலாம்) மற்றும் Enter என்பதை அழுத்தலாம். பின்னர் பின்னிணைப்பை நகலெடுத்து அதை வெளியீட்டில் ஒட்டவும்.

macOS இல்

  • /Applications/Jami.app/Contents/MacOS/ க்கு செல்லவும்.

  • ஜாமி என்பதை இரட்டை கிளிக் செய்யவும், அது ஜாமிவை இயக்கி முனையத்திற்கு பதிவு அச்சிடும்.

  • முனையத்திலிருந்து பதிவுகளை ஒரு கோப்பில் நகலெடுக்கவும்.

மாற்றாக, நீங்கள் /< பாதை Jami>/Jami.app/Contents/MacOS/Jami -d முனையத்திலிருந்து இயக்கலாம்.

Android இல்

ஜாமிக்கு உதவியாக உங்கள் தொலைபேசியில் பதிவுகளை சேகரிக்கஃ

  • உரையாடல்கள்

  • மேல் வலதுபுறத்தில் உள்ள மூன்று புள்ளிகள் மெனுவை தட்டவும்

  • அமைப்புகள்

  • `அறிவு பதிவுகளைத் தட்டவும்

Android Debug Bridge (adb) ஐ பயன்படுத்தி உங்கள் கணினியில் பதிவுகளை சேகரிக்கஃ

  • உங்கள் கணினியில் AdB அமைக்க வேண்டும்.

  • உங்கள் ஸ்மார்ட்போன் மீது ஜாமி தொடங்க மற்றும் பின்னர் மரணதண்டனை

  • ```adb logcat *:D ♬ grep adb shell ps egrep 'cx.ring' cut -c10-15 > logring.txt``

  • நீங்கள் இப்போது வாடிக்கையாளர் பதிவுகள் கொண்ட ஒரு கோப்பு உள்ளது

விண்டோஸ்

பின்வரும் விருப்பங்களுடன் ஒரு முனையத்தை (cmd.exe) திறந்து Jami.exe ஐ இயக்கவும்ஃ

  • -d பதிவுகளை பெற தனி கன்சோல் விண்டோவைத் திறக்க

  • -f % localappdata%\jami\jami.log