iOS projenize Firebase ekleyin

Önkoşullar

• Aşağıdakileri yükleyin:

  • Xcode 12.2 veya üstü
  • CocoaPods 1.10.0 veya üzeri

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

  • Projeniz iOS 10 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'yı kullanmak istiyor musunuz?

  iOS'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 Anında Bildirim Kimlik Doğrulama Anahtarı edinin.
  • Xcode'da App > Capabilities altında Push Bildirimlerini 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.

Adım 1 : Bir Firebase projesi oluşturun

Firebase'i iOS uygulamanıza 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 Anlayın sayfasını ziyaret edin.

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

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

Bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve düşünceler hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfası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. iOS paket kimliği alanına uygulamanızın paket kimliğini girin.

   Paket kimliği nedir ve onu nerede bulursunuz?

   • Paket kimliği , Apple 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 kaydedildikten 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 Uygulama Mağazası Kimliği .

   Firebase'de Uygulama takma adı ve Uygulama Mağazası 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 : Kullanıcıları App Store sayfanıza yönlendirmek için Firebase Dynamic Links ve dönüşüm etkinliklerini Google Ads'e aktarmak için Google Analytics tarafından 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 : Bir 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 Anlayın sayfasını ziyaret edin.

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

   • Yapılandırma dosyası adının sonuna (2) gibi ek karakterler eklenmediğinden emin olun.

2. Yapılandırma dosyanızı Xcode projenizin kök dizinine taşıyın. İstenirse, yapılandırma dosyasını tüm hedeflere eklemek için 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 konsolunda kayıtlı bir uygulamayla ilişkilendirmeniz gerekir.

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

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

Hızlı başlangıç ​​örneklerinden birini mi kullanıyorsunuz? Xcode projesi ve Podfile (bölmelerle birlikte) zaten mevcut, ancak yine de Firebase yapılandırma dosyanızı eklemeniz ve bölmeleri yüklemeniz gerekecek.

1. Henüz yoksa bir Pod dosyası 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

   platform :ios, ‘10.0’
   
   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   
   # 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'

   Apple'ın Kullanıcı Gizliliği ve Veri Kullanımı ve Uygulama İzleme Şeffaflığı belgelerinde cihaz düzeyinde reklam tanımlayıcısı olan IDFA hakkında daha fazla bilgi edinin.

   Analytics etkinleştirilmedi

   platform :ios, ‘10.0’
   
   # 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 kurun, ardından projeyi .xcworkspace görmek için .xcworkspace dosyanızı açın:

   pod install

   open your-project.xcworkspace

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

Son adım, uygulamanıza başlatma kodu eklemektir. Bunu, uygulamanıza Firebase eklemenin bir parçası olarak zaten yapmış olabilirsiniz. Bir hızlı başlangıç ​​örneği proje kullanıyorsanız , bu sizin için yapılmıştır.

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

   hızlı

   import Firebase

   Amaç-C

   @import Firebase;

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

   hızlı

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

   Amaç-C

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

3. Firebase Analytics'i dahil ettiyseniz, Firebase'i başarıyla yüklediğiniz Firebase konsoluna doğrulama göndermek için uygulamanızı çalıştırabilirsiniz.

Bu kadar! Sonraki adımlara atlayabilirsiniz.

Yine de kurulum konusunda sorun yaşıyorsanız, iOS sorun giderme ve SSS sayfasını ziyaret edin.

Mevcut kapsüller

Bu bölüm, iOS ve bunların bölmeleri için desteklenen Firebase ürünlerini listeler. Bu Firebase iOS kitaplıkları hakkında daha fazla bilgi edinin:

• Referans belgeleri ( Swift | Obj-C )

• Firebase iOS SDK GitHub deposu

CocoaPod'lar 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 yararlanmaya devam edebilirsiniz.

çerçeveler

iOS platformunu desteklemenin yanı sıra, zip artık topluluk tabanlı Catalyst desteği ekleyen .xcframework dosyalarını da içeriyor. Ayrıntılar için GitHub'daki Firebase iOS SDK README'ye 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 bağlayıcı bayrağını , hedefinizin oluşturma ayarlarındaki Other Linker Settings ekleyin.

Swift Paket Yöneticisi

Kılavuzumuzda Swift Paket Yöneticisi entegrasyonu hakkında daha fazla bilgi edinin.

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 Anlayın sayfasını ziyaret edin.

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

• Firebase iOS Codelab ile uygulamalı deneyim elde edin.

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

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

  • Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
  • Projenizin birden fazla Firebase hizmetinde kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma panosunu izleyin.
  • Firebase başlatma kontrol listesini inceleyin .

• Firebase ve iOS projenizle ilgili sorun mu yaşıyorsunuz? iOS sorun giderme ve SSS sayfasını ziyaret edin.

Uygulamanıza Firebase hizmetleri 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.

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