建構和使用支援執行階段的 SDK

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

建構及設定測試應用程式

本節說明如何設定及準備使用支援執行階段的應用程式 用於本機測試的 SDK。

備妥應用程式

首先，請建立獨立的獨立專案或模組。

在這種情況下，應用程式不包含 SDK 程式碼，而是將其宣告為 Maven 依附元件。

如要建構使用已啟用執行階段的 SDK 的應用程式，必須啟用 Android Studio Ladybug Canary 1 以上版本和 Android Gradle 外掛程式 (AGP) 8.7.0-alpha01 以上版本。

  1. 請按照先前所述的步驟設定開發環境和測試裝置/模擬器。

  2. 使用 步驟 3：「備妥 SDK」一節。

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

  3. 將 Privacy Sandbox Maven 網址新增至專案的頂層 build.gradle 檔案。

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

  4. 請將 Maven 依附元件保留在現有廣告程式庫 (您的執行階段感知 SDK) Maven 目標中。

  5. 使用 SDK 程式庫的依附元件，在 build.gradle 專案中加入 privacySandbox 區塊，並將該區塊設為啟用

    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. 應用程式現在可以採用與 如「API 用量」一節所述

建構應用程式

您可以照常將應用程式建構為 Android App Bundle (AAB)。

在本機測試 SDK

如要執行測試應用程式，請在測試中安裝支援執行階段的 SDK 和應用程式 裝置或模擬器

  1. 開啟測試應用程式的 Android Studio 專案。
  2. 依序前往「Run」>「Edit Configurations」。系統隨即會顯示「Run/Debug」設定視窗。您可以部署「預設 APK」或「套件中的 APK」。
  3. 在「Launch Options」下，將「Launch」設為「Specified Activity」。
  4. 按一下「Activity」旁的「三點圖示選單」，然後為用戶端選取「Main Activity」。
  5. 依序按一下「Apply」和「OK」。
  6. 按一下「Run」，在測試裝置上安裝用戶端應用程式和 SDK。

建構要發布的 SDK

您必須將 SDK 建構為 Android SDK 套件 (ASB) 才能發布到應用程式商店ASB 是未簽署的出版品 。

ASB 或其衍生版本 Android SDK 封存檔 (ASAR) 會與應用程式的 AAB 一同由 Bundletool 轉換為可安裝的 APK 組合。應用程式開發人員可以直接在 Android Studio (目前為 Canary 版本) 中使用 BundleTool，輸出所有 APK 變化版本。

Bundletool 會取用 AAB 和 ASB，並輸出一系列 APK 變化版本：

  1. 專為在 SDK 執行階段回溯相容模式中執行的 APK， 不符合 SDK 執行階段 (Android 13 以下版本) 的裝置。 這個 APK 內含應用程式和 SDK 所需的所有程式碼。
  2. 專為執行 SDK 執行階段模式而建立的 APK，適用於與 SDK 執行階段 (Android 14 以上版本)。這個 APK 只包含應用程式程式碼，以及支援執行階段的 SDK API 代碼。
  3. 包含支援執行階段的 SDK 程式碼的 SDK APK，旨在先於上一個步驟所述的應用程式 APK 安裝。

您可以透過以下兩種方式建構 ASB：

  • Android Studio
    1. 建構您的專案。方法是呼叫「Build」>「Rebuild」專案。
    2. ASB 檔案位於支援執行階段的 ASB 模組中，位於 build/outputs/asb/single/<your-asb-module-name>.asb
  • Bundletool 指令列 - 請按照這些操作說明操作。

您必須使用上傳金鑰簽署 SDK 後才能發布。使用這個上傳金鑰簽署 ASB，然後上傳至 SDK 主控台。Google 會運用 進行身分驗證。

以下概略說明簽署 ASB 時須採取的步驟：

  1. 產生 KeyStore 和上傳金鑰。這等於 為應用程式產生 KeyStore 和上傳金鑰。
  2. 使用上傳金鑰簽署 ASB。如要這麼做，請新增 signedConfig 區塊 新增到 build.gradle 檔案中，同時指定新建立的金鑰和 KeyStore：
android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

應用程式商店可以開發不同的策略，使用這些元件來支援啟用執行階段的應用程式發行作業。SDK 執行階段會持續與應用程式商店合作，擴大對支援執行階段的 SDK 支援範圍。

步驟 4：使用支援執行階段的 SDK