מדריך העברת SDK למנהל מערכת

הגרסאות הבאות של ערכות ה-Admin SDK מציגות מספר מוגבל של שינויים שבירה:

  • Java SDK 6.0.0
  • Go SDK 3.0.0

השינוי בעל ההשפעה הרחבה ביותר הוא הסרת ממשק Java Task , אשר מוחלף בממשק ApiFuture .

בנוסף, ישנם שינויים בתכונות אלה:

  • ציון אישורי הרשאה עבור Java SDK
  • הגדרת רמות יומן מסד נתונים בזמן אמת
  • יצירת אסימונים מותאמים אישית ואימות אסימוני מזהה ב-Go

Admin Java SDK (6.0.0)

השתמש ApiFuture במקום ב- Task

ממשק ה- Task שהוצא משימוש הוסר. אם האפליקציה שלך משתמשת בממשק זה, עדכן אותו כדי להשתמש בממשק ApiFutures במקום זאת. לדוגמה:

לפני

Task<String> customToken = FirebaseAuth.getInstance()
    .createCustomToken("uid");

לאחר

String customToken = FirebaseAuth.getInstance()
    .createCustomToken("uid");

// Or

ApiFuture<String> customToken = FirebaseAuth.getInstance()
    .createCustomTokenAsync("uid");

לדיון מפורט על שינוי זה עם דוגמאות לשימוש מתקדמות, ראה פעולות אסינכרוניות עם Admin Java SDK .

העבר את FirebaseCredentials ל- GoogleCredentials

FirebaseCredential ו- FirebaseCredentials אינם זמינים עוד. כדי לציין אישורי הרשאה עבור ה-SDK, השתמש במקום זאת ב- GoogleCredentials . לדוגמה:

לפני

FirebaseCredential credential = FirebaseCredentials.fromCertificate(stream);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredential(credential)
    .build();

FirebaseCredential credential = FirebaseCredentials.applicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredential(credential)
    .build();

לאחר

GoogleCredentials credentials = GoogleCredentials.fromStream(stream);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();

GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();

השתמש ב-SLF4J כדי להגדיר רישום

ממשק ה-API של FirebaseDatabase.setLogLevel() אינו זמין עוד. השתמש ב-SLF4J ישירות כדי להגדיר רישום עבור ה-SDK כולו.

שינוי זה אומר שניתן להגדיר רישום כעת ללא שינויי קוד. למידע נוסף, ראה כניסה לספריות Java עבור Firebase ו-Google Cloud .

לפני

FirebaseDatabase.getInstance()
 .setLogLevel(Logger.Level.DEBUG);

לאחר

  • הוסף slf4j-simple.jar ל-classpath של הפרויקט.
  • הגדר את -Dorg.slf4j.simpleLogger.defaultLogLevel=debug system עבור ה-JVM.
  • עיין בתיעוד SLF4J לפרטים על שימוש במסגרות רישום אחרות כמו Log4J ו- java.util.logging .

Admin Go SDK 3.0.0

שינויים ב-auth.Client for Go

השיטות CustomToken ו- CustomTokeWithClaims כעת ארגומנט הקשר, כמו רוב ממשקי API הקיימים של Go.

לפני

token, err := CustomToken("uid")

token, err := CustomToken("uid", claimsMap)

result, err := VerifyIDToken(idToken)

לאחר

token, err := CustomToken(context.Background(), "uid")

token, err := CustomTokenWithClaims(context.Background(), "uid", claimsMap)

result, err := VerifyIDToken(context.Background(), idToken)