Bu belgede, Android'de Nearby Messages API ile geliştirmeye nasıl başlayacağınız açıklanmaktadır. Nearby Messages API, Google Play Hizmetleri'nin bir parçasıdır.
1. adım: Google Play Hizmetleri'ni edinin
Nearby Messages API, Google Play Hizmetleri 7.8.0 veya sonraki sürümlerin yüklü olduğu Android cihazlarda kullanılabilir. Google Play Store uygulamasına sahip olan ve Android 2.3 veya sonraki sürümleri çalıştıran cihazlar, Google Play Hizmetleri güncellemelerini otomatik olarak alır. Cihazınızda Google Play Hizmetleri'nin hangi sürümünün yüklü olduğunu kontrol etmek için Ayarlar > Uygulamalar > Google Play Hizmetleri'ne gidin.
Geliştirme ana makinenizde Google Play Hizmetleri için en yeni istemci kitaplığının bulunduğundan emin olun:
- Android SDK Manager'ı açın.
Appearance & Behavior > System Settings > Android SDK > SDK Tools (Görünüm ve Davranış > Sistem Ayarları > Android SDK > SDK Araçları) bölümünde aşağıdaki paketlerin yüklü olduğundan emin olun:
- Google Play Hizmetleri
- Google Deposu
2. adım: Google Hesabı oluşturun
Nearby Messages API'lerini kullanmak için bir Google Hesabınız olmalıdır. Bu sayede, geliştirici olarak bir sonraki adımda Nearby API'yi etkinleştirebilirsiniz (kullanıcılarınızın Google Hesabı olması gerekmez). Hesabınız varsa başka bir şey yapmanız gerekmez. Test amacıyla ayrı bir Google Hesabı da kullanmak isteyebilirsiniz.
3. adım: API anahtarı alın
Android için Google Nearby Messages API'yi etkinleştirmek ve API anahtarı almak üzere aşağıdaki adımları uygulayın:
- Google Developers Console'a gidin.
- Uygulamanızı kaydetmek için bir proje oluşturun veya seçin.
- Continue'yu (Devam) tıklayarak API'yi etkinleştirin.
- Kimlik bilgileri sayfasında yeni bir Android anahtarı oluşturun (ve API kimlik bilgilerini ayarlayın).
Not: Mevcut bir Android anahtarınız varsa bu anahtarı kullanabilirsiniz. - Açılan iletişim kutusunda uygulamanızın SHA-1 parmak izini ve paket adını girin. Örneğin:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
com.example.android.nearbyexample
- Yeni Android API anahtarınız, projenizin API anahtarları listesinde görünür.
API anahtarı, şuna benzer bir karakter dizesidir:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
Sertifikanızın SHA1 parmak izini alma
Android uygulamanız için yeni bir API anahtarı oluşturmak istiyorsanız APK'nızı imzalamak için kullandığınız sertifikanın SHA1 parmak izine ihtiyacınız vardır. Mesajlar yalnızca aynı projeden API anahtarlarıyla imzalanmış uygulamalar arasında paylaşılabilir.
Bu parmak izini almak için:
- Anahtar deponuzun konumunu bulun.
- Terminalde, JDK'den
keytoolyardımcı programını çalıştırın. Örneğin,`debug`anahtar deposunu kullanıyorsanız: keytoolkomutunun çıkışı, sertifikanın SHA1 parmak izini içerir.
$ keytool -alias \ androiddebugkey -keystore \ ~/.android/debug.keystore -list -v
Not: Hata ayıklama anahtar deposunun şifresi android şeklindedir. Mac OS ve Linux'ta hata ayıklama anahtar deposu genellikle ~/.android/ konumunda bulunur. Windows'da genellikle %USERPROFILE%\ konumunda bulunur.
4. adım: Projenizi yapılandırın
Android Studio, Nearby Messages API için proje oluşturmayı kolaylaştırır. Yeni bir proje oluşturmak için Proje Oluşturma bölümünde açıklanan adımları uygulayın. Android Studio'da modülünüzün build.gradle dosyasını açın ve Google Play Hizmetleri istemci kitaplığını bağımlılık olarak ekleyin:
apply plugin: 'android'
...
dependencies {
compile 'com.google.android.gms:play-services-nearby:19.5.1'
}
Ardından, manifest dosyanızı önceki adımda oluşturulan API anahtarıyla yapılandırın:
<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. adım: Yayınlama ve abone olma
Uygulamanızda Nearby Messages API'yi kullanmaya başlayın.
@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, kullanıcı izni gerektirir. Yayınlama veya abone olma ilk kez çağrıldığında Nearby, bir etkinleştirme iletişim kutusu gösterir.