Panduan migrasi cepat Login dengan Google

Halaman ini menjelaskan perubahan utama untuk versi utama Google Sign-In SDK.

Ikuti panduan ini untuk memigrasikan aplikasi Anda ke versi terbaru Google Sign-In SDK. Perlu diperhatikan bahwa dokumentasi selalu merujuk pada versi terbaru.

Lihat juga catatan rilis dan repositori di GitHub untuk mengetahui informasi selengkapnya.

SDK Login dengan Google v7.0.0+

Untuk memigrasikan aplikasi Anda dari versi Google Sign-In SDK sebelum v7.0.0, lakukan perubahan berikut:

• Tetapkan konfigurasi klien OAuth di file Info.plist aplikasi Anda. Anda dapat terus menetapkannya saat runtime (menggunakan objek GIDConfiguration), tetapi tindakan ini tidak lagi direkomendasikan. Lihat panduan memulai untuk mengetahui contoh dan detail selengkapnya.

  Kunci Info.plist	Deskripsi
  GIDClientID	Client ID OAuth
  GIDServerClientID	Client ID OAuth server untuk autentikasi backend
  GIDHostedDomain	Domain Google Workspace
  GIDOpenIDRealm	Realm OpenID

• Metode addScopes: telah dipindahkan ke GIDGoogleUser. Daripada meminta cakupan otorisasi tambahan dari GIDSignIn, sekarang Anda harus memintanya dari GIDGoogleUser setelah autentikasi selesai.

• Jika Anda menyetel serverClientID untuk mengaktifkan akses API sisi server untuk aplikasi Anda, serverAuthCode sekarang akan ditampilkan dengan GIDSignInResult setelah selesai.

• Properti dari GIDAuthentication telah dipindahkan ke GIDGoogleUser.

• Mengupdate panggilan metode:

v6.2.x	v7.0.0 dan yang lebih baru
GIDSignIn signInWithConfiguration:presentingViewController:callback:	GIDSignIn signInWithPresentingViewController:completion:
GIDSignIn restorePreviousSignInWithCallback:	GIDSignIn restorePreviousSignInWithCompletion:
GIDSignIn disconnectWithCallback:	GIDSignIn disconnectWithCompletion:
GIDAuthentication doWithFreshTokens:	GIDGoogleUser refreshTokensIfNeededWithCompletion:
GIDSignIn addScopes:presentingViewController:callback:	GIDGoogleUser addScopes:presentingViewController:completion:

SDK Login dengan Google v6.0.0

Untuk memigrasikan aplikasi Anda dari versi Google Sign-In SDK sebelum v6.0.0, lakukan perubahan berikut:

• Update semua panggilan [GIDSignIn sharedInstance] ke akses properti GIDSignIn.sharedInstance.

• Pindahkan semua konfigurasi klien (client ID, dll.) ke objek GIDConfiguration.

• Perbarui panggilan ke metode yang dihapus menjadi padanan barunya:

  v5.x.x	v6.0.0
  signIn	signInWithConfiguration:presentingViewController:callback:
  restorePreviousSignIn	restorePreviousSignInWithCallback:
  disconnect	disconnectWithCallback:
  getTokensWithHandler:	doWithFreshTokens:
  refreshTokensWithHandler:	doWithFreshTokens:

• Hapus semua referensi ke protokol GIDSignInDelegate dan metodenya.

  • Pindahkan logika dari signIn:didSignInForUser:withError: ke blok callback signInWithConfiguration:presentingViewController:callback:.

  • Pindahkan logika dari signIn:didDisconnectWithUser:withError: ke blok callback disconnectWithCallback:.

• Hubungkan GIDSignInButton secara manual ke metode yang memanggil signInWithConfiguration:presentingViewController:callback: menggunakan IBAction atau yang serupa.