פיתוח וצריכה של ערכת 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 Plugin (AGP) 8.7.0-alpha01 ואילך.

  1. פועלים לפי אותם השלבים שתוארו קודם כדי להגדיר בסביבת הפיתוח מכשיר/אמולטור לבדיקה.

  2. מפעילים את זמן הריצה של ה-SDK באמצעות הדגל שמתואר ב- שלב 3: הכנת הקטע של ה-SDK.

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

  3. הוספת כתובת ה-URL של Maven לארגז החול לפרטיות ל-build.gradle ברמה העליונה של הפרויקט חדש.

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

  4. שומרים על התלות של Maven ביעד Maven לספריית המודעות הקיימת (ערכת SDK שמבוססת על זמן ריצה).

  5. מוסיפים בלוק של privacySandbox לקובץ build.gradle של הפרויקט עם תלות בספריית ה-SDK ומגדירים את enable כ-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. האפליקציה יכולה עכשיו להשתמש בממשקי ה-API של ה-SDK באותו אופן שבו היא יכולה להשתמש מוסבר בקטע 'צריכת API'.

פיתוח האפליקציה

אתם יכולים ליצור את האפליקציות כחבילת Android App Bundle‏ (AAB) כמו שאתם עושים בדרך כלל.

בדיקה מקומית של ה-SDK

כדי להריץ את אפליקציית הבדיקה, יש להתקין בבדיקה שלך את האפליקציה וה-SDK שמופעלים בזמן הריצה במכשיר או באמולטור של Android Studio.

  1. פותחים את פרויקט Android Studio של אפליקציית הבדיקה.
  2. עוברים אל הפעלה > עריכת הגדרות. חלון ההגדרה 'הפעלה/ניפוי באגים' יופיע. אפשר לפרוס בתור 'APK ברירת מחדל' או 'APK מחבילה'.
  3. בקטע Launch options (אפשרויות הפעלה), מגדירים את Launch (הפעלה) כ-Specified Activity (פעילות ספציפית).
  4. לוחצים על תפריט שלוש הנקודות שלצד פעילות ובוחרים באפשרות פעילות של הלקוח שלך.
  5. לוחצים על אישור ואז על אישור.
  6. לוחצים על Run כדי להתקין את אפליקציית הלקוח ואת ה-SDK במכשיר הבדיקה.

בניית ה-SDK להפצה

צריך לפתח את ה-SDK חבילת Android SDK (ASB) לפני שמפרסמים אותו בחנות אפליקציות. ASB היא חבילת פרסום לא חתומה שדומה לקובצי Android App Bundle.

ה-ASB, או נגזרתו, Android SDK Archive‏ (ASAR), יחד עם קובץ ה-AAB של האפליקציה, הופכים על ידי Bundletool לקבוצה של חבילות APK שניתן להתקין. אפליקציה מפתחים יכולים להשתמש ב-BundTool ישירות ב-Android Studio (כרגע Canary כרגע) גרסה) כדי להפיק פלט של כל הווריאציות של ה-APK.

Bundletool לוקחת AAB ו-ASB ויכולה להפיק פלט של קבוצת וריאנטים של APK:

  1. APK שמיועד להרצה במצב תאימות לאחור בזמן ריצה ל-SDK, עבור מכשירים שלא תואמים לזמן הריצה של ה-SDK (Android 13 ומטה). קובץ ה-APK הזה מכיל את כל הקוד הנדרש גם לאפליקציה וגם ל-SDK.
  2. APK שמיועד להרצת מצב זמן ריצה של SDK במכשירים שתואמים ל- זמן ריצה ל-SDK (Android 14 ואילך). חבילת ה-APK הזו מכילה רק את של קוד האפליקציה, עם stubs של API עבור ערכת SDK שתואמת לזמן ריצה.
  3. חבילת ה-APK של ה-SDK עם קוד ה-SDK התואם לזמן ריצה, שהיה מיועד להתקנה לפני את ה-APK של האפליקציה שמתואר בשלב הקודם.

יש שתי דרכים ליצור ASB:

  • Android Studio
    1. יוצרים את הפרויקט. אפשר לעשות זאת על ידי קריאה לפרויקט Build > Rebuild.
    2. קובץ ה-ASB נמצא במודול ASB שתומך בזמן ריצה בקטע build/outputs/asb/single/<your-asb-module-name>.asb
  • שורת הפקודה Bundletool – מעקב ההוראות האלה.

כדי לפרסם את ה-SDK, צריך לחתום עליו באמצעות מפתח העלאה. שימוש בטיוטה הזו מפתח העלאה כדי לחתום על ה-ASB לצורך העלאה אל SDK Console. Google משתמשת אישור ההעלאה כדי לאמת את הזהות שלך.

השלבים הבאים הם סקירה כללית של הפעולות שצריך לבצע כדי לחתום על טופס ה-ASB:

  1. יצירת מאגר מפתחות ומפתח העלאה. הכתובת הזו זהה ל- יצירת מאגר מפתחות ומפתח העלאה לאפליקציות.
  2. חותמים על ה-ASB באמצעות מפתח ההעלאה. כדי לעשות זאת, מוסיפים בלוק signingConfig לקובץ build.gradle ומציינים את המפתח החדש שנוצר ואת מאגר המפתחות:
android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

חנויות האפליקציות יכולות לפתח אסטרטגיות שונות לשימוש ברכיבים האלה כדי לתמוך הפצת אפליקציות בזמן ריצה. זמן הריצה של ה-SDK פועל כל הזמן עם האפליקציה חנויות כדי להרחיב את התמיכה בערכות SDK תואמות זמן ריצה.

שלב 4: שימוש ב-SDK שתואם לזמן הריצה