Memulai Login dengan Google untuk iOS dan macOS

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

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

  2. Buka jendela terminal dan arahkan ke lokasi project Xcode aplikasi Anda.

  3. Jika Anda belum membuat Podfile untuk aplikasi Anda, buat 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 "Login dengan 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 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 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 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.

Membuat client ID OAuth

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:

  1. Buka project Anda di Cloud Console.

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