Tworzenie i wykorzystywanie pakietu SDK z włączonym środowiskiem wykonawczym

Tworzenie i konfigurowanie aplikacji testowej

Z tej sekcji dowiesz się, jak skonfigurować i przygotować aplikację do korzystania z pakietu SDK z włączonym środowiskiem wykonawczym na potrzeby testów lokalnych.

Przygotowywanie aplikacji

Najpierw utwórz osobny projekt lub moduł.

W tym scenariuszu aplikacja nie zawiera kodu pakietu SDK, ale deklaruje go jako zależność Maven.

Tworzenie aplikacji, która korzysta z pakietu SDK z włączonym środowiskiem wykonawczym, wymaga Androida Studio w wersji Ladybug Canary 1 lub nowszej oraz wtyczki Android Gradle Plugin (AGP) w wersji 8.7.0-alpha01 lub nowszej.

1. Wykonaj te same czynności co wcześniej, aby skonfigurować środowisko programistyczne i urządzenie lub emulator do testowania.

2. Włącz środowisko wykonawcze SDK za pomocą flagi opisanej w kroku 3 w sekcji Przygotowywanie pakietu SDK.

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

3. Dodaj adres URL repozytorium Maven Piaskownicy prywatności do pliku build.gradle najwyższego poziomu w projekcie.

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

4. Zachowaj zależność Maven od istniejącej biblioteki reklam (pakietu SDK uwzględniającego środowisko wykonawcze) w przypadku elementu docelowego Maven.

5. Dodaj blok privacySandbox do pliku build.gradle projektu z zależnością od biblioteki pakietu SDK i ustaw wartość enable na true.

   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. Aplikacja może teraz używać interfejsów API pakietu SDK w taki sam sposób, jak opisano w sekcji dotyczącej korzystania z interfejsu API.

Tworzenie aplikacji

Aplikacje możesz tworzyć jako pakiet aplikacji na Androida (AAB) w zwykły sposób.

Testowanie pakietu SDK lokalnie

Aby uruchomić aplikację testową, zainstaluj pakiet SDK z włączonym środowiskiem wykonawczym i aplikację na urządzeniu testowym lub w emulatorze za pomocą Androida Studio.

1. Otwórz projekt Android Studio dla aplikacji testowej.
2. Kliknij Uruchom > Edytuj konfiguracje. Pojawi się okno konfiguracji „Uruchom/Debuguj”. Możesz wdrożyć „Domyślny plik APK” lub „Plik APK z pakietu”.
3. W sekcji Opcje uruchamiania ustaw Uruchom na Określona aktywność.
4. Kliknij menu z 3 kropkami obok opcji Aktywność i wybierz główną aktywność klienta.
5. Kliknij Zastosuj, a następnie OK.
6. Kliknij Uruchom, aby zainstalować aplikację klienta i pakiet SDK na urządzeniu testowym.

Tworzenie pakietu SDK do dystrybucji

Zanim opublikujesz pakiet SDK w sklepie z aplikacjami, musisz go utworzyć jako pakiet Android SDK (ASB). ASB to niepodpisany pakiet publikacyjny odpowiednik pakietów Android App Bundle.

Pakiet ASB lub jego pochodna, czyli archiwum pakietu Android SDK (ASAR), oraz pakiet AAB aplikacji są przekształcane przez narzędzie do pakietów w zestaw plików APK, które można zainstalować. Deweloperzy aplikacji mogą używać narzędzia do pakietów bezpośrednio w Android Studio (obecnie w wersji Canary), aby generować wszystkie warianty APK.

Bundletool przetwarza pakiet AAB i ASB i może wygenerować zestaw wariantów APK:

1. Plik APK utworzony do działania w trybie wstecznej zgodności środowiska wykonawczego pakietu SDK na urządzeniach, które nie są z nim zgodne (Android 13 i starsze wersje). Ten plik APK zawiera cały kod potrzebny zarówno aplikacji, jak i pakietowi SDK.
2. Plik APK utworzony do uruchamiania trybu środowiska wykonawczego pakietu SDK na urządzeniach zgodnych ze środowiskiem wykonawczym pakietu SDK (Android 14 lub nowszy). Ten plik APK zawiera tylko kod aplikacji ze stubami interfejsu API dla pakietu SDK z włączonym środowiskiem wykonawczym.
3. Plik APK pakietu SDK z kodem pakietu SDK używanym w czasie działania aplikacji, który ma być zainstalowany przed plikiem APK aplikacji opisanym w poprzednim kroku.

ASB możesz utworzyć na 2 sposoby:

• Android Studio
  1. Utwórz projekt. Możesz to zrobić, wybierając Build > Rebuild (Kompilacja > Ponownie skompiluj) projekt.
  2. Plik ASB znajduje się w module ASB używanym w czasie działania aplikacji w folderze build/outputs/asb/single/<your-asb-module-name>.asb
• Wiersz poleceń narzędzia Bundletool – postępuj zgodnie z tymi instrukcjami.

Przed opublikowaniem pakietu SDK musisz go podpisać kluczem przesyłania. Użyj tego klucza przesyłania, aby podpisać plik ASB przed przesłaniem go do SDK Console. Google używa certyfikatu przesyłania do potwierdzania Twojej tożsamości.

Poniżej znajdziesz omówienie czynności, które musisz wykonać, aby podpisać ASB:

1. Wygeneruj magazyn kluczy i klucz przesyłania. Jest to identyczne z generowaniem magazynu kluczy i klucza przesyłania w przypadku aplikacji.
2. Podpisz pakiet ASB, używając klucza przesyłania. Aby to zrobić, dodaj do pliku build.gradle blok signingConfig, w którym określisz nowo utworzony klucz i magazyn kluczy:

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

Sklepy z aplikacjami mogą opracowywać różne strategie wykorzystania tych komponentów na potrzeby rozpowszechniania aplikacji z włączonym środowiskiem wykonawczym. Środowisko wykonawcze pakietu SDK stale współpracuje ze sklepami z aplikacjami, aby rozszerzać obsługę pakietów SDK z włączonym środowiskiem wykonawczym.

arrow_back_iosKrok 4. Korzystaj z pakietu SDK z włączonym środowiskiem wykonawczym