ข้อกำหนดเบื้องต้น
ติดตั้งสิ่งต่อไปนี้
- Xcode 15.2 ขึ้นไป
ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดต่อไปนี้
- โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
- iOS 13
- macOS 10.15
- TVOS 13
- WatchOS 7
- โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
ตั้งค่าอุปกรณ์ Apple ที่จับต้องได้หรือใช้เครื่องจำลองในการเรียกใช้แอป
- ลงชื่อเข้าใช้ Firebase โดยใช้ บัญชี Google
หากยังไม่มีโปรเจ็กต์ Xcode และต้องการลองใช้ Firebase คุณสามารถดาวน์โหลดตัวอย่างการเริ่มต้นอย่างรวดเร็วของเราได้
ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase
คุณต้องสร้าง Firebase ก่อนจึงจะเพิ่ม Firebase ลงในแอป Apple ได้ เพื่อเชื่อมต่อกับแอปของคุณ ไปที่เว็บไซต์ ทำความเข้าใจโปรเจ็กต์ 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
โปรดดูรายละเอียดที่ Firebase
SDK README บนแพลตฟอร์ม Apple
GitHub
ที่ใช้เวลาเพียง 2 นาที
ดาวน์โหลดไฟล์ ZIP ของเฟรมเวิร์ก SDK ไฟล์นี้มีขนาดประมาณ 200 MB และอาจใช้เวลา ในการดาวน์โหลด
แตกไฟล์ จากนั้นผสานรวมเฟรมเวิร์กที่คุณต้องการรวม ในแอปของคุณ
โดยจะดูคำแนะนำการผสานรวมได้ในที่ใดที่หนึ่งต่อไปนี้
- ใน ที่เก็บ Firebase iOS SDK GitHub
- ในไฟล์
README.md
ภายในการกระจาย ZIP ที่ดาวน์โหลดมา
สำหรับข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือทรัพยากร Dependency โปรดดู
METADATA.md
ภายในการกระจาย Zip ที่ดาวน์โหลดมาเพิ่ม
-ObjC
Linker Flag ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย
ขั้นตอนถัดไป
ดูข้อมูลเกี่ยวกับ Firebase
ไปที่ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติม เกี่ยวกับโปรเจ็กต์ Firebase และแนวทางปฏิบัติแนะนำสำหรับโปรเจ็กต์
สำรวจตัวอย่างแอป Firebase
รับประสบการณ์การใช้งาน Firebase iOS Codelab
สำรวจ โอเพนซอร์สใน GitHub
เตรียมเปิดตัวแอป
- ตั้งค่า งบประมาณ การแจ้งเตือน สำหรับโปรเจ็กต์ในคอนโซล Google Cloud
- ตรวจสอบการใช้งานและการเรียกเก็บเงิน แดชบอร์ด ในคอนโซล Firebase เพื่อดูภาพรวมของโปรเจ็กต์ ในบริการต่างๆ ของ Firebase
- ดูรายการตรวจสอบการเปิดตัว Firebase
หากพบปัญหาเกี่ยวกับ Firebase และโปรเจ็กต์ Apple ไปที่วิธีแก้ไขปัญหาเกี่ยวกับแพลตฟอร์มของ Apple และ คำถามที่พบบ่อย
เพิ่มบริการ Firebase ลงในแอป
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics
ตั้งค่าการตรวจสอบสิทธิ์ผู้ใช้ด้วยการตรวจสอบสิทธิ์
จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database
จัดเก็บไฟล์ต่างๆ เช่น รูปภาพและวิดีโอด้วย Cloud Storage
ทริกเกอร์โค้ดแบ็กเอนด์ที่ทํางานในสภาพแวดล้อมที่ปลอดภัยด้วย ฟังก์ชันระบบคลาวด์
ส่งการแจ้งเตือนด้วย Cloud Messaging
ดูว่าแอปของคุณขัดข้องเมื่อใดและเพราะเหตุใดด้วย Crashlytics