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

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

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

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

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

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

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

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

  สำหรับ Cloud Messaging บน iOS มีข้อกำหนดเบื้องต้นดังต่อไปนี้:

  • ตั้งค่าอุปกรณ์ iOS ทางกายภาพ
  • ได้รับการผลักดันแอปเปิ้ลประกาศรับรองความถูกต้องที่สำคัญสำหรับคุณ บัญชีนักพัฒนาซอฟต์แวร์แอปเปิ้ล
  • เปิดใช้งานการแจ้งเตือนผลักดันใน Xcode ภายใต้ App> ความสามารถ

• ลงชื่อเข้าใช้ Firebase ใช้บัญชี Google ของคุณ

หากคุณไม่ได้มีโครงการ Xcode และเพียงแค่ต้องการที่จะลองผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งของเรา ตัวอย่าง QuickStart

ขั้นตอนที่ 1: สร้างโครงการ Firebase

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

ขั้นตอนที่ 2: ลงทะเบียนแอปของคุณด้วย Firebase

หลังจากคุณมีโปรเจ็กต์ Firebase แล้ว คุณสามารถเพิ่มแอป iOS ลงไปได้

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

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

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

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

3. ใส่รหัสชุดของแอปในช่องรหัสกำ iOS

   ID บันเดิลคืออะไร และหาได้จากที่ไหน

   • รหัสชุด ไม่ซ้ำกันระบุการประยุกต์ใช้ในระบบนิเวศของแอปเปิ้ล

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

     ค่าของฟิลด์ Bundle ตัวบ่งชี้คือ iOS ของคุณกำประจำตัวประชาชน (ตัวอย่างเช่น com.yourcompany.yourproject )

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

4. (อุปกรณ์เสริม) ป้อนข้อมูลตรวจสอบอื่น ๆ : ชื่อเล่น App และ App Store ID

   วิธีนี้เป็นชื่อเล่น App และ App Store ID ที่ใช้ภายใน Firebase?

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

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

5. คลิกแอปสมัครสมาชิก

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

1. คลิกดาวน์โหลด GoogleService-Info.plist ที่จะได้รับไฟล์ config Firebase iOS ของคุณ ( GoogleService-Info.plist )

   สิ่งที่คุณต้องรู้เกี่ยวกับไฟล์ปรับแต่งนี้

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

   • คุณสามารถดาวน์โหลดของ ไฟล์ config Firebase อีกครั้งในเวลาใดก็ได้

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

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

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

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

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

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

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

   cd your-project-directory

   pod init

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

   คุณสามารถเพิ่มใด ๆ ของ ผลิตภัณฑ์ 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 ระบุการโฆษณาระดับอุปกรณ์ในแอปเปิ้ลของ ความเป็นส่วนตัวของผู้ใช้และการใช้ข้อมูล และ App ติดตามความโปร่งใส เอกสาร

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

   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 ของไฟล์เพื่อดูโครงการใน Xcode นี้:

   pod install

   open your-project.xcworkspace

ขั้นตอนที่ 5: การเตรียม Firebase ใน app ของคุณ

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

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

   Swift

   import Firebase

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

   @import Firebase;

2. กำหนดค่า FirebaseApp ที่ใช้ร่วมกันเช่นปกติในของแอป application:didFinishLaunchingWithOptions: วิธีการ:

   Swift

   // 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 เหล่านี้:

• เอกสารอ้างอิง ( สวิฟท์ | Obj-C )

• Firebase iOS SDK GitHub repo

บูรณาการโดยไม่ต้อง CocoaPods

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

กรอบงาน

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

1. ดาวน์โหลด ซิปกรอบ SDK ไฟล์นี้เป็นไฟล์ขนาดประมาณ 200MB และอาจใช้เวลาในการดาวน์โหลดสักครู่

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

3. เพิ่ม ObjC ธงลิงเกอร์ ของคุณใน Other Linker Settings ในเป้าหมายของการตั้งค่าการสร้าง

Swift Package Manager

เรียนรู้เพิ่มเติมเกี่ยวกับการรวมสวิฟท์แพคเกจ Manager ที่ปรากฏใน คำแนะนำของเรา

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

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

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

• สำรวจ ปพลิเคชัน Firebase ตัวอย่าง

• ได้รับประสบการณ์กับ Firebase iOS Codelab

• สำรวจ รหัสที่มาเปิดใน GitHub

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

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

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

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

• ข้อมูลเชิงลึกกำไรจากพฤติกรรมของผู้ใช้กับ Analytics

• ตั้งค่าการตรวจสอบผู้ใช้ที่มี การตรวจสอบสิทธิ์

• จัดเก็บข้อมูลเช่นข้อมูลของผู้ใช้กับ ระบบคลาวด์ FireStore หรือ เรียลไทม์ฐานข้อมูล

• จัดเก็บไฟล์เช่นรูปภาพและวิดีโอที่มี การจัดเก็บเมฆ

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

• ส่งการแจ้งเตือนกับ Cloud Messaging

• หาเวลาและทำไมแอปของคุณล้มเหลวกับ Crashlytics