สร้างโปรเจ็กต์ Xcode

หลังจากเปิดใช้การเรียกเก็บเงินและสร้างคีย์ API แล้ว คุณก็พร้อมที่จะตั้งค่าโปรเจ็กต์ Xcode ที่ใช้พัฒนาแอป

บันทึกประจำรุ่นมีให้ใช้งานสำหรับการเผยแพร่แต่ละครั้ง

ขั้นตอนที่ 1: ติดตั้งซอฟต์แวร์ที่จำเป็น

หากต้องการสร้างโปรเจ็กต์โดยใช้ Places SDK สำหรับ iOS คุณต้องมีสิ่งต่อไปนี้

  • Xcode เวอร์ชัน 26.0 ขึ้นไป

ขั้นตอนที่ 2: สร้างโปรเจ็กต์ Xcode และติดตั้ง Places SDK สำหรับ iOS

Swift Package Manager

คุณสามารถติดตั้ง Places SDK สำหรับ iOS ผ่าน Swift Package Manager ได้ หากต้องการเพิ่ม SDK โปรดตรวจสอบว่าคุณได้ นำการขึ้นต่อกันของ Places SDK สำหรับ iOS ที่มีอยู่ออกแล้ว

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิด project หรือ workspace ของ Xcode แล้วไปที่ไฟล์ > เพิ่มการขึ้นต่อกันของแพ็กเกจ
  2. ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL กด Enter เพื่อดึงแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
  3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกัน เป็นตัวเลือกใดตัวเลือกหนึ่งที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
  4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ตรวจสอบว่าระบบจะเพิ่ม GooglePlaces GooglePlacesSwift หรือทั้ง 2 อย่างลงในเป้าหมายหลักที่กำหนด เมื่อเสร็จแล้ว ให้คลิกเพิ่มแพ็กเกจ

    หากคุณกำลังอัปเดต Google Places Swift จาก URL GitHub ที่เลิกใช้งานแล้ว

    สำคัญ: URL GitHub สำหรับเข้าถึง Google Places Swift ได้เปลี่ยนไปแล้วโดยเริ่มตั้งแต่เวอร์ชัน 0.3.0 หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำออกในส่วนการขึ้นต่อกันของแพ็กเกจใน Xcode

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

หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  1. จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด

    หากคุณกำลังอัปเดต Google Places Swift จาก URL GitHub ที่เลิกใช้งานแล้ว

    สำคัญ: URL GitHub สำหรับเข้าถึง Google Places Swift ได้เปลี่ยนไปแล้วโดยเริ่มตั้งแต่เวอร์ชัน 0.3.0 หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำออกในส่วนการขึ้นต่อกันของแพ็กเกจใน Xcode

  2. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจ ในแถบนำทางของโปรเจ็กต์ เพื่อยืนยันแพ็กเกจและเวอร์ชัน

หากต้องการนำ Places SDK สำหรับ iOS ที่ติดตั้งด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้

  1. จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำเฟรมเวิร์กต่อไปนี้ออก
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. จากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ให้นำ GooglePlaces บันเดิลออก

การติดตั้งด้วยตนเอง

คู่มือนี้แสดงวิธีเพิ่ม XCFrameworks ที่มี Places SDK สำหรับ iOS และ Places Swift SDK สำหรับ iOS ลงใน โปรเจ็กต์ด้วยตนเอง และกำหนดค่าการตั้งค่าการสร้างใน Xcode XCFramework เป็นแพ็กเกจไบนารีที่คุณใช้ได้ในหลายแพลตฟอร์ม รวมถึงเครื่อง ที่ใช้ Apple Silicon คุณสามารถเลือกเพิ่ม Places SDK สำหรับ iOS, Places Swift SDK สำหรับ iOS หรือทั้ง 2 อย่าง

  1. ดาวน์โหลดไฟล์ไบนารีและไฟล์ทรัพยากร SDK ต่อไปนี้
  2. หากคุณกำลังติดตั้ง Places Swift SDK สำหรับ iOS ให้ติดตั้งไฟล์ต่อไปนี้
  3. แตกไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร
  4. เปิด Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มพัฒนาแอป iOS ให้สร้างโปรเจ็กต์ใหม่และ เลือก เทมเพลตแอป iOS
  5. นำบันเดิล Maps จากเวอร์ชันก่อนหน้าออกจากโปรเจ็กต์
  6. เปิดแท็บทั่วไป ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ ในส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ตรวจสอบว่าได้เลือกไม่ฝัง:
    • GooglePlaces.xcframework
    หากคุณกำลังติดตั้ง Places Swift SDK ให้ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ ในส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ตรวจสอบว่าได้เลือกไม่ฝัง:
    • GooglePlacesSwift.xcframework
  7. คัดลอก GooglePlaces.bundle จาก GooglePlacesResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ตรวจสอบว่าได้เลือก คัดลอกรายการลงในโฟลเดอร์ของกลุ่มปลายทาง เมื่อระบบแจ้ง

    หากคุณกำลังติดตั้ง Places Swift SDK ให้คัดลอก GooglePlacesSwift.bundle จาก GooglePlacesSwiftResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ตรวจสอบว่าได้เลือกคัดลอกรายการลงในโฟลเดอร์ของกลุ่มปลายทาง เมื่อระบบแจ้ง
  8. เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
  9. เปิดแท็บขั้นตอนการสร้าง ในส่วนลิงก์ไบนารีกับ ไลบรารี ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework

  10. เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิด แท็บการตั้งค่าการสร้าง ในส่วนการลิงก์ - ทั่วไป -> แฟล็กของลิงเกอร์ อื่นๆ ให้เพิ่ม -ObjC ลงใน "ดีบัก" และ "เผยแพร่" หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าการสร้าง จากพื้นฐาน เป็นทั้งหมด

ขั้นตอนที่ 3: เพิ่มคีย์ API ลงในแอป

ในตัวอย่างต่อไปนี้ ให้แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ

GooglePlacesSwift

เพิ่มคีย์ API ลงใน AppDelegate.swift ดังนี้

  • เพิ่มคำสั่งนำเข้าต่อไปนี้ 
    import GooglePlacesSwift
  • เพิ่มข้อมูลต่อไปนี้ลงในเมธอด application(_:didFinishLaunchingWithOptions:) โดยแทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ 
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

เพิ่มคีย์ API ลงใน AppDelegate.swift ดังนี้

  • เพิ่มคำสั่งนำเข้าต่อไปนี้ 
    import GooglePlaces
  • เพิ่มข้อมูลต่อไปนี้ลงในเมธอด application(_:didFinishLaunchingWithOptions:) โดยแทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

เพิ่มคีย์ API ลงใน AppDelegate.m ดังนี้

  • เพิ่มคำสั่งนำเข้าต่อไปนี้ 
    @import GooglePlaces;
  • เพิ่มข้อมูลต่อไปนี้ลงในเมธอด application:didFinishLaunchingWithOptions: โดยแทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

ขั้นตอนที่ 4 (ไม่บังคับ): ตรวจสอบไฟล์ Manifest ความเป็นส่วนตัวของ Apple

Apple กำหนดให้แอปใน App Store ต้องมีรายละเอียดความเป็นส่วนตัวของแอป โปรดไปที่หน้าข้อมูลความเป็นส่วนตัวของ Apple App Store เพื่อดูข้อมูลอัปเดตและข้อมูลเพิ่มเติม

ไฟล์ Manifest ความเป็นส่วนตัวของ Apple จะรวมอยู่ในบันเดิลทรัพยากรของ SDK หากต้องการยืนยันว่าได้รวมไฟล์ Manifest ความเป็นส่วนตัวไว้แล้วและตรวจสอบเนื้อหา ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร

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