Kayıt ve API anahtarları

Google Awareness API'yi kullanmak için uygulamanıza bir Google API anahtarı eklemeniz gerekir. İhtiyacınız olan API anahtarı türü, Android API anahtarıdır.

Tüm Android uygulamaları, özel anahtarına sahip olduğunuz bir dijital sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için uygulamanızı imzalama ile ilgili Android kılavuzuna bakın.

Android API anahtarları, belirli sertifika-paket çiftlerine bağlıdır. Uygulamanızın kaç kullanıcısı olursa olsun her sertifika için yalnızca bir anahtara ihtiyacınız vardır.

Uygulamanız için anahtar almak üzere birkaç adım uygulamanız gerekir. Bu adımlar bu kılavuzda ayrıntılı olarak açıklanmış olup aşağıdaki gibi özetlenmiştir:

  1. Uygulamanızın sertifikası hakkında bilgi edinme
  2. Google Developers Console'da bir proje kaydedin ve User Context API'yi proje için hizmet olarak ekleyin.
  3. Anahtar isteyin.
  4. Anahtarı uygulamanıza ekleyin. Bunun için uygulama manifestinize bir öğe ekleyin.

Uygulamanızın sertifika bilgilerini bulma

API anahtarı, uygulamanızın dijital sertifikasının SHA-1 parmak izi olarak bilinen kısa bir biçimine dayanır. Sertifikanızın SHA-1 parmak izini görüntülemek için öncelikle doğru sertifikayı kullandığınızdan emin olun. Aşağıdaki iki sertifika arasından seçim yapabilirsiniz:

  • Hata ayıklama sertifikası: Android SDK araçları, hata ayıklama derlemesi yaptığınızda bu sertifikayı otomatik olarak oluşturur. Bu sertifikayı yalnızca test ettiğiniz uygulamalarda kullanın. Hata ayıklama sertifikasıyla imzalanmış bir uygulamayı yayınlamaya çalışmayın. Hata ayıklama sertifikası, Android geliştirici belgelerinin Hata ayıklama derlemenizi imzalama bölümünde daha ayrıntılı olarak açıklanmıştır.
  • Yayın sertifikası: Android SDK araçları, yayınlanan derleme oluşturduğunuzda bu sertifikayı oluşturur. Bu sertifikayı keytool programıyla da oluşturabilirsiniz. Uygulamanızı tüm dünyada kullanıma sunmaya hazır olduğunuzda bu sertifikayı kullanın.

keytool hakkında daha fazla bilgi için Oracle belgelerine bakın.

Hata ayıklama sertifikası

Hata ayıklama sertifikası parmak izini görüntüleme

Bir sertifikanın SHA-1 parmak izini görüntülemek için keytool programını -v parametresiyle kullanın. Bunun için aşağıdaki adımları uygulayın:

  1. Hata ayıklama anahtar deposu dosyanızı bulun. Dosya adı debug.keystore şeklindedir ve projenizi ilk kez derlediğinizde oluşturulur. Varsayılan olarak, Android Sanal Cihazı (AVD) dosyalarınızla aynı dizinde depolanır:

    • OS X ve Linux: ~/.android/
    • Windows Vista ve Windows 7: C:\Users\your_user_name\.android\

  2. SHA-1 parmak izini listeleme:

    • Linux veya OS X için bir terminal penceresi açın ve aşağıdakileri girin:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Windows Vista ve Windows 7 için aşağıdakileri çalıştırın:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Şuna benzer bir çıkış alırsınız:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
Sertifikayı yayınlama

Sürüm sertifikası parmak izini görüntüleme

Bir sertifikanın SHA-1 parmak izini görüntülemek için keytool programını -v parametresiyle kullanın. Bunun için aşağıdaki adımları uygulayın:

  1. Sürüm sertifikası anahtar deposu dosyanızı bulun. Sürüm anahtar deposu için varsayılan bir konum veya ad yoktur. Uygulamanızı yayınlamak için derlerken bir anahtar belirtmezseniz derleme, .apk dosyanızı imzasız bırakır ve yayınlamadan önce imzalamanız gerekir. Sürüm sertifikası için sertifikanın takma adı, anahtar deposunun şifreleri ve sertifika da gerekir.

  2. Bir anahtar deposundaki tüm anahtarların takma adlarını listelemek için aşağıdakileri girin:

    keytool -list -keystore your_keystore_name
  3. your_keystore_name ifadesini anahtar deposunun tam yolu ve adıyla değiştirin. .keystore uzantısını ekleyin. İstendiğinde anahtar deposunun şifresini girin. Ardından, keytool anahtar deposundaki tüm takma adları gösterir.

  4. Terminal veya komut istemine aşağıdakileri girin:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. your_keystore_name ifadesini anahtar deposunun tam yolu ve adıyla değiştirin. .keystore uzantısını ekleyin.
  6. your_alias_name ifadesini, sertifikayı oluştururken atadığınız takma adla değiştirin.

Şuna benzer bir çıkış alırsınız:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 ile başlayan satır, sertifikanın SHA-1 parmak izini içerir. Parmak izi, iki nokta üst üste ile ayrılmış 20 adet iki basamaklı onaltılık sayı dizisidir.

Google Developers Console'dan API anahtarı alma

Google Awareness API'yi kullanmaya başlamak için Anahtar al düğmesini tıklayın. Bu düğme, sizi Google Developers Console'a yönlendirir. Console, süreç boyunca size yol gösterir ve Awareness API'yi otomatik olarak etkinleştirir.

Anahtar alma

Alternatif olarak, API anahtarı almak için aşağıdaki adımları uygulayabilirsiniz:

  1. Google Developers Console'a gidin.
  2. Bir proje seçin veya yeni bir proje oluşturun.
  3. Awareness API'yi etkinleştirmek için Continue'yu (Devam) tıklayın.

  4. "Kimlik bilgileri" sayfasında bir Android anahtarı oluşturun ve API kimlik bilgilerini ayarlayın.

  5. "Anahtar oluştur" iletişim kutusunda, kullanımınızı Android uygulamalarıyla kısıtlamanız gerekir. Bunu yapmak için uygulamanızın SHA-1 parmak izini ve paket adını aşağıdaki örnekte gösterildiği gibi girin:

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example

  6. Oluştur'u tıklayın. Yeni Android API anahtarınız, projenizin API anahtarları listesinde görünür. API anahtarı, aşağıdaki gibi bir karakter dizesidir:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

API anahtarınızı aldıktan sonra, Başlangıç kılavuzunda açıklandığı şekilde uygulamanızın manifest dosyasına ekleyebilirsiniz.

Ek API'leri etkinleştirme

Awareness API, işaretçiler gibi birden fazla içerik verisi türüne erişmenize olanak tanır. Bu türleri kullanmak için Google Developers Console'da ilgili API'leri etkinleştirmeniz gerekir.

Hizmet Awareness API yöntemleri Etkinleştirilecek API
İşaretçiler SnapshotApi.getBeaconState(), FenceApi.BeaconFence Nearby Messages API