מתחילים

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

שלב 1: הורדת הגרסה העדכנית של Xcode

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

שלב 2: קבלת CocoaPods

Google Nearby Messages API ל-iOS זמין בתור של 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 פשוט, כולל שם הרצף שדרוש לך ל-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. לוחצים על החץ כדי להרחיב את הקטע Objective-C Bridging Header.
  8. בקטעים ניפוי באגים וגרסה, מוסיפים את הנתיב לקובץ הכותרת שרוצים. נוצר.
  9. בונים את הפרויקט כדי שהשינויים ייכנסו לתוקף.

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

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

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

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

  1. עוברים אל Google Developers Console
  2. יוצרים או בוחרים פרויקט שבו רוצים לרשום את הבקשה.
  3. לוחצים על Continue (המשך) כדי להפעיל את ה-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")