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

1
Key concepts
2
Set up your development environment
3
Build an RE SDK
4
Consume the RE SDK
5
Testing, and building for distribution

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

Bu bölümde, çalışma zamanı etkin bir uygulamayı kullanmak için uygulamanın nasıl ayarlanacağı ve hazırlanacağı açıklanmaktadır Yerel testler için SDK.

Uygulamanızı hazırlama

İlk olarak ayrı ve bağımsız bir proje veya modül oluşturun.

Bu senaryoda uygulama, SDK kodunu içermez. bu ürünü bunun yerine Maven bağımlılığı.

Çalışma Zamanı Etkin SDK kullanan bir uygulama derlemek için Android Studio gerekir Ladybug Canary 1 veya sonraki sürümleri ve Android Gradle Plugin (AGP) 8.7.0-alpha01 veya sonraki sürümleri.

  1. geliştirme ortamının test için cihaz/emülatör.
  2. SDK Çalışma Zamanını, şurada açıklanan işareti kullanarak etkinleştirin: 3. adım: SDK bölümünüzü hazırlayın.

    # 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 dosyası olarak kaydedebilirsiniz.

        allprojects {
            repositories {
                google()
                maven {
                    url "https://maven.privacysandbox.com/v1/repository"
                    }
                }
            }
    
  4. Maven bağımlılığını mevcut reklam kitaplığındaki (çalışma zamanına duyarlı SDK'nız) Maven hedefinde tutun.

  5. SDK kitaplığına bağımlı bir şekilde derleme.gradle projesine bir privacySandbox bloğu ekleyin ve etkinleştirme seçeneğini 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çıklanmıştır.

Uygulamanızı oluşturma

Uygulamalarınızı her zamanki gibi Android App Bundle (AAB) olarak derleyebilirsiniz.

SDK'nızı yerel olarak test etme

Test uygulamanızı çalıştırmak için testinize çalışma zamanı etkin SDK'yı ve uygulamayı yükleyin emülatör olarak kullanabilirsiniz.

  1. Test uygulamanızın Android Studio projesini açın.
  2. Çalıştır > Yapılandırmaları Düzenleyin. "Çalıştır/Hata Ayıklama" Yapılandırma penceresi görünür. "Varsayılan APK" olarak dağıtabilirsiniz veya "Paketten APK"yı seçin.
  3. Başlatma Seçenekleri altında, BaşlatBelirtilen Etkinlik olarak ayarlayın.
  4. Etkinlik'in yanındaki üç nokta menü simgesini tıklayın ve Müşterinizle ilgili etkinlik.
  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.
ziyaret edin.

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

SDK'nızı Android SDK Bundle (ASB) önce uygulamanız gerekir. ASB imzasız bir yayındır Android App Bundle'lara eşdeğer paket.

ASB veya türevi Android SDK Arşivi (ASAR), birlikte paketleme aracı tarafından bir dizi yüklenebilir APK'ya dönüştürülür. Uygulaması geliştiriciler, BundleTool'u doğrudan Android Studio'da (şu anda Canary sürümü) kullanın.

Paket aracı bir AAB ve ASB alır ve bir dizi APK varyantının çıktısını verebilir:

  1. SDK Çalışma Zamanı geriye dönük uyumlu modunda çalışacak şekilde oluşturulmuş bir APK cihazlar (Android 13 ve altı). Bu APK, hem uygulama hem de SDK için gereken tüm kodu içerir.
  2. Şu sürümlerle uyumlu cihazlarda SDK Çalışma Zamanı modunu çalıştırmak için oluşturulmuş bir APK SDK Çalışma Zamanı (Android 14 ve sonraki sürümler). Bu APK yalnızca uygulama kodunu ekleyin.
  3. Çalışma zamanı etkin SDK koduna sahip olan, daha önce yüklenmesi amaçlanan SDK APK'sı önceki adımda açıklanan uygulama APK'sı.

ASB'yi iki şekilde oluşturabilirsiniz:

  • Android Studio
    1. Projenizi oluşturun. Bu işlem, Derleme > Projeyi yeniden derleyin.
    2. ASB dosyası, şu bölümünde çalışma zamanının etkin olduğu ASB modülünüzde bulunur: build/outputs/asb/single/<your-asb-module-name>.asb.
  • Bundletool'un komut satırı - izleyin buradaki talimatları inceleyin.

SDK'nın yayınlanabilmesi için öncelikle bir yükleme anahtarıyla imzalanması gerekir. Bunu kullan SDK Console'a yüklemek üzere ASB'nizi imzalamak için yükleme anahtarını kullanın. Google Kimliğinizi doğrulamak için yükleme sertifikasını.

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

  1. Bir anahtar deposu ve yükleme anahtarı oluşturun. Bu, uygulamalar için anahtar deposu ve yükleme anahtarı oluşturma.
  2. ASB'nizi yükleme anahtarıyla imzalayın. Bunu yapmak için bir signConfig bloğu ekleyin yeni oluşturulan anahtarı ve anahtar deposunu belirten build.gradle dosyanıza:
android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

Uygulama mağazaları, destek alma amacıyla bu bileşenleri kullanmak için Çalışma zamanı etkin uygulama dağıtımı. SDK Çalışma Zamanı, uygulamayla sürekli olarak çalışıyor mağazalarına çalışma zamanı etkin SDK'lar için destek sağlama.

4. Adım: Çalışma zamanı etkin SDK'yı kullanın