สร้างโปรเจ็กต์ 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 ให้ตรวจสอบว่าคุณได้นำทรัพยากร Dependency ของ Places SDK สำหรับ iOS ที่มีอยู่ออกแล้ว

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

  1. เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
  2. ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
  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 ให้นำเวอร์ชันดังกล่าวออกจากส่วนทรัพยากร Dependency ของแพ็กเกจ Xcode

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

หากต้องการอัปเดต 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 ให้นำเวอร์ชันดังกล่าวออกจากส่วนทรัพยากร Dependency ของแพ็กเกจ Xcode

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

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

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

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

คู่มือนี้แสดงวิธีเพิ่ม 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 ต่อไปนี้ลงในโปรเจ็กต์ในส่วน Frameworks, Libraries, and Embedded Content ตรวจสอบว่าได้เลือกไม่ฝัง
    • GooglePlaces.xcframework
    หากคุณกำลังติดตั้ง Places Swift SDK ให้ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ของคุณในส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ตรวจสอบว่าได้เลือกไม่ฝัง
    • GooglePlacesSwift.xcframework
  7. คัดลอก GooglePlaces.bundle จาก GooglePlacesResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode อย่าลืมเลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางเมื่อได้รับข้อความแจ้ง

    หากคุณกำลังติดตั้ง Places Swift SDK ให้คัดลอก GooglePlacesSwift.bundle จาก GooglePlacesSwiftResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode อย่าลืมเลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางเมื่อได้รับข้อความแจ้ง
  8. เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
  9. เปิดแท็บ Build Phases ใน Link Binary with Libraries ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. เลือกโปรเจ็กต์แทนเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บ Build Settings ในส่วน Linking - General -> Other Linker Flags ให้เพิ่ม -ObjC ลงใน "Debug" และ "Release" หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าบิลด์จากพื้นฐานเป็นทั้งหมด

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

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

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

เพิ่มคีย์ 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 (ไม่บังคับ): ตรวจสอบไฟล์ Apple Privacy Manifest

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

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

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