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

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

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

  • Xcode 11.0 หรือใหม่กว่า
  • CocoaPods 1.4.0 หรือใหม่กว่า

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

  • โครงการของคุณต้องกำหนดเป้าหมายเป็น iOS 8 หรือใหม่กว่า

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

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

  สำหรับ Cloud Messaging บน iOS สิ่งที่ต้องมีมีดังต่อไปนี้:

  • ตั้งค่า อุปกรณ์ iOS จริง
  • รับคีย์การตรวจสอบสิทธิ์ Apple Push Notification สำหรับ บัญชี Apple Developer ของ คุณ
  • เปิดใช้งานการแจ้งเตือนแบบพุชใน 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 คือรหัสบันเดิลของ 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 ของคุณได้

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

   # 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'

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

   # 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 สำเร็จแล้ว

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

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

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

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

• Firebase iOS SDK GitHub repo

เลิกใช้:

ผสานรวมโดยไม่ใช้ 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 linker ใน Other Linker Settings ของ Other Linker Settings ใน Other Linker Settings ของเป้าหมาย

Swift Package Manager

ปัจจุบันการสนับสนุน Swift Package Manager เป็นรุ่นเบต้า ทำตาม เอกสารใน GitHub และส่งคำติชมไปยัง เครื่องมือติดตามปัญหา GitHub

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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