ابدأ بالنظام الذي سيتصل به التطبيق
يحتاج التقدير الموثوق إلى أكثر من اسم المنصة. نحتاج إلى فهم واجهتها الموثّقة وبيئة الاختبار المتاحة ومتطلبات الوصول والعمليات التي سينفذها التطبيق.
يختلف الربط بـAPI مدعوم عن محاولة الاتصال بنظام لا يوفّر واجهة مناسبة. ينبغي كشف نقص التوثيق أو صلاحيات الحساب أو وظائف الخادم قبل بدء التطوير.
نعمل عبر وصول مصرّح به وطرق تكامل مدعومة. لا يلغي التطبيق المخصّص شروط ترخيص الجهة الأخرى أو استخدامها أو وصولها.
أعمال تكامل يمكن تحديد نطاقها
الحسابات والطلبات الموثّقة
تنفيذ مسار تسجيل الدخول والتفويض المناسب للنظام. نحدّد ما يحدث عند انتهاء الجلسة أو إلغاء الصلاحية أو محاولة مستخدم تنفيذ عملية غير مسموح بها.
بيانات الأعمال والمزامنة
ربط التطبيق بسجلات العملاء أو المهام أو المخزون أو البيانات المتفق عليها. نحدّد النظام الذي يملك كل سجل وطريقة التعامل مع التحديثات المتعارضة أو الناقصة.
حِزم SDK التابعة لجهات أخرى
دمج مكتبة موثّقة من مورّد، وتقييم إعداداتها ومتطلبات توافقها، وتحديد السلوك الذي تضيفه إلى التطبيق. وجود SDK لا يغني عن مراجعة أذوناته وطريقة معالجته للبيانات.
الإشعارات والرفع والعمليات التي تغيّر البيانات
نحدّد مسار المستخدم كاملًا: البداية والتقدّم والتأكيد والتعافي. يختلف رفع ملف عن استعلام للقراءة فقط، ولا ينبغي إعادة إرسال طلب يغيّر البيانات دون التحقق من نتيجته.
تكاملات أصلية لتطبيقات Flutter
إذا احتاج مشروع Flutter إلى SDK خاص بأندرويد، نراجع التنفيذ الأصلي وواجهته مع طبقة Dart. راجع تطوير Flutter للمشروع المشترك بين المنصات.
اجعل حالات الفشل مفهومة
يوضّح التكامل الجيد للمستخدم ما حدث وما يمكنه فعله بعد ذلك، بدل عرض شاشة فارغة عند كل إخفاق.
| الحالة | السلوك الذي ينبغي تحديده |
|---|---|
| الشبكة غير متاحة. | أوضح الإجراءات المتعذّرة وهل يمكن حفظ بعض العمل محليًا. |
| انتهت جلسة المستخدم. | استعد الوصول عبر مسار المصادقة المدعوم دون فقدان مدخلات لا داعي لفقدها. |
| رفضت الخدمة الطلب. | اعرض رسالة مناسبة واحتفظ بسياق تشخيصي يكفي لفحص المشكلة. |
| انتهت مهلة طلب قد يكون غيّر البيانات. | تحقّق من النتيجة بأمان قبل إرسال عملية قد تتكرر. |
| غيّر المورّد استجابته أو SDK. | حدّد افتراضات التوافق والصيانة التي قد تلزم. |
تدخل هذه القرارات في مواصفات التكامل. ويتوقف تنفيذها الدقيق على API والخادم، لا على تطبيق أندرويد وحده.
وضّح بيانات الاعتماد والمسؤوليات
التطبيق على الهاتف ليس مكانًا مناسبًا لإخفاء بيانات اعتماد مسؤول الخادم. قد تتطلب العمليات ذات الامتيازات مكوّنًا خلفيًا بصلاحيات مضبوطة.
نحدّد الإعدادات التي تعيش في التطبيق، والعمليات التي تنتمي إلى الخادم، ومن يدير الحسابات ذات الصلة. أرسل في الطلب الأول روابط التوثيق ووصف المسار المطلوب، لا رموز الإنتاج أو كلمات المرور.
تُعدّ تغييرات الخادم ولوحات الإدارة ورسوم الخدمات المستمرة بنود نطاق منفصلة ما لم ينص العرض على شمولها.
ما الذي يتضمنه تسليم مفيد؟
قد تشمل المخرجات تعديلات التنفيذ، وتعليمات الإعداد، وخرائط الحقول، والافتراضات الموثّقة، وفحوص حالات النجاح والفشل الأساسية.
عندما يوفّر المورّد بيئة اختبار، نستخدمها للتحقق المناسب. نوثّق البيئة والإصدار المدعوم بدل الزعم بأن اختبارًا واحدًا يغطي كل تغييرات المزوّد المحتملة.
إذا أردت تطبيقًا كاملًا حول التكامل، فراجع تطوير أندرويد المخصّص. وللربط بمعدّات فعلية، راجع تكامل أجهزة أندرويد.
أسئلة شائعة
هل يمكن ربط تطبيق أندرويد بنظام إدارة العملاء أو موقعنا الحالي؟
ربما. أرسل اسم المنصة وسير العمل المطلوب وأي توثيق عام لـAPI. نتحقق من توفر العمليات والصلاحيات اللازمة.
هل تحتاجون أيضًا إلى الوصول إلى الخادم؟
يتوقف ذلك على التكامل. قد يستخدم مشروع API قائمًا، فيما يحتاج آخر إلى تغييرات في الخادم أو بيانات اعتماد أو إعدادات يديرها فريقك الخلفي.
هل تعملون مع SDK خاص بمورّد؟
نعم، بشرط توافر الوصول والترخيص المناسبين. نحتاج إلى توثيقه والبيئات المدعومة وطريقة اختبار لا تكشف معلومات سرية علنًا.
هل يمكن للتكامل العمل دون اتصال؟
يمكن تصميم بعض البيانات والإجراءات لذلك. يجب تحديد ما يمكن تخزينه مؤقتًا أو وضعه في قائمة انتظار، وكيف تُسوّى التغييرات.
هل يمكن إصلاح تكامل قائم؟
نعم. صف العملية الفاشلة ووقت حدوثها. قد تكون مراجعة تصحيح أخطاء التطبيق نقطة البداية الأنسب.
أخبرنا بما يحتاج إلى الربط
اذكر التطبيق والخدمة أو SDK والإجراء الذي يجب أن ينجزه المستخدم. أرفق رابط التوثيق إن توفر.