สิ่งที่ต้องดำเนินการก่อน
ติดตั้งสิ่งต่อไปนี้
- Xcode 14.1 ขึ้นไป
ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดต่อไปนี้
- โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
- iOS 11
- macOS 10.13
- TVOS 12
- WatchOS 6
- โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
ตั้งค่าอุปกรณ์ Apple ที่จับต้องได้หรือใช้เครื่องจำลองในการเรียกใช้แอป
- ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google
หากยังไม่มีโปรเจ็กต์ Xcode และแค่อยากลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดตัวอย่างการเริ่มต้นอย่างรวดเร็วของเรา
ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase
ก่อนที่จะเพิ่ม Firebase ในแอป Apple ได้ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอป โปรดไปที่ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase
ขั้นตอนที่ 2: ลงทะเบียนแอปกับ Firebase
หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปลงในโปรเจ็กต์
ไปที่คอนโซล Firebase
ที่ตรงกลางของหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
หากคุณเพิ่มแอปลงในโปรเจ็กต์ Firebase แล้ว ให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสชุดของแอปในช่องรหัสแพ็กเกจ
(ไม่บังคับ) ป้อนข้อมูลอื่นๆ ของแอป ได้แก่ ชื่อเล่นแอปและรหัส App Store
คลิกลงทะเบียนแอป
ขั้นตอนที่ 3: เพิ่มไฟล์การกำหนดค่า Firebase
คลิก Download GoogleService-Info.plist เพื่อรับไฟล์การกำหนดค่าแพลตฟอร์ม Firebase Apple (
GoogleService-Info.plist
)ย้ายไฟล์การกำหนดค่าไปยังรูทของโปรเจ็กต์ Xcode หากได้รับข้อความแจ้ง ให้เลือกเพิ่มไฟล์การกำหนดค่าให้เป้าหมายทั้งหมด
หากมีรหัสชุดหลายรายการในโปรเจ็กต์ คุณต้องเชื่อมโยงรหัสชุดแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist
ของตัวเองได้
ขั้นตอนที่ 4: เพิ่ม Firebase SDK ลงในแอป
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase
- เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
- เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK สำหรับแพลตฟอร์ม Firebase ของ Apple ดังนี้
- เลือกเวอร์ชัน SDK ที่ต้องการใช้
เลือกไลบรารี Firebase ที่ต้องการใช้
หากเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase อย่าลืมเพิ่ม
FirebaseAnalytics
สำหรับ Analytics ที่ไม่สามารถรวบรวม IDFA ได้ ให้เพิ่มFirebaseAnalyticsWithoutAdId
แทน
https://github.com/firebase/firebase-ios-sdk
เมื่อเสร็จสิ้นแล้ว Xcode จะเริ่มแก้ปัญหาและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ
ขั้นตอนที่ 5: เริ่มต้น Firebase ในแอป
ขั้นตอนสุดท้ายคือเพิ่มโค้ดการเริ่มต้นลงในแอปพลิเคชัน คุณอาจดำเนินการนี้ไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ลงในแอป แต่หากคุณใช้ โปรเจ็กต์ตัวอย่างการเริ่มต้นอย่างรวดเร็ว ระบบจะดำเนินการให้คุณ
- นำเข้าโมดูล
FirebaseCore
ในUIApplicationDelegate
รวมถึงโมดูล Firebase อื่นๆ ที่ผู้รับมอบสิทธิ์แอปใช้ เช่น วิธีใช้ Cloud Firestore และ Authentication มีดังนี้SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- กำหนดค่าอินสแตนซ์ที่แชร์ของ
FirebaseApp
ในเมธอดapplication(_:didFinishLaunchingWithOptions:)
ของตัวแทนแอป ดังนี้SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- หากใช้ SwiftUI คุณต้องสร้างการมอบสิทธิ์แอปพลิเคชันและแนบการมอบสิทธิ์กับโครงสร้าง
App
ผ่านUIApplicationDelegateAdaptor
หรือNSApplicationDelegateAdaptor
คุณต้องปิดใช้ SWizzing ที่มอบสิทธิ์ของแอปด้วย ดูข้อมูลเพิ่มเติมได้ที่วิธีการของ SwiftUISwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- หากรวม Firebase SDK สำหรับ Google Analytics ไว้แล้ว คุณจะเรียกใช้แอปเพื่อส่งการยืนยันไปยังคอนโซล Firebase ที่ติดตั้ง Firebase สำเร็จแล้ว
เพียงเท่านี้ก็เสร็จแล้ว! หรือข้ามไปยังขั้นตอนถัดไปได้เลย
แต่หากพบปัญหาในการตั้งค่า โปรดไปที่การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์ม Apple
ไลบรารีที่ใช้ได้
ส่วนนี้จะแสดงผลิตภัณฑ์ Firebase ที่รองรับสำหรับแพลตฟอร์ม Apple ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Firebase Apple เหล่านี้
ที่เก็บ GitHub สำหรับแพลตฟอร์ม Firebase Apple
บริการหรือผลิตภัณฑ์ | พ็อด | ไลบรารีของ SwiftPM | เพิ่ม Analytics ไหม |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
ไม่มี | |
ข้อมูลวิเคราะห์ | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
การตรวจสอบแอป | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
การแจกจ่ายแอป | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
การตรวจสอบสิทธิ์ | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
การรับส่งข้อความในระบบคลาวด์ | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
พื้นที่เก็บข้อมูลระบบคลาวด์ | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | 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 |
|
Vertex AI สำหรับ Firebase | ไม่มี | FirebaseVertexAI-Preview |
ผสานรวมโดยไม่ใช้ Swift Package Manager
หากไม่ต้องการใช้ Swift Package Manager คุณยังคงใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือนำเข้าเฟรมเวิร์กโดยตรง
CocoaPods
ดูข้อมูลเพิ่มเติมเกี่ยวกับการผสานรวม CocoaPods ในคู่มือของเรา
กรอบการทำงาน
นอกจากรองรับแพลตฟอร์ม iOS แล้ว ตอนนี้ไฟล์ ZIP จะมีไฟล์ .xcframework
ไฟล์ด้วย ดูรายละเอียดได้ที่SDK README แพลตฟอร์ม Firebase
Apple บน
GitHub
ดาวน์โหลดไฟล์ ZIP ของเฟรมเวิร์ก SDK นี่คือไฟล์ขนาดประมาณ 200 MB และอาจใช้เวลาดาวน์โหลดสักครู่
แตกไฟล์ จากนั้นผสานรวมเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอป
โดยจะดูคำแนะนำการผสานรวมได้ในที่ใดที่หนึ่งต่อไปนี้
- ในที่เก็บ Firebase iOS SDK GitHub
- ในไฟล์
README.md
ภายในการกระจาย ZIP ที่ดาวน์โหลดมา
หากต้องการข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือทรัพยากร Dependency ให้อ้างอิงไฟล์
METADATA.md
ภายในไฟล์ ZIP ที่ดาวน์โหลดมาเพิ่มแฟล็ก Linker
-ObjC
ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย
ขั้นตอนถัดไป
ดูข้อมูลเกี่ยวกับ Firebase
ไปที่ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase และแนวทางปฏิบัติแนะนำสำหรับโปรเจ็กต์
สำรวจตัวอย่างแอป Firebase
สัมผัสประสบการณ์การใช้งาน Firebase iOS Codelab โดยตรง
เตรียมเปิดตัวแอป
- ตั้งค่าการแจ้งเตือนงบประมาณสำหรับโปรเจ็กต์ในคอนโซล Google Cloud
- ตรวจสอบหน้าแดชบอร์ดการใช้งานและการเรียกเก็บเงินในคอนโซล Firebase เพื่อดูภาพรวมการใช้งานโปรเจ็กต์ในบริการต่างๆ ของ Firebase
- ดูรายการตรวจสอบการเปิดตัว Firebase
หากพบปัญหาเกี่ยวกับ Firebase และโปรเจ็กต์ Apple โปรดไปที่การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์มของ Apple
เพิ่มบริการ Firebase ลงในแอป
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics
ตั้งค่าการตรวจสอบสิทธิ์ผู้ใช้ด้วยการตรวจสอบสิทธิ์
จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือฐานข้อมูลเรียลไทม์
จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอด้วย Cloud Storage
ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions
ส่งการแจ้งเตือนด้วย Cloud Messaging
ดูเวลาและสาเหตุที่แอปขัดข้องด้วย Crashlytics