ข้อกำหนดเบื้องต้น
ติดตั้งสิ่งต่อไปนี้
- Xcode 16.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 ลงในแอป Apple ได้ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอปของคุณ ไปที่ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase
สร้างโปรเจ็กต์ Firebase
-
ในFirebase คอนโซล ให้คลิกเพิ่มโปรเจ็กต์
-
หากต้องการเพิ่มทรัพยากร Firebase ลงในโปรเจ็กต์ที่มีอยู่ Google Cloud ให้ป้อนชื่อโปรเจ็กต์หรือเลือกจากเมนูแบบเลื่อนลง
-
หากต้องการสร้างโปรเจ็กต์ใหม่ ให้ป้อนชื่อโปรเจ็กต์ นอกจากนี้ คุณยัง เลือกแก้ไขรหัสโปรเจ็กต์ที่แสดงใต้ชื่อโปรเจ็กต์ได้ด้วย
-
-
หากได้รับแจ้ง ให้อ่านและยอมรับข้อกำหนดของ Firebase
-
คลิกต่อไป
-
(ไม่บังคับ) ตั้งค่า Google Analytics สำหรับโปรเจ็กต์ ซึ่งจะ ช่วยให้ได้รับประสบการณ์การใช้งานที่ดียิ่งขึ้นเมื่อใช้ผลิตภัณฑ์ Firebase ต่อไปนี้ Firebase A/B Testing Cloud Messaging Crashlytics In-App Messaging และ Remote Config (รวมถึงการปรับเปลี่ยนในแบบของคุณ)
เลือกบัญชี Google Analytics ที่มีอยู่ หรือสร้างบัญชีใหม่ หากสร้างบัญชีใหม่ ให้เลือกAnalyticsสถานที่ตั้งการรายงาน จากนั้นยอมรับการตั้งค่าการแชร์ข้อมูลและGoogle Analyticsข้อกำหนดสำหรับ โปรเจ็กต์
-
คลิกสร้างโปรเจ็กต์ (หรือเพิ่ม Firebase หากคุณเพิ่ม Firebase ไปยังโปรเจ็กต์ Google Cloud ที่มีอยู่)
Firebase จะจัดสรรทรัพยากรสำหรับโปรเจ็กต์ Firebase โดยอัตโนมัติ เมื่อ กระบวนการเสร็จสมบูรณ์ ระบบจะนำคุณไปยังหน้าภาพรวมของโปรเจ็กต์ Firebase ในFirebaseคอนโซล
ขั้นตอนที่ 2: ลงทะเบียนแอปกับ Firebase
หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปไปยังโปรเจ็กต์
ไปที่คอนโซล Firebase
ที่กึ่งกลางหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
หากเพิ่มแอปไปยังโปรเจ็กต์ Firebase แล้ว ให้คลิกเพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสชุดของแอปในช่องรหัสชุด
รหัสชุดคืออะไรและดูได้จากที่ใด
รหัสชุด ระบุแอปพลิเคชันในระบบนิเวศของ Apple ได้อย่างไม่ซ้ำกัน
ค้นหารหัสชุดซอฟต์แวร์: เปิดโปรเจ็กต์ใน Xcode เลือกแอป ระดับบนสุดในแถบนำทางโปรเจ็กต์ แล้วเลือกแท็บทั่วไป
ค่าของช่องตัวระบุชุดคือรหัสชุด (เช่น
com.yourcompany.yourproject
)โปรดทราบว่าค่า Bundle ID จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่สามารถ เปลี่ยนแปลงสำหรับแอป Firebase นี้ได้หลังจากลงทะเบียนกับ โปรเจ็กต์ Firebase แล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ ดังนี้ ชื่อเล่นของแอปและรหัส App Store
Firebase ใช้ชื่อเล่นของแอปและรหัส App Store อย่างไร
ชื่อเล่นของแอป: ตัวระบุภายในที่สะดวกซึ่งคุณจะเห็นได้ในFirebase Console เท่านั้น
รหัส App Store: ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store ของคุณ และใช้โดย Google Analytics เพื่อ นําเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสได้ในภายหลัง ในการตั้งค่าโปรเจ็กต์
คลิกลงทะเบียนแอป
ขั้นตอนที่ 3: เพิ่มไฟล์กำหนดค่า Firebase
คลิกดาวน์โหลด GoogleService-Info.plist เพื่อรับ ไฟล์กำหนดค่า Firebase (
GoogleService-Info.plist
) ของแอปคุณควรรู้อะไรบ้างเกี่ยวกับไฟล์การกำหนดค่านี้
ไฟล์การกำหนดค่า Firebase จะมีตัวระบุที่ไม่ซ้ำกันและไม่เป็นความลับสำหรับ โปรเจ็กต์และแอปของคุณ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่านี้ โปรดไปที่ทำความเข้าใจโปรเจ็กต์ Firebase
คุณดาวน์โหลดไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
โปรดตรวจสอบว่าชื่อไฟล์การกำหนดค่าไม่มีอักขระต่อท้ายเพิ่มเติม เช่น
(2)
ย้ายไฟล์การกำหนดค่าไปยังรูทของโปรเจ็กต์ Xcode หากได้รับแจ้ง ให้เลือกเพิ่มไฟล์กำหนดค่าไปยังเป้าหมายทั้งหมด
หากมี Bundle ID หลายรายการในโปรเจ็กต์ คุณต้องเชื่อมโยง Bundle ID แต่ละรายการกับแอปที่ลงทะเบียนไว้ในFirebase Console เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist
ของตัวเองได้
ขั้นตอนที่ 4: เพิ่ม Firebase SDK ลงในแอป
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase
- เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่File > Add Packages
- เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Apple ของ Firebase ดังนี้
- เลือกเวอร์ชัน SDK ที่ต้องการใช้
เลือกไลบรารี Firebase ที่ต้องการใช้
หากเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase โปรดตรวจสอบ ว่าได้เพิ่ม
FirebaseAnalytics
แล้ว ซึ่งจะให้ฟีเจอร์การวิเคราะห์ทั้งหมด นอกจากนี้ คุณยังเลือกฟีเจอร์แต่ละรายการได้ด้วย โปรดดูคำถามที่พบบ่อยเกี่ยวกับการจัดระเบียบโมดูลล่าสุดใน Google Analytics สำหรับ Firebase SDK
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; // ...
- กำหนดค่า
FirebaseApp
อินสแตนซ์ที่แชร์ใน เมธอดapplication(_:didFinishLaunchingWithOptions:)
ของตัวแทนแอป// 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
ผ่าน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 เหล่านี้
Firebase Apple platforms SDK ที่เก็บ GitHub
บริการหรือผลิตภัณฑ์ | พ็อด | ไลบรารี SwiftPM | เพิ่ม Analytics ไหม |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
ไม่มี | |
Firebase AI Logic 1 |
pod 'FirebaseAI' |
FirebaseAI |
|
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 |
|
Data Connect | ไม่มี | FirebaseDataConnect |
|
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 |
1 ก่อนหน้านี้ Firebase AI Logic มีชื่อว่า
"Vertex AI in Firebase" โดยมีพ็อด pod 'FirebaseVertexAI'
และ
SwiftPM Library FirebaseVertexAI
ผสานรวมโดยไม่ต้องใช้ Swift Package Manager
หากไม่ต้องการใช้ Swift Package Manager คุณยังคงใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือนำเข้าเฟรมเวิร์กโดยตรง
CocoaPods
ดูข้อมูลเพิ่มเติมเกี่ยวกับการผสานรวม CocoaPods ได้ในคำแนะนำ
เฟรมเวิร์ก
นอกจากจะรองรับแพลตฟอร์ม iOS แล้ว ตอนนี้ไฟล์ ZIP ยังมี.xcframework
ไฟล์ด้วย โปรดดูรายละเอียดที่ README ของ Firebase
Apple platforms SDK ใน
GitHub
ดาวน์โหลด SDK zip ของเฟรมเวิร์ก ไฟล์นี้มีขนาดประมาณ 200 MB และอาจใช้เวลา สักครู่ในการดาวน์โหลด
แตกไฟล์ แล้วผสานรวมเฟรมเวิร์กที่ต้องการรวมไว้ในแอป
คุณดูวิธีการผสานรวมได้จากที่ใดที่หนึ่งต่อไปนี้
- ในที่เก็บ Firebase iOS SDK บน GitHub
- ในไฟล์
README.md
ภายในไฟล์ ZIP ที่ดาวน์โหลด
ดูข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือการอ้างอิงได้ในไฟล์
METADATA.md
ภายในไฟล์ ZIP ที่ดาวน์โหลดมาเพิ่ม
-ObjC
แฟล็กตัวลิงก์ ในOther Linker Settings
ในการตั้งค่าบิลด์ของเป้าหมาย
ขั้นตอนถัดไป
ดูข้อมูลเกี่ยวกับ Firebase
ไปที่ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อดูข้อมูลเพิ่มเติม เกี่ยวกับโปรเจ็กต์ Firebase และแนวทางปฏิบัติแนะนำสำหรับโปรเจ็กต์
รับประสบการณ์การใช้งานจริงด้วย Codelab ของ Firebase iOS
เตรียมพร้อมเปิดตัวแอป
- ตั้งค่าการแจ้งเตือน งบประมาณ สำหรับโปรเจ็กต์ในGoogle Cloudคอนโซล
- ตรวจสอบแดชบอร์ดการใช้งานและการเรียกเก็บเงินในFirebaseคอนโซลเพื่อดูภาพรวมการใช้งานของโปรเจ็กต์ในบริการ Firebase หลายรายการ
- ตรวจสอบรายการตรวจสอบการเปิดตัว Firebase
หากมีปัญหาเกี่ยวกับ Firebase และโปรเจ็กต์ Apple ไปที่การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับแพลตฟอร์มของ Apple
เพิ่มบริการ Firebase ไปยังแอป
สร้างฟีเจอร์ Generative AI ด้วยโมเดล Gemini และ Imagen โดยใช้ Firebase AI Logic
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics
ตั้งค่าการตรวจสอบสิทธิ์ของผู้ใช้ด้วย Authentication
จัดเก็บข้อมูล เช่น ข้อมูลผู้ใช้ ด้วย Cloud Firestore หรือ Realtime Database
จัดเก็บไฟล์ เช่น รูปภาพและวิดีโอ ด้วย Cloud Storage
ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions
ส่งการแจ้งเตือนด้วย Cloud Messaging
ดูว่าแอปขัดข้องเมื่อใดและเพราะเหตุใดด้วย Crashlytics