توضّح هذه الصفحة كيفية استخدام Google AI Studio لإنشاء التطبيقات ونشرها بسرعة (أو "البرمجة الوصفية") التي تختبر أحدث إمكانات Gemini، مثل Nano Banana وLive API. يتيح Google AI Studio إنشاء تطبيقات ويب باستخدام أوقات تشغيل كاملة المكدس وتطبيقات Android أصلية باستخدام Kotlin وJetpack Compose، وكل ذلك من خلال طلبات باللغة الطبيعية.
البدء
ابدأ البرمجة الوصفية في وضع "الإنشاء" في Google AI Studio. يمكنك البدء في الإنشاء بعدة طرق:
- البدء بطلب: في وضع "الإنشاء"، استخدِم مربّع الإدخال لإدخال وصف لما تريد إنشاؤه. اختَر "شرائح الذكاء الاصطناعي" لإضافة ميزات معيّنة، مثل إنشاء الصور أو بيانات "خرائط Google"، إلى طلبك. يمكنك حتى قول ما تريده باستخدام زر تحويل الكلام إلى نص.
- زر "ضربة حظ": إذا كنت بحاجة إلى إطلاق العنان لإبداعك، استخدِم زر "ضربة حظ"، وسينشئ Gemini طلبًا يتضمّن فكرة مشروع لمساعدتك في البدء.
- إعادة مزج مشروع من المعرض: افتح مشروعًا من معرض التطبيقات وانقر على نسخ التطبيق.
بعد تشغيل الطلب، ستظهر لك التعليمات البرمجية والملفات اللازمة التي يتم إنشاؤها، مع معاينة مباشرة لتطبيقك على الجانب الأيسر.
ما الذي يتم إنشاؤه؟
عند تشغيل طلبك، ينشئ AI Studio تطبيقًا كاملاً. يمكنك اختيار إنشاء تطبيق ويب أو تطبيق Android أصلي باستخدام أداة اختيار النظام الأساسي.
بالنسبة إلى تطبيقات الويب (الإعداد التلقائي)، ينشئ AI Studio بيئة كاملة المكدس تتضمّن ما يلي:
- من جهة العميل: واجهة أمامية للويب (React هي الإعداد التلقائي)
- من جهة الخادم: وقت تشغيل Node.js يتيح إجراء طلبات آمنة لواجهة برمجة التطبيقات، الاتصال بقواعد البيانات واستخدام حِزم npm.
بالنسبة إلى تطبيقات Android، ينشئ AI Studio مشروعًا باستخدام Kotlin وJetpack Compose يمكنك معاينته في محاكي مستند إلى المتصفّح وتثبيته على جهاز فعلي، ونشره على متجر Play للاختبار. مزيد من المعلومات عن إنشاء تطبيقات Android apps.
يمكنك الاطّلاع على الرمز الذي يتم إنشاؤه من خلال النقر على علامة التبويب الرمز في لوحة المعاينة على الجانب الأيسر. يدير برنامج Antigravity Agent بذكاء ملفات متعدّدة على مستوى المكدس، ما يضمن نشر التغييرات بشكل صحيح.
برنامج Antigravity Agent
Antigravity Agent هي وظيفة الذكاء الاصطناعي الرئيسية في Google Antigravity، وتعمل الآن المكوّنات الأساسية لأداة البرنامج على تشغيل تجربة وضع "الإنشاء" في Google AI Studio. يتجاوز هذا البرنامج مجرد إنشاء الرموز البرمجية البسيطة من خلال الحفاظ على سياق مشروعك بالكامل وإدارة ملفات متعدّدة وفهم التعليمات المعقّدة لإنشاء تطبيقات قوية وكاملة المكدس.
تشمل الإمكانات الرئيسية ما يلي:
- الوعي بالسياق: يحافظ على سياق الطلبات السابقة وحالات الملفات.
- إدارة ملفات متعدّدة: يعالج التبعيات في ملفات متعدّدة.
- التنفيذ الذي تم التحقّق منه: يتحقّق من تعديلات الرمز لتقليل الأخطاء.
إمكانات كاملة المكدس
يطلق Google AI Studio العنان لقوة النظام الإيكولوجي الحديث للويب، ما يتيح لك إنشاء أكثر من مجرد نماذج أولية من جهة العميل.
- وقت التشغيل من جهة الخادم وnpm: استخدِم المكتبة الواسعة لحِزم npm. سيحدّد البرنامج الحِزم ويثبّتها تلقائيًا حسب الحاجة لتطبيقك (مثل مكتبات معيّنة لتصوّر البيانات أو برامج واجهة برمجة التطبيقات من جهة العميل). يمكنك أيضًا طلب حِزم معيّنة إذا أردت ذلك.
- إدارة الأسرار: يمكنك تخزين مفاتيح واجهة برمجة التطبيقات والأسرار بشكل آمن في قائمة الإعدادات. يمكن الوصول إلى هذه العناصر في الرمز من جهة الخادم، ما يحافظ على أمانها من العرض من جهة العميل.
- وضع اللاعبين المتعدّدين: يمكنك إنشاء تجارب تعاونية في الوقت الفعلي مباشرةً في AI Studio. يدير وقت التشغيل من جهة الخادم الحالة والاتصالات المطلوبة لكي يتفاعل المستخدمون معًا.
- Firebase Firestore ومصادقة Firebase: يمكنك توفير Firebase وإعداده تلقائيًا، بما في ذلك قاعدة بيانات Firestore (تخزين البيانات المستمر) و مصادقة Firebase (عمليات تسجيل الدخول، وتحديدًا "تسجيل الدخول باستخدام حساب Google"). يتولّى البرنامج عملية الإعداد بالكامل ويكتب الرمز في تطبيقك لهذه الخدمات.
- عمليات الدمج مع Google Workspace: يمكنك ربط تطبيقك بواجهات برمجة تطبيقات Google Workspace ، مثل Gmail و"جداول بيانات Google" و"مستندات Google" وDrive و"تقويم Google" وغير ذلك. يتولّى AI Studio جميع عمليات إعداد OAuth تلقائيًا.
مزيد من المعلومات عن تطوير تطبيقات كاملة المكدس
تطبيقات Android
يمكنك أيضًا إنشاء تطبيقات Android أصلية باستخدام Kotlin وJetpack Compose. يمكنك معاينة تطبيقك في محاكي Android مستند إلى المتصفّح وتثبيته على جهاز فعلي باستخدام ADB في المتصفّح ونشره على متجر Play للاختبار الداخلي.
مزيد من المعلومات عن إنشاء تطبيقات Android
متابعة الإنشاء
بعد أن ينشئ Google AI Studio الرمز الأوّلي لتطبيقك، يمكنك مواصلة تحسينه:
الإنشاء في Google AI Studio
- التكرار باستخدام Gemini: استخدِم لوحة المحادثة في وضع "الإنشاء" لطلب إجراء تعديلات أو إضافة ميزات جديدة أو تغيير التصميم من Gemini.
- تعديل الرمز مباشرةً: افتح علامة التبويب "الرمز" في لوحة المعاينة لإجراء تعديلات مباشرة.
التطوير خارجيًا
بالنسبة إلى مهام العمل الأكثر تقدمًا، يمكنك تصدير الرمز والعمل في البيئة المفضّلة لديك:
- التنزيل والتطوير محليًا: يمكنك تصدير الرمز الذي تم إنشاؤه كـ ملف ZIP واستيراده إلى أداة تعديل الرموز.
- الإرسال إلى GitHub: يمكنك دمج الرمز مع عمليات التطوير والنشر الحالية من خلال إرساله إلى مستودع GitHub.
الميزات الرئيسية
يتضمّن Google AI Studio عدة ميزات لجعل عملية الإنشاء سهلة ومرئية:
- إنشاء تطبيقات كاملة المكدس وتكرارها: يمكنك إنشاء تطبيقات كاملة المكدس باستخدام طلب فقط وتكرارها من خلال المحادثة أو وضع التعليقات التوضيحية. يتيح لك وضع التعليقات التوضيحية تمييز أي جزء من واجهة مستخدم تطبيقك ووصف التغيير الذي تريده.
- مشاركة تطبيقك ونشره: يمكنك مشاركة إبداعاتك مع الآخرين للـ تعاون أو عرض عملك. عند المشاركة، يتم احتساب طلبات واجهة برمجة التطبيقات ضمن حدود الاستخدام. قد يتم فرض رسوم إذا كنت تستخدم نماذج مدفوعة. بعد ذلك، عندما يصبح تطبيقك جاهزًا، يمكنك نشره على Cloud Run.
- معرض التطبيقات: يوفّر "معرض التطبيقات" مكتبة مرئية لأفكار المشاريع. يمكنك تصفّح الإمكانات المتاحة باستخدام Gemini ومعاينة التطبيقات على الفور وإعادة مزجها لتخصيصها.
نشر تطبيقك أو أرشفته
بعد أن يصبح تطبيقك جاهزًا، يمكنك نشره:
Cloud Run: يمكنك نشر تطبيقك كخدمة قابلة للتوسّع. قد يتم فرض رسوم على Google Cloud Run استنادًا إلى الاستخدام. لمزيد من المعلومات عن النشر، يُرجى الاطّلاع على مقالة النشر من Google AI Studio.
GitHub: يمكنك تصدير مشروعك إلى مستودع GitHub.
القيود
يسرد هذا القسم القيود الحالية لوضع "الإنشاء" في Google AI Studio.
إدارة مفتاح واجهة برمجة التطبيقات
عند إنشاء تطبيق جديد يستخدم Gemini API، يضبط AI Studio تلقائيًا مفتاح Gemini API كسرّ في بيئة الخادم من جهة التطبيق. يمكنك الاطّلاع على هذا المفتاح وإدارته في لوحة الأسرار.
- الإعداد التلقائي: يتم إعداد
GEMINI_API_KEYلك، ولا يلزم إجراء أي إعداد يدوي لبدء الإنشاء. - من جهة الخادم فقط: يتم إدخال مفاتيح واجهة برمجة التطبيقات في وقت التشغيل من جهة الخادم و لا يتم تضمينها مطلقًا في الرمز من جهة العميل.
- التطبيقات الحالية: بالنسبة إلى التطبيقات التي تم إنشاؤها قبل 14 مايو 2026، سيُجري البرنامج تلقائيًا ترقية لعملية دمج Gemini API إلى الطريقة المقترَحة من جهة الخادم في المرة التالية التي تعدّل فيها ميزات Gemini في التطبيق.
النشر خارج Google AI Studio
- Cloud Run: عند النشر على Cloud Run من AI Studio، يتم تضمين مفتاح واجهة برمجة التطبيقات بشكل آمن في بيئة الخادم من جهة الخادم. سيستخدم التطبيق الذي تم نشره مفتاح واجهة برمجة التطبيقات لجميع طلبات Gemini API الخاصة بالمستخدمين.
- تنزيل ملف ZIP: إذا نزّلت تطبيقك كملف ZIP لتشغيله
في مكان آخر، عليك إعداد متغيّر البيئة
GEMINI_API_KEYفي بيئة الاستضافة. بما أنّ طلبات Gemini API الخاصة بتطبيقك يتم إجراؤها من الرمز من جهة الخادم، لا يتم عرض المفتاح للمستخدمين النهائيين.
حدث خطأ عند مشاركة التطبيقات
إذا شاركت تطبيقك وظهر للمستخدم النهائي خطأ 403 تم حظر الوصول عند استخدام عنوان URL الذي تمت مشاركته، قد يرجع ذلك إلى أحد الأسباب التالية:
- إضافات المتصفّح: قد تحظر إضافات الخصوصية، مثل Privacy Badger، التطبيق. عليك إيقاف الإضافة لتجنُّب الخطأ.
- مشاكل في الإنشاء: قد تكون هناك مشاكل في الرمز الحالي. اطلب من البرنامج "إصلاح أي مشاكل في الإنشاء في الرمز الحالي"، ثم أعد مشاركة عنوان URL.
الأسئلة الشائعة
ما هو وضع "الإنشاء" في AI Studio؟
وضع "الإنشاء" في AI Studio هو منصة مصمّمة لنقلك من طلب بسيط إلى تطبيق مستنِد إلى الذكاء الاصطناعي وجاهز للإنتاج باستخدام Gemini. يمكنك وصف ما تريد إنشاؤه باستخدام طلب، وسينشئ Gemini تطبيقًا لك. يمكنك أيضًا استكشاف المعرض للاطّلاع على الإمكانات المتاحة باستخدام Gemini API وإعادة مزج التطبيقات لتخصيصها.
كيف يتعامل وضع "الإنشاء" مع مفتاح Gemini API؟
عند إنشاء تطبيق يستخدم Gemini API، يضبط AI Studio تلقائيًا مفتاح Gemini API كسرّ من جهة الخادم. يتم إجراء طلبات Gemini API الخاصة بتطبيقك من الرمز من جهة الخادم باستخدام هذا المفتاح، لذا لا يتم عرضه مطلقًا في المتصفّح. يمكنك الاطّلاع على مفتاح واجهة برمجة التطبيقات في لوحة الأسرار في "الإعدادات".
هل يتم عرض مفتاح واجهة برمجة التطبيقات عند مشاركة التطبيقات؟
لا، يتم تخزين مفتاح واجهة برمجة التطبيقات كسرّ من جهة الخادم ولا يتم تضمينه مطلقًا في الرمز من جهة العميل. عند مشاركة تطبيقك، يمكن للمستخدمين الآخرين استخدامه، ولكن لا يمكنهم الاطّلاع على مفتاح واجهة برمجة التطبيقات.
عند مشاركة تطبيقاتك مع الآخرين، يتم احتساب طلبات واجهة برمجة التطبيقات ضمن حدود الاستخدام. قد يتم فرض رسوم إذا كنت تستخدم نماذج مدفوعة. سيُعلمك AI Studio أثناء الإعداد وقبل المشاركة إذا كان تطبيقك قد يتكبّد تكاليف.
مَن يمكنه الاطّلاع على تطبيقاتي؟
يكون تطبيقك خاصًا بشكل تلقائي. يمكنك مشاركة تطبيقك مع مستخدمين آخرين للسماح لهم باستخدامه. يمكن للمستخدمين الذين تشارك معهم تطبيقك الاطّلاع على الرمز الخاص به وإنشاء نسخة منه لأغراضهم الخاصة. إذا شاركت تطبيقك مع إذن التعديل، يمكن للمستخدمين الآخرين تعديل رمز تطبيقك.
هل يمكنني تشغيل التطبيقات خارج AI Studio؟
نعم. يمكنك نشر تطبيقك على
Cloud Run من AI Studio، ما
يمنح تطبيقك عنوان URL علنيًا مع إعداد مفتاح واجهة برمجة التطبيقات بشكل آمن في
بيئة الخادم من جهة الخادم. يمكنك أيضًا تنزيل تطبيقك كملف ZIP واستضافته في مكان آخر، ولكن عليك ضبط متغيّر البيئة GEMINI_API_KEY في بيئة الاستضافة. بما أنّ طلبات Gemini API يتم إجراؤها من الرمز من جهة الخادم، يظل مفتاحك آمنًا.
لمزيد من المعلومات عن خيارات النشر، يُرجى الاطّلاع على مقالة النشر من Google AI Studio.
هل يمكنني تطوير التطبيقات محليًا باستخدام أدواتي الخاصة ثم مشاركتها هنا؟
هذه الوظيفة غير متاحة بعد. نحن متحمّسون لإتاحة المزيد من حالات استخدام التطبيقات في المستقبل. يُرجى تقديم ملاحظاتك إذا كان لديك أي شيء محدّد في ذهنك.
كيف يمكنني استخدام قاعدة بيانات أو مساحة تخزين أخرى مع تطبيقاتي؟
تطبيقات AI Studio هي تطبيقات عادية يتم تشغيلها في حاوية Cloud Run. يمكنك استخدام أي حلّ تخزين يمكنك الاتصال به عبر شبكة، طالما لا يوجد جدار حماية يمنع الوصول من نطاق عنوان IP ديناميكي.
نحن نعمل على إضافة دعم مباشر لمساحة التخزين في المستقبل، وستتمكّن من إعدادها مباشرةً في AI Studio.
كيف يمكنني الوصول إلى الميكروفون وكاميرا الويب وواجهات برمجة تطبيقات Navigator الأخرى؟
لضمان علم المشاهدين باستخدام التطبيق لكاميرا الويب أو الأجهزة الأخرى
، نطلب إقرارًا إضافيًا قبل أن يتمكّن التطبيق من الوصول إلى
واجهات برمجة تطبيقات Navigator هذه.
يمكن لمُنشئي التطبيقات إضافة طلبات الأذونات هذه إلى ملف metadata.json الخاص بتطبيقهم. على سبيل المثال:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
القيم المسموح بها لـ requestFramePermissions هي مجموعة فرعية من الـ
ميزات العادية التي تتحكّم فيها السياسة.
كيف يمكنني استخدام GitHub مع تطبيقاتي؟
يتيح لك التكامل مع GitHub في AI Studio إنشاء مستودع لعملك وإجراء تغييراتك الأخيرة. لا نتيح حاليًا جلب التغييرات عن بُعد.
هل يمكنني منح مستخدمين آخرين إذن تعديل تطبيقي؟
هذه الميزة غير متاحة بعد، ولكن سيتم إتاحتها قريبًا.
لماذا تم وضع علامة على تطبيقي بسبب انتهاك السياسة؟
لدينا أنظمة تراجع التطبيقات تلقائيًا لضمان امتثالها لسياساتنا. إذا تبيّن لنا أنّ تطبيقًا يخالف سياساتنا، ستتم إزالته من AI Studio. يمكن أن تشمل انتهاكات السياسات، على سبيل المثال لا الحصر، ما يلي:
- التطبيقات التي تحتوي على برامج ضارة أو تصيّد احتيالي أو انتحال هوية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة صور الاعتداء الجنسي على الأطفال
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة التحرّش
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الكلام الذي يحضّ على الكراهية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الاتجار بالبشر
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الجنسي الفاضح
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى العنيف والدموي
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الضار أو الخطير
إذا تم وضع علامة على تطبيقك بسبب انتهاك السياسة، وكنت تعتقد أنّ ذلك حدث عن طريق الخطأ، يمكنك إرسال طلب بإعادة النظر. قد تؤدي الانتهاكات المتكرّرة لسياساتنا إلى إنهاء إمكانية وصولك إلى AI Studio.
ما هي مسؤولياتي بصفتي مطوّر تطبيقات؟
للتذكير، بصفتك مالك تطبيقك، أنت مسؤول عن سلوكه وجميع البيانات التي يعالجها. يشمل ذلك ما يلي:
- الامتثال للقوانين وحقوق الأطراف الثالثة: يجب التأكّد من امتثال تطبيقك لجميع القوانين واللوائح السارية وعدم انتهاك حقوق الآخرين، بما في ذلك حقوق الملكية الفكرية وحقوق الخصوصية.
- رصد المحتوى: قد تنطبق بنود إضافية على الخدمات الأخرى التي يستخدمها تطبيقك. على سبيل المثال، تتطلب بنود خدمة Google Cloud، السارية على Firestore، من العملاء الذين يستضيفون محتوًى تابعًا لجهة خارجية نشر سياسات تحدّد المحتوى المحظور (مثل المحتوى غير القانوني) ورصد هذا المحتوى غير القانوني.
- التنفيذ الآمن: يجب تنفيذ الضمانات وأدوات الإشراف اللازمة لمنع إساءة استخدام تطبيقك.
يُرجى العِلم بقيود الاستخدام في بنود الخدمة.
ما هي البنود السارية على التطبيقات في "معرض التطبيقات" في AI Studio؟
تنطبق بنود الخدمة الإضافية الخاصة بـ Gemini API على استخدام التطبيقات المعروضة في "معرض التطبيقات" في AI Studio، ما لم يُنص على خلاف ذلك.
الخطوات التالية
- تطوير تطبيقات كاملة المكدس (الويب)
- إنشاء تطبيقات Android
- الاطّلاع على أمثلة في معرض التطبيقات.