ข้อกำหนดเบื้องต้น
ติดตั้งสิ่งต่อไปนี้:
- Xcode 12.2 หรือใหม่กว่า
- CocoaPods 1.10.0 หรือใหม่กว่า
ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:
- โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเป็น iOS 10 ขึ้นไป
ตั้งค่าอุปกรณ์ iOS จริงหรือใช้โปรแกรมจำลอง iOS เพื่อเรียกใช้แอปของคุณ
สำหรับ Cloud Messaging บน iOS สิ่งที่ต้องมีมีดังต่อไปนี้:
- ตั้งค่า อุปกรณ์ iOS จริง
- รับคีย์การตรวจสอบสิทธิ์การแจ้งเตือนแบบพุชของ Apple สำหรับบัญชีนักพัฒนา Apple ของ คุณ
- เปิดใช้งานการแจ้งเตือนแบบพุชใน Xcode ภายใต้ แอพ> ความสามารถ
- ลงชื่อเข้า ใช้ Firebase โดยใช้บัญชี Google ของคุณ
หากคุณยังไม่มีโปรเจ็กต์ Xcode และเพียงแค่ต้องการทดลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่างการเริ่มต้นอย่างรวดเร็ว ของเรา
ขั้นตอนที่ 1 : สร้างโครงการ Firebase
ก่อนที่คุณจะสามารถเพิ่ม Firebase ในแอป iOS คุณต้องสร้างโครงการ Firebase เพื่อเชื่อมต่อกับแอป iOS ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase
ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณกับ Firebase
หลังจากที่คุณมีโปรเจ็กต์ Firebase คุณสามารถเพิ่มแอป iOS ของคุณลงไปได้
ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดและข้อควรพิจารณาในการเพิ่มแอปในโครงการ Firebase รวมถึงวิธีจัดการรูปแบบบิวด์หลายรายการ
ไปที่ คอนโซล Firebase
ตรงกลางหน้าภาพรวมโครงการคลิกไอคอน iOS (
) เพื่อเปิดเวิร์กโฟลว์การตั้งค่าหากคุณได้เพิ่มแอปลงในโครงการ Firebase แล้วให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม
ป้อนรหัสบันเดิลของแอปของคุณในฟิลด์ รหัสบันเดิลของ iOS
รหัสบันเดิลจะ ระบุแอปพลิเคชันโดยไม่ซ้ำกันในระบบนิเวศของ Apple
ค้นหารหัสบันเดิลของคุณ: เปิดโปรเจ็กต์ iOS ของคุณใน Xcode เลือกแอพระดับบนสุดในตัวนำทางโปรเจ็กต์จากนั้นเลือกแท็บ ทั่วไป
ค่าของช่อง Bundle Identifier คือ ID บันเดิลของ iOS (ตัวอย่างเช่น
com.yourcompany.yourproject
)โปรดทราบว่าค่ารหัสชุดเป็นแบบตรงตามตัวพิมพ์เล็กและใหญ่และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase iOS นี้หลังจากที่ลงทะเบียนกับโครงการ Firebase แล้ว
(ไม่บังคับ) ป้อนข้อมูลแอปอื่น ๆ : ชื่อเล่น แอป และ รหัส App Store
ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase
App Store ID : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store ของคุณ และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปของคุณยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสได้ในภายหลังใน การตั้งค่าโครงการ ของคุณ
คลิก ลงทะเบียนแอป
ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase
คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่า Firebase iOS ของคุณ (
GoogleService-Info.plist
)ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำกัน แต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่านี้โปรดไปที่ ทำความเข้าใจกับโครงการ Firebase
คุณสามารถดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
ตรวจสอบว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติมเช่น
(2)
ย้ายไฟล์กำหนดค่าของคุณไปที่รูทของโปรเจ็กต์ Xcode ของคุณ หากได้รับแจ้งให้เลือกเพิ่มไฟล์กำหนดค่าให้กับเป้าหมายทั้งหมด
หากคุณมีรหัสบันเดิลหลายรายการในโปรเจ็กต์คุณต้องเชื่อมโยงรหัสบันเดิลแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist
เป็นของตัวเอง
ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ลงในแอปของคุณ
ขอแนะนำให้ใช้ CocoaPods เพื่อติดตั้งไลบรารี Firebase อย่างไรก็ตามหากคุณไม่ต้องการใช้ CocoaPods คุณสามารถ รวมเฟรมเวิร์ก SDK ได้โดยตรง หรือใช้ Swift Package Manager (เบต้า)
คุณกำลังใช้ ตัวอย่างการเริ่มต้นอย่างรวดเร็ว หรือไม่? มีโครงการ Xcode และ Podfile (พร้อมพ็อด) อยู่แล้ว แต่คุณยังต้อง เพิ่มไฟล์การกำหนดค่า Firebase และ ติดตั้ง พ็อด
สร้าง Podfile หากคุณยังไม่มี:
cd your-project-directory
pod init
ใน Podfile ของคุณให้เพิ่มพ็อด Firebase ที่คุณต้องการใช้ในแอปของคุณ
คุณสามารถเพิ่ม ผลิตภัณฑ์ Firebase ที่รองรับ ลงในแอป iOS ของคุณได้
เปิดใช้งานการวิเคราะห์
platform :ios, ‘10.0’
# Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
# Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'ไม่ได้เปิดใช้งานการวิเคราะห์
platform :ios, ‘10.0’
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'ติดตั้ง
.xcworkspace
จากนั้นเปิดไฟล์..xcworkspace
เพื่อดูโปรเจ็กต์ใน Xcode:pod install
open your-project.xcworkspace
ขั้นตอนที่ 5 : เริ่มต้น Firebase ในแอปของคุณ
ขั้นตอนสุดท้ายคือการเพิ่มรหัสเริ่มต้นในแอปพลิเคชันของคุณ คุณอาจได้ดำเนินการไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ในแอปของคุณ หากคุณกำลังใช้ โปรเจ็กต์ตัวอย่างการเริ่มต้นอย่างรวดเร็ว สิ่งนี้ได้ดำเนินการให้คุณแล้ว
- นำเข้าโมดูล Firebase ใน
UIApplicationDelegate
ของคุณ:รวดเร็ว
import Firebase
วัตถุประสงค์ -C
@import Firebase;
- กำหนดค่าอินสแตนซ์ที่แชร์ของ
FirebaseApp
โดยทั่วไปจะอยู่ในแอปพลิเคชันของแอปของคุณapplication:didFinishLaunchingWithOptions:
method:รวดเร็ว
// Use Firebase library to configure APIs FirebaseApp.configure()
วัตถุประสงค์ -C
// Use Firebase library to configure APIs [FIRApp configure];
- หากคุณรวม Firebase Analytics ไว้คุณสามารถเรียกใช้แอปของคุณเพื่อส่งการยืนยันไปยังคอนโซล Firebase ที่คุณติดตั้ง Firebase สำเร็จแล้ว
แค่นั้นแหละ! คุณสามารถข้ามไปยัง ขั้นตอนถัดไป ได้
ฝักที่มีจำหน่าย
ส่วนนี้แสดงรายการผลิตภัณฑ์ Firebase ที่รองรับ iOS และพ็อด เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี Firebase iOS เหล่านี้:
Firebase iOS SDK GitHub repo
บริการหรือสินค้า | พ็อด | เพิ่ม Analytics ไหม |
---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' | |
การวิเคราะห์ | pod 'Firebase/Analytics' | |
การกระจายแอป | pod 'Firebase/AppDistribution' | |
การรับรองความถูกต้อง | pod 'Firebase/Auth' | |
Cloud Firestore | pod 'Firebase/Firestore' | |
Cloud Functions สำหรับ Firebase Client SDK | pod 'Firebase/Functions' | |
การส่งข้อความบนคลาวด์ | pod 'Firebase/Messaging' | |
การจัดเก็บเมฆ | pod 'Firebase/Storage' | |
Firebase Crashlytics | pod 'Firebase/Crashlytics' | |
ลิงก์แบบไดนามิก | pod 'Firebase/DynamicLinks' | |
การส่งข้อความในแอป | pod 'Firebase/InAppMessaging' | (จำเป็น) |
API โมเดลที่กำหนดเองของ Firebase ML | pod 'Firebase/MLModelDownloader' | |
การตรวจสอบประสิทธิภาพ | pod 'Firebase/Performance' | |
ฐานข้อมูลเรียลไทม์ | pod 'Firebase/Database' | |
การกำหนดค่าระยะไกล | pod 'Firebase/RemoteConfig' |
ผสานรวมโดยไม่ใช้ CocoaPods
หากคุณไม่ต้องการใช้ Cocoapods คุณยังสามารถใช้ประโยชน์จาก Firebase SDK ได้โดยการนำเข้าเฟรมเวิร์กโดยตรงหรือใช้ Swift Package Manager
กรอบ
นอกเหนือจากการรองรับแพลตฟอร์ม iOS แล้วตอนนี้ zip ยังมีไฟล์. xcframework ที่เพิ่มการสนับสนุน Catalyst ตามชุมชน โปรดดูรายละเอียด ที่ Firebase iOS SDK README บน GitHub
ดาวน์โหลด Framework SDK zip นี่คือไฟล์ ~ 200MB และอาจใช้เวลาดาวน์โหลดสักครู่
แตกไฟล์จากนั้นตรวจสอบ
README
สำหรับ Frameworks ที่คุณต้องการรวมไว้ในแอปของคุณเพิ่ม ค่าสถานะตัวเชื่อมต่อ
ObjC
ในOther Linker Settings
ในการตั้งค่าการสร้างเป้าหมายของคุณ
ตัวจัดการแพ็คเกจ Swift
ขณะนี้การสนับสนุน Swift Package Manager อยู่ในรุ่นเบต้า ทำตาม เอกสารใน GitHub และส่งคำติชมไปยัง เครื่องมือติดตามปัญหา GitHub
ขั้นตอนถัดไป
เรียนรู้เกี่ยวกับ Firebase:
ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase และแนวทางปฏิบัติที่ดีที่สุดสำหรับโครงการ
สำรวจ แอป Firebase ตัวอย่าง
สัมผัสประสบการณ์จริงกับ Firebase iOS Codelab
สำรวจ รหัสโอเพนซอร์สใน GitHub
เตรียมเปิดตัวแอปของคุณ:
- ตั้งค่าการ แจ้งเตือนงบประมาณ สำหรับโครงการของคุณใน Google Cloud Console
- ตรวจสอบ การใช้งานและแดชบอร์ดการเรียกเก็บเงิน ของคุณในคอนโซล Firebase
- ตรวจ สอบรายการตรวจสอบการเปิดตัว Firebase
เพิ่มบริการ Firebase ในแอปของคุณ:
รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics
ตั้งค่าการพิสูจน์ตัวตนผู้ใช้ด้วยการ พิสูจน์ตัว ตน
จัดเก็บข้อมูลเช่นข้อมูลผู้ใช้ด้วย Cloud Firestore หรือ Realtime Database
จัดเก็บไฟล์เช่นภาพถ่ายและวิดีโอด้วย Cloud Storage
ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions
ส่งการแจ้งเตือนด้วย Cloud Messaging
ค้นหาว่าเมื่อใดและเหตุใดแอปของคุณจึงขัดข้องด้วย Crashlytics