Geospatial API ve Cloud Anchor gibi ARCore özellikleri, Google Cloud'da barındırılan ARCore API'yi kullanır. Uygulamanız, bu özellikleri kullanırken ARCore API hizmetine erişmek için kimlik bilgilerini kullanır.
Bu hızlı başlangıç kılavuzunda, uygulamanızı Google Cloud'da barındırılan ARCore API hizmetiyle iletişim kuracak şekilde nasıl ayarlayacağınız açıklanmaktadır.
Yeni bir Google Cloud projesi oluşturun veya mevcut bir projeyi kullanın
Mevcut bir projeniz varsa seçin.
Google Cloud projeniz yoksa yeni bir proje oluşturun.
ARCore API'yi etkinleştir
ARCore API'sini kullanmak için projenizde etkinleştirmeniz gerekir.
Yetkilendirme yöntemi ayarlama
Bir Android uygulaması, ARCore API'si ile iki farklı yetkilendirme yöntemi kullanarak iletişim kurabilir: önerilen yöntem olan Anahtarsız yetkilendirme (OAuth 2.0) ve API Anahtarı yetkilendirmesi:
- Anahtarsız yetkilendirme, uygulamanızı yetkilendirmek için uygulamanın paket adı ve imzalama anahtarının parmak izinin bir kombinasyonunu kullanır.
- API anahtarı, Google Cloud projelerini tanımlayan bir dizedir. API anahtarları, genellikle istemciler tarafından erişilebilir olduğundan genellikle güvenli kabul edilmez. ARCore API ile iletişim kurmak için anahtarsız yetkilendirmeyi kullanmayı düşünün.
Anahtarsız
Uygulamanızı Anahtarsız kimlik doğrulama kullanarak yetkilendirmek için OAuth 2.0 istemci kimlikleri oluşturun.
İmzalama anahtarı parmak izlerini belirleyin
OAuth 2.0 istemci kimliği, uygulamanızı tanımlamak için uygulamanızın imzalama anahtarı parmak izini kullanır.
Hata ayıklama imzalı parmak izinizi alma
Android SDK araçları, projenizi çalıştırırken veya hata ayıklarken uygulamanızı oluşturulan bir hata ayıklama sertifikasıyla otomatik olarak imzalar.
- Android Studio'da Gradle araç panelini açın.
- project-name > Görevler > Android'e gidin.
- signingReport görevini çalıştırın.
- Hata ayıklama varyantı için SHA-1 parmak izini kopyalayın.
Anahtar deposundan imza parmak izi nasıl alınır?
Anahtar deposu dosyanız varsa parmak izini belirlemek için keytool
yardımcı programını kullanın.
keytool -list -v -alias your-key-name -keystore path-to-production-keystore
Daha sonra keytool
yardımcı programı, parmak izini terminale yazdırır. Örneğin:
Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
Play Uygulama İmzalama'dan uygulamanızın imzalama anahtarını alma
Play Uygulama İmzalama kullanılırken Google, uygulamanızın imzalama anahtarını yönetir ve APK'larınızı imzalamak için kullanır. Bu anahtar, imzalama parmak izi için kullanılmalıdır.
- Google Play Console'daki Uygulama İmzalama sayfasında Uygulama imzalama anahtarı sertifikası'na gidin.
- SHA-1 sertifika parmak izini kullanın.
OAuth 2.0 istemci kimlikleri oluşturma
Önceki adımlarda geçerli olan her imzalama anahtarı için Google Cloud projenizin kimlik bilgilerinde bir OAuth 2.0 istemci kimliği oluşturun.
Google Cloud'da Kimlik bilgileri sayfasını açın.
Kimlik bilgileri oluştur'u tıklayın, ardından menüden OAuth istemci kimliği'ni seçin.
Zorunlu alanları aşağıdaki gibi doldurun:
- Uygulama türü: Android'i seçin.
- Paket adı: AndroidManifest.xml dosyanızda belirtilen paket adını kullanın.
- SHA-1 sertifika parmak izi: Önceki adımlarda edindiğiniz bir parmak izi kullanın.
Oluştur'a basın.
Gerekli kitaplıkları dahil et
- Uygulamanızın bağımlılıklarına
com.google.android.gms:play-services-auth:16+
ekleyin. Kod küçültme kullanıyorsanız bunu uygulamanızın
build.gradle
dosyasına ekleyin:buildTypes { release { ... proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } }
Uygulamanızın
proguard-rules.pro
dosyasına aşağıdakileri ekleyin:-keep class com.google.android.gms.common.** { *; } -keep class com.google.android.gms.location.** { *; } -keep class com.google.android.gms.auth.** { *; } -keep class com.google.android.gms.tasks.** { *; }
Uygulamanız artık Anahtarsız kimlik doğrulama kullanacak şekilde yapılandırılmış.
API Anahtarı
- Google Cloud'da Kimlik bilgileri sayfasını açın.
Kimlik bilgileri - Kimlik bilgileri oluştur'u tıklayın, ardından menüden API anahtarı'nı seçin.
API anahtarı oluşturuldu iletişim kutusu, yeni oluşturduğunuz anahtarın dizesini görüntüler. Android Studio'da projenize yeni API anahtarını ekleyin. API anahtarını, uygulamanızın
AndroidManifest.xml
öğesindeki<application>
öğesine bir<meta-data>
öğesine ekleyin:<meta-data android:name="com.google.android.ar.API_KEY" android:value="API_KEY"/>
- API anahtarınızı güvence altına almak için API anahtarı kısıtlamaları ile ilgili belgeleri inceleyin.
Uygulamanız artık API anahtarları kullanacak şekilde yapılandırılmış.
Sırada ne var?
Yetkilendirme yapılandırılmışsa onu kullanan aşağıdaki ARCore özelliklerine göz atın: