GameActivity   Android Game Development Kit'in bir parçasıdır.

GameActivity, Android oyunlarının uygulamanın C/C++ kodundaki uygulama döngüsü komutlarını, giriş etkinliklerini ve metin girişini işlemesine yardımcı olmak için tasarlanmış bir Jetpack kitaplığıdır. GameActivity, NativeActivity'nin doğrudan bir alt öğesidir ve benzer bir mimariyi paylaşır:

alt_text

Önceki şemada gösterildiği gibi GameActivity aşağıdaki işlevleri yerine getirir:

  • Java tarafındaki bileşen aracılığıyla Android çerçevesiyle etkileşim kurma
  • Uygulama döngüsü komutlarını, giriş etkinliklerini ve giriş metnini yerel tarafa iletme
  • C/C++ kaynak kodunu üç mantıksal bileşene ayırma:
    • GameActivity'nin Java işlevini doğrudan destekleyen ve etkinlikleri native_app_glue için sıraya alan GameActivity'nin JNI işlevleri.
    • native_app_glue, çoğunlukla kendi yerel iş parçacığında (uygulamanın ana iş parçacığından farklı) çalışır ve görevleri kendi döngüleyicisiyle yürütür.
    • Uygulamanın oyun kodu, native_app_glue içinde sıraya alınan etkinlikleri sorgulayıp işler ve oyun kodunu native_app_glue iş parçacığında yürütür.

GameActivity sayesinde, JNI koduyla uğraşmak için çok fazla zaman harcamak yerine oyun geliştirme sürecine odaklanabilirsiniz.

NativeActivity hakkında bilgi sahibiyseniz GameActivity ile NativeActivity arasındaki temel farklar şunlardır:

  • GameActivity, SurfaceView olarak oluşturulur. Bu sayede oyunların diğer kullanıcı arayüzü bileşenleriyle etkileşime girmesi çok daha kolay olur.
  • Dokunma ve tuş girişi etkinlikleri için GameActivity, NativeActivity tarafından kullanılan InputQueue'ten ayrı, android_input_buffer arayüzüyle tamamen yeni bir uygulamaya sahiptir.
  • GameActivity, AppCompatActivity'in türetilmiş bir sınıfıdır ve diğer Jetpack bileşenlerini sorunsuz bir şekilde kullanmanıza olanak tanır. ActionBar, Fragment ve diğerleri kullanılabilir.
  • GameActivity, GameTextInput kitaplığını entegre ederek metin girişi işlevi ekler.
  • GameActivity'dan türetilen uygulamaların, C/C++ kodunun üç bölümünü de tek bir kitaplıkta derlemesi beklenir. Öte yandan, NativeActivity uygulamasının JNI işlevleri, çerçevenin bir parçasıdır (her zaman OS tarafından yüklenir). Bu nedenle, yalnızca native_app_glue ve uygulamanın C/C++ kodunun tek bir kitaplıkta derlenmesi beklenir.
  • NativeActivity, Android çerçevesinin bir parçasıdır ve sürüm döngüsünü (genellikle yıllık) takip eder. GameActivity, Jetpack kitaplığının bir parçasıdır. Bu kitaplığın yayın döngüsü çok daha sık olduğundan (genellikle iki haftada bir) yeni özellikler ve hata düzeltmeleri çok daha hızlı bir şekilde sunulabilir.

Konumları serbest bırakma

GameActivity kitaplığı aşağıdaki kanallarda kullanılabilir:

C/C++ kodu, Prefab biçimi kullanılarak tüm sürüm kanallarında kaynak kodu olarak sağlanır. GameActivity 1.2.2 sürümü, dağıtıma statik bir kitaplık ekler. Bu sürümden itibaren kaynak kodu yerine statik kitaplığı kullanmanızı öneririz.

Jetpack kitaplığının içeriği

Jetpack kitaplığıyla GameActivity, AAR ile yayınlanır. Bu AAR aşağıdaki ana bileşenleri içerir:

  • Java kodu için JAR dosyası
  • C/C++ statik kitaplığı game-activity_static, GameActivity 1.2.2 ve sonraki sürümlere dahildir.
  • C/C++ kaynak kodu (/prefab klasörünün altında)

Bu sayfada bağlantısı verilen entegrasyon talimatları, derleme sisteminizde Prefab'i kullanabileceğinizi varsayar. Aksi takdirde, prefab/modules/game-activity/include klasöründe paketlenmiş kaynak kodunu derleme sisteminize kopyalayabilir ve gerekli entegrasyon adımlarını uygulayabilirsiniz. Android Jetpack kitaplığı için androidx altındaki sürümlerde benzer bir dosya yapısı vardır. Gradle, varsayılan olarak AAR'leri önbellek dizinine (~/.gradle/caches/...) açar. C/C++ kaynak kodunu bulmak için prefab/modules/game-activity/include araması yapıp istediğiniz yayınlanan sürümün altındaki konumu seçebilirsiniz.

Jetpack kitaplığını kullanarak entegrasyon yapma talimatları için GameActivity'yi kullanmaya başlama başlıklı makaleyi inceleyin.

AOSP kaynak kodunun içeriği

AOSP her zaman en güncel kaynak kodunu içerir. Kendi sürümlerinizi oluşturmak için derleme talimatlarını uygulayın veya kaynağı doğrudan derleme ortamınıza entegre edin. C/C++ kaynak kodu, Jetpack kitaplığına benzer bir dosya yapısına kaydedilir.

Entegrasyon kılavuzları

GameActivity ürününü uygulamalarınıza entegre etmek için bu kılavuzları takip edin:

Ek kaynaklar

GameActivity hakkında daha fazla bilgi edinmek için aşağıdakilere göz atın:

Geri bildirim

GameActivity'de hata bildirmek veya yeni özellikler istemek için GameActivity Issue Tracker'ı kullanın.