תחילת עבודה

במאמר הזה מוסבר איך להתחיל לפתח באמצעות Nearby Messages API ב-Android. ‫Nearby Messages API הוא חלק מ-Google Play Services.

שלב 1: מורידים את Google Play Services

‫Nearby Messages API זמין במכשירי Android עם Google Play Services מגרסה 7.8.0 ואילך. מכשירים עם Android מגרסה 2.3 ואילך שמותקנת בהם אפליקציית חנות Google Play מקבלים עדכונים ל-Google Play Services באופן אוטומטי. כדי לבדוק איזו גרסה של Google Play Services מותקנת במכשיר, עוברים אל הגדרות > אפליקציות > Google Play Services.

מוודאים שספריית הלקוח העדכנית של Google Play Services מותקנת במארח הפיתוח:

  1. פותחים את Android SDK Manager.
  2. בקטע Appearance & Behavior > System Settings > Android SDK > SDK Tools, מוודאים שהחבילות הבאות מותקנות:

    • Google Play Services
    • מאגר Google

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

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

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

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

  1. נכנסים אל Google Developers Console.
  2. יוצרים או בוחרים פרויקט כדי לרשום בו את האפליקציה.
  3. לוחצים על Continue כדי להפעיל את ה-API.
  4. בדף Credentials, יוצרים Android key חדש (ומגדירים את פרטי הכניסה ל-API).
    הערה: אם יש לכם מפתח Android קיים, אתם יכולים להשתמש בו.
  5. בתיבת הדו-שיח שמופיעה, מזינים את טביעת האצבע SHA-1 ואת שם החבילה של האפליקציה. לדוגמה:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.nearbyexample
  6. מפתח ה-API החדש ל-Android מופיע ברשימת מפתחות ה-API של הפרויקט. מפתח API הוא מחרוזת של תווים, למשל:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

איך מקבלים את טביעת האצבע מסוג SHA1 של האישור

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

כדי לקבל את טביעת האצבע הזו:

  1. מאתרים את המיקום של מאגר המפתחות.
  2. במסוף, מריצים את הכלי keytool מ-JDK. לדוגמה, אם אתם משתמשים במאגר המפתחות `debug`:
  3. $ keytool -alias \
    androiddebugkey -keystore \
    ~/.android/debug.keystore -list -v
    

    הערה: הסיסמה למאגר המפתחות לניפוי באגים היא android. ב-Mac OS וב-Linux, מאגר המפתחות לניפוי באגים נמצא בדרך כלל בכתובת ~/.android/debug.keystore. ב-Windows, הוא נמצא בדרך כלל בכתובת %USERPROFILE%\.android\debug.keystore.

  4. הפלט של הפקודה keytool מכיל את טביעת האצבע SHA1 של האישור.

שלב 4: מגדירים את הפרויקט

ב-Android Studio קל ליצור פרויקט ל-Nearby Messages API. כדי ליצור פרויקט חדש, פועלים לפי השלבים שמתוארים במאמר יצירת פרויקט. ב-Android Studio, פותחים את הקובץ build.gradle של המודול ומוסיפים את ספריית הלקוח של Google Play Services כתלות:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.5.1'
}

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

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

שלב 5: פרסום והרשמה

באפליקציה, מתחילים להשתמש ב-Nearby Messages API.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

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