الإنشاء والاختبار

يوضح هذا المستند عملية التطوير والاختبار الأساسية للتطبيقات التي تم إنشاؤها حديثًا على Meta للمطوّرين. كما يصف الأدوات والإعدادات المتوفرة في لوحة معلومات التطبيق التي قد تساعدك أثناء التطوير.

العملية العامة

ستختلف عملية التطوير باختلاف احتياجات تطبيقك، ولكن المسار الأساسي يبدأ بقراءة الوثائق المرتبطة بكل حالة من حالات الاستخدام. يمكن الاطلاع على معلومات عن حالات الاستخدام هذه على developers.facebook.com/products.

بمجرد تحديد أي مجموعات من الوثائق الملائمة وقراءتها، فإن الخطوة التالية تتمثل في إجراء تغييرات على قاعدة الرموز في تطبيقك وتكوين أي إعدادات للوحة معلومات التطبيق والتي قد تكون مطلوبة بواسطة حالات الاستخدام ومجموعات SDK واستدعاءات API التي تنفذها. إذا كان سيساعدك أشخاص آخرون في تطوير تطبيقك واختباره، فيمكنك تعيين أدوار في التطبيق لهم بحيث يتمكنوا من تكوين إعدادات التطبيق والمساعدة في اختبار عمليات دمج Graph API.

في النهاية، للتحقق من تنفيذ كل شيء بشكل صحيح، يمكنك اختبار تطبيقك باستخدام حساب المطوّر على Meta أو من خلال الحسابات الاختبارية التي تحاكي مستخدمي تقنيات Meta الحقيقيين.

كنقطة انطلاق، تستخدم معظم تطبيقات فيسبوك Graph API لإدخال البيانات إلى فيسبوك والحصول عليها منه. تتطلب نقاط نهاية Graph API وجود أذونات. نظرًا إلى أن تصدير البيانات داخل Graph API واستيرادها منها هو إجراء شائع، فإننا نوفر مجموعات SDK لتسهيل عملية استدعاء نقاط نهاية Graph API. لذلك، يبدأ العديد من المطوّرين بهذه المجموعات الأربع من الوثائق.

حالات استخدام التطبيق

عند إنشاء التطبيق لأول مرة، يجب اختيار حالة استخدام رئيسية ثم حالات استخدام ثانوية، إذا لزم الأمر، لإضافة الوظائف إلى التطبيق. تتكون حالات الاستخدام من أذونات وميزات تتم إضافتها تلقائيًا إلى تطبيق Meta. ستتطلب أغلبية حالات الاستخدام هذه عملية مراجعة التطبيقات.

على سبيل المثال، عند تحديد تسجيل دخول فيسبوك كحالة الاستخدام الأساسية في تطبيقك خلال عملية الإنشاء، ستتمكن حينها من إضافة حالات استخدام ثانوية مع الأذونات والميزات المرتبطة بحالات الاستخدام تلك. ترتبط كل حالة استخدام بمجموعة خاصة من الأذونات والميزات وواجهات API التي يمكنك الاختيار من بينها. عند إضافة حالة استخدام ثانوية، ستنتقل إلى صفحة التكوين في لوحة معلومات التطبيق حيث يمكنك تكوين الأذونات والميزات وواجهات API المرتبطة بحالة الاستخدام تلك.

أنواع التطبيقات

إذا كنت تنشئ تطبيقًا لا يستخدم حالة استخدام مدرجة في لوحة معلومات التطبيق، فستحدد غير ذلك حيث ستختار حينها نوع التطبيق الذي تقوم بإنشائه.

تحدد أنواع التطبيقات المنتجات التي يمكن إضافتها إلى تطبيق ما في لوحة معلومات التطبيق، بالإضافة إلى الأذونات والميزات التي يمكن طلب الموافقة عليها خلال عملية مراجعة التطبيقات.

أوضاع التطبيق

سيكون تطبيقك إما في وضع التطوير أو وضع النشر. تنطبق أوضاع التطبيقات على التطبيقات غير التجارية وتحدد الأذونات والميزات التي يمكن لتطبيقك استخدامها، ومن يمكنه استخدام تطبيقك.

يمكن للتطبيقات في وضع التطوير طلب الحصول على أي أذونات، ولكن فقط من مستخدمي التطبيق الذين يتوفر لديهم دور في التطبيق ذاته. بالإضافة إلى ذلك، تكون جميع الميزات نشطة، ولكن فقط لمستخدمي التطبيق الذين يتمتعون بدور في التطبيق.

يمك�� منح الأذونات للتطبيقات في وضع النشر من جانب أي شخص، ولكن فقط تلك الأذونات التي تمت الموافقة عليها خلال عملية مراجعة التطبيقات. وبالمثل، تكون الميزات نشطة لجميع مستخدمي التطبيق، ولكن الميزات التي تمت الموافقة عليها فقط خلال عملية مراجعة التطبيقات.

يتم تعيين جميع التطبيقات غير التجارية التي تم إنشاؤها حديثًا إلى وضع التطوير أولاً، ويجب تجنب تغييرها حتى تنتهي من جميع عمليات التطوير والاختبار.

لاحظ أن:

  • أنواع التطبيقات تؤثر أيضًا على نوعية الأذونات المتوفرة للتطبيق. على سبيل المثال، لا تتوفر الأذونات المرتبطة بالمستخدم لتطبيقات النشاط التجاري، ولا تتوفر الأذونات المرتبطة بالنشاط التجاري لتطبيقات المستهلك. كما لا تحتوي التطبيقات التي اختارت نوع تطبيق الأعمال على أوضاع تطبيق على الإطلاق، وتعتمد بدلاً من ذلك على مستويات الوصول والتي تعمل بشكل مشابه.
  • قد يتعين ربط التطبيقات، التي تطلب الوصول المتقدم للحصول على الأذونات، بنشاط تجاري تم التحقق منه.

الأدوار في التطبيق

قبل نشر تطبيقك، يمكن للأشخاص الذين تم منحهم دورًا محددًا في التطبيق، مثل المطوّر أو المختبر، الوصول إليه حتى يتمكنوا من المساعدة على عملية التطوير والاختبار.

الاختبار

تحتوي صفحة الاختبار على كل حالات الاستخدام للتطبيق والأذونات المرتبطة التي طلبت الوصول إليها. يمكنك أيضًا العثور على متطلبات الاختبار لعملية مراجعة التطبيقات.

يجب استخدام مستكشف Graph API أو إنشاء حسابات مستخدمين اختبارية لإجراء استدعاءات API الاختبارية المطلوبة قبل الإرسال لعملية مراجعة التطبيقات. لا تتطلب بعض الأذونات الخضوع للاختبار قبل عملية مراجعة التطبيقات، ولكن نوصي باختبار كل الأذونات لضمان عمل التطبيق كما هو مطلوب.

بمجرد اكتمال كل استدعاءات API الاختبارية، ستكون جاهزًا لعملية مراجعة التطبيقات.

ضع في اعتبارك أن:

  • يمكن أن تستغرق استدعاءات API الاختبارية ما يصل إلى 24 ساعة للظهور في صفحة الاختبار.
  • لا تكون استدعاءات API الاختبارية صالحة إلا لمدة 30 يومًا ويجب إكمالها خلال 30 يومًا قبل الإرسال إلى عملية مراجعة التطبيقات.

الحسابات الاختبارية

الحسابات الاختبارية عبارة عن حسابات اختبارية يمكنك تسجيل الدخول إليها لمحاكاة مستخدمي فيسبوك الحقيقيين عند اختبار تطبيقك. لا يمكن للحسابات الاختبارية التفاعل مع مستخدمي فيسبوك الحقيقيين، وتكون كل المحتويات أو التفاعلات التي تم إنشاؤها بواسطة الحسابات الاختبارية مرئية فقط للحسابات الاختبارية الأخرى وأي شخص لديه دور في تطبيقك.

الصفحات الاختبارية

الصفحات الاختبارية عبارة عن صفحات تم إنشاؤها بواسطة الحسابات الاختبارية والتي يمكنك استخدامها لمحاكاة صفحات فيسبوك الحقيقية عند اختبار تطبيقك. لا يمكن اكتشاف الصفحات الاختبارية بواسطة مستخدمي فيسبوك الحقيقيين ولا يمكن التفاعل معها إلا من خلال الحسابات الاختبارية الأخرى أو بواسطة أشخاص يتوفر لديهم دور في تطبيقك.

استدعاء حذف البيانات

في حالة ��نفيذ حالة استخدام أو في حالة تحديد نوع تطبيقك ليكون من نوع المستهلك أو الألعاب الفورية، فيجب تنفيذ استدعاء حذف البيانات قبل نشر التطبيق. سيتم استدعاء عنوان URL الخاص باستدعاء حذف البيانات لدى تطبيقك في أي وقت يطلب منك أحد مستخدمي التطبيق حذف بياناته.

الخطوات التالية

بمجرد الانتهاء من تطوير التطبيق والاستعداد لنشر تطبيقك، يمكنك بدء أي عمليات قد تكون مطلوبة لإصدار تطبيقك بنجاح.