Android'de C++ için Play Oyun Hizmetleri'ni Kullanmaya Başlama

Google ile Giriş API'sinin desteğinin sonlandırılmasının ardından, 2026'da Games v1 SDK'sını kaldırıyoruz. Şubat 2025'ten sonra games v1 SDK'sıyla yeni entegre edilen oyunları Google Play'de yayınlayamayacaksınız. Bunun yerine games v2 SDK'sını kullanmanızı öneririz.
Önceki Games v1 entegrasyonlarına sahip mevcut uygulamalar birkaç yıl daha çalışmaya devam edecek olsa da Haziran 2025'ten itibaren v2'ye geçiş yapmanız önerilir.
Bu kılavuz, Play Games Hizmetleri v1 SDK'sının kullanımıyla ilgilidir. Play Games Hizmetleri v2 için C++ SDK'sı henüz kullanılamamaktadır.

Bu geliştirici kılavuzunda, Google Play Oyun Hizmetleri API'sini kullanan bir C++ oyununu Android'de nasıl derleyip çalıştıracağınız açıklanmaktadır. Başlamadan önce aşağıdaki gereksinimleri indirip yapılandırın:

Bu geliştirici kılavuzunda Android Native Development Kit (NDK) kullanılmaktadır. NDK'ya aşina değilseniz devam etmeden önce NDK dokümanlarına ve örneklerine göz atın.

1. adım: Ortamınızı ayarlayın

  1. Android SDK'yı ve Android NDK'yı indirip makinenize çıkarın. Ortamınızda SDK_ROOT değerini Android SDK klasörünüzün konumuna, NDK_ROOT değerini ise Android NDK klasörünüzün konumuna ayarlayın.
  2. C++ örnek oyunlarını indirin. Bu geliştirici kılavuzunda, makinenizdeki örneklerin konumu SAMPLES_DIR olarak belirtilir.
  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 üstündeki 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 Preferences > Android > NDK'yı tıklayarak NDK'yı nereye yüklediğinizi Eclipse'e bildirin.

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

    1. Eclipse'te File > Import > Android > Existing Android Code into Workspace'i (Dosya > İçe Aktar > Android > Mevcut Android Kodunu Çalışma Alanına) tıklayın.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib 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 > Existing Android Code into Workspace'i (Dosya > İçe Aktar > Android > Mevcut Android Kodunu Çalışma Alanına) tıklayın.
    2. SAMPLES_DIR/samples-android/minimalist (Hangouts Chat'e Bildirim Gönder) seçeneğini belirleyin.
    3. Son'u tıklayın.

  7. MinimalistActivity projesini sağ tıklayın ve Properties'i (Özellikler) tıklayın. Android bölümünde Kitaplık bölümüne gidin ve google-play-services_lib projesinin doğru şekilde referans verildiğinden emin olun. Aksi takdirde, referansı kaldırıp ç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. Bu işlemi manuel olarak yapmak için jni klasörüne gidin ve ndk-build komutunu çalıştırın. Bu işlemi, jni klasöründe değişiklik yaptıktan sonra gerçekleştirmeyi unutmayın.

Projeniz artık derlenmelidir ancak henüz çalışmayacaktır. Öncelikle Google Play Console'da oyununuzu yapılandırmanız gerekir.

2. adım: Oyunu Google Play Console'da ayarlayın

Google Play Console'da oyununuz için bir giriş oluşturun. Bu işlem, uygulamanız için Games hizmetlerini etkinleştirir ve henüz yoksa bir OAuth 2.0 istemci kimliği oluşturur.

  1. Google Play Games Hizmetleri'ni ayarlama başlıklı makalede açıklanan adımları uygulayarak oyununuz için bir giriş oluşturun.
  2. AndroidManifest.xml içinde, <manifest> etiketinin package özelliğini, Google Play Console'u ayarlarken seçtiğiniz paket adıyla değiştirin. Bu değişikliği yaptıktan sonra projenin tamamında (özellikle oluşturulan R sınıfında) bazı referansları düzeltmeniz gerekebilir.
  3. res/values/ids.xml uygulamasını açın ve uygulama kimliğinizi buraya yerleştirin. Uygulama kimliğinin, istemci kimliğiyle aynı olmadığını unutmayın. Uygulama kimliği, Google Play Console'un Oyun Ayrıntıları sayfasında oyununuzun adının yanındaki numaradır.

3. adım: Örneği çalıştırın

Örneği çalıştırmak için Google Play Hizmetleri'nin yüklü olduğu fiziksel bir Android cihaz veya emülatör gerekir:

  1. Yerel kodu derlemek için ndk-build komutunu çalıştırın.
  2. Eclipse'te Run > Run As > Android Application'ı (Çalıştır > Farklı Çalıştır > Android Uygulaması) tıklayın ve örneği cihazınızda çalıştırın.
  3. Örnek açıldığında ekranda herhangi bir yere dokunun. Google Play Games logosunu görmeniz gerekir. Uygulamanızı doğru şekilde yapılandırdıysanız oturum açmanız istenir.

İsteğe bağlı: Eclipse ile otomatik olarak derleme

Aşağıdaki adımlarda, jni klasöründeki dosyalarda değişiklik yaptığınızda Eclipse'i ndk-build'yı otomatik olarak çalıştıracak şekilde nasıl yapılandıracağınız gösterilmektedir.

  1. MinimalistActivity projesini sağ tıklayın ve Properties'i (Özellikler) tıklayın. Özellikler penceresinde Oluşturucular bölmesini seçin.
  2. Yeni bir Oluşturucu eklemek için Yeni'yi tıklayın, Program'ı seçin ve 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 Çalışma alanına 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 Kaynakları Belirtin'i tıklayın. Sonuç olarak açılan iletişim kutusunda MinimalActivity altında jni klasörünü seçin.
  8. Oluşturucunuzu oluşturmayı tamamlamak için Uygula'yı ve ardından Tamam'ı tıklayın.

Artık jni klasöründeki bir dosyayı her düzenlediğinizde Eclipse, ndk-build komutunu çalıştırıp çıktıyı Eclipse Konsolu'na yazdırır.