نقل البيانات إلى الإصدار 4 من حزمة تطوير البرامج (SDK) لمشرف Go

بدءًا من الإصدار 4.0.0، تم تفعيل Firebase Admin SDK لنظام التشغيل Go باستخدام وحدات Go. هناك أيضًا تغييرات في معالجة الأخطاء والدلالات.

تغييرات التثبيت

امتثالاً لأفضل الممارسات المتعلّقة بالوحدات، تمت إضافة الإصدار الرئيسي لحزمة SDK إلى اسم الحزمة. يؤدّي هذا التغيير إلى تعديلات أسماء الحِزم التالية:

  • firebase.google.com/go → firebase.google.com/go/v4
  • firebase.google.com/go/auth → firebase.google.com/go/v4/auth
  • firebase.google.com/go/db → firebase.google.com/go/v4/db
  • firebase.google.com/go/iid → firebase.google.com/go/v4/iid
  • firebase.google.com/go/messaging → firebase.google.com/go/v4/messaging

المطوّرون الذين يستخدمون الوحدات حاليًا

استخدِم اسم الحزمة المرتبط بالإصدار لتثبيت أحدث إصدار من حزمة SDK.

# Install the latest version:
go install firebase.google.com/go/v4@latest

# Or install a specific version:
go install firebase.google.com/go/v4@4.15.0

ويجب استخدام اسم الحزمة ذات الإصدارات نفسها في رمز المصدر عند استيراد حزمة SDK.

package helloworld

import (
        "firebase.google.com/go/v4"
        "firebase.google.com/go/v4/auth"
        "firebase.google.com/go/v4/messaging"
)

لتثبيت إصدار سابق، استخدِم اسم الحزمة القديم (غير المحدَّد بإصدار) مع محدِّد إصدار صريح.

# Notice the @v3 suffix.
# This instructs Go tools to fetch the latest v3.x release of the SDK.
go get firebase.google.com/go@v3

المطوّرون الذين لا يستخدمون الوحدات حاليًا

يمكن للمطوّرين الذين لم يسبق لهم تفعيل استخدام الوحدات مواصلة تثبيت حزمة تطوير البرامج (SDK) باستخدام اسم الحزمة غير المحدَّد بإصدار.

go get firebase.google.com/go

مع ذلك، يؤدي هذا الإجراء إلى جلب أحدث إصدار من حزمة تطوير البرامج (SDK) (الإصدار 4 أو الإصدارات الأحدث) الذي يحتوي على تغييرات أخرى قد تؤدي إلى أعطال في واجهة برمجة التطبيقات.

التغييرات العامة في معالجة الأخطاء

توفّر حزمة تطوير البرامج (SDK) الإصدار 4 حزمة errorutils جديدة توفّر وظائف للتعامل مع حالات الأخطاء على مستوى النظام الأساسي. في حال حدوث خطأ بسبب خطأ في خدمة الخلفية، يمكنك الوصول إلى الاستجابة الأصلية للخطأ من خلال استدعاء الدالة الجديدة errorutils.HTTPResponse(). يمكنك استخدام الدوالّ في هذه الحزمة مع الأخطاء التي تعرضها أيّ واجهة برمجة تطبيقات في حزمة تطوير البرامج (SDK).

Authentication التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة دوال جديدة للتعامل مع الأخطاء لاستخدامها مع واجهتَي برمجة التطبيقات VerifyIDToken() وVerifySessionCookie():
    • IsIDTokenInvalid()
    • IsIDTokenExpired()
    • IsSessionCookieInvalid()
    • IsSessionCookieExpired()
    • IsCertificateFetchFailed()
  • تم إيقاف العمل بها:
    • IsProjectNotFound()
    • IsUnknown()
    • IsInsufficientPermission()
    • IsInvalidEmail()

FCM تغيير في واجهة برمجة التطبيقات

  • تمت إعادة تسمية النوع messaging.WebpushFCMOptions إلى messaging.WebpushFcmOptions.
  • تمت إضافة:
    • IsThirdPartyAuthError()
    • IsQuotaExceeded()
    • IsSenderIDMismatch()
    • IsUnregistered()
    • IsUnavailable()
  • غير مستخدَمة:
    • IsInvalidAPNSCredentials()
    • IsMessageRateExceeded()
    • IsMismatchedCredential()
    • IsRegistrationTokenNotRegistered()
    • IsServerUnavailable()
    • IsTooManyTopics()
    • IsUnknown()

التغييرات في واجهة برمجة التطبيقات IID

تم الآن إيقاف جميع وظائف معالجة الأخطاء المتاحة حاليًا في حزمة iid نهائيًا. يمكنك استخدام وظائف معالجة الأخطاء المقابلة المتوفّرة في حزمة "errorutils" بدلاً من ذلك.