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

Swift Package Manager

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

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

1. เปิด Xcode project หรือ workspace แล้วไปที่File > Add Package Dependencies
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. หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้ง นอกจากนี้ คุณยังดูส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

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

1. จาก Xcode ให้ไปที่ "File > Packages > Update To Latest Package Versions"

   หากคุณอัปเดต 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. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน

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

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

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

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

1. ดาวน์โหลดไฟล์ไบนารีและไฟล์ทรัพยากร SDK ต่อไปนี้
   • GooglePlaces
   • GooglePlacesResources
2. หากคุณกำลังติดตั้ง Places Swift SDK สำหรับ iOS ให้ติดตั้งไฟล์ต่อไปนี้
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. แตกไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร
4. เปิด Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มพัฒนาแอป iOS ให้สร้างโปรเจ็กต์ใหม่และ เลือกเทมเพลตแอป iOS
5. นำ Maps Bundle ออกจากโปรเจ็กต์ของคุณในรุ่นก่อนหน้า
6. เปิดแท็บทั่วไป ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ ในส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง โปรดเลือกห้ามฝัง
   • GooglePlaces.xcframework
   หากคุณกำลังติดตั้ง Places Swift SDK ให้ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ ในส่วนFrameworks, Libraries, and Embedded Content โปรดเลือกห้ามฝัง
   • 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. เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บการตั้งค่าการสร้าง ในส่วนการลิงก์ - ทั่วไป -> แฟล็ก Linker อื่นๆ ให้เพิ่ม -ObjC ลงใน "Debug" และ "Release" หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าบิลด์จากพื้นฐานเป็นทั้งหมด

CocoaPods

Places SDK สำหรับ iOS และ Places Swift SDK สำหรับ iOS พร้อมใช้งานเป็นพ็อด CocoaPod, GooglePlaces และ GooglePlacesSwift

CocoaPods เป็นเครื่องมือจัดการทรัพยากร Dependency แบบโอเพนซอร์สสำหรับโปรเจ็กต์ Swift และ Objective-C Cocoa หากยังไม่มีเครื่องมือ CocoaPods ให้ติดตั้งใน macOS โดยเรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล โปรดดูรายละเอียดใน คู่มือเริ่มต้นใช้งาน CocoaPods

sudo gem install cocoapods

สร้าง Podfile เพื่อติดตั้ง SDK และการอ้างอิงของ SDK

1. หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างตอนนี้และบันทึกลงใน เครื่องของคุณ หากเพิ่งเริ่มพัฒนาแอป iOS ให้สร้างโปรเจ็กต์ใหม่ และเลือกเทมเพลตแอป iOS
2. สร้างไฟล์ชื่อ Podfile ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้ จะกำหนดการอ้างอิงของโปรเจ็กต์
3. แก้ไข Podfile และเพิ่มทรัพยากร Dependency พร้อมกับเวอร์ชัน ตัวอย่างที่ระบุชื่อเป้าหมายของแอปพลิเคชันและชื่อของพ็อด GooglePlaces และ GooglePlacesSwift มีดังนี้

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '10.8.0'
     pod 'GooglePlacesSwift', '10.8.0'
   end

   โปรดเรียกใช้ pod outdated เป็นประจำเพื่อตรวจหาเมื่อมีเวอร์ชันใหม่กว่า เพื่อให้แน่ใจว่าคุณใช้เวอร์ชันล่าสุดอยู่เสมอ
4. บันทึกPodfile

5. เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีที่มี Podfile:

   cd <path-to-project>

6. เรียกใช้คำสั่ง pod install ซึ่งจะติดตั้ง API ที่ระบุใน Podfile พร้อมกับการอ้างอิง ที่อาจมี

   pod install

7. ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode นับจากนี้เป็นต้นไป คุณต้องใช้ไฟล์ .xcworkspace เพื่อเปิดโปรเจ็กต์

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

1. เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีโปรเจ็กต์ที่มี Podfile
2. เรียกใช้คำสั่ง pod update การดำเนินการนี้จะอัปเดต API ทั้งหมด ที่ระบุไว้ใน Podfile เป็นเวอร์ชันล่าสุด

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"];