Android uygulamalarınızı Google Play Servisleri ile entegre ederek, Haritalar, Drive ve Google+ gibi Google servislerine erişebilirsiniz. Uygulamalarınızı bu hizmetleri kullanacak şekilde ayarladıktan sonra, onlara erişmek genellikle basittir.
Kurulum işlemi birkaç adım gerektirir, ancak yalnızca bir kez gerçekleştirmeniz gerekir. Bu yazıda Google Play Hizmetlerini Android uygulamalarıyla entegre etmeye çalışacağız.
Giriş
Yazı boyunca, Eclipse ve Android Studio’daki uygulamaları Play Services ile entegre etmek için yapmanız gerekenleri özetleyeceğiz. Google Geliştirici Konsolu’na ve Keytool yardımcı programına erişmeniz gerekir.
Play Services’ı kurduğunuzda, geliştirme işleminin kendisi, uygulamalarınızın ne yapmasını istediğinize göre belirlenir. Ancak kurulum prosedürü aynı kalır. Platform hizmetlerine erişmek için client library (istemci kitaplığını) kullanarak, uygulamalarınız Google Play Store’daki otomatik güncellemelerden faydalanacaktır.
1. IDE’nize Play Services’i yükleyin
Aşama 1
IDE’nizi açın ve Android SDK Manager’ı başlatın. Eclipse’de Window > Android > SDK Manager (SDK Yöneticisi)’ni seçin . Android Studio’da, SDK Manager araç çubuğu düğmesini tıklayın. Listede ilerleyin, Extras (Ekstralar) klasörünü genişletin ve Google Play Services (Google Play Servisleri’ni) seçin .
Paketi kurmak ve istendiğinde lisansı kabul etmek için tıklayın. Android Studio’da geliştiriyorsanız, Google Repository (Google Deposunu) da kurmanız gerekir .
Adım 2
Google Play Hizmet API’lerini kullandığınız uygulamaları test ederken, ideal olarak, onları fiziksel cihazlarda çalıştırmalısınız. Ancak, emülatörde test etmek mümkündür. Bunu yapmak için, Google API Platformunu yüklemeniz gerekecektir . Bunu, 17 ve üzeri API seviyelerinin herhangi biri için dizinde bulabilirsiniz.
Platformu SDK Yöneticinizde bulun, kurun ve lisansı kabul edin. Bir uygulamayı Google Play Hizmetlerini kullanarak test etmek için bir AVD (Android Sanal Cihaz) ((Android Virtual Device) oluşturduğunuzda, hedef olarak Google API’ları seçin.
Aşama 3
Eclipse’de geliştiriyorsanız, Play Services kitaplığını çalışma alanınıza kopyalamanız gerekir. İlk önce, bir dosya gezgini kullanarak bilgisayarınıza göz atın. Android SDK’nızı indirdiğiniz klasörde bulabilirsiniz
/extras/google/google_play_services/libproject/google-play-services_lib/
Bilgisayarınızdaki Android geliştirme dosyaları için kullandığınız bir yere kopyalayın. Kütüphaneyi kopyaladıktan sonra (sürümü SDK dizininde kullanmak yerine kopyalamanız gerekir), Eclipse’e geri dönün. Seç Al dan Dosya menüsünden. Expand Android klasörü seçin Existing Android Code Into Workspace (Mevcut Android Kod içine Workspace) ve İleri ye tıklayın .
Click Browse (Gözat) düğmesini ve içine Play Services library (Play Hizmetleri kütüphane) kopyalanan konuma gidin. Kopyaladığınız klasörü seçin ve almak için Son’a tıklayın . Paketi Package Explorer (Paket Gezgini)’nde görünecektir.
2. Bir Android Projesi Yaratın
Aşama 1
Artık Play Services kaynaklarıyla geliştirmeye başlayabilirsiniz. IDE’nizde yeni bir Android projesi oluşturun.Çalışma alanınızda bir projeniz olduğunda, içindeki Play Services kaynaklarına başvurmanız gerekir.
Android Studio’da, uygulama projeniz için modülde build.gradle dosyasına bir inşa kuralı eklemeniz gerekir . Bu dependencies
bölümde aşağıdaki sözdizimini kullanın:
compile ‘com.google.android.gms:play-services:7.0.0’
Numarayı Play Services’ın en son sürümüne kullandığınızdan emin olun. Kütüphane güncellendiğinde bunu güncellemeniz gerekir. Dosyayı kaydedin ve Sync Project with Gradle Files (Projeyi Gradle Files ile Eşitle) düğmesine tıklayın.
6.5 sürümünden beri komple kütüphaneyi (çok büyük) veya sadece ihtiyacınız olan modülleri (En İyi Seçenek) ekleyebilirsiniz. Yani, yalnızca Google Haritalar ve Analytics’e ihtiyacınız varsa, önceki örneği aşağıdaki ile değiştirebilirsiniz:
dependencies { compile 'com.google.android.gms:play-services-base:7.0.0' compile 'com.google.android.gms:play-services-maps:7.0.0' }
Google Play Hizmetlerinin en yeni sürümünü burada bulabilirsiniz. Tam listesini burada bulabilirsiniz.
- Go to File -> Project Structure
- ‘Project Settings‘ i seç
- ‘Dependencies‘ Tabını seç
- ‘+‘ ya tıkla ve ‘1.Library Dependencies‘ i seç
- com.google.android.gms:play-services cümlesini arattır.
- Son versiyonu seç ve ‘OK‘ a tıkla
Eclipse’de Paket Gezgini’nde projeyi seçin, sağ tıklayın veya Project (Proje) menüsünü seçin ve Properties (Özellikler)’i seçin . Android i seçip sonra soldaki Library (Kütüphane) bölümündeki library yi seçerek Add (Ekle) tıkla.
Paket Listesi burada
Açılan pencereden Google Play Hizmetleri kütüphanesini seçin ve eklemek için Tamam’ı tıklayın . Apply (Uygula) ve Tamam’a tıklayın .
Adım 2
Hangi IDE’yi kullanıyorsanız kullanın, manifest dosyanıza Play Services meta-data eklemeniz gerekir. Projenin manifest dosyasını açın ve application
öğesinin içine meta-data öğesini ekleyin:
meta-data android:name=”com.google.android.gms.version”
android:value=”@integer/google_play_services_version”
Proguard kullanıyorsanız, bir istisna oluşturmanız gerekir. Daha fazla ayrıntı için Geliştirici Kılavuzuna bakın. Google Play Hizmet API’lerine genel bir bakış için Paket Dizini’ne göz atın .
3. Uygulamalarınızdaki Play Services ile bağlantı kurma
Adım 1
Uygulama kodunuzda atmanız gereken işlem adımları, Play Services ile hangi işlevselliği uygulamak istediğinize bağlı olacaktır. Aşağıdaki bölümlerde bazı genel düşünceler ve adımlar açıklanmaktadır.
Güncellemeler Google Play Store üzerinden yayınlansa da, Google Play Hizmetleri ile herhangi bir işlem yapmayı denemeden önce, kullanıcı cihazının hangi sürümünün yüklü olduğunu kontrol etmeniz önerilir.
Bkz Implementing GCM Client (Uygulama GCM Müşteri) bir mesafede olan bu kontrolleri nasıl uygulanacağı bir bakış için Geliştirici Kılavuzu’nda örnek kod Activity
sınıfında. Aranacak yöntem çağrısı isGooglePlayServicesAvailable
, aşağıdaki alıntıdaki gibi yardımcı bir yönteme ekleyebileceğiniz yöntemdir:
private boolean checkPlayServices() { int resultCode = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this); //... }
Play Services kaynaklarına eriştiğiniz örneği onCreate
oluşturmayı denemeden önce ve içindeki yöntemi çağırabilirsiniz . Kullanıcı cihazında kurulu gerekli kaynaklar yoksa, onlardan Google Play Store aracılığıyla istenir. GoogleAPIClient
onResume
Adım 2
Kullanıcı cihazındaki destek düzeyini kontrol ettikten sonra GoogleAPIClient
, Google Play kaynaklarında çağrılacak sınıfın bir örneğini oluşturabilirsiniz . Aşağıdaki örnek kod bunu göstermektedir ve buna dahil edilebilir onCreate
:
GoogleApiClient myClient = new GoogleApiClient.Builder(this) .addApi(Plus.API) .addScope(Plus.SCOPE_PLUS_PROFILE) .addConnectionCallbacks(this) .addOnConnectionFailedListener(this) .build();
Bu, uygulamanızı Plus.API
alıntıdan görebileceğiniz gibi Google+ hizmetlerine erişmek için hazırlar . addScope
Hattı, uygulamanın ne bağlı olarak değişecektir. Bu kod ayrıca bağlantı işlemi için geri aramaları ayarlar. Sınıfınız aşağıdaki arayüzleri uygulayabilir:
public class MainActivity extends Activity implements ConnectionCallbacks, OnConnectionFailedListener
Sınıf daha sonra uygulayabilirsiniz onConnected
ve onConnectionSuspended
Play Hizmetleri bağlantı değişiklikleri işlemek için geri aramalar.
Kullanıcının oturum açması gerektiği durumlarda olduğu gibi Play Services’e bağlanmadaki başarısızlıklarla başa çıkmak için, sınıfınız onConnectionFailed
tipik hataları çözmek için çeşitli standart yöntemlere erişmek için de uygulayabilir . Bu yöntemlerden bazıları onActivityResult
, kullanıcı uygulamaya geri döndüğünde yöntemin çalışmasına neden olur , böylece oraya bağlanmak için yeniden giriş yapabilirsiniz.
Genel olarak, Activity
sınıfınız aşağıdaki alıntılarda olduğu gibi sınıf üzerinden Play Services’e bağlanmalı ve sınıf yoluyla onStart
bağlantısını kesmelidir:onStop
GoogleAPIClient
myClient.connect();
4. Play Hizmet Kaynaklarını Kullanma
Aşama 1
Google+ dahil olmak üzere bazı Oynatma Servislerinde erişim için kayıt olmanız gerekir. Bunu yapmak için, Google API Konsolu’na giriş yapın , Create Project (Proje Oluştur)’u tıklayın ve bir ad girin. Projeyi oluşturduktan sonra, konsoldaki projeye yönlendirilmelisiniz.
API menü öğesini seçin, listede Google+ API’yi bulun ve etkinleştirmek için düğmeye tıklayın. Lisansı kabul ettikten sonra durumun ON (AÇIK) olması gerekir . API listesine tıklamak, onunla neler yapabileceğinize dair genel bir bakış sunar.
Adım 2
Ardından, Credentials (Kimlik Bilgileri)’ni seçin ve Create New Client ID (Yeni Müşteri Kimliği Oluştur)’u tıklayın. Installed application (Yüklü uygulama) nın radyo düğmesini seçin, Android’i türü olarak ve uygulama ayrıntıları girin. Şimdi bir SHA1 sertifikası oluşturmak için Keytool kaynağını kullanmanız gerekir.
Geliştirme sırasında, aşağıdaki kodu bir terminale girerek hata ayıklama anahtar deposunu kullanabilirsiniz:
keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Bunun hata ayıklama anahtar deponuz için doğru konum olduğundan emin olmanız gerekir, değilse yolu değiştirin. Bu komutu çalıştırdığınızda, sizden şifre istenir. android
Hata ayıklama anahtar deposu için Enter ve parmak izi terminale çıkarılmalıdır.
Signing certificate fingerprint ((İmzalama sertifikası parmak izi)) kutusu içerisindeki API konsoluna SHA1
satırını kopyala ve yapıştırın.
Gerekirse derinlemesine bağlantıyı etkinleştirin ve ardından ID (kimliği) oluşturmak için düğmeye tıklayın. Client ID for Android Application ( Android Uygulaması için Müşteri Kimliği) başlıklı bir bölüm görünecektir . ID (Kimliğinizi)’nizi uygulama kodunuzda kullanmanız gerekmez, ancak bir kopyasını kendi kayıtlarınız için saklamak isteyebilirsiniz.
Aşama 3
Uygulama kodunuzdaki Play Services API’lerini çağırmadan önce, projenizin bildirim dosyasına uygun izinleri eklemeniz gerekir. Aşağıdaki örnekler birkaç tipik kullanım durumu göstermektedir, ancak kendi projeniz için uygun izinleri seçmeniz gerekecektir:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" /> <uses-permission android:name="android.permission.USE_CREDENTIALS" />
Projeniz şimdi ihtiyacınız olan Play Services API’lerini arayacak şekilde yapılandırılmalıdır. Activity
Uygulamalarınızın ne yaptığına bağlı olarak sınıflarınızı farklı bir şekilde yapılandırmanız gerekecektir . Bununla ilgili daha fazla bilgi için Developer Guide(Geliştirici Kılavuzuna) bakın.
Mevcut Oyun Servislerinden bazılarına başlamak için aşağıdaki kılavuzları incelemeyi unutmayın:
Erişmek istediğiniz Google hizmetleri Play Services kütüphanesinin bir parçası değilse, Google’ın REST API’sini kullanarak bunlara erişebilirsiniz.
Sonuç
Android uygulamalarında Google Play Servisleri ile birçok olasılık var. Oyun oynamaktan konum ve haritalama hizmetlerine kadar, uygulamalarınız kendi kullanıcı arayüzleriniz ve işlevleriniz bağlamında mevcut platform özelliklerinden faydalanabilir.
Kurulum işlemi biraz zahmetli görünebilir, ancak bir kez kurduğunuzda, bu hizmetleri kullanıcılarınıza sunmaya odaklanabilirsiniz.
https://code.tutsplus.com/tutorials/integrating-google-play-services-on-android–cms-19828