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 akan melakukannya. Langkah berikutnya kemudian 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

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

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

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

    pod init

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

    pod 'GoogleSignIn'

  5. Jika Anda menggunakan SwiftUI, tambahkan juga ekstensi pod untuk tombol "Login dengan Google": 

    pod 'GoogleSignInSwiftSupport'

  6. Simpan file dan jalankan: 

    pod install

  7. Buka file workspace .xcworkspace 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

  1. Buka project Anda di Xcode.

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

    Repositori https://github.com/google/GoogleSignIn-iOS
    Version 7.0.0
    Paket produk GoogleSignIn

  3. Jika Anda menggunakan SwiftUI, tambahkan juga produk paket ekstensi berikut untuk tombol "Login dengan Google":

    Paket produk 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 untuk melakukannya.

Membuat client ID OAuth

Setelah membuat client ID OAuth, catat string client ID, yang akan Anda perlukan untuk mengonfigurasi Login dengan Google di aplikasi. 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 ada

Mendapatkan client ID server OAuth

Sebagian besar aplikasi harus meneruskan identitas pengguna yang login ke layanan backend tertentu. Untuk meneruskan identitas pengguna yang login dengan Google ke backend dengan aman, Anda menggunakan token ID, seperti yang telah dibahas di Mengautentikasi dengan server backend. Untuk mengambil token ID pengguna, Anda 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 akan Anda perlukan untuk mengonfigurasi Login dengan Google di aplikasi.

Mengonfigurasi project aplikasi

Login dengan Google mengharuskan project Anda dikonfigurasi dengan client ID OAuth dan skema URL kustom. Atau, 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

Perbarui 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 dibalik. Hal ini juga ditampilkan di bagian "Skema URL iOS" saat memilih klien OAuth iOS yang ada di konsol Cloud. 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, 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 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 aplikasi

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

Langkah berikutnya

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