Memulai Login dengan Google untuk iOS dan macOS

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

  1. Jika Anda belum menginstal CocoaPods, ikuti langkah-langkah di Memulai CocoaPods kami.

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

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

    pod init

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

    pod 'GoogleSignIn'

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

    pod 'GoogleSignInSwiftSupport'

  6. Simpan file dan jalankan: 

    pod install

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

  1. Buka project Anda di Xcode.

  2. Menambahkan dependensi Login dengan Google ke aplikasi Anda (Dokumentasi Xcode):

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

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

Membuat client ID OAuth

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:

  1. Buka project Anda di Konsol Cloud.

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