เอกสารนี้จะอธิบายวิธีเริ่มพัฒนาด้วย Nearby Messages API ใน iOS
ขั้นตอนที่ 1: ดาวน์โหลด Xcode เวอร์ชันล่าสุด
หากต้องการสร้างโปรเจ็กต์โดยใช้ Google Nearby Messages API สำหรับ iOS คุณต้องใช้ Xcode เวอร์ชัน 6.3 ขึ้นไป
ขั้นตอนที่ 2: ดาวน์โหลด CocoaPods
Google Nearby Messages API สำหรับ iOS พร้อมให้ใช้งานในรูปแบบพ็อด CocoaPods CocoaPods เป็นเครื่องมือจัดการทรัพยากร Dependency แบบโอเพนซอร์สสำหรับโปรเจ็กต์ Swift และ Objective-C Cocoa
หากยังไม่มีเครื่องมือ CocoaPods ให้ติดตั้งบน OS X โดยเรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล โปรดดูรายละเอียดในคู่มือเริ่มต้นใช้งาน CocoaPods
$ sudo gem install cocoapods
ขั้นตอนที่ 3: ติดตั้ง API โดยใช้ CocoaPods
สร้าง Podfile
สำหรับ Google Nearby Messages API สำหรับ iOS และใช้เพื่อติดตั้ง API และการอ้างอิงของ API ดังกล่าว
- หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์ตอนนี้และบันทึกลงในเครื่องของคุณเอง (หากคุณเพิ่งเริ่มใช้งานการพัฒนาสำหรับ iOS ให้สร้างแอปพลิเคชัน มุมมองเดียว และตรวจสอบว่า "ใช้การนับการอ้างอิงอัตโนมัติ" เปิดอยู่)
- สร้างไฟล์ชื่อ
Podfile
ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะระบุทรัพยากร Dependency ของโปรเจ็กต์ แก้ไข
Podfile
และเพิ่มทรัพยากร Dependency ต่อไปนี้เป็น Podspec อย่างง่าย รวมถึงชื่อพ็อดที่คุณต้องการสำหรับ Google Nearby Messages API สำหรับ iOSsource 'https://github.com/CocoaPods/Specs.git' platform :ios, '7.0' pod 'NearbyMessages'
บันทึก
Podfile
เปิดเทอร์มินัลและไปที่ไดเรกทอรีที่มี
Podfile
:$ cd
เรียกใช้คำสั่ง
pod install
การดำเนินการนี้จะติดตั้ง API ที่ระบุใน Podspec พร้อมกับทรัพยากร Dependency ที่อาจมีติดตั้ง $ Pod
ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์
.xcworkspace
ของโปรเจ็กต์เพื่อเปิด Xcode หลังจากนั้น คุณต้องใช้ไฟล์.xcworkspace
เพื่อเปิดโปรเจ็กต์
ขั้นตอนที่ 4: สร้างส่วนหัวการบริดจ์ (Swift เท่านั้น)
หากสร้างโปรเจ็กต์โดยใช้ Swift คุณต้องเพิ่มส่วนหัวการบริดจ์ลงในโปรเจ็กต์เพื่อให้สามารถใช้ไลบรารีที่ติดตั้งโดยไฟล์พ็อดได้ ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มส่วนหัวการบริดจ์
- ในไดเรกทอรีเดียวกันกับไฟล์
.xcworkspace
ของโปรเจ็กต์ ให้เพิ่มไฟล์ส่วนหัวใหม่ (ตั้งชื่อตามใจชอบและใช้นามสกุลไฟล์เป็น ".h") - วางโค้ดต่อไปนี้ลงในไฟล์ที่คุณสร้าง
#import <GNSMessages.h>
- บันทึกไฟล์
- ในแผงซ้ายของเครื่องมือแก้ไขโปรเจ็กต์ ให้เลือกโปรเจ็กต์หลัก
- คลิกการตั้งค่าบิลด์ที่ด้านบนของเครื่องมือแก้ไขบิลด์
- ในการตั้งค่าบิลด์ ให้ไปที่ "Swift Compiler - Code Generation" (พิมพ์ "Swift Compiler" ลงในช่องค้นหาเพื่อค้นหาอย่างรวดเร็ว)
- คลิกลูกศรเพื่อขยายส่วน Objective-C Bridging Header
- ในส่วนแก้ไขข้อบกพร่องและเผยแพร่ ให้เพิ่มเส้นทางไปยังไฟล์ส่วนหัวที่สร้างไว้
- สร้างโปรเจ็กต์เพื่อให้การเปลี่ยนแปลงมีผล
ขั้นตอนที่ 5: สร้างบัญชี Google
หากต้องการใช้ Nearby Messages API คุณต้องมีบัญชี Google หากมีบัญชีอยู่แล้ว ไม่ต้องดำเนินการใดๆ หรือคุณอาจต้องการบัญชี Google แยก เพื่อวัตถุประสงค์ในการทดสอบ
ขั้นตอนที่ 6: รับคีย์ API
ทำตามขั้นตอนต่อไปนี้เพื่อเปิดใช้ Google Nearby Messages API สำหรับ iOS และรับคีย์ API
- ไปที่ Google Developers Console
- สร้างหรือเลือกโปรเจ็กต์ที่จะใช้ลงทะเบียนแอปพลิเคชัน
- คลิกต่อไปเพื่อเปิดใช้ API
- ในหน้าข้อมูลเข้าสู่ระบบ ให้สร้างคีย์ iOS ใหม่ (และตั้งค่าข้อมูลเข้าสู่ระบบ API)
หมายเหตุ: หากมีคีย์ iOS อยู่แล้ว ก็สามารถใช้คีย์นั้นได้ - ในกล่องโต้ตอบที่แสดง ให้ป้อนตัวระบุ Bundle ของแอป ตัวอย่างเช่น
com.example.nearbyexample
- คีย์ API สำหรับ iOS ใหม่จะปรากฏในรายการคีย์ API สำหรับโปรเจ็กต์ของคุณ
คีย์ API เป็นสตริงอักขระดังนี้
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- โปรดรักษาความปลอดภัยของคีย์ API โดยทำตามแนวทางปฏิบัติแนะนำเหล่านี้เพื่อป้องกันการขโมยโควต้า
ขั้นตอนที่ 7: สร้างออบเจ็กต์ตัวจัดการข้อความ
ออบเจ็กต์ตัวจัดการข้อความช่วยให้คุณเผยแพร่และสมัครรับข้อมูลได้ การแลกเปลี่ยนข้อความไม่ผ่านการตรวจสอบสิทธิ์ คุณจึงต้องระบุคีย์ API ที่สร้างไว้ในขั้นตอนก่อนหน้า
Objective-C
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
Swift
let messageManager = GNSMessageManager(APIKey: "API_KEY")