เริ่มต้นใช้งาน Google Sign-In สำหรับ iOS และ macOS

ก่อนที่จะเริ่มผสานรวมแอป iOS หรือ macOS กับคอมโพเนนต์การลงชื่อเข้าใช้ด้วย Google ได้ คุณต้องดาวน์โหลดทรัพยากร Dependency และกำหนดค่าโปรเจ็กต์ Xcode ขั้นตอนใน หน้านี้จะช่วยให้คุณทำเช่นนั้นได้ จากนั้นขั้นตอนถัดไปจะอธิบายวิธีผสานรวมฟีเจอร์การลงชื่อเข้าใช้ด้วยบัญชี Google เข้ากับแอป

ก่อนเริ่มต้น

ติดตั้ง Xcode เวอร์ชันปัจจุบัน

ติดตั้งการอ้างอิงการลงชื่อเข้าใช้ด้วย Google ในโปรเจ็กต์

CocoaPods

  1. หากยังไม่ได้ติดตั้ง CocoaPods ให้ทำตามขั้นตอนใน คู่มือการเริ่มต้นใช้งาน CocoaPods

  2. เปิดหน้าต่างเทอร์มินัลแล้วไปที่ตำแหน่งของโปรเจ็กต์ Xcode ของแอป

  3. หากยังไม่ได้สร้าง Podfile สำหรับแอปพลิเคชัน ให้สร้างตอนนี้โดยทำดังนี้ 

    pod init

  4. เปิด Podfile ที่สร้างขึ้นสำหรับแอปพลิเคชัน แล้วเพิ่มโค้ดต่อไปนี้ 

    pod 'GoogleSignIn'

  5. หากคุณใช้ SwiftUI ให้เพิ่มส่วนขยาย Pod สำหรับปุ่ม "ลงชื่อเข้าใช้ด้วย Google" ด้วย 

    pod 'GoogleSignInSwiftSupport'

  6. บันทึกไฟล์และเรียกใช้: 

    pod install

  7. เปิดไฟล์ .xcworkspace workspace ที่สร้างขึ้นสำหรับแอปพลิเคชันใน Xcode ใช้ไฟล์นี้สำหรับการพัฒนาทั้งหมดที่จะเกิดขึ้นในอนาคตสำหรับแอปพลิเคชัน (โปรดทราบ ว่าไฟล์นี้แตกต่างจากไฟล์.xcodeproj โปรเจ็กต์ที่รวมไว้ ซึ่ง จะทำให้เกิดข้อผิดพลาดในการสร้างเมื่อเปิด)

    คุณดูตัวอย่างได้ใน Podfile ของแอปตัวอย่าง Objective-C

Swift Package Manager

  1. เปิดโปรเจ็กต์ใน Xcode

  2. เพิ่มการอ้างอิงการลงชื่อเข้าใช้ด้วย Google ลงในแอป (เอกสารประกอบของ Xcode)

    ที่เก็บ https://github.com/google/GoogleSignIn-iOS
    เวอร์ชัน 9.0.0
    แพ็กเกจผลิตภัณฑ์ GoogleSignIn

  3. หากคุณใช้ SwiftUI ให้เพิ่มผลิตภัณฑ์แพ็กเกจส่วนขยายต่อไปนี้ด้วย สำหรับปุ่ม "ลงชื่อเข้าใช้ด้วย Google"

    แพ็กเกจผลิตภัณฑ์ GoogleSignInSwift

รับรหัสไคลเอ็นต์ OAuth

แอปของคุณต้องมีรหัสไคลเอ็นต์ OAuth เพื่อระบุตัวตนกับแบ็กเอนด์การตรวจสอบสิทธิ์ของ Google สำหรับแอป iOS และ macOS ต้องกำหนดค่าประเภทแอปพลิเคชันรหัสไคลเอ็นต์ OAuth เป็น iOS

หากยังไม่ได้สร้างรหัสไคลเอ็นต์ OAuth ให้คลิกปุ่มด้านล่างเพื่อสร้าง

สร้างรหัสไคลเอ็นต์ OAuth

หลังจากสร้างรหัสไคลเอ็นต์ OAuth แล้ว ให้จดสตริงรหัสไคลเอ็นต์ ซึ่งคุณจะต้องใช้เพื่อกำหนดค่าการลงชื่อเข้าใช้ด้วย Google ในแอป คุณเลือกดาวน์โหลดไฟล์การกำหนดค่าซึ่งมีรหัสไคลเอ็นต์และข้อมูลการกำหนดค่าอื่นๆ เพื่อใช้อ้างอิงในอนาคตได้

หากสร้างรหัสไคลเอ็นต์ OAuth แล้ว คุณจะดูข้อมูล OAuth ที่มีอยู่ได้โดยคลิกปุ่มด้านล่าง

รับรหัสไคลเอ็นต์ OAuth ที่มีอยู่

รับรหัสไคลเอ็นต์เซิร์ฟเวอร์ OAuth

แอปส่วนใหญ่จะต้องส่งข้อมูลประจำตัวของผู้ใช้ที่ลงชื่อเข้าใช้ไปยังบริการแบ็กเอนด์ บางประเภท หากต้องการส่งข้อมูลระบุตัวตนของผู้ใช้ที่ลงชื่อเข้าใช้ด้วย Google ไปยังแบ็กเอนด์อย่างปลอดภัย คุณต้องใช้โทเค็นรหัสตามที่อธิบายไว้ในตรวจสอบสิทธิ์กับเซิร์ฟเวอร์แบ็กเอนด์ การดึงโทเค็นรหัสของผู้ใช้ต้องใช้รหัสไคลเอ็นต์ที่ 2 ซึ่งก็คือรหัสไคลเอ็นต์เซิร์ฟเวอร์ ของคุณ ซึ่งแสดงถึงแบ็กเอนด์

วิธีสร้างรหัสไคลเอ็นต์ของเซิร์ฟเวอร์

  1. เปิดโปรเจ็กต์ใน Cloud Console

  2. สร้างรหัสไคลเอ็นต์ OAuth ประเภทเว็บแอปพลิเคชันใหม่ จดสตริงรหัสไคลเอ็นต์ไว้ ซึ่งคุณจะต้องใช้เพื่อกำหนดค่าการลงชื่อเข้าใช้ด้วย Google ในแอป

กำหนดค่าโปรเจ็กต์แอปพลิเคชัน

Google Sign-In กำหนดให้โปรเจ็กต์ของคุณต้องได้รับการกำหนดค่าด้วยรหัสไคลเอ็นต์ OAuth และรูปแบบ URL ที่กำหนดเอง นอกจากนี้ คุณยังเพิ่มรหัสไคลเอ็นต์เซิร์ฟเวอร์สำหรับการตรวจสอบสิทธิ์แบ็กเอนด์ หรือเพิ่มประสิทธิภาพแอปสำหรับโดเมน Google Workspace ได้ด้วย (ไม่บังคับ)

เพิ่มรหัสไคลเอ็นต์ OAuth และรูปแบบ URL ที่กำหนดเอง

อัปเดตไฟล์ Info.plist ของแอปเพื่อเพิ่มรหัสไคลเอ็นต์ OAuth และรูปแบบ URL ที่กำหนดเองตามรหัสไคลเอ็นต์แบบย้อนกลับ

รหัสไคลเอ็นต์แบบย้อนกลับคือรหัสไคลเอ็นต์ที่มีการกลับลำดับของฟิลด์ที่คั่นด้วยจุด ซึ่งจะแสดงในส่วน "รูปแบบ URL ของ iOS" ด้วยเมื่อเลือกไคลเอ็นต์ OAuth ของ iOS ที่มีอยู่แล้วในคอนโซลระบบคลาวด์ เช่น 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>

ไม่บังคับ: กำหนดค่าการตรวจสอบสิทธิ์แบ็กเอนด์

หากต้องการรับโทเค็นรหัสของผู้ใช้สำหรับการตรวจสอบสิทธิ์แบ็กเอนด์ ให้ตั้งค่าคีย์ GIDServerClientID ในไฟล์ Info.plist ของแอปด้วย

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

ไม่บังคับ: เพิ่มประสิทธิภาพสำหรับโดเมน Google Workspace หรือขอบเขต OpenID

ใช้พารามิเตอร์ GIDHostedDomain หากต้องการเพิ่มประสิทธิภาพขั้นตอนการลงชื่อเข้าใช้สำหรับ โดเมน Google Workspace

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

ใช้พารามิเตอร์ GIDOpenIDRealm หากต้องการระบุขอบเขต OpenID

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

การลงนามในแอปพลิเคชัน

แอปพลิเคชันของคุณต้องลงชื่อด้วยใบรับรองที่ Apple ออกให้เพื่อเรียกใช้ ในอุปกรณ์ macOS และ iOS โดยตรงเพื่อจัดเก็บข้อมูลเข้าสู่ระบบโดยใช้พวงกุญแจ

หากต้องการให้แอป macOS จัดเก็บข้อมูลเข้าสู่ระบบโดยใช้พวงกุญแจได้สำเร็จ คุณจะต้องเพิ่ม $(AppIdentifierPrefix)$(CFBundleIdentifier) ลงในกลุ่มการเข้าถึงพวงกุญแจด้วย

ขั้นตอนถัดไป

ตอนนี้คุณได้ดาวน์โหลดการอ้างอิงโปรเจ็กต์และกำหนดค่าโปรเจ็กต์ Xcode แล้ว คุณจะเพิ่ม Google Sign-In ลงในแอป iOS ได้