skill
أساسيات Firebase Remote Config
يدير قوالب Firebase Remote Config، وعلامات الميزات، واستراتيجيات التحميل، وحزم SDK (لنظامي Android و iOS). يستخدم عند تنزيل/نشر قوالب JSON ل Remote Config، وإدارة سجل الإصدارات/علامات الميزات، وتعيين الإعدادات الافتراضية داخل التطبيق، و fetchAndActivate()، والمستمعين في الوقت الفعلي، أو إعداد حزمة SDK. لا يستخدم ل Firebase Hosting، أو Auth، أو Firestore، أو Data Connect، أو Crashlytics، أو App Hosting.
نبذة
# التهيئة عن بعد (Remote Config)
توفر هذه المهارة دليلا كاملا للبدء باستخدام Remote Config على نظامي Android أو iOS. تتيح لك Remote Config تغيير سلوك ومظهر تطبيقك دون نشر تحديث للتطبيق، وذلك عن طريق الحفاظ على قالب تهيئة قائم على السحابة.
## المتطلبات المسبقة
يتطلب توفير Remote Config كلا من مشروع Firebase وتطبيق Firebase، سواء كان Android أو iOS. لإدارة قالب Remote Config والشروط عبر سطر الأوامر، استخدم Firebase CLI. راجع مهارة `firebase-basics` للحصول على مراجع حول تهيئة المشروع.
## استكشاف أخطاء التنفيذ وإصلاحها
### معالجة أخطاء npx 403 Forbidden
إذا فشل `npx -y firebase-tools@latest` بسبب أذونات السجل (خطأ 403):
1. **إبلاغ المستخدم**: "لا يمكنني جلب أحدث أدوات Firebase عبر npx بسبب خطأ في السجل." 2. **العودة إلى الخيار الاحتياطي**: حاول استخدام أمر `firebase` المحلي مباشرة إذا أكد المستخدم أنه مثبت عالميا (`npm install -g firebase-tools`).
### معالجة مشكلات سياق المشروع
إذا فشل أمر ما لأن "لا يوجد مشروع نشط محدد":
1. **التحقق من تسجيل الدخول**: قم بتشغيل `npx -y firebase-tools@latest login:list`. 2. **المطالبة بالمعرف**: إذا كنت مسجلا للدخول ولكن لا يوجد مشروع نشط، اطلب من المستخدم: "يرجى تقديم معرف مشروع Firebase الخاص بك للمتابعة." 3. **استخدام العلامة**: ألحق `--project <PROJECT_ID>` بكل أمر لاحق.
## إعداد SDK
لمعرفة كيفية إعداد Remote Config في كود تطبيقك، اختر نظامك الأساسي:
- **Android**: [android_setup.md](references/android_setup.md) - **iOS**: [ios_setup.md](references/ios_setup.md)
## أفضل الممارسات وإدارة القوالب
اتبع هذه الإرشادات واستخدم أدوات CLI المرتبطة لضمان استخدام فعال وآمن ل Remote Config.
### استراتيجيات الجلب
لتحسين أداء التطبيق وتجربة المستخدم، اتبع هذه الأنماط الموصى بها (انظر [استراتيجيات التحميل](https://firebase.google.com/docs/remote-config/loading)):
- **تحميل قيم جديدة للتشغيل التالي**: النمط الأكثر فعالية هو تفعيل القيم التي تم جلبها مسبقا فورا عند بدء التشغيل وجلب قيم جديدة في الخلفية لاستخدامها في المرة القادمة. هذا يقلل من وقت انتظار المستخدم. - **تحديثات في الوقت الفعلي**: استخدم مستمع الوقت الفعلي ل SDK لتحديث التطبيق فورا دون تحديث عند تغيير التهيئة من جانب الخادم.
### إدارة القوالب عبر CLI
استخدم الأوامر التالية لإدارة قالب Remote Config وسجل الإصدارات الخاص بك عبر الطرفية:
- **الحصول على القالب الحالي**: احفظ القالب البعيد في ملف JSON محلي للتدقيق أو التعديل.
```bash npx -y firebase-tools@latest remoteconfig:get -o remote_config.json ```
- **التحرير والاكتشاف المستقل**: قم بتعديل ملف `remote_config.json` المحلي مباشرة. حدد الإشارة الصحيحة (مثل device.country أو percent) وقم بتحديث مصفوفة "conditions" وخريطة "parameters" وفقا لذلك.
- **إلزامي: مراجعة المستخدم والتحقق**: توقف واطلب من المستخدم التحقق من تغييراتك قبل المتابعة إلى النشر.
- الإجراء: أبلغ المستخدم: "لقد أعددت التغييرات في remote_config.json. يرجى مراجعة الملف للتأكد من دقته. بمجرد أن تكون راضيا، أخبرني ب 'deploy' لجعل التغييرات مباشرة."
- **تنسيق النشر**: لدفع التغييرات، يجب عليك التأكد من تهيئة البيئة للنشر.
- تعيين التهيئة: إذا كان ملف firebase.json مفقودا، فقم بإنشاء واحد لتعيين JSON المحلي إلى خدمة Remote Config:
```json { "remoteconfig": { "template": "remote_config.json" } } ```
- النشر: نفذ أمر النشر الجزئي
```bash npx -y firebase-tools@latest deploy --only remoteconfig ```
- **التحقق**: بعد النشر، تحقق من التحديث عن طريق سرد سجل الإصدارات.
```bash npx -y firebase-tools@latest remoteconfig:versions:list ```
يوفر SDK عددا من الميزات لجعل تطبيقك ديناميكيا ومتجاوبا مع شرائح المستخدمين.
- **تعيين الإعدادات الافتراضية داخل التطبيق**: حدد قيما أساسية لضمان عمل التطبيق دون اتصال بالإنترنت أو قبل الجلب الأول. - **الجلب والتفعيل**: استرداد القيم من الواجهة الخلفية ل Firebase وتطبيقها على واجهة المستخدم/المنطق المحلي. - **إدارة القوالب**: استخدم Firebase CLI للتحكم في الإصدارات، وجلب، ونشر ملفات JSON الخاصة بالتهيئة.
التثبيت
شغل هذا الأمر
npx skills add firebase/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add firebase/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/firebase-remote-config-basics` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة أساسيات Firebase Remote Config؟
يدير قوالب Firebase Remote Config، وعلامات الميزات، واستراتيجيات التحميل، وحزم SDK (لنظامي Android و iOS). يستخدم عند تنزيل/نشر قوالب JSON ل Remote Config، وإدارة سجل الإصدارات/علامات الميزات، وتعيين الإعدادات الافتراضية داخل التطبيق، و fetchAndActivate()، والمستمعين في الوقت الفعلي، أو إعداد حزمة SDK. لا يستخدم ل Firebase Hosting، أو Auth، أو Firestore، أو Data Connect، أو Crashlytics، أو App Hosting.
كيف أثبت أساسيات Firebase Remote Config؟
شغل هذا الأمر في الطرفية:
npx skills add firebase/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل أساسيات Firebase Remote Config؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور أساسيات Firebase Remote Config؟
طورها firebase.
هل أساسيات Firebase Remote Config مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add heygen-com/hyperframes
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add google/agents-cli
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى