เริ่มต้นใช้งาน

เอกสารนี้อธิบายวิธีเริ่มพัฒนาด้วย Nearby Messages API ใน iOS

ขั้นตอนที่ 1: รับ Xcode เวอร์ชันล่าสุด

หากต้องการสร้างโปรเจ็กต์โดยใช้ Google Nearby Messages API สำหรับ iOS คุณต้องมี เวอร์ชัน 6.3 ขึ้นไปของ Xcode

ขั้นตอนที่ 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 และทรัพยากร Dependency

  • หากยังไม่มีโปรเจ็กต์ Xcode โปรดสร้างโปรเจ็กต์ในตอนนี้และบันทึกไว้ใน ในเครื่อง (ถ้าคุณเพิ่งเริ่มใช้การพัฒนาซอฟต์แวร์ iOS ให้สร้างมุมมองเดียว แอปพลิเคชัน และตรวจสอบว่า "ใช้การนับการอ้างอิงอัตโนมัติ" เปิดอยู่)
  • สร้างไฟล์ชื่อ Podfile ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้ระบุ ทรัพยากร Dependency ของโปรเจ็กต์

  • แก้ไข Podfile และเพิ่มทรัพยากร Dependency ของคุณ ต่อไปนี้คือ Podspec ง่ายๆ รวมถึงชื่อพ็อดที่คุณต้องการสำหรับ Google Nearby Messages API iOS 

    source '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 คุณต้องเพิ่มส่วนหัวการบริดจ์ลงใน เพื่อให้ใช้ไลบรารีที่ติดตั้งโดยไฟล์พ็อดได้ ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มส่วนหัวการบริดจ์

  1. ในไดเรกทอรีเดียวกับไฟล์ .xcworkspace ของโปรเจ็กต์ ให้เพิ่ม ไฟล์ส่วนหัว (ตั้งชื่อตามต้องการ และใช้นามสกุลไฟล์เป็น ".h")
  2. วางโค้ดต่อไปนี้ลงในไฟล์ที่คุณสร้าง: #import <GNSMessages.h>
  3. บันทึกไฟล์
  4. เลือกโปรเจ็กต์หลักในแผงทางด้านซ้ายในเครื่องมือแก้ไขโปรเจ็กต์
  5. คลิกการตั้งค่าบิลด์ที่ด้านบนของเครื่องมือแก้ไขบิลด์
  6. ในการตั้งค่าบิลด์ ให้ไปที่ "Swift Compiler - Code Generation" (ประเภท "คอมไพเลอร์ Swift" ลงในช่องค้นหาเพื่อให้ค้นหาได้อย่างรวดเร็ว)
  7. คลิกลูกศรเพื่อขยายส่วนส่วนหัวการเชื่อมวัตถุประสงค์-C
  8. ในส่วนแก้ไขข้อบกพร่องและรุ่น ให้เพิ่มเส้นทางไปยังไฟล์ส่วนหัวที่คุณ สร้าง แล้ว
  9. สร้างโปรเจ็กต์เพื่อให้การเปลี่ยนแปลงมีผล

ขั้นตอนที่ 5: สร้างบัญชี Google

หากต้องการใช้ Nearby Messages API คุณต้องมีบัญชี Google หากมีบัญชีอยู่แล้ว คุณก็พร้อมใช้งานได้ คุณอาจต้องการ บัญชี Google แยกต่างหากเพื่อวัตถุประสงค์ในการทดสอบ

ขั้นตอนที่ 6: รับคีย์ API

ทำตามขั้นตอนต่อไปนี้เพื่อเปิดใช้ Google Nearby Messages API สำหรับ iOS และรับ คีย์ API:

  1. ไปที่หน้า Google Developers Console
  2. สร้างหรือเลือกโปรเจ็กต์ที่จะใช้ลงทะเบียนแอปพลิเคชัน
  3. คลิกต่อไปเพื่อเปิดใช้ API
  4. ในหน้าข้อมูลเข้าสู่ระบบ ให้สร้างคีย์ iOS ใหม่ (และตั้งค่า API ข้อมูลเข้าสู่ระบบ)
    หมายเหตุ: หากมีคีย์ iOS อยู่แล้ว คุณก็ใช้คีย์นั้นได้
  5. ในกล่องโต้ตอบที่แสดงขึ้น ให้ป้อนตัวระบุชุดของแอป ตัวอย่างเช่น 
    com.example.nearbyexample
  6. คีย์ API สำหรับ iOS ใหม่จะปรากฏในรายการคีย์ API สำหรับโปรเจ็กต์ของคุณ คีย์ API เป็นสตริงอักขระ มีลักษณะดังนี้ 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. รักษาความปลอดภัยให้คีย์ API ตามขั้นตอนต่อไปนี้เพื่อป้องกันการขโมยโควต้า แนวทางปฏิบัติแนะนำ

ขั้นตอนที่ 7: สร้างออบเจ็กต์เครื่องมือจัดการข้อความ

ออบเจ็กต์ตัวจัดการข้อความช่วยให้คุณเผยแพร่และสมัครรับข้อมูลได้ การแลกเปลี่ยนข้อความคือ ไม่ได้ตรวจสอบสิทธิ์ คุณจึงต้องระบุคีย์ API ที่สร้างไว้ก่อนหน้านี้ ครั้งแรก

Objective-C

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")