Android'de C++ İçin Play Oyun Hizmetlerini Kullanmaya Başlayın

Dikkat: Bu kılavuz, Play Games Hizmetleri 1. sürümü kullanımı içindir. C Oyun SDK'sı ve Play Games Hizmetleri 2. sürümü ile ilgili kılavuzlar yakında sunulacaktır. Bu süre zarfında v2 hakkında daha fazla bilgiye oturum açma kılavuzundan ulaşabilirsiniz. SDK'nın yeni sürümünü denemek istiyorsanız daha fazla bilgi için lütfen Google temsilcinizle iletişime geçin.

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

1. 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.
2. C++ örnek oyunlarını indirin. Bu geliştirici kılavuzunda, makinenizdeki örneklerin konumları SAMPLES_DIR olarak belirtilmiştir.
3. Google Play Games hizmetleri C++ SDK'sını indirin. SDK'yı geliştirme makinenize çıkarın. Ortamınızda, NDK_MODULE_PATH değişkenini gpg-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/

4. Eclipse'i açın. Henüz yapmadıysanız Tercihler > Android > NDK'yi tıklayarak Eclipse'e NDK'yi yüklediğiniz yeri bildirin.

5. Google Play Hizmetleri kitaplık projesini Eclipse çalışma alanınıza aktarın.

   1. Eclipse'te File > Import > Android > android Android > Workspace'e gidin.
   2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib öğesini seçin. Burada SDK_ROOT, Android SDK'nızın konumudur.
   3. Son'u tıklayın.

6. Minimalist örnek projeyi Eclipse çalışma alanınıza aktarın.

   1. Eclipse'te File > Import > Android > android Android > Workspace'e gidin.
   2. SAMPLES_DIR/samples-android/minimalist seçeneğini belirleyin.
   3. Son'u tıklayın.

7. 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.

1. Google Play Oyun Hizmetleri'ni kurma sayfasında açıklanan adımları uygulayarak oyununuz için bir giriş oluşturun.
2. AndroidManifest.xml uygulamasında <manifest> etiketinin package ö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şturulan R sınıfında).
3. 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:

1. Yerel kodu derlemek için ndk-build komutunu çalıştırın.
2. 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.
3. Ö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.

Önemli: APK'nızı Google Play Console'da parmak izini yapılandırdığınız sertifikayla imzaladığınızdan emin olun. Aksi takdirde hatalar ortaya çıkabilir.

Önemli: Yayınlanmamış bir oyunu test ediyorsanız oturum açmak istediğiniz hesabın (genellikle test cihazındaki hesap) projede test kullanıcısı olarak listelendiğinden emin olun. Beyaz listeye eklemek veya beyaz listeye eklemek için Google Play Console'un Oyun hizmetleri alt sekmesinde Test sayfasını açın. Bu adımın gerçekleştirilmemesi, sunucunun projeniz yokmuş gibi davranmasına ve hataları döndürmesine neden olur.

İ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.

1. MinimalistActivity projesini sağ tıklayın ve Özellikler'i tıklayın. Özellikler penceresinde, Builders (Derleyiciler) bölmesini seçin.
2. Yeni bir oluşturucu eklemek için Yeni'yi tıklayın ve Program'ı seçip Tamam'ı tıklayın.
3. Name (Ad) alanına "NDK Builder" yazın.
4. Konum bölümünde Dosya Sistemine Göz At'ı tıklayın, NDK_ROOT dizinine gidin ve ndk-build komutunu seçin.
5. Çalışma Dizini bölümünde, Workspace'e Göz At'ı tıklayın ve MinimalistActivity proje klasörünü seçin.
6. Yenile sekmesini tıklayın. Tamamlandığında kaynakları yenile kutusunun işaretli olduğundan emin olun.
7. 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.
8. 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.

Not: Eclipse'de C/C++ dosyalarını düzenlerken projeyi oluşturmanızı engelleyen hatalar görürseniz Eclipse'te C/C++ hata raporlamasını devre dışı bırakabilirsiniz. Proje özelliklerinizde C/C++ Genel > Kod Analizi > Başlatma'ya gidin ve her iki kutunun da işaretli olmadığından emin olun. Ardından Uygula ve Tamam'ı tıklayın. Bu, Eclipse'in yerel kodunuzu kontrol etmesini önlemek için geçici bir çözümdür. Olası hatalarınızı düzeltmez.