在 Google AI Studio 中建構 Android 應用程式

Google AI Studio 可讓您使用自然語言提示，建構原生 Android 應用程式。只要描述想要的應用程式，Antigravity 代理程式就會生成完整的 Kotlin 和 Jetpack Compose 專案。您可以在瀏覽器中，透過瀏覽器型 Android Emulator 預覽應用程式、將應用程式安裝到實體裝置，以及發布應用程式進行測試。

Android 應用程式也支援整合 Firebase，可透過 Firebase AI Logic 和 App Check 呼叫 Gemini 模型、將資料儲存在 Cloud Firestore，以及使用 Firebase 驗證登入使用者。

開始使用

如要開始建構 Android 應用程式，請按照下列步驟操作：

  1. 在 Google AI Studio 中，使用左側導覽面板前往「建構模式」。
  2. 在平台挑選器中選取「Android」Android。
  3. 輸入提示詞，描述要建構的應用程式 (例如「建立具有本機儲存空間的每日工作追蹤工具」或「建構食譜應用程式，使用 AI 根據食材建議餐點」)。
  4. 代理會生成專案，並在瀏覽器型 Android Emulator 中啟動。

接著，您可以使用對話面板反覆改良應用程式，就像在網頁上操作一樣。代理程式會管理 Android 專案中的所有檔案，並將變更套用至整個程式碼集。

Firebase 整合

Google AI Studio 與 Firebase 整合，因此 Android 應用程式可以安全地呼叫 Gemini 模型、保留資料，以及驗證使用者，不需自訂伺服器端後端。當您提示代理建構需要生成式 AI、資料庫或登入功能的功能時，代理會自動在 Firebase 專案中佈建及設定下列服務：

  • Firebase AI Logic 和 Firebase App Check：直接從 Android 應用程式呼叫 Gemini 模型，不必在 APK 中嵌入原始 API 金鑰。AI Studio 會自動設定 App Check，驗證要求是否來自應用程式的真實執行個體：
    • 測試和共用 (偵錯版本)：在瀏覽器模擬器中預覽、透過 USB 安裝，或與測試人員共用時，使用 AI Studio 自動管理的 App Check 偵錯權杖。
    • 發布至 Google Play (發布子版本)：為 Google Play 建構發布版本時，系統會使用預先設定的網站金鑰，自動切換至 reCAPTCHA Enterprise。
  • Cloud Firestore：在 NoSQL 雲端資料庫中儲存及同步資料，包括自動產生的 Firestore 安全性規則 (firestore.rules)。
  • Firebase 驗證：新增「使用 Google 帳戶登入」流程，驗證使用者。

您可以在要求這些功能時，透過對話中顯示的設定資訊卡啟用 Firebase，也可以隨時在「設定」>「整合」下方啟用。如要進一步瞭解專案設定、共用配額和 App Check 生命週期，請參閱「將 Firebase 新增至 Google AI Studio 應用程式」。

瀏覽器式 Android Emulator

Android Emulator 完全在雲端執行，並串流至瀏覽器。您不需要安裝 Android SDK、Android Studio 或本機模擬器。

模擬器提供：

  • Pixel 裝置模擬：輕觸、捲動及與應用程式互動，就像在實際裝置上操作一樣。
  • 旋轉支援：在直向和橫向之間切換。
  • 即時預覽：代理程式變更程式碼時，應用程式會重新建構，模擬器也會自動重新整理。

模擬器限制

瀏覽器模擬器不支援所有硬體功能。模擬器不支援下列功能：

  • 相機和拍照
  • NFC 和藍牙
  • GPS (模擬位置)
  • Google Play 服務 (Google 登入、地圖和其他 Play 服務功能可在實體裝置上運作，但無法在模擬器中運作)

使用 ADB 在裝置上安裝

您可以使用 USB 將 Android 實體裝置連接到電腦，直接在裝置上安裝建構的 APK。這項工具會使用 WebUSB，透過瀏覽器與裝置通訊。不必在本機安裝 ADB。

必要條件

  • 支援 WebUSB 的 Chrome 或 Edge 瀏覽器。
  • Android 裝置，且已啟用開發人員選項和 USB 偵錯。
  • 使用 USB 傳輸線將裝置連接到電腦。

在裝置上安裝應用程式

  1. 在預覽面板中，按一下「在裝置上安裝」。
  2. 從瀏覽器的 USB 裝置挑選器中選取 Android 裝置。
  3. APK 會轉移並安裝到裝置上。
  4. 應用程式會自動啟動。

發布至 Play 商店

您可以將 Android 應用程式發布至 Google Play 管理中心內部測試群組，最多可將應用程式發布給 100 位測試人員。

必要條件

發布應用程式

  1. 在 Google AI Studio 中，依序點選「設定」>「發布」。
  2. 按一下「發布到 Play 商店」。
  3. 使用 Google Play 開發人員帳戶進行驗證。
  4. AI Studio 會簽署 APK、建立應用程式資訊 (或上傳新版本)，並發布至內部測試群組。
  5. 您會收到要與測試人員分享的連結。

AI Studio 會使用代管 KeyStore 自動管理 APK 簽署作業。您稍後可以在 Play 管理中心自訂應用程式資訊 (圖示、螢幕截圖、說明)。

生成內容

建構 Android 應用程式時，代理會產生以 Gradle 為基礎的標準專案，結構如下：

  • 建構設定：使用 Kotlin DSL 的 build.gradle.kts 檔案 (專案和應用程式層級)。
  • UI 層：Jetpack Compose 元件，採用 Material 3 主題。
  • 架構：採用 ViewModel 和資料類別的單一活動架構。
  • 資源：AndroidManifest.xml、可繪項目、字串和其他 Android 資源。
  • Firebase 設定 (啟用 Firebase 時)：google-services.json、firebase_applet_config.xml 和 firestore.rules。

代理程式會自動管理 Gradle 依附元件，並視需要從 Maven 和 Google 存放區新增套件。

您可以使用預覽面板中的「Code」(程式碼) 分頁標籤，查看及編輯生成的程式碼。如要在 Android Studio 中繼續開發，請將專案下載為 ZIP 檔案。

限制

在 AI Studio 建構 Android 應用程式時，有下列限制：

平台限制

  • 僅限用戶端：Android 應用程式不含伺服器端元件。需要伺服器執行階段的功能 (Secret Manager、多人遊戲、Google Workspace API) 無法使用。
  • 單一活動架構：僅支援單一活動、單一模組專案。
  • 僅限 Jetpack Compose：應用程式使用 Kotlin 和 Jetpack Compose。不支援 Java 和 XML 版面配置。
  • 不支援 NDK 或原生程式碼：不支援 C 和 C++ 程式碼。
  • 不支援 Wear OS 或 Android TV：僅支援手機和平板電腦板型規格。

匯出限制

  • 僅限下載 ZIP 檔案：您可以將專案下載為 ZIP 檔案。Android 專案目前不支援 GitHub 匯出功能。

後續步驟