Sebelum mulai mengintegrasikan aplikasi iOS atau macOS dengan komponen Login dengan Google, Anda harus mendownload dependensi dan mengonfigurasi project Xcode Anda. Langkah-langkah di halaman ini menjelaskan hal itu. Selanjutnya, langkah berikutnya menjelaskan cara mengintegrasikan fitur Login dengan Google ke dalam aplikasi Anda.
Sebelum memulai
Instal Xcode versi terbaru.
Menginstal dependensi Login dengan Google di project Anda
CocoaPods
Jika Anda belum menginstal CocoaPods, ikuti langkah-langkah dalam panduan Memulai CocoaPods.
Buka jendela terminal dan arahkan ke lokasi project Xcode aplikasi Anda.
Jika Anda belum membuat Podfile untuk aplikasi Anda, buat sekarang:
pod init
Buka Podfile yang dibuat untuk aplikasi Anda dan tambahkan hal berikut:
pod 'GoogleSignIn'
Jika Anda menggunakan SwiftUI, tambahkan juga ekstensi pod untuk tombol "Login dengan Google":
pod 'GoogleSignInSwiftSupport'
Simpan file dan jalankan:
pod install
Buka file
.xcworkspace
workspace yang dihasilkan untuk aplikasi Anda di Xcode. Gunakan file ini untuk semua pengembangan aplikasi Anda di masa mendatang. (Perhatikan bahwa ini berbeda dengan file project.xcodeproj
yang disertakan, yang akan menyebabkan error build saat dibuka.)Anda dapat melihat Podfile aplikasi contoh Objective-C sebagai contoh.
Swift Package Manager
Buka project Anda di Xcode.
Tambahkan dependensi Login dengan Google ke aplikasi Anda (dokumentasi Xcode):
Repositori https://github.com/google/GoogleSignIn-iOS
Version 6.0.2 Produk paket GoogleSignIn Jika Anda menggunakan SwiftUI, tambahkan juga produk paket ekstensi berikut untuk tombol "Login dengan Google":
Produk paket GoogleSignInSwift
Mendapatkan client ID OAuth
Aplikasi Anda memerlukan client ID OAuth untuk mengidentifikasi dirinya sendiri ke backend autentikasi Google. Untuk aplikasi iOS dan macOS, jenis aplikasi client ID OAuth harus dikonfigurasi sebagai iOS.
Jika Anda belum membuat client ID OAuth, klik tombol di bawah ini untuk melakukannya.
Setelah Anda membuat client ID OAuth, catat string client ID, yang diperlukan untuk mengonfigurasi Login dengan Google di aplikasi Anda. Secara opsional, Anda dapat mendownload file konfigurasi, yang berisi client ID Anda dan data konfigurasi lainnya, untuk referensi di masa mendatang.
Jika sudah membuat client ID OAuth, Anda dapat menemukan informasi OAuth yang sudah ada dengan mengklik tombol di bawah.
Dapatkan client ID OAuth yang sudah ada
Mendapatkan client ID server OAuth
Sebagian besar aplikasi harus meneruskan identitas pengguna yang login ke layanan backend semacam itu. Untuk meneruskan identitas pengguna yang login dengan Google ke backend Anda secara aman, gunakan token ID, seperti yang dibahas di bagian Mengautentikasi dengan server backend. Pengambilan token ID pengguna memerlukan client ID kedua—client ID server—yang mewakili backend Anda.
Untuk membuat client ID server:
Buka project Anda di Cloud Console.
Buat client ID OAuth jenis Web application baru. Catat string client ID yang perlu dikonfigurasi Login dengan Google di aplikasi Anda.
Mengonfigurasi project aplikasi Anda
Login dengan Google mengharuskan project Anda dikonfigurasi dengan client ID OAuth dan skema URL kustom. Secara opsional, Anda juga dapat menambahkan client ID server untuk autentikasi backend atau mengoptimalkan aplikasi untuk domain Google Workspace Anda.
Menambahkan client ID OAuth dan skema URL kustom
Update file Info.plist
aplikasi Anda untuk menambahkan client ID
OAuth dan skema URL kustom berdasarkan client ID terbalik.
Client ID terbalik adalah client ID Anda dengan urutan kolom yang dipisahkan titik. Hal ini juga ditampilkan di bagian "iOS URL scheme" saat memilih klien OAuth iOS yang ada di Cloud Console. Contoh:
com.googleusercontent.apps.1234567890-abcdefg
<key>GIDClientID</key> <string>YOUR_IOS_CLIENT_ID</string> <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string> </array> </dict> </array>
Opsional: Mengonfigurasi autentikasi backend
Jika Anda perlu mendapatkan token ID pengguna untuk autentikasi backend, setel juga kunci GIDServerClientID
di file Info.plist
aplikasi Anda.
<key>GIDServerClientID</key> <string>YOUR_SERVER_CLIENT_ID</string>
Opsional: Mengoptimalkan domain Google Workspace atau lingkup OpenID
Gunakan parameter GIDHostedDomain
jika Anda ingin mengoptimalkan alur login untuk domain Google Workspace.
<key>GIDHostedDomain</key> <string>YOUR_HOSTED_DOMAIN</string>
Gunakan parameter GIDOpenIDRealm
jika Anda ingin menentukan realm OpenID.
<key>GIDOpenIDRealm</key> <string>YOUR_OPENID_REALM</string>
Menandatangani aplikasi Anda
Aplikasi Anda harus ditandatangani dengan sertifikat yang diterbitkan oleh Apple agar dapat berjalan secara native di perangkat macOS dan iOS agar dapat menyimpan kredensial melalui keychain.
Langkah berikutnya
Setelah mendownload dependensi project dan mengonfigurasi project Xcode, Anda dapat menambahkan Login dengan Google ke aplikasi iOS.