Runtime-fähiges SDK erstellen und nutzen

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-App erstellen und konfigurieren

In diesem Abschnitt wird erläutert, wie Sie eine Anwendung für die Nutzung einer laufzeitfähigen App einrichten und vorbereiten. SDK für lokale Tests.

App vorbereiten

Erstellen Sie zuerst ein separates eigenständiges Projekt oder Modul.

In diesem Szenario enthält die App keinen SDK-Code. deklariert sie als Maven-Abhängigkeit.

Zum Erstellen einer App, die ein Runtime Enabled-SDK verwendet, ist Android Studio erforderlich Ladybug Canary 1 oder höher und Android Gradle Plugin (AGP) 8.7.0-alpha01 oder höher.

  1. Führen Sie dieselben Schritte wie zuvor beschrieben aus, um Ihr Entwicklungsumgebung und Gerät/Emulator zum Testen.

  2. Aktivieren Sie die SDK-Laufzeit mit dem Flag, das unter Schritt 3:Abschnitt „SDK vorbereiten“

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

  3. Fügen Sie die Maven-URL der Privacy Sandbox der obersten Ebene Ihres Projekts „build.gradle“ hinzu. -Datei.

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

  4. Behalten Sie die Maven-Abhängigkeit vom Maven-Ziel der vorhandenen Anzeigenbibliothek (Ihr laufzeitfähiges SDK) bei.

  5. Fügen Sie dem Projekt build.gradle einen privacySandbox-Block mit einer Abhängigkeit von der SDK-Bibliothek hinzu und setzen Sie „enable true“ (wahr)

    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. Die App kann die APIs des SDK jetzt auf dieselbe Weise verwenden wie wird im Abschnitt „API-Nutzung“ erläutert.

App erstellen

Sie können Ihre Apps wie gewohnt als Android App Bundle (AAB) erstellen.

SDK lokal testen

Installieren Sie das laufzeitfähige SDK und die App in Ihrem Test, um Ihre Test-App auszuführen oder Emulator nutzen.

  1. Öffnen Sie das Android Studio-Projekt für Ihre Test-App.
  2. Wählen Sie Ausführen > Konfigurationen bearbeiten. Die Option „Run/Debug“ (Ausführen/Fehlerbehebung) Konfigurationsfenster angezeigt wird. Du kannst sie als „Standard-APK“ bereitstellen oder „APK aus Bundle“.
  3. Legen Sie unter Startoptionen für Start die Option Angegebene Aktivität fest.
  4. Klicken Sie auf das Dreipunkt-Menü neben Aktivität und wählen Sie das Hauptverzeichnis aus. Aktivität für Ihren Kunden.
  5. Klicken Sie auf Übernehmen und dann auf OK.
  6. Klicken Sie auf Ausführen, um die Client-App und das SDK auf Ihrem Testgerät zu installieren.
<ph type="x-smartling-placeholder">

SDK für den Vertrieb erstellen

Sie müssen Ihr SDK als Android SDK Bundle (ASB) bevor du sie im App-Shop veröffentlichen kannst. ASB ist eine nicht signierte Veröffentlichung Paket, das Android App Bundles entspricht.

Das ASB oder eine Ableitung des Android SDK-Archivs (ASAR) zusammen mit dem AAB der App werden von Bundletool in eine Reihe installierbarer APKs umgewandelt. App-Kampagnen Entwickler können BundleTool direkt in Android Studio verwenden (derzeit Canary Version), um alle APK-Varianten auszugeben.

Bundletool verwendet ein AAB und ein ASB und kann eine Reihe von APK-Varianten ausgeben:

  1. Ein APK, das für die Ausführung im abwärtskompatiblen Modus mit der SDK-Laufzeit erstellt wurde, für Geräte, die nicht mit der SDK-Laufzeit kompatibel sind (Android 13 und niedriger) Dieses APK enthält den gesamten Code, der für die App und das SDK erforderlich ist.
  2. Ein APK, das zum Ausführen des SDK-Laufzeitmodus für Geräte entwickelt wurde, die mit dem SDK Runtime (Android 14 und höher) Dieses APK enthält nur die App-Code mit API-Stubs für das laufzeitfähige SDK.
  3. Das SDK-APK mit dem laufzeitfähigen SDK-Code, das vor dem das im vorherigen Schritt beschriebene App-APK.

Sie können ein ASB auf zwei Arten erstellen:

  • Android Studio <ph type="x-smartling-placeholder">
      </ph>
    1. Erstellen Sie Ihr Projekt. Dies kann durch Aufrufen von Build > Projekt neu erstellen.
    2. Die ASB-Datei befindet sich in Ihrem laufzeitfähigen ASB-Modul unter build/outputs/asb/single/<your-asb-module-name>.asb
  • Befehlszeile von Bundletool – folgen Sie finden Sie in dieser Anleitung.

Das SDK muss vor der Veröffentlichung mit einem Uploadschlüssel signiert werden. Verwenden Uploadschlüssel, um dein ASB für den Upload in die SDK Console zu signieren. Google verwendet das Uploadzertifikat, um deine Identität zu bestätigen.

Die folgenden Schritte geben einen Überblick darüber, was Sie tun müssen, um Ihr ASB zu signieren:

  1. Generieren Sie einen Schlüsselspeicher und einen Uploadschlüssel. Dies ist identisch mit Generieren eines Schlüsselspeichers und eines Uploadschlüssels für Apps
  2. Signieren Sie Ihr ASB mit dem Uploadschlüssel. Fügen Sie dazu einen „signConfig“-Block hinzu in Ihre build.gradle-Datei ein, in der Sie den neu erstellten Schlüssel und den Keystore angeben:
android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

App-Shops können verschiedene Strategien entwickeln, um diese Komponenten App-Bereitstellung mit aktivierter Laufzeit SDK Runtime arbeitet kontinuierlich mit App Speicher, um die Unterstützung für laufzeitfähige SDKs zu erweitern.

Schritt 4: Laufzeitfähiges SDK verwenden