Google AI Studio'da uygulama geliştirme

Bu sayfada, Nano Banana ve Live API gibi en yeni Gemini özelliklerini test eden uygulamaları hızlıca oluşturmak (veya "sezgisel kodlama" yapmak) ve dağıtmak için Google AI Studio'nun nasıl kullanılacağı açıklanmaktadır. Google AI Studio, doğal dilde istemler kullanarak tam yığın çalışma zamanlarıyla web uygulamaları, Kotlin ve Jetpack Compose ile yerel Android uygulamaları oluşturmayı destekler.

Başlayın

Google AI Studio'nun Derleme modunda sezgisel kodlamaya başlayın. Uygulama oluşturmaya birkaç şekilde başlayabilirsiniz:

  • İstemle başlayın: Oluşturma modunda, giriş kutusunu kullanarak oluşturmak istediğiniz şeyin açıklamasını girin. İsteminize görüntü üretme veya Google Haritalar verileri gibi belirli özellikleri eklemek için yapay zeka çiplerini seçin. Hatta sesle yazma düğmesini kullanarak ne istediğinizi söyleyebilirsiniz.
  • "Kendimi Şanslı Hissediyorum" düğmesi: Yaratıcı bir fikre ihtiyacınız varsa "Kendimi Şanslı Hissediyorum" düğmesini kullanın. Gemini, başlamanıza yardımcı olacak bir proje fikri içeren bir istem oluşturur.
  • Galerideki bir projeyi remiksleme: Uygulama Galerisi'nden bir proje açın ve Uygulamayı kopyala'yı seçin.
  • GitHub'dan proje içe aktarma: Derleme modunda, mevcut kodunuzu içe aktarmak için istem giriş kutusundaki Dosya ekle (+ simgesi) menüsünden GitHub'dan içe aktar'ı seçin.

İstemi çalıştırdıktan sonra gerekli kod ve dosyaların oluşturulduğunu görürsünüz. Uygulamanızın canlı önizlemesi sağ tarafta gösterilir.

Ne oluşturulur?

İsteminizi çalıştırdığınızda AI Studio eksiksiz bir uygulama oluşturur. Platform seçiciyi kullanarak web uygulaması veya yerel Android uygulaması oluşturabilirsiniz.

AI Studio, web uygulamaları (varsayılan) için aşağıdakileri içeren tam yığın bir ortam oluşturur:

  • İstemci tarafı: Web ön ucu (varsayılan olarak React kullanılır).
  • Sunucu tarafı: Güvenli API çağrılarına, veritabanı bağlantılarına ve npm paketi kullanımına olanak tanıyan bir Node.js çalışma zamanı.

Android uygulamaları için AI Studio, tarayıcı tabanlı bir emülatörde önizleyebileceğiniz, fiziksel bir cihaza yükleyebileceğiniz ve test için Play Store'da yayınlayabileceğiniz bir Kotlin ve Jetpack Compose projesi oluşturur. Android uygulamaları geliştirme hakkında daha fazla bilgi edinin.

Sağdaki önizleme bölmesinde Kod sekmesini seçerek oluşturulan kodu görüntüleyebilirsiniz. Antigravity Agent, yığınınızdaki birden fazla dosyayı akıllıca yöneterek değişikliklerin doğru şekilde uygulanmasını sağlar.

Antigravity Agent

Antigravity Agent, Google Antigravity'deki ana yapay zeka işlevidir. Temsilci düzeneğinin temel bileşenleri artık Google AI Studio'daki Build modunu desteklemektedir. Yalnızca kod oluşturmakla kalmaz, projenizin tamamının bağlamını korur, birden fazla dosyayı yönetir ve karmaşık talimatları anlayarak sağlam, tam yığın uygulamalar oluşturur.

Temel özellikler:

  • Bağlam farkındalığı: Önceki istemlerin ve dosya durumlarının bağlamını korur.
  • Çoklu dosya yönetimi: Birden fazla dosya arasındaki bağımlılıkları yönetir.
  • Doğrulanmış yürütme: Halüsinasyonları azaltmak için kod güncellemelerini doğrular.

Full-stack özellikleri

Google AI Studio, modern web ekosisteminin gücünden yararlanarak istemci tarafı prototiplerden daha fazlasını oluşturmanıza olanak tanır.

  • Sunucu tarafı çalışma zamanı ve npm: Geniş npm paketleri kitaplığını kullanın. Temsilci, uygulamanız için gereken paketleri (ör. veri görselleştirme veya API istemcileri için belirli kitaplıklar) otomatik olarak tanımlayıp yükler. İsterseniz belirli paketleri de talep edebilirsiniz.
  • Gizli anahtar yönetimi: API anahtarlarını ve gizli anahtarları Ayarlar menüsünde güvenli bir şekilde saklayın. Bu değişkenlere sunucu tarafı kodunuzdan erişilebilir. Böylece değişkenler, istemci tarafında açığa çıkmaya karşı korunur.
  • Multiplayer: Doğrudan AI Studio'da gerçek zamanlı ortak çalışma deneyimleri oluşturun. Sunucu tarafı çalışma zamanı, kullanıcıların birlikte etkileşim kurması için gereken durumu ve bağlantıları yönetir.
  • Firebase Firestore ve Authentication: Firestore veritabanı (kalıcı veri depolama) ve Firebase Authentication (oturum açma akışları, özellikle "Google ile oturum açma") dahil olmak üzere Firebase'i otomatik olarak sağlayın ve ayarlayın. Temsilci, tüm kurulum sürecini yönetir ve hatta uygulamanızda bu hizmetler için kod yazar.
  • Google Workspace entegrasyonları: Uygulamanızı Gmail, E-Tablolar, Dokümanlar, Drive, Takvim ve daha fazlası gibi Google Workspace API'lerine bağlayın. AI Studio, tüm OAuth yapılandırmasını otomatik olarak yapar.

Full-stack uygulamalar geliştirme hakkında daha fazla bilgi

Android uygulamaları

Kotlin ve Jetpack Compose'u kullanarak yerel Android uygulamaları da oluşturabilirsiniz. Uygulamanızı tarayıcı tabanlı bir Android emülatöründe önizleyin, tarayıcıda ADB kullanarak fiziksel bir cihaza yükleyin ve dahili test için Play Store'da yayınlayın.

AI Studio, Android uygulamaları için Firebase ile de entegre olur. Bu sayede Firebase AI Logic ve Firebase App Check'i (ham API anahtarlarını göstermeden güvenli istemci tarafı Gemini API çağrıları için) otomatik olarak sağlar. Ayrıca Cloud Firestore ve Firebase Authentication'ı da otomatik olarak sağlar.

Android uygulamaları geliştirme hakkında daha fazla bilgi edinin.

Oluşturmaya devam etme

Google AI Studio, uygulamanız için ilk kodu oluşturduktan sonra kodu daha da iyileştirebilirsiniz:

Google AI Studio'da geliştirme

  • Gemini ile yineleme: Gemini'dan değişiklik yapmasını, yeni özellikler eklemesini veya stili değiştirmesini istemek için Derleme modunda sohbet panelini kullanın.
  • Kodu doğrudan düzenleme: Canlı düzenlemeler yapmak için önizleme panelinde Kod sekmesini açın.

Harici olarak geliştirme

Daha gelişmiş iş akışları için kodu tercih ettiğiniz ortamda çalışacak şekilde senkronize edebilir veya dışa aktarabilirsiniz:

  • GitHub ile senkronizasyon: İki yönlü senkronizasyonu etkinleştirmek için uygulamanızı bir GitHub deposuna bağlayın. AI Studio'da istenen değişiklikleri, yapay zeka tarafından oluşturulan commit mesajlarıyla doğrudan deponuza gönderebilir veya IDE'nizde ya da ekip arkadaşlarınız tarafından yerel olarak yapılan değişiklikleri AI Studio'ya geri çekebilirsiniz. Senkronizasyon durumunuzu istediğiniz zaman Ayarlar'daki GitHub sekmesinden yönetebilirsiniz.
  • İndirme ve yerel olarak geliştirme: Oluşturulan kodu ZIP dosyası olarak dışa aktarın ve kod düzenleyicinize aktarın.

Temel özellikler

Google AI Studio, geliştirme sürecini sezgisel ve görsel hale getiren çeşitli özellikler içerir:

  • Full-stack uygulamalar oluşturma ve üzerinde değişiklik yapma: Yalnızca bir istemle full-stack uygulamalar oluşturun ve sohbet veya not modu üzerinden değişiklik yapın. Not ekleme modu, uygulamanızın kullanıcı arayüzünün herhangi bir bölümünü vurgulamanıza ve istediğiniz değişikliği açıklamanıza olanak tanır.
  • Uygulamanızı paylaşma ve dağıtma: Çalışmalarınızı başkalarıyla paylaşarak ortak çalışabilir veya çalışmalarınızı sergileyebilirsiniz. Paylaşım sırasında API çağrıları, kullanım sınırlarınıza dahil edilir. Ücretli modelleri kullanırsanız maliyetler geçerli olabilir. Uygulamanız hazır olduğunda Cloud Run'a dağıtabilirsiniz.
  • Uygulama galerisi: Uygulama galerisi, proje fikirlerinin yer aldığı görsel bir kitaplık sunar. Gemini ile neler yapabileceğinizi inceleyebilir, uygulamaları anında önizleyebilir ve kendi ihtiyaçlarınıza göre düzenleyebilirsiniz.

Uygulamanızı dağıtma veya arşivleme

Uygulamanız hazır olduğunda dağıtabilirsiniz:

  • Cloud Run: Uygulamanızı ölçeklenebilir bir hizmet olarak dağıtın. Kullanıma bağlı olarak Google Cloud Run için ücret alınabilir. Dağıtım hakkında daha fazla bilgi edinmek için Google AI Studio'dan dağıtım yapma başlıklı makaleyi inceleyin.

  • GitHub: Kaynak kodunu yönetmek veya ekip arkadaşlarınızla ortak çalışmak için projenizi yeni ya da mevcut bir GitHub deposuyla senkronize edin.

Sınırlamalar

Bu bölümde, Google AI Studio'daki derleme modunun mevcut sınırlamaları listelenmiştir.

API anahtarı yönetimi

Gemini API'yi kullanan yeni bir web uygulaması oluşturduğunuzda AI Studio, Gemini API anahtarınızı uygulamanın sunucu tarafı ortamında otomatik olarak gizli anahtar olarak yapılandırır. Bu anahtarı Gizli anahtarlar panelinde görüntüleyip yönetebilirsiniz.

  • Otomatik kurulum: GEMINI_API_KEY sizin için ayarlanır. Derlemeye başlamak için manuel yapılandırma gerekmez.
  • Yalnızca sunucu tarafı: API anahtarları, sunucu tarafı çalışma zamanına eklenir ve hiçbir zaman istemci tarafı koduna dahil edilmez.
  • Mevcut uygulamalar: 14 Mayıs 2026'dan önce oluşturulan uygulamalarda, uygulamanın Gemini özelliklerini bir sonraki değiştirme işleminizde temsilci, Gemini API entegrasyonunuzu önerilen sunucu tarafı yaklaşımına otomatik olarak yükseltir.

Android uygulamaları

AI Studio, Android uygulamaları oluştururken ham API anahtarı yerine Firebase AI Logic ve Firebase App Check'i kullanır. Bu sayede kimlik bilgileri hiçbir zaman APK'nıza yerleştirilmez.

Google AI Studio dışında dağıtım

  • Cloud Run: AI Studio'dan Cloud Run'a dağıtım yaptığınızda API anahtarınız sunucu tarafı ortamına güvenli bir şekilde dahil edilir. Dağıtılan uygulama, tüm kullanıcıların Gemini API çağrıları için API anahtarınızı kullanır.
  • ZIP indirme: Uygulamanızı başka bir yerde çalıştırmak için ZIP dosyası olarak indirirseniz barındırma ortamınızda GEMINI_API_KEY ortam değişkenini ayarlamanız gerekir. Uygulamanızın Gemini API çağrıları sunucu tarafı kodundan yapıldığından anahtar, son kullanıcılara gösterilmez.

Uygulamalar paylaşılırken hata oluştu

Uygulamanızı paylaşırsanız ve son kullanıcınız paylaşılan URL'yi kullanırken 403 Erişim Kısıtlandı hatasıyla karşılaşırsa bunun nedeni aşağıdakilerden biri olabilir:

  • Tarayıcı uzantıları: Privacy Badger gibi gizlilik uzantıları uygulamayı engelliyor olabilir. Hatayı önlemek için uzantıyı devre dışı bırakın.
  • Derleme sorunları: Mevcut kodla ilgili sorunlar olabilir. Temsilciden "mevcut kodla ilgili derleme sorunlarını düzeltmesini" isteyin ve ardından URL'yi tekrar paylaşın.

SSS

AI Studio'da derleme nedir?

AI Studio Build, Gemini'ı kullanarak basit bir istemden üretime hazır, yapay zeka destekli bir uygulama oluşturmanıza yardımcı olan bir platformdur. Oluşturmak istediğiniz uygulamayı bir istemle açıklayın. Gemini sizin için bir uygulama oluşturur. Ayrıca Gemini API ile neler yapabileceğinizi görmek için galerimizi inceleyebilir ve uygulamaları remiksleyerek kendinize göre uyarlayabilirsiniz.

Build, Gemini API anahtarımı nasıl işler?

Gemini API'yi kullanan bir web uygulaması oluşturduğunuzda AI Studio, Gemini API anahtarınızı otomatik olarak sunucu tarafı gizli anahtarı olarak ayarlar. Uygulamanızın Gemini API çağrıları, bu anahtar kullanılarak sunucu tarafı kodundan yapıldığından tarayıcıda hiçbir zaman gösterilmez. API anahtarınızı Ayarlar'daki Gizli anahtarlar panelinde görüntüleyebilirsiniz. AI Studio, Android uygulamalarında API anahtarını uygulama ikili dosyasına yerleştirmeden güvenli istemci tarafı çağrıları yapmak için Firebase AI Logic ve Firebase App Check'i kullanır.

Uygulama paylaşırken API anahtarım görünür mü?

Hayır. API anahtarınız sunucu tarafı gizli anahtarı olarak depolanır ve hiçbir zaman istemci tarafı koduna dahil edilmez. Uygulamanızı paylaştığınızda diğer kullanıcılar uygulamanızı kullanabilir ancak API anahtarınızı göremez.

Uygulamalarınızı başkalarıyla paylaştığınızda API çağrıları kullanım sınırlarınıza dahil edilir. Ücretli modelleri kullanırsanız maliyetler geçerli olabilir. AI Studio, kurulum sırasında ve paylaşmadan önce uygulamanızın maliyet oluşturup oluşturmayacağı konusunda sizi uyarır.

Uygulamalarımı kimler görebilir?

Uygulamanız varsayılan olarak gizlidir. Uygulamanızı diğer kullanıcılarla paylaşarak kullanmalarına izin verebilirsiniz. Uygulamanızı paylaştığınız kullanıcılar, uygulamanızın kodunu görebilir ve kendi amaçları doğrultusunda çatallayabilir. Uygulamanızı düzenleme izniyle paylaşırsanız diğer kullanıcılar uygulamanızın kodunu düzenleyebilir.

Uygulamaları AI Studio dışında çalıştırabilir miyim?

Evet. Uygulamanızı AI Studio'dan Cloud Run'a dağıtabilirsiniz. Bu sayede uygulamanız, API anahtarınız sunucu tarafı ortamında güvenli bir şekilde yapılandırılmış olarak herkese açık bir URL alır. Uygulamanızı ZIP dosyası olarak indirip başka bir yerde de barındırabilirsiniz. Bu durumda, barındırma ortamınızda GEMINI_API_KEY ortam değişkenini ayarlamanız gerekir. Gemini API çağrıları sunucu tarafı kodundan yapıldığı için anahtarınız güvende kalır.

Dağıtım seçenekleri hakkında daha fazla bilgi edinmek için Google AI Studio'dan dağıtım yapma başlıklı makaleyi inceleyin.

Uygulamaları kendi araçlarımla yerel olarak geliştirip burada paylaşabilir miyim?

Evet. AI Studio uygulamanızı bir GitHub deposuna bağlayarak tercih ettiğiniz kod düzenleyiciyi veya CLI araçlarını kullanarak yerel olarak geliştirme yapabilir, değişikliklerinizi GitHub'a gönderebilir ve ardından Ayarlar'daki GitHub sekmesini kullanarak bu güncellemeleri doğrudan AI Studio'ya geri çekebilirsiniz.

Uygulamalarımda veritabanı veya başka bir depolama alanını nasıl kullanabilirim?

AI Studio uygulamaları, Cloud Run container'ında çalışan standart uygulamalardır. Dinamik IP aralığından erişimi engelleyen bir güvenlik duvarı olmadığı sürece ağ üzerinden bağlanabileceğiniz herhangi bir depolama çözümünü kullanabilirsiniz.

Gelecekte depolama alanı için doğrudan destek eklemek üzere çalışıyoruz. Bu desteği doğrudan AI Studio'da yapılandırabileceksiniz.

İzleyicilerin, bir uygulamanın web kameralarını veya diğer cihazlarını kullandığından haberdar olmalarını sağlamak için uygulamanın bu Navigator API'lerine erişebilmesinden önce ek bir onay alınmasını zorunlu kılıyoruz. Uygulama geliştiriciler, bu izin isteklerini uygulamalarının metadata.json dosyasına ekleyebilir. Örneğin:

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

requestFramePermissions için desteklenen değerler, standart politikayla kontrol edilen özelliklerin bir alt kümesidir.

GitHub'ı uygulamalarımla nasıl kullanabilirim?

AI Studio, GitHub ile iki yönlü senkronizasyonu destekler:

  • Depo içe aktarma: Derleme modunda, mevcut kodu içe aktarmak için istem giriş kutusundaki Dosya ekle (+ simgesi) menüsünden GitHub'dan içe aktar'ı seçin.
  • Depo bağlama: Ayarlar'da GitHub sekmesini açarak uygulamanızdan yeni bir GitHub deposu oluşturun veya mevcut bir depoya bağlantı verin.
  • İki yönlü senkronizasyon: AI Studio'da istenen değişiklikleri, yapay zeka tarafından oluşturulan commit mesajlarıyla doğrudan deponuza aktarın veya harici olarak yapılan değişiklikleri (ör. yerel IDE düzenlemeleri ya da ekip arkadaşlarınızın pull istekleri) AI Studio'ya geri çekin.
  • Birleştirme çakışmalarını çözme: GitHub ile senkronizasyon sırasında değişiklikler çakışırsa AI Studio, yan yana fark görüntüleyici içeren bir Çakışmaları çöz iletişim kutusu sunar. Bu iletişim kutusunda farklılıkları inceleyebilir ve çakışan her dosya için AI Studio veya GitHub sürümünü saklamayı seçebilirsiniz.

Diğer kullanıcılara uygulamam için düzenleme erişimi verebilir miyim?

AI Studio, doğrudan gerçek zamanlı ortak düzenlemeyi desteklemez. Ancak uygulamanızı paylaşılan bir GitHub deposuna bağlayarak ekip arkadaşlarınızla ortak çalışabilirsiniz. Ekip arkadaşlarınız GitHub'da değişiklikleri gönderebilir veya pull istekleri açabilir. Siz de bu güncellemeleri AI Studio'ya çekebilirsiniz.

Uygulamam neden politika ihlali nedeniyle işaretlendi?

Uygulamaları otomatik olarak inceleyerek politikalarımıza uygunluklarını kontrol eden sistemlerimiz vardır. Politikalarımızı ihlal ettiği tespit edilen uygulamalar AI Studio'dan kaldırılır. Politika ihlalleri aşağıdakileri kapsayabilir ancak bunlarla sınırlı değildir:

  • Kötü amaçlı yazılım, kimlik avı veya kimliğe bürünme içeren uygulamalar
  • Çocukların cinsel istismarı nitelikli görsel politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Taciz politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Nefret Söylemi Politikası'nı ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • İnsan Ticareti Politikası'nı ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Müstehcen içerik politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Şiddet ve vahşet politikasını ihlal eden içerikler gösteren veya dağıtan uygulamalar
  • Zararlı veya tehlikeli içerik politikasını ihlal eden içerikler gösteren ya da dağıtan uygulamalar

Uygulamanız politika ihlali nedeniyle işaretlendiyse ve bunun hatalı olduğunu düşünüyorsanız itirazda bulunabilirsiniz. Politikalarımızın tekrarlanan şekilde ihlal edilmesi, AI Studio'ya erişiminizin sonlandırılmasına neden olabilir.

Uygulama geliştirici olarak sorumluluklarım nelerdir?

Uygulamanızın sahibi olarak, uygulamanızın davranışından ve işlediği tüm verilerden sorumlu olduğunuzu hatırlatmak isteriz. Bunlardan bazıları:

  • Kanunlara ve Kurallara Uygunluk ve Üçüncü Taraf Hakları: Uygulamanızın geçerli tüm yasalara ve yönetmeliklere uygun olmasını ve fikri mülkiyet ile gizlilik hakları da dahil olmak üzere başkalarının haklarını ihlal etmemesini sağlama.
  • İçerik İzleme: Ek şartlara uygunluk, uygulamanız tarafından kullanılan diğer hizmetler için geçerli olabilir. Örneğin, Firestore için geçerli olan Google Cloud Hizmet Şartları uyarınca, üçüncü taraf içerikleri barındıran müşterilerin hangi içeriklerin yasak olduğunu (ör. yasa dışı içerik) tanımlayan politikalar yayınlaması ve bu yasa dışı içeriklerin varlığını izlemesi gerekir.
  • Güvenli uygulama: Uygulamanızın kötüye kullanılmasını önlemek için gerekli güvenlik önlemlerini ve moderasyon araçlarını uygulama.

Hizmet Şartları'ndaki kullanım kısıtlamalarına dikkat edin.

Aksi belirtilmedikçe, AI Studio'daki uygulama galerisinde yer alan uygulamaların kullanımı Gemini API Ek Hizmet Şartları'na tabidir.

Sırada ne var?