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

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

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

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

ขั้นตอนที่ 2: ดาวน์โหลด CocoaPods

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

หากยังไม่มีเครื่องมือ CocoaPods ให้ติดตั้งใน OS X โดยเรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล ดูรายละเอียดได้ที่คู่มือเริ่มต้นใช้งาน CocoaPods Getting Started

$ sudo gem install cocoapods

ขั้นตอนที่ 3: ติดตั้ง API โดยใช้ CocoaPods

สร้าง Podfile สำหรับ Google Nearby Messages API สำหรับ iOS แล้วใช้ไฟล์นี้เพื่อติดตั้ง API และทรัพยากร Dependency

  • หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์ตอนนี้และบันทึกลงในเครื่อง (หากคุณเพิ่งเริ่มพัฒนาแอป iOS ให้สร้างแอปพลิเคชัน Single View และตรวจสอบว่าได้เปิดใช้ Use Automatic Reference Counting แล้ว)
  • สร้างไฟล์ชื่อ 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 ที่ API อาจมี

    $ pod install

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

ขั้นตอนที่ 4: สร้างส่วนหัวการเชื่อมโยง (Swift เท่านั้น)

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

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

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

คุณต้องมี บัญชี Google จึงจะใช้ Nearby Messages API ได้ หากมีบัญชีอยู่แล้ว คุณก็พร้อมใช้งานได้ นอกจากนี้ คุณอาจต้องการบัญชี 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")