เพิ่ม Firebase ให้กับโครงการ Apple ของคุณ

ข้อกำหนดเบื้องต้น

• ติดตั้งสิ่งต่อไปนี้:

  • Xcode 14.1 หรือใหม่กว่า

• ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:

  • โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
    • iOS 11
    • แมคโอเอส 10.13
    • tvOS 12
    • วอทช์โอเอส 6

• ตั้งค่าอุปกรณ์ Apple จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอพของคุณ

  คุณต้องการใช้ Cloud Messaging หรือไม่

  สำหรับ Cloud Messaging บนแพลตฟอร์ม Apple สิ่งที่จำเป็นต้องมีมีดังนี้

  • ตั้งค่า อุปกรณ์ Apple จริง
  • รับรหัสการตรวจสอบสิทธิ์การแจ้งเตือนแบบพุชของ Apple สำหรับ บัญชีนักพัฒนา Apple ของคุณ
  • เปิดใช้งานการแจ้งเตือนแบบพุชใน Xcode ภายใต้ App > Capabilities

• ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ

หากคุณยังไม่มีโครงการ Xcode และเพียงต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่างการเริ่มต้นอย่างรวดเร็ว ของเรา

ขั้นตอนที่ 1 : สร้างโครงการ Firebase

ก่อนที่คุณจะเพิ่ม Firebase ลงในแอป Apple คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอปของคุณ ไปที่ ทำความเข้าใจโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase

สร้างโครงการ Firebase

1. ใน คอนโซล Firebase ให้คลิก เพิ่มโครงการ

   • หากต้องการเพิ่มทรัพยากร Firebase ในโครงการ Google Cloud ที่มีอยู่ ให้ป้อนชื่อโครงการหรือเลือกจากเมนูแบบเลื่อนลง

   • หากต้องการสร้างโครงการใหม่ ให้ป้อนชื่อโครงการที่ต้องการ คุณยังสามารถเลือกที่จะแก้ไขรหัสโครงการที่แสดงด้านล่างชื่อโครงการ

2. หากได้รับแจ้ง ให้อ่านและยอมรับ ข้อกำหนดของ Firebase

3. คลิก ดำเนินการต่อ

4. (ไม่บังคับ) ตั้งค่า Google Analytics สำหรับโครงการ ซึ่งช่วยให้คุณได้รับประสบการณ์ที่ดีที่สุดโดยใช้ผลิตภัณฑ์ Firebase ต่อไปนี้

   Firebase Crashlytics การส่งข้อความบนคลาวด์ของ Firebase

   การส่งข้อความในแอปของ Firebase การกำหนดค่าระยะไกลของ Firebase

   การกำหนดค่าส่วนบุคคลระยะไกล การทดสอบ A/B ของ Firebase

   เลือก บัญชี Google Analytics ที่มีอยู่หรือสร้างบัญชีใหม่

   หากคุณสร้างบัญชีใหม่ ให้เลือก ตำแหน่งการรายงาน Analytics ของคุณ จากนั้นยอมรับการตั้งค่าการแบ่งปันข้อมูลและข้อกำหนดของ Google Analytics สำหรับโครงการของคุณ

5. คลิก สร้างโครงการ (หรือ เพิ่ม Firebase หากคุณใช้โครงการ Google Cloud ที่มีอยู่)

Firebase จัดเตรียมทรัพยากรสำหรับโครงการ Firebase ของคุณโดยอัตโนมัติ เมื่อดำเนินการเสร็จสิ้น คุณจะเข้าสู่หน้าภาพรวมสำหรับโปรเจ็กต์ Firebase ในคอนโซล Firebase

ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณกับ Firebase

หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปของคุณในโครงการ

1. ไปที่ คอนโซล Firebase

2. ที่กึ่งกลางของหน้าภาพรวมโครงการ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า

   หากคุณเพิ่มแอปในโครงการ Firebase แล้ว ให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

3. ป้อนรหัสชุดของแอปในช่อง รหัสชุด

   รหัสบันเดิลคืออะไร และคุณจะพบได้จากที่ใด

   • รหัสบันเดิล จะระบุแอปพลิเคชันในระบบนิเวศของ Apple โดยไม่ซ้ำกัน

   • ค้นหา Bundle ID ของคุณ: เปิดโปรเจ็กต์ของคุณใน Xcode เลือกแอประดับบนสุดในเนวิเกเตอร์โปรเจ็กต์ จากนั้นเลือกแท็บ ทั่วไป

     ค่าของฟิลด์ Bundle Identifier คือรหัสบันเดิล (เช่น com.yourcompany.yourproject )

   • โปรดทราบว่าค่า Bundle ID คำนึงถึงขนาดตัวพิมพ์ และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase นี้หลังจากลงทะเบียนกับโปรเจ็กต์ Firebase ของคุณแล้ว

4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่นแอป และ App Store ID

   ชื่อเล่นแอป และ รหัส App Store ใช้ใน Firebase อย่างไร

   • ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase

   • App Store ID : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปของคุณยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสในภายหลังได้ใน การตั้งค่าโครงการ

5. คลิก ลงทะเบียนแอป

ขั้นตอนที่ 3 : เพิ่มไฟล์กำหนดค่า Firebase

1. คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่าแพลตฟอร์ม Firebase Apple ( GoogleService-Info.plist )

   คุณต้องรู้อะไรบ้างเกี่ยวกับไฟล์ปรับแต่งนี้

   • ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำใครแต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่านี้ โปรดไป ที่ ทำความเข้าใจโครงการ Firebase

   • คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ

   • ตรวจสอบให้แน่ใจว่าชื่อไฟล์ config ไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

2. ย้ายไฟล์กำหนดค่าของคุณไปที่รูทของโปรเจ็กต์ Xcode หากได้รับแจ้ง ให้เลือกเพื่อเพิ่มไฟล์กำหนดค่าไปยังเป้าหมายทั้งหมด

หากคุณมีรหัสกลุ่มหลายรหัสในโครงการ คุณต้องเชื่อมโยงรหัสกลุ่มแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist ของตัวเอง

ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ในแอปของคุณ

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการอ้างอิง Firebase

1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:

  https://github.com/firebase/firebase-ios-sdk

3. เลือกเวอร์ชัน SDK ที่คุณต้องการใช้

4. เลือกไลบรารี Firebase ที่คุณต้องการใช้

   หากเปิดใช้ Google Analytics ในโครงการ Firebase อย่าลืมเพิ่ม FirebaseAnalytics สำหรับ Analytics ที่ไม่มีความสามารถในการรวบรวม IDFA ให้เพิ่ม FirebaseAnalyticsWithoutAdId แทน

เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

ขั้นตอนที่ 5 : เริ่มต้น Firebase ในแอปของคุณ

ขั้นตอนสุดท้ายคือการเพิ่มรหัสเริ่มต้นให้กับแอปพลิเคชันของคุณ คุณอาจทำสิ่งนี้ไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ในแอปของคุณ หากคุณกำลังใช้ โครงการตัวอย่างเริ่มต้นอย่างรวดเร็ว สิ่งนี้ได้ดำเนินการให้คุณแล้ว

1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่ตัวแทนแอปของคุณใช้ ตัวอย่างเช่น หากต้องการใช้ Cloud Firestore และการรับรองความถูกต้อง:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   สวิฟต์

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   วัตถุประสงค์-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp ใน application(_:didFinishLaunchingWithOptions:) วิธีการ:

   SwiftUI

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

   สวิฟต์

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

   วัตถุประสงค์-C

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

3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. หากคุณรวม Firebase SDK สำหรับ Google Analytics แล้ว คุณสามารถเรียกใช้แอปเพื่อส่งการยืนยันไปยังคอนโซล Firebase ที่คุณติดตั้ง Firebase สำเร็จ

แค่นั้นแหละ! คุณสามารถข้ามไปยัง ขั้นตอนถัดไป

หากคุณประสบปัญหาในการตั้งค่า โปรดไปที่ การแก้ไขปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์มของ Apple

ห้องสมุดที่มีอยู่

ส่วนนี้แสดงรายการผลิตภัณฑ์ Firebase ที่รองรับสำหรับแพลตฟอร์มของ Apple เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Firebase Apple เหล่านี้:

• เอกสารอ้างอิง ( Swift | Obj-C )

• Firebase Apple แพลตฟอร์ม SDK GitHub repo

บริการหรือสินค้า	พ็อด	ห้องสมุด SwiftPM	เพิ่มการวิเคราะห์?
AdMob	pod 'Google-Mobile-Ads-SDK'	ไม่มีข้อมูล
การวิเคราะห์	pod 'FirebaseAnalytics'	FirebaseAnalytics
ตรวจสอบแอป	pod 'FirebaseAppCheck'	FirebaseAppCheck
การกระจายแอพ	pod 'FirebaseAppDistribution'	FirebaseAppDistribution
การรับรองความถูกต้อง	pod 'FirebaseAuth'	FirebaseAuth
Cloud Firestore	pod 'FirebaseFirestore'	FirebaseFirestore
ฟังก์ชันคลาวด์สำหรับ Firebase Client SDK	pod 'FirebaseFunctions'	FirebaseFunctions
การส่งข้อความบนคลาวด์	pod 'FirebaseMessaging'	FirebaseMessaging
การจัดเก็บเมฆ	pod 'FirebaseStorage'	FirebaseStorage
แครชไลติค	pod 'FirebaseCrashlytics'	FirebaseCrashlytics
ลิงค์แบบไดนามิก	pod 'FirebaseDynamicLinks'	FirebaseDynamicLinks
การส่งข้อความในแอป	pod 'FirebaseInAppMessaging'	FirebaseInAppMessaging	(ที่จำเป็น)
การติดตั้ง Firebase	pod 'FirebaseInstallations'	FirebaseInstallations
API โมเดลที่กำหนดเองของ Firebase ML	pod 'FirebaseMLModelDownloader'	FirebaseMLModelDownloader
การตรวจสอบประสิทธิภาพ	pod 'FirebasePerformance'	FirebasePerformance
ฐานข้อมูลเรียลไทม์	pod 'FirebaseDatabase'	FirebaseDatabase
การกำหนดค่าระยะไกล	pod 'FirebaseRemoteConfig'	FirebaseRemoteConfig

ผสานรวมโดยไม่ต้องใช้ Swift Package Manager

หากคุณไม่ต้องการใช้ Swift Package Manager คุณยังคงสามารถใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือโดยการนำเข้าเฟรมเวิร์กโดยตรง

ฝักโกโก้

เรียนรู้เพิ่มเติมเกี่ยวกับการรวม CocoaPods ใน คำแนะนำของเรา

กรอบงาน

นอกเหนือจากการรองรับแพลตฟอร์ม iOS แล้ว zip ยังมีไฟล์ .xcframework โปรดดูรายละเอียด ที่ Firebase Apple platforms SDK README บน GitHub

1. ดาวน์โหลด เฟรมเวิร์ก SDK zip นี่เป็นไฟล์ประมาณ 200MB และอาจใช้เวลาสักครู่ในการดาวน์โหลด

2. เปิดเครื่องรูดไฟล์ จากนั้นรวมเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอปของคุณ

   คุณสามารถดูคำแนะนำในการรวมได้จากที่ใดที่หนึ่งต่อไปนี้:

   • ใน ที่เก็บ Firebase iOS SDK GitHub
   • ในไฟล์ README.md ภายในไฟล์ zip ที่ดาวน์โหลดมา

   สำหรับข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือการขึ้นต่อกัน โปรดดูที่ไฟล์ METADATA.md ภายในไฟล์ zip ที่ดาวน์โหลดมา

3. เพิ่ม แฟล็กตัวเชื่อมโยง -ObjC ใน Other Linker Settings ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ

ขั้นตอนถัดไป

เรียนรู้เกี่ยวกับ Firebase:

• ไปที่ ทำความเข้าใจโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase และแนวทางปฏิบัติที่ดีที่สุดสำหรับโครงการ

• สำรวจ แอป Firebase ตัวอย่าง

• รับประสบการณ์จริงด้วย Firebase iOS Codelab

• สำรวจ โอเพ่นซอร์สโค้ดใน GitHub

• เตรียมเปิดตัวแอปของคุณ:

  • ตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโครงการของคุณใน Google Cloud Console
  • ตรวจสอบ แดชบอร์ด การใช้งานและการเรียกเก็บเงิน ในคอนโซล Firebase เพื่อดูภาพรวมของการใช้งานโครงการของคุณในบริการต่างๆ ของ Firebase
  • ตรวจสอบ รายการตรวจสอบการเปิดใช้ Firebase

• มีปัญหากับ Firebase และโครงการ Apple ของคุณใช่ไหม ไปที่ การแก้ไขปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์มของ Apple

เพิ่มบริการ Firebase ในแอปของคุณ:

• รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics

• ตั้งค่าการพิสูจน์ตัวตนผู้ใช้ด้วย Authentication

• จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database

• จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอด้วย Cloud Storage

• ทริกเกอร์แบ็กเอนด์โค้ดที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions

• ส่งการแจ้งเตือนด้วย Cloud Messaging

• ค้นหาว่าเมื่อใดและเพราะเหตุใดแอปของคุณจึงหยุดทำงานด้วย Crashlytics