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

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

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

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

ติดตั้งทรัพยากร Dependency ของ Google Sign-In ในโปรเจ็กต์

CocoaPods

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

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

  3. หากคุณยังไม่ได้สร้าง Podfile สำหรับแอปพลิเคชันของคุณ ให้สร้างขึ้นใหม่ ในขณะนี้: 

    pod init

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

    pod 'GoogleSignIn'

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

    pod 'GoogleSignInSwiftSupport'

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

    pod install

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

    คุณสามารถดูตัวอย่างแอป Objective-C Podfile

เครื่องมือจัดการแพ็กเกจ Swift

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

  2. เพิ่มทรัพยากร Dependency ของ Google Sign-In ลงในแอป (เอกสารประกอบ Xcode):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Google Sign-In กำหนดให้ต้องกำหนดค่าโปรเจ็กต์ด้วยรหัสไคลเอ็นต์ OAuth และ Scheme ของ URL ที่กำหนดเอง นอกจากนี้ คุณยังเพิ่มรหัสไคลเอ็นต์ของเซิร์ฟเวอร์สำหรับ การตรวจสอบสิทธิ์แบ็กเอนด์หรือเพิ่มประสิทธิภาพแอปเพื่อ 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 เพื่อจัดเก็บข้อมูลเข้าสู่ระบบผ่าน พวงกุญแจ

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

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