من Google AI Studio إلى APK: تطبيق AI Studio الخاص بك على Android

يكتب وضع Build في AI Studio تطبيق React وTypeScript مبنيًا بـ Vite. بعض الصادرات تتضمن أيضًا خادمًا صغيرًا، والأقدم منها يحمّل الحزم من CDN عبر import map.

طريقتان لبنائه

خطوة بخطوة

1. نزّل التطبيق من AI Studio

   افتح التطبيق في وضع Build في AI Studio واستخدم زر التنزيل لحفظ المشروع كملف ZIP. اترك الملف كما هو: لا تفك ضغطه ثم تعيد ضغطه.

2. اختره في AppMint

   في تطبيق AppMint، اضغط على بطاقة Google AI Studio في الشاشة الرئيسية واختر ملف ZIP. تفحص شاشة الاختيار المشروع قبل إنشاء أي شيء وتعرض ما وجدته.

3. أصلح كل ما يحجبه

   تمنع الفحوصات أي إنشاء لن يعمل كتطبيق، وتذكر السبب: مشروع ليس React، أو بدون package.json، أو حزم تُحمَّل من esm.sh عبر import map، أو استخدام process.env في كود المتصفح، أو سكربت Tailwind CDN. أصلحه في AI Studio، ونزّل من جديد واختر ملف ZIP الجديد.

4. املأ خطوة Env إن ظهرت

   إذا كان الكود يقرأ قيم import.meta.env.VITE_…، فإن خطوة Env إضافية تعرض كل اسم مع خانة لقيمته. تُحفظ القيم على هاتفك لذلك المشروع، فلا يسأل إعادة الإنشاء مرة أخرى.

5. إنشاء

   يشغّل AppMint عملية الإنشاء ويجمع النتيجة. إذا فشل الإنشاء، ترى خطأ المترجم نفسه مع الملف والسطر، لتصلحه في AI Studio.

ما الذي يعمل داخل التطبيق

• الكاميرا والميكروفون والموقع: يقرأ AppMint المشروع (الكود وrequestFramePermissions في metadata.json) ويحدد أذونات Android التي يحتاجها التطبيق، فلا يُشحن تطبيق كاميرا بكاميرا معطلة.
• إضافات Capacitor التي يستوردها كودك، من المجموعة المدمجة في كل تطبيق AppMint (الكاميرا والمشاركة والاهتزاز ونظام الملفات والتفضيلات والمزيد).
• يغلق زر الرجوع مربع الحوار المفتوح قبل أن يغادر الشاشة، كما يتوقع مستخدمو Android.
• الإنشاء مجاني، بدون علامة مائية.

ما يجب التحقق منه أولًا

مفتاح API في كود المتصفح

تطبيق AI Studio الذي يقرأ مفتاحه بـ process.env في المتصفح لن يُنشأ كتطبيق، ويمكن لأي شخص يثبّته نسخ المفتاح الموجود في كود الواجهة الأمامية. انقل الاستدعاء خلف خادمك الخاص وانشره، ثم غلّف ذلك العنوان.

التطبيقات ذات الخادم

إذا تضمن الصادر خادمًا، فلا يمكن للهاتف تشغيله. انشره، ثم أدخل العنوان المنشور في الخطوة 1؛ يوجّه AppMint طلبات fetch وXHR وEventSource وWebSocket الخاصة بالتطبيق إليه.

هاتف حقيقي لإنشاء المشاريع المصدرية

تعمل أدوات الإنشاء على الهاتف على هواتف ARM64، وهي تقريبًا كل هواتف Android المباعة في السنوات الأخيرة. يمكن لمحاكي x86 فتح المعالج لكن لا يمكنه إنشاء مشروع مصدري.

نشر تطبيق Google AI Studio الخاص بك على Google Play

يقبل Google Play ملف AAB (Android App Bundle) وليس APK. تمنحك الأداة ملف AAB مجانًا مع كل إنشاء، موقّعًا بمفتاح يبقى نفسه لاسم الحزمة نفسه، لذا احتفظ باسم الحزمة نفسه لكل تحديث وارفع رقم الإصدار في كل مرة. قبل التقديم، راجع قائمة تحقق متجر Play: سياسة الخصوصية، ولقطات الشاشة، ونموذج سلامة البيانات، وللحساب الشخصي الجديد للمطور، الاختبار المغلق مع المختبرين.

إذا أبلغ Play أن مفتاح التوقيع غير مطابق، فاقرأ إصلاح خطأ مفتاح الرفع.

أسئلة

هل يغيّر AppMint كود AI Studio الخاص بي؟

لا. يبني هذا المسار ملف ZIP تمامًا كما صُدِّر: بدون معالجة بالذكاء الاصطناعي، وبدون إصلاح تلقائي، وبدون استهلاك أرصدة. إذا كان هناك خطأ، يخبرك به وتصلحه في AI Studio.

هل يمكنني فعل ذلك على الموقع بدل التطبيق؟

يحوّل منشئ المواقع عنوان URL إلى APK. إذا كان تطبيق AI Studio الخاص بك منشورًا وعامًا، يمكنك تغليف عنوانه هناك. للإنشاء من ملف ZIP، استخدم تطبيق AppMint لنظام Android.

لماذا حُظر ملف ZIP الخاص بي لاستخدامه import map؟

تحمّل صادرات AI Studio الأقدم React وحزمًا أخرى من esm.sh أثناء التشغيل بدل تضمينها. يتطلب ذلك اتصالًا بالشبكة عند كل تشغيل ولا يمكن فحصه وقت الإنشاء. تتضمن الصادرات الأحدث ملف package.json؛ نزّل التطبيق مرة أخرى من AI Studio.

هل يمكنني نشره على Google Play؟

نعم. يُنشئ AppMint ملف AAB الذي يطلبه Play. اقرأ قائمة التحقق الخاصة بـ Play Store قبل أن ترسل تطبيقك.

أدوات بناء أخرى

آخر تحقق 2026-09-25.