ข้อกำหนดเบื้องต้น
ติดตั้งรายการต่อไปนี้
- Xcode 15.2 ขึ้นไป
ตรวจสอบว่าโปรเจ็กต์เป็นไปตามข้อกำหนดต่อไปนี้
- โปรเจ็กต์ต้องกำหนดเป้าหมายเป็นแพลตฟอร์มเวอร์ชันต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- โปรเจ็กต์ต้องกำหนดเป้าหมายเป็นแพลตฟอร์มเวอร์ชันต่อไปนี้หรือเวอร์ชันที่ใหม่กว่า
ตั้งค่าอุปกรณ์ Apple จริงหรือใช้เครื่องจำลองเพื่อเรียกใช้แอป
คุณต้องการใช้ Cloud Messaging ไหม
ข้อกําหนดเบื้องต้นสําหรับ Cloud Messaging ในแพลตฟอร์ม Apple มีดังนี้
- ตั้งค่าอุปกรณ์ Apple จริง
- รับคีย์การตรวจสอบสิทธิ์ข้อความ Push ของ Apple สำหรับบัญชีนักพัฒนาแอป Apple
- เปิดใช้ข้อความ Push ใน Xcode ในส่วนแอป > ความสามารถ
- ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google
หากยังไม่มีโปรเจ็กต์ Xcode และต้องการลองใช้ผลิตภัณฑ์ Firebase เพียงอย่างเดียว คุณสามารถดาวน์โหลดตัวอย่างการเริ่มต้นใช้งานอย่างรวดเร็วของเรา
ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase
คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอปก่อนจึงจะเพิ่ม Firebase ในแอป Apple ได้ โปรดไปที่ทําความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase
สร้างโปรเจ็กต์ Firebase
-
ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์
-
หากต้องการเพิ่มทรัพยากร Firebase ลงในโปรเจ็กต์ Google Cloud ที่มีอยู่ ให้ป้อนชื่อโปรเจ็กต์หรือเลือกจากเมนูแบบเลื่อนลง
-
หากต้องการสร้างโปรเจ็กต์ใหม่ ให้ป้อนชื่อโปรเจ็กต์ที่ต้องการ นอกจากนี้ คุณยังแก้ไขรหัสโปรเจ็กต์ที่แสดงใต้ชื่อโปรเจ็กต์ได้ด้วย
-
-
เมื่อได้รับข้อความแจ้ง ให้อ่านและยอมรับข้อกำหนดของ Firebase
-
คลิกต่อไป
-
(ไม่บังคับ) ตั้งค่า Google Analytics สําหรับโปรเจ็กต์ ซึ่งจะช่วยให้คุณได้รับประสบการณ์การใช้งานผลิตภัณฑ์ Firebase ต่อไปนี้อย่างเต็มประสิทธิภาพ
เลือกบัญชี Google Analytics ที่มีอยู่หรือสร้างบัญชีใหม่
หากคุณสร้างบัญชีใหม่ ให้เลือกตำแหน่งการรายงาน Analytics แล้วยอมรับการตั้งค่าการแชร์ข้อมูลและข้อกำหนด Google Analytics สำหรับโปรเจ็กต์
-
คลิกสร้างโปรเจ็กต์ (หรือเพิ่ม Firebase หากคุณใช้โปรเจ็กต์ Google Cloud ที่มีอยู่)
Firebase จะจัดสรรทรัพยากรสําหรับโปรเจ็กต์ Firebase โดยอัตโนมัติ เมื่อดำเนินการเสร็จแล้ว ระบบจะนำคุณไปยังหน้าภาพรวมของโปรเจ็กต์ Firebase ในคอนโซล Firebase
ขั้นตอนที่ 2: ลงทะเบียนแอปกับ Firebase
หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปลงในโปรเจ็กต์
ไปที่คอนโซล Firebase
คลิกไอคอน iOS+ ตรงกลางหน้าภาพรวมโปรเจ็กต์เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
หากเพิ่มแอปลงในโปรเจ็กต์ Firebase อยู่แล้ว ให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสกลุ่มของแอปในช่องรหัสกลุ่ม
รหัสกลุ่มคืออะไรและดูได้จากที่ใด
รหัสชุดเป็นตัวระบุที่ไม่ซ้ำสำหรับแอปพลิเคชันในระบบนิเวศของ Apple
ค้นหารหัสชุด: เปิดโปรเจ็กต์ใน Xcode เลือกแอประดับบนสุดในเครื่องมือนำทางโปรเจ็กต์ แล้วเลือกแท็บทั่วไป
ค่าของช่องตัวระบุกลุ่มคือรหัสกลุ่ม (เช่น
com.yourcompany.yourproject
)โปรดทราบว่าระบบจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ในค่ารหัสกลุ่ม และคุณจะเปลี่ยนค่านี้สำหรับแอป Firebase นี้ไม่ได้หลังจากที่ลงทะเบียนกับโปรเจ็กต์ Firebase แล้ว
(ไม่บังคับ) ป้อนข้อมูลอื่นๆ ของแอป ได้แก่ ชื่อเล่นของแอปและ App Store ID
ชื่อเล่นของแอปและรหัส App Store ใช้ภายใน Firebase อย่างไร
ชื่อเล่นของแอป: ตัวระบุภายในเพื่อความสะดวกที่คุณจะมองเห็นได้เฉพาะในคอนโซล Firebase
รหัส App Store: Firebase Dynamic Links ใช้เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store และ Google Analytics ใช้เพื่อนําเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสภายหลังได้ในส่วนการตั้งค่าโครงการ
คลิกลงทะเบียนแอป
ขั้นตอนที่ 3: เพิ่มไฟล์กําหนดค่า Firebase
คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์การกําหนดค่าแพลตฟอร์ม Apple ของ Firebase (
GoogleService-Info.plist
)สิ่งที่คุณจำเป็นต้องทราบเกี่ยวกับไฟล์การกําหนดค่านี้
ไฟล์การกําหนดค่า Firebase จะมีตัวระบุที่ไม่ซ้ำกันและไม่เป็นความลับสําหรับโปรเจ็กต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์การกําหนดค่านี้ได้ที่หัวข้อทําความเข้าใจโปรเจ็กต์ Firebase
คุณดาวน์โหลดไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
โปรดตรวจสอบว่าชื่อไฟล์การกําหนดค่าไม่มีอักขระต่อท้ายเกิน เช่น
(2)
ย้ายไฟล์การกําหนดค่าไปยังรูทของโปรเจ็กต์ Xcode หากได้รับข้อความแจ้ง ให้เลือกเพิ่มไฟล์กำหนดค่าลงในเป้าหมายทั้งหมด
หากมีรหัสกลุ่มหลายรายการในโปรเจ็กต์ คุณต้องเชื่อมโยงรหัสกลุ่มแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist
เป็นของตัวเอง
ขั้นตอนที่ 4: เพิ่ม Firebase SDK ลงในแอป
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase
- เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
- เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase SDK สำหรับแพลตฟอร์ม 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 ให้ทำดังนี้import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- กำหนดค่าอินสแตนซ์ที่แชร์ในเมธอด
application(_:didFinishLaunchingWithOptions:)
ของตัวแทนแอป ดังนี้FirebaseApp
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs [FIRApp configure];
- หากใช้ SwiftUI คุณต้องสร้างผู้รับมอบสิทธิ์แอปพลิเคชันและแนบไปกับ
App
struct ผ่านUIApplicationDelegateAdaptor
หรือNSApplicationDelegateAdaptor
นอกจากนี้ คุณยังต้องปิดใช้การสลับผู้รับมอบสิทธิ์แอปด้วย ดูข้อมูลเพิ่มเติมได้ที่วิธีการ SwiftUI@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 ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารีแพลตฟอร์ม Apple ของ Firebase
ที่เก็บ GitHub ของ Firebase Apple Platforms SDK
บริการหรือผลิตภัณฑ์ | พ็อด | คลัง SwiftPM | Google Analytics">เพิ่ม Analytics |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
ไม่มี | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(ต้องระบุ) |
Firebase การติดตั้ง | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML Custom Model API | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
ผสานรวมโดยไม่ใช้ Swift Package Manager
หากไม่ต้องการใช้ Swift Package Manager คุณยังคงใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือนําเข้าเฟรมเวิร์กโดยตรง
CocoaPods
ดูข้อมูลเพิ่มเติมเกี่ยวกับการผสานรวม CocoaPods ในคู่มือของเรา
เฟรมเวิร์ก
นอกจากรองรับแพลตฟอร์ม iOS แล้ว ตอนนี้ไฟล์ ZIP ยังมี.xcframework
ไฟล์ด้วย โปรดดูรายละเอียดที่README ของ Firebase SDK สำหรับแพลตฟอร์ม Apple ใน GitHub
ดาวน์โหลด framework SDK zip ไฟล์นี้มีขนาดใหญ่ประมาณ 200 MB และอาจใช้เวลาสักครู่ในการดาวน์โหลด
แตกไฟล์ แล้วผสานรวมเฟรมเวิร์กที่ต้องการรวมไว้ในแอป
คุณดูวิธีการผสานรวมได้จากที่ใดที่หนึ่งต่อไปนี้
- ในที่เก็บ GitHub ของ Firebase iOS SDK
- ในไฟล์
README.md
ภายในไฟล์ ZIP ที่ดาวน์โหลด
ดูข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือข้อกำหนดเบื้องต้นได้ที่ไฟล์
METADATA.md
ในไฟล์ ZIP ที่ดาวน์โหลดเพิ่ม
-ObjC
Flag ของ linker ในOther Linker Settings
ในการตั้งค่าการสร้างของเป้าหมาย
ขั้นตอนถัดไป
ดูข้อมูลเกี่ยวกับ Firebase
ไปที่ทําความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase และแนวทางปฏิบัติแนะนําสําหรับโปรเจ็กต์
รับประสบการณ์การใช้งานจริงจาก Firebase iOS Codelab
เตรียมเปิดตัวแอป
- ตั้งค่าการแจ้งเตือนเกี่ยวกับงบประมาณสำหรับโปรเจ็กต์ในคอนโซล Google Cloud
- ตรวจสอบแดชบอร์ดการใช้งานและการเรียกเก็บเงินในคอนโซล Firebase เพื่อดูภาพรวมการใช้งานโปรเจ็กต์ในบริการ Firebase หลายรายการ
- ตรวจสอบรายการตรวจสอบการเปิดตัว Firebase
หากพบปัญหาเกี่ยวกับ Firebase และโปรเจ็กต์ Apple ไปที่การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์ม Apple
เพิ่มบริการ Firebase ลงในแอป
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics
ตั้งค่าการตรวจสอบสิทธิ์ของผู้ใช้ด้วย Authentication
จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database
จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอ ด้วย Cloud Storage
ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions
ส่งการแจ้งเตือนด้วย Cloud Messaging
ดูว่าแอปขัดข้องเมื่อใดและสาเหตุที่ขัดข้องด้วย Crashlytics