פתרון בעיות ושאלות נפוצות בנושא Android ו-Firebase

מופיעה הודעת שגיאה שלפיה לא ניתן לפענח את הספרייה ktx או שלא ניתן למצוא אותה.

השגיאה הזו מתרחשת כנראה כי אתם משתמשים ב-Firebase BoM ומציינים מודול KTX כתלות בספריית המוצרים.

ביולי 2025 הפסקנו להשיק גרסאות חדשות של מודולי KTX, והסרנו את ספריות KTX מ-Firebase Android BoM (גרסה 34.0.0).

אם אתם משתמשים בממשקי KTX API ממודולי KTX שפורסמו בעבר, מומלץ להעביר את האפליקציה לשימוש בממשקי KTX API מהמודולים הראשיים במקום זאת. פרטים נוספים זמינים בשאלות הנפוצות על התוכנית הזו.

צריך לספק SHA-1 כשמוסיפים אפליקציית Android לפרויקט Firebase?

פרטי SHA-1 נדרשים על ידי Firebase Authentication (כשמשתמשים בכניסה באמצעות חשבון Google או בכניסה באמצעות מספר טלפון) ועל ידי Firebase Dynamic Links. אם אתם לא משתמשים בתכונות האלה, אתם לא צריכים לספק SHA-1.

איך פותרים את השגיאה: "An OAuth2 client already exists for this package name and SHA-1 in another project"?

השגיאה הזו מתרחשת אם המערכת מזהה שבפרויקט אחר ב-Firebase או ב-Google Cloud יש מזהה לקוח ב-OAuth 2.0 עם שם החבילה ו-SHA-1 שציינתם. איך פותרים את השגיאה הזו

כשמוסיפים את Firebase לפרויקט Android, מוצגת השגיאה 'לא נמצא'.

בדרך כלל, השגיאה הזו מציינת שחסר באפליקציה הפניה אחת או יותר למאגר Maven של Google. חשוב לכלול את מאגר Maven של Google ‏(google()) בקובץ ההגדרה של Gradle.

• אם הפרויקט שלכם משתמש בתחביר plugins, צריך לכלול אותו בקטע plugins בקובץ settings.gradle.kts או settings.gradle.
• אם הפרויקט משתמש בתחביר buildscript, צריך לכלול אותו בקטעים buildscript ו-allprojects בקובץ build.gradle.kts או build.gradle ברמת הפרויקט.

אחרי שפרסמתי את האפליקציה שלי, מופיעה השגיאה '12500:' בכניסה באמצעות חשבון Google. איך אפשר לפתור את הבעיה?

יכולות להיות שתי סיבות לכך: לא סיפקתם כתובת אימייל לתמיכה או שחסר לכם מפתח SHA. כדי לפתור את השגיאה, צריך לוודא שכל התנאים הבאים מתקיימים:

• הוספתם כתובת אימייל לתמיכה בהגדרות הכלליות של הפרויקט במסוף Firebase.
• הוספתם את טביעת האצבע של אישור SHA-1 ממאגר המפתחות של הגרסה או של הסביבה שלכם לאפליקציית Android ב-Firebase במסוף Firebase (עוברים אל settings Project settings, גוללים למטה אל Your apps ובוחרים את אפליקציית Android).
• הוספת את טביעת האצבע של אישור SHA-1 מGoogle Play Console לאפליקציית Android ב-Firebase במסוף Firebase (עוברים אל settings Project settings, גוללים למטה אל Your apps ואז בוחרים את אפליקציית Android).

איך מוסיפים פלאגינים של Firebase לפרויקט Android באמצעות התחביר buildscript ?

ל-Firebase יש את הפלאגינים הבאים של Gradle:

כך מוסיפים פלאגין של Firebase לפרויקט Android שעדיין משתמש בתחביר buildscript:

1. בקובץ Gradle ברמת השורש (ברמת הפרויקט) (<project>/build.gradle.kts או <project>/build.gradle), מוסיפים את הפלאגין כתלות באמצעות הקואורדינטות שלו ב-Maven:

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מוסיפים את הפלאגין באמצעות מזהה הפלאגין שלו:

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }