الخطوات الأولى

يشرح هذا المستند كيفية بدء التطوير باستخدام واجهة برمجة تطبيقات "الرسائل القريبة" على Android تُعد واجهة برمجة تطبيقات "رسائل الأجهزة المجاورة" جزءًا من خدمات Google Play:

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

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

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

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

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

    • خدمات Google Play
    • مستودع Google

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

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

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

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

  1. الانتقال إلى Google Developers Console:
  2. أنشِئ أو اختَر مشروعًا لتسجيل تطبيقك فيه.
  3. انقر على متابعة لتفعيل واجهة برمجة التطبيقات.
  4. في صفحة Credentials (بيانات الاعتماد)، أنشئ مفتاح 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 OS وLinux، عادةً ما يكون مخزن مفاتيح تصحيح الأخطاء في ~/.android/debug.keystore. في نظام التشغيل Windows، من يقع عادةً في %USERPROFILE%\.android\debug.keystore.

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

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

يجعل استوديو Android السهل إنشاء مشروع لواجهة برمجة تطبيقات "الرسائل القريبة". اتّبِع الخطوات الموضّحة. في إنشاء مشروع لإنشاء مشروع جديد. في "استوديو Android"، افتح ملف 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: النشر والاشتراك

في تطبيقك، ابدأ استخدام واجهة برمجة تطبيقات "الرسائل القريبة".

@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();
}

تتطلب واجهة برمجة تطبيقات "الرسائل القريبة" موافقة المستخدم. عند النشر أو الاشتراك تم استدعاء الإجراء لأول مرة، ستعرض ميزة "الأجهزة المجاورة" مربّع حوار الموافقة.