במאמר הזה מוסבר איך להתחיל לפתח באמצעות 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 מותקנת במארח הפיתוח:
- פותחים את Android SDK Manager.
בקטע 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:
- נכנסים אל Google Developers Console.
- יוצרים או בוחרים פרויקט כדי לרשום בו את האפליקציה.
- לוחצים על Continue כדי להפעיל את ה-API.
- בדף Credentials, יוצרים Android key חדש (ומגדירים את פרטי הכניסה ל-API).
הערה: אם יש לכם מפתח Android קיים, אתם יכולים להשתמש בו. - בתיבת הדו-שיח שמופיעה, מזינים את טביעת האצבע 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
- מפתח ה-API החדש ל-Android מופיע ברשימת מפתחות ה-API של הפרויקט.
מפתח API הוא מחרוזת של תווים, למשל:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
איך מקבלים את טביעת האצבע מסוג SHA1 של האישור
כדי ליצור מפתח API חדש לאפליקציה ל-Android, צריך את טביעת האצבע SHA1 של האישור שמשמש לחתימה על ה-APK. אפשר להעביר הודעות רק בין אפליקציות שחתומות באמצעות מפתחות API מאותו פרויקט.
כדי לקבל את טביעת האצבע הזו:
- מאתרים את המיקום של מאגר המפתחות.
- במסוף, מריצים את הכלי
keytoolמ-JDK. לדוגמה, אם אתם משתמשים במאגר המפתחות`debug`: - הפלט של הפקודה
keytoolמכיל את טביעת האצבע SHA1 של האישור.
$ keytool -alias \ androiddebugkey -keystore \ ~/.android/debug.keystore -list -v
הערה: הסיסמה למאגר המפתחות לניפוי באגים היא android. ב-Mac OS וב-Linux, מאגר המפתחות לניפוי באגים נמצא בדרך כלל בכתובת ~/.android/. ב-Windows, הוא נמצא בדרך כלל בכתובת %USERPROFILE%\.
שלב 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, צריך לקבל הסכמה מהמשתמש. בפעם הראשונה שמופעלת פעולת פרסום או הרשמה, תוצג תיבת דו-שיח להבעת הסכמה.