เพิ่ม Firebase ในโปรเจ็กต์ iOS ของคุณ

ข้อกำหนดเบื้องต้น

• ติดตั้งสิ่งต่อไปนี้:

  • Xcode 12.2 หรือใหม่กว่า
  • CocoaPods 1.10.0 หรือใหม่กว่า

• ตรวจสอบให้แน่ใจว่าโครงการของคุณตรงตามข้อกำหนดเหล่านี้:

  • โปรเจ็กต์ของคุณต้องกำหนดเป้าหมายเป็น iOS 10 ขึ้นไป

• ตั้งค่าอุปกรณ์ iOS จริงหรือใช้โปรแกรมจำลอง iOS เพื่อเรียกใช้แอปของคุณ

  คุณต้องการใช้ Cloud Messaging หรือไม่?

  สำหรับ 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 รวมถึงวิธีจัดการรูปแบบบิวด์หลายรายการ

1. ไปที่ คอนโซล Firebase

2. ตรงกลางหน้าภาพรวมโครงการคลิกไอคอน iOS ( plat_ios ) เพื่อเปิดเวิร์กโฟลว์การตั้งค่า

   หากคุณได้เพิ่มแอปลงในโครงการ Firebase แล้วให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

3. ป้อนรหัสบันเดิลของแอปของคุณในฟิลด์ รหัสบันเดิลของ iOS

   Bundle ID คืออะไรและคุณจะพบได้ที่ไหน?

   • รหัสบันเดิลจะ ระบุแอปพลิเคชันในระบบนิเวศของ Apple โดยไม่ซ้ำกัน

   • ค้นหารหัสบันเดิลของคุณ: เปิดโปรเจ็กต์ iOS ของคุณใน Xcode เลือกแอพระดับบนสุดในตัวนำทางโปรเจ็กต์จากนั้นเลือกแท็บ ทั่วไป

     ค่าของช่อง Bundle Identifier คือ ID บันเดิลของ iOS (ตัวอย่างเช่น com.yourcompany.yourproject )

   • โปรดทราบว่าค่ารหัสชุดเป็นแบบตรงตามตัวพิมพ์เล็กและใหญ่และไม่สามารถเปลี่ยนแปลงได้สำหรับแอป Firebase iOS นี้หลังจากที่ลงทะเบียนกับโครงการ Firebase ของคุณแล้ว

4. (ไม่บังคับ) ป้อนข้อมูลแอปอื่น ๆ : ชื่อเล่น แอป และ รหัส App Store

   ชื่อเล่นแอป และ รหัส App Store ใช้ภายใน Firebase อย่างไร

   • ชื่อเล่นแอป : ตัวระบุความสะดวกภายในที่มองเห็นได้เฉพาะคุณในคอนโซล Firebase

   • App Store ID : ใช้โดย Firebase Dynamic Links เพื่อ เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า App Store ของคุณ และโดย Google Analytics เพื่อ นำเข้าเหตุการณ์ Conversion ไปยัง Google Ads หากแอปของคุณยังไม่มีรหัส App Store คุณสามารถเพิ่มรหัสได้ในภายหลังใน การตั้งค่าโครงการ ของคุณ

5. คลิก ลงทะเบียนแอป

ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase

1. คลิก ดาวน์โหลด GoogleService-Info.plist เพื่อรับไฟล์กำหนดค่า Firebase iOS ของคุณ ( GoogleService-Info.plist )

   คุณต้องรู้อะไรบ้างเกี่ยวกับไฟล์กำหนดค่านี้

   • ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำกัน แต่ไม่เป็นความลับสำหรับโครงการของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่านี้โปรดไปที่ ทำความเข้าใจกับโครงการ Firebase

   • คุณสามารถดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ

   • ตรวจสอบว่าชื่อไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติมเช่น (2)

2. ย้ายไฟล์กำหนดค่าของคุณไปยังรูทของโปรเจ็กต์ Xcode ของคุณ หากได้รับแจ้งให้เลือกเพิ่มไฟล์กำหนดค่าให้กับเป้าหมายทั้งหมด

หากคุณมีรหัสบันเดิลหลายรายการในโปรเจ็กต์คุณต้องเชื่อมโยงรหัสบันเดิลแต่ละรายการกับแอปที่ลงทะเบียนในคอนโซล Firebase เพื่อให้แต่ละแอปมีไฟล์ GoogleService-Info.plist เป็นของตัวเอง

ขั้นตอนที่ 4 : เพิ่ม Firebase SDK ลงในแอปของคุณ

ขอแนะนำให้ใช้ CocoaPods เพื่อติดตั้งไลบรารี Firebase อย่างไรก็ตามหากคุณไม่ต้องการใช้ CocoaPods คุณสามารถ รวมเฟรมเวิร์ก SDK ได้โดยตรง หรือใช้ Swift Package Manager แทน

คุณกำลังใช้ ตัวอย่างการเริ่มต้นอย่างรวดเร็ว หรือไม่? มีโครงการ Xcode และ Podfile (พร้อมพ็อด) อยู่แล้ว แต่คุณยังต้อง เพิ่มไฟล์การกำหนดค่า Firebase และ ติดตั้ง พ็อด

1. สร้าง Podfile หากคุณยังไม่มี:

   cd your-project-directory

   pod init

2. ใน Podfile ของคุณให้เพิ่ม Firebase pods ที่คุณต้องการใช้ในแอปของคุณ

   คุณสามารถเพิ่ม ผลิตภัณฑ์ Firebase ที่รองรับ ลงในแอป iOS ของคุณได้

   เปิดใช้งานการวิเคราะห์

   platform :ios, ‘10.0’
   
   # Add the Firebase pod for Google Analytics
   pod 'Firebase/Analytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   
   # 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'

   เรียนรู้เพิ่มเติมเกี่ยวกับ IDFA ตัวระบุโฆษณาระดับอุปกรณ์ในเอกสาร ความเป็นส่วนตัว ของ ผู้ใช้และการใช้ข้อมูล และการ ติดตาม แอปของ Apple

   ไม่ได้เปิดใช้งานการวิเคราะห์

   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'

3. ติดตั้ง .xcworkspace จากนั้นเปิดไฟล์. .xcworkspace เพื่อดูโปรเจ็กต์ใน Xcode:

   pod install

   open your-project.xcworkspace

ขั้นตอนที่ 5 : เริ่มต้น Firebase ในแอปของคุณ

ขั้นตอนสุดท้ายคือการเพิ่มรหัสเริ่มต้นในแอปพลิเคชันของคุณ คุณอาจได้ดำเนินการไปแล้วโดยเป็นส่วนหนึ่งของการเพิ่ม Firebase ในแอปของคุณ หากคุณกำลังใช้ โปรเจ็กต์ตัวอย่างการเริ่มต้นอย่างรวดเร็ว สิ่งนี้ได้ดำเนินการให้คุณแล้ว

1. นำเข้าโมดูล Firebase ใน UIApplicationDelegate ของคุณ:

   รวดเร็ว

   import Firebase

   วัตถุประสงค์ -C

   @import Firebase;

2. กำหนดค่าอินสแตนซ์ที่แชร์ของ FirebaseApp โดยทั่วไปจะอยู่ในแอปพลิเคชันของแอปของคุณ application:didFinishLaunchingWithOptions: method:

   รวดเร็ว

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   วัตถุประสงค์ -C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. หากคุณรวม Firebase Analytics ไว้คุณสามารถเรียกใช้แอปของคุณเพื่อส่งการยืนยันไปยังคอนโซล Firebase ที่คุณติดตั้ง Firebase ได้สำเร็จ

แค่นั้นแหละ! คุณสามารถข้ามไปยัง ขั้นตอนถัดไป ได้

หากคุณประสบปัญหาในการตั้งค่าโปรดไปที่การ แก้ไขปัญหาและคำถามที่พบบ่อยของ iOS

ฝักที่มีจำหน่าย

ส่วนนี้แสดงรายการผลิตภัณฑ์ Firebase ที่รองรับ iOS และพ็อด เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี Firebase iOS เหล่านี้:

• เอกสารอ้างอิง ( Swift | Obj-C )

• ที่เก็บ GitHub ของ Firebase iOS SDK

ผสานรวมโดยไม่ใช้ CocoaPods

หากคุณไม่ต้องการใช้ Cocoapods คุณยังสามารถใช้ประโยชน์จาก Firebase SDK ได้โดยการนำเข้าเฟรมเวิร์กโดยตรงหรือใช้ Swift Package Manager

กรอบ

นอกเหนือจากการรองรับแพลตฟอร์ม iOS แล้วตอนนี้ zip ยังมีไฟล์. xcframework ที่เพิ่มการสนับสนุน Catalyst ตามชุมชน โปรดดูรายละเอียด ที่ Firebase iOS SDK README บน GitHub

1. ดาวน์โหลด Framework SDK zip นี่คือไฟล์ ~ 200MB และอาจใช้เวลาดาวน์โหลดสักครู่

2. แตกไฟล์จากนั้นตรวจสอบ README สำหรับ Frameworks ที่คุณต้องการรวมไว้ในแอปของคุณ

3. เพิ่ม ค่าสถานะตัวเชื่อมต่อ ObjC ใน Other Linker Settings ของคุณในการตั้งค่าการสร้างเป้าหมายของคุณ

ตัวจัดการแพ็คเกจ Swift

เรียนรู้เพิ่มเติมเกี่ยวกับการรวม Swift Package Manager ใน คำแนะนำของเรา

ขั้นตอนถัดไป

เรียนรู้เกี่ยวกับ Firebase:

• ไปที่ ทำความเข้าใจกับโครงการ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโครงการ Firebase และแนวทางปฏิบัติที่ดีที่สุดสำหรับโครงการ

• สำรวจ แอป Firebase ตัวอย่าง

• สัมผัสประสบการณ์จริงกับ Firebase iOS Codelab

• สำรวจ รหัสโอเพนซอร์สใน GitHub

• เตรียมเปิดตัวแอปของคุณ:

  • ตั้งค่าการ แจ้งเตือนงบประมาณ สำหรับโครงการของคุณใน Google Cloud Console
  • ตรวจสอบ แดชบอร์ด การใช้งานและการเรียกเก็บเงิน ในคอนโซล Firebase เพื่อดูภาพรวมของการใช้งานโครงการของคุณในบริการต่างๆของ Firebase
  • ตรวจ สอบรายการตรวจสอบการเปิดตัว Firebase

• มีปัญหากับ Firebase และโปรเจ็กต์ iOS ของคุณใช่หรือไม่ ไปที่การ แก้ไขปัญหาและคำถามที่พบบ่อยของ iOS

เพิ่มบริการ Firebase ในแอปของคุณ:

• รับข้อมูลเชิงลึกเกี่ยวกับพฤติกรรมของผู้ใช้ด้วย Analytics

• ตั้งค่าการพิสูจน์ตัวตนผู้ใช้ด้วยการ พิสูจน์ตัว ตน

• จัดเก็บข้อมูลเช่นข้อมูลผู้ใช้ด้วย Cloud Firestore หรือ Realtime Database

• จัดเก็บไฟล์เช่นภาพถ่ายและวิดีโอด้วย Cloud Storage

• ทริกเกอร์โค้ดแบ็กเอนด์ที่ทำงานในสภาพแวดล้อมที่ปลอดภัยด้วย Cloud Functions

• ส่งการแจ้งเตือนด้วย Cloud Messaging

• ค้นหาว่าเมื่อใดและเหตุใดแอปของคุณจึงขัดข้องด้วย Crashlytics