البدء

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

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

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

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

  1. افتح Android SDK Manager.

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

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

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

لاستخدام واجهات برمجة التطبيقات Nearby Messages API، يجب أن يكون لديك حساب 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"، افتح ملف build.gradle للوحدة وأضِف مكتبة برامج "خدمات Google Play" كعنصر تابع:

apply plugin: 'android'
...

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

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

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