התחל בעבודה

במסמך הזה נסביר איך מתחילים לפתח באמצעות Nearby Messages API ב-iOS.

שלב 1: הורדת הגרסה האחרונה של Xcode

כדי ליצור פרויקט באמצעות Google Nearby Messages API ל-iOS, צריך גרסה 6.3 ואילך של Xcode.

שלב 2: הורדת CocoaPods

ה-API של Google Nearby Messages ל-iOS זמין בתור pod של CocoaPods. CocoaPods הוא מנהל יחסי תלות בקוד פתוח לפרויקטים של Swift ו-Objective-C Cocoa.

אם עדיין לא התקנתם את הכלי CocoaPods, תוכלו להתקין אותו ב-OS X על ידי הפעלת הפקודה הבאה מהטרמינל. פרטים נוספים זמינים במדריך למתחילים ב-CocoaPods.

$ sudo gem install cocoapods

שלב 3: התקנת ה-API באמצעות CocoaPods

יוצרים Podfile ל-Google Nearby Messages API ל-iOS ומשתמשים בו כדי להתקין את ה-API ואת יחסי התלות שלו.

  • אם עדיין אין לכם פרויקט Xcode, תוכלו ליצור אחד עכשיו ולשמור אותו במחשב המקומי. (אם אתם מפתחים חדשים ב-iOS, כדאי ליצור אפליקציה עם תצוגה אחת ולוודא שהאפשרות 'שימוש בספירת הפניות אוטומטית' מופעלת).
  • יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.

  • עורכים את Podfile ומוסיפים את יחסי התלות. לפניכם Podspec פשוט, שכולל את שם ה-pod שנחוץ ל-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, יחד עם כל יחסי התלות שלהם.

    $ pod install

  • סוגרים את Xcode ופותחים (לחיצה כפולה) את הקובץ .xcworkspace של הפרויקט כדי להפעיל את Xcode. מעכשיו והלאה, צריך להשתמש בקובץ .xcworkspace כדי לפתוח את הפרויקט.

שלב 4: יוצרים כותרת מקשרת (Swift בלבד)

אם יצרתם את הפרויקט באמצעות Swift, עליכם להוסיף לפרויקט כותרת גישור כדי שיהיה אפשר להשתמש בספריות שהותקנו על ידי קובץ ה-pod. כדי להוסיף כותרת גישור:

  1. באותה ספרייה שבה נמצא הקובץ .xcworkspace של הפרויקט, מוסיפים קובץ כותרת חדש (נותנים לו שם כלשהו ומשתמשים בסיומת '‎.h').
  2. מדביקים את הקוד הבא בקובץ שיצרתם: #import <GNSMessages.h>.
  3. שומרים את הקובץ.
  4. בחלונית הימנית של עורך הפרויקט, בוחרים את הפרויקט הראשי.
  5. לוחצים על Build Settings בחלק העליון של עורך ה-build.
  6. בהגדרות ה-Build, עוברים אל 'Swift Compiler – Code Generation' (מקלידים 'Swift Compiler' בתיבת החיפוש כדי לאתר את ההגדרה במהירות).
  7. לוחצים על החץ כדי להרחיב את הקטע Objective-C Bridging Header.
  8. בקטע Debug ו-Release, מוסיפים את הנתיב לקובץ הכותרת שיצרתם.
  9. כדי שהשינויים ייכנסו לתוקף, צריך לבנות את הפרויקט.

שלב 5: קבלת חשבון Google

כדי להשתמש בממשקי ה-API של Nearby Messages, צריך חשבון Google. אם כבר יש לכם חשבון, הכול מוכן. מומלץ גם ליצור חשבון Google נפרד למטרות בדיקה.

שלב 6: קבלת מפתח API

כדי להפעיל את Google Nearby Messages API ל-iOS ולקבל מפתח API:

  1. נכנסים ל Google Developers Console.
  2. יוצרים או בוחרים פרויקט שבו רוצים לרשום את האפליקציה.
  3. לוחצים על Continue כדי להפעיל את ה-API.
  4. בדף Credentials, יוצרים מפתח iOS חדש (ומגדירים את פרטי הכניסה ל-API).
    הערה: אם יש לכם מפתח iOS קיים, אתם יכולים להשתמש בו.
  5. בתיבת הדו-שיח שמופיעה, מזינים את מזהה החבילה של האפליקציה. לדוגמה: 
    com.example.nearbyexample
  6. מפתח ה-API החדש ל-iOS יופיע ברשימת מפתחות ה-API של הפרויקט. מפתח API הוא מחרוזת של תווים, למשל: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. כדי למנוע גניבת מכסות, כדאי לאבטח את מפתח ה-API לפי השיטות המומלצות הבאות.

שלב 7: יוצרים אובייקט של מנהל הודעות

אובייקט מנהל ההודעות מאפשר לפרסם ולבצע הרשמה. החלפת ההודעות לא מאומתת, לכן צריך לספק את מפתח ה-API שיצרתם בשלב הקודם.

Objective-CSwift

#import <GNSMessages.h>

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


let messageManager = GNSMessageManager(APIKey: "API_KEY")