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ını sizin tuttuğunuz bir dijital sertifikayla imzalanır. Dijital sertifikalar hakkında daha fazla bilgi için uygulamanızı imzalama ile ilgili Android kılavuzunu inceleyin.

Android API anahtarları belirli sertifika-paket çiftlerine bağlıdır. Uygulamanızda kaç kullanıcınız 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ıştır ve aşağıda özetlenmiştir:

1. Uygulamanızın sertifikası hakkında bilgi edinin.
2. Google Developers Console'a bir proje kaydedin ve projeye User Context API'yi hizmet olarak ekleyin.
3. Anahtar isteyin.
4. Anahtarı uygulamanıza ekleyin. Bunu yapmak için uygulama manifest dosyanıza bir öğe ekleyin.

Uygulamanızın sertifika bilgilerini bulma

API anahtarı, uygulamanızın dijital sertifikasının kısa bir formunu (SHA-1 parmak izi olarak bilinir) temel alır. Sertifikanızın SHA-1 parmak izini görüntülemek için önce 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 dokümanlarında yer alan Hata ayıklama derlemenizi imzalama bölümünde daha ayrıntılı şekilde açıklanmıştır.
• Sürüm sertifikası: Android SDK araçları, sürüm derlemesi yaptığınızda bu sertifikayı oluşturur. Bu sertifikayı keytool programıyla da oluşturabilirsiniz. Uygulamanızı herkese sunmaya hazır olduğunuzda bu sertifikayı kullanın.

keytool hakkında daha fazla bilgi için Oracle dokümanlarına göz atı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 paketi dosyanızı bulun. Dosya adı debug.keystore'tür 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 listeleyin:

   • Linux veya OS X için bir terminal penceresi açıp 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

Sertifika 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 mağazası için varsayılan bir konum veya ad yoktur. Uygulamanızı yayınlamak için derlediğiniz sırada bir .apk belirtmezseniz derleme işlemi, .apk dosyanızı imzalamaz ve yayınlamadan önce imzalamanız gerekir. Sürüm sertifikası için sertifikanın takma adı, anahtar deposunun şifreleri ve sertifikaya da ihtiyacınız vardır.

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

   keytool -list -keystore your_keystore_name
         

3. your_keystore_name yerine anahtar deposunun tam nitelikli yolunu ve adını yazın. .keystore uzantısını ekleyin. İstendiğinde anahtar deposunun şifresini girin. Ardından, keytool anahtar deposundaki tüm takma adları gösterir.

4. Terminale 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 nitelikli yolunu ve adını girerek değiştirin. .keystore uzantısını ekleyin.
6. your_alias_name kısmını, oluşturduğunuzda sertifikaya 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 noktayla ayrılmış 20 iki basamaklı on altılık sayının dizisidir.

Dikkat: Anahtar deponuzu ve anahtarınızı korumak için, bilgisayarınızın güvenliğinden emin değilseniz komut satırına storepass veya keypass bağımsız değişkenlerini girmeyin. Örneğin, herkese açık bir bilgisayarda terminal penceresi geçmişinize veya çalışan işlemlerinizin listesine bakarak şifreyi edinen bir kişi, imzalama sertifikanıza yazma erişimi elde edebilir. Bu durumda, söz konusu kullanıcı uygulamanızı değiştirebilir veya kendi uygulamasıyla değiştirebilir.

Google Developers Console'dan API anahtarı alma

Google Awareness API'yi kullanmaya başlamak için Anahtar al düğmesini tıklayın. Bu sayfa, Google Developers Console'a bağlantı verir. Bu konsolda, işlem boyunca size yol gösterilir ve Awareness API otomatik olarak etkinleştirilir.

Anahtar alma

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

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 Devam'ı tıklayın.

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

   Not: Mevcut bir Android anahtarınız varsa bunu kullanabilirsiniz.

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 dizisidir:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

API anahtarınız hazır olduğunda Başlayın kılavuzunda açıklandığı gibi anahtarı uygulamanızın manifest dosyasına ekleyebilirsiniz.

Ek API'leri etkinleştirme

Awareness API, işaretçi gibi birden fazla bağlamsal veri 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çi	SnapshotApi.getBeaconState(), FenceApi.BeaconFence	Nearby Messages API