פיתוח וצריכה של ערכת SDK שתואמת לזמן ריצה

יצירה והגדרה של אפליקציית בדיקה

בקטע הזה מוסבר איך להגדיר ולהכין אפליקציה לשימוש ב-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 בספריית המודעות הקיימת (ערכת ה-SDK שלכם שמודעת לזמן הריצה) כיעד Maven.

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. עוברים אל Run > Edit Configurations (הפעלה > עריכת הגדרות). חלון ההגדרה 'הפעלה/ניפוי באגים' מופיע. אפשר לפרוס כ-APK ברירת מחדל או כ-APK מ-Bundle.
3. בקטע אפשרויות הפעלה, מגדירים את הפעלה לפעילות ספציפית.
4. לוחצים על תפריט שלוש הנקודות לצד פעילות ובוחרים את הפעילות הראשית של הלקוח.
5. לוחצים על אישור ואז על אישור.
6. לוחצים על הפעלה כדי להתקין את אפליקציית הלקוח ואת ה-SDK במכשיר הבדיקה.

איך יוצרים SDK להפצה

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

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

‫Bundletool מקבל קובץ AAB וקובץ ASB ויכול להפיק קבוצה של וריאציות APK:

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

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

• ‫Android Studio
  1. יוצרים את הפרויקט. כדי לעשות את זה, מפעילים את הפקודה Build > Rebuild project.
  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 Runtime פועלת כל הזמן עם חנויות אפליקציות כדי להרחיב את התמיכה בערכות SDK תואמות זמן ריצה.

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