หลังจากเปิดใช้การเรียกเก็บเงินและสร้างคีย์ 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 ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
projectหรือworkspaceแล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
-
หากต้องการติดตั้ง
versionที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันรายการใดรายการหนึ่ง สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" - จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าจะเพิ่ม
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 - หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ นอกจากนี้ คุณยังดูส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย
หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
จาก 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 - หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน
หากต้องการนำ Places SDK สำหรับ iOS ที่มีอยู่ซึ่งติดตั้งด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้
-
จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ (-) เพื่อนำเฟรมเวิร์กต่อไปนี้ออก
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
นำแพ็กเกจ
GooglePlacesออกจากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode
การติดตั้งด้วยตนเอง
คู่มือนี้แสดงวิธีเพิ่ม XCFrameworks ที่มี Places SDK สำหรับ iOS และ Places Swift SDK สำหรับ iOS ลงในโปรเจ็กต์ด้วยตนเอง และกำหนดการตั้งค่าบิลด์ใน Xcode XCFramework เป็นแพ็กเกจไบนารีที่คุณใช้ได้ในหลายแพลตฟอร์ม รวมถึงเครื่องที่ใช้ Apple Silicon คุณเลือกเพิ่ม Places SDK สำหรับ iOS, Places Swift SDK สำหรับ iOS หรือทั้ง 2 อย่างก็ได้
- ดาวน์โหลดไฟล์ไบนารีและทรัพยากรของ SDK ต่อไปนี้
- หากคุณกำลังติดตั้ง Places Swift SDK สำหรับ iOS ให้ติดตั้งไฟล์ต่อไปนี้
- แตกไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร
- เปิด Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มพัฒนา iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS
- นำแพ็กเกจ Maps จากรุ่นก่อนหน้าออกจากโปรเจ็กต์
-
เปิดแท็บทั่วไป ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ในส่วน Frameworks, Libraries, and Embedded Content ตรวจสอบว่าได้เลือกไม่ฝัง
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
คัดลอก
GooglePlaces.bundleจาก GooglePlacesResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode อย่าลืมเลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางเมื่อได้รับข้อความแจ้ง
หากคุณกำลังติดตั้ง Places Swift SDK ให้คัดลอกGooglePlacesSwift.bundleจาก GooglePlacesSwiftResources ที่คุณดาวน์โหลดลงในไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode อย่าลืมเลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางเมื่อได้รับข้อความแจ้ง - เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
-
เปิดแท็บ Build Phases ใน Link Binary with Libraries ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
เลือกโปรเจ็กต์แทนเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บ Build Settings ในส่วน Linking - General -> Other Linker Flags ให้เพิ่ม
-ObjCลงใน "Debug" และ "Release" หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าบิลด์จากพื้นฐานเป็นทั้งหมด
ขั้นตอนที่ 3: เพิ่มคีย์ API ลงในแอป
ในตัวอย่างต่อไปนี้ ให้แทนที่ YOUR_API_KEY ด้วยคีย์ API ของคุณ
เพิ่มคีย์ 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 ด้านความเป็นส่วนตัวไว้แล้ว และตรวจสอบเนื้อหา ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร
ขั้นตอนถัดไป
- เริ่มเขียนโค้ด จุดเริ่มต้นที่แนะนำคือการใช้แอปเริ่มต้นที่รับสถานที่ปัจจุบันของผู้ใช้
- หลังจากกำหนดค่าโปรเจ็กต์แล้ว คุณจะสำรวจแอปตัวอย่างได้
- ใช้ App Check เพื่อรักษาความปลอดภัยให้คีย์ API