เพิ่ม Firebase กับโครงการ iOS ของคุณ

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

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

  • Xcode 10.3 หรือสูงกว่า
  • CocoaPods 1.4.0 หรือในภายหลัง

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

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

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

  คุณต้องการที่จะใช้การส่งข้อความเมฆ?

  สำหรับ 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

   คือสิ่งที่รหัสชุดและสถานที่ที่คุณจะพบมันได้หรือไม่

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

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

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

   • ทราบว่าค่า ID มัดเป็นกรณีที่มีความอ่อนไหวและไม่สามารถเปลี่ยนแปลงนี้ app 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 )

   อะไรที่คุณต้องรู้เกี่ยวกับไฟล์ config นี้หรือไม่?

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

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

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

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

หากคุณมีรหัสมัดในหลายโครงการของคุณคุณต้องเชื่อมโยง 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 ของคุณ

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

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

   Analytics ไม่ได้เปิดใช้

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

   รวดเร็ว

   import Firebase

   Objective-C

   @import Firebase;

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

   รวดเร็ว

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

   Objective-C

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

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

แค่นั้นแหละ! คุณสามารถข้ามไปข้างหน้าเพื่อ ทำตามขั้นตอนต่อไป

ฝักที่มีอยู่

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

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

• Firebase iOS SDK GitHub repo

เลิกใช้:

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

หากคุณไม่ต้องการที่จะใช้ Cocoapods คุณยังสามารถใช้ประโยชน์จาก Firebase SDKs โดยการนำเข้ากรอบโดยตรง

นอกจากการสนับสนุนแพลตฟอร์ม iOS, ซิปขณะนี้รวมถึงไฟล์ที่เพิ่ม .xcframework ชุมชนตามการสนับสนุนตัวเร่งปฏิกิริยา ดูรายละเอียด Firebase iOS SDK README บน GitHub

1. ดาวน์โหลด ซิปกรอบ SDK นี้เป็นไฟล์ ~ 200MB และอาจใช้เวลาในการดาวน์โหลด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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