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

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

Bu geliştirici kılavuzunda Android Native Development Kit (NDK) kullanılır. NDK'ya aşina değilseniz devam etmeden önce NDK dokümanlarına ve örnek uygulamalarına bakı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 belirtilmiştir.
  3. Google Play Oyun 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 dizini 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'yı nereye yüklediğinizi bildirin.

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

    1. Eclipse'te Dosya > İçe Aktar > Android > Mevcut Android Kodunu Workspace'e'yi tıklayın.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib seçeneğini belirleyin. Bu seçenekte 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 Dosya > İçe Aktar > Android > Mevcut Android Kodunu Workspace'e'yi 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 Özellikler'i tıklayın. Android bölümünde Kitaplık'a gidin ve google-play-services_lib projesine 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 derleyecektir. 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 dosyasını çalıştırın. jni klasöründe değişiklik yaptıktan sonra bunu yapmayı unutmayın.

Projeniz derlenir ancak henüz çalışmaz. Öncelikle oyununuzu Google Play Console'da 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 dosyasında, <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 proje genelindeki bazı referansları (özellikle de oluşturulan R sınıfını) düzeltmeniz gerekebilir.
  3. res/values/ids.xml'ü 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 sayıdır.

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

Sana Özel örneğini çalıştırmak için fiziksel bir Android cihaza veya Google Play Hizmetleri yüklü bir emülatöre ihtiyacınız vardır:

  1. Yerel kodu derlemek için ndk-build dosyasını çalıştırın.
  2. Eclipse'te Çalıştır > Olarak Çalıştır > Android Uygulaması'nı tıklayın ve örneği cihazınızda çalıştırın.
  3. Sana Özel'deki bir içeriği açtığınızda ekranda herhangi bir yere dokunun. Google Play Games logosu gösterilir. 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'i 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. Mülkler penceresinde Geliştiriciler 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. 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 ardından Kaynakları Belirt'i tıklayın. Sonuç olarak açılan iletişim kutusunda, MinimalActivity altındaki 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.