שנתחיל?

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

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

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

שלב 2: קבלת CocoaPods

Google Nearby Messages API ל-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)

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

שלב 4: יצירת כותרת גישור (ב-Swift בלבד)

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

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

שלב 5: יוצרים חשבון Google

כדי להשתמש בממשקי 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-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")