البدء

يوضِّح هذا المستند كيفية بدء تطوير التطبيقات باستخدام واجهة برمجة التطبيقات Nearby Messages API على Android. واجهة برمجة التطبيقات Nearby Messages API هي جزء من خدمات Google Play.

الخطوة 1: الحصول على "خدمات Google Play"

تتوفّر واجهة برمجة التطبيقات Nearby Messages API على أجهزة Android التي تعمل بالإصدار 7.8.0 من خدمات Google Play أو الإصدارات الأحدث. تتلقّى تلقائيًا الأجهزة التي تعمل بالإصدار 2.3 من نظام التشغيل Android أو الإصدارات الأحدث والتي تم تثبيت تطبيق "متجر Google Play" عليها تحديثات "خدمات Google Play". للاطّلاع على إصدار "خدمات Google Play" المثبّت على جهازك، انتقِل إلى الإعدادات > التطبيقات > خدمات Google Play.

تأكَّد من توفُّر أحدث مكتبة عملاء لـ "خدمات Google Play" على مضيف التطوير:

  1. افتح مدير حزمة تطوير البرامج (SDK) لنظام التشغيل Android.

  2. ضمن المظهر والسلوك > إعدادات النظام > حزمة تطوير البرامج (SDK) لنظام التشغيل Android > أدوات حزمة SDK، تأكّد من تثبيت الحِزم التالية:

    • خدمات Google Play
    • Google Repository

الخطوة 2: الحصول على حساب Google

لاستخدام واجهات برمجة تطبيقات "الرسائل عن قرب"، يجب أن يكون لديك حساب Google. يُرجى إجراء ذلك كي تتمكّن أنت كمطوّر من تفعيل Nearby API في الخطوة التالية (لن يحتاج المستخدمون إلى امتلاك حساب Google). إذا كان لديك حساب، يعني هذا أنّك قد انتهيت من عملية إعداد حسابك. قد تحتاج أيضًا إلى حساب Google منفصل لأغراض الاختبار.

الخطوة 3: الحصول على مفتاح واجهة برمجة التطبيقات

اتّبِع الخطوات التالية لتفعيل Google Nearby Messages API لنظام التشغيل Android والحصول على مفتاح واجهة برمجة التطبيقات:

  1. انتقِل إلى Google Developers Console.
  2. أنشئ مشروعًا أو اختَره لتسجيل تطبيقك.
  3. انقر على متابعة لتفعيل واجهة برمجة التطبيقات.
  4. في صفحة بيانات الاعتماد، أنشئ مفتاح Android جديدًا (واضبط بيانات اعتماد واجهة برمجة التطبيقات).
    ملاحظة: إذا كان لديك مفتاح 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. سيظهر مفتاح واجهة برمجة التطبيقات الجديد لنظام التشغيل Android في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، على النحو التالي: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

الحصول على بصمة SHA1 لشهادتك

لإنشاء مفتاح واجهة برمجة تطبيقات جديد لتطبيق Android، تحتاج إلى الملف المرجعي SHA1 للشهادة التي تستخدمها لتوقيع ملف APK. لا يمكن تبادل الرسائل إلا بين التطبيقات الموقَّعة باستخدام مفاتيح واجهة برمجة التطبيقات من المشروع نفسه.

للحصول على بصمة الإصبع هذه:

  1. ابحث عن موقع ملف تخزين المفاتيح.
  2. في وحدة طرفية، شغِّل الأداة keytool من JDK. على سبيل المثال، إذا كنت تستخدِم ملف تخزين مفاتيح `debug`:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    ملاحظة: بالنسبة إلى ملف تخزين مفاتيح تصحيح الأخطاء، تكون كلمة المرور هي android. على نظامَي التشغيل Mac وLinux، يقع عادةً متجر مفاتيح تصحيح الأخطاء في ~/.android/debug.keystore. في نظام التشغيل Windows، يقع عادةً في %USERPROFILE%\.android\debug.keystore.

  3. يحتوي ناتج الأمر keytool على الملف المرجعي SHA1 للشهادة.

الخطوة 4: ضبط إعدادات مشروعك

يسهّل استوديو Android إنشاء مشروع لواجهة برمجة التطبيقات Nearby Messages API. اتّبِع الخطوات الموضّحة في إنشاء مشروع لإنشاء مشروع جديد. في Android Studio، افتح ملف build.gradle ل وحدتك وأضِف مكتبة عميل "خدمات Google Play" كتبعية:

apply plugin: 'android'
...

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

بعد ذلك، عليك ضبط البيان باستخدام مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه في الخطوة السابقة:

<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 موافقة المستخدم. عند تفعيل ميزة "النشر" أو "الاشتراك" للمرة الأولى، ستعرض ميزة "الأجهزة المجاورة" مربّع حوار للموافقة على المشاركة.