عن المشروع

React Native Google Mobile Ads هي مكتبة من Invertase تتيح لتطبيقات React Native وExpo تحقيق الدخل عبر Google AdMob أو Google Ad Manager. تغلف المكتبة SDK الإعلانات الأصلية من Google لنظامي iOS وAndroid بدلاً من إعادة تنفيذ عرض الإعلانات في JavaScript. الخصائص الرئيسية الموضحة في ملف README: - التثبيت الأول عبر Expo باستخدام `npx expo install`، مع إعداد عبر مكوّن إضافي مدمج؛ كما يتم دعم مشاريع React Native CLI العارية. - تشمل تنسيقات الإعلانات: إعلانات فتح التطبيق، البانر (التكيفي المثبت، التكيفي المضمن، القابل للطي، والأحجام الثابتة القديمة)، الإعلانات الأصلية، الإعلانات البينية، الإعلانات المكافأة، والإعلانات البينية المكافأة، بالإضافة إلى Google Ad Manager، ومعالجة الموافقة عبر منصة رسائل المستخدم (UMP)، والوساطة. - تتضمن خيارات واجهة برمجة التطبيقات للمطورين فئات إعلانية حتمية، وخطافات React، ومجموعات تحميل مسبق للتطبيقات التي تعرض العديد من الإعلانات. - مكتوبة بلغة TypeScript مع مرجع API مُولّد، ومختبرة وحدويًا ومن طرف إلى طرف على كلتا المنصتين. متطلبات المنصة: يتطلب الإصدار 17 من المكتبة React Native 0.86.0 أو أحدث مع تفعيل البنية الجديدة؛ ولم يعد يتم دعم البنية القديمة. تحتاج مشاريع Expo إلى بناء تطويري لأن Expo Go غير مدعوم. الحد الأدنى لأنظمة التشغيل هو iOS 15.1 ومستوى واجهة برمجة تطبيقات Android 24. على Android، يمكن للمدمجين اختيار SDK الإعلانات الكلاسيكي من Google (الافتراضي) أو SDK الجيل التالي GMA في وقت البناء، مع نفس واجهة برمجة التطبيقات JavaScript في كلتا الحالتين. يتضمن ملف README جدول حالة التنفيذ الأصلي الذي يوضح الأسطح التي تم نقلها إلى وحدات Turbo أو مكونات Fabric على كل منصة. على iOS، تم وضع علامة اكتمال على طرق SDK، والبانرات، والإعلانات بملء الشاشة، والإعلانات الأصلية، ومنصة رسائل المستخدم، بينما لا يزال EventEmitter قيد التنفيذ. على Android، الإعلانات الأصلية مكتملة، والبانرات جزئية (تم نقل البانر متعدد التنسيقات، والبانر القياسي قيد التنفيذ)، وطرق SDK، والإعلانات بملء الشاشة، ومنصة رسائل المستخدم، وEventEmitter لا تزال قيد التنفيذ؛ لا تزال هذه الأسطح تعمل عبر طبقة التشغيل البيني في React Native دون تغيير واجهة برمجة التطبيقات JavaScript. تغطي روابط التوثيق البدء، والتثبيت لـ Expo وReact Native CLI، وتنسيقات الإعلانات بما في ذلك الخطافات وAd Manager، والموافقة والخصوصية، والاختبار، والأسباب الشائعة لعدم ظهور الإعلانات، والاستخدام مع React Native Firebase، والترقية إلى الإصدار 17، ومرجع API. تتضمن الحزمة أيضًا دليل مدمج لوكلاء الذكاء الاصطناعي في ملف AGENTS.md، المثبت في node_modules، والمقصود استشارته قبل أن يكتب الوكيل كود إعلانات. يقبل المشروع المشكلات وطلبات السحب وينشر إرشادات المساهمة ومدونة قواعد السلوك. شروط الترخيص موجودة في ملف LICENSE بالمستودع.