ساختن برنامه‌های Android در Google AI Studio

‫Google AI Studio به شما امکان می‌دهد از پیام‌واره زبان طبیعی، برنامه‌های Android بومی بسازید. برنامه موردنظرتان را توصیف کنید و عامل Antigravity یک پروژه کامل Kotlin و Jetpack Compose تولید می‌کند. از مرورگرتان می‌توانید پیش‌نمایش برنامه‌تان را در شبیه‌ساز Android مبتنی بر مرورگر ببینید، آن را در دستگاه فیزیکی نصب کنید، و آن را برای آزمایش منتشر کنید.

برنامه‌های Android همچنین از ادغام Firebase برای فراخوانی مدل‌های Gemini با Firebase AI Logic و «بررسی برنامه»، ذخیره کردن داده‌ها در Cloud Firestore، و وارد شدن کاربران به سیستم با «اصالت‌سنجی Firebase» پشتیبانی می‌کنند.

شروع کنید

برای شروع ساختن برنامه Android:

  1. بااستفاده از پانل پیمایش سمت راست، به حالت ساختن در Google AI Studio بروید.
  2. Android را از انتخاب‌گر پلاتفرم انتخاب کنید.
  3. پیام‌واره‌ای وارد کنید که برنامه‌ای را که می‌خواهید بسازید توصیف کند (برای مثال، «یک ردیاب تکلیف روزانه با فضای ذخیره‌سازی محلی ایجاد کن» یا «یک برنامه دستور پخت بساز که از هوش مصنوعی برای پیشنهاد غذا براساس مواد اولیه استفاده می‌کند»).
  4. عامل پروژه را تولید می‌کند و آن را در شبیه‌ساز Android مبتنی بر مرورگر راه‌اندازی می‌کند.

سپس می‌توانید بااستفاده از پانل گپ، درست مثل تجربه وب، برنامه‌تان را تکرار کنید. این عامل همه فایل‌های پروژه Android شما را مدیریت می‌کند و تغییرات را در سراسر پایگاه کد منتشر می‌کند.

یکپارچه‌سازی Firebase

Google AI Studio با Firebase ادغام می‌شود تا برنامه Android شما بتواند مدل‌های Gemini را به‌طور ایمن فراخوانی کند، داده‌ها را حفظ کند، و کاربران را بدون نیاز به پسوند سفارشی سمت سرور اصالت‌سنجی کند. وقتی از نماینده می‌خواهید ویژگی‌هایی بسازد که به هوش مصنوعی زایا، پایگاه داده، یا ورود به سیستم نیاز دارند، می‌تواند به‌طور خودکار سرویس‌های زیر را در پروژه Firebase شما تأمین و پیکربندی کند:

  • Firebase AI Logic و بررسی برنامه Firebase: مدل‌های Gemini را مستقیماً از برنامه Android خود بدون جاسازی کلیدهای API خام در APK فراخوانی کنید. AI Studio به‌طور خودکار «بررسی برنامه» را پیکربندی می‌کند تا تأیید کند درخواست‌ها از نمونه معتبری از برنامه شما منشأ می‌گیرند:
    • آزمایش و هم‌رسانی (ساخت‌های اشکال‌زدایی): از یک کد اشکال‌زدایی App Check استفاده می‌کند که به‌طور خودکار توسط AI Studio هنگام پیش‌نمایش در شبیه‌ساز مبتنی بر مرورگر، نصب ازطریق USB، یا هم‌رسانی با آزمایش‌کنندگان مدیریت می‌شود.
    • انتشار در Google Play (ساخت‌های نسخه پخش): هنگام ساختن نسخه پخش برای Google Play، به‌طور خودکار بااستفاده از کلید سایت ازپیش پیکربندی‌شده به reCAPTCHA Enterprise تغییر می‌کند.
  • Cloud Firestore: ذخیره و همگام‌سازی داده‌ها در پایگاه داده ابری NoSQL، ازجمله «قوانین امنیتی Firestore» که به‌طور خودکار تولید شده است (firestore.rules).
  • اصالت‌سنجی Firebase: برای اصالت‌سنجی کاربران، جریان‌های «ورود به سیستم با Google» را اضافه کنید.

می‌توانید Firebase را از کارت راه‌اندازی که هنگام درخواست این ویژگی‌ها در گپ ظاهر می‌شود، یا هر زمان دیگری در تنظیمات > ادغام‌ها فعال کنید. برای جزئیات مربوط به راه‌اندازی پروژه، سهمیه‌های مشترک، و چرخه حیات «بررسی برنامه»، به افزودن Firebase به برنامه Google AI Studio مراجعه کنید.

شبیه‌ساز Android مبتنی بر مرورگر

شبیه‌ساز Android کاملاً در فضای ابری اجرا می‌شود و در مرورگر شما جاری‌سازی می‌شود. نیازی به نصب کیت توسعه نرم‌افزار Android،‏ Android Studio، یا شبیه‌ساز محلی ندارید.

شبیه‌ساز موارد زیر را ارائه می‌دهد:

  • شبیه‌سازی دستگاهی شبیه Pixel: درست مثل یک دستگاه واقعی، روی برنامه‌تان تک‌ضرب بزنید، پیمایش کنید، و با آن تعامل داشته باشید.
  • پشتیبانی از چرخش: بین جهت عمودی و افقی جابه‌جا شوید.
  • پیش‌نمایش زنده: وقتی عامل تغییراتی در کد ایجاد می‌کند، برنامه بازسازی می‌شود و شبیه‌ساز به‌طور خودکار بازآوری می‌شود.

محدودیت‌های شبیه‌ساز

شبیه‌ساز مبتنی بر مرورگر از همه ویژگی‌های سخت‌افزاری پشتیبانی نمی‌کند. موارد زیر در شبیه‌ساز دردسترس نیست:

  • ضبط عکس و دوربین
  • NFC و بلوتوث
  • GPS (مکان شبیه‌سازی شده است)
  • خدمات Google Play («ورود به سیستم Google»،‏ Maps، و دیگر ویژگی‌های خدمات Play در دستگاه واقعی کار می‌کنند اما در شبیه‌ساز کار نمی‌کنند)

نصب در دستگاه با ADB

می‌توانید APK ساخته‌شده را مستقیماً در دستگاه Android فیزیکی متصل به رایانه‌تان بااستفاده از USB نصب کنید. این ابزار از WebUSB برای برقراری ارتباط با دستگاهتان ازطریق مرورگر استفاده می‌کند. نیازی به نصب محلی ADB نیست.

پیش‌نیازها

برنامه را در دستگاهتان نصب کنید

  1. روی نصب در دستگاه در پانل پیش‌نمایش کلیک کنید.
  2. دستگاه Android خود را از انتخاب‌گر دستگاه USB مرورگر انتخاب کنید.
  3. APK منتقل و در دستگاهتان نصب می‌شود.
  4. برنامه به‌طور خودکار راه‌اندازی می‌شود.

انتشار در «فروشگاه Play»

می‌توانید برنامه Android خود را در دسته هدف آزمایشی داخلی کنسول Google Play منتشر کنید که به شما امکان می‌دهد برنامه را برای حداکثر ۱۰۰ آزمایش‌کننده توزیع کنید.

پیش‌نیازها

  • حساب توسعه‌دهنده Google Play (مستلزم پرداخت کارمزد ثبت‌نام یک‌باره ۲۵ دلاری است).
  • نمایه توسعه‌دهنده تکمیل‌شده در «کنسول Play».

انتشار برنامه

  1. تنظیمات > انتشار را در Google AI Studio باز کنید.
  2. روی انتشار در «فروشگاه Play» کلیک کنید.
  3. با حساب توسعه‌دهنده Google Play خود اصالت‌سنجی کنید.
  4. ‫AI Studio فایل APK را امضا می‌کند، فهرستگان برنامه را ایجاد می‌کند (یا نسخه جدیدی را بارگذاری می‌کند)، و آن را در دسته هدف آزمایشی داخلی منتشر می‌کند.
  5. پیوندی دریافت می‌کنید که می‌توانید با آزمایش‌کنندگان هم‌رسانی کنید.

AI Studio امضای APK را به‌طور خودکار بااستفاده از keystore مدیریت‌شده مدیریت می‌کند. می‌توانید فهرستگان برنامه (نماد، نماگرفت‌ها، شرح) را بعداً در «کنسول Play» سفارشی‌سازی کنید.

آنچه تولید می‌شود

وقتی برنامه Android می‌سازید، عامل یک پروژه استاندارد مبتنی بر Gradle با ساختار زیر تولید می‌کند:

  • پیکربندی ساخت: فایل‌های build.gradle.kts (سطح پروژه و برنامه) بااستفاده از Kotlin DSL.
  • لایه میانای کاربر: مؤلفه‌های Jetpack Compose با موضوع‌بندی Material 3.
  • معماری: معماری تک‌فعالیتی با ViewModels و کلاس‌های داده.
  • منابع: AndroidManifest.xml، منابع قابل‌رسم، رشته‌ها، و دیگر منابع Android.
  • پیکربندی Firebase (وقتی Firebase فعال باشد): google-services.json، firebase_applet_config.xml، و firestore.rules.

این عامل به‌طور خودکار وابستگی‌های Gradle را مدیریت می‌کند و درصورت نیاز، بسته‌هایی را از مخازن Maven و Google اضافه می‌کند.

می‌توانید کد تولیدشده را بااستفاده از برگه کد در پانل پیش‌نمایش مشاهده و ویرایش کنید. برای ادامه توسعه در «استودیو Android»، پروژه را به‌صورت فایل ZIP بارگیری کنید.

محدودیت‌ها

ساختن برنامه Android در AI Studio محدودیت‌های زیر را دارد:

محدودیت‌های پلاتفرم

  • فقط سمت کارخواه: برنامه‌های Android مؤلفه سمت سرور ندارند. ویژگی‌هایی که به زمان اجرای سرور نیاز دارند (مدیریت اسرار، چندبازیکنه، میاناهای برنامه‌سازی کاربردی Google Workspace) دردسترس نیستند.
  • معماری تک‌فعالیتی: فقط پروژه‌های تک‌فعالیتی و تک‌ماژولی پشتیبانی می‌شوند.
  • فقط Jetpack Compose: برنامه‌ها از Kotlin و Jetpack Compose استفاده می‌کنند. از Java و چیدمان‌های XML پشتیبانی نمی‌شود.
  • بدون NDK یا کد بومی: کد C و C++‎ پشتیبانی نمی‌شود.
  • بدون Wear OS یا Android TV: فقط از ابعاد تلفن و رایانه لوحی پشتیبانی می‌شود.

محدودیت‌های صادر کردن

  • فقط بارگیری ZIP: می‌توانید پروژه را به‌عنوان فایل ZIP بارگیری کنید. صادر کردن GitHub هنوز برای پروژه‌های Android دردسترس نیست.

قدم بعدی چیست