1. Genel Bakış
Bu codelab'de, Firebase Studio'da Firebase MCP sunucusu ile birlikte App Prototyping aracısını kullanarak Firestore'u kullanan bir tam yığın web uygulaması oluşturma alıştırması yapacaksınız.
Neler öğreneceksiniz?
- Uygulama Prototipi Oluşturma aracısını kullanarak statik bir web uygulaması oluşturma
- Firebase projesine bağlanma
- Firebase MCP sunucusunu ayarlama
- Firebase MCP'yi kullanarak Firestore'u ekleme
Gerekenler
- Google Chrome gibi istediğiniz bir tarayıcı
- Firebase projenizin oluşturulması ve yönetilmesi için bir Google Hesabı
2. Uygulama Prototipleme aracını kullanarak uygulamanızı oluşturma
Uygulama Prototipi Aracısı, uygulamanızı oluşturmak için Firebase'de Gemini'ı kullanır. Aynı istemler kullanıldığında bile sonuçlar farklı olabilir.
- Google Hesabınıza giriş yapın, Google Geliştirici Programı'na katılın ve Firebase Studio'yu açın.
- Yapay zeka ile uygulama prototipi oluşturun alanına uygulamanın açıklamasını girin:
An app for a picker wheel that allows custom input.
- İstemi İyileştir'i tıklayın. İyileştirilmiş istemi inceleyin.
- Yapay zeka ile prototip oluşturun'u tıklayın.
- Önerilen uygulama planını inceleyin. Düzenlemek için
Özelleştir'i tıklayın.
- Kaydet'i tıklayın.
- Plan, güncellemelerinizi eklemeyi tamamladığında Bu Uygulamanın Prototipini Oluştur'u tıklayın.
- Planınızda yapay zeka öğeleri varsa aracı, Gemini Gemini anahtarı girmenizi ister. Kendi Gemini API anahtarınızı ekleyin veya Gemini API anahtarı oluşturmak için Otomatik oluştur'u tıklayın. Otomatik oluştur'u tıklarsanız Firebase Studio bir Firebase projesi oluşturur ve sizin için bir Gemini API anahtarı oluşturur.
- Uygulama Prototipleme aracısı, uygulamanızın ilk sürümünü oluşturmak için planı kullanır. İşlem tamamlandığında, uygulamanızın önizlemesi bir Gemini Chat arayüzüyle birlikte gösterilir. Uygulamanızı inceleyip test etmek için biraz zaman ayırın. Hatalarla karşılaşırsanız temsilcinin kendi hatalarını düzeltmesine izin vermek için sohbette Hatayı Düzelt'i tıklayın.
3. (İsteğe bağlı) Kodu alma
Takılırsanız bu noktadan itibaren örnek uygulamayı daha yakından takip etmek için örnek dosyaları kullanın.
- Klasördeki dosyaları indirin.
- Firebase Studio'da
Koda Geç'i tıklayarak Kod görünümünü açın.
- İndirdiğiniz dosyaları Firebase Studio'nun Explorer bölmesine sürükleyin. Dosyaların mevcut dosyaları değiştirmesine izin verin.
- Paketleri yüklemek için terminalde (
Shift
+Ctrl
+C
) aşağıdaki komutu çalıştırın.npm install
- Firebase Studio'nun Kaynak Kontrolü bölmesini açın, kod değişikliğini açıklayan bir mesaj yazın (ör. "GitHub'dan kod içe aktarıldı") ve Commit'e (Yorumla) basın.
- Uygulamanın örnek sürümünü kullanarak codelab'e devam etmek için Prototip Oluşturucu'ya geç'i tıklayın.
4. Firebase projesine bağlanma
Tebrikler! Uygulamanız yerel olarak çalışıyor. Uygulamaya arka uç eklemek için bir sonraki adımda uygulamayı bir Firebase projesine bağlayacaksınız.
- Uygulama Prototipi Oluşturma aracısından bir Firebase projesine bağlanmasını isteyin.
Aracının yeni bir proje oluşturmasını veya mevcut bir projeye bağlanmasını bekleyin (Daha önce Gemini API anahtarı almak için otomatik oluşturma seçeneğini kullandıysanız projeniz ekranınızın sol üst köşesindeki çalışma alanı adınızın yanında görünür). Ardından, gerekli Firebase yapılandırmasını oluşturupConnect to a Firebase project.
src/lib/firebase.ts
aracılığıyla uygulamanıza entegre edin (gösterildiği gibi). Yukarıdaki istem görevi tek seferde tamamlayamazsa aracıya tekrar sormaktan çekinmeyin. Gerekirse adımları ayrı ayrı sorun.import { initializeApp, getApp, getApps } from 'firebase/app'; const firebaseConfig = { "projectId": "foo-bar-baz", "appId": "1:630673270654:web:3eda41879acd38fa96ce14", "storageBucket": "foo-bar-baz.firebasestorage.app", "apiKey": "AIzaSyDGoMZQia334izw8JedslMTUD0fNpmFca0", "authDomain": "foo-bar-baz.firebaseapp.com", "measurementId": "", "messagingSenderId": "630673270654" }; // Initialize Firebase const app = !getApps().length ? initializeApp(firebaseConfig) : getApp(); export default app;
Create a new Firebase project.
5. Firebase Studio'da Firebase MCP'yi ayarlama
Firebase MCP sunucusu, Firebase Authentication, Cloud Firestore ve Firebase Data Connect dahil olmak üzere Firebase hizmetlerinden veri ayarlamak, yönetmek ve çekmek için aracının çağırabileceği araçlar sağlayarak Uygulama Prototipi Oluşturma aracısının özelliklerini genişletir. Bunu nasıl ayarlayacağınız aşağıda açıklanmıştır.
- Kod görünümünü açmak için
Koda Geç'i tıklayın.
- Terminalde (
Shift
+Ctrl
+C
), ekrandaki talimatları uygulayarak ve tüm varsayılan seçenekleri olduğu gibi bırakarak Firebase hesabınızda oturum açmak için aşağıdaki komutu çalıştırın:firebase login --no-localhost
- Gezgin'de (
Ctrl
+Shift
+E
) .idx klasörünü sağ tıklayın ve Yeni dosya'yı seçin. Dosyayamcp.json
adını verin ve Enter tuşuna basın. - Sunucu yapılandırmalarını
.idx/mcp.json
dosyasına ekleyin. Firebase MCP sunucusuna bağlı olduğunuzu doğrulayın. Çıkış panelinde benzer günlük girişleri görmeniz gerekir. Doğru kanal olarak "Gemini" seçilmelidir.{ "mcpServers": { "firebase": { "command": "npx", "args": [ "-y", "firebase-tools@latest", "experimental:mcp" ] } } }
6. Firebase MCP'yi kullanarak Firestore'u ekleme
1. hedef: Firestore'u ekleyin
- Prototyper'a geçin. Sohbet arayüzünde, temsilciden uygulamanızda Firestore'u kullanmasını isteyin.
Temsilcinin şunları yapmasını bekleyin:Use Firestore for user entries. Give anyone read and write access.
- Firebase MCP aracını
firebase_init
çağırarak Firestore'u başlatın. Bu işlem, diğer yapılandırma değişikliklerinin yanı sıra Firestore kurallarını (gösterildiği gibi) oluşturur ve dosyaları indeksler. - Uygulama kodunuzu yerel depolama yerine Firestore'u kullanacak şekilde güncelleyin.
Burada, herkese veritabanınızda okuma ve yazma erişimi verilir. Bu codelab'in dışında, veritabanlarınızı her zaman güvenli hale getirmeniz gerekir. Bu konu hakkında daha fazla bilgiyi dokümanlarımızda bulabilirsiniz.rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { match /{document=**} { allow read, write: if true; } } }
- Firebase MCP aracını
- Koda geç'i tıklayın. Terminalde (
Shift
+Ctrl
+C
), mevcut Firebase projesinde Firestore API'yi hiç etkinleştirmediyseniz Firestore'u başlatın. Ekrandaki talimatları uygulayın ve varsayılan seçenekleri değiştirmeyin. Önceki adımdaki güvenlik kurallarının üzerine yazmayın.Ardından, veritabanı örneğiniz için güvenlik kurallarını dağıtın.firebase init firestore
Bu işlem, sizin için bir Firestore veritabanı örneği sağlar.firebase deploy --only firestore
2. hedef: Test edin
- Uygulamanızı yeniden yükleyin, seçme çarkınızda girişler oluşturup silin ve bu güncellemeleri Firebase Console'daki Firestore sayfasında izleyin.
- Veritabanınızı sorgulamak için Firestore ile de sohbet edebilirsiniz.
Gemini'ın Firebase MCP aracınıList my Firestore collections.
firestore_list_collections
çağırmasını bekleyin.
7. Sonuç
Tebrikler! Firebase MCP ile App Prototyping aracısını kullanarak tam yığınlı bir web uygulamasını başarıyla oluşturdunuz. Firebase MCP sunucusu tarafından sunulan diğer araçları denemekten ve uygulamanızın yapabileceklerini genişletmekten çekinmeyin.