התחל בעבודה

במסמך הזה מוסבר איך להתחיל לפתח באמצעות 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 install

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

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

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

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