این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

یک SDK با قابلیت زمان اجرا بسازید و مصرف کنید

آزمایش و ساخت برای توزیع

یک برنامه آزمایشی بسازید و پیکربندی کنید

این بخش نحوه راه‌اندازی و آماده‌سازی یک برنامه برای مصرف یک SDK فعال با زمان اجرا برای آزمایش محلی را توضیح می‌دهد.

اپلیکیشن خود را آماده کنید

ابتدا یک پروژه یا ماژول مستقل جداگانه ایجاد کنید.

در این سناریو، برنامه حاوی کد SDK نیست. در عوض آن را به عنوان یک وابستگی Maven اعلام می کند.

برای ساختن برنامه‌ای که یک SDK فعال شده در زمان اجرا مصرف می‌کند، به Android Studio Ladybug Canary 1 یا جدیدتر و Android Gradle Plugin (AGP) 8.7.0-alpha01 یا جدیدتر نیاز دارد.

همان مراحلی را که قبلاً توضیح داده شد دنبال کنید تا محیط توسعه و دستگاه/شبیه ساز خود را برای آزمایش تنظیم کنید.

با استفاده از پرچمی که در مرحله 3 توضیح داده شده است، زمان اجرا SDK را فعال کنید: بخش SDK خود را آماده کنید .

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

URL Maven Privacy Sandbox را به فایل build.gradle سطح بالای پروژه خود اضافه کنید.

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

وابستگی Maven را به هدف Maven کتابخانه تبلیغاتی موجود (SDK آگاه از زمان اجرا) حفظ کنید.

یک بلوک privacySandbox به پروژه build.gradle با وابستگی به کتابخانه SDK اضافه کنید و فعال کردن 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>)
}

این برنامه اکنون می تواند از API های SDK به همان روشی که در بخش مصرف API توضیح داده شده است استفاده کند.

اپلیکیشن خود را بسازید

می‌توانید برنامه‌های خود را به‌عنوان یک Android App Bundle (AAB) همانطور که معمولاً انجام می‌دهید بسازید.

SDK خود را به صورت محلی تست کنید

برای اجرای برنامه آزمایشی خود، SDK و برنامه فعال شده در زمان اجرا را با استفاده از Android Studio روی دستگاه آزمایشی یا شبیه ساز خود نصب کنید.

پروژه Android Studio را برای برنامه آزمایشی خود باز کنید.
به Run > Edit Configurations بروید. پنجره پیکربندی "Run/Debug" ظاهر می شود. می‌توانید به‌عنوان «پیش‌فرض APK» یا «APK from Bundle» مستقر شوید.
در قسمت Launch Options ، Launch را روی Specified Activity قرار دهید.
روی منوی سه نقطه در کنار Activity کلیک کنید و Activity اصلی را برای مشتری خود انتخاب کنید.
روی Apply و سپس OK کلیک کنید.
روی Run کلیک کنید تا برنامه مشتری و SDK روی دستگاه آزمایشی خود نصب شود.

هشدار: هنگام اجرای یک برنامه وابسته به SDK با قابلیت اجرا بر روی دستگاه آزمایشی از طریق Android Studio (بدون دانلود آن از Play یا فروشگاه‌های دیگر)، ابتدا هر برنامه دیگری را که به نسخه‌های SDK شما بستگی دارد که از Play یا فروشگاه‌های دیگر دانلود شده‌اند، حذف نصب کنید. .

اگر فراموش کردید این کار را انجام دهید، یک خطای عدم تطابق گواهی می‌بینید، زیرا Play یا فروشگاه‌های دیگر ممکن است SDK را با کلیدی متفاوت از کلید مورد استفاده Android Studio هنگام استقرار محلی امضا کنند.

SDK خود را برای توزیع بسازید

قبل از اینکه بتوانید آن را در یک فروشگاه برنامه منتشر کنید، باید SDK خود را به عنوان یک بسته نرم افزاری Android SDK (ASB) بسازید. ASB یک بسته انتشارات بدون امضا است که معادل با Android App Bundles است.

ASB یا مشتق آن Android SDK Archive ( ASAR )، همراه با AAB برنامه توسط Bundletool به مجموعه‌ای از APKهای قابل نصب تبدیل می‌شوند. توسعه دهندگان برنامه می توانند از BundleTool مستقیماً در Android Studio (نسخه Canary فعلی) برای خروجی همه انواع APK استفاده کنند.

Bundletool یک AAB و یک ASB می گیرد و می تواند مجموعه ای از انواع APK را خروجی دهد:

یک APK ساخته شده برای اجرا در حالت سازگار با SDK Runtime، برای دستگاه‌هایی که با زمان اجرا SDK (اندروید 13 و پایین‌تر) سازگار نیستند. این APK حاوی تمام کدهای مورد نیاز برای برنامه و SDK است.
یک APK ساخته شده برای اجرای حالت SDK Runtime برای دستگاه های سازگار با SDK Runtime (اندروید 14 و بالاتر). این APK فقط حاوی کد برنامه است، با خردهای API برای SDK فعال در زمان اجرا.
SDK APK با کد SDK فعال در زمان اجرا، قرار است قبل از APK برنامه که در مرحله قبل توضیح داده شد نصب شود.

شما می توانید یک ASB را به دو روش بسازید:

اندروید استودیو
1. پروژه خود را بسازید این کار را می توان با فراخوانی Build > Rebuild project انجام داد.
2. فایل ASB در ماژول ASB فعال در زمان اجرا تحت build/outputs/asb/single/<your-asb-module-name>.asb زندگی می کند.
خط فرمان Bundletool - این دستورالعمل ها را دنبال کنید.

قبل از اینکه بتوانید آن را منتشر کنید، SDK باید با یک کلید آپلود امضا شود. از این کلید آپلود برای امضای ASB خود برای آپلود در کنسول SDK استفاده کنید. Google از گواهی آپلود برای تأیید هویت شما استفاده می کند.

مراحل زیر یک نمای کلی از کارهایی است که برای امضای ASB خود باید انجام دهید:

یک فروشگاه کلید ایجاد کنید و کلید آپلود کنید. این با ایجاد یک ذخیره‌سازی کلید و کلید آپلود برای برنامه‌ها یکسان است.
ASB خود را با کلید آپلود امضا کنید. برای انجام این کار، یک بلوک signingConfig را به فایل build.gradle خود اضافه کنید که کلید جدید ایجاد شده و فروشگاه کلید را مشخص می کند:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

فروشگاه‌های برنامه می‌توانند استراتژی‌های مختلفی را برای استفاده از این مؤلفه‌ها برای پشتیبانی از توزیع برنامه‌های Runtime-Enabled ایجاد کنند. SDK Runtime به طور مداوم با فروشگاه های برنامه کار می کند تا پشتیبانی از SDK های دارای زمان اجرا را افزایش دهد.

مرحله 4 : SDK فعال با زمان اجرا را مصرف کنید