Başlamadan önce
Bu geliştirici kılavuzunda, Google Play Game Services API'yi kullanan bir C++ oyununun Android'de nasıl derleneceği ve çalıştırılacağı gösterilmektedir. Başlamadan önce aşağıdaki gereksinimleri indirin ve yapılandırın:
- Android NDK, Düzeltme 14 veya sonraki sürümler.
- Android SDK v10 veya sonraki sürümler ve Eclipse ADT'nin en son sürümü.
- Cihaz, Android 4.0 (API düzeyi 14) veya sonraki bir sürümü çalıştırıyor olmalıdır.
- Google Play Hizmetleri SDK'sının en son sürümü.
Bu geliştirici kılavuzunda Android Native Development Kit (NDK) kullanılmaktadır. NDK hakkında bilgi sahibi değilseniz devam etmeden önce NDK dokümanlarına ve örneklerine bakın.
1. Adım: Ortamınızı ayarlayın
- Android SDK'yı ve Android NDK'yi indirip makinenize çıkarın. Ortamınızda
SDK_ROOT
öğesini Android SDK klasörünüzün konumu olarak,NDK_ROOT
değerini de Android NDK klasörünüzün konumu olarak ayarlayın. - C++ örnek oyunlarını indirin. Bu geliştirici kılavuzunda, makinenizdeki örneklerin konumları
SAMPLES_DIR
olarak belirtilmiştir. - Google Play Games hizmetleri C++ SDK'sını indirin. SDK'yı geliştirme makinenize çıkarın. Ortamınızda,
NDK_MODULE_PATH
değişkeninigpg-cpp-sdk
dizininin yukarısındaki dizine işaret edecek şekilde ayarlayın. Aşağıdaki dizin yapısına sahip olmanız gerekir:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Eclipse'i açın. Henüz yapmadıysanız Tercihler > Android > NDK'yi tıklayarak Eclipse'e NDK'yi yüklediğiniz yeri bildirin.
Google Play Hizmetleri kitaplık projesini Eclipse çalışma alanınıza aktarın.
- Eclipse'te File > Import > Android > android Android > Workspace'e gidin.
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
öğesini seçin. BuradaSDK_ROOT
, Android SDK'nızın konumudur.- Son'u tıklayın.
Minimalist örnek projeyi Eclipse çalışma alanınıza aktarın.
- Eclipse'te File > Import > Android > android Android > Workspace'e gidin.
SAMPLES_DIR/samples-android/minimalist
seçeneğini belirleyin.- Son'u tıklayın.
MinimalistActivity projesini sağ tıklayın ve Özellikler'i tıklayın. Android bölümünde, Kitaplık bölümüne gidin ve google-play-services_lib projesinin doğru şekilde başvurulduğundan emin olun. Uygulanmamışsa referansı kaldırın ve çalışma alanınızdan tekrar ekleyin.
Eclipse, projenizin Java ve Android kaynaklarını otomatik olarak derler. Ancak jni
klasöründeki yerel kodun ayrı olarak derlenmesi gerekir. Bunu manuel olarak yapmak için jni
klasörüne gidin ve ndk-build
komutunu çalıştırın. jni
klasöründe değişiklik yaptıktan sonra bunu yapmayı unutmayın.
Projeniz artık derlenmelidir, ancak henüz çalışmayacaktır. Öncelikle oyununuzu Google Play Console'da yapılandırmanız gerekir.
2. Adım: Oyunu Google Play Console'da kurun
Google Play Console'da oyununuz için bir giriş oluşturun. Bu, uygulamanız için Oyun hizmetlerini etkinleştirir ve henüz yoksa bir OAuth 2.0 istemci kimliği oluşturur.
- Google Play Oyun Hizmetleri'ni kurma sayfasında açıklanan adımları uygulayarak oyununuz için bir giriş oluşturun.
AndroidManifest.xml
uygulamasında<manifest>
etiketininpackage
özelliğini, Google Play Console'u kurarken seçtiğiniz paket adıyla değiştirin. Bu değişikliği yaptıktan sonra proje genelinde bazı referansları düzeltmeniz gerekebilir (özellikle oluşturulanR
sınıfında).res/values/ids.xml
uygulamasını açıp Uygulama Kimliğinizi oraya yerleştirin. Uygulama Kimliği'nin istemci kimliğiyle aynı olmadığını, Google Play Console'un Oyun Ayrıntıları sayfasındaki oyununuzun adının yanındaki sayı olduğunu unutmayın.
3. Adım: Örneği çalıştırın
Örneği çalıştırmak için fiziksel bir Android cihaza veya Google Play hizmetlerinin yüklü olduğu bir emülatöre ihtiyacınız vardır:
- Yerel kodu derlemek için
ndk-build
komutunu çalıştırın. - Eclipse'te Çalıştır > Farklı Çalıştır > Android Uygulaması'nı tıklayın ve örneği cihazınızda çalıştırın.
- Örnek açıldığında, camın herhangi bir yerine dokunun. Bir Google Play Games logosu görürsünüz. Uygulamanızı doğru şekilde yapılandırdıysanız oturum açmanız istenir.
İsteğe Bağlı: Eclipse ile Otomatik Olarak Oluşturma
Aşağıdaki adımlarda, jni
klasöründeki dosyalarda değişiklik yaptığınızda Eclipse'i, ndk-build
aracını otomatik olarak çalıştıracak şekilde nasıl yapılandıracağınız gösterilmektedir.
- MinimalistActivity projesini sağ tıklayın ve Özellikler'i tıklayın. Özellikler penceresinde, Builders (Derleyiciler) bölmesini seçin.
- Yeni bir oluşturucu eklemek için Yeni'yi tıklayın ve Program'ı seçip Tamam'ı tıklayın.
- Name (Ad) alanına "NDK Builder" yazın.
- Konum bölümünde Dosya Sistemine Göz At'ı tıklayın,
NDK_ROOT
dizinine gidin vendk-build
komutunu seçin. - Çalışma Dizini bölümünde, Workspace'e Göz At'ı tıklayın ve MinimalistActivity proje klasörünü seçin.
- Yenile sekmesini tıklayın. Tamamlandığında kaynakları yenile kutusunun işaretli olduğundan emin olun.
- Belirli kaynaklar radyo düğmesini seçin ve ardından Kaynakları Belirt'i tıklayın. Açılan iletişim kutusunda MinimalActivity bölümünde
jni
klasörünü seçin. - Derleyici oluşturma işlemini tamamlamak için Uygula'yı, ardından Tamam'ı tıklayın.
Artık jni
klasöründe bir dosyayı her düzenlediğinizde Eclipse, ndk-build
uygulamasını çalıştıracak ve çıkışı Eclipse Console'a yazdıracak.