கண்டறிதல், பதிவுகள் & பிழை அறிக்கைகள்

ஒவ்வொரு ட்ரேஸ்லெட் பயன்பாடும் SDK சாதனத்தில் என்ன செய்கிறது - அனுமதிகள், கண்காணிப்பு நிலை, சென்சார் கிடைக்கும் தன்மை மற்றும் உருட்டல் பதிவு. தி tracelet_doctor தொகுப்பு அனைத்தையும் a ஆக மாற்றுகிறது ஒரே தட்டினால் கண்டறியும் திரை மற்றும் நகலெடுத்து ஒட்டு பிழை அறிக்கை, எனவே எப்போது ஏதோ தவறாகத் தெரிகிறது நீங்கள் (அல்லது உங்கள் பயனர்கள்) என்ன நடந்தது என்பதை சரியாகப் பிடிக்க முடியும்.

30-வினாடி பதிப்பு

tracelet_doctor ஐ தேவ் சார்பு (வழக்கமான ஒன்று அல்ல) - இது பிழைத்திருத்தமாகும் கருவி, மற்றும் Flutter வெளியீட்டு உருவாக்கங்களில் இருந்து dev-சார்பு தொகுப்புகளை விலக்குகிறது:

flutter pub add dev:tracelet_doctor

kDebugMode க்குப் பின் பாதுகாப்புப் பயன்பாடு, அதனால் அது மரத்தால் அசைக்கப்பட்டது.

import 'package:flutter/foundation.dart' show kDebugMode;
import 'package:tracelet_doctor/tracelet_doctor.dart';
 
// Open the diagnostic screen from a debug menu, button, or shake gesture:
if (kDebugMode) {
  TraceletDoctor.show(context);
}

இது ஒரு தாளைத் திறக்கிறது:

• எச்சரிக்கைகள் - கண்காணிப்பை பாதிக்கக்கூடிய எதுவும் (அனுமதி மறுக்கப்பட்டது, சக்தி சேமிப்பு பயன்முறை, ஆக்கிரமிப்பு OEM, குறிப்பிடத்தக்க-இயக்கம் சென்சார் இல்லை, போலி இடங்கள்…).
• அனுமதிகள், கண்காணிப்பு நிலை, பேட்டரி & OEM, கட்டமைப்பு, சென்சார்கள், தரவுத்தளம்.
• ஒரு பதிவுகளைக் காண்க பொத்தான் (கடைசி 500 பதிவு வரிகள்).
• பிழை அறிக்கையை நகலெடு மற்றும் பிழை அறிக்கையைப் பகிர் பொத்தான்கள் மேல் வலதுபுறத்தில்.

பிழை அறிக்கையை தாக்கல் செய்தல் (உங்கள் பயனர்களுக்கு)

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

1. டிரேஸ்லெட் டாக்டர் திரையைத் திறக்கவும் (உங்கள் பயன்பாட்டில் எங்கு வைத்தாலும்).
2. மேல் வலதுபுறத்தில் உள்ள பகிர் ஐகானை (↗) - அல்லது நகலெடு (⧉) - தட்டவும்.
3. உங்கள் ஆதரவு சேனலில் அல்லது GitHub சிக்கலில் ஒட்டு / இணைக்கவும் உங்களின் சொந்த பயன்பாட்டுப் பதிவுகளில் ஏதேனும்*.

அறிக்கை எளிய மார்க் டவுன் மற்றும் இது போல் தெரிகிறது:

# Tracelet Bug Report
 
_Generated by Tracelet Doctor at 2026-06-14T10:22:31Z (UTC)._
 
## Health check
| Field | Value |
|---|---|
| Platform | android |
| OS version | 14 |
| Manufacturer | Xiaomi |
| Aggressive OEM | true (rating 5/5) |
| Location permission | always |
| Power save mode | true |
...
**Warnings (2):**
- ⚠️ Power Save mode is ON — may throttle background tracking
- ⚠️ Device manufacturer may kill background apps
 
## Active configuration
```json
{ "geo": { "distanceFilter": 10.0, ... },
"http": { "url": " «திருத்தப்பட்டது»", "தலைப்புகள்": " «திருத்தப்பட்டது»", ... }}
```
 
## Telematics events (most recent)
| Type | Severity | Lat | Lng | Time | Synced |
...
 
## Logs (last 500)
2026-06-14T10:21:55Z [INFO] Tracking started (mode: location)
2026-06-14T10:22:03Z [WARN] Location accuracy degraded
...

பதிவுகளுடன் நேரடியாக வேலை செய்தல்

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

// Read the most recent log entries.
final logs = await Tracelet.getLogs(500);
for (final entry in logs) {
  print('${entry.timestamp} [${entry.level}] ${entry.message}');
}
 
// Wipe stored logs (e.g. after the user files a report).
await Tracelet.clearLogs();

ஒவ்வொரு LogEntry, id, level (DEBUG/INFO/WARN/ERROR), message, மற்றும் ஒரு ISO-8601 timestamp. பதிவுகள் சாதனத்தில் உள்ள SQLite தரவுத்தளத்தில் சேமிக்கப்படும் அவர்கள் பயன்பாட்டை மறுதொடக்கம் செய்து பின்னணி செயல்பாட்டைப் பிடிக்கிறார்கள் - சரியாக பிழைத்திருத்தியில் பார்க்க முடியாத நிகழ்வுகள்.

உங்கள் சொந்த அறிக்கையை உருவாக்குதல்

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

import 'package:tracelet_doctor/tracelet_doctor.dart';
 
final report = await TraceletBugReport.build(
  appName: 'My App',
  appVersion: '2.4.1',   // e.g. from package_info_plus
  logLimit: 500,
  telematicsLimit: 100,
);
 
// Now copy, share, upload, or attach `report` however you like.

நீங்கள் எந்த கட்டமைப்பு வரைபடத்திலும் ரகசிய-திருத்தம் உதவியாளரை மீண்டும் பயன்படுத்தலாம் - எளிது உங்கள் சொந்த கட்டமைப்பை நீங்கள் பதிவு செய்தால்:

final safe = TraceletBugReport.redactConfig(Tracelet.activeConfig.toMap());

அறிக்கையில் என்ன இருக்கிறது (ஏமாற்ற தாள்)

தெரிந்து கொள்வது நல்லது

• முதலில் தனியுரிமை - அறிக்கை முழு சாதனத்திலும் உருவாக்கப்படுகிறது. ஒன்றுமில்லை நீங்கள் அனுப்பும் வரை பதிவேற்றப்பட்டது. இரகசியங்கள் சேர்க்கப்படுவதற்கு முன்பு அவை திருத்தப்படுகின்றன.
• தொடக்கம் செய்யப்படாத போது வேலை செய்யும் — ட்ரேஸ்லெட் இன்னும் தொடங்கப்படவில்லை என்றால், மருத்துவர் செயலிழப்பதற்குப் பதிலாக நட்பு “தொடக்கப்படாத” திரையைக் காட்டுகிறது, மேலும் ஒவ்வொரு அறிக்கையும் பிரிவு அழகாகச் சிதைகிறது.
• பிழைத்திருத்த உருவாக்கங்களில் அனுப்பவும் — பல குழுக்கள் TraceletDoctor.show(context) ஐ ஒரு க்கு அனுப்புகின்றன குலுக்கல் சைகை அல்லது மறைக்கப்பட்ட பிழைத்திருத்த மெனுவின் மூலம் QA மற்றும் ஆதரவு ஒரு அறிக்கையைப் பெற முடியும் வினாடிகள்.