ข้อกำหนดเบื้องต้น
ติดตั้งสิ่งต่อไปนี้:
- Xcode 14.1 หรือใหม่กว่า
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
- iOS 11
- แมคโอเอส 10.13
- tvOS 12
- วอทช์โอเอส 6
- โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
ตั้งค่าอุปกรณ์ Apple จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอพของคุณ
สำหรับ Cloud Messaging บนแพลตฟอร์ม Apple สิ่งที่จำเป็นต้องมีมีดังนี้
- ตั้งค่า อุปกรณ์ Apple จริง
- รับรหัสการตรวจสอบสิทธิ์การแจ้งเตือนแบบพุชของ Apple สำหรับ บัญชีนักพัฒนา Apple ของคุณ
- เปิดใช้งานการแจ้งเตือนแบบพุชใน Xcode ภายใต้ App > Capabilities
- ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ
หากคุณยังไม่มีโครงการ Xcode และเพียงต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่างการเริ่มต้นอย่างรวดเร็ว ของเรา
ขั้นตอนที่ 1 : สร้างโครงการ Firebase
ก่อนที่คุณจะเพิ่ม Firebase ลงในแอป Apple คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอปของคุณ ไปที่ ทำความเข้าใจโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase
ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณกับ Firebase
หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอปมักเรียกว่า "การเพิ่ม" แอปของคุณในโครงการ
ไปที่ คอนโซล Firebase
ที่กึ่งกลางของหน้าภาพรวมโครงการ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
หากคุณเพิ่มแอปในโครงการ Firebase แล้ว ให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสชุดของแอปในช่อง รหัสชุด
รหัสบันเดิล จะระบุแอปพลิเคชันในระบบนิเวศของ Apple โดยไม่ซ้ำกัน
ค้นหา Bundle ID ของคุณ: เปิดโปรเจ็กต์ของคุณใน Xcode เลือกแอประดับบนสุดในเนวิเกเตอร์โปรเจ็กต์ จากนั้นเลือกแท็บ ทั่วไป
ค่าของฟิลด์ Bundle Identifier คือรหัสบันเดิล (เช่น
com.yourcompany.yourproject
)โปรดทราบว่าค่า Bundle ID คำนึงถึงขนาดตัวพิมพ์ และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase นี้หลังจากลงทะเบียนกับโปรเจ็กต์ Firebase ของคุณแล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่นแอป และ App Store ID
ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase
App Store ID : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปของคุณยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสในภายหลังได้ใน การตั้งค่าโครงการ
คลิก ลงทะเบียนแอป
ขั้นตอนที่ 3 : เพิ่มไฟล์กำหนดค่า Firebase
คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่าแพลตฟอร์ม Firebase Apple (
GoogleService-Info.plist
)ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำใครแต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่านี้ โปรดไป ที่ ทำความเข้าใจโครงการ Firebase
คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
ตรวจสอบให้แน่ใจว่าชื่อไฟล์ config ไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น
(2)
ย้ายไฟล์กำหนดค่าของคุณไปที่รูทของโปรเจ็กต์ Xcode หากได้รับแจ้ง ให้เลือกเพื่อเพิ่มไฟล์กำหนดค่าไปยังเป้าหมายทั้งหมด
หากคุณมีรหัสกลุ่มหลายรหัสในโครงการ คุณต้องเชื่อมโยงรหัสกลุ่มแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist
ของตัวเอง
ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ในแอปของคุณ
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการอ้างอิง Firebase
- ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
- เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:
- เลือกเวอร์ชัน SDK ที่คุณต้องการใช้
เลือกไลบรารี Firebase ที่คุณต้องการใช้
หากเปิดใช้ Google Analytics ในโครงการ Firebase อย่าลืมเพิ่ม
FirebaseAnalytics
สำหรับ Analytics ที่ไม่มีความสามารถในการรวบรวม IDFA ให้เพิ่มFirebaseAnalyticsWithoutAdId
แทน
https://github.com/firebase/firebase-ios-sdk
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง
ขั้นตอนที่ 5 : เริ่มต้น Firebase ในแอปของคุณ
ขั้นตอนสุดท้ายคือการเพิ่มรหัสเริ่มต้นให้กับแอปพลิเคชันของคุณ คุณอาจทำสิ่งนี้ไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ในแอปของคุณ หากคุณกำลังใช้ โครงการตัวอย่างเริ่มต้นอย่างรวดเร็ว สิ่งนี้ได้ดำเนินการให้คุณแล้ว
- นำเข้าโมดูล
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; // ...
- กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ
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];
- หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง
App
ของคุณผ่านUIApplicationDelegateAdaptor
หรือNSApplicationDelegateAdaptor
คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ 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 เหล่านี้:
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
ดาวน์โหลด เฟรมเวิร์ก SDK zip นี่เป็นไฟล์ประมาณ 200MB และอาจใช้เวลาสักครู่ในการดาวน์โหลด
เปิดเครื่องรูดไฟล์ จากนั้นรวมเฟรมเวิร์กที่คุณต้องการรวมไว้ในแอปของคุณ
คุณสามารถดูคำแนะนำในการรวมได้จากที่ใดที่หนึ่งต่อไปนี้:
- ใน ที่เก็บ Firebase iOS SDK GitHub
- ในไฟล์
README.md
ภายในไฟล์ zip ที่ดาวน์โหลดมา
สำหรับข้อมูลเกี่ยวกับเวอร์ชันเฟรมเวิร์กหรือการขึ้นต่อกัน โปรดดูที่ไฟล์
METADATA.md
ภายในไฟล์ zip ที่ดาวน์โหลดมาเพิ่ม แฟล็กตัวเชื่อมโยง
-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