Ta strona została przetłumaczona przez Cloud Translation API.

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

Testing, and building for distribution

Tworzenie i konfigurowanie aplikacji testowej

Z tej sekcji dowiesz się, jak skonfigurować i przygotować aplikację do korzystania ze środowiska wykonawczego Pakiet SDK do testów lokalnych.

Przygotowanie aplikacji

Najpierw utwórz oddzielny, samodzielny projekt lub moduł.

w tym przypadku aplikacja nie zawiera kodu SDK; deklaruje je jako zależność Maven.

Tworzenie aplikacji, która korzysta z pakietu SDK z włączonym środowiskiem wykonawczym, wymaga Androida Studio Ladybug Canary 1 lub nowsza oraz wtyczka Androida do obsługi Gradle (AGP) w wersji 8.7.0-alfa01 lub nowszej.

Wykonaj te same czynności co wcześniej, aby skonfigurować środowiska programistycznego device/emulator do testowania.

Włącz środowisko wykonawcze SDK za pomocą flagi opisanej w sekcji Krok 3. Przygotuj sekcję SDK

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

Dodaj adres URL Maven Piaskownicy prywatności do pliku build.gradle najwyższego poziomu projektu. .

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

Zachowaj zależność Maven od istniejącej biblioteki reklam (pakietu SDK współpracującego z środowiskiem wykonawczym) w celu Maven.

Dodaj do projektu build.gradle blok PrivacySandbox w zależności od biblioteki SDK i ustaw wartość „Włącz”

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

android {
    //...
    privacySandbox {
        enable true
    }
    //...
}

dependencies {
    // SDK library dependency
    implementation(<maven coordinates to SDK library>)
}

Aplikacja może teraz korzystać z interfejsów API pakietu SDK w taki sam sposób, które opisujemy w sekcji Wykorzystanie interfejsów API.

Utwórz aplikację

Aplikacje możesz tworzyć w zwykły sposób jako pakiety Android App Bundle.

Testowanie pakietu SDK lokalnie

Aby uruchomić aplikację testową, zainstaluj w teście pakiet SDK i aplikację z obsługą środowiska wykonawczego lub emulatorze w Android Studio.

Otwórz projekt aplikacji testowej w Android Studio.
Wybierz Uruchom > Edytuj konfiguracje. Opcja „Uruchom/debugowanie” Okno konfiguracji Możesz ją wdrożyć jako „Domyślny plik APK” lub „APK z pakietu”.
W sekcji Launch options (Opcje uruchamiania) ustaw opcję Launch (Uruchom) na Określona aktywność.
Kliknij menu z 3 kropkami obok opcji Aktywność i wybierz Główna. Działania związane z klientem.
Kliknij Zastosuj, a potem OK.
Kliknij Uruchom, aby zainstalować aplikację kliencką i pakiet SDK na urządzeniu testowym.

Tworzenie pakietu SDK do dystrybucji

Pakiet SDK należy utworzyć jako Pakiet Android SDK (ASB) przed opublikowaniem jej w sklepie z aplikacjami. ASB to publikacja niepodpisana odpowiadający pakietom Android App Bundle.

Plik ASB lub jego pochodny z Android SDK Archive (ASAR) razem, pakietu aplikacji na Androida zostanie przekształcony przez pakiet Bundletool w zestaw plików APK z możliwością zainstalowania. Promująca aplikację deweloperzy mogą korzystać z narzędzia BundleTool bezpośrednio w Android Studio (obecnie w wersji Canary wersji), aby wyświetlić wszystkie warianty pliku APK.

Pakiet SDK korzysta z pakietów AAB i ASB i może zwrócić zestaw wariantów pliku APK:

Plik APK przeznaczony do uruchamiania w trybie zgodności wstecznej SDK środowiska wykonawczego, dla urządzenia niezgodne ze środowiskiem wykonawczym SDK (Android 13 i starsze). Ten plik APK zawiera cały kod wymagany zarówno dla aplikacji, jak i pakietu SDK.
Plik APK przeznaczony do uruchamiania w trybie środowiska wykonawczego SDK na urządzeniach zgodnych z Środowisko wykonawcze SDK (Android 14 i nowsze). Ten plik APK zawiera tylko kodu aplikacji z fragmentami interfejsu API pakietu SDK używanego w środowisku wykonawczym.
Plik APK SDK zawierający kod SDK używany w czasie działania aplikacji, który powinien zostać zainstalowany przed plik APK aplikacji opisany w poprzednim kroku.

ASB możesz utworzyć na 2 sposoby:

Android Studio,
1. Zbuduj projekt. Można to zrobić, wywołując Build > > Ponownie utwórz projekt.
2. Plik ASB znajduje się w module ASB włączonym w środowisku wykonawczym pod adresem build/outputs/asb/single/<your-asb-module-name>.asb
Wiersz poleceń pakietu Bundletool – wykonaj tymi instrukcjami.

Zanim opublikujesz pakiet SDK, musisz go podpisać kluczem przesyłania. Użyj tej klucz przesyłania, aby podpisać Twoje konto ASB przed przesłaniem do SDK Console. Google używa certyfikat przesyłania, aby potwierdzić Twoją tożsamość.

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

Wygeneruj magazyn kluczy i klucz przesyłania. Ta wartość jest identyczna jak generując magazyn kluczy i klucz przesyłania dla aplikacji.
Podpisz swoje konto ASB za pomocą klucza przesyłania. Aby to zrobić, dodaj blok signedConfig do pliku build.gradle, podając 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 Rozpowszechnianie aplikacji z włączonym środowiskiem wykonawczym. Środowisko wykonawcze SDK stale współpracuje z aplikacją , aby rozszerzyć obsługę pakietów SDK używanych w czasie działania aplikacji.

Krok 4. Skorzystaj z pakietu SDK używanego w czasie działania aplikacji