Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

ทำความเข้าใจกับโครงการ Firebase

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

ความสัมพันธ์ระหว่างโครงการ Firebase แอพและผลิตภัณฑ์

โครงการ Firebase เป็นเอนทิตีระดับสูงสุดสำหรับ Firebase ในโครงการคุณสร้างแอป Firebase โดยการลงทะเบียน iOS, Android หรือเว็บแอป หลังจากที่คุณลงทะเบียนแอพของคุณด้วย Firebase คุณสามารถเพิ่ม Firebase SDKs สำหรับ ผลิตภัณฑ์ Firebase จำนวนเท่าใดก็ได้เช่น Analytics, Cloud Firestore, การตรวจสอบประสิทธิภาพหรือการกำหนดค่าระยะไกล

เรียนรู้ข้อมูลรายละเอียดเพิ่มเติมเกี่ยวกับกระบวนการนี้ในคู่มือเริ่มต้นใช้งาน ( iOS | Android | เว็บ | Unity | C ++ )

ความสัมพันธ์ระหว่างโครงการ Firebase กับแพลตฟอร์ม Google Cloud (GCP)

เมื่อคุณสร้างโครงการ Firebase ใหม่ในคอนโซล Firebase คุณกำลังสร้างโครงการ Google Cloud Platform (GCP) ที่ อยู่เบื้องหลัง คุณสามารถนึกถึงโครงการ GCP เป็นที่เก็บเสมือนจริงสำหรับข้อมูลรหัสการกำหนดค่าและบริการ โครงการ Firebase เป็นโครงการ GCP ที่มีการกำหนดค่าและบริการเฉพาะสำหรับ Firebase เพิ่มเติม คุณสามารถสร้างโครงการ GCP ก่อนจากนั้นเพิ่ม Firebase ลงในโครงการในภายหลัง

เนื่องจากโครงการ Firebase เป็น โครงการ GCP:

การตั้งค่าโครงการ Firebase และการลงทะเบียนแอพ

คุณสามารถตั้งค่าโครงการ Firebase และลงทะเบียนแอพใน คอนโซล Firebase (หรือสำหรับกรณีการใช้งานขั้นสูงผ่าน Firebase Management REST API หรือ Firebase CLI ) เมื่อคุณตั้งค่าโครงการและลงทะเบียนแอพคุณจะต้องทำการตัดสินใจขององค์กรและเพิ่มข้อมูลการกำหนดค่าเฉพาะของ Firebase ให้กับโครงการในท้องถิ่นของคุณ

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

ชื่อโครงการ

เมื่อคุณสร้างโครงการคุณให้ ชื่อโครงการ ตัวระบุนี้เป็นชื่อ ภายในเท่านั้น สำหรับโครงการใน คอนโซล Firebase , คอนโซล GCP และ Firebase CLI ชื่อโครงการไม่ปรากฏใน Firebase หรือผลิตภัณฑ์ GCP บริการหรือทรัพยากรที่เปิดเผยต่อสาธารณะ มันมีไว้เพื่อช่วยให้คุณแยกแยะความแตกต่างระหว่างหลาย ๆ

คุณสามารถแก้ไขชื่อโครงการได้ตลอดเวลาในการ โครงการ ของคอนโซล Firebase ชื่อโครงการจะแสดงในบานหน้าต่างด้านบน

หมายเลขโครงการ

โครงการ Firebase (และ โครงการ GCP ที่เกี่ยวข้อง ) มี หมายเลขโครงการ นี่คือรหัสประจำตัวมาตรฐานที่ไม่ซ้ำใครซึ่งได้รับมอบหมายจาก Google สำหรับโครงการ ใช้ตัวระบุนี้เมื่อกำหนดค่าการรวมระบบและ / หรือโทรออก API ไปยัง Firebase, Google หรือบริการบุคคลที่สาม

การเรียก API และหมายเลขโครงการ

สำหรับการเรียกใช้ API จำนวนมากคุณต้องรวมตัวระบุเฉพาะสำหรับโครงการ แม้ว่า APIs จำนวนมากยอมรับ รหัสโครงการ ขอแนะนำให้คุณใช้ หมายเลขโครงการ สำหรับการโทร API ไปยัง Firebase, Google หรือบริการบุคคลที่สาม

เรียนรู้เพิ่มเติมเกี่ยวกับการใช้ตัวระบุโครงการโดยเฉพาะหมายเลขโครงการใน มาตรฐาน AIP 2510 ของ Google

ค้นหาหมายเลขโครงการ

  • คอนโซล Firebase: คลิก โครงการ หมายเลขโครงการจะแสดงในบานหน้าต่างด้านบน

  • Firebase CLI: เรียกใช้ firebase projects:list หมายเลขโครงการจะปรากฏขึ้นพร้อมกับโครงการ Firebase ทั้งหมดที่เกี่ยวข้องกับบัญชีของคุณ

  • Firebase Management REST API: โทร projects.list เนื้อความการตอบสนองมีหมายเลขโครงการในวัตถุ FirebaseProject

รหัสโครงการ

โครงการ Firebase (และ โครงการ GCP ที่เกี่ยวข้อง ) มี รหัสโครงการ นี่คือตัวระบุเฉพาะที่ผู้ใช้กำหนดสำหรับโครงการใน Firebase และ GCP ทั้งหมด เมื่อคุณสร้างโครงการ Firebase Firebase จะกำหนด ID เฉพาะให้กับโครงการโดยอัตโนมัติ แต่คุณสามารถแก้ไขได้ในระหว่างการตั้งค่าโครงการ โดยทั่วไปตัวระบุนี้ควรได้รับการปฏิบัติเสมือนเป็นนามแฝงอำนวยความสะดวกในการอ้างอิงโครงการ

หากคุณลบโครงการรหัสโครงการจะถูกลบด้วยและจะไม่สามารถใช้โครงการอื่นใดได้อีก

ทรัพยากร Firebase และรหัสโครงการ

ID โครงการแสดงในแหล่งข้อมูล Firebase ที่เปิดเผยต่อสาธารณะเช่น:

  • โดเมนย่อยโฮสติ้งเริ่มต้น - PROJECT_ID .web.app และ PROJECT_ID .firebaseapp.com
  • URL ฐานข้อมูลเรียลไทม์เริ่มต้น - PROJECT_ID .firebaseio.com
  • ชื่อที่ฝากข้อมูล Cloud Storage เริ่มต้น - PROJECT_ID .appspot.com

สำหรับทรัพยากรดังกล่าวทั้งหมดคุณสามารถสร้างอินสแตนซ์ที่ไม่ใช่ค่าเริ่มต้น ชื่อที่ไม่ใช่ค่าเริ่มต้นที่เปิดเผยต่อสาธารณะนั้นสามารถปรับแต่งได้อย่างเต็มที่ คุณสามารถ เชื่อมต่อโดเมนที่กำหนดเอง กับไซต์ที่โฮสต์ Firebase, แชร์ฐานข้อมูลเรียลไทม์ และ สร้างที่เก็บ Cloud หลายถัง (ไปที่หน้าเริ่มต้นใช้งานเฉพาะแพลตฟอร์ม)

Firebase CLI และ ID โครงการ

สำหรับบางกรณีการใช้งานคุณอาจมีหลายโครงการของ Firebase ที่เชื่อมโยงกับไดเรกทอรีแอปในเครื่องเดียวกัน ในสถานการณ์เหล่านี้เมื่อคุณใช้ Firebase CLI คุณจะต้องผ่าน --project flag ด้วยคำสั่ง firebase เพื่อสื่อสารว่า Firebase โครงการใดที่คุณต้องการโต้ตอบ

คุณยังสามารถตั้งค่า ชื่อแทนโครงการ สำหรับแต่ละโครงการของ Firebase เพื่อที่คุณจะได้ไม่ต้องจำรหัสโครงการ

การเรียก API และรหัสโครงการ

สำหรับการเรียกใช้ API จำนวนมากคุณต้องรวมตัวระบุเฉพาะสำหรับโครงการ แม้ว่า APIs จำนวนมากยอมรับรหัสโครงการขอแนะนำให้คุณใช้ หมายเลขโครงการ สำหรับการโทร API ไปยัง Firebase, Google หรือบริการบุคคลที่สาม

เรียนรู้เพิ่มเติมเกี่ยวกับการใช้ตัวระบุโครงการโดยเฉพาะหมายเลขโครงการใน มาตรฐาน AIP 2510 ของ Google

ค้นหารหัสโครงการ

  • คอนโซล Firebase: คลิก โครงการ รหัสโครงการจะแสดงในบานหน้าต่างด้านบน

  • Firebase CLI: เรียกใช้ firebase projects:list รหัสโครงการจะแสดงพร้อมกับโครงการ Firebase ทั้งหมดที่เกี่ยวข้องกับบัญชีของคุณ

  • Firebase Management REST API: โทร projects.list เนื้อความการตอบสนองมี ID โครงการในวัตถุ FirebaseProject

ไฟล์และวัตถุของ Firebase config

เมื่อคุณลงทะเบียนแอปด้วยโครงการ Firebase คอนโซล Firebase จะให้ไฟล์กำหนดค่า Firebase (แอป iOS / Android) หรือวัตถุการกำหนดค่า (เว็บแอป) ที่คุณเพิ่มลงในไดเรกทอรีแอปในพื้นที่ของคุณโดยตรง

  • สำหรับแอป iOS คุณเพิ่มไฟล์กำหนดค่า GoogleService-Info.plist
  • สำหรับแอป Android คุณเพิ่มไฟล์กำหนดค่า google-services.json
  • สำหรับเว็บแอปคุณเพิ่มวัตถุการกำหนดค่า Firebase

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

ไฟล์กำหนดค่า Firebase หรือวัตถุเชื่อมโยงแอปกับโครงการ Firebase ที่เฉพาะเจาะจงและทรัพยากร (ฐานข้อมูลถังเก็บข้อมูล ฯลฯ ) การกำหนดค่ารวมถึง "ตัวเลือก Firebase" ซึ่งเป็นพารามิเตอร์ที่จำเป็นสำหรับบริการ Firebase และ Google เพื่อสื่อสารกับเซิร์ฟเวอร์ API ของ Firebase และเพื่อเชื่อมโยงข้อมูลลูกค้ากับโครงการ Firebase และแอป Firebase นี่คือ "Firebase options" ขั้นต่ำที่จำเป็น:

  • คีย์ API : สตริงเข้ารหัสแบบง่ายที่ใช้เมื่อเรียก API บางอย่างที่ไม่จำเป็นต้องเข้าถึงข้อมูลผู้ใช้ส่วนตัว (ค่าตัวอย่าง: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • รหัสโครงการ : ตัวระบุเฉพาะที่ผู้ใช้กำหนดสำหรับโครงการใน Firebase และ GCP ทั้งหมด ตัวระบุนี้อาจปรากฏใน URL หรือชื่อสำหรับทรัพยากร Firebase บางอย่าง แต่โดยทั่วไปควรถือว่าเป็นชื่อแทนความสะดวกสบายในการอ้างอิงโครงการ (ค่าตัวอย่าง: myapp-project-123 )

  • รหัสแอปพลิเคชัน ("AppID") : ตัวระบุเฉพาะสำหรับแอป Firebase ใน Firebase ทั้งหมดด้วยรูปแบบเฉพาะแพลตฟอร์ม:

    • แอป Firebase iOS: GOOGLE_APP_ID (ค่าตัวอย่าง: 1:1234567890:ios:321abc456def7890 )
      นี่ ไม่ใช่ รหัสรวม Apple
    • แอพ Android ของ Firebase: mobilesdk_app_id (ค่าตัวอย่าง: 1:1234567890:android:321abc456def7890 )
      นี่ ไม่ใช่ ชื่อแพคเกจ Android หรือรหัสแอปพลิเคชัน Android
    • Firebase Web apps: appId (ค่าตัวอย่าง: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

เนื้อหาของไฟล์หรือวัตถุการกำหนดค่า Firebase ถือว่าเป็นสาธารณะรวมถึง ID เฉพาะแพลตฟอร์มของแอป (ID ชุดรวม iOS หรือชื่อแพ็คเกจ Android) และค่าเฉพาะโครงการ Firebase เช่นรหัส API, รหัสโครงการ, URL ฐานข้อมูลเรียลไทม์และ ที่เก็บข้อมูลชื่อ ให้สิ่งนี้ ใช้กฎความปลอดภัย เพื่อปกป้องข้อมูลและไฟล์ของคุณใน ฐานข้อมูล Realtime , Cloud Firestore และ Cloud Storage

สำหรับโครงการโอเพ่นซอร์สโดยทั่วไปเราไม่แนะนำให้รวมไฟล์ Firebase ของแอปหรือวัตถุในการควบคุมแหล่งที่มาเพราะโดยส่วนใหญ่ผู้ใช้ของคุณควรสร้างโครงการ Firebase ของตัวเองและชี้แอปของพวกเขาไปยังทรัพยากร Firebase ของตนเอง ไฟล์หรือวัตถุ)

การจัดการโครงการ Firebase

ตรวจสอบให้แน่ใจว่าได้ตรวจทาน แนวปฏิบัติที่ดีที่สุดระดับโครงการทั่วไป (ที่ด้านล่างของหน้านี้) เพื่อพิจารณาสิ่งที่อาจส่งผลต่อวิธีที่คุณจัดการโครงการ Firebase

เครื่องมือในการจัดการโครงการ

คอนโซล Firebase

คอนโซล Firebase มอบสภาพแวดล้อมที่สมบูรณ์ที่สุดสำหรับการจัดการผลิตภัณฑ์ Firebase แอพและการตั้งค่าระดับโครงการ

Firebase console - หน้าจอภาพรวมโครงการ

แผงด้านซ้ายของคอนโซลจะแสดงรายการผลิตภัณฑ์ Firebase ซึ่งจัดเรียงตามหมวดหมู่ระดับบนสุด ที่ด้านบนของแผงด้านซ้ายให้เข้าถึงการตั้งค่าของโครงการโดยคลิก การตั้งค่าของโครงการรวมถึง การรวม การอนุญาตการเข้าถึง และ การเรียกเก็บเงิน

ตรงกลางของคอนโซลจะแสดงปุ่มที่เปิดใช้งานเวิร์กโฟลว์เพื่อลงทะเบียนแอพประเภทต่างๆ หลังจากที่คุณเริ่มใช้ Firebase พื้นที่หลักของคอนโซลจะเปลี่ยนเป็นแดชบอร์ดที่แสดงสถิติเกี่ยวกับผลิตภัณฑ์ที่คุณใช้

Firebase CLI (เครื่องมือบรรทัดคำสั่ง)

Firebase ยังมี Firebase CLI สำหรับการกำหนดค่าและจัดการผลิตภัณฑ์ Firebase เฉพาะเช่น Firebase Hosting และฟังก์ชั่นคลาวด์สำหรับ Firebase

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

Firebase Management REST API

การใช้ Firebase Management REST API คุณสามารถจัดการโครงการ Firebase โดยทางโปรแกรมได้ ตัวอย่างเช่นคุณสามารถลงทะเบียนแอปด้วยโครงการหรือรายการแอพที่ลงทะเบียนแล้ว ( iOS | Android | เว็บ )

แนวปฏิบัติที่ดีที่สุดทั่วไป

การเพิ่มแอพในโครงการ

ตรวจสอบให้แน่ใจว่าแอพทั้งหมดภายในโครงการเป็นตัวแปรของแอปพลิเคชันเดียวกัน จากมุมมองของผู้ใช้ปลายทาง ขอแนะนำให้ลงทะเบียน iOS, Android และเวอร์ชั่นเว็บของแอพหรือเกมเดียวกันกับโครงการ Firebase เดียวกัน แอพทั้งหมดในโครงการโดยทั่วไปจะใช้ทรัพยากร Firebase ร่วมกัน (ฐานข้อมูลถังเก็บข้อมูล ฯลฯ )

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

แม้ว่าจะไม่มีข้อ จำกัด เกี่ยวกับจำนวนแอพภายในโปรเจ็กต์การลงทะเบียนแอพสามารถสร้าง ID ไคลเอ็นต์ OAuth 2.0 พื้นฐานหนึ่งรายการขึ้นไป มีข้อ จำกัด ประมาณ 30 ID ลูกค้าที่สามารถสร้างได้ภายในโครงการเดียว

หลายครอบครอง

ไม่แนะนำให้เชื่อมต่อแอพที่ไม่ขึ้นอยู่กับเหตุผลหลาย ๆ ตัวและ / หรือเว็บไซต์เข้ากับโครงการเดียว (มักเรียกว่า "หลายผู้เช่า") การครอบครองหลายพื้นที่สามารถนำไปสู่ปัญหาการกำหนดค่าที่ร้ายแรงและปัญหาความเป็นส่วนตัวของข้อมูลรวมถึงปัญหาที่ไม่ได้ตั้งใจเกี่ยวกับการรวมการวิเคราะห์การพิสูจน์ตัวตนที่ใช้ร่วมกันโครงสร้างฐานข้อมูลที่ซับซ้อนเกินไปและปัญหาเกี่ยวกับกฎความปลอดภัย

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

ตัวอย่างเช่นหากคุณพัฒนาแอปพลิเคชันป้ายกำกับสีขาวแต่ละแอปที่ติดป้ายกำกับอิสระควรมีโครงการ Firebase เป็นของตนเอง แต่ละแอปไม่ควรและไม่ควร (เพื่อเหตุผลด้านความเป็นส่วนตัว) แชร์ข้อมูลกับแอปอื่น ๆ

หมายเหตุข้อ จำกัด ทั่วไปบางประการสำหรับโครงการ Firebase แอปและเว็บไซต์

  • จำนวนโครงการต่อบัญชี

    • แผน Spark ฟรีเทียร์ - โควต้าการสร้างโครงการถูก จำกัด ไว้ที่จำนวนโครงการที่น้อยกว่า (โดยปกติประมาณ 5-10)
    • แผนการชำระเงิน - โควต้าการสร้างโครงการต่อบัญชีการเรียกเก็บเงินเพิ่มขึ้นอย่างมากตราบใดที่บัญชีการเรียกเก็บเงินบนคลาวด์ที่เชื่อมโยงอยู่ในสถานะที่ดี

    ข้อ จำกัด เกี่ยวกับโควต้าการสร้างโครงการไม่ค่อยเป็นปัญหาสำหรับนักพัฒนาส่วนใหญ่ แต่ถ้าจำเป็นคุณสามารถ ขอเพิ่มโควต้าโครงการ ได้

    โปรดทราบว่าการลบโครงการทั้งหมดต้องใช้เวลา 30 วันและนับรวมเข้ากับโควต้าของโครงการจนกว่าโครงการจะถูกลบอย่างสมบูรณ์

  • จำนวนแอพต่อโครงการ

    แม้ว่าจะไม่มีข้อ จำกัด เกี่ยวกับจำนวนแอพภายในโปรเจ็กต์การลงทะเบียนแอพสามารถสร้างรหัส OAuth 2.0 ไคลเอนต์พื้นฐานหนึ่งรายการขึ้นไป มีข้อ จำกัด ประมาณ 30 ID ลูกค้าที่สามารถสร้างได้ภายในโครงการเดียว

  • จำนวนโฮสต์เว็บไซต์ต่อโครงการ

    คุณลักษณะหลาย ไซต์ของ Firebase Hosting รองรับได้สูงสุด 36 ไซต์ต่อโครงการ

เปิดแอปของคุณ