Sebelum Anda dapat mulai mengintegrasikan aplikasi iOS atau macOS dengan komponen Login dengan Google, Anda harus mengunduh dependensi dan mengonfigurasi proyek Xcode Anda. Langkah-langkah pada halaman ini melakukan hal tersebut. Langkah berikutnya kemudian menjelaskan cara mengintegrasikan Fitur Login dengan Google di 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 di Memulai CocoaPods kami.
Buka jendela terminal dan arahkan ke lokasi Xcode aplikasi Anda proyek.
Jika Anda belum membuat Podfile untuk aplikasi Anda, buat Podfile untuk sekarang:
pod init
Buka Podfile yang dibuat untuk aplikasi Anda dan tambahkan yang berikut ini:
pod 'GoogleSignIn'
Jika Anda menggunakan SwiftUI, tambahkan juga ekstensi pod untuk tombol "Login dengan Google" tombol:
pod 'GoogleSignInSwiftSupport'
Simpan file dan jalankan:
pod install
Buka file workspace
.xcworkspace
dihasilkan untuk aplikasi Anda di Xcode. Gunakan file ini untuk semua pengembangan aplikasi Anda di masa mendatang. (Catatan bahwa file tersebut berbeda dari file project.xcodeproj
yang disertakan, yang akan mengakibatkan error build saat dibuka.)Anda dapat melihat aplikasi contoh Objective-C Podfile sebagai contoh.
Swift Package Manager
Buka project Anda di Xcode.
Menambahkan dependensi Login dengan Google ke aplikasi Anda (Dokumentasi Xcode):
Repositori https://github.com/google/GoogleSignIn-iOS
Version 7.0.0 Paketkan produk GoogleSignIn Jika Anda menggunakan SwiftUI, tambahkan juga produk paket ekstensi berikut untuk "Login dengan Google" tombol:
Paketkan produk GoogleSignInSwift
Mendapatkan client ID OAuth
Aplikasi Anda memerlukan client ID OAuth untuk mengidentifikasi dirinya ke autentikasi Google backend. Untuk aplikasi iOS dan macOS, Jenis aplikasi client ID OAuth harus dikonfigurasi sebagai iOS.
Jika Anda belum membuat client ID OAuth, klik tombol ini di bawah untuk melakukannya.
Setelah Anda membuat client ID OAuth, perhatikan string client ID, yang Anda harus mengonfigurasi Login dengan Google di aplikasi Anda. Anda dapat memilih unduh file konfigurasi, yang berisi ID klien Anda dan data konfigurasi, sebagai referensi di masa mendatang.
Jika sudah membuat client ID OAuth, Anda dapat menemukan ID OAuth informasi bisnis dengan mengklik tombol di bawah ini.
Mendapatkan client ID OAuth yang ada
Mendapatkan client ID server OAuth
Sebagian besar aplikasi harus meneruskan identitas pengguna yang login ke layanan backend semacam ini. Untuk meneruskan identitas pengguna yang login dengan Google secara aman ke backend, Anda menggunakan token ID, seperti yang dibahas dalam Mengautentikasi dengan server backend. Pengambilan token ID pengguna memerlukan client ID kedua—server Anda client ID, yang mewakili backend Anda.
Untuk membuat client ID server:
Buka project Anda di Konsol Cloud.
Buat client ID OAuth jenis Aplikasi web baru. Catat string client ID, yang harus Anda konfigurasi Login dengan Google di .
Mengonfigurasi project aplikasi Anda
Login dengan Google mengharuskan project Anda dikonfigurasi dengan client ID OAuth dan skema URL kustom. Opsional, Anda juga dapat menambahkan ID klien server Anda untuk autentikasi backend atau mengoptimalkan aplikasi untuk keamanan Workspace.
Menambahkan client ID OAuth dan skema URL kustom
Update file Info.plist
aplikasi Anda untuk menambahkan OAuth
client ID dan skema URL kustom berdasarkan client ID terbalik.
Client ID terbalik adalah client ID Anda dengan urutan yang dipisahkan titik
{i>field <i}terbalik. Hal ini juga ditampilkan di bagian "skema URL iOS" saat memilih
klien OAuth iOS yang ada di Cloud
Konsol Play. 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 ingin mendapatkan Token ID 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 realm 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 permohonan
Aplikasi Anda harus ditandatangani dengan sertifikat yang diterbitkan oleh Apple agar dapat dijalankan secara native di perangkat macOS dan iOS untuk menyimpan kredensial melalui gantungan kunci.
Langkah berikutnya
Setelah Anda mendownload dependensi project dan mengonfigurasi Xcode project, Anda dapat menambahkan Login dengan Google ke aplikasi iOS.