منصوبے کے بارے میں
جائزہ
رائیبٹ موبل ایک کمیونٹی دی گئی فلٹر ایپلی کیشن ہے جو رائیبٹ اینالٹکس سرور سے جڑتی ہے۔ یہ ویب اینالٹکس ڈیٹا دیکھنے کے لیے نیٹیو موبائل تجربہ فراہم کرتی ہے، جس میں پرائزی اور اوپن سورس ڈویلپمنٹ پر زور ہے۔
اسکرین شاٹس
ایپ میں ڈیش بورڈ جائزہ، اینالٹکس چارٹس، سیشن فہرست، سائٹ سیٹنگز اور مزید اسکرین شامل ہیں۔ مزید اسکرین شاٹس ملک کے نقشوں، صفحات کی فہرست اور تفصیلی سیشن دیکھنے کو دکھاتے ہیں۔
خصوصیات
- ریل ٹائم وزیٹرز، تنظیم فلٹر اور وقت کی حد منتخب کرنے والی ڈیش بورڈ۔
- صارفین، سیشنز، صفحات، باؤنس ریٹ، دورانیہ اور مزید کے لیے وقت سیریز چارٹس۔
- تفصیلی میٹرکس: سب سے اوپر کے صفحات، رفررز، ملک (جیسے پرچم)، ڈیوائسز، براؤزرز، OS۔
- کور ویب ویٹلز کی نگرانی (LCP، CLS، FCP، TTFB، INP) رنگیں ریٹنگ اور ٹرینڈ چارٹس کے ساتھ۔
- کسٹم ایونٹس جائزہ، خصوصیات کی تجزیہ اور باہر کے لنک کا تعین۔
- گولز کی تخلیق (پاتھ-بنیادی اور ایونٹ-بنیادی) اور فنل کے ساتھ کنورژن کی شرح کی ویژوالائزیشن۔
- ملک کے پرچم، براؤزر معلومات، انگریزی صفحہ کے ساتھ سیشن فہرست؛ سیشن کی تفصیل میں مکمل ایونٹ ٹائم لائن اور ریپلے دکھاتی ہے۔
- جاوا اسکرپٹ خرابی کا تعین، جس میں واقعات کی تعداد اور متاثرہ سیشنز شامل ہیں۔
- سائٹ کی تشکیل (ٹریکنگ ٹوگلز، مستثمر IP/ملک) اور تنظیم کے ممبروں کا منتظم کرنا۔
- ڈارک/لائٹ/آٹو تھیم، زبان کا انتخاب (11 زبانوں)، سرور URL اور تصدیق کا طریقہ کی سیٹنگز۔
زبانیں جو سپورٹ کی جاتی ہیں
انگریزی (en)، جاپانی (ja)، چیک (cs)، کوریائی (ko)، جرمن (de)، پولش (pl)، سپینی (es)، پرتگالی (pt)، فرانسیسی (fr)، چینی (zh)، اطالوی (it)۔
شروع کرنا
ضروریات
- فلٹر SDK 3.38+۔
- اینڈروئیڈ SDK (API 21+) یا iOS کے لیے Xcode (12+)۔
- رائیبٹ انسٹنس تک رسائی۔
سیٹ اپ
1. ریپوزٹری کلون کریں۔
2. `flutter pub get` کو چلانے سے ڈیپنڈنسیز انسٹال کریں۔
3. `flutter pub run build_runner build --delete-conflicting-outputs` کے ذریعے کوڈ جنریٹ کریں۔
4. `flutter gen-l10n` کے ذریعے مقامی فائلز جنریٹ کریں۔
5. `.env.example` کو `.env` میں کاپی کریں اور ضروری متغیرات بھریں۔
6. `flutter run --dart-define-from-file=.env` کے ذریعے ایپ چلانا یا APK/IPA بنا کر چلانا۔
تصدیق
دو طریقوں کی سپورٹ ہے: ای میل + پاس ورڈ لاگ ان اور API کی چابی کی تصدیق۔ لاگ ان اسکرین پر رائیبٹ سرور URL اور کریڈینشلز داخل کریں۔
ٹیکنال اسٹیک
- فریم ورک: فلٹر 3.38+ / Dart 3.10+
- اسٹیٹ منیجمنٹ: Riverpod
- روٹنگ: go_router
- HTTP کلائنٹ: Dio کے ساتھ کوکی کا تعین
- لوکل سٹوریج: Hive اور Flutter Secure Storage
- چارٹس: fl_chart
- سریلائزیشن: Freezed + json_serializable
- مقامی بندی: Flutter gen-l10n (ARB فائلز)
- اختیاری خرابی کا تعین: Sentry (via `SENTRY_DSN` کے ذریعے کنفیگر کیا گیا)
آرکیٹیکچر
پروجیکٹ فیچر-پہلے ماڈولر لے آؤٹ کی پیروی کرتا ہے:
lib/
core/ // ترتیبات، نیٹ ورک، روٹنگ، تھیم، سٹوریج، Sentry
features/ // ہر اینالٹکس فیچر (ڈیش بورڈ، سیشنز، پرفارمنس، وغیرہ)
l10n/ // ترجمہ ARB فائلز
shared/ // مشترکہ ماڈلز، یوٹیلز، دوبارہ استعمال کرنے والے ویجیٹس
ہر فیچر کو ڈیٹا (API)، ایپلیکیشن (اسٹیٹ) اور پریزنٹیشن (UI) لیئرز میں تقسیم کیا گیا ہے۔
ڈویلپمنٹ کمانڈز
- ڈیبگ: `flutter run --dart-define-from-file=.env`
- APK بنانا: `flutter build apk --debug|--release --dart-define-from-file=.env`
- کوڈ جنریشن: `flutter pub run build_runner build --delete-conflicting-outputs`
- ترجمہ دوبارہ جنریٹ کرنا: `flutter gen-l10n`
- تجزیہ: `flutter analyze`
- ٹیسٹ: `flutter test`
نئی زبان شامل کرنا
`app_en.arb` کی بنیاد پر نئی ARB فائل بنائیں، تمام کیز ترجمہ کریں، ایپ کے اندراج پر موجود سپورٹڈ لوکلز میں لوکل کوڈ شامل کریں، پھر `flutter gen-l10n` چلائیں۔
توافق
- اینڈروئیڈ: API 21 (لولیپاپ) اور نئی ترین۔
- iOS: ورژن 12.0 اور نئی ترین۔
- بیک اینڈ: رائیبٹ v1.0 یا اس سے بعد کے ورژنز کے ساتھ مطابقت رکھتا ہے۔
تعاون
تعاون کی اجازت ہے۔ ریپوزٹری کو فورک کریں، فیچر برانچ بنائیں، تبدیلیاں کمٹ کریں، پوش کریں اور پل ریکوئسٹ کھولیں۔ موجودہ کوڈ سٹائل کی پیروی کریں اور جمع کرنے سے پہلے ٹیسٹ چلائیں۔
لائسنس
یہ غیر رسمی کمیونٹی پروجیکٹ ہے۔ تحت الرائیبٹ پلیٹ فارم کی ڈویلپمنٹ rybbit-io تنظیم کی طرف سے کی گئی ہے۔ ایپ ریپوزٹری کی لائسنس کے ساتھ جاری کی گئی ہے (LICENSE فائل دیکھیں)۔
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.