Çalışma Zamanı Etkinleştirilmiş SDK derleme ve kullanma

Test uygulaması oluşturma ve yapılandırma

Bu bölümde, yerel test için çalışma zamanı etkin bir SDK'yı kullanacak şekilde uygulamayı ayarlama ve hazırlama açıklanmaktadır.

Uygulamanızı hazırlama

Öncelikle ayrı bir bağımsız proje veya modül oluşturun.

Bu senaryoda uygulama, SDK kodunu içermez. Bunun yerine Maven bağımlılığı olarak bildirir.

Çalışma zamanı etkin bir SDK'yı kullanan uygulama oluşturmak için Android Studio Ladybug Canary 1 veya sonraki bir sürümün ve Android Gradle Plugin'in (AGP) 8.7.0-alpha01 veya sonraki bir sürümün yüklü olması gerekir.

1. Geliştirme ortamınızı ve test için cihazınızı/emülatörünüzü ayarlamak üzere daha önce açıklanan adımları uygulayın.

2. 3. adım: SDK'nızı hazırlayın bölümünde açıklanan işareti kullanarak SDK Çalışma Zamanı'nı etkinleştirin.

   # This enables the Privacy Sandbox for your project on Android Studio.
   android.experimental.privacysandboxsdk.enable=true
   android.experimental.privacysandboxsdk.requireServices=false
   

3. Özel Korumalı Alan Maven URL'sini projenizin üst düzey build.gradle dosyasına ekleyin.

       allprojects {
           repositories {
               google()
               maven {
                   url "https://maven.privacysandbox.com/v1/repository"
                   }
               }
           }
   

4. Mevcut reklam kitaplığındaki (çalışma zamanına duyarlı SDK'nız) Maven bağımlılığını Maven hedefinde tutun.

5. SDK kitaplığına bağımlılığı olan bir privacySandbox bloğunu project build.gradle dosyasına ekleyin ve enable değerini true olarak ayarlayın.

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       //...
       privacySandbox {
           enable true
       }
       //...
   }
   
   dependencies {
       // SDK library dependency
       implementation(<maven coordinates to SDK library>)
   }
   

6. Uygulama artık SDK'nın API'lerini API tüketimi bölümünde açıklandığı şekilde kullanabilir.

Uygulamanızı geliştirin

Uygulamalarınızı normalde yaptığınız gibi Android App Bundle (AAB) olarak oluşturabilirsiniz.

SDK'nızı yerel olarak test etme

Test uygulamanızı çalıştırmak için Android Studio'yu kullanarak çalışma zamanı etkin SDK'yı ve uygulamayı test cihazınıza veya emülatörünüze yükleyin.

1. Test uygulamanızın Android Studio projesini açın.
2. Run > Edit Configurations'a (Çalıştır > Yapılandırmaları Düzenle) gidin. "Çalıştırma/Hata Ayıklama" Yapılandırma penceresi görünür. "Varsayılan APK" veya "Paketten APK" olarak dağıtabilirsiniz.
3. Başlatma Seçenekleri bölümünde Başlat'ı Belirtilen Etkinlik olarak ayarlayın.
4. Etkinlik'in yanındaki üç nokta menüsünü tıklayın ve müşteriniz için Ana Etkinlik'i seçin.
5. Uygula'yı ve ardından Tamam'ı tıklayın.
6. İstemci uygulamasını ve SDK'yı test cihazınıza yüklemek için Çalıştır'ı tıklayın.

Dağıtım için SDK'nızı oluşturma

SDK'nızı bir uygulama mağazasında yayınlayabilmek için Android SDK paketi (ASB) olarak oluşturmanız gerekir. ASB, Android App Bundle'lara eşdeğer, imzalanmamış bir yayın paketidir.

ASB veya türevi olan Android SDK Arşivi (ASAR), uygulamanın AAB'si ile birlikte Bundletool tarafından yüklenebilir bir APK'lar grubuna dönüştürülür. Uygulama geliştiriciler, tüm APK varyantlarını oluşturmak için BundleTool'u doğrudan Android Studio'da (şu anda Canary sürümü) kullanabilir.

Bundletool bir AAB ve bir ASB alır ve bir dizi APK varyantı oluşturabilir:

1. SDK çalışma zamanı ile uyumlu olmayan cihazlarda (Android 13 ve önceki sürümler) SDK çalışma zamanı geriye dönük uyumlu modda çalışacak şekilde oluşturulmuş bir APK. Bu APK, hem uygulama hem de SDK için gereken tüm kodu içerir.
2. SDK Çalışma Zamanı ile uyumlu cihazlarda (Android 14 ve sonraki sürümler) SDK Çalışma Zamanı modunu çalıştırmak için oluşturulmuş bir APK. Bu APK, çalışma zamanı özellikli SDK için API saplarıyla birlikte yalnızca uygulama kodunu içerir.
3. Çalışma zamanı etkin SDK kodu içeren SDK APK'sı, önceki adımda açıklanan uygulama APK'sından önce yüklenmek üzere tasarlanmıştır.

İki şekilde ASB oluşturabilirsiniz:

• Android Studio
  1. Projenizi oluşturun. Bu işlem, Build > Rebuild projesi çağrılarak yapılabilir.
  2. ASB dosyası, build/outputs/asb/single/<your-asb-module-name>.asb altında çalışma zamanı etkin ASB modülünüzde bulunur.
• Bundletool'un komut satırı - bu talimatları uygulayın.

SDK'yı yayınlayabilmeniz için yükleme anahtarıyla imzalamanız gerekir. ASB'nizi SDK Console'a yüklemek üzere imzalamak için bu yükleme anahtarını kullanın. Google, kimliğinizi doğrulamak için yükleme sertifikasını kullanır.

Aşağıdaki adımlar, ASB'nizi imzalamak için yapmanız gerekenlere genel bir bakış sunar:

1. Anahtar deposu ve yükleme anahtarı oluşturun. Bu işlem, uygulamalar için anahtar deposu ve yükleme anahtarı oluşturma ile aynıdır.
2. ASB'nizi yükleme anahtarıyla imzalayın. Bunu yapmak için build.gradle dosyanıza yeni oluşturulan anahtarı ve anahtar deposunu belirten bir signingConfig bloğu ekleyin:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

Uygulama mağazaları, bu bileşenleri kullanarak çalışma zamanında etkin uygulama dağıtımını desteklemek için farklı stratejiler geliştirebilir. SDK Runtime, çalışma zamanı özellikli SDK'lar için desteği genişletmek amacıyla uygulama mağazalarıyla sürekli olarak çalışmaktadır.

arrow_back_ios4. adım: Çalışma zamanı etkin SDK'yı kullanın