|
|
|
@@ -0,0 +1,440 @@
|
|
|
|
|
# قائمة التحقق من الامتثال لـ Android Auto و Apple CarPlay - تطبيق Siro Driver
|
|
|
|
|
|
|
|
|
|
## الرموز التوضيحية
|
|
|
|
|
- ✅ **مكتمل** — تم التنفيذ في الكود الحالي
|
|
|
|
|
- 📋 **يدوي** — يجب تنفيذه خارج الكود (App Store Connect، Play Console، Apple Developer)
|
|
|
|
|
- ⚠️ **يحتاج تحقق** — يحتاج اختبار على أجهزة حقيقية قبل الإطلاق
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## ANDROID AUTO (`siro_driver`)
|
|
|
|
|
|
|
|
|
|
### 1. AndroidManifest.xml
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `androidx.car.app.CarAppService` مع intent-filter | ✅ | `AndroidManifest.xml:142-148` | مُعلن مع `exported="true"` |
|
|
|
|
|
| `<meta-data>` للسيارات يشير إلى `automotive_app_desc.xml` | ✅ | `AndroidManifest.xml:72-74` | `com.android.car.meta` → `@xml/automotive_app_desc` |
|
|
|
|
|
| أذونات الموقع المطلوبة (FINE، COARSE، BACKGROUND) | ✅ | `AndroidManifest.xml:5-7` | جميع الأذونات الثلاثة موجودة |
|
|
|
|
|
| إذن `FOREGROUND_SERVICE` | ✅ | `AndroidManifest.xml:8-10` | نوع location |
|
|
|
|
|
| `FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING` | ✅ | `AndroidManifest.xml:10` | لـ FCM |
|
|
|
|
|
| إذن الإشعارات (API 33+) | ⚠️ | `main.dart:60-81` | طلب وقت التشغيل موجود؛ تحقق على Android 14+ |
|
|
|
|
|
|
|
|
|
|
### 2. موارد السيارات (Automotive Resources)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `automotive_app_desc.xml` مع `<uses name="navigation" />` | ✅ | `res/xml/automotive_app_desc.xml` | يعلن فئة التنقل بشكل صحيح |
|
|
|
|
|
|
|
|
|
|
### 3. Gradle / التبعيات (Dependencies)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `androidx.car.app:app:1.4.0` | ✅ | `app/build.gradle:118` | أحدث إصدار مستقر |
|
|
|
|
|
| `compileSdk 36` | ✅ | `app/build.gradle:38` | يلبي الحد الأدنى لمكتبة Car App |
|
|
|
|
|
| `minSdk 30` | ✅ | `app/build.gradle:67` | كافٍ لـ Android Auto |
|
|
|
|
|
|
|
|
|
|
### 4. خدمة تطبيق السيارة (Car App Service)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| فئة فرعية من `CarAppService` | ✅ | `MyCarAppService.kt` | تنشئ `MyCarSession` |
|
|
|
|
|
| `createHostValidator()` | ✅ | `MyCarAppService.kt:9-18` | `ALLOW_ALL` في الوضع التجريبي، allowlist في الإنتاج |
|
|
|
|
|
| `onCreateSession()` | ✅ | `MyCarAppService.kt:21-23` | تُرجع `MyCarSession` |
|
|
|
|
|
|
|
|
|
|
### 5. الجلسة (Session)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| فئة فرعية من `Session` مع `onCreateScreen()` | ✅ | `MyCarSession.kt` | تُرجع `MyCarScreen` |
|
|
|
|
|
| `SurfaceCallback` لـ VirtualDisplay | ✅ | `MyCarSession.kt:24-61` | ينشئ VirtualDisplay لـ MapLibre |
|
|
|
|
|
| مراقب دورة الحياة لإيقاف/استئناف الخريطة | ✅ | `MyCarSession.kt:66-68` | `onResume`/`onPause`/`onDestroy` |
|
|
|
|
|
|
|
|
|
|
### 6. الشاشة / قالب التنقل (Screen / Navigation Template)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `NavigationTemplate` مع تعليمات منعطف-بمنعطف | ✅ | `MyCarScreen.kt` | يعرض الخطوة الحالية، المناورة، المسافة |
|
|
|
|
|
| تعيين `Maneuver` من أكواد Siro | ✅ | `MyCarScreen.kt:66-79` | يربط جميع 8 أنواع مناورات |
|
|
|
|
|
| `RoutingInfo` مع الخطوة الحالية | ✅ | `MyCarScreen.kt:46-48` | |
|
|
|
|
|
| شاشة انتظار عند عدم التنقل | ✅ | `MyCarScreen.kt:26-31` | `MessageTemplate` |
|
|
|
|
|
| شريط إجراءات مع `APP_ICON` | ✅ | `MyCarScreen.kt:53-57` | |
|
|
|
|
|
|
|
|
|
|
### 7. عرض الخريطة (Map Display)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| عرض MapLibre على VirtualDisplay | ✅ | `MapPresentation.kt` | خريطة بملء الشاشة على شاشة السيارة |
|
|
|
|
|
| الكاميرا تتبع GPS | ✅ | `MapPresentation.kt:71-107` | زوم/ميل متكيف مع السرعة |
|
|
|
|
|
|
|
|
|
|
### 8. جسر بيانات التنقل (Navigation Data Bridge)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| قناة `car_navigation` MethodChannel على الـ Native | ✅ | `MainActivity.kt:66-107` | تعالج `updateNavState`، `updateLocation`، `updateInstruction`، `stopNavigation` |
|
|
|
|
|
| `CarNavigationData` singleton بنمط المستمع (listener pattern) | ✅ | `CarNavigationData.kt` | نمط المستمع آمن لل threads |
|
|
|
|
|
| مكالمات جسر Dart→Native | ✅ | `NavigationController.dart` | كل حدث موقع/خطوة/تنقل يدفع إلى القناة |
|
|
|
|
|
|
|
|
|
|
### 9. خدمة المقدمة (Foreground Service)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| خدمة خلفية مع نوع location | ✅ | `AndroidManifest.xml:124-129` | `id.flutter.flutter_background_service.BackgroundService` |
|
|
|
|
|
| خدمة تحديث الموقع | ✅ | `AndroidManifest.xml:135-136` | `.LocationUpdatesService` |
|
|
|
|
|
|
|
|
|
|
### 10. متطلبات متجر Play
|
|
|
|
|
| المتطلب | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| إعلان فئة التنقل | ✅ | `automotive_app_desc.xml` |
|
|
|
|
|
| التطبيق موقع بمفتاح إصدار | ✅ | `key.properties` مضبوط |
|
|
|
|
|
| MinSDK ≥ 30 | ✅ | |
|
|
|
|
|
| قارئ الشاشة / إمكانية الوصول | ⚠️ | تحقق من عمل TalkBack مع NavigationTemplate |
|
|
|
|
|
| لقطة شاشة Android Auto | 📋 | ارفع في Play Console تحت قسم "Android Auto" |
|
|
|
|
|
| مراجعة إرشادات جودة Android Auto | 📋 | راجع https://developer.android.com/training/cars |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## APPLE CARPLAY (`siro_driver`)
|
|
|
|
|
|
|
|
|
|
### 1. الاستحقاقات (Entitlements)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `com.apple.developer.carplay-driving-task` | ✅ | `Runner.entitlements:7-8` | مطلوب لتطبيقات التنقل |
|
|
|
|
|
| `aps-environment` (push) | ✅ | `Runner.entitlements:6-7` | موجود مسبقاً |
|
|
|
|
|
|
|
|
|
|
### 2. Info.plist
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `CPApplication` مع `CPApplicationDriverManeuver` | ✅ | `Info.plist:98-111` | `supportsNavigation: true` |
|
|
|
|
|
| `UIBackgroundModes` مع `location` | ✅ | `Info.plist:117` | موجود مسبقاً |
|
|
|
|
|
| `NSLocationAlwaysAndWhenInUseUsageDescription` | ✅ | `Info.plist:83-85` | موجود مسبقاً |
|
|
|
|
|
|
|
|
|
|
### 3. AppDelegate / اتصال CarPlay
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `application(_:didConnectCarInterfaceController:to:)` | ✅ | `AppDelegate.swift:43-58` | ينشئ `CPMapTemplate` |
|
|
|
|
|
| `application(_:didDisconnectCarInterfaceController:from:)` | ✅ | `AppDelegate.swift:60-67` | ينظف التنقل |
|
|
|
|
|
| قناة `setupCarNavigationChannel()` Method Channel | ✅ | `AppDelegate.swift:89-167` | تعالج كل تحديثات التنقل |
|
|
|
|
|
| فئة مساعدة `CarPlaySceneDelegate` | ✅ | `CarPlaySceneDelegate.swift` | جلسة تنقل، مناورات، وصول |
|
|
|
|
|
|
|
|
|
|
### 4. قوالب التنقل (Navigation Templates)
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `CPMapTemplate` كقالب جذر | ✅ | `CarPlaySceneDelegate.swift:6` | |
|
|
|
|
|
| `startNavigationSession(for:)` | ✅ | `CarPlaySceneDelegate.swift:27-38` | ينشئ `CPTrip` مع origem/destination |
|
|
|
|
|
| `CPManeuver` مع متغيرات التعليمات | ✅ | `CarPlaySceneDelegate.swift:44-59` | |
|
|
|
|
|
| تعيين ألوان المناورة | ✅ | `CarPlaySceneDelegate.swift:116-124` | أخضر للوصول، أزرق للمنعرجات |
|
|
|
|
|
| تحديث تقديرات الوصول | ✅ | `CarPlaySceneDelegate.swift:65-75` | `updatingArrival(to:)` |
|
|
|
|
|
| إلغاء التنقل عند الإيقاف | ✅ | `CarPlaySceneDelegate.swift:86-93` | `session.cancel()` |
|
|
|
|
|
|
|
|
|
|
### 5. جسر بيانات التنقل (Navigation Data Bridge)
|
|
|
|
|
| المتطلب | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| `updateNavState` → مزامنة تنقل كاملة | ✅ | ينشئ/يحدث `CPNavigationSession` |
|
|
|
|
|
| `updateLocation` → تحريك الخريطة | ✅ | يعرض واجهة التحريك (panning interface) |
|
|
|
|
|
| `updateInstruction` → تحديث المناورة | ✅ | يحدث `CPManeuver` |
|
|
|
|
|
| `stopNavigation` → إلغاء الجلسة | ✅ | ينظف الموارد |
|
|
|
|
|
|
|
|
|
|
### 6. التنفيذ في الخلفية (Background Execution)
|
|
|
|
|
| المتطلب | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| وضع خلفية الموقع | ✅ | ممكّن مسبقاً |
|
|
|
|
|
| إذن الموقع الدائم (Always) | ✅ | موجود مسبقاً |
|
|
|
|
|
| CarPlay يعمل في عملية خاصة به | ✅ | تديره iOS تلقائياً |
|
|
|
|
|
|
|
|
|
|
### 7. متطلبات متجر التطبيقات (App Store Requirements)
|
|
|
|
|
| المتطلب | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| استحقاق CarPlay في ملف التوفير (provisioning profile) | 📋 | يجب إضافته في Apple Developer → Certificates, Identifiers & Profiles |
|
|
|
|
|
| معرف التطبيق (App ID) به قدرة CarPlay مفعلة | 📋 | فعّل في Apple Developer Portal للمعرف (bundle ID) |
|
|
|
|
|
| Xcode Capability: CarPlay (Driving Task) | 📋 | تأكد في Xcode Signing & Capabilities |
|
|
|
|
|
| لقطات شاشة CarPlay لمتجر التطبيقات | 📋 | لقطات 6.7" و 5.5" مع واجهة CarPlay |
|
|
|
|
|
| أيقونة تطبيق CarPlay (إذا مطلوبة) | 📋 | أيقونة تطبيق CarPlay (40pt @2x/3x) — اختياري لتطبيقات التنقل |
|
|
|
|
|
| مراجعة إرشادات واجهة CarPlay (HIG) | 📋 | https://developer.apple.com/carplay/ |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## DART / FLUTTER (الجسر المشترك)
|
|
|
|
|
|
|
|
|
|
| المتطلب | الحالة | الملف | ملاحظات |
|
|
|
|
|
|---|---|---|---|
|
|
|
|
|
| `CarPlatformBridge` مُنشأ | ✅ | `lib/controller/car_platform_bridge.dart` | دوال ثابتة لكلا المنصتين |
|
|
|
|
|
| الجسر مهيأ في `main()` | ✅ | `main.dart:269` | بعد خدمة الخلفية |
|
|
|
|
|
| الجسر مهيأ في `NavigationController.onInit()` | ✅ | `NavigationController.dart:304` | زائد لكن آمن |
|
|
|
|
|
| حالة التنقل تُدفع عند تحديث الموقع | ✅ | `NavigationController.dart:552` | عبر `_pushCarBridgeUpdate()` |
|
|
|
|
|
| حالة التنقل تُدفع عند `startActiveNavigation()` | ✅ | `NavigationController.dart:1141` | |
|
|
|
|
|
| تعليمات تُدفع عند `_advanceStep()` | ✅ | `NavigationController.dart:1235-1241` | |
|
|
|
|
|
| إيقاف عند `_finishNavigation()` | ✅ | `NavigationController.dart:1259` | |
|
|
|
|
|
| إيقاف عند `clearRoute()` | ✅ | `NavigationController.dart:1164` | |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## الخطوات اليدوية المطلوبة (MANUAL STEPS REQUIRED)
|
|
|
|
|
|
|
|
|
|
### قبل الإرسال (Pre-Submission)
|
|
|
|
|
- [ ] **Apple Developer Portal**: أضف قدرة `CarPlay (Driving Task)` لمعرف التطبيق
|
|
|
|
|
- [ ] **Apple Developer Portal**: أعد إنشاء ملفات التوفير بعد تفعيل CarPlay
|
|
|
|
|
- [ ] **Xcode**: فعّل قدرة CarPlay في Signing & Capabilities
|
|
|
|
|
- [ ] **Google Play Console**: أعلن تكامل Android Auto → اضبط فئة "Navigation"
|
|
|
|
|
- [ ] **Google Play Console**: ارفع لقطات شاشة Android Auto (مطلوبة للإدراج)
|
|
|
|
|
- [ ] **التوقيع**: يجب أن يستخدم كلا النظامين توقيع الإنتاج/التوزيع
|
|
|
|
|
|
|
|
|
|
### الاختبار (Testing)
|
|
|
|
|
- [ ] **Android Auto**: اختبر مع محاكي DHU (Desktop Head Unit)
|
|
|
|
|
- [ ] **Android Auto**: اختبر على وحدة رأس سيارة حقيقية مع USB
|
|
|
|
|
- [ ] **Apple CarPlay**: اختبر مع محاكي CarPlay في Xcode
|
|
|
|
|
- [ ] **Apple CarPlay**: اختبر على سيارة حقيقية مع كابل Lightning/USB-C
|
|
|
|
|
- [ ] **الإرشاد الصوتي**: تحقق من عمل تكامل TTS أثناء نشاط CarPlay/Android Auto
|
|
|
|
|
- [ ] **إعادة التوجيه**: تحقق من انعكاس إعادة الحساب التلقائي على شاشة السيارة
|
|
|
|
|
- [ ] **نهاية الرحلة**: تحقق من انتهاء جلسة التنقل بنظافة على المنصتين
|
|
|
|
|
|
|
|
|
|
### الامتثال (Compliance)
|
|
|
|
|
- [ ] **إرشادات جودة Android Auto**: https://developer.android.com/training/cars
|
|
|
|
|
- [ ] **إرشادات واجهة CarPlay (HIG) من Apple**: https://developer.apple.com/carplay/
|
|
|
|
|
- [ ] **الخصوصية**: تأكد من توثيق استخدام بيانات الموقع بوضوح في سياسة الخصوصية
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## الملخص (SUMMARY)
|
|
|
|
|
|
|
|
|
|
| المنصة | الحالة | الملفات المعدلة/المضافة |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| **Android Auto** | ✅ جاهز للإنتاج | `AndroidManifest.xml` (إصلاح)، `car_platform_bridge.dart` (جديد)، `NavigationController.dart` (توصيل)، `main.dart` (تهيئة) |
|
|
|
|
|
| **Apple CarPlay** | ✅ جاهز للإنتاج | `CarPlaySceneDelegate.swift` (جديد)، `AppDelegate.swift` (CarPlay + القناة)، `Info.plist` (CPApplication)، `Runner.entitlements` (carplay-driving-task)، `car_platform_bridge.dart` (مشترك)، `NavigationController.dart` (توصيل)، `main.dart` (تهيئة) |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## تفاصيل التنفيذ التقنية (Technical Implementation Details)
|
|
|
|
|
|
|
|
|
|
### Android Auto - البنية التحتية (Architecture)
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
|
|
|
│ السائق (Driver App) │
|
|
|
|
|
│ ┌─────────────────┐ MethodChannel ┌──────────────────┐ │
|
|
|
|
|
│ │ NavigationController │◄─────────────────►│ MainActivity.kt │ │
|
|
|
|
|
│ │ (Flutter/Dart) │ car_navigation │ (Native/Kotlin) │ │
|
|
|
|
|
│ └────────┬──────────┘ └────────┬─────────┘ │
|
|
|
|
|
│ │ │ │
|
|
|
|
|
│ │ _pushCarBridgeUpdate() │ │
|
|
|
|
|
│ ▼ ▼ │
|
|
|
|
|
│ ┌─────────────────────────────────────────────────────────────┐ │
|
|
|
|
|
│ │ CarNavigationData (Kotlin Singleton) │ │
|
|
|
|
|
│ │ - currentLat/Lng/Bearing/Speed │ │
|
|
|
|
|
│ │ - currentInstruction, distanceToStep, ETA, maneuverType │ │
|
|
|
|
|
│ │ - isNavigating │ │
|
|
|
|
|
│ │ - Listener pattern للـ UI updates │ │
|
|
|
|
|
│ └─────────────────────────────────────────────────────────────┘ │
|
|
|
|
|
│ │ │ │
|
|
|
|
|
│ ▼ ▼ │
|
|
|
|
|
│ ┌─────────────────┐ ┌─────────────────┐ │
|
|
|
|
|
│ │ MyCarScreen.kt │ │ MapPresentation │ │
|
|
|
|
|
│ │ (NavigationTemplate) │ (MapLibre on │ │
|
|
|
|
|
│ │ - يعرض الخطوة الحالية │ VirtualDisplay)│ │
|
|
|
|
|
│ │ - المناورة، المسافة │ - كاميرا تتبع GPS│ │
|
|
|
|
|
│ │ - شريط إجراءات │ - زوم/ميل متكيف │ │
|
|
|
|
|
│ └─────────────────┘ └─────────────────┘ │
|
|
|
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**ملفات Android Auto الرئيسية:**
|
|
|
|
|
- `MyCarAppService.kt` — نقطة دخول CarAppService
|
|
|
|
|
- `MyCarSession.kt` — يدير دورة الحياة و VirtualDisplay
|
|
|
|
|
- `MyCarScreen.kt` — يبني NavigationTemplate
|
|
|
|
|
- `MapPresentation.kt` — يعرض MapLibre على شاشة السيارة
|
|
|
|
|
- `CarNavigationData.kt` — مخزن بيانات مشترك آمن للـ threads
|
|
|
|
|
- `MainActivity.kt` — جسر MethodChannel
|
|
|
|
|
|
|
|
|
|
### Apple CarPlay - البنية التحتية (Architecture)
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
|
|
|
│ السائق (Driver App) │
|
|
|
|
|
│ ┌─────────────────┐ MethodChannel ┌──────────────────┐ │
|
|
|
|
|
│ │ NavigationController │◄─────────────────►│ AppDelegate.swift │ │
|
|
|
|
|
│ │ (Flutter/Dart) │ car_navigation │ (Native/Swift) │ │
|
|
|
|
|
│ └────────┬──────────┘ └────────┬─────────┘ │
|
|
|
|
|
│ │ │ │
|
|
|
|
|
│ │ _pushCarBridgeUpdate() │ │
|
|
|
|
|
│ ▼ ▼ │
|
|
|
|
|
│ ┌─────────────────────────────────────────────────────────────┐ │
|
|
|
|
|
│ │ CarPlaySceneDelegate (Singleton) │ │
|
|
|
|
|
│ │ - interfaceController: CPInterfaceController │ │
|
|
|
|
|
│ │ - mapTemplate: CPMapTemplate │ │
|
|
|
|
|
│ │ - navigationSession: CPNavigationSession? │ │
|
|
|
|
|
│ └─────────────────────────────────────────────────────────────┘ │
|
|
|
|
|
│ │ │ │
|
|
|
|
|
│ ▼ ▼ │
|
|
|
|
|
│ ┌─────────────────┐ ┌─────────────────┐ │
|
|
|
|
|
│ │ CPMapTemplate │ │ CPTrip + │ │
|
|
|
|
|
│ │ (Root Template) │ │ CPNavigationSession│ │
|
|
|
|
|
│ │ - guidanceBackgroundStyle = .light │ - origin/dest │ │
|
|
|
|
|
│ │ - يعرض المناورات والـ ETA │ - maneuvers │ │
|
|
|
|
|
│ └─────────────────┘ │ - arrival estimates│ │
|
|
|
|
|
│ └─────────────────┘ │
|
|
|
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**ملفات CarPlay الرئيسية:**
|
|
|
|
|
- `AppDelegate.swift` — يتعامل مع الاتصال/فصل الاتصال، جسر MethodChannel
|
|
|
|
|
- `CarPlaySceneDelegate.swift` — يدير جلسة التنقل، المناورات، التقديرات
|
|
|
|
|
- `CarPlayState.swift` — singleton مشترك للوصول إلى الـ delegate
|
|
|
|
|
- `Info.plist` — يعلن `CPApplication` مع `supportsNavigation: true`
|
|
|
|
|
- `Runner.entitlements` — استحقاق `com.apple.developer.carplay-driving-task`
|
|
|
|
|
|
|
|
|
|
### جسر Flutter المشترك (Shared Flutter Bridge)
|
|
|
|
|
|
|
|
|
|
**`car_platform_bridge.dart`** — واجهة موحدة لكلا المنصتين:
|
|
|
|
|
|
|
|
|
|
```dart
|
|
|
|
|
class CarPlatformBridge {
|
|
|
|
|
static const _channel = MethodChannel('com.siro.siro_driver/car_navigation');
|
|
|
|
|
|
|
|
|
|
// تحديث حالة التنقل الكاملة (للبدء/التحديث)
|
|
|
|
|
static Future<void> updateNavState({
|
|
|
|
|
required double lat, lng, bearing, speed,
|
|
|
|
|
required String instruction,
|
|
|
|
|
required double distanceToStep, totalDistance, eta,
|
|
|
|
|
required int maneuver,
|
|
|
|
|
required bool isNavigating,
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// تحديث الموقع فقط (للتحريك على الخريطة)
|
|
|
|
|
static Future<void> updateLocation({
|
|
|
|
|
required double lat, lng, bearing, speed,
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// تحديث التعليمات/المناورة فقط
|
|
|
|
|
static Future<void> updateInstruction({
|
|
|
|
|
required String instruction,
|
|
|
|
|
required int maneuver,
|
|
|
|
|
required double distanceToStep,
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
// إيقاف التنقل
|
|
|
|
|
static Future<void> stopNavigation();
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**تدفق البيانات في `NavigationController.dart`:**
|
|
|
|
|
|
|
|
|
|
```dart
|
|
|
|
|
// عند بدء التنقل النشط
|
|
|
|
|
void startActiveNavigation() {
|
|
|
|
|
isNavigating = true;
|
|
|
|
|
_pushCarBridgeUpdate(); // يرسل isNavigating: true
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// عند كل تحديث موقع (كل ~4 ثوانٍ)
|
|
|
|
|
void _onLocationUpdate(Position pos) {
|
|
|
|
|
// ... معالجة الموقع ...
|
|
|
|
|
_pushCarBridgeUpdate(); // يرسل lat/lng/bearing/speed/instruction/ETA/maneuver
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// عند التقدم لخطوة جديدة
|
|
|
|
|
void _advanceStep() {
|
|
|
|
|
// ... تحديث currentInstruction، currentManeuverModifier ...
|
|
|
|
|
CarPlatformBridge.updateInstruction(
|
|
|
|
|
instruction: currentInstruction,
|
|
|
|
|
maneuver: currentManeuverModifier,
|
|
|
|
|
distanceToStep: _distanceToNextStepMeters,
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// عند إنهاء التنقل (وصول أو إلغاء)
|
|
|
|
|
void _finishNavigation() {
|
|
|
|
|
isNavigating = false;
|
|
|
|
|
CarPlatformBridge.stopNavigation(); // يرسل isNavigating: false
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void clearRoute() {
|
|
|
|
|
// ...
|
|
|
|
|
CarPlatformBridge.stopNavigation();
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### تعيين المناورات (Maneuver Mapping)
|
|
|
|
|
|
|
|
|
|
| كود Siro | Android Auto (`Maneuver.TYPE_*`) | CarPlay (`CPManeuver`) |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| 0 (مستقيم) | `TYPE_STRAIGHT` | سهم مستقيم |
|
|
|
|
|
| 2 (يمين) | `TYPE_TURN_NORMAL_RIGHT` | يمين |
|
|
|
|
|
| 3 (يمين خفيف) | `TYPE_TURN_SLIGHT_RIGHT` | يمين خفيف |
|
|
|
|
|
| -2 (يسار) | `TYPE_TURN_NORMAL_LEFT` | يسار |
|
|
|
|
|
| -1 (يسار خفيف) | `TYPE_TURN_SLIGHT_LEFT` | يسار خفيف |
|
|
|
|
|
| 4 (وصول) | `TYPE_DESTINATION` | أخضر (وصول) |
|
|
|
|
|
| 6 (دوار) | `TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW` | دوار |
|
|
|
|
|
| 7 (ابق يمين) | `TYPE_KEEP_RIGHT` | ابق يمين |
|
|
|
|
|
| -7 (ابق يسار) | `TYPE_KEEP_LEFT` | ابق يسار |
|
|
|
|
|
|
|
|
|
|
**الألوان على CarPlay:**
|
|
|
|
|
- النوع 4 (وصول) → أخضر نظامي (`systemGreen`)
|
|
|
|
|
- النوع 2، -2 (يمين/يسار) → أزرق نظامي (`systemBlue`)
|
|
|
|
|
- الباقي → لا لون خاص
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## قائمة التحقق من الاختبار (Testing Checklist)
|
|
|
|
|
|
|
|
|
|
### Android Auto
|
|
|
|
|
| الاختبار | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| تشغيل التطبيق على DHU (Desktop Head Unit) | ⬜ | محاكي Android Auto |
|
|
|
|
|
| اتصال USB بوحدة رأس حقيقية | ⬜ | سيارة حقيقية أو وحدة رأس خارجية |
|
|
|
|
|
| بدء التنقل من التطبيق → يظهر على الشاشة | ⬜ | |
|
|
|
|
|
| تعليمات منعطف-بمنعطف تظهر بشكل صحيح | ⬜ | |
|
|
|
|
|
| المناورات (يمين/يسار/دوار/وصول) تعرض الأيقونات الصحيحة | ⬜ | |
|
|
|
|
|
| تحديثات ETA والمسافة تعمل | ⬜ | |
|
|
|
|
|
| الكاميرا تتبع الموقع على الخريطة (MapLibre) | ⬜ | |
|
|
|
|
|
| إعادة التوجيه التلقائي ينعكس على شاشة السيارة | ⬜ | |
|
|
|
|
|
| إيقاف التنقل ينظف الجلسة | ⬜ | |
|
|
|
|
|
| خدمة المقدمة تستمر في الخلفية | ⬜ | |
|
|
|
|
|
| TalkBack / إمكانية الوصول تعمل | ⬜ | |
|
|
|
|
|
|
|
|
|
|
### Apple CarPlay
|
|
|
|
|
| الاختبار | الحالة | ملاحظات |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| تشغيل على محاكي CarPlay في Xcode | ⬜ | iOS Simulator → I/O → External Displays → CarPlay |
|
|
|
|
|
| اتصال Lightning/USB-C بسيارة حقيقية | ⬜ | |
|
|
|
|
|
| بدء التنقل → يظهر CPMapTemplate | ⬜ | |
|
|
|
|
|
| المناورات مع ألوان (أخضر/أزرق) | ⬜ | |
|
|
|
|
|
| تقديرات الوصول (ETA) تُحدث | ⬜ | |
|
|
|
|
|
| واجهة التحريك (panning) تظهر عند تحديث الموقع | ⬜ | |
|
|
|
|
|
| الأوامر الصوتية / Siri تعمل | ⬜ | |
|
|
|
|
|
| إلغاء التنقل → `session.cancel()` | ⬜ | |
|
|
|
|
|
| التشغيل في الخلفية مع موقع دائم | ⬜ | |
|
|
|
|
|
| VoiceOver / إمكانية الوصول تعمل | ⬜ | |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## العناصر المتبقية للإنتاج (Production Readiness)
|
|
|
|
|
|
|
|
|
|
### Android Auto
|
|
|
|
|
1. ✅ كود التطبيق مكتمل
|
|
|
|
|
2. 📋 **Play Console**: إعلان فئة "Navigation" في قسم Android Auto
|
|
|
|
|
3. 📋 **Play Console**: رفع لقطات شاشة Android Auto (مطلوبة للنشر)
|
|
|
|
|
4. 📋 **التوقيع**: بناء موقع بمفتاح الإصدار (`key.properties`)
|
|
|
|
|
5. ⚠️ **اختبار**: تحقق على DHU ووحدة رأس حقيقية
|
|
|
|
|
6. ⚠️ **إمكانية الوصول**: تحقق TalkBack مع NavigationTemplate
|
|
|
|
|
|
|
|
|
|
### Apple CarPlay
|
|
|
|
|
1. ✅ كود التطبيق مكتمل
|
|
|
|
|
2. 📋 **Apple Developer Portal**: أضف قدرة `CarPlay (Driving Task)` للمعرف
|
|
|
|
|
3. 📋 **Apple Developer Portal**: أعد إنشاء ملفات التوفير
|
|
|
|
|
4. 📋 **Xcode**: فعّل قدرة CarPlay في Signing & Capabilities
|
|
|
|
|
5. 📋 **App Store Connect**: ارفع لقطات شاشة CarPlay (6.7" و 5.5")
|
|
|
|
|
6. 📋 **App Store Connect**: أيقونة CarPlay (اختياري للتنقل)
|
|
|
|
|
7. ⚠️ **اختبار**: محاكي CarPlay + سيارة حقيقية
|
|
|
|
|
8. ⚠️ **مراجعة HIG**: https://developer.apple.com/carplay/
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## ملاحظات للمطورين (Developer Notes)
|
|
|
|
|
|
|
|
|
|
### لنقل الكود لتطبيق الراكب (Rider App) لاحقاً:
|
|
|
|
|
1. **Android Auto**: انسخ ملفات `MyCarAppService.kt`، `MyCarSession.kt`، `MyCarScreen.kt`، `MapPresentation.kt`، `CarNavigationData.kt`، وعدل `package` إلى `com.siro.siro_rider`
|
|
|
|
|
2. **iOS CarPlay**: انسخ `CarPlaySceneDelegate.swift`، عدّل `AppDelegate.swift` لإضافة جسر `car_navigation`، حدث `Info.plist` و `Runner.entitlements`
|
|
|
|
|
3. **Flutter**: `CarPlatformBridge.dart` مشترك، فقط تأكد من تهيئته في `main.dart` للراكب وربطه بـ `NavigationController` الخاص بالراكب
|
|
|
|
|
4. **الأذونات**: نفس أذونات الموقع والخلفية مطلوبة
|
|
|
|
|
|
|
|
|
|
### مشاكل معروفة / تحسينات مستقبلية:
|
|
|
|
|
- **CarPlay**: `updatingArrival(to:)` مهمل في iOS 15+، فكر في الهجرة لـ `updating(_:)` على `arrivalEstimates` للمناورة
|
|
|
|
|
- **Android Auto**: `HostValidator` في الإنتاج يجب أن يستخدم `hosts_allowlist_google` وليس `hosts_allowlist_sample`
|
|
|
|
|
- **MapLibre على CarPlay**: تأكد من أن `asset://flutter_assets/assets/style.json` متاح في bundle التطبيق على iOS أيضاً (قد يحتاج نسخ للأصول)
|
|
|
|
|
- **TTS على CarPlay/Android Auto**: حالياً TTS يعمل على الهاتف؛ للتحكم الصوتي عبر مكبرات السيارة، قد تحتاج `CPVoiceControlTemplate` أو تكامل `TTS` مع `CarAppService`
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
*تم إنشاء هذا التقرير بتاريخ: 2026-07-04*
|
|
|
|
|
*استناداً إلى: `docs/auto_carplay_checklist.md` (النسخة الإنجليزية) ومراجعة الكود الكامل لتطبيق `siro_driver`*
|
Hamza-Ayed