نقل البيانات إلى الإصدار 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.2

يجب استخدام اسم الحزمة نفسه المرتبط بالإصدار في رمز المصدر عند استيراد 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 بدلاً من ذلك.