Firebase'i iOS projenize ekleyin

Önkoşullar

• Aşağıdakileri kurun:

  • Xcode 11.0 veya üstü
  • CocoaPods 1.4.0 veya üstü

• Projenizin şu gereksinimleri karşıladığından emin olun:

  • Projeniz iOS 8 veya sonraki bir sürümünü hedeflemelidir.

• Uygulamanızı çalıştırmak için fiziksel bir iOS cihazı kurun veya iOS simülatörünü kullanın.

  Bulut Mesajlaşma kullanmak istiyor musunuz?

  İOS'ta Bulut Mesajlaşma için ön koşullar şunlardır:

  • Fiziksel bir iOS cihazı kurun.
  • Apple Geliştirici hesabınız için bir Apple Push Bildirimi Kimlik Doğrulama Anahtarı edinin.
  • Xcode'da Uygulama> Yetenekler altında Push Bildirimleri etkinleştirin.

• Google hesabınızı kullanarak Firebase'de oturum açın.

Halihazırda bir Xcode projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç ​​örneklerimizden birini indirebilirsiniz.

1. Adım : Firebase projesi oluşturun

İOS uygulamanıza Firebase eklemeden önce, iOS uygulamanıza bağlanmak için bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama bölümünü ziyaret edin.

2. Adım : Uygulamanızı Firebase'e kaydedin

Bir Firebase projeniz olduktan sonra, iOS uygulamanızı buna ekleyebilirsiniz.

Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve dikkate alınması gereken noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama bölümünü ziyaret edin.

1. Firebase konsoluna gidin .

2. Projeye genel bakış sayfasının plat_ios , kurulum iş akışını başlatmak için iOS simgesine ( plat_ios ) tıklayın.

   Firebase projenize zaten bir uygulama eklediyseniz, platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.

3. İOS paket kimliği alanına uygulamanızın paket kimliğini girin.

   Paket kimliği nedir ve nerede buluyorsunuz?

   • Paket kimliği , Apple'ın ekosistemindeki bir uygulamayı benzersiz şekilde tanımlar.

   • Paket kimliğinizi bulun: iOS projenizi Xcode'da açın, proje gezgininde en üst düzey uygulamayı seçin, ardından Genel sekmesini seçin.

     Paket Tanımlayıcı alanının değeri, iOS paket kimliğidir (örneğin, com.yourcompany.yourproject ).

   • Paket kimliği değerinin büyük / küçük harfe duyarlı olduğunu ve Firebase projenize kaydolduktan sonra bu Firebase iOS uygulaması için değiştirilemeyeceğini unutmayın.

4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve App Store Kimliği .

   Firebase'de Uygulama takma adı ve App Store Kimliği nasıl kullanılır?

   • Uygulama takma adı : Yalnızca Firebase konsolunda görebileceğiniz dahili, kullanışlı bir tanımlayıcı

   • App Store Kimliği : Firebase Dynamic Links tarafından kullanıcıları App Store sayfanıza yönlendirmek için ve Google Analytics tarafından dönüşüm etkinliklerini Google Ads'e aktarmak için kullanılır . Uygulamanızın henüz bir App Store Kimliği yoksa kimliği daha sonra Proje ayarlarınızdan ekleyebilirsiniz.

5. Uygulamayı kaydet'i tıklayın.

3. Adım : Firebase yapılandırma dosyası ekleyin

1. Firebase iOS yapılandırma dosyanızı ( GoogleService-Info.plist ) almak için GoogleService-Info.plist'i İndir'i tıklayın.

   Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?

   • Firebase yapılandırma dosyası, projeniz için benzersiz, ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

   • Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.

   • Yapılandırma dosyası adına (2) gibi ek karakterlerin eklenmediğinden emin olun.

2. Yapılandırma dosyanızı Xcode projenizin köküne taşıyın. İstenirse, yapılandırma dosyasını tüm hedeflere eklemeyi seçin.

Projenizde birden fazla paket kimliğiniz varsa, her uygulamanın kendi GoogleService-Info.plist dosyasına sahip olabilmesi için her paket kimliğini Firebase konsolundaki kayıtlı bir uygulamayla ilişkilendirmeniz gerekir.

4. Adım : Firebase SDK'larını uygulamanıza ekleyin

Firebase kitaplıklarını yüklemek için CocoaPods kullanmanızı öneririz . Ancak CocoaPod'ları kullanmak istemiyorsanız, SDK çerçevelerini doğrudan entegre edebilir veya Swift Paket Yöneticisini (beta) kullanabilirsiniz .

Hızlı başlangıç ​​örneklerinden birini kullanıyor musunuz? Xcode projesi ve Podfile (kapsüller ile) zaten mevcut, ancak yine de Firebase yapılandırma dosyanızı eklemeniz ve bölmeleri yüklemeniz gerekir.

1. Zaten sahip değilseniz bir Podfile oluşturun:

   cd your-project-directory

   pod init

2. Pod Dosyanıza, uygulamanızda kullanmak istediğiniz Firebase bölmelerini ekleyin.

   Desteklenen Firebase ürünlerinden herhangi birini iOS uygulamanıza ekleyebilirsiniz.

   Analytics etkinleştirildi

   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # Add the pods for any other Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'Firebase/Auth'
   pod 'Firebase/Firestore'

   Analytics etkinleştirilmedi

   # Add the pods for the Firebase products you want to use in your app
   # For example, to use Firebase Authentication and Cloud Firestore
   pod 'Firebase/Auth'
   pod 'Firebase/Firestore'

3. Bölmeleri yükleyin, ardından projeyi .xcworkspace görmek için .xcworkspace dosyanızı açın:

   pod install

   open your-project.xcworkspace

5. Adım : Uygulamanızda Firebase'i başlatın

Son adım, uygulamanıza başlatma kodunu eklemektir. Firebase'i uygulamanıza eklemenin bir parçası olarak bunu zaten yapmış olabilirsiniz. Hızlı başlangıç ​​örnek projesi kullanıyorsanız , bu sizin için yapılmıştır.

1. Sizin de Firebase modülü içe UIApplicationDelegate :

   Swift

   import Firebase

   Amaç-C

   @import Firebase;

2. Genellikle uygulamanızın uygulamasında bir FirebaseApp paylaşılan örneği yapılandırın application:didFinishLaunchingWithOptions: yöntem:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Amaç-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Firebase Analytics'i eklediyseniz, Firebase'i başarıyla yüklediğinize dair doğrulamayı Firebase konsoluna göndermek için uygulamanızı çalıştırabilirsiniz.

Bu kadar! Sonraki adımlara atlayabilirsiniz.

Kullanılabilir kapsüller

Bu bölümde, iOS için desteklenen Firebase ürünleri ve bunların kapsülleri listelenmektedir. Bu Firebase iOS kitaplıkları hakkında daha fazla bilgi edinin:

• Başvuru belgeleri ( Swift | Obj-C )

• Firebase iOS SDK GitHub kod deposu

Kullanımdan kaldırıldı:

CocoaPods olmadan entegre edin

Cocoapod'ları kullanmak istemiyorsanız, çerçeveleri doğrudan içe aktararak veya Swift Paket Yöneticisi'ni kullanarak Firebase SDK'larından yararlanabilirsiniz.

Çerçeveler

İOS platformunu desteklemeye ek olarak, zip artık topluluk tabanlı Catalyst desteği ekleyen .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'da Firebase iOS SDK README sayfasına bakın.

1. Çerçeve SDK zip dosyasını indirin. Bu ~ 200MB'lık bir dosyadır ve indirilmesi biraz zaman alabilir.

2. Dosyanın Sıkıştırılmış ve ardından incelemek README uygulamanızda dahil etmek istediğiniz çerçeveleri.

3. ObjC derleme ayarlarındaki Other Linker Settings ObjC bağlayıcı bayrağını ekleyin.

Swift Paket Yöneticisi

Swift Paket Yöneticisi desteği şu anda beta aşamasındadır. GitHub'daki belgeleri takip edin ve herhangi bir geri bildiriminizi GitHub sorun izleyicisine gönderin.

Sonraki adımlar

Firebase hakkında bilgi edinin:

• Firebase projeleri ve projeler için en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

• Örnek Firebase uygulamalarını keşfedin.

• Firebase iOS Codelab ile uygulamalı deneyim edinin .

• GitHub'da açık kaynak kodunu keşfedin.

• Uygulamanızı başlatmaya hazırlanın:

  • GCP konsolunda projeniz için bütçe uyarıları ayarlayın.
  • Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izleyin.
  • Firebase başlatma kontrol listesini inceleyin .

Firebase hizmetlerini uygulamanıza ekleyin:

• Analytics ile kullanıcı davranışı hakkında bilgi edinin .

• Kimlik Doğrulama ile kullanıcı kimlik doğrulamasını ayarlayın.

• Kullanıcı bilgileri gibi verileri Cloud Firestore veya Realtime Database ile depolayın.

• Fotoğraflar ve videolar gibi dosyaları Cloud Storage ile depolayın.

• Cloud Functions ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.

• Bulut Mesajlaşma ile bildirimler gönderin.

• Uygulamanızın ne zaman ve neden Crashlytics ile kilitlendiğini öğrenin .