این راهنما برای ناشران در نظر گرفته شده است که یک ساختار دسترسی اولیه از Google Mobile Ads Android SDK را در برنامه Android خود ادغام می کنند. ساخت‌های دسترسی زودهنگام این فرصت را فراهم می‌کنند که از ویژگی‌های جدید Google Mobile Ads SDK بدون انتظار برای انتشار بعدی سرویس‌های Google Play استفاده کنید و مزایای زیر را ارائه می‌دهد:
هنگامی که ویژگی دسترسی زودهنگام در APK راه‌اندازی شد، به‌طور خودکار اجرای جدیدتر Google Mobile Ads SDK را از APK خدمات Google Play شروع می‌کنند.
آنها کاملاً آزمایش شده‌اند و همان معیارهای نسخه‌های عمومی موجود در مخزن Maven Google یا مدیر SDK را برای انتشار دارند.
آنها نسخه‌های کامل Google Mobile Ads SDK هستند که بزرگ‌تر از Lite SDK هستند، اما مشمول محدودیت‌های Lite SDK نیستند.
آنها را می توان در سطح جهانی و نه تنها در برنامه های توزیع شده از طریق Google Play استفاده کرد.
برای راه‌اندازی یک مخزن محلی Maven با دسترسی زودهنگام Google Mobile Ads SDK و ارجاع آن به عنوان یک وابستگی در برنامه Android خود، مراحل این صفحه را دنبال کنید.
پیش نیازها
- از Android Studio 3.0 یا بالاتر استفاده کنید
- Android API سطح 16 یا بالاتر را هدف قرار دهید
- دسترسی زودهنگام به فایل فشرده SDK Ads Google Mobile ارائه شده توسط Account Manager
مخزن سفارشی Maven را پیکربندی کنید
فایل فشرده SDK Ads Google Mobile Ads را دانلود کنید. یک پوشه gma_sdk_repo در دایرکتوری سطح بالای پروژه خود ایجاد کنید و کل محتویات zip را در آن پوشه قرار دهید. ساختار دایرکتوری شما باید شبیه <project_root_dir>/gma_sdk_repo/com/google/... باشد.
فایل build.gradle سطح پروژه برنامه خود را باز کنید.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
خط پررنگ را به بخش allprojects/repositories اضافه کنید. این به Gradle دستور می دهد تا به دنبال یک مخزن Maven در پوشه gma_sdk_repo که به تازگی هنگام حل وابستگی ها ایجاد کرده اید، بگردد.
افزودن وابستگی به ساخت
برای استفاده از ساخت دسترسی اولیه Google Mobile Ads SDK در پروژه خود، همچنین باید به آن به عنوان یک وابستگی در فایل build.gradle در سطح برنامه خود ارجاع دهید: فایل build.gradle سطح برنامه را باز کنید و خط پررنگ را به آن اضافه کنید. قطعه به بخش dependencies .
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
نسخه وابستگی، که توسط xyz در قطعه قبلی نشان داده شده است، می‌تواند با یافتن آخرین نسخه موجود در فهرست com/google/android/gms/play-services-ads/ در محتویات بایگانی‌نشده Early Access Google Mobile Ads Android تعیین شود. فایل فشرده SDK.
تضادهای Firebase را حل کنید
اگر از کتابخانه Firebase همراه با SDK تبلیغات موبایل استفاده می‌کنید، می‌توانید com.google.android.gms:play-services-measurement-api و com.google.android.gms:play-services-measurement-sdk-api داشته باشید. وابستگی های com.google.android.gms:play-services-measurement-sdk-api در پروژه شما گنجانده شده است. نسخه‌های این دو وابستگی باید مطابقت داشته باشند، اما ممکن است متوجه شوید که ساخت دسترسی اولیه SDK Ads Mobile و نسخه فعلی Firebase شما نسخه‌های مختلفی برای این دو وابستگی دارد.
به عنوان یک راه حل، می توانید وابستگی را به نسخه خاصی از کتابخانه play-services-measurement-sdk-api در فایل build.gradle برنامه خود به شرح زیر وادار کنید:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
نسخه xyz به نسخه Firebase شما بستگی دارد. در اینجا نسخه های صحیح برای نسخه های اخیر Firebase آمده است:
نسخه firebase-core | نسخه play-services-measurement-sdk-api |
|---|---|
16.0.7 | 16.3.0 |
16.0.6 | 16.0.4 |
16.0.5 | 16.0.3 |
16.0.4 | 16.0.2 |
برای جستجوی نسخه صحیح برای سایر نسخه های Firebase، gradle androidDependencies برای برنامه خود اجرا کنید و از نسخه چاپ شده برای وابستگی com.google.android.gms:play-services-measurement-api استفاده کنید.
برنامه Android شما اکنون آماده استفاده با ساخت دسترسی اولیه Google Mobile Ads Android SDK است.