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

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

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

برنامه خود را آماده کنید

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

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

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

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

2. با استفاده از پرچمی که در بخش «مرحله ۳: آماده‌سازی SDK» توضیح داده شده است، SDK Runtime را فعال کنید.

   # 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. یک بلوک 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 توضیح داده شد، استفاده کند.

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

شما می‌توانید برنامه‌های خود را به صورت یک بسته نرم‌افزاری اندروید (AAB) طبق روال معمول بسازید.

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

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

1. پروژه اندروید استودیو مربوط به اپلیکیشن آزمایشی خود را باز کنید.
2. به Run > Edit Configurations بروید. پنجره پیکربندی "Run/Debug" ظاهر می‌شود. می‌توانید آن را به عنوان "Default APK" یا "APK from Bundle" مستقر کنید.
3. در قسمت گزینه‌های راه‌اندازی (Launch Options) ، گزینه راه‌اندازی (Launch) را روی فعالیت مشخص‌شده (Specified Activity) تنظیم کنید.
4. روی منوی سه نقطه کنار Activity کلیک کنید و Main Activity را برای کلاینت خود انتخاب کنید.
5. روی اعمال و سپس تأیید کلیک کنید.
6. برای نصب برنامه کلاینت و SDK روی دستگاه آزمایشی خود، روی Run کلیک کنید.

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

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

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

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

1. یک APK که برای اجرا در حالت سازگار با نسخه‌های قبلی SDK Runtime، برای دستگاه‌هایی که با نسخه‌های قبلی SDK سازگار نیستند (اندروید ۱۳ و پایین‌تر) ساخته شده است. این APK شامل تمام کدهای مورد نیاز برای برنامه و SDK است.
2. یک APK ساخته شده برای اجرای حالت SDK Runtime برای دستگاه‌های سازگار با SDK Runtime (اندروید ۱۴ و بالاتر). این APK فقط شامل کد برنامه به همراه خلاصه‌های API برای SDK فعال‌شده در زمان اجرا است.
3. 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 استفاده کنید. گوگل از گواهی آپلود برای تأیید هویت شما استفاده می‌کند.

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

1. یک کلید اصلی (keystore) و کلید آپلود ایجاد کنید. این کار مشابه ایجاد کلید اصلی (keystore) و کلید آپلود برای برنامه‌ها (apps) است.
2. ASB خود را با کلید آپلود امضا کنید. برای انجام این کار، یک بلوک signingConfig به فایل build.gradle خود اضافه کنید که کلید جدید ایجاد شده و keystore را مشخص کند:

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

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

arrow_back_ios مرحله ۴ : استفاده از SDK فعال‌شده در زمان اجرا