ข้อกำหนดเบื้องต้น
ติดตั้งสิ่งต่อไปนี้:
- Xcode 13.3.1 หรือใหม่กว่า
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
- iOS 10
- macOS 10.12
- tvOS 12
- watchOS 6
- โครงการของคุณต้องกำหนดเป้าหมายเวอร์ชันแพลตฟอร์มเหล่านี้หรือใหม่กว่า:
ตั้งค่าอุปกรณ์ Apple จริงหรือใช้เครื่องจำลองเพื่อเรียกใช้แอปของคุณ
สำหรับ Cloud Messaging บนแพลตฟอร์ม Apple มีข้อกำหนดเบื้องต้นดังต่อไปนี้:
- ตั้งค่า อุปกรณ์ Apple จริง
- รับ Apple Push Notification Authentication Key สำหรับ บัญชีนักพัฒนา Apple ของคุณ
- เปิดใช้งาน Push Notifications ใน Xcode ภายใต้ App > Capabilities
- ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ
หากคุณยังไม่มีโปรเจ็กต์ Xcode และต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่าง การเริ่มต้นอย่างรวดเร็วของเรา
ขั้นตอนที่ 1 : สร้างโปรเจ็กต์ Firebase
ก่อนที่คุณจะเพิ่ม Firebase ลงในแอป Apple ได้ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับแอปของคุณ ไปที่ ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase
ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณด้วย Firebase
หากต้องการใช้ Firebase ในแอป Apple คุณต้องลงทะเบียนแอปกับโปรเจ็กต์ Firebase การลงทะเบียนแอพของคุณมักจะเรียกว่า "การเพิ่ม" แอพของคุณในโครงการของคุณ
ไปที่ คอนโซล Firebase
ที่ตรงกลางหน้าภาพรวมโครงการ ให้คลิกไอคอน iOS+ เพื่อเปิดเวิร์กโฟลว์การตั้งค่า
หากคุณได้เพิ่มแอปลงในโปรเจ็กต์ Firebase แล้ว ให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสชุดของแอปในช่อง รหัสชุด ข้อมูล
รหัสชุดข้อมูล ระบุแอปพลิเคชันในระบบนิเวศของ Apple โดยไม่ซ้ำกัน
ค้นหารหัสบันเดิลของคุณ: เปิดโปรเจ็กต์ของคุณใน Xcode เลือกแอประดับบนสุดในตัวนำทางโปรเจ็กต์ จากนั้นเลือกแท็บ ทั่วไป
ค่าของฟิลด์ Bundle Identifier คือ ID บันเดิล (เช่น
com.yourcompany.yourproject
)โปรดทราบว่าค่ารหัสชุดจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase นี้หลังจากที่ลงทะเบียนกับโปรเจ็กต์ Firebase แล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่นๆ: ชื่อเล่น แอป และ ID App Store
ชื่อเล่นของแอป : ตัวระบุความสะดวกภายในที่มีคุณเท่านั้นที่เห็นในคอนโซล Firebase
รหัส App Store : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store ของคุณ และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion เข้าสู่ Google Ads หากแอปของคุณยังไม่มี App Store ID คุณสามารถเพิ่ม ID ได้ในภายหลังใน การตั้งค่าโครงการ ของคุณ
คลิก ลงทะเบียนแอป
ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase
คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่าแพลตฟอร์ม Firebase Apple ของคุณ (
GoogleService-Info.plist
)ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำแต่ไม่เป็นความลับสำหรับโปรเจ็กต์ของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่านี้ ให้ไปที่ ทำความเข้าใจโปรเจ็กต์ Firebase
คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
ตรวจสอบให้แน่ใจว่าชื่อไฟล์ปรับแต่งไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น
(2)
ย้ายไฟล์ปรับแต่งของคุณไปที่รูทของโปรเจ็กต์ Xcode หากได้รับแจ้ง ให้เลือกเพื่อเพิ่มไฟล์กำหนดค่าไปยังเป้าหมายทั้งหมด
หากคุณมี Bundle ID หลายรายการในโปรเจ็กต์ของคุณ คุณต้องเชื่อมโยงแต่ละ ID บันเดิลกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปสามารถมีไฟล์ GoogleService-Info.plist
ของตัวเองได้
ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ลงในแอปของคุณ
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา Firebase
- ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
- เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Firebase Apple:
- เลือกเวอร์ชัน SDK ที่คุณต้องการใช้
เลือกไลบรารี Firebase ที่คุณต้องการใช้
หากเปิดใช้ Google Analytics ในโครงการ Firebase อย่าลืมเพิ่ม
FirebaseAnalytics
สำหรับ Analytics ที่ไม่มีความสามารถในการรวบรวม IDFA ให้เพิ่มFirebaseAnalyticsWithoutAdId
แทน
https://github.com/firebase/firebase-ios-sdk
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการพึ่งพาของคุณในพื้นหลังโดยอัตโนมัติ
ขั้นตอนที่ 5 : เริ่มต้น Firebase ในแอปของคุณ
ขั้นตอนสุดท้ายคือการเพิ่มรหัสเริ่มต้นให้กับแอปพลิเคชันของคุณ คุณอาจทำสิ่งนี้ไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ในแอปของคุณ หากคุณกำลังใช้ โครงการตัวอย่าง Quickstart สิ่งนี้ทำเพื่อคุณ
- นำเข้าโมดูล
FirebaseCore
ในUIApplicationDelegate
ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่ผู้รับมอบสิทธิ์แอปของคุณใช้ ตัวอย่างเช่น ในการใช้ Cloud Firestore และการตรวจสอบสิทธิ์:Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
วัตถุประสงค์-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ
FirebaseApp
โดยทั่วไปในเครื่องมือเริ่มต้นของApp
ปหรือวิธีการของapplication(_:didFinishLaunchingWithOptions:)
ของแอปหรือผู้รับมอบสิทธิ์แอป:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
วัตถุประสงค์-C
// Use Firebase library to configure APIs [FIRApp configure];
- หากคุณรวม 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 | |
Crashlytics | pod 'FirebaseCrashlytics' | FirebaseCrashlytics | |
ลิงก์แบบไดนามิก | pod 'FirebaseDynamicLinks' | FirebaseDynamicLinks | |
การส่งข้อความในแอป | pod 'FirebaseInAppMessaging' | FirebaseInAppMessaging | (ที่จำเป็น) |
การติดตั้ง Firebase | pod 'FirebaseInstallations' | FirebaseInstallations | |
Firebase ML Custom Model APIs | pod 'FirebaseMLModelDownloader' | FirebaseMLModelDownloader | |
การตรวจสอบประสิทธิภาพ | pod 'FirebasePerformance' | FirebasePerformance | |
ฐานข้อมูลเรียลไทม์ | pod 'FirebaseDatabase' | FirebaseDatabase | |
การกำหนดค่าระยะไกล | pod 'FirebaseRemoteConfig' | FirebaseRemoteConfig |
บูรณาการโดยไม่ต้องใช้ Swift Package Manager
หากคุณไม่ต้องการใช้ Swift Package Manager คุณยังสามารถใช้ประโยชน์จาก Firebase SDK ได้โดยใช้ CocoaPods หรือนำเข้าเฟรมเวิร์กโดยตรง
CocoaPods
เรียนรู้เพิ่มเติมเกี่ยวกับการรวม CocoaPods ใน คู่มือของเรา
กรอบงาน
นอกจากการรองรับแพลตฟอร์ม iOS แล้ว ไฟล์ zip ยังรวมไฟล์ . .xcframework
ด้วย สำหรับรายละเอียด โปรดดู ที่แพลตฟอร์ม Firebase Apple SDK README บน GitHub
ดาวน์โหลด zip เฟรมเวิร์ก SDK ไฟล์นี้เป็นไฟล์ขนาดประมาณ 200MB และอาจใช้เวลาในการดาวน์โหลดสักครู่
แตกไฟล์ จากนั้นตรวจสอบ
README
สำหรับกรอบงานที่คุณต้องการรวมไว้ในแอพของคุณเพิ่ม แฟล็กตัวเชื่อมโยง
-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 เมื่อใดและเพราะเหตุใด