在 Google AI Studio 中建構應用程式

本頁面說明如何使用 Google AI Studio 快速建構 (或「直覺式程式開發」) 及部署應用程式,測試 Gemini 的最新功能,例如 Nano Banana 和 Live API。Google AI Studio 支援使用全端執行階段建構網頁應用程式,以及使用 Kotlin 和 Jetpack Compose 建構原生 Android 應用程式,全都透過自然語言提示完成。

開始使用

在 Google AI Studio 的建構模式,體驗直覺式程式開發。您可以透過下列幾種方式開始建構:

  • 從提示詞開始:在建構模式中,使用輸入框輸入要建構的內容說明。選取 AI 晶片,在提示中加入特定功能,例如圖像生成或 Google 地圖資料。你甚至可以使用語音轉文字按鈕,說出想輸入的內容。
  • 「好手氣」按鈕:如果需要創意靈感,請使用「好手氣」按鈕,Gemini 會生成提示,提供專案構想,協助你開始著手。
  • 改造範例庫中的專案:從應用程式範例庫開啟專案,然後選取「Copy App」。
  • 從 GitHub 匯入專案:在建構模式中,從提示輸入框的「Add files」(新增檔案) (+ 圖示) 選單中選取「Import from GitHub」(從 GitHub 匯入),即可匯入現有程式碼。

執行提示詞後,系統會生成必要的程式碼和檔案,並在右側顯示應用程式的即時預覽畫面。

建立的內容

執行提示詞時,AI Studio 會建立完整的應用程式。您可以使用平台挑選器,選擇建構網頁應用程式或原生 Android 應用程式。

如果是網頁應用程式 (預設),AI Studio 會建立全端環境,包括:

  • 用戶端:網頁前端 (預設為 React)。
  • 伺服器端:Node.js 執行階段,可安全地呼叫 API、連線資料庫及使用 npm 套件。

如果是 Android 應用程式,AI Studio 會生成 Kotlin 和 Jetpack Compose 專案,您可以在瀏覽器模擬器中預覽、安裝到實體裝置,以及發布到 Play 商店進行測試。進一步瞭解如何建構 Android 應用程式。

在右側預覽窗格中選取「Code」分頁標籤,即可查看產生的程式碼。Antigravity 代理程式會智慧管理堆疊中的多個檔案,確保變更正確套用。

Antigravity 代理程式

Antigravity 代理程式是 Google Antigravity 的主要 AI 函式,現在代理駕馭系統的核心元件,也支援 Google AI Studio 的建構模式體驗。這項工具不只能生成程式碼,還能維護整個專案的脈絡、管理多個檔案,以及理解複雜的指令,建構出穩健的全端應用程式。

主要功能包括:

  • 脈絡感知:保留先前提示和檔案狀態的脈絡。
  • 多檔案管理:處理多個檔案之間的依附元件。
  • 驗證執行:驗證程式碼更新,減少幻覺。

全端功能

Google AI Studio 充分發揮現代網路生態系統的威力,不只能建構用戶端原型。

  • 伺服器端執行階段和 npm:使用龐大的 npm 套件程式庫。代理會自動識別並安裝應用程式所需的套件,例如資料視覺化或 API 用戶端專用的特定程式庫。您也可以視需要要求特定套件。
  • 密鑰管理:在「Settings」(設定) 選單中,安全地儲存 API 金鑰和密鑰。這些金鑰可在伺服器端程式碼中存取,不會在用戶端外洩。
  • 多人協作:直接在 AI Studio 中打造即時協作體驗。伺服器端執行階段會管理使用者互動所需的狀態和連線。
  • Firebase Firestore 和驗證:自動佈建及設定 Firebase,包括 Firestore 資料庫 (永久資料儲存庫) 和 Firebase 驗證 (登入流程,特別是「使用 Google 帳戶登入」)。代理會管理整個設定程序,甚至編寫程式碼,將應用程式連至這些服務。
  • Google Workspace 整合:將應用程式連結至 Gmail、試算表、文件、雲端硬碟、日曆等 Google Workspace API。AI Studio 會自動處理所有 OAuth 設定。

進一步瞭解如何開發全端應用程式

Android 應用程式

您也可以使用 Kotlin 和 Jetpack Compose 建構原生 Android 應用程式。在瀏覽器型 Android Emulator 中預覽應用程式、在瀏覽器中使用 ADB 將應用程式安裝到實體裝置,以及發布至 Play 商店進行內部測試。

AI Studio 也與 Android 應用程式的 Firebase 整合,可自動佈建 Firebase AI Logic 和 Firebase App Check (用於安全的用戶端 Gemini API 呼叫,不會公開原始 API 金鑰),以及 Cloud Firestore 和 Firebase 驗證。

進一步瞭解如何建構 Android 應用程式

繼續建構

Google AI Studio 生成應用程式的初始程式碼後,您可以繼續調整:

在 Google AI Studio 中建構內容

  • 使用 Gemini 反覆調整:在建構模式中使用對話面板,問問 Gemini 進行修改、新增功能或變更樣式。
  • 直接編輯程式碼:在預覽面板中開啟「Code」分頁,即可即時編輯。

在外部開發

如要執行更進階的工作流程,可以同步或匯出程式碼,在偏好的環境中作業:

  • 與 GitHub 同步:將應用程式連結至 GitHub 存放區,啟用雙向同步功能。您可以直接將 AI Studio 提示的變更推送至存放區,並附上 AI 生成的修訂訊息,也可以將 IDE 中本機所做的變更,或團隊成員所做的變更,提取回 AI Studio。您隨時可以前往「設定」的「GitHub」GitHub分頁,管理同步狀態。
  • 下載並在本機開發:將生成的程式碼匯出為 ZIP 檔案,然後匯入程式碼編輯器。

主要功能與特色

Google AI Studio 包含多項功能,可讓建構過程直覺且視覺化:

  • 建立及反覆改良全端應用程式:只要輸入提示詞,就能建立全端應用程式,並透過對話或註解模式反覆改良。註解模式可讓您醒目顯示應用程式 UI 的任何部分,並說明所需變更。
  • 分享及部署應用程式:您可以與他人分享作品,以便協作或展示成果。共用時,API 呼叫會計入用量限制。如果使用付費模型,可能需要支付費用。應用程式準備就緒後,即可部署至 Cloud Run。
  • 應用程式庫:應用程式庫提供專案構想的視覺化程式庫。您可以瀏覽 Gemini 的功能、立即預覽應用程式,並加以改造,打造專屬應用程式。

部署或封存應用程式

應用程式準備就緒後,即可部署:

  • Cloud Run:將應用程式部署為可擴充的服務。系統可能會依據用量,收取 Google Cloud Run 費用。如要進一步瞭解部署作業,請參閱「從 Google AI Studio 部署」。

  • GitHub:將專案與新的或現有的 GitHub 存放區同步,以便管理原始碼或與團隊成員協作。

限制

本節列出 Google AI Studio 建構模式目前的限制。

API 金鑰管理

建立使用 Gemini API 的新網頁應用程式時,AI Studio 會自動將 Gemini API 金鑰設為應用程式伺服器端環境中的密鑰。您可以在「Secrets」面板中查看及管理這組金鑰。

  • 自動設定:系統會為您設定 GEMINI_API_KEY,您無須手動設定,即可開始建構。
  • 僅限伺服器端:API 金鑰會插入伺服器端執行階段,絕不會包含在用戶端程式碼中。
  • 現有應用程式:如果是 2026 年 5 月 14 日前建構的應用程式,下次修改應用程式的 Gemini 功能時,代理會自動將 Gemini API 整合升級為建議的伺服器端方法。

Android 應用程式

建構 Android 應用程式時,AI Studio 會使用 Firebase AI Logic 和 Firebase App Check,而非原始 API 金鑰,因此憑證不會嵌入 APK。

在 Google AI Studio 以外部署

  • Cloud Run:從 AI Studio 部署至 Cloud Run 時,API 金鑰會安全地包含在伺服器端環境中。部署的應用程式會使用您的 API 金鑰,處理所有使用者的 Gemini API 呼叫。
  • ZIP 下載:如果您將應用程式下載為 ZIP 檔案,以便在其他位置執行,則必須在託管環境中設定 GEMINI_API_KEY 環境變數。由於應用程式的 Gemini API 呼叫是透過伺服器端程式碼發出,因此金鑰不會向使用者公開。

分享應用程式時發生錯誤

如果您分享應用程式,而使用者透過分享的網址存取時,遇到「403 Access Restricted」(403 存取受限) 錯誤,可能是下列原因造成:

  • 瀏覽器擴充功能:Privacy Badger 等隱私權擴充功能可能會封鎖應用程式。請停用擴充功能,避免發生錯誤。
  • 建構問題:目前的程式碼可能有問題。提示代理「修正目前程式碼的所有建構問題」,然後重新分享網址。

常見問題

什麼是「在 AI Studio 建構」?

AI Studio Build 平台可讓您從簡單的提示詞開始,使用 Gemini 建構可部署於正式環境的 AI 輔助應用程式。只要透過提示詞描述想建構的內容,Gemini 就會為您生成應用程式。您也可以瀏覽我們的資源庫,瞭解 Gemini API 的功能,並重新混編應用程式,打造專屬版本。

Build 如何處理我的 Gemini API 金鑰?

建立使用 Gemini API 的網頁應用程式時,AI Studio 會自動將 Gemini API 金鑰設為伺服器端密鑰。應用程式的 Gemini API 呼叫是透過伺服器端程式碼使用這組金鑰,因此不會在瀏覽器中公開。您可以在「設定」的「Secrets」面板中查看 API 金鑰。如果是 Android 應用程式,AI Studio 會使用 Firebase AI Logic 和 Firebase App Check,安全地進行用戶端呼叫,不必在應用程式二進位檔中嵌入 API 金鑰。

分享應用程式時,API 金鑰會外洩嗎?

不會。API 金鑰會儲存為伺服器端密鑰,絕不會包含在用戶端程式碼中。分享應用程式後,其他使用者可以運用,但無法查看您的 API 金鑰。

與他人共用應用程式時,API 呼叫會計入用量限制。如果使用付費模型,可能需要支付費用。如果應用程式可能產生費用,AI Studio 會在設定期間和分享前提醒您。

誰能看到我的應用程式?

應用程式預設為私人。您可以與其他使用者分享應用程式,讓他們使用。您分享應用程式的使用者可以查看程式碼,並依據自身需求建立分支版本。如果您與他人共用應用程式並授予編輯權限,對方就能編輯應用程式的程式碼。

我可以在 AI Studio 以外的地方執行應用程式嗎?

可以。您可以從 AI Studio 將應用程式部署至 Cloud Run,這樣應用程式就會取得公開網址,並在伺服器端環境中安全設定 API 金鑰。您也可以將應用程式下載為 ZIP 檔案,並託管在其他位置,但必須在託管環境中設定 GEMINI_API_KEY 環境變數。Gemini API 呼叫是透過伺服器端程式碼發出,因此金鑰會保持安全。

如要進一步瞭解部署選項,請參閱「從 Google AI Studio 部署」。

我可以使用自己的工具在本機開發應用程式,然後在這裡分享嗎?

可以。您可以將 AI Studio 應用程式連結至 GitHub 存放區,在本機使用偏好的程式碼編輯器或 CLI 工具進行開發,將變更推送至 GitHub,然後使用「設定」中的「GitHub」GitHub分頁,直接將這些更新內容提取回 AI Studio。

如何搭配應用程式使用資料庫或其他儲存空間?

AI Studio 應用程式是在 Cloud Run 容器中執行的標準應用程式。只要沒有防火牆阻止動態 IP 範圍的存取,您就可以使用任何可透過網路連線的儲存解決方案。

我們正努力在未來新增直接支援儲存空間的功能,屆時您將能直接在 AI Studio 中設定。

為確保檢視者知道應用程式會使用網路攝影機或其他裝置,應用程式必須先取得額外確認,才能存取這些 Navigator API。應用程式建立者可以在應用程式的 metadata.json 檔案中新增這些權限要求。例如:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

requestFramePermissions 支援的值是標準政策控管功能的子集。

如何搭配應用程式使用 GitHub?

AI Studio 支援與 GitHub 雙向同步:

  • 匯入存放區:在建構模式中,從提示詞輸入框的「新增檔案」 (+ 圖示) 選單中選取「從 GitHub 匯入」,即可匯入現有程式碼。
  • 連結存放區:在「Settings」中開啟「GitHub」分頁,從應用程式建立新的 GitHub 存放區,或連結至現有存放區。
  • 雙向同步:將 AI Studio 提示的變更直接推送至存放區,並附上 AI 生成的修訂訊息,或將外部變更 (例如本機 IDE 編輯或團隊成員的提取要求) 提取回 AI Studio。
  • 解決合併衝突:與 GitHub 同步時,如果變更發生衝突,AI Studio 會提供「解決衝突」對話方塊,並顯示並排差異檢視器,方便您查看差異,並選擇要保留 AI Studio 或 GitHub 版本的衝突檔案。

我可以授予其他使用者應用程式編輯權限嗎?

AI Studio 不支援直接即時協作編輯。不過,您可以將應用程式連結至共用的 GitHub 存放區,與團隊成員協作。團隊成員可以在 GitHub 推送變更或開啟提取要求,您則可將這些更新提取至 AI Studio。

為什麼我的應用程式因違反政策而遭標記?

我們的系統會自動審查應用程式,確保符合政策規定。如果發現應用程式違反政策,就會從 AI Studio 移除。違反政策的行為包括但不限於:

  • 含有惡意軟體、網路釣魚或冒用他人身分的應用程式
  • 應用程式顯示或散布違反兒少性虐待圖像政策的內容
  • 應用程式顯示或散布違反騷擾政策的內容
  • 應用程式顯示或散布違反仇恨言論政策的內容
  • 應用程式顯示或散布違反人口販運政策的內容
  • 應用程式顯示或散布違反情色露骨內容政策的內容
  • 應用程式顯示或散布違反暴力血腥政策的內容
  • 應用程式顯示或發布違反有害或危險內容政策的內容

如果應用程式因違反政策而遭標記,但您認為這項處置有誤,可以提出申訴。如果屢次違規,可能會導致您無法繼續使用 AI Studio。

應用程式開發人員有哪些責任?

提醒您,身為應用程式擁有者,您必須對應用程式的行為和處理的所有資料負責。包括:

  • 法律遵循和第三方權利:確保應用程式遵守所有適用法律和法規,且未侵犯他人權利,包括智慧財產權和隱私權。
  • 內容監控:應用程式使用的其他服務可能須遵守附加條款。舉例來說,Firestore 適用《Google Cloud 服務條款》,其中規定託管第三方內容的客戶必須發布政策,定義禁止的內容 (例如非法內容),並監控是否有這類非法內容。
  • 安全導入:導入必要的防護措施和審核工具,防止應用程式遭到濫用。

請注意《服務條款》中的使用限制。

除非另有註明,否則使用 AI Studio 應用程式庫中的應用程式時,須遵守《Gemini API 附加服務條款》。

後續步驟