Memulai Login dengan Google untuk iOS dan macOS

Sebelum dapat mulai mengintegrasikan aplikasi iOS atau macOS dengan komponen Login dengan Google, Anda harus mendownload dependensi dan mengonfigurasi project Xcode. Langkah-langkah di halaman ini melakukannya. Langkah berikutnya akan menjelaskan cara mengintegrasikan fitur Login dengan Google ke dalam aplikasi Anda.

Sebelum memulai

Instal Xcode versi saat ini.

Instal dependensi Login dengan Google di project Anda

CocoaPods

  1. Jika Anda belum menginstal CocoaPods, ikuti langkah-langkah dalam panduan CocoaPods Mulai.

  2. Buka jendela terminal dan buka lokasi project Xcode aplikasi Anda.

  3. Jika Anda belum membuat Podfile untuk aplikasi Anda, buat satu sekarang: 

    pod init

  4. Buka Podfile yang dibuat untuk aplikasi Anda dan tambahkan hal berikut: 

    pod 'GoogleSignIn'

  5. Jika Anda menggunakan SwiftUI, tambahkan juga ekstensi pod untuk tombol "Sign in with Google":

    pod 'GoogleSignInSwiftSupport'

  6. Simpan file dan jalankan: 

    pod install

  7. 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 untuk mengetahui contohnya.

Swift Package Manager

  1. Buka project Anda di Xcode.

  2. Tambahkan dependensi Login dengan Google ke aplikasi Anda (dokumentasi Xcode):

    Repositori https://github.com/google/GoogleSignIn-iOS
    Versi 6.0.2
    Produk paket GoogleSignIn

  3. 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 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.

Membuat client ID OAuth

Setelah membuat client ID OAuth, catat string client ID yang akan diperlukan untuk mengonfigurasi Login dengan Google di aplikasi Anda. Anda dapat secara opsional mendownload file konfigurasi, yang berisi client ID dan data konfigurasi lainnya, untuk referensi di masa mendatang.

Jika sudah membuat client ID OAuth, Anda dapat menemukan informasi OAuth yang ada dengan mengklik tombol di bawah.

Mendapatkan client ID OAuth yang sudah ada

Mendapatkan client ID server OAuth

Sebagian besar aplikasi perlu meneruskan identitas pengguna yang login ke suatu layanan backend. Untuk meneruskan identitas pengguna yang login dengan Google ke backend Anda dengan aman, gunakan token ID, seperti yang dibahas dalam Melakukan autentikasi dengan server backend. Pengambilan token ID pengguna memerlukan client ID kedua—client ID server—yang mewakili backend Anda.

Untuk membuat client ID server:

  1. Buka project Anda di Cloud Console.

  2. Buat client ID OAuth jenis aplikasi web baru. Catat string client ID yang harus Anda konfigurasikan untuk 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.

Tambahkan client ID OAuth dan skema URL kustom Anda

Perbarui file Info.plist aplikasi untuk menambahkan client ID OAuth dan skema URL kustom berdasarkan ID klien terbalik.

Client ID terbalik adalah client ID Anda dengan urutan kolom yang dipisahkan titik yang dibalik. Nama ini juga ditampilkan di bagian "Skema URL iOS" 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 perlu mendapatkan token ID pengguna untuk autentikasi backend, tetapkan juga kunci GIDServerClientID dalam file Info.plist aplikasi Anda.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Opsional: Mengoptimalkan untuk 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 lingkup OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

Menandatangani aplikasi Anda

Aplikasi Anda harus ditandatangani dengan sertifikat yang diterbitkan oleh Apple untuk dijalankan secara native di perangkat macOS dan iOS untuk menyimpan kredensial melalui keychain.

Langkah berikutnya

Setelah mendownload dependensi project dan mengonfigurasi project Xcode, Anda dapat menambahkan Login dengan Google ke aplikasi iOS.